请求修改器

About

1. 插件简介
请求修改器是一款专为开发者设计的强大浏览器扩展工具，支持Chrome和Edge浏览器。该插件旨在帮助开发者在开发调试过程中灵活地修改浏览器发出的网络请求，包括请求重定向和请求头修改功能。通过直观的界面和强大的规则系统，开发者可以轻松实现URL重定向、请求头注入等常见调试需求，提升开发效率。

1.1 核心功能
请求重定向：将匹配到的URL请求重定向到指定的目标地址，适用于开发环境地址切换、端口调整等场景
请求头修改：对匹配到的请求添加、修改或删除请求头，可用于模拟特定请求头、注入认证信息等
规则管理：支持规则的启用/禁用、编辑和删除，灵活控制调试行为
实时测试：提供URL测试功能，可实时预览URL重定向结果，验证规则正确性
数据同步：所有规则数据通过浏览器扩展的同步存储保存，同一账号下多设备自动同步

1.2 技术架构
Manifest版本：3
核心权限：
declarativeNetRequest：声明式网络请求API，用于修改网络请求
declarativeNetRequestWithHostAccess：带主机访问权限的声明式网络请求API
storage：浏览器存储API，用于保存规则数据
主机权限：<all_urls>，允许对任意URL进行请求修改
后台服务：Service Worker，确保扩展在后台持续运行
用户界面：弹出窗口(index.html)和图标(icon_disabled.png)

2. 功能详细介绍
2.1 请求重定向
请求重定向功能允许开发者将匹配到的URL请求重定向到指定的目标地址，常用于开发环境地址、端口切换等场景。

2.1.1 使用方法
请求重定向采用URL地址查找替换机制，具体操作步骤如下：
添加规则：在规则列表中添加新的重定向规则
设置匹配值：输入要匹配的字符串，支持正则表达式
设置替换值：输入要替换的字符串，支持正则替换语法。留空则将匹配内容替换为空串
启用/禁用：通过开关控制单条规则是否生效
编辑规则：点击"编辑"按钮进入编辑模式，修改后点击"保存"
删除规则：点击"删除"按钮移除规则

2.1.2 示例
将所有https://www.baidu.com的请求重定向到https://www.taobao.com：
字段	值	
匹配值	baidu	
替换值	taobao	
这样，只要在浏览器请求的地址包含baidu，都将其替换为taobao。

2.1.3 URL测试
在规则列表上方的测试区域输入待测试的URL，可以实时预览URL重定向结果，方便验证规则是否正确。

2.2 请求头修改
请求头修改功能允许开发者对匹配到的请求添加、修改或删除请求头，常用于模拟特定请求头、注入认证信息等场景。

2.2.1 使用方法
添加规则：在规则列表中添加新的请求头修改规则
设置匹配URL：输入要匹配的URL字符串，只要URL包含则匹配，支持正则表达式。留空表示对所有请求生效
设置请求头名称：输入要操作的请求头参数名称，如Authorization
设置请求头值：要设置的请求头参数的值
启用/禁用：通过开关控制单条规则是否生效
编辑规则：点击"编辑"按钮进入编辑模式，修改后点击"保存"
删除规则：点击"删除"按钮移除规则（需二次确认）

2.2.2 示例
为所有请求添加Authorization头：
字段	值	
匹配URL	留空	
Header 名称	Authorization	
Header 值	Bearer your-token	

2.2.3 限制说明
由于Chrome Manifest V3的declarativeNetRequest API限制，当前版本暂不支持响应头修改功能。后续如Chrome放开限制将及时支持。

2.3 禁止修改的请求头
浏览器出于安全考虑，以下请求头无法通过扩展修改：
请求头	说明	
Host	HTTP协议核心头，由浏览器自动设置	
Origin	防止CSRF攻击，浏览器禁止伪造	
Referer	受浏览器Referrer-Policy控制	
Cookie	受SameSite等安全策略限制	
Connection	连接管理头，由浏览器控制	
Keep-Alive	持久连接头，由浏览器控制	
Accept-Charset	已废弃，浏览器不再支持修改	
Accept-Encoding	编码协商头，由浏览器控制	
Access-Control-Request-Headers	CORS预检头，由浏览器自动设置	
Access-Control-Request-Method	CORS预检头，由浏览器自动设置	
以Sec-开头的头	安全相关头，浏览器禁止修改	
以Proxy-开头的头	代理相关头，浏览器禁止修改	
如需修改以上请求头，建议使用本地代理工具（如Fiddler、Charles、mitmproxy）。

3. 使用场景
3.1 开发环境调试
本地开发服务器：将生产环境的API请求重定向到本地开发服务器
端口切换：在不同端口之间快速切换测试
模拟不同环境：模拟生产、测试、开发等不同环境的API响应

3.2 API测试
模拟认证：为API请求添加认证头，测试需要认证的接口
请求头调试：修改请求头，测试API对不同请求头的处理
URL重定向测试：验证URL重定向规则是否正确

3.3 跨域调试
CORS调试：通过修改请求头，测试CORS策略
代理调试：将请求重定向到代理服务器，进行跨域调试

4. 安装与配置
4.1 安装步骤
从Chrome Web Store安装：
访问Chrome Web Store
搜索"请求修改器"
点击"添加至Chrome"按钮
确认安装
从本地文件安装：
下载插件安装包（.crx文件）
在Chrome/Edge浏览器中打开扩展程序管理页面
启用"开发者模式"
拖拽.crx文件到扩展程序管理页面进行安装
确认安装并启用插件

4.2 基本配置
图标状态：插件图标显示为禁用状态时，表示所有规则未生效
弹出窗口：点击插件图标可打开主界面，查看和编辑规则
权限设置：确保已授予必要的权限（如网络请求修改权限）

5. 使用指南
5.1 添加重定向规则
打开插件弹出窗口
点击"添加规则"按钮
选择"重定向规则"类型
填写匹配值和替换值
启用规则
测试URL，验证规则是否正确

5.2 添加请求头规则
打开插件弹出窗口
点击"添加规则"按钮
选择"请求头规则"类型
填写匹配URL、请求头名称和值
启用规则
测试请求，验证请求头是否正确添加

5.3 规则管理
启用/禁用：通过开关控制单条规则是否生效
编辑规则：点击"编辑"按钮进入编辑模式，修改后点击"保存"
删除规则：点击"删除"按钮移除规则（需二次确认）

6. 常见问题解答
6.1 为什么某些请求头无法修改？
由于浏览器安全策略限制，部分请求头（如Host、Origin、Cookie等）无法通过扩展修改。这是为了防止安全风险，如CSRF攻击、隐私泄露等。

6.2 规则修改后何时生效？
规则修改后立即生效，无需重启浏览器。但请注意，某些缓存机制可能导致延迟生效。

6.3 如何备份规则数据？
规则数据通过Chrome同步存储保存，同一账号下多设备自动同步。你也可以手动导出规则数据（JSON格式）进行备份。

6.4 插件支持哪些浏览器？
目前支持Chrome和Edge浏览器。其他基于Chromium的浏览器可能也支持，但未经过全面测试。

6.5 插件是否安全？
是的，插件仅请求必要的权限（网络请求修改和存储），不会收集用户的浏览数据或个人信息。所有规则数据都保存在本地，不会上传到任何服务器。

7. 安全和隐私声明
7.1 权限说明
declarativeNetRequest：用于修改网络请求，仅用于请求重定向和请求头修改
storage：用于保存规则数据，仅保存在本地，不会上传到任何服务器

7.2 数据保护
所有规则数据通过Chrome同步存储保存，同一账号下多设备自动同步
规则数据仅保存在本地，不会收集用户的浏览数据或个人信息
插件不会访问或修改用户的敏感信息

7.3 安全措施
插件采用最小权限原则，仅请求必要的权限
规则数据加密存储，保护用户隐私
定期更新，修复安全漏洞

注意：本插件仅供开发调试使用，请勿用于非法目的。使用本插件所产生的任何法律问题，由用户自行承担。