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，以便有效隔离并修复问题。