开发文档 · API 与协议参考

Capability Discovery

按 Feature ID、版本和限制发现 Gateway、Host、Runtime 与 Connector 能力。

成熟度:Experimental。 部分能力目录已存在,跨 Gateway、Host、Runtime 和 Connector 的统一 discovery 契约尚未稳定。

Capability Discovery 让客户端根据目标环境实际声明的能力进行适配,而不是按产品名、平台名或 SDK 包版本猜测。

声明职责

一项可发现能力应包含稳定 Feature ID、能力版本、适用限制和不可用原因。涉及权限时,discovery 只能说明环境“可能支持”,不能证明当前主体已获授权。

当前可用

Host 路径和部分能力目录已有实现,不同部署 Profile 也会决定 Sandbox、Channel 和网络能力。当前没有可假设处处存在的统一 discovery endpoint 或响应 Schema;请按具体产品文档和实际版本验证。

信任边界

  • 服务端与 Host 的声明必须经过认证来源提供,客户端不得自行开启未声明能力。
  • “已发现”不跳过 Scope、资源归属、参数校验或 Consent。
  • Cloud / Web 缺少 Desktop 能力时应明确降级或失败,不能伪造结果。
  • adapter 不得把外部协议能力静默映射为更高权限的内部能力。

版本边界

能力版本与 SDK、协议模块和产品发布版本分别维护。客户端应拒绝不支持的 major,并对兼容新增字段保持容忍。统一 discovery 进入 Preview 前需有机器可读 Schema、拒绝语义和跨端 conformance。

相关文档