header-modify 是一个本地 Chrome 请求头修改插件，可以在浏览器请求发出前自动添加请求头参数。
- 全局模式：对所有请求添加 Header。
- 分组模式：按 URL 匹配规则添加 Header。
- 自动保存：编辑完成后自动保存并同步规则，不需要手动点击应用。
- 独立开关：全局 Header 和每个分组规则都可以单独启用或停用。
- 优先级规则：全局和分组可以同时生效；如果存在同名 Header，全局优先生效。
- 本地存储：配置保存在
chrome.storage.local，不上传到服务器。
远程仓库地址：
https://github.com/weiambt/header-modify
git clone https://github.com/weiambt/header-modify.git
cd header-modify- 打开 https://github.com/weiambt/header-modify。
- 点击页面右侧或顶部的
Code按钮。 - 点击
Download ZIP。 - 解压到本地任意目录。
- 确认解压后的目录里有
extension/manifest.json文件。
这个插件不需要构建步骤，也不需要启动服务。Chrome 直接加载 extension/ 目录即可。
header-modify/
├── extension/ # Chrome 直接加载这个目录
│ ├── manifest.json
│ ├── background.js
│ ├── popup.html
│ ├── popup.js
│ ├── options.html
│ ├── styles.css
│ └── src/
├── tests/ # 规则生成测试
├── README.md
├── package.json
├── preview-popup-quick.png
└── preview-popup-group.png
- 打开 Chrome，访问
chrome://extensions。 - 打开右上角的「开发者模式」。
- 点击「加载已解压的扩展程序」。
- 选择
header-modify/extension目录，也就是包含manifest.json的插件目录。 - 安装成功后，Chrome 工具栏会出现 Header Modify 插件。
本机当前目录示例：
/Users/didi/Desktop/个人工作空间/header-modify/extension
点击 Chrome 工具栏里的 Header Modify 图标，会打开插件弹窗。
- 切换到「全局」。
- 点击「新增 Header」。
- 填写 Header 名称和值，例如：
Header: X-Debug-Mode
Value: true
- 打开右上角全局开关后，全局 Header 会对所有请求生效。
- 切换到「分组」。
- 点击「新增规则」创建一个分组。
- 填写规则名和匹配地址。
- 在规则内添加 Header 参数。
- 打开该规则右侧开关后，这个分组规则会生效。
匹配地址示例：
*
localhost
||example.com/
- 全局模式和分组模式可以同时生效。
- 全局开关只控制全局 Header。
- 分组规则右侧开关只控制当前分组。
- 如果全局和分组设置了相同 Header 名，全局优先生效。
- 修改后会自动保存，新的请求会使用最新规则。
| 权限 | 用途 |
|---|---|
declarativeNetRequest |
使用 Chrome Manifest V3 动态规则修改请求头。 |
storage |
保存全局 Header、分组规则和开关状态。 |
<all_urls> |
允许插件将用户配置的 Header 应用到匹配的网页请求。 |
header-modify 是本地插件：
- 不需要账号。
- 不启动本地服务。
- 不向外部服务器上传配置。
- Header 配置只保存在浏览器本地的
chrome.storage.local。
如果你更新了项目代码：
- 打开
chrome://extensions。 - 找到 Header Modify。
- 点击「重新加载」按钮。
- 重新打开插件弹窗确认功能正常。
如果你是通过 Git 下载的项目，可以在项目目录执行：
git pull如果是重新下载的压缩包，先替换本地 header-modify 目录，再回到 chrome://extensions 点击「重新加载」。如果 Chrome 提示路径变化，重新选择 header-modify/extension 目录加载即可。
项目包含规则生成的基础测试：
npm test测试会验证全局/分组规则生成、开关行为、同名 Header 优先级和旧数据迁移逻辑。