HTTPeep CLI SKILLS. HTTP API Deubgger ｜ Give the agent the ability to see the network. — HTTPeep CLI 技能。HTTP API 调试器 ｜ 为代理提供查看网络的能力。

HTTPeep CLI 概述 使用 httpeep-cli 从终端操作 HTTPeep，用于本地调试、自动化、CI 检查和代理工作流。对于 Codex 必须解析或总结的命令，建议使用 --format json。有关详细标志、示例和命令特定注释，请阅读 references/cli-reference.md。

操作工作流 在进行更深入的调试之前，验证 CLI 和代理状态： httpeep-cli --version httpeep-cli --format json proxy status httpeep-cli proxy logs --lines 50 根据任务启动或修复捕获： httpeep-cli proxy start --port 8800 httpeep-cli proxy system status httpeep-cli cert status 仅当用户需要系统范围的代理时，才使用代理系统。对于范围内的交互式终端捕获，建议使用 httpeep-cli shell 或 hp shell；它启动或重用代理并进入带有 HTTPeep 代理变量和运行时钩子的子 shell。对于非交互式代理执行，建议使用显式应用代理环境变量或 proxy start --capture-pid ，以免代理阻塞在交互式 shell 中。

捕获和检查流量： httpeep-cli --format json sessions list --keyword login httpeep-cli --format json sessions watch --domain api.example.com 在进行破坏性清理之前使用过滤器。尽可能进行 dry-run 删除： httpeep-cli sessions delete --keyword login --dry-run httpeep-cli sessions clear --all --yes --dry-run

为可复制的测试应用临时规则，然后更改全局规则集： httpeep-cli rules run \ --map-remote "api.example.com=http://127.0.0.1:3000" \ -- httpeep-cli request --method GET --url "https://api.example.com/users" 仅当需要持久规则时，才使用 rules upsert、rules import、rules replace 或 rules reset。导出现有规则，然后再进行破坏性更改： httpeep-cli rules export --output rules-backup.json

发送、重放或记录请求： httpeep-cli --format json request --method GET --url "https://api.example.com/v2/users" httpeep-cli replay --id --retry-times 3 --retry-interval-ms 800 httpeep-cli record start httpeep-cli record stop --output baseline.httpeep httpeep-cli replay file baseline.httpeep

故障排除 按照以下顺序检查故障： CLI 可用性：httpeep-cli --version 代理引擎可达性：httpeep-cli --format json proxy status 最近的代理日志：httpeep-cli proxy logs --lines 100 应用路由：HTTP_PROXY、HTTPS_PROXY 或 httpeep-cli proxy system status HTTPS 信任：httpeep-cli cert status，然后 httpeep-cli cert install 如果需要 终端捕获 shell：httpeep-cli shell / hp shell 创建 ~/.httpeep/automatic-setup/ 并在子 shell 中暴露 httpeep_intercept_off 输出解析：重新运行相关命令以 --format json；记住 sessions watch --format json 发出 NDJSON 如果 httpeep-cli 不在 PATH 中，指示用户打开 HTTPeep 桌面设置并使用设置 -> MCP -> 修复 CLI / PATH 安装，或调用 MCP 修复工具（如果可用）。

跟踪证据 对于复杂的调试或多步骤捕获/重放工作，在最终答案或任务注释中记录一个简洁的跟踪日志： 执行的命令，包括重要标志 每个主要步骤的时间戳或序列顺序 使用或生成的会话 ID 来自 sessions list、request、rules run 或 replay 的相关 JSON 字段 httpeep-cli proxy logs --lines 的摘要（当涉及代理行为时） 应用的规则 ID 或临时规则快捷方式 避免记录来自头部、cookie、Authorization 值或请求正文的机密。报告之前请编辑敏感值。

安全默认值 首选使用 rules run、request 或 replay --id 的临时规则，然后再进行持久规则编辑。使用 --format json 进行机器解析和 CI 日志。除非用户明确希望交互式 shell，否则不要从未attended 自动化路径运行 httpeep-cli shell；它故意占用终端，直到 shell 退出。首先进行 dry-run 破坏性会话清理。导出规则，然后再进行 rules replace 或 rules reset。仅当用户明确要求证书信任或系统范围的代理更改时，才运行 cert install、cert uninstall、proxy system on 和 proxy system off。仅当用户明确要求持久替换、重置或完全清理时，才运行 rules replace、rules reset 或 sessions clear --all --yes。尽可能显示或运行备份/干运行命令。将 import curl、import har 和 import http 视为版本依赖，因为某些 CLI 构建可能会报告这些命令尚未实现。