版本与扩展¶
AXI 区分规范版本、目录修订、动作合同修订和软件制品版本，避免一次文案更新被误当成必须重新授权或重新执行任务。
四类版本¶
| 字段 | 表示什么 | 何时变化 |
|---|---|---|
spec_version |
AXI 结构与语义 | 核心字段、状态或行为要求改变 |
catalog_revision |
某提供方的目录 | 条目、用途、引用或支持能力改变 |
contract_revision |
单一动作的精确合同 | 输入、输出、副作用或恢复行为改变 |
| 采用方制品版本/摘要 | 实际代码、Skill 和资源 | 按采用方交付制度变化 |
AXI-VER-001：调用必须使用明确支持的版本和动作合同修订；提供方不得把未知版本静默解释成当前版本。破坏性输入、输出或副作用变化必须产生新的合同修订，并提供显式迁移说明。
本版将 contract_revision 当不透明字符串，客户端不通过数字大小推测兼容性。AXI 不替 MCP 协商其协议版本，也不为 CLI 增加网络初始化握手。
规范生命周期¶
草案允许修改，但应保留变更记录和可核对制品；依赖草案的实现绑定规范、合同及源码摘要。候选版用于冻结验证范围，稳定版需有公开的互操作和行为证据。当前只有草案，不能把生命周期描述当成已完成认证。
文字澄清不改变机器或行为合同时，可以保持规范版本并更新文档提交。已有稳定版本的破坏性更改应进入新版本目录；旧版本的安全勘误需明确标识。
可选扩展¶
extensions 的键使用反向域名命名空间，例如 org.example/review。org.example 仅用于示例，不表示可实际注册的内置扩展。扩展不得重新定义核心字段。
AXI-EXT-001：未知可选扩展可以忽略；实现不得在核心调用中暗含必须理解的扩展。需要扩展才能安全执行的能力必须采用新的显式合同修订或独立动作，并在发现时说明。
新增字段不能直接放入封闭核心对象。新增标准状态或副作用分类需要规范变更。兼容性评审要覆盖旧客户端解析、错误、缓存失效、原操作恢复和迁移期间的制品并存。