Lockspec

讓編碼助理從你的 OpenAPI 規格取得依版本固定的 API 契約資訊，使產生的呼叫符合真實端點與型別。

可以做什麼

可從檔案、URL 或文字載入 OpenAPI 3.0 或 3.1 規格，進行正規化與索引，並固定為帶版本的快照。工具支援依意圖或路徑尋找操作、尋找具名 schema、讀取精確的請求與回應簽章，並對照固定規格對草稿請求做結構驗證。也可列出已載入規格、切換作用中版本、移除某個規格或版本，以及對兩個版本做破壞性／非破壞性差異比較。

適用情境

當助理要針對私有、內部、第三方、體積過大或不在儲存庫中的 API 規格撰寫程式碼時適用。也適合多個 API 版本同時上線、希望助理固定使用指定版本而非最近看到的版本的情境。

執行需求

透過 npx 執行的本機程序（npm 套件 lockspec），或從原始碼建置後執行；需要 Node 22 或更新版本。未宣告帳號、API 金鑰或環境變數。規格只抓取一次，之後從 ~/.lockspec/ 離線提供。