跳转至

AXI 0.2.1

状态:草案。 本版定义与传输无关的操作合同,以及可用于交换和测试的 JSON 表示。它不定义网络握手、RPC 路由或新的授权系统。

范围

核心覆盖发现、定位、执行、观察与恢复,并约束组件的集成生命周期。分页、批量和等待是可选能力;一旦声明支持,就必须满足相应章节要求。浏览器视觉能力只在任务需要时采用。CLI、MCP、Skills、插件与交互视图按原生合同协作,不要求全部采用。

层次 本版定义 保持在采用方的内容
语义 上下文、副作用、状态、错误、恢复 领域流程、质量判据、商业规则
JSON 表示 catalog、action、result、page、batch 业务输入和输出 Schema
绑定 CLI、MCP、网页的映射要求 既有协议版本、地址、认证实现
验证 静态、行为、任务三类证据 目标宿主、数据、性能预算

规范用语

本文中的必须(MUST)、不得(MUST NOT)、应当(SHOULD)、不应(SHOULD NOT)与可以(MAY)具有 BCP 14 的要求强度;仅这些明确标示的用语构成要求。应当项允许有理由的偏离,采用清单需记录理由与影响。

带 AXI-… 编号的段落是可追踪要求。构建从这些段落生成要求索引,不另维护一份规则副本。

AXI-CORE-001:实现必须声明精确规范版本、提供方标识、所覆盖的核心任务和绑定;不得仅以“支持 AXI”代替声明范围。

AXI-CORE-002:人类入口与 Agent 入口必须使用同一领域权限、修订、副作用和事实源;接入层不得直接绕过业务校验写入领域存储。

数据合同与优先级

JSON Schema是字段、类型、必填、枚举和组合结构的权威定义。各章节是行为、顺序、授权、状态和恢复语义的权威定义。示例是说明,不扩大合同。两者发生矛盾时应视为规范缺陷,不能宣称通过符合性验证。

JSON Schema 可验证回执形状,不能证明权限真实、幂等持久化或任务质量。验证层次见符合性。

交互性能

AXI-PERF-001:采用方必须为声明支持的CLI、MCP及本地/远程视图分别确定任务性能预算与测量边界,区分首次反馈、首个正确可用结果、完整交付、冷启动和热会话;报告必须包含环境、精确制品、样本数、失败及尾部延迟,不得仅以工具响应或localhost位置宣称端到端提速。

AXI-PERF-002:性能优化必须保持原权限、输入校验、修订、费用、恢复和结果质量;不得以省略必需核验、丢弃失败样本或重发未知操作换取较低耗时。提供方应当让已知目标直接调用,避免重复发现、无关启动和同任务重复创建视图。

各入口关键路径、预算制定和比较方法见性能实践。这些是任务证据要求,不新增JSON核心字段,也不规定所有产品采用同一毫秒阈值。

阅读顺序

先读数据模型,再按顺序实现发现、定位、执行、结果及恢复。可选能力及安全要求需要与核心一起评审。