成熟度: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/clientcreateClient()根 上的 Management 挂载(仍使用/management子路径)。- 完整 Fleet 计费、跨组织 SIEM、191-op 全量 typed codegen 到生产 TS 导出(可选 backlog)。