用途：当 OpenRouter 请求失败或返回异常结果时，生成结构化调试包，便于定位失败、异常响应或延迟问题。核心关联键是响应中的生成 ID（gen-* 前缀），可通过 GET /api/v1/generation?id= 查询精确成本、所用供应商与延迟。
主要能力：先用常见检查排除环境问题（用 /api/v1/auth/key 验证密钥、用 /api/v1/models 确认模型存在、查看 status.openrouter.ai）；用 curl -v 复现并捕获完整请求/响应头与正文；提取生成 ID 并查询生成元数据；在应用内调用 Python 的 debug_request() 捕获请求、响应、错误、延迟与环境数据为 DebugBundle，并用 bundle.save("debug_bundle.json") 保存；按错误处理表匹配症状（缺少生成 ID、502/503、model_not_found、TTFT 慢）。
使用方式：需 OPENROUTER_API_KEY（sk-or-v1-...）、curl 与 jq，Python 3.8+ 及 openai、requests 包，以及可复现的失败请求。快速调试命令示例：curl -v https://openrouter.ai/api/v1/chat/completions -H "Authorization: Bearer $OPENROUTER_API_KEY" ... | tee /tmp/openrouter-debug.txt；随后 GEN_ID=$(jq -r '.id' /tmp/openrouter-debug.txt) 并查询生成元数据。
输出：/tmp/openrouter-debug.txt 完整 curl 记录、生成元数据 JSON、debug_bundle.json（含时间戳、生成 ID、请求模型/消息/参数、响应状态与内容、错误类型/消息/代码、latency_ms、生成元数据、环境信息）以及三项常见检查的单行 JSON 结果。
限制与注意：分享前必须脱敏 API 密钥（sk-or-v1-... -> sk-or-v1-[REDACTED]）；联系 OpenRouter 支持时附上生成 ID；元数据为空可等 1-2 秒后用同一密钥重试；502/503 多为上游故障，可查状态页或换供应商；model_not_found 需核对模型 ID；TTFT 慢可改用流式或 :floor 变体。具体收费、价格与平台支持情况暂未提供。