SchemaFit

工具介绍

## 這是什麼 你寫的 JSON Schema / tool definition 在 OpenAI 上好好的，一換 Anthropic 或 Gemini 就直接 400——還只告訴你失敗，不說哪條約束炸了。團隊只能手改、試錯、上線後才發現。SchemaFit 把這件事前置：用各家文件裡的約束做成版本化規則包，在本地/CI 靜態 lint 你的 schema，精確指出 JSON-Pointer 路徑、關鍵字和原因，失敗就非零退出攔 PR；還能 best-effort 修一版能過的 schema。全程不調模型、不需 API Key、零執行時依賴。 ## 能打的地方 - **多提供商靜態規則包**：覆蓋 OpenAI、Anthropic、Gemini、Mistral、Cohere，把 nested oneOf、缺 additionalProperties:false、default、minLength/format/pattern、anyOf 等已知坑編碼成可審查的宣告式規則，直接對你現有的原始 schema 檢查。 - **精確報錯 + CI 可執行**：輸出違規路徑、關鍵字、原因，exit code 非零讓 PR 掛掉；支援 SARIF 餵給 GitHub code-scanning。 - **自動 repair**：剝離或改寫違規關鍵字，儘量保留意圖，吐出 provider-valid 變體。 - **零依賴、可離線、可審計**：pip install 即用，demo 命令端到端可復現，無網路、無金鑰，方便 vendoring 進構建流水線。 - **規則漂移檢測（v0.5）**：可選 --live-verify 對照真實提供商，防止規則包落後於 API 變化。 ## 適合誰 · 誰不用碰 **適合**：同時對接多家 LLM、大量用 structured output / function calling / tool schema 的後端與 AI 應用團隊；已經把 schema 當代碼管、想在 CI 攔相容性坑的人。 **不用碰**：只用單一提供商且 schema 很簡單的人；純執行時動態修 schema 就夠、不在乎構建期攔截的人；非開發者。 ## 上手門檻 本地 CLI，核心完全離線，大陸使用者直接 `pip install schemafit` 即可，無需梯子、無需賬號、無需 Key。命令面清晰（lint / repair / providers / demo），對會寫 JSON Schema 的開發者幾乎零學習成本。介面與文件目前為英文。免費開源。 ## 和同類怎麼選 SchemaFit 定位是**構建期靜態 lint**，和 Instructor / BAML / LiteLLM / Vercel AI SDK 這類執行時客戶端是互補而非替代——後者擅長呼叫時歸一化/修復，前者在 schema 進提供商前就讓 CI 失敗。 | 維度 | SchemaFit | Instructor / LiteLLM 等 | |--------------|----------------------------|----------------------------------| | 核心定位 | 靜態 CI lint + repair | 執行時客戶端 / 呼叫時修復 | | 價格模式 | 開源免費 | 多為開源免費 | | 易用性 | 純 CLI，進 CI 直接用 | 庫/SDK，嵌進程式碼 | | 大陸可用性 | 本地離線，無障礙 | 同本地庫，無障礙 | 具體以各家官網為準。 ## 值不值得試 多模型 structured-output 團隊直接裝：十分鐘就能把“上線才 400”變成“PR 就掛”，值得立刻放進流水線。單提供商或 schema 極簡的可以先觀望。