开发文档 · API 与协议参考

兼容性

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

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

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

成熟度基线

  • Stable: Interaction(≥ 0.6.0)、Management operator(≥ 0.5.65)。
  • Stable: Interfaces(4 adapters @ ≥ 0.7.1 · P5-01)。
  • Experimental: Host;可测试,不承诺 Stable SemVer。
  • Stable(opt-in): Case API(5 ops @ ≥ 0.6.4,case.v1);默认关闭。
  • Stable(opt-in): Runtime API(2 ops @ ≥ 0.6.5,runtime.v1);默认关闭。
  • Proposed: 尚未实现或仅 FPP 的设计面。

版本规则

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

Gateway capability tokens(Experimental)

Token环境变量说明
case.v1FELLOW_CASE=1Case MVP instance API
runtime.v1FELLOW_RUNTIME=1Runtime workload API

当前可用

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

信任边界

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

相关文档