跳转至

新载体适配

未来宿主、IDE 扩展、原生自动化或远程代理可以通过适配层加入。扩展的是到达同一业务能力的方式,不是另建一套资源、权限和任务状态。

最小适配合同

项目 必须回答的问题
身份 谁连接、令牌受众/范围是什么、怎样撤销
分发 原生包格式、可信来源、安装、启用与升级
发现 能力和方法从哪里来,如何窄查、缓存与失效
调用 输入如何映射,错误和取消如何保留
上下文 原对象、修订、页面状态与迟到响应如何隔离
观察 结果、部分失败、未知与等待如何表达
恢复 原操作如何跨连接与版本继续
UI 人如何检查、决定和接管;缺 UI 怎样降级
退出 禁用、撤权、卸载与退役各自影响什么
证据 哪些平台、版本和真实任务已测

适配过程

flowchart TD
  N[新增载体] --> M[读取原生协议、包与授权合同]
  M --> G[建立能力和语义差距矩阵]
  G --> A[实现窄适配,共用业务用例]
  A --> T[合同负例与生命周期测试]
  T --> H[目标宿主真实任务和降级]
  H --> R[按证据声明支持范围]

能用原生结构承载的语义直接映射;没有等价字段时,可以提供明确扩展或参考字段,但不能悄悄丢失 CAS、原操作或权限原因。AXI JSON 表示是可选互换格式,不要求每个宿主都包一层相同 JSON。

扩展与治理

原生适配不应先修改核心规范。只有跨载体可复现的问题确需共同字段或行为时,再按提案流程演进核心。宿主专有信息放在显式命名空间,不新增永久的专用状态枚举污染所有实现。

新适配先标记文档或参考状态;通过目标宿主任务后才提升验证声明。不能把“理论上能接 MCP”写成“已支持”。