header-modify

header-modify 是一个本地 Chrome 请求头修改插件，可以在浏览器请求发出前自动添加请求头参数。

主要功能

• 全局模式：对所有请求添加 Header。
• 分组模式：按 URL 匹配规则添加 Header。
• 自动保存：编辑完成后自动保存并同步规则，不需要手动点击应用。
• 独立开关：全局 Header 和每个分组规则都可以单独启用或停用。
• 优先级规则：全局和分组可以同时生效；如果存在同名 Header，全局优先生效。
• 本地存储：配置保存在 chrome.storage.local，不上传到服务器。

界面预览

全局模式

分组模式

下载插件

远程仓库地址：

https://github.com/weiambt/header-modify

方式一：使用 Git 下载

git clone https://github.com/weiambt/header-modify.git
cd header-modify

方式二：下载 ZIP 压缩包

1. 打开 https://github.com/weiambt/header-modify。
2. 点击页面右侧或顶部的 Code 按钮。
3. 点击 Download ZIP。
4. 解压到本地任意目录。
5. 确认解压后的目录里有 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

1. 打开 Chrome，访问 chrome://extensions。
2. 打开右上角的「开发者模式」。
3. 点击「加载已解压的扩展程序」。
4. 选择 header-modify/extension 目录，也就是包含 manifest.json 的插件目录。
5. 安装成功后，Chrome 工具栏会出现 Header Modify 插件。

本机当前目录示例：

/Users/didi/Desktop/个人工作空间/header-modify/extension

使用方式

点击 Chrome 工具栏里的 Header Modify 图标，会打开插件弹窗。

全局模式

1. 切换到「全局」。
2. 点击「新增 Header」。
3. 填写 Header 名称和值，例如：

Header: X-Debug-Mode
Value: true

4. 打开右上角全局开关后，全局 Header 会对所有请求生效。

分组模式

1. 切换到「分组」。
2. 点击「新增规则」创建一个分组。
3. 填写规则名和匹配地址。
4. 在规则内添加 Header 参数。
5. 打开该规则右侧开关后，这个分组规则会生效。

匹配地址示例：

*
localhost
||example.com/

生效规则

• 全局模式和分组模式可以同时生效。
• 全局开关只控制全局 Header。
• 分组规则右侧开关只控制当前分组。
• 如果全局和分组设置了相同 Header 名，全局优先生效。
• 修改后会自动保存，新的请求会使用最新规则。

权限说明

权限	用途
declarativeNetRequest	使用 Chrome Manifest V3 动态规则修改请求头。
storage	保存全局 Header、分组规则和开关状态。
<all_urls>	允许插件将用户配置的 Header 应用到匹配的网页请求。

隐私说明

header-modify 是本地插件：

• 不需要账号。
• 不启动本地服务。
• 不向外部服务器上传配置。
• Header 配置只保存在浏览器本地的 chrome.storage.local。

更新插件

如果你更新了项目代码：

1. 打开 chrome://extensions。
2. 找到 Header Modify。
3. 点击「重新加载」按钮。
4. 重新打开插件弹窗确认功能正常。

如果你是通过 Git 下载的项目，可以在项目目录执行：

git pull

如果是重新下载的压缩包，先替换本地 header-modify 目录，再回到 chrome://extensions 点击「重新加载」。如果 Chrome 提示路径变化，重新选择 header-modify/extension 目录加载即可。

开发验证

项目包含规则生成的基础测试：

npm test

测试会验证全局/分组规则生成、开关行为、同名 Header 优先级和旧数据迁移逻辑。