用途：帮助排查 OpenRouter API 调用失败，按 HTTP 状态与错误码定位根因并给出修复方向。
主要能力：涵盖 400 bad_request、invalid_model、context_length_exceeded、401 invalid_api_key、402 insufficient_credits、403 key_disabled、408 request_timeout、429 rate_limit_exceeded、502 provider_error、503 model_unavailable 等错误码的成因与修复；说明错误响应体包含 error.code、error.message 与 error.metadata.provider_name。
使用方式：先按状态码查表定位，再查看响应体；运行诊断脚本检查鉴权、剩余额度、模型是否存在并发起一次 1-token 最小请求。诊断脚本关键命令：curl -s https://openrouter.ai/api/v1/auth/key -H "Authorization: Bearer $OPENROUTER_API_KEY"；curl -s https://openrouter.ai/api/v1/models | jq '.data[].id'。生产调用可用 safe_completion() 包装（max_retries=3 自动重试 429 与 5xx），发送前用 validate_before_send() 校验模型 ID、消息格式与上下文长度。
前置条件：OPENROUTER_API_KEY（sk-or-v1- 开头）、curl 与 jq、Python 3.8+ 及 OpenAI SDK、Node.js 18+；使用预检需 requests 包。
限制：技能本身不代管密钥与额度；重试与是否换 provider 需自行配置；模型与费用信息以其返回数据为准，其余未提供。