开发文档 · API 与协议参考

Management Protocol

身份、凭证、Scope、策略、版本、发布与审计的管理面协议。

成熟度:Stable(@ @fellow.work/client 0.5.65 · wire m25-wire-2026-09-12)

Management Protocol 负责管理主体、凭证、Scope、策略、配置、发布、版本与审计。它对各协议模块施加治理约束,但不代替这些模块执行业务操作,也不成为业务对象数据面。

当前可用

Integration App、部分 Scope、Console 实例治理、模型与用户管理、配额、日志和审计已有实现。Operator 平面已有独立机器可读契约:management.openapi.yaml(193 operations,随 spec/ tarball 发布,不在 Interaction openapi.yaml 内)。

Provider已文档化范围
gateway-console/api/console/* 全 inventory(用户/模型/Skills/配额/安全/调度、可观测、Control、Integration App 等)
platform-console会话与 fleet/platform 顶层面 + deployment 代理(镜像实例 operator HTTP)

193/193 路由与 OpenAPI 对齐;Stable 兼容策略见 tarball 内 management-stable-semver.md 与 fpp-0020-management-stable-gate.md。

Conformance:wire.json + Gateway test:management(74) + Console test:management(51);tarball:contracts:test-management-sdk-package(Gateway + Console)。本地:pnpm spec:runner:management 或 scripts/verify-protocol.sh。

TypeScript operator: @fellow.work/client/management(wire Stable;Console Web/Server 已接 Platform / 实例代理)。Shell:examples/management-smoke.sh。

健康探针响应头:Fellow-Management-Version: stable;wire=…;ops=193。

信任边界

Console Token、App Key、用户 Token、Connector Secret 与 Host Consent 属于不同凭证域。管理凭证不能复用于 Interaction 数据面;策略发布后,各数据面入口仍必须自行执行认证、授权、资源归属与输入校验。

版本边界

Management wire 版本由 Fellow-Management-Version 与 OpenAPI x-fellow-maturity 声明,与 Console 产品 UI 版本相互独立。Breaking 变更走 FPP + SDK major / 新 wire 代际(见 management-stable-semver.md)。

当前不包含

  • @fellow.work/client createClient() 根 上的 Management 挂载(仍使用 /management 子路径)。
  • 完整 Fleet 计费、跨组织 SIEM、191-op 全量 typed codegen 到生产 TS 导出(可选 backlog)。