@nsnanocat/util 2.1.0 → 2.1.1

package/lib/app.mjs

@@ -1,7 +1,18 @@
 /**
- * Current app name
+ * 当前运行平台名称。
+ * Current runtime platform name.
  *
- * @type {("Quantumult X" | "Loon" | "Shadowrocket" | "Node.js" | "Egern" | "Surge" | "Stash")}
+ * 识别顺序:
+ * Detection order:
+ * 1) `$task` -> Quantumult X
+ * 2) `$loon` -> Loon
+ * 3) `$rocket` -> Shadowrocket
+ * 4) `module` -> Node.js
+ * 5) `Egern` -> Egern
+ * 6) `$environment["surge-version"]` -> Surge
+ * 7) `$environment["stash-version"]` -> Stash
+ *
+ * @type {("Quantumult X" | "Loon" | "Shadowrocket" | "Node.js" | "Egern" | "Surge" | "Stash" | undefined)}
  */
 export const $app = (() => {
 	const keys = Object.keys(globalThis);

package/lib/argument.mjs

@@ -1,6 +1,24 @@
 import { Console } from "../polyfill/Console.mjs";
 import { Lodash as _ } from "../polyfill/Lodash.mjs";
 
+/**
+ * 统一 `$argument` 输入格式并展开深路径。
+ * Normalize `$argument` input format and expand deep paths.
+ *
+ * 平台差异:
+ * Platform differences:
+ * - Surge / Stash / Egern 常见为字符串参数: `a=1&b=2`
+ * - Surge / Stash / Egern usually pass string args: `a=1&b=2`
+ * - Loon 支持字符串和对象两种形态
+ * - Loon supports both string and object forms
+ * - Quantumult X / Shadowrocket 一般不提供 `$argument`
+ * - Quantumult X / Shadowrocket usually do not expose `$argument`
+ *
+ * 执行时机:
+ * Execution timing:
+ * - 该模块为即时执行模块，`import` 时立即处理全局 `$argument`
+ * - This module executes immediately and mutates global `$argument` on import
+ */
 (() => {
 	Console.debug("☑️ $argument");
 	switch (typeof $argument) {

package/lib/done.mjs

@@ -4,10 +4,30 @@ import { Lodash as _ } from "../polyfill/Lodash.mjs";
 import { StatusTexts } from "../polyfill/StatusTexts.mjs";
 
 /**
- * Complete the script execution
+ * `done` 的统一入参结构。
+ * Unified `done` input payload.
  *
- * @export
- * @param {object} object
+ * @typedef {object} DonePayload
+ * @property {number|string} [status] 响应状态码或状态行 / Response status code or status line.
+ * @property {string} [url] 响应 URL / Response URL.
+ * @property {Record<string, any>} [headers] 响应头 / Response headers.
+ * @property {string|ArrayBuffer|ArrayBufferView} [body] 响应体 / Response body.
+ * @property {ArrayBuffer} [bodyBytes] 二进制响应体 / Binary response body.
+ * @property {string} [policy] 指定策略名 / Preferred policy name.
+ */
+
+/**
+ * 结束脚本执行并按平台转换参数。
+ * Complete script execution with platform-specific parameter mapping.
+ *
+ * 说明:
+ * Notes:
+ * - 这是调用入口，平台原生 `$done` 差异在内部处理
+ * - This is the call entry and native `$done` differences are handled internally
+ * - Node.js 不调用 `$done`，而是直接退出进程
+ * - Node.js does not call `$done`; it exits the process directly
+ *
+ * @param {DonePayload} [object={}] 统一响应对象 / Unified response object.
  * @returns {void}
  */
 export function done(object = {}) {

package/lib/environment.mjs

@@ -1,6 +1,28 @@
 import { $app } from "./app.mjs";
 
+/**
+ * 标准化后的运行环境对象。
+ * Normalized runtime environment object.
+ *
+ * - Surge/Stash/Egern: 基于全局 `$environment` 并补充 `app`
+ * - Surge/Stash/Egern: based on global `$environment` with `app` patched
+ * - Loon: 解析 `$loon` 得到设备与版本信息
+ * - Loon: parse `$loon` into device/version fields
+ * - Quantumult X: 仅返回 `{ app: "Quantumult X" }`
+ * - Quantumult X: returns `{ app: "Quantumult X" }` only
+ * - Node.js: 复用 `process.env` 并写入 `process.env.app`
+ * - Node.js: reuses `process.env` and writes `process.env.app`
+ *
+ * @type {Record<string, any>}
+ */
 export const $environment = environment();
+
+/**
+ * 获取标准化环境对象。
+ * Build and return the normalized environment object.
+ *
+ * @returns {Record<string, any>}
+ */
 export function environment() {
 	switch ($app) {
 		case "Surge":

package/lib/index.js

@@ -4,3 +4,15 @@ export * from "./done.mjs";
 export * from "./notification.mjs";
 export * from "./time.mjs";
 export * from "./wait.mjs";
+
+/**
+ * 已标准化的 `$argument` 快照。
+ * Normalized `$argument` snapshot.
+ */
+export const $argument = globalThis.$argument ?? {};
+
+/**
+ * 兼容别名（建议优先使用 `$argument`）。
+ * Backward-compatible alias (prefer `$argument`).
+ */
+export const argument = $argument;

package/lib/notification.mjs

@@ -2,20 +2,41 @@ import { $app } from "./app.mjs";
 import { Console } from "../polyfill/Console.mjs";
 
 /**
- * 系统通知
+ * 通知内容扩展参数。
+ * Extended notification content options.
  *
- * > 通知参数: 同时支持 QuanX 和 Loon 两种格式, EnvJs根据运行环境自动转换, Surge 环境不支持多媒体通知
- *
- * 示例:
- * $.msg(title, subtitle, body, "twitter://")
- * $.msg(title, subtitle, body, { "open-url": "twitter://", "media-url": "https://github.githubassets.com/images/modules/open_graph/github-mark.png" })
- * $.msg(title, subtitle, body, { "open-url": "https://bing.com", "media-url": "https://github.githubassets.com/images/modules/open_graph/github-mark.png" })
+ * @typedef {object|string|number|boolean} NotificationContent
+ * @property {string} [open] 打开链接 / Open URL.
+ * @property {string} ["open-url"] 打开链接 (QuanX) / Open URL (QuanX).
+ * @property {string} [url] 打开链接 / Open URL.
+ * @property {string} [openUrl] 打开链接 (Loon/Shadowrocket) / Open URL (Loon/Shadowrocket).
+ * @property {string} [copy] 复制文本 / Copy text.
+ * @property {string} ["update-pasteboard"] 复制文本 (QuanX) / Copy text (QuanX).
+ * @property {string} [updatePasteboard] 复制文本 / Copy text.
+ * @property {string} [media] 媒体 URL 或 Base64 / Media URL or Base64.
+ * @property {string} ["media-url"] 媒体 URL / Media URL.
+ * @property {string} [mediaUrl] 媒体 URL / Media URL.
+ * @property {string} [mime] Base64 媒体 MIME / MIME type for Base64 media.
+ * @property {number} ["auto-dismiss"] 自动消失秒数 / Auto dismiss seconds.
+ * @property {string} [sound] 提示音 / Notification sound.
+ */
+
+/**
+ * 发送系统通知并按平台适配参数格式。
+ * Send system notification with platform-specific payload mapping.
  *
- * @param {string} title 标题
- * @param {string} subtitle 副标题
- * @param {string} body 内容
- * @param {*} mutableContent 通知扩展字段
+ * 说明:
+ * Notes:
+ * - iOS App 平台调用 `$notification.post` 或 `$notify`
+ * - iOS app platforms call `$notification.post` or `$notify`
+ * - Node.js 不支持 iOS 通知接口，仅输出日志
+ * - Node.js does not support iOS notification APIs; it logs only
  *
+ * @param {string} [title=`ℹ️ ${$app} 通知`] 标题 / Title.
+ * @param {string} [subtitle=""] 副标题 / Subtitle.
+ * @param {string} [body=""] 内容 / Message body.
+ * @param {NotificationContent} [content={}] 扩展参数 / Extended content options.
+ * @returns {void}
  */
 export function notification(title = `ℹ️ ${$app} 通知`, subtitle = "", body = "", content = {}) {
 	const mutableContent = MutableContent(content);
@@ -39,6 +60,14 @@ export function notification(title = `ℹ️ ${$app} 通知`, subtitle = "", bod
 	Console.groupEnd();
 }
 
+/**
+ * 将统一通知参数转换为平台可识别字段。
+ * Convert normalized content into platform-recognized fields.
+ *
+ * @private
+ * @param {NotificationContent} content 通知扩展参数 / Extended content options.
+ * @returns {Record<string, any>}
+ */
 const MutableContent = content => {
 	const mutableContent = {};
 	switch (typeof content) {

package/lib/runScript.mjs

@@ -3,6 +3,27 @@ import { fetch } from "../polyfill/fetch.mjs";
 import { Lodash as _ } from "../polyfill/Lodash.mjs";
 import { Storage } from "../polyfill/Storage.mjs";
 
+/**
+ * 远程脚本执行选项。
+ * Remote script execution options.
+ *
+ * @typedef {object} RunScriptOptions
+ * @property {number} [timeout] 执行超时秒数 / Timeout in seconds.
+ */
+
+/**
+ * 通过 BoxJS HTTP API 触发脚本执行。
+ * Trigger script execution through BoxJS HTTP API.
+ *
+ * 依赖键:
+ * Required keys:
+ * - `@chavy_boxjs_userCfgs.httpapi` (`password@host:port`)
+ * - `@chavy_boxjs_userCfgs.httpapi_timeout`
+ *
+ * @param {string} script 脚本文本 / Script source text.
+ * @param {RunScriptOptions} [runOpts] 运行选项 / Runtime options.
+ * @returns {Promise<void>}
+ */
 export async function runScript(script, runOpts) {
 	let httpapi = Storage.getItem("@chavy_boxjs_userCfgs.httpapi");
 	httpapi = httpapi?.replace?.(/\n/g, "")?.trim();

package/lib/time.mjs

@@ -1,14 +1,14 @@
 /**
- * time
- * 时间格式化
- * [version of ISO8601]{@link https://262.ecma-international.org/5.1/#sec-15.9.1.15}
- * 示例:time("yyyy-MM-dd qq HH:mm:ss.S") YYYY-MM-DDTHH:mm:ss.sssZ
- *    :time("yyyyMMddHHmmssS")
- *    YY:年 MM:月 dd:日 S:季 HH:时 m:分 ss:秒 sss:毫秒 Z:时区
- *    其中y可选0-4位占位符、S可选0-1位占位符，其余可选0-2位占位符
- * @param {string} format 格式化参数
- * @param {number} ts 可选: 根据指定时间戳返回格式化日期
+ * 按模板格式化时间字符串。
+ * Format date/time into a template string.
  *
+ * 支持占位符:
+ * Supported tokens:
+ * - `YY`, `yyyy`, `MM`, `dd`, `HH`, `mm`, `ss`, `sss`, `S`
+ *
+ * @param {string} format 格式模板 / Format template.
+ * @param {number} [ts] 可选时间戳 / Optional timestamp.
+ * @returns {string}
  */
 export function time(format, ts) {
 	const date = ts ? new Date(ts) : new Date();

package/lib/wait.mjs

@@ -1,9 +1,9 @@
 /**
- * wait
+ * 延时等待指定毫秒后继续执行。
+ * Wait for the given milliseconds before continuing.
  *
- * @export
- * @param {number} [delay=1000]
- * @returns {Promise<resolve>}
+ * @param {number} [delay=1000] 延迟毫秒 / Delay in milliseconds.
+ * @returns {Promise<void>}
  */
 export function wait(delay = 1000) {
 	return new Promise(resolve => setTimeout(resolve, delay));

package/package.json

@@ -39,5 +39,5 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "version": "2.1.0"
+  "version": "2.1.1"
 }

package/polyfill/Console.mjs

@@ -1,12 +1,41 @@
 import { $app } from "../lib/app.mjs";
 
+/**
+ * 统一日志工具，兼容各脚本平台与 Node.js。
+ * Unified logger compatible with script platforms and Node.js.
+ *
+ * logLevel 用法:
+ * logLevel usage:
+ * - 可读: `Console.logLevel` 返回 `OFF|ERROR|WARN|INFO|DEBUG|ALL`
+ * - Read: `Console.logLevel` returns `OFF|ERROR|WARN|INFO|DEBUG|ALL`
+ * - 可写: 数字 `0~5` 或字符串 `off/error/warn/info/debug/all`
+ * - Write: number `0~5` or string `off/error/warn/info/debug/all`
+ *
+ * @example
+ * Console.logLevel = "debug";
+ * Console.debug("only shown when level >= DEBUG");
+ * Console.logLevel = 2; // WARN
+ */
 export class Console {
 	static #counts = new Map([]);
 	static #groups = [];
 	static #times = new Map([]);
 
+	/**
+	 * 清空控制台（当前为空实现）。
+	 * Clear console (currently a no-op).
+	 *
+	 * @returns {void}
+	 */
 	static clear = () => {};
 
+	/**
+	 * 增加计数器并打印当前值。
+	 * Increment counter and print the current value.
+	 *
+	 * @param {string} [label="default"] 计数器名称 / Counter label.
+	 * @returns {void}
+	 */
 	static count = (label = "default") => {
 		switch (Console.#counts.has(label)) {
 			case true:
@@ -19,6 +48,13 @@ export class Console {
 		Console.log(`${label}: ${Console.#counts.get(label)}`);
 	};
 
+	/**
+	 * 重置计数器。
+	 * Reset a counter.
+	 *
+	 * @param {string} [label="default"] 计数器名称 / Counter label.
+	 * @returns {void}
+	 */
 	static countReset = (label = "default") => {
 		switch (Console.#counts.has(label)) {
 			case true:
@@ -31,12 +67,26 @@ export class Console {
 		}
 	};
 
+	/**
+	 * 输出调试日志。
+	 * Print debug logs.
+	 *
+	 * @param {...any} msg 日志内容 / Log messages.
+	 * @returns {void}
+	 */
 	static debug = (...msg) => {
 		if (Console.#level < 4) return;
 		msg = msg.map(m => `🅱️ ${m}`);
 		Console.log(...msg);
 	};
 
+	/**
+	 * 输出错误日志。
+	 * Print error logs.
+	 *
+	 * @param {...any} msg 日志内容 / Log messages.
+	 * @returns {void}
+	 */
 	static error(...msg) {
 		if (Console.#level < 1) return;
 		switch ($app) {
@@ -56,12 +106,39 @@ export class Console {
 		Console.log(...msg);
 	}
 
+	/**
+	 * `error` 的别名。
+	 * Alias of `error`.
+	 *
+	 * @param {...any} msg 日志内容 / Log messages.
+	 * @returns {void}
+	 */
 	static exception = (...msg) => Console.error(...msg);
 
+	/**
+	 * 进入日志分组。
+	 * Enter a log group.
+	 *
+	 * @param {string} label 分组名 / Group label.
+	 * @returns {number}
+	 */
 	static group = label => Console.#groups.unshift(label);
 
+	/**
+	 * 退出日志分组。
+	 * Exit the latest log group.
+	 *
+	 * @returns {*}
+	 */
 	static groupEnd = () => Console.#groups.shift();
 
+	/**
+	 * 输出信息日志。
+	 * Print info logs.
+	 *
+	 * @param {...any} msg 日志内容 / Log messages.
+	 * @returns {void}
+	 */
 	static info(...msg) {
 		if (Console.#level < 3) return;
 		msg = msg.map(m => `ℹ️ ${m}`);
@@ -70,6 +147,12 @@ export class Console {
 
 	static #level = 3;
 
+	/**
+	 * 获取日志级别文本。
+	 * Get current log level text.
+	 *
+	 * @returns {"OFF"|"ERROR"|"WARN"|"INFO"|"DEBUG"|"ALL"}
+	 */
 	static get logLevel() {
 		switch (Console.#level) {
 			case 0:
@@ -88,6 +171,12 @@ export class Console {
 		}
 	}
 
+	/**
+	 * 设置日志级别。
+	 * Set current log level.
+	 *
+	 * @param {number|string} level 级别值 / Level value.
+	 */
 	static set logLevel(level) {
 		switch (typeof level) {
 			case "string":
@@ -130,6 +219,13 @@ export class Console {
 		}
 	}
 
+	/**
+	 * 输出通用日志。
+	 * Print generic logs.
+	 *
+	 * @param {...any} msg 日志内容 / Log messages.
+	 * @returns {void}
+	 */
 	static log = (...msg) => {
 		if (Console.#level === 0) return;
 		msg = msg.map(log => {
@@ -157,16 +253,44 @@ export class Console {
 		console.log(msg.join("\n"));
 	};
 
+	/**
+	 * 开始计时。
+	 * Start timer.
+	 *
+	 * @param {string} [label="default"] 计时器名称 / Timer label.
+	 * @returns {Map<string, number>}
+	 */
 	static time = (label = "default") => Console.#times.set(label, Date.now());
 
+	/**
+	 * 结束计时并移除计时器。
+	 * End timer and remove it.
+	 *
+	 * @param {string} [label="default"] 计时器名称 / Timer label.
+	 * @returns {boolean}
+	 */
 	static timeEnd = (label = "default") => Console.#times.delete(label);
 
+	/**
+	 * 输出当前计时器耗时。
+	 * Print elapsed time for a timer.
+	 *
+	 * @param {string} [label="default"] 计时器名称 / Timer label.
+	 * @returns {void}
+	 */
 	static timeLog = (label = "default") => {
 		const time = Console.#times.get(label);
 		if (time) Console.log(`${label}: ${Date.now() - time}ms`);
 		else Console.warn(`Timer "${label}" doesn’t exist`);
 	};
 
+	/**
+	 * 输出警告日志。
+	 * Print warning logs.
+	 *
+	 * @param {...any} msg 日志内容 / Log messages.
+	 * @returns {void}
+	 */
 	static warn(...msg) {
 		if (Console.#level < 2) return;
 		msg = msg.map(m => `⚠️ ${m}`);

package/polyfill/Lodash.mjs

@@ -1,5 +1,28 @@
 /* https://www.lodashjs.com */
+/**
+ * 轻量 Lodash 工具集。
+ * Lightweight Lodash-like utilities.
+ *
+ * 说明:
+ * Notes:
+ * - 这是 Lodash 的“部分方法”简化实现，不等价于完整 Lodash
+ * - This is a simplified subset, not a full Lodash implementation
+ * - 各方法语义可参考 Lodash 官方文档
+ * - Method semantics can be referenced from official Lodash docs
+ *
+ * 参考:
+ * Reference:
+ * - https://www.lodashjs.com
+ * - https://lodash.com
+ */
 export class Lodash {
+	/**
+	 * HTML 特殊字符转义。
+	 * Escape HTML special characters.
+	 *
+	 * @param {string} string 输入文本 / Input text.
+	 * @returns {string}
+	 */
 	static escape(string) {
 		const map = {
 			"&": "&",
@@ -11,6 +34,15 @@ export class Lodash {
 		return string.replace(/[&<>"']/g, m => map[m]);
 	}
 
+	/**
+	 * 按路径读取对象值。
+	 * Get object value by path.
+	 *
+	 * @param {object} [object={}] 目标对象 / Target object.
+	 * @param {string|string[]} [path=""] 路径 / Path.
+	 * @param {*} [defaultValue=undefined] 默认值 / Default value.
+	 * @returns {*}
+	 */
 	static get(object = {}, path = "", defaultValue = undefined) {
 		// translate array case to dot case, then split with .
 		// a[0].b -> a.0.b -> ['a', '0', 'b']
@@ -24,7 +56,9 @@ export class Lodash {
 
 	/**
 	 * 递归合并源对象的自身可枚举属性到目标对象
+	 * Recursively merge source enumerable properties into target object.
 	 * @description 简化版 lodash.merge，用于合并配置对象
+	 * @description A simplified lodash.merge for config merging.
 	 *
 	 * 适用情况:
 	 * - 合并嵌套的配置/设置对象
@@ -41,8 +75,11 @@ export class Lodash {
 	 * - 会修改原始目标对象 (mutates target)
 	 *
 	 * @param {object} object - 目标对象
+	 * @param {object} object - Target object.
 	 * @param {...object} sources - 源对象(可多个)
+	 * @param {...object} sources - Source objects.
 	 * @returns {object} 返回合并后的目标对象
+	 * @returns {object} Merged target object.
 	 * @example
 	 * const target = { a: { b: 1 }, c: 2 };
 	 * const source = { a: { d: 3 }, e: 4 };
@@ -99,8 +136,11 @@ export class Lodash {
 
 	/**
 	 * 判断值是否为普通对象 (Plain Object)
+	 * Check whether a value is a plain object.
 	 * @param {*} value - 要检查的值
+	 * @param {*} value - Value to check.
 	 * @returns {boolean} 如果是普通对象返回 true
+	 * @returns {boolean} Returns true when value is a plain object.
 	 */
 	static #isPlainObject(value) {
 		if (value === null || typeof value !== "object") return false;
@@ -108,24 +148,56 @@ export class Lodash {
 		return proto === null || proto === Object.prototype;
 	}
 
+	/**
+	 * 删除对象指定路径并返回对象。
+	 * Omit paths from object and return the same object.
+	 *
+	 * @param {object} [object={}] 目标对象 / Target object.
+	 * @param {string|string[]} [paths=[]] 要删除的路径 / Paths to remove.
+	 * @returns {object}
+	 */
 	static omit(object = {}, paths = []) {
 		if (!Array.isArray(paths)) paths = [paths.toString()];
 		paths.forEach(path => Lodash.unset(object, path));
 		return object;
 	}
 
+	/**
+	 * 仅保留对象指定键（第一层）。
+	 * Pick selected keys from object (top level only).
+	 *
+	 * @param {object} [object={}] 目标对象 / Target object.
+	 * @param {string|string[]} [paths=[]] 需要保留的键 / Keys to keep.
+	 * @returns {object}
+	 */
 	static pick(object = {}, paths = []) {
 		if (!Array.isArray(paths)) paths = [paths.toString()];
 		const filteredEntries = Object.entries(object).filter(([key, value]) => paths.includes(key));
 		return Object.fromEntries(filteredEntries);
 	}
 
+	/**
+	 * 按路径写入对象值。
+	 * Set object value by path.
+	 *
+	 * @param {object} object 目标对象 / Target object.
+	 * @param {string|string[]} path 路径 / Path.
+	 * @param {*} value 写入值 / Value.
+	 * @returns {object}
+	 */
 	static set(object, path, value) {
 		if (!Array.isArray(path)) path = Lodash.toPath(path);
 		path.slice(0, -1).reduce((previousValue, currentValue, currentIndex) => (Object(previousValue[currentValue]) === previousValue[currentValue] ? previousValue[currentValue] : (previousValue[currentValue] = /^\d+$/.test(path[currentIndex + 1]) ? [] : {})), object)[path[path.length - 1]] = value;
 		return object;
 	}
 
+	/**
+	 * 将点路径或数组下标路径转换为数组。
+	 * Convert dot/array-index path string into path segments.
+	 *
+	 * @param {string} value 路径字符串 / Path string.
+	 * @returns {string[]}
+	 */
 	static toPath(value) {
 		return value
 			.replace(/\[(\d+)\]/g, ".$1")
@@ -133,6 +205,13 @@ export class Lodash {
 			.filter(Boolean);
 	}
 
+	/**
+	 * HTML 实体反转义。
+	 * Unescape HTML entities.
+	 *
+	 * @param {string} string 输入文本 / Input text.
+	 * @returns {string}
+	 */
 	static unescape(string) {
 		const map = {
 			"&amp;": "&",
@@ -144,6 +223,14 @@ export class Lodash {
 		return string.replace(/&amp;|&lt;|&gt;|&quot;|&#39;/g, m => map[m]);
 	}
 
+	/**
+	 * 删除对象路径对应的值。
+	 * Remove value by object path.
+	 *
+	 * @param {object} [object={}] 目标对象 / Target object.
+	 * @param {string|string[]} [path=""] 路径 / Path.
+	 * @returns {boolean}
+	 */
 	static unset(object = {}, path = "") {
 		if (!Array.isArray(path)) path = Lodash.toPath(path);
 		const result = path.reduce((previousValue, currentValue, currentIndex) => {

package/polyfill/StatusTexts.mjs

@@ -1,3 +1,20 @@
+/**
+ * HTTP 状态码文本映射表。
+ * HTTP status code to status text map.
+ *
+ * 主要用途:
+ * Primary usage:
+ * - 为 Quantumult X 的 `$done` 状态行拼接提供状态文本
+ * - Provide status text for Quantumult X `$done` status-line composition
+ * - QX 在部分场景要求 `status` 为完整状态行（如 `HTTP/1.1 200 OK`）
+ * - QX may require full status line (e.g. `HTTP/1.1 200 OK`) in some cases
+ *
+ * 参考:
+ * Reference:
+ * - https://github.com/crossutility/Quantumult-X/raw/refs/heads/master/sample-rewrite-response-header.js
+ *
+ * @type {Record<number, string>}
+ */
 export const StatusTexts = {
 	100: "Continue",
 	101: "Switching Protocols",