Aidog Request Inspect

aidog-request-inspect

按 request id 从 Aidog 本地数据库读取单条代理请求的完整链路（入站请求 → 协议转换 → 上游请求 → 上游响应 → 回客户端），用于调试某次请求。

何时用

• 用户给出一个 request id（32 位 hex，如 fcd9eb36533f4f0ba4344f3cdc6cf530）要看详情。
• 排查某次请求为什么失败 / 慢 / token 异常 / 路由到哪个平台 / 协议怎么转的。
• 列最近 N 条请求，或筛失败请求（按状态码 / group）。

数据源

• 库：~/.aidog/log.db（SQLite，运行时开启 WAL；config-db-split 后 proxy_log 从 aidog.db 移入 log.db）。
• 表：proxy_log，主键 id 即 request id；一次请求一行；deleted_at=0 为有效行。
• 脚本以只读连接（mode=ro），不锁库、不干扰运行中的 aidog。

用法

脚本在本 skill 目录下：.claude/skills/aidog-request-inspect/req_inspect.py

# 查单条详情（摘要 + 各 body，body 默认截断 4000 字符，headers 脱敏）
python3 .claude/skills/aidog-request-inspect/req_inspect.py <request_id>

# 不截断 body（看完整请求/响应体）
python3 .claude/skills/aidog-request-inspect/req_inspect.py <request_id> --full

# 原始 JSON（机读，不格式化不脱敏 —— 谨慎，含明文密钥）
# 🔴 CHECKPOINT：--raw 输出含明文 Authorization / api-key / cookie。执行前必须确认：
#   仅本地排查、不外传、不贴入任何对外汇报或第三方。默认改用脱敏模式（去掉 --raw）。
python3 .claude/skills/aidog-request-inspect/req_inspect.py <request_id> --raw

# 列最近 N 条（默认 10）
python3 .claude/skills/aidog-request-inspect/req_inspect.py --recent 20

# 筛失败请求 / 按 group
python3 .claude/skills/aidog-request-inspect/req_inspect.py --recent 20 --status 400
python3 .claude/skills/aidog-request-inspect/req_inspect.py --recent 20 --group glm-coding-plan-auto

# 覆盖库路径（非默认位置）
python3 .claude/skills/aidog-request-inspect/req_inspect.py <request_id> --db /path/to/log.db

输出包含

单条详情：

• 摘要：时间 / group / model→actual_model / source→target 协议 / platform_id / client+upstream 状态码 / 耗时 / stream / retry / tokens / est_cost / client URL / upstream URL
• 重试链（attempts）：每次尝试的 platform / status / 耗时 / error
• 入站请求 headers（脱敏）+ body
• 上游请求 headers（脱敏）+ body（看协议转换后实际发上游的内容）
• 上游响应 headers + 响应 body

约定与注意

• 脱敏：headers 里 authorization / x-api-key / x-goog-api-key / api-key / cookie 等自动打码（头尾各留 4 字符）。--raw 模式不脱敏，仅在确需原始密钥排查时用，输出含敏感信息。
• body 截断：默认 4000 字符，--full 看全部。流式响应 body 可能很大。
• WAL：默认只读连接能读到未 checkpoint 的最新行；若读不到刚发生的请求，确认 aidog 在跑 + id 正确。
• 找不到：报错提示 id 不存在或已被 retention 清理（aidog 的 retention 会清空字段或删行，见项目 CLAUDE.md「Proxy 日志」）。

禁止清单（反模式）

• 🔴 禁把 --raw 输出（含明文密钥）贴入对外汇报、issue、PR、聊天、截图或任何第三方/外部渠道。
• 🔴 禁粘贴任何未脱敏的 authorization / x-api-key / x-goog-api-key / api-key / cookie 值。
• 默认用脱敏模式（不带 --raw）排查；仅在确需原始密钥比对时才临时本地使用 --raw，用后不留存。
• 禁用本脚本以外的方式直连/写库；脚本为只读（mode=ro），禁改写 proxy_log。
• 引用请求详情对外说明时，只引脱敏后的字段（状态码 / 协议 / token / 耗时 / 平台 / 错误信息），不引原始 header 值。

字段速查（proxy_log 关键列）