开发文档 · API 与协议参考

兼容性

SDK、协议、Gateway、Host 与 Console 的版本和成熟度兼容规则。

页面状态: 兼容规则入口。完整、自动生成的产品版本兼容矩阵尚未发布。

兼容判断至少涉及 SDK、协议模块、Gateway、Host、Runtime 和 Console。它们独立发布,不能因为 npm 包可安装或 UI 可见,就推断目标环境支持某项能力。

成熟度基线

  • Preview: Interaction;可在受控场景使用,仍可能需要迁移。
  • Experimental: Host、Runtime、Interfaces、Management;可测试,不承诺生产兼容。
  • Proposed: Object、Control;仅供设计评审,不存在可依赖的生产集成面。

版本规则

  • 每个协议模块独立声明版本,产品版本和包版本不替代协议版本。
  • 新增可选字段应保持向后兼容;删除、改名、收窄枚举或改变终态语义属于破坏性变化。
  • adapter 必须声明内部与外部版本范围,不支持时快速失败。
  • 客户端应结合 Capability Discovery 判断实际能力,并为明确拒绝和降级建立处理路径。

当前可用

Interaction 的 Thread / Run、SSE 与参考 SDK 是当前最成熟路径。其余模块应按具体实现、部署 Profile 和文档验证。由于尚无完整矩阵,本页不会编造最低 Gateway、Host 或 Console 版本。

信任边界

版本协商结果和远端 capability 都需校验;不得让旧客户端通过忽略授权字段获得更高权限。兼容层不能掩盖 Scope、Consent、租户隔离或错误语义的破坏性变化。

相关文档