开发文档 · API 与协议参考

Changelog

协议、API、SDK 与治理能力变更事实及迁移入口。

页面状态: 变更索引入口。当前尚未建立覆盖七模块的统一自动化 Changelog。

Changelog 记录已经发布的事实:版本、日期、成熟度变化、兼容新增、破坏性变化、弃用和修复。它不代替 Migration Guide,也不把路线计划写成已交付能力。

记录职责

每条协议变更应说明所属模块、旧版与新版、影响范围、权威契约、发布时间和迁移链接。API、SDK、Gateway、Host 与 Console 的发布应分别记录,避免把包版本误认为协议版本。

当前基线

截至当前文档基线:

  • Interaction:Stable(Integration 25-op @ ≥ 0.6.0 · FPP-0028)
  • Management:Stable(Operator @ ≥ 0.5.65)
  • Control:Stable(10 ops @ ≥ 0.6.1 · opt-in · FPP-0017)
  • Object:Stable(5 ops @ ≥ 0.6.3 · opt-in · FPP-0029)
  • Case:Stable(5 ops @ ≥ 0.6.4 · opt-in · FPP-0030)
  • Runtime:Stable(2 ops @ ≥ 0.6.5 · opt-in · FPP-0031)
  • Interfaces:Stable(P5-01 @ ≥ 0.7.1 · FPP-0032)
  • Host:Stable(host-results v2 @ ≥ 0.7.3 · FPP-0033;能力目录非 Stable)

Object / Control / Case 默认关闭;Stable 指 wire/SemVer,不表示默认挂载。Operator 主路径: 仅 TypeScript(P5-04 / Python 版暂不推进,见 SDK p5-04-multilanguage-readiness.md)。本页不代替 SDK 发布说明。

近期事实(SDK 与 opt-in 协议)

以下条目为已发布或工作区对齐的 事实摘要(非完整 semver 日志):

版本 / 范围说明
@fellow.work/client@0.7.38FPP-0060:dispatcher-runmanager-stream-replay.test.ts(Channels 入站 → create → 真实 streamRun DB 回放 → send)。
@fellow.work/client@0.7.37FPP-0059:gateway-outbound-inbound.json + outbound-provider-fixtures.test.ts(discord / weixin 入站解析 golden · spec:channels:outbound-fixtures)。
@fellow.work/client@0.7.36FPP-0058:Gateway stream-replay.test.ts(RunManager.streamRun 从 StreamEvent 回放 · fromSequence · 合成终态)。
@fellow.work/client@0.7.35FPP-0057:Gateway dispatcher-runmanager-db.test.ts(Channels 入站 → RunManager.create → mock run.create)。
@fellow.work/client@0.7.34产品轨 P0–P5:open-platform-execution-plan-2026.md · FPP-0053–0056(录制收口 · Host/Ch/Interfaces/Mgmt MVP 文档)。
@fellow.work/client@0.7.33FPP-0052:Open Platform train exit v2(spec:monorepo:verify-protocol-exit-gate 取代仅 baseline)。
@fellow.work/client@0.7.32FPP-0051:spec:monorepo:verify-protocol-exit-gate(baseline + npm pack composite exit)。
@fellow.work/client@0.7.31FPP-0050:registry tarball 含 examples/verify-protocol.sh(spec:monorepo:verify-protocol-pack)。
@fellow.work/client@0.7.30FPP-0049:sdk/examples/verify-protocol.sh 为 monorepo smoke SoT(baseline v3 · 工作区脚本委派)。
@fellow.work/client@0.7.29FPP-0048:Monorepo verify-protocol.sh 含 train exit smoke(spec:monorepo:verify-protocol-baseline v2)。
@fellow.work/client@0.7.28FPP-0047:Open Platform 补丁列车 exit gate(spec:open-platform:train-exit-gate · 0045+0046)。
@fellow.work/client@0.7.27FPP-0046:Monorepo verify-protocol.sh baseline(Channels Hono + composite exit · spec:monorepo:verify-protocol-baseline)。
@fellow.work/client@0.7.26FPP-0045:Open Platform composite exit(Host 0043 + Channels 0044 · spec:open-platform:composite-exit-gate)。
@fellow.work/client@0.7.24FPP-0044:Channels Interfaces composite exit(spec:channels:interfaces-exit-gate · 录制 + Hono + taxonomy)。
@fellow.work/client@0.7.23FPP-0043:Host 治理 composite exit gate(spec:host:governance-exit-gate · 5 baseline gates)。
@fellow.work/client@0.7.22FPP-0042:Channels 平台分类 baseline(5 HTTP webhook · 2 outbound · spec:channels:platform-taxonomy)。
@fellow.work/client@0.7.21FPP-0041:Host placement id 与 Gateway capability token 分离 baseline(spec:host:catalog-separation)。
@fellow.work/client@0.7.20FPP-0040:Gateway 能力 opt-in env ↔ gateway/.env.example baseline(spec:gateway:capability-env-baseline)。
@fellow.work/client@0.7.19FPP-0039:Channels dispatcher Hono E2E(/api/channels/webhooks/* → ChannelDispatcher · spec:channels:dispatcher-hono-e2e)。
@fellow.work/client@0.7.18FPP-0038:Host 治理三轨 baseline(wire · Gateway header · placement 技能 · spec:host:governance-baseline)。
@fellow.work/client@0.7.17FPP-0037:Host placement / 技能目录 baseline(computer.use 等 4 host capabilities · spec:host:placement-catalog-baseline)。
@fellow.work/client@0.7.16FPP-0036:Channels webhook 录制 exit gate · spec:channels:recording-gate(FPP-0034 Complete · 9+5 cases)。
@fellow.work/client@0.7.15FPP-0034:dispatcher-inbound 收束 DingTalk / WeCom 加密 callback(v3 · 5 cases · 全 HTTP webhook 平台)。
@fellow.work/client@0.7.14FPP-0034:dispatcher-inbound 扩展 Feishu / Slack(v2 · 3 cases)。
@fellow.work/client@0.7.13FPP-0034:Channels dispatcher-inbound.json — Telegram webhook → ChannelDispatcher → Run → adapter.send 联调录制。
@fellow.work/client@0.7.12FPP-0034 扩展:Feishu im.message.receive_v1 p2p text ack(webhooks.json v6 · 9 cases)。
@fellow.work/client@0.7.11FPP-0035:Gateway Fellow-Gateway-Capabilities baseline fixture(3 scenarios · p5-gateway-capability-catalog-baseline;Host 技能目录仍非 Stable)。
@fellow.work/client@0.7.10FPP-0034 收束:DingTalk / WeCom GET URL 验证(echostr · webhooks.json v5 · 8 cases)。
@fellow.work/client@0.7.9FPP-0034:WeCom XML Encrypt callback DM 录制(webhooks.json v4 · 6 cases)。
@fellow.work/client@0.7.8FPP-0034:DingTalk 加密 callback DM 录制(webhooks.json v3 · 5 cases · query + encrypt body)。
@fellow.work/client@0.7.7FPP-0034 扩展:Telegram 私聊 Update · Slack IM message ack(webhooks.json v2 · 4 cases)。
@fellow.work/client@0.7.6FPP-0034:Channels Slack / Feishu url_verification webhook provider 录制 · webhooks.json · p5-channels-webhook-record。
@fellow.work/client@0.7.5Spec/docs:phase5-pr-scope / status.md 对齐 registry 0.7.4 治理基线(tarball 同步)。
@fellow.work/client@0.7.4治理:P5-04 / Python 主路径暂不推进(TS operator only)· channels-webhook-recording-readiness.md 草案。
@fellow.work/client@0.7.3Host Stable(FPP-0033)· host.lifecycle: stable · spec:host:stable-gate · v2 wire only。
@fellow.work/client@0.7.2Spec/docs:phase5-pr-scope @ 0.7.1 · host-stable-readiness.md · p5-04-multilanguage-readiness.md。
@fellow.work/client@0.7.1Interfaces Stable(FPP-0032)· interfaces.lifecycle: stable · spec:interfaces:stable-gate。
@fellow.work/client@0.7.0fpp-0026:根 AgUiMapper / AgUiCustomName / AgUiMapContext 已移除 · 请用 @fellow/ag-ui-adapter 或 /ag-ui · ag-ui.json#compat_reexport: removed。
@fellow.work/client@0.6.5Runtime Stable(FPP-0031)· runtime.lifecycle: stable · spec:runtime:stable-gate · Phase 3 opt-in 模块齐备 Stable。
@fellow.work/client@0.6.4Case Stable(FPP-0030)· case.lifecycle: stable · spec:case:stable-gate · case-protocol.mdx。
@fellow.work/client@0.6.3Object Stable(FPP-0029)· object.lifecycle: stable · spec:object:stable-gate · phase3 p3-object-stable-*。
@fellow.work/client@0.6.2Spec/docs:roadmap §11 registry 表 · object-stable-readiness.md;Open Platform 成熟度扫尾。
@fellow.work/client@0.6.1Control Stable(FPP-0017)· control.lifecycle: stable · 仍 opt-in · spec:control:stable-gate · Phase 4 Complete。
@fellow.work/client@0.6.0Interaction Stable(FPP-0028)· registry interaction.lifecycle: stable · 录制 residual waiver · Open Platform 文档同步。
@fellow.work/client@0.5.93catalog_skills_list_minimal · Gateway contracts:record 补齐 object/case/runtime provider cases。
@fellow.work/client@0.5.91FPP-0028 · spec:interaction:stable-gate · Interaction 录制缺口 / SemVer 草案文档。
@fellow.work/client@0.5.90Tarball 门禁:Management audit fixture + ag-ui.json / migration doc;Open Platform 文档对齐 0.5.89+ train。
@fellow.work/client@0.5.89fpp-0026 pre-flight:ag-ui.json 结构化 compat_reexport · 根 import 含 AgUiMapContext 门禁。
@fellow.work/client@0.5.88C1 audit SoT · verify-protocol.sh 证据 · phase5 矩阵更新。
@fellow.work/client@0.5.87spec:monorepo:pin · spec:fpp-0026:readiness · Gateway 全 package pin 校验。
@fellow.work/client@0.5.86Open Platform interfaces-protocol.mdx(Preview)· exit gate 链 website 文档。
@fellow.work/client@0.5.85P5-01 Interfaces MVP exit:spec:interfaces:exit-gate · fpp-0027 · protocol-registry#interfaces = preview。
@fellow.work/client@0.5.84Gateway MCP + Connectors boundary contract tests(test:interfaces-boundaries)。
@fellow.work/client@0.5.83MCP/Connectors boundary.json fixtures · AG-UI 双 import 门禁。
@fellow.work/client@0.5.81Adapter tarball 实验 · check-ag-ui-root-imports · Channels ingress Gateway tests。
@fellow/ag-ui-adapter@0.1.0独立 AG-UI mapper npm 包(@fellow.work/client/ag-ui subpath)。
@fellow.work/client@0.5.65Management Stable(fpp-0020 · 193 ops · /management)。
@fellow.work/client@0.5.44Fellow-Management-Version 健康头 + Stable 就绪清单(非 Stable 宣告)。
@fellow.work/client@0.5.43P5-02 Experimental 退出(双 provider 负向 auth 6/6)。
@fellow.work/client@0.5.42Gateway operator 负向 auth code + management-negative-auth-gateway.test.ts。
@fellow.work/client@0.5.41management-error-codes.md + negative-auth 门禁;pnpm management-smoke。
@fellow.work/client@0.5.40TS @fellow.work/client/management:call(operationId) + shadow management-openapi.d.ts。
@fellow.work/client@0.5.39Python catalog + smoke(可选路径)。
@fellow.work/client@0.5.38fellow-management 0.2.0:P0 HTTP client + smoke 脚本。
@fellow.work/client@0.5.37P5-04:Python fellow-management wire consumer + spec:runner:management:python。
@fellow.work/client@0.5.36Management Experimental stable-gate:FPP-0020、runbook、spec:management:stable-gate CI(非 Stable 宣告)。
@fellow.work/client@0.5.35Management Experimental inventory + schema 收官:191/191 ops;typed 2xx + request body(含 Skills multipart);wire m25-wire;spec:management:check generic 门禁。
@fellow.work/client@0.5.23Management Platform 顶层面:191 ops;m14-wire。
@fellow.work/client@0.5.22Management Gateway console 全 inventory:151 ops;m13-wire。
@fellow.work/client@0.5.21Management deployment 代理面扩展:97 ops — Platform deployment 子路由 proxy 批量 + fleet summary users/models/skills;m12-wire。
@fellow.work/client@0.5.20Management P3 实例代理:36 ops — users/apps 读写 + access/env;m11-wire。 — deployment users/apps create·patch·rotate-key 代理;m10-wire。
@fellow.work/client@0.5.19Management P3 实例代理(增量):28 ops — Gateway patchConsoleUser;Platform listPlatformDeploymentUsers / listPlatformDeploymentIntegrationApps;m9-wire。
@fellow.work/client@0.5.18Management / P5-02 Experimental batch Complete:management.openapi.yaml(25 ops) — Gateway console P0 + Platform login/fleet/audit + deployments list/get/provision/lifecycle/session/audit/logs;m8-wire(1:1 fixtures)、protocol-registry.json 联动、verify-pack-includes-management.mjs;Gateway/Console test:management + tarball contract。Control ≥ 0.5.17;smoke:sdk/examples/management-smoke.sh。
@fellow.work/client@0.5.17Control listReconciles;Phase 2/3 退出门禁与 conformance cli.mjs;Management 独立契约(16 ops)+ spec:management:check / spec:runner:management。
Gateway opt-inFELLOW_OBJECT=1、FELLOW_CONTROL=1 等;capability 见 兼容性。
规范状态SDK spec/status.md 与 spec/conformance/matrix/phase{3,4,5}.json 为工程侧变更索引。

信任与版本边界

Changelog 不是契约权威。线上 HTTP 行为以 Gateway 实现为当前事实依据,机器可读 Schema 建立后应成为生成与校验来源。安全修复可能要求立即升级;任何兼容层都不得绕过 Scope、Consent、租户隔离或资源归属检查。

当前可用

开发者目前应结合仓库发布说明、对应模块文档和实际部署版本核对变化。统一 Changelog 发布前,不应仅根据本页判断升级安全性。

相关文档