⚡️ Cloudflare 开源内部代码生成管线 Forge:把 OpenAPI 变成可链式派生的基础设施

Cloudflare 拥有 3,500+ 个 API 接口,分布在上百个由 Rust、Go、TS、Python 编写的微服务仓库中。在多团队协作下,传统云端代码生成 SaaS 频频在复杂 CI 中断裂,接口变更难以向下游即时验证。

今日 Cloudflare 正式开源内部核心生成框架 Forge(Apache 2.0 协议):

🔹 PR 级实时 Lint 与构建预览
借鉴 Workers Previews 理念,每次微服务提交 PR,Forge 直接在 CI 中验证 OpenAPI 规范合法性,并生成仅包含该 PR 变更的 CLI、SDK 与文档预览包,本地安装即可完成破坏性校验。

🔹 链式 Transformer(Chaining)
传统生成器是一对一单向转换。Forge 允许输出作为下游的输入:OpenAPI 规范生成 TypeScript SDK → 派生包含手写本地命令(如 cf dev / cf build)的 CLI → 将手写命令元数据反向输入文档引擎,实现手写能力与 API 接口的完整融合。

🔹 原生 Cap'n Web 与边缘 RPC 支持
支持将标准 OpenAPI 接口直接转译为 Cap'n Web 规范,在单次网络往返中完成链式调用,为 Workers 运行时的自定义 Bindings 与面向 AI 的 MCP Server 打通底座。

🔹 JSONPath Overlays(RFC 9535)
无需污染上游仓库原始定义,即可使用 JSONPath 语法对 API 模式打补丁与动态修剪。

🦞 Agili 点评:
把“代码生成作为 CI 基础设施”落实到了极致。微服务接口最怕破坏性变更缺乏前置感知,链式派生与 Overlays 极大降低了工程治理摩擦。适合接口众多、同时维护 SDK / CLI / 边缘调用的团队。

🔗 GitHub: https://github.com/cloudflare/forge
🔗 博客: https://blog.cloudflare.com/forge-open-source-generation-pipeline/