-
- Official Website
-
-
-
- Official Website
-
-
-
+本仓库在其早期源码基础上做了以下改造：
-## Features
+- **迁移到 Manifest V3**：后台页改为 Service Worker，请求/响应头修改改用 `declarativeNetRequest`（DNR）动态规则实现。
+- **存储层迁移**：状态从 `localStorage` 迁移到 `chrome.storage.local`（MV3 的 Service Worker 无法访问 `localStorage`），并保留对旧数据的一次性自动迁移。
+- **精简**：移除了云备份、捐赠、推广提示等无用功能与相关死代码、冗余资源。
-* Add/modify/remove request headers and response headers
-* Enable header modification based on URL/resource type
-* Add comments to header
-* Multiple different profiles
-* Sorting headers by name, value, or comments
-* Append value to existing request or response header
-* Export and import header
-* Clone profile
-* Cloud backup
-* Tab locking!
+前端仍保留原有的 AngularJS + Angular Material 界面。
-## Screenshots
+## 功能
-
+- 增加 / 修改 / 删除**请求头**与**响应头**
+- 按 **URL 正则**或**资源类型**限定生效范围（Filter）
+- 多套 **Profile** 配置，可快速切换
+- 给每条 header 添加**备注**
+- 按名称 / 值 / 备注**排序**
+- 在已有 header 值后**追加**（拼接 / 逗号拼接）
+- **导出 / 导入** Profile（JSON）
+- **克隆** Profile
+- **Tab 锁**：仅对指定标签页生效
+- **暂停**：一键临时停用全部修改
-## Forking and contribution
+## 安装 / 本地开发
-Feel free to send pull requests to add new features to ModHeader. It will benefit everyone! That said, I reserve the rights to reject pull requests that does not seem useful, or if they add too much complexity for very little benefits.
+无需任何构建工具，直接加载 `src` 目录即可：
-You may fork and redistribute ModHeader for a small group of friends / colleagues, but please do not impersonate ModHeader, or try to sell it for a profit. If you use ModHeader in any commercial product, please let me know.
+1. 浏览器打开 `chrome://extensions`
+2. 打开右上角**开发者模式**
+3. 点击**加载已解压的扩展程序**，选择本仓库的 `src` 目录
+4. 修改代码后，回到该页面点扩展卡片上的**刷新（↻）**即可重新加载
-## Installation
+## 使用方法
-ModHeader does not require any extra tool for building. Simply load the src directory into Chrome / Firefox to start local development.
+1. 点击工具栏中的 ModHeader 图标打开弹窗。
+2. 点右上角 **+**：
+ - **Request header**：添加请求头（如 `User-Agent`、`Authorization` 等）
+ - **Response header**：添加响应头（如 `Access-Control-Allow-Origin`）
+ - **Filter**：添加生效条件（URL 正则或资源类型）
+3. 勾选每行左侧的复选框以**启用**该条修改；填写 Name / Value。
+4. 打开目标网站并刷新，在 DevTools 的 **Network** 面板中即可确认头已被修改。
+5. 图标上的**数字角标**表示当前生效的 header 数量。
-## Selenium usage
+### 生效范围说明
-If you need to use ModHeader for Selenium tests, please visit: https://github.com/hao1300/modheader_selenium
+- **不加 Filter**：对所有 URL 生效。
+- **URL Pattern**：填写正则（如 `https://example\.com/.*`），仅匹配的请求生效；多条之间为「或」的关系。
+- **Resource Type**：仅对选中的资源类型（main_frame、xmlhttprequest 等）生效。
+- **Tab 锁**：点弹窗中的 “Tab lock”，修改将只作用于当前标签页。
+
+## 目录结构
+
+```
+src/
+├── manifest.json # MV3 清单
+├── background.js # Service Worker：DNR 规则生成、角标、右键菜单
+├── popup.html # 弹窗界面
+├── scripts/
+│ ├── main.js # AngularJS 逻辑 + storage.local 适配层
+│ └── angular*.min.js # AngularJS 1.7.8 及其模块（官方，MIT）
+├── styles/ # 样式
+├── images/ # 图标
+└── *.tmpl.html # 各对话框模板
+```
+
+## 已知限制
+
+- `declarativeNetRequest` 的 `append` 操作对部分请求头有限制，遇到不支持的 header 时该规则会失败并在 Service Worker 控制台打印错误。
+- Tab 锁通过 DNR 的 **session 规则** + `tabIds` 实现，浏览器重启后会失效（符合预期）。
+
+## 许可
+
+沿用原项目的 **MIT** 许可。
diff --git a/src/background.js b/src/background.js
index 78a4762..317e63e 100644
--- a/src/background.js
+++ b/src/background.js
@@ -1,397 +1,307 @@
-const browser = chrome;
-const SPECIAL_CHARS = '^$&+?.()|{}[]/'.split('');
-const MAX_PROFILES_IN_CLOUD = 50;
-const CHROME_VERSION = getChromeVersion();
-const EXTRA_REQUEST_HEADERS = new Set(['accept-language', 'accept-encoding', 'referer', 'cookie']);
-const EXTRA_RESPONSE_HEADERS = new Set(['set-cookie']);
-let currentProfile;
-let tabUrls = {};
-
-/**
- * Check whether the current request url pass the given list of filters.
- */
-function passFilters_(url, type, filters) {
- if (!filters) {
- return true;
- }
- let allowUrls = false;
- let hasUrlFilters = false;
- let allowTypes = false;
- let hasResourceTypeFilters = false;
- for (let filter of filters) {
- if (filter.enabled) {
- switch (filter.type) {
- case 'urls':
- hasUrlFilters = true;
- if (url.search(filter.urlRegex) == 0) {
- allowUrls = true;
- }
- break;
- case 'types':
- hasResourceTypeFilters = true;
- if (filter.resourceType.indexOf(type) >= 0) {
- allowTypes = true;
- }
- break;
- }
- }
- }
- return (!hasUrlFilters || allowUrls)
- && (!hasResourceTypeFilters || allowTypes);
-};
-
-function loadSelectedProfile_() {
- let appendMode = false;
- let headers = [];
- let respHeaders = [];
- let filters = [];
- if (localStorage.profiles) {
- const profiles = JSON.parse(localStorage.profiles);
- if (!localStorage.selectedProfile) {
- localStorage.selectedProfile = 0;
- }
- const selectedProfile = profiles[localStorage.selectedProfile];
-
- function filterEnabledHeaders_(headers) {
- let output = [];
- for (let header of headers) {
- // Overrides the header if it is enabled and its name is not empty.
- if (header.enabled && header.name) {
- output.push({name: header.name, value: header.value});
- }
- }
- return output;
- };
- for (let filter of selectedProfile.filters) {
- if (filter.urlPattern) {
- const urlPattern = filter.urlPattern;
- const joiner = [];
- for (let i = 0; i < urlPattern.length; ++i) {
- let c = urlPattern.charAt(i);
- if (SPECIAL_CHARS.indexOf(c) >= 0) {
- c = '\\' + c;
- } else if (c == '\\') {
- c = '\\\\';
- } else if (c == '*') {
- c = '.*';
- }
- joiner.push(c);
- }
- filter.urlRegex = joiner.join('');
- }
- filters.push(filter);
- }
- appendMode = selectedProfile.appendMode;
- headers = filterEnabledHeaders_(selectedProfile.headers);
- respHeaders = filterEnabledHeaders_(selectedProfile.respHeaders);
- }
- return {
- appendMode: appendMode,
- headers: headers,
- respHeaders: respHeaders,
- filters: filters
- };
-};
-
-function modifyHeader(source, dest) {
- if (!source.length) {
- return;
- }
- // Create an index map so that we can more efficiently override
- // existing header.
- const indexMap = {};
- for (const index in dest) {
- const header = dest[index];
- indexMap[header.name.toLowerCase()] = index;
- }
- for (let header of source) {
- const index = indexMap[header.name.toLowerCase()];
- if (index !== undefined) {
- if (!currentProfile.appendMode) {
- dest[index].value = header.value;
- } else if (currentProfile.appendMode == 'comma') {
- if (dest[index].value) {
- dest[index].value += ',';
- }
- dest[index].value += header.value;
- } else {
- dest[index].value += header.value;
- }
- } else {
- dest.push({name: header.name, value: header.value});
- indexMap[header.name.toLowerCase()] = dest.length - 1;
- }
- }
-};
-
-function modifyRequestHeaderHandler_(details) {
- if (localStorage.isPaused) {
- return {};
- }
- if (details.type == 'main_frame' && details.url && details.tabId) {
- tabUrls[details.tabId] = details.url;
- localStorage.activeTabId = details.tabId;
- browser.tabs.get(details.tabId, onTabUpdated);
- }
- if (!localStorage.lockedTabId
- || localStorage.lockedTabId == details.tabId) {
- if (currentProfile
- && passFilters_(details.url, details.type, currentProfile.filters)) {
- modifyHeader(currentProfile.headers, details.requestHeaders);
- }
- }
- return {requestHeaders: details.requestHeaders};
-};
-
-function modifyResponseHeaderHandler_(details) {
- if (localStorage.isPaused) {
- return {};
- }
- if (!localStorage.lockedTabId
- || localStorage.lockedTabId == details.tabId) {
- if (currentProfile
- && passFilters_(details.url, details.type, currentProfile.filters)) {
- const serializedOriginalResponseHeaders = JSON.stringify(details.responseHeaders);
- const responseHeaders = JSON.parse(serializedOriginalResponseHeaders);
- modifyHeader(currentProfile.respHeaders, responseHeaders);
- if (JSON.stringify(responseHeaders) != serializedOriginalResponseHeaders) {
- return {responseHeaders: responseHeaders};
- }
- }
- }
-};
-
-function getChromeVersion() {
- let pieces = navigator.userAgent.match(/Chrom(?:e|ium)\/([0-9]+)\.([0-9]+)\.([0-9]+)\.([0-9]+)/);
- if (pieces == null || pieces.length != 5) {
- return {};
- }
- pieces = pieces.map(piece => parseInt(piece, 10));
- return {
- major: pieces[1],
- minor: pieces[2],
- build: pieces[3],
- patch: pieces[4]
- };
-}
-
-function setupHeaderModListener() {
- browser.webRequest.onBeforeSendHeaders.removeListener(modifyRequestHeaderHandler_);
- browser.webRequest.onHeadersReceived.removeListener(modifyResponseHeaderHandler_);
-
- // Chrome 72+ requires 'extraHeaders' to be added for some headers to be modifiable.
- // Older versions break with it.
- if (currentProfile.headers.length > 0) {
- let requiresExtraRequestHeaders = false;
- if (CHROME_VERSION.major >= 72) {
- for (let header of currentProfile.headers) {
- if (EXTRA_REQUEST_HEADERS.has(header.name.toLowerCase())) {
- requiresExtraRequestHeaders = true;
- break;
- }
- }
- }
- browser.webRequest.onBeforeSendHeaders.addListener(
- modifyRequestHeaderHandler_,
- {urls: ["
- 
-