一条规则，让 FAT 前端直连 UAT 后端——不改代码、不改 CORS

它拦截页面发出的 API 请求，并把请求送到别处。在研发场景里，通常就是让一个连着某个后端的前端页面改连另一个环境，于是不改应用代码、不重新部署，也能在 FAT 页面上验证只有 UAT 才有的修复。

页面主世界的拦截器会接管 fetch、XMLHttpRequest 与 WebSocket，相对地址在匹配前先解析为绝对地址。仅重写 URL 的规则会被编译成 declarativeNetRequest 重定向，由浏览器对匹配的各类资源生效：主文档与子框架、XHR、脚本、样式、图片、字体、媒体与其他。

通配符把 * 视为任意字符，并把结尾 * 捕获的内容拼接到目标地址之后；前缀匹配 URL 开头，把剩余部分拼到目标之后；正则要覆盖整个 URL 才能让两条通道结果一致——后台通道只替换模式命中的那一段，网络层则整条替换，因此建议用 ^ 锚定并把结尾写成 (.*)$。多条规则同时命中时，优先级数值小者优先，数值相同则按规则列表里的先后顺序，请给每条规则不同的数值。

内容脚本注入到所有 http 与 https 页面，规则按请求 URL 匹配，因此内网系统、localhost 开发服务、预发域名都适用。chrome:// 页面、Chrome 应用商店与其他扩展页面被浏览器统一限制，任何扩展都无法注入。

使用了任一高级能力（请求头覆盖、请求体覆盖、响应覆盖、Mock、延迟、阻断、重试、方法过滤、查询参数注入、WebSocket）的规则，由持有主机权限的扩展后台上下文发出请求，页面拿到的是扩展构造的响应，因此不会触发页面侧的 CORS 校验。仅重写 URL 的规则走网络层重定向，浏览器仍会校验重定向后响应的 Access-Control-Allow-Origin。若目标环境不允许你的源，给规则加上任一高级能力（加一个响应头覆盖代价最小）即可切到后台通道。

因为网络层表达不了你想要的行为。不以 * 结尾的通配符、目标地址为空，或者带了任一高级能力，都会被刻意路由到后台通道——若强行编译成重定向，结果会被悄悄改变。URL 匹配测试器会在你依赖某条规则之前，把任意 URL 的转发通道显示出来。

只重写 URL 的规则单请求零 JavaScript 开销，由浏览器网络栈直接完成重定向。走后台通道的请求会多一次扩展内的中转，外加你配置的延迟，单个代理请求有 30 秒上限。用户编写的正则会先做嵌套量词 ReDoS 检测，送往网络层的正则还需通过 Chrome 的 RE2 校验——一条不支持的正则会让整批规则安装失败，因此在同步前就被过滤掉。

网络层重定向不会经过扩展，没有可记录的逐条请求。规则级命中数会出现在「DNR 命中统计」里，统计窗口为最近 5 分钟；Chrome 对该读取接口有配额限制，因此面板改为手动刷新，超出配额时静默保留上一次结果。后台通道的命中数单独统计。

一条规则可以挂多组条件——URL 正则、HTTP 方法、查询参数——首个命中的条件决定响应体、状态码与 Content-Type，全部不命中时回落到规则的默认响应体。于是一条规则就能替多个接口、或同一接口的多种状态兜底。Mock 请求完全不触网，返回状态码被钳制在 200–599。

阻断让请求以网络故障的方式失败，用来验证离线兜底与重试逻辑；改写响应状态码则给你一个真实的 HTTP 错误码、状态文本与响应头，用来验证依赖状态码的错误渲染。被阻断的请求不会被原生回退重放——否则发出去的正是你要压掉的那个请求。

重试是规则级开关，运行在后台通道。开启后，规则在首次请求之外追加 1 至 5 次尝试，间隔可在 100 至 30000 毫秒之间设置（默认 1000 毫秒）。某次尝试抛出异常（包括触及单请求 30 秒上限被中止）、或返回 5xx 且仍有剩余次数时触发重试；次数用尽后把最后一次响应或错误交回页面。因为重试属于后台通道能力，启用重试的规则永远不会被判定为网络层重定向。

可以。导出为 JSON 配置，默认开启分享模式——自动剔除 Authorization、Cookie 等请求头与响应头、以及 token 类查询参数，需要本机全量备份时取消勾选即可原样导出；同事导入时可选择覆盖，也可与现有规则合并；可把捕获到的流量导出为 HAR 1.2，也可导入别处抓的 HAR 自动生成规则；粘贴一条 cURL 命令（DevTools「复制为 cURL」产物）即可预填规则表单。环境配置快照会保存整套规则的命名副本。

最多 200 条规则，最近 500 条请求日志，请求体上限 10 MB，延迟 0 至 60000 毫秒，重试默认关闭、开启后追加 1 至 5 次尝试且间隔 100 至 30000 毫秒，单个代理请求 30 秒上限，Mock 与改写的状态码钳制在 200–599，以保证页面总能构造出合法的 Response 对象。

页面会回退到浏览器原生的 fetch、XMLHttpRequest 或 WebSocket，请求照常发出，表现如同规则不存在。FormData、Blob、ArrayBuffer 等非字符串请求体无法跨消息通道传递，同样回退原生。唯一的例外是阻断规则：被阻断的请求绝不会被原生回退重放。

不会。规则、日志、环境快照与偏好设置都保存在本机的 chrome.storage.local 里。扩展不含统计埋点、不上传任何数据，也没有自有远程服务，唯一的网络流量就是你让它代理的 API 流量。需要留意的是，请求日志会在本机记录被代理的请求头与请求体（可能含 token），在分享导出的 HAR 或复制的 cURL 命令之前请先检查。

面向 Chrome（Manifest V3）构建与验证。Edge 支持 Chromium 扩展，同一份构建通常可用；Firefox 的 Manifest V3 在 declarativeNetRequest 上存在差异，目前不是支持目标。