Astra Shell 文档下载 macOS
文档目录 当前:协议与兼容

文档 / 参考 / 协议与兼容

REFERENCE · PROTOCOL

版本、能力与兼容路径。

连接版本决定 framing 与认证家族,Hello 能力协商决定这次连接可以使用哪些语义终端和会话能力。

版本范围

当前 application protocol 为 N=2,并支持 N-1=1。ALPN astra/1 表示 framing / authentication family;具体语义由 Hello 中的版本范围与 capability selection 决定。

能力表

能力版本状态
terminal.semantic_statev2已启用
terminal.history_pagingv1已启用
session.objectsv1已启用
terminal.input_leasev1已启用
terminal.datagram_state未启用

兼容边界

只有未协商 semantic capability 的 N-1 客户端进入隔离 ANSI 模式。独立 SSH/SFTP Host 是单独的产品模式,不等同于 Astra-over-SSH stdio fallback。

演进规则

能力必须显式协商,旧字段的语义不能在 UI 层猜测,新迁移路径需要版本化和注册。客户端遇到未知或不完整状态时,应拒绝提交并请求可靠基线。