网络请求修改器

后端没就绪，前端怎么测？

在 Web 开发与自动化调试中，前端逻辑往往严重依赖后端接口。当后端还未就绪，或者你需要复现某个特定的边缘 Case 时，直接修改浏览器发出的网络请求与响应往往是最高效的方案。但传统的抓包工具通常需要安装沉重的浏览器插件，不仅环境配置繁琐，也很难直接集成到 AI Agent 的自动化工作流中。

基于 CDP 的观察与改写

这个技能通过 Chrome DevTools Protocol (CDP) 直接驱动浏览器，无需安装任何插件。它将工作流严格划分为两个阶段：

• 观察模式（Observation）：当你还不清楚目标页面到底发送了什么请求时，先在此模式下抓取网络日志。它会输出 JSONL 格式的数据流，每行包含 requestId、url、method、statusCode 等核心字段。利用 resourceType 可以轻松过滤出 XHR 或 Fetch 请求，帮助 AI 快速分析网络特征。
• 拦截模式（Interception）：当你明确需要修改请求时，通过 STDIN 管道传入 JSON 规则配置。规则支持 allOf（AND）与 anyOf（OR）逻辑，并能指定 stage（request 或 response）。

你可以使用 block 屏蔽追踪脚本，用 setHeader 修改身份验证 Token，或者在响应阶段使用 patchBodyJson 修改接口返回的 JSON 数据。

执行约束与注意事项

• 观察优先：除非用户给出了极其明确的修改规则，否则必须先在观察模式下确认网络特征，再编写拦截规则。
• 长驻进程管理：核心脚本 twist 是一个类似 tail -f 的纯阻塞进程，它不会在执行完毕后自动退出。如果 Agent 在同步模式下等待其结束，将会陷入永久阻塞。
• 后台轮询机制：启动该技能后，必须使用后台机制运行，并通过非阻塞轮询的方式读取 stdout 输出。在拦截模式下，甚至不需要读取输出，等待用户在浏览器端完成验证后，再手动终止进程即可。