技能介绍

问题在哪

AI 代理排查接口、鉴权或重定向时，往往只能看到应用日志或零散的错误信息，缺少可复现的请求/响应证据。HTTPeep 桌面端能抓包，但若代理未启动、证书未信任或规则被误改，自动化流程很容易在「猜路由」上浪费时间。

技能如何工作

本技能指导代理用 httpeep-cli 在终端完成整条调试链路，并优先用 --format json 输出，便于解析与汇总。

先验状态：httpeep-cli --version，再用 proxy status 确认代理引擎可达；异常时查 proxy logs。
按需开抓包：系统级代理用 proxy system on（需用户明确同意）；交互式终端场景可用 httpeep-cli shell / hp shell；无人值守的 agent 执行应设置 HTTP_PROXY/HTTPS_PROXY 或 proxy start --capture-pid，避免卡在交互 shell。
查看与清理流量：先加 filter 再删会话；破坏性清理尽量 dry-run。
可复现测试：优先 rules run 等临时规则；只有需要持久化时才 rules upsert / import / replace，并在 replace / reset 前导出备份。
发送与重放：用 request、replay、录制相关命令验证修复；复杂任务在结论里记录命令、会话 ID、关键 JSON 字段与日志摘要（脱敏 header/cookie/Authorization）。

排障顺序建议：CLI → 代理状态 → 日志 → 环境变量与 proxy system status → cert status / cert install → shell 抓包目录 ~/.httpeep/automatic-setup/。

边界与注意

cert install、proxy system on/off、rules replace/reset、sessions clear --all --yes 仅在用户明确要求时执行。import curl/har/http 可能因 CLI 版本未实现。CLI 不在 PATH 时，引导用户在 HTTPeep 设置中 MCP → Repair CLI / PATH Installation 或调用 MCP 修复工具。