生活分享

Cloudflare 開源 Forge：一套可自動產生 SDK、CLI 與文件的生成流程

Cloudflare 於 2026 年 9 月 28 日宣布推出開源工具 Forge，可從 API 規格自動產生 SDK、命令列工具與文件。開發者可免費部署使用。Cloudflare 表示，它能讓工具與文件跟上 API 的每次變更，並在問題影響使用者前被發現。

閱讀時間約 6 分鐘

Cloudflare 開源 Forge：一套可自動產生 SDK、CLI 與文件的生成流程
圖片：Mokaair (Original editorial artwork)

Cloudflare 宣布了什麼

Cloudflare 於 2026 年 9 月 28 日在官方部落格發表文章，宣布推出 Forge，作者為 Dimitri Mitropoulos、Matt “TK” Taylor 與 Samuel Macleod。根據 Cloudflare，Forge 是一個開源、可插拔的生成流程。「可插拔」是指可以自行加入新的生成模組。它能自動產生 SDK（軟體開發套件，讓程式設計師更容易使用某項服務的程式庫）、CLI（命令列工具，在終端機輸入指令操作服務的程式）、文件與函式庫，任何人都可以免費部署與執行。

Cloudflare 表示，Forge 仍處於早期階段，但已用於產生 cf CLI 所需的輸出，並將在未來幾個月內支援 Cloudflare 的 API 文件、SDK 等。Cloudflare 也說明，開發 Forge 是為了把 AI 代理（能自行操作軟體完成任務的 AI 程式）當作客戶來服務。在它看來，CLI、API SDK、MCP 伺服器（讓 AI 代理連接並使用服務的介面）與相應文件，如今已是每種產品的基本配備。

Cloudflare 開源 Forge：一套可自動產生 SDK、CLI 與文件的生成流程
Mokaair 編輯查核流程 · 圖片：Mokaair (Original editorial artwork)
閱讀完整文字說明

消息會先蒐集來源、獨立查核，再交由 Jev 判斷。

為什麼 Cloudflare 要自己打造 Forge

API 是軟體之間互相溝通的介面。根據 Cloudflare，其 API 有超過 3,500 個操作（可呼叫的功能），背後數百個服務以 Rust、Go、TypeScript、Python 等多種語言撰寫。Cloudflare 表示，它曾試用數個託管產品，也曾在正式環境中依賴其中幾個，但都未能解決問題，部分產品甚至已完全停止服務。過去曾發生這樣的情況：某個團隊合併的變更意外破壞了生成流程，另一個團隊直到發布時才發現。

Cloudflare 表示，Forge 會在 CI（持續整合，每次修改程式碼時自動執行檢查與建置的流程）中，於各團隊的 API 儲存庫（存放程式碼的地方）執行。它會檢查每個變更，並產生只突顯該變更、可安裝測試的 CLI、文件與 SDK 預覽版本，讓問題在影響下游使用者之前被發現。

依據 Cloudflare 官方部落格整理，內容為 Cloudflare 單方說法
面向Cloudflare 描述的過去情況Cloudflare 描述的 Forge 做法
發現問題的時機變更可能在發布時才被另一團隊發現在 CI 中對每個變更檢查並產生預覽
工具控制權依賴無法掌控的託管工具，部分已停止服務開源、可自行免費部署執行
輸入格式Cloudflare 未說明目前支援 OpenAPI，設計上未來可支援 AsyncAPI、GraphQL、Cap’n Proto、Protobuf 等
輸出之間的關係其他生成器通常由工具決定串接方式轉換器可串接，由使用者自行控制

Forge 的主要設計特點

可產生多種輸出，包括 Cap’n Web

OpenAPI 是一種描述 API 功能的標準格式。Cloudflare 表示，Forge 可從 OpenAPI 規格直接產生 Cap’n Web。Cap’n Web 是 Cloudflare 的 RPC（遠端程序呼叫）系統，讓 TypeScript 程式能像呼叫本地方法一樣呼叫遠端 API。Cloudflare 舉例指出，同樣的方式也可用於產生 TanStack Query 綁定、Zod 或 Valibot 結構描述、MCP 伺服器等。

轉換器可以串接

根據 Cloudflare，Forge 的轉換器可以用一個目標的輸出去產生其他輸出，並讓使用者自行控制串接方式。Cloudflare 以 cf CLI 為例說明。cf CLI 以 TypeScript 撰寫，並包含 cf dev、cf build 等指令，這些是在自動生成的內容之上手寫加入的，需要呼叫 Vite 等套件的 TypeScript API。Cloudflare 表示找不到能把這類手寫指令回饋進文件的現有工具，因此正把這項功能建進 Forge。

與 API 版本管理的關係

根據 Cloudflare，其 v4 API 已是 10 年來唯一的主要版本。Cloudflare 表示正在研究一種版本管理方式，讓未來發布新的主要 API 版本時，不會破壞舊的客戶端或 SDK。Cloudflare 也表示，很快會公布更多關於 TypeScript、Rust、Python、Go、PHP 與 Terraform SDK 的消息。Terraform 是以程式碼管理雲端設定的工具，Cloudflare 表示會對 Terraform 的過渡格外謹慎。

對一般讀者與開發者的實際影響

  • 對一般使用者：這類工具主要在幕後運作。若 Cloudflare 所述目標實現，其 CLI、SDK 與文件可望更一致地跟上 API 變更，但這取決於後續實際成果。
  • 對開發者：Cloudflare 表示 Forge 是開源且可免費部署，理論上可用來為自家 API 產生 SDK、CLI 與文件。由於 Forge 仍在早期階段，評估前宜留意其成熟度。
  • 對 AI 代理生態：Cloudflare 認為 MCP 伺服器等讓 AI 代理使用的介面已是每種產品的基本配備，並希望每個人都能產生這些介面。
  • 對 Cloudflare 既有用戶：Cloudflare 提到將調整 API 版本管理與 SDK，其中包括 Terraform，後續公告值得留意。

常見問題

Forge 是什麼？

根據 Cloudflare，Forge 是一個開源、可插拔的生成流程，用來從 API 規格產生 SDK、CLI、文件與函式庫，任何人都可以免費部署與執行。

Forge 現在已經在實際使用嗎？

Cloudflare 表示 Forge 仍處於早期階段，但已用於產生 cf CLI 所需的輸出，並將在未來幾個月內支援 Cloudflare 的 API 文件與 SDK。

Forge 支援哪些輸入格式？

根據 Cloudflare，Forge 目前支援 OpenAPI，設計上未來可支援 AsyncAPI、GraphQL、Cap’n Proto、Protobuf 等其他輸入格式。

為什麼 Cloudflare 不繼續使用現有的託管工具？

Cloudflare 表示，它曾試用並依賴數個託管產品，但都無法滿足跨團隊、跨數百個儲存庫的需求，部分產品甚至已停止服務。

這會影響我目前使用的 Cloudflare API 或 Terraform 設定嗎？

Cloudflare 表示正在研究一種方式，能在不破壞舊客戶端或 SDK 的前提下發布新的主要版本，並將對 Terraform 過渡格外謹慎。不過具體細節尚未公布，建議留意 Cloudflare 後續的官方公告。

Forge 的說法經過獨立驗證了嗎？

沒有。本文資訊僅來自 Cloudflare 官方部落格，屬於該公司自身的說法。

查看同分類最新消息

同主題延伸閱讀

最新旅遊情報攻略

資料來源

生活分享