Developer Docs

文档首页
本地开发与调试Mock、Fixtures 与回放Conformance 测试打包与版本Registry 与发布升级与迁移

开发文档 · 测试与发布

Conformance 测试

SDK、Gateway、Host 与 Connector 一致性测试的目标和当前边界。

成熟度：Partial（仓库内） — Interaction 与 opt-in 域已有 fixture + CI；尚无对外认证的统一报告格式或「Fellow Conformance」标记。

目标

用机器可执行测试证明实现符合对应协议版本，而不是仅凭类型、示例或单个官方应用判断兼容性。

当前可用

Monorepo 内已具备可重复的机器证据（不等同于对外认证）：

  • SDK： pnpm spec:check（OpenAPI/schema、各模块 stable-gate、Interfaces/Channels 子门禁、verify-protocol baseline/pack/exit、open-platform train exit、phase2–5 matrix:check）；conformance runner（verify-bundle、consumer、adapter；provider 需 FELLOW_GATEWAY_ROOT）；pnpm test:phase3；Control 客户端测试。
  • Gateway： @fellow/api provider contract tests；Channels ingress / webhook 录制 / dispatcher Hono E2E；@fellow/gateway Channels fixture 回放与 RunManager 回归（FPP-0057–0060）；pnpm protocol:phase3；pnpm protocol:control；contracts:test-sdk-package / contracts:test-management-sdk-package 对 registry tarball 的隔离校验。
  • Fixture 源： @fellow.work/client 发布包内的 spec/conformance/**（含 adapter manifests、phase 矩阵；见 Fixtures）。

Fellow 多仓 sibling checkout 根目录：bash scripts/verify-protocol.sh（SoT 脚本在 sdk/examples/verify-protocol.sh）聚合 SDK spec:check 与 Gateway 协议测试。

Developer 文档 canonical：docs/developer/（fellowos/docs）；Website 直接读取 sibling ../docs/developer（见 website/scripts/resolve-open-platform-docs-dir.ts），不再维护 website/content/open-platform/ MDX 副本。

因此，现阶段可以运行项目测试并引用 matrix 行（phase2.json–phase5.json），不能据此宣称“通过 Fellow 官方 Conformance 认证”或“七个模块均已 Stable”。

边界

  • 每个协议模块独立判定，Interaction 的测试不能证明 Runtime、Host 或 Management 兼容。
  • 服务端 HTTP 行为以 Gateway 实现为当前事实；手写 SDK 类型不能反向定义服务端。
  • 原生流式基线是 Fellow StreamEvent SSE；AG-UI 映射只验证 adapter。
  • Control / Object / Case / Runtime 为 Stable opt-in（≥ 0.6.1 / 0.6.3 / 0.6.4 / 0.6.5）；均默认关闭。
  • HARP 文档列出的合规断言是目标规范；公开 fixture 和跨宿主套件完成前，不构成完整认证。

未来能力

Planned： 对外发布按模块和协议版本划分的测试包、统一 report schema 认证标记、Host Adapter / Connector / HARP 跨宿主套件。每个模块进入 Preview 前，应具备机器可读契约、稳定错误语义和主要一致性检查；进入 Stable 前还需版本承诺、迁移与运维验证。

相关文档