簡介
API 的建構方式正在發生轉變。二十年來，操作者是在圖形介面中點擊的人，而 API 合約的消費者是閱讀文件的人。如今這兩端都在變化：
- 操作者越來越像是把意圖轉化為行動的 AI 助手；
- 消費者越來越像是透過 MCP 把 API 當作工具呼叫的 AI 代理。
定義了上一個時代的工具——API 用戶端、規範檢視器、請求集合——都是為坐在鍵盤前的人打造的。Powerduck 則為這個時代而生。它不是一個更好用的 API 用戶端，也不是一個更漂亮的規範檢視器，而是一個從一份 OpenAPI 檔案出發的 AI 原生平台。
核心：一份本機 OpenAPI 檔案
一切都始於你儲存庫中的一個普通 openapi.yaml——開放、可版本控制、人和 AI 都能閱讀。它不是專有資料庫，也不需要雲端帳號。
one local openapi.yaml
|
you + AI -> design debug test mock docs data-model
|
MCP tools
|
any AI coding agent
那一份檔案就是合約。每個工作流都從它讀取，同一份檔案還可以透過 MCP 交給任何 AI 程式設計代理——因此你、內建助手以及每個外部代理都共享同一個事實來源。當設計、除錯、測試、Mock 和文件都讀取同一份檔案時，「讓各工具保持同步」就不再是一項任務。這是設計帶來的結果，而非目標本身。
Powerduck 支援 OpenAPI 3.2，並透過就地升級來讀取已有的 3.0、3.1 文件（以及 Swagger 2.0）。非 HTTP API——SSE、WebSocket、GraphQL、gRPC 和 MCP——透過 x-protocol 擴充建模在普通的路徑項上，而不是被強行塞進僅支援 REST 的形態。
你如何與 AI 協作
- 打開一個 YAML，助手會立即建議你可以用它做什麼；
- 用平實的語言陳述結果——「建立訂單相關介面」「準備測試資料」「執行結帳流程並給我一份報告」——助手會選擇合適的工具並提出變更；
- 每一項變更都以可審閱的卡片呈現；在你核准之前不會套用任何內容；
- 當你細化某個 API 時，助手會停留在該 API 上，只改動你要求的部分，而不會在整份文件中漂移；
- 可接入任何相容 OpenAI 的模型。在桌面端，提示詞和密鑰永遠不會離開你的機器。
預設本機優先
Powerduck 在你的機器上執行，打開並儲存真實檔案，可離線工作，並讓 API 密鑰和提示詞遠離瀏覽器。雲端是用於分享和發布的選用擴充，從不是開始使用的前提。
使用 Powerduck 的三種方式
| 形態 | 它是什麼 | 最適合 |
|---|---|---|
| 桌面用戶端 | 一個本機優先的 Electron 應用程式，內建 AI 助手和完整的 API 工作區 | 希望一切都在自己機器上、離線工作、密鑰和提示詞保留在本機的工程師 |
| Powerduck Cloud | 用於 OAS 託管、線上文件和託管 MCP 的雲端服務 | 與他人共享 API、發布穩定連結，以及無需執行任何程式即可提供 MCP |
| 開源函式庫 | 可組合的 @powerduck/* npm 套件 | 建構你自己的工具、CI 管線或嵌入式元件 |
三種形態共享相同的引擎：桌面用戶端和雲端都由開源函式庫組裝而成，因此無論你在本機執行、透過網路呼叫還是直接引入套件，同一個能力的表現都一致。
桌面用戶端
桌面用戶端完全在你的機器上執行。它打開並編輯磁碟上的真實檔案，透過本機程序發送請求，執行本機 Mock，並讓你的 AI 提示詞和 API 密鑰遠離瀏覽器主控台。模型完全由你配置，每個提議的變更在套用前都以可審閱的卡片呈現。
Powerduck Cloud
Powerduck Cloud 把同樣的工作流搬到線上。新增檔案、Git 儲存庫或 URL；選擇要暴露哪些操作；然後獲得渲染文件的穩定連結和託管的 MCP 端點。存取可以用檢視密碼或 MCP 存取密鑰保護，付費計畫增加了 Git 同步、自訂網域和更高的額度。
開源函式庫
這些函式庫是底層引擎：OpenAPI 剖析器與升級器、多協定 CLI、程式碼產生器、MCP 伺服器、請求執行器、cURL 與 Postman 轉換器，以及可嵌入的編輯器。每個套件都在 npm 上獨立發布，帶有自己的安裝指南和 API 參考——底層技術細節都在這裡。
對你意味著什麼
- 你指揮結果，而不是點擊。 描述目標，助手透過可審閱的步驟完成工作。
- 你的 API 天然面向代理就緒。 產生文件的同一份合約也產生 MCP 工具，因此 AI 代理從第一天起就能正確呼叫你的 API。
- 沒有漂移。 設計、除錯、測試、Mock 和文件都讀取同一份檔案。
- 所有協定集中一處。 HTTP、SSE、WebSocket、GraphQL、gRPC 和 MCP 存在於單一規範中，而不是六個工具裡。
- 無鎖定。 自帶模型，桌面端密鑰保留在本機，並擁有儲存庫中那份普通的 YAML。