Merge branch 'master' into dev

Author: sylingd

docs/docs/en-US/guide/FAQ.md

@@ -8,6 +8,22 @@ On Chrome, you'll see this prompt when the response body modification feature is
 * Disable "Modify Response Body" in "Options".
 * Add the `--silent-debugger-extension-api` parameter when running Chrome.
 
+## Why is "header name" reduced to lowercase?
+
+[RFC 2616](https://tools.ietf.org/html/rfc2616.html#section-4.2) says:
+
+> Each header field consists of a name followed by a colon `(":")` and the field value. Field names are case-insensitive.
+
+So, since 4.0.0, Header Editor will reduce "header name" to lowercase. Except for custom functions: the custom function will still get the original header (except that it has been modified by other rules)
+
+## Response header modification not taking effect
+
+The modified response header will not be displayed in the developer tools. This result is inaccurate. Please refer to the actual result for accuracy.
+
+For example, modify `content-type` to `text/plain` will make the webpage display as plain text. This indicates that the modification has been successful, but the developer tools still display `text/html`.
+
+![2025-09-03_115619.png](https://img10.360buyimg.com/ddimg/jfs/t1/325127/5/15269/85767/68b7bc80F3d770c5e/45cdb64f42625693.jpg)
+
 ## All rules are ineffective
 
 In rare cases, some rules may fail to initialize due to syntax errors, resulting in all rules being ineffective.
@@ -27,14 +43,6 @@ Firefox:
 * Find the corresponding rule and error message.
 ![img](https://img13.360buyimg.com/ddimg/jfs/t1/289605/39/18012/32092/68a4ae2cFa61f9a6a/9be7525f36abe945.jpg)
 
-## Why is "header name" reduced to lowercase?
-
-[RFC 2616](https://tools.ietf.org/html/rfc2616.html#section-4.2) says:
-
-> Each header field consists of a name followed by a colon `(":")` and the field value. Field names are case-insensitive.
-
-So, since 4.0.0, Header Editor will reduce "header name" to lowercase. Except for custom functions: the custom function will still get the original header (except that it has been modified by other rules)
-
 ## Can I delete a header in a simple way?
 
 Yes, just modify it to `_header_editor_remove_`

docs/docs/zh-CN/guide/FAQ.md

@@ -8,6 +8,22 @@ title: FAQ
 * 在“选项”中禁用“修改响应体”。
 * 运行 Chrome 时，添加`--silent-debugger-extension-api`参数。
 
+## 为什么“头名称”变成小写了？
+
+[RFC 2616](https://tools.ietf.org/html/rfc2616.html#section-4.2)中写到:
+
+> Each header field consists of a name followed by a colon `(":")` and the field value. Field names are case-insensitive.
+
+因此，从4.0.0开始，Header Editor会将“头名称”变为小写。但自定义函数除外：除了已被其他规则修改的头外，自定义函数获取到的仍然是原始头
+
+## 响应头修改不生效
+
+开发者工具中不会显示修改后的响应头，此结果不准确，请以实际结果为准。
+
+例如将`content-type`修改为`text/plain`可以让网页显示为纯文本，可以看出实际已经修改成功，但开发者工具中仍然显示为`text/html`。
+
+![2025-09-03_115619.png](https://img10.360buyimg.com/ddimg/jfs/t1/325127/5/15269/85767/68b7bc80F3d770c5e/45cdb64f42625693.jpg)
+
 ## 所有规则都不生效
 
 极少数情况下，部分规则因为存在语法问题，会导致初始化失败，致使所有规则都不生效。
@@ -27,14 +43,6 @@ Firefox:
 * 找到报错提示，查看规则、错误信息。
 ![img](https://img13.360buyimg.com/ddimg/jfs/t1/289605/39/18012/32092/68a4ae2cFa61f9a6a/9be7525f36abe945.jpg)
 
-## 为什么“头名称”变成小写了？
-
-[RFC 2616](https://tools.ietf.org/html/rfc2616.html#section-4.2)中写到:
-
-> Each header field consists of a name followed by a colon `(":")` and the field value. Field names are case-insensitive.
-
-因此，从4.0.0开始，Header Editor会将“头名称”变为小写。但自定义函数除外：除了已被其他规则修改的头外，自定义函数获取到的仍然是原始头
-
 ## 我能以简单的方式删除头吗?
 
 可以，只需将其修改为`_header_editor_remove_`

docs/docs/zh-TW/guide/FAQ.md

@@ -8,6 +8,22 @@ title: FAQ
 * 在「選項」中停用「修改回應主體」。
 * 在執行 Chrome 瀏覽器時新增 `--silent-debugger-extension-api` 參數。
 
+## 為什麼“標頭名稱”會被縮減為小寫？
+
+[RFC 2616](https://tools.ietf.org/html/rfc2616.html#section-4.2) 規定：
+
+> Each header field consists of a name followed by a colon `(":")` and the field value. Field names are case-insensitive.
+
+因此，從 4.0.0 版本開始，Header Editor 會將“標頭名稱”縮減為小寫。自訂函數除外：自訂函數仍將取得原始 header（除非它已被其他規則修改）。
+
+## 修改回應頭不生效
+
+修改後的回應頭不會顯示在開發者工具中。此結果不準確，請以實際結果為準。
+
+例如，將“content-type”變更為“text/plain”會導致網頁顯示為純文字。這表示修改成功，但開發者工具仍然顯示“text/html”。
+
+![2025-09-03_115619.png](https://img10.360buyimg.com/ddimg/jfs/t1/325127/5/15269/85767/68b7bc80F3d770c5e/45cdb64f42625693.jpg)
+
 ## 所有規則均無效
 
 在極少數情況下，某些規則可能會因為語法錯誤而無法初始化，導致所有規則都無效。

scripts/pack-utils/amo.mjs

@@ -4,7 +4,7 @@ import { setTimeout as sleep } from 'node:timers/promises';
 import { signAddon } from 'amo-upload';
 import { last } from 'lodash-es';
 import { path as _path, getVersion } from '../config.mjs';
-import { copyDir, fileExists } from '../utils.mjs';
+import { copyDir, fileExists, getNote } from '../utils.mjs';
 import { createZip } from '../zip.mjs';
 
 let packingSourceCode = null;
@@ -114,8 +114,7 @@ export async function submitAddon(
   const opts = {
     apiKey: process.env.AMO_KEY,
     apiSecret: process.env.AMO_SECRET,
-    approvalNotes:
-      'https://github.com/FirefoxBar/HeaderEditor/blob/master/README.md',
+    approvalNotes: getNote(),
     override: false,
     pollInterval: 8000,
     pollRetry: 9999,

scripts/pack-utils/cws.mjs

@@ -20,9 +20,11 @@ async function packCws({ zipPath, extensionConfig }) {
     clientSecret: process.env.CWS_CLIENT_SECRET,
   });
 
-  return client.submit({
+  const res = await client.submit({
     filePath: zipPath,
   });
+
+  return JSON.stringify(res);
 }
 
 export default packCws;

scripts/pack-utils/edge.mjs

@@ -1,5 +1,6 @@
 import { createReadStream } from 'node:fs';
 import { EdgeAddonsAPI } from '@plasmohq/edge-addons-api';
+import { getNote } from '../utils.mjs';
 
 export default async function ({ zipPath, extensionConfig }) {
   if (!process.env.MS_CLIENT_ID) {
@@ -19,9 +20,7 @@ export default async function ({ zipPath, extensionConfig }) {
   console.log('[edge] upload done', uploadResp);
   const uploadStatus = await client.waitForUpload(uploadResp);
   console.log('[edge] upload check success', uploadStatus);
-  const publishResp = await client.publish(
-    'https://github.com/FirefoxBar/HeaderEditor/blob/master/README.md',
-  );
+  const publishResp = await client.publish(getNote());
   console.log('[edge] publish done', publishResp);
   return JSON.stringify(await client.getPublishStatus(publishResp));
 }

scripts/utils.mjs

@@ -66,3 +66,12 @@ export function copyDir(source, target) {
     );
   });
 }
+
+export function getNote() {
+  const repo = process.env.GITHUB_REPOSITORY;
+  const runId = process.env.GITHUB_RUN_ID;
+  if (repo && runId) {
+    return `Submit via GitHub Actions: https://github.com/${repo}/actions/runs/${runId}`;
+  }
+  return 'https://github.com/FirefoxBar/HeaderEditor/blob/master/README.md';
+}