代理信任握手协议使用语义版本标识符,格式为 MAJOR.MINOR(例如 0.10.21.0)。

版本方案

组成部分含义
主版本号(例如 1.x协议接口的破坏性变更
次版本号(例如 0.2新功能,向后兼容的增补
对于向后兼容的变更,协议版本号_不会_递增。这允许在保持同一主版本号的实现之间互操作性的同时进行增量改进。

当前版本

当前协议版本为 v0.1,涵盖:
  • 代理身份模型(基于 URI 的 Agent_ID + 签名 JWT 证明)
  • 三种发现模式(手动、网关目录、服务端 .well-known
  • 可信握手流程(阶段 A:代理注册,阶段 B:用户 OAuth 同意)
  • PKCE(RFC 7636)和资源指示器(RFC 8707
  • 范围交集执行
  • API 端点(注册、授权、令牌、代理、撤销)
  • 安全注意事项

发现文档版本管理

发现文档(/.well-known/ath.json/.well-known/ath-app.json)中的 ath_version 字段指示实现支持的协议版本:
{
  "ath_version": "0.1",
  ...
}
代理应在继续注册之前检查此字段以确保兼容性。

计划版本

有关计划中的协议版本详情,请参阅路线图