开发文档 · API 与协议参考

Host Protocol

窄宿主能力、参数约束、Consent 与 OS 特权边界。

成熟度:Stable(host-results v2 wire) @ @fellow.work/client ≥ 0.7.3(FPP-0033)

Stable 承诺范围: POST /runs/{run_id}/host-results 的 host_command_result_request_v2 wire、JSON Schema 与 conformance fixtures(host.v2)。OpenAPI 路径归属 Integration 标签;registry 单独 host 模块计数 1 operation。

尚未 Stable: 全平台能力目录、discovery、Consent UX 与跨端一致失败语义(见 SDK host-stable-readiness.md waiver)。

信任边界

  • 模型输出不能声明自己已获授权。
  • Host 只接受已登记能力与结构化参数,禁止任意命令、argv、环境变量和 shell: true。
  • 路径必须经过篱笆并以虚拟路径返回,不泄露本机绝对路径。
  • Consent 应绑定能力和参数指纹;同意一项操作不等于授予通用特权。
  • Cloud / Web 缺少能力时必须明确失败,不能模拟 Desktop 成功。

版本边界

Host-results v2 以 SDK spec/openapi.yaml、host.schema.json 与 host/v2/current.json 为准。未在目录登记的能力 不能 因 Stable wire 而视为产品默认可用。

相关文档