response-compliance

response-compliance 是一項專為維護或擴展 LobeHub Response API 的開發人員所設計的工程工具。它能自動執行官方的 OpenResponses 測試套件，確保您的本地或遠端 API 實作嚴格遵循所需的架構與行為規範。此工具對於 CI/CD 流程、除錯架構差異以及在部署前驗證核心 LLM 互動模式至關重要。

• 執行針對 /api/v1/responses 端點的標準化測試套件，涵蓋基礎文字生成與串流生命週期驗證。

• 驗證複雜的回應結構，例如工具呼叫協議 (tool calling)、系統提示處理、多模態圖片輸入與多輪對話歷史紀錄。

• 支援多種驗證模式，包括模擬開發使用者、API 金鑰以及自訂標頭，提供靈活的整合測試配置。

• 提供詳細的冗長輸出 (verbose) 與 JSON 報告功能，非常適合互動式除錯與自動化品質保證工作流程。

• 自動同步測試環境，透過複製並更新官方 openresponses 測試執行器儲存庫來保持測試基準最新。

• 使用注意事項：執行測試前，請確保您的本地開發伺服器已開啟 ENABLE_MOCK_DEV_USER=true。

• 輸入要求：有效的端點 URL (例如 http://localhost:3010) 與適當的驗證旗標 (如 --auth-header, --api-key)。

• 失敗分析：若測試因 Zod 驗證錯誤、缺少輸出項目或認證重新導向問題而失敗，請使用 -v 旗標來檢查完整的請求與回應負載。

• 篩選測試：使用 --filter 旗標來鎖定特定場景，例如 streaming-response、tool-calling 或 system-prompt，以便有效隔離並修復問題。