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.state_ack / terminal.semantic_diffv1已启用
transport.stream_channelsv1协商启用
terminal.datagram_statev21.1 完整协商后启用

1.1 默认使用 Quinn。DATAGRAM 需要 semantic state v2、state ACK、semantic diff、session objects 与 stream channels;缺少依赖的旧服务器使用可靠通道兼容,不需要用户开启实验开关。

兼容边界

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

演进规则

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