@nsnanocat/util 2.2.0 → 2.2.4

package/README.md

@@ -1,6 +1,6 @@
 # @nsnanocat/util
 
-用于统一 Quantumult X / Loon / Shadowrocket / Node.js / Egern / Surge / Stash 脚本接口的通用工具库。
+用于统一 Quantumult X / Loon / Shadowrocket / Worker / Node.js / Egern / Surge / Stash 脚本接口的通用工具库。
 
 核心目标：
 - 统一不同平台的 HTTP、通知、持久化、结束脚本等调用方式。
@@ -56,16 +56,16 @@ npm i @nsnanocat/util@latest
 
 ```js
 import {
-  $app,       // 当前平台名（如 "Surge" / "Loon" / "Quantumult X" / "Node.js"）
+  $app,       // 当前平台名（如 "Surge" / "Loon" / "Quantumult X" / "Worker" / "Node.js"）
   $argument,  // 已标准化的模块参数对象（导入包时自动处理字符串 -> 对象）
   done,       // 统一结束脚本函数（内部自动适配各平台 $done 差异）
-  fetch,      // 统一 HTTP 请求函数（内部自动适配 $httpClient / $task / Node fetch）
+  fetch,      // 统一 HTTP 请求函数（内部自动适配 $httpClient / $task / fetch）
   notification, // 统一通知函数（内部自动适配 $notify / $notification.post）
   time,       // 时间格式化工具
   wait,       // 延时等待工具（Promise）
   Console,    // 统一日志工具（支持 logLevel）
   Lodash as _, // Lodash 建议按官方示例惯例使用 `_` 作为工具对象别名
-  Storage,    // 统一持久化存储接口（适配 $prefs / $persistentStore / 文件）
+  Storage,    // 统一持久化存储接口（适配 $prefs / $persistentStore / 内存 / 文件）
 } from "@nsnanocat/util";
 ```
 
@@ -104,7 +104,7 @@ import {
 | `lib/notification.mjs` | `lib/app.mjs`, `polyfill/Console.mjs` | `$app`, `Console.group`, `Console.log`, `Console.groupEnd`, `Console.error` | 将通知参数映射到各平台通知接口并统一日志输出 |
 | `lib/runScript.mjs` | `polyfill/Console.mjs`, `polyfill/fetch.mjs`, `polyfill/Storage.mjs`, `polyfill/Lodash.mjs` | `Console.error`, `fetch`, `Storage.getItem`（`Lodash` 当前版本未实际调用） | 读取 BoxJS 配置并发起统一 HTTP 调用执行脚本 |
 | `getStorage.mjs` | `lib/argument.mjs`, `polyfill/Console.mjs`, `polyfill/Lodash.mjs`, `polyfill/Storage.mjs` | `Console.debug`, `Console.logLevel`, `Lodash.merge`, `Storage.getItem` | 先标准化 `$argument`，再合并默认配置/持久化配置/运行参数 |
-| `polyfill/Console.mjs` | `lib/app.mjs` | `$app` | 日志在 Node.js 与 iOS 脚本环境使用不同错误输出策略 |
+| `polyfill/Console.mjs` | `lib/app.mjs` | `$app` | 日志在 Worker / Node.js 与 iOS 脚本环境使用不同错误输出策略 |
 | `polyfill/fetch.mjs` | `lib/app.mjs`, `polyfill/Lodash.mjs`, `polyfill/StatusTexts.mjs`, `polyfill/Console.mjs` | `$app`, `Lodash.set`, `StatusTexts`（`Console` 当前版本未实际调用） | 按平台选请求引擎并做参数映射、响应结构统一 |
 | `polyfill/Storage.mjs` | `lib/app.mjs`, `polyfill/Lodash.mjs` | `$app`, `Lodash.get`, `Lodash.set`, `Lodash.unset` | 按平台选持久化后端并支持 `@key.path` 读写 |
 | `polyfill/Lodash.mjs` | 无 | 无 | 提供路径/合并等基础能力，被多个模块复用 |
@@ -116,7 +116,7 @@ import {
 ### `lib/app.mjs` 与 `lib/environment.mjs`（平台识别与环境）
 
 #### `$app`
-- 类型：`"Quantumult X" | "Loon" | "Shadowrocket" | "Egern" | "Surge" | "Stash" | "Node.js" | undefined`
+- 类型：`"Quantumult X" | "Loon" | "Shadowrocket" | "Egern" | "Surge" | "Stash" | "Worker" | "Node.js" | undefined`
 - 角色：核心模块。库内所有存在平台行为差异的模块都会先读取 `$app` 再分流（如 `done`、`notification`、`fetch`、`Storage`、`Console`、`environment`）。
 - 读取方式：
 
@@ -133,9 +133,10 @@ console.log(appName);
 4. 存在 `Egern` -> `Egern`
 5. 存在 `$environment` 且有 `surge-version` -> `Surge`
 6. 存在 `$environment` 且有 `stash-version` -> `Stash`
-7. 存在 `process.versions.node` -> `Node.js`
-8. 默认回落 -> `undefined`
-- 实现细节：内部使用 `'key' in globalThis` 检测平台标记，避免 `Object.keys(globalThis)` 漏掉不可枚举全局变量；因此在 Workers / Vercel 风格全局对象存在时，只要 `process.versions.node` 可用，仍会识别为 `Node.js`。
+7. 存在 `Cloudflare` -> `Worker`
+8. 存在 `process.versions.node` -> `Node.js`
+9. 默认回落 -> `undefined`
+- 实现细节：内部使用 `'key' in globalThis` 检测平台标记，避免 `Object.keys(globalThis)` 漏掉不可枚举全局变量；当前 Worker 识别以 `Cloudflare` 全局标记为准。
 
 #### `$environment` / `environment()`
 - 路径：`lib/environment.mjs`（未从包主入口导出）
@@ -157,6 +158,7 @@ console.log(environment()); // 当前环境对象
 | Egern | 读取全局 `$environment`，再写入 `app` | `{ ..., app: "Egern" }` |
 | Loon | 读取全局 `$loon` 字符串并拆分 | `{ device, ios, "loon-version", app: "Loon" }` |
 | Quantumult X | 不读取额外环境字段，直接构造对象 | `{ app: "Quantumult X" }` |
+| Worker | 直接构造对象 | `{ app: "Worker" }` |
 | Node.js | 读取 `process.env` 并写入 `process.env.app` | `{ ..., app: "Node.js" }` |
 | 其他 | 无 | `{}` |
 
@@ -194,7 +196,7 @@ console.log($argument); // { mode: "on", a: { b: "1" } }
 
 #### `done(object = {})`
 - 签名：`done(object?: object): void`
-- 作用：统一不同平台的脚本结束接口（`$done` / Node 退出）。
+- 作用：统一不同平台的脚本结束接口（`$done` / Worker 日志结束 / Node 退出）。
 
 说明：下表描述的是各 App 原生接口差异与本库内部映射逻辑。调用方只需要按 `done` 的统一参数传值即可，不需要自己再写平台分支。
 
@@ -216,12 +218,14 @@ console.log($argument); // { mode: "on", a: { b: "1" } }
 | Egern | 不转换 | 透传 | 透传 | `$done(object)` |
 | Shadowrocket | 不转换 | 透传 | 透传 | `$done(object)` |
 | Quantumult X | 写入 `opts.policy` | `number` 会转 `HTTP/1.1 200 OK` 字符串 | 仅保留 `status/url/headers/body/bodyBytes`；`ArrayBuffer/TypedArray` 转 `bodyBytes` | `$done(object)` |
+| Worker | 不适用 | 不适用 | 不适用 | 仅记录结束日志 |
 | Node.js | 不适用 | 不适用 | 不适用 | `process.exit(1)` |
 
 不可用/差异点：
 - `policy` 在 Egern / Shadowrocket 分支不做映射。
 - Quantumult X 会丢弃未在白名单内的字段。
 - Quantumult X 的 `status` 在部分场景要求完整状态行（如 `HTTP/1.1 200 OK`），本库会在传入数字状态码时自动拼接（依赖 `StatusTexts`）。
+- Worker 不调用 `$done`，仅记录结束日志。
 - Node.js 不调用 `$done`，而是直接退出进程，且退出码固定为 `1`。
 - 未识别平台（`$app === undefined`）只记录结束日志，不会尝试调用 `$done` 或退出进程。
 
@@ -252,11 +256,13 @@ console.log($argument); // { mode: "on", a: { b: "1" } }
 | Shadowrocket | `$notification.post` | `{ openUrl: content }` | 走 Surge 分支的 action/url/text/media 字段 |
 | Loon | `$notification.post` | `{ openUrl: content }` | `openUrl`、`mediaUrl`（仅 http/https） |
 | Quantumult X | `$notify` | `{ "open-url": content }` | `open-url`、`media-url`（仅 http/https）、`update-pasteboard` |
+| Worker | 不发送通知（非 iOS App 环境） | 无 | 无 |
 | Node.js | 不发送通知（非 iOS App 环境） | 无 | 无 |
 
 不可用/差异点：
 - `copy/update-pasteboard` 在 Loon 分支不会生效。
 - Loon / Quantumult X 对 `media` 仅接受网络 URL；Base64 媒体不会自动映射。
+- Worker 不是 iOS App 脚本环境，不支持 iOS 通知行为；当前分支仅日志输出。
 - Node.js 不是 iOS App 脚本环境，不支持 iOS 通知行为；当前分支仅日志输出。
 
 ### `lib/time.mjs`
@@ -384,7 +390,7 @@ const store = getStorage("@my_box", ["YouTube", "Global"], database);
 - `timeout`
 - `policy`
 - `redirection` / `auto-redirect`
-- `auto-cookie`（仅 Node.js 分支识别；默认启用，传入 `false` / `0` / `-1` 可关闭）
+- `auto-cookie`（Worker / Node.js 共享分支识别；默认启用，传入 `false` / `0` / `-1` 可关闭）
 
 说明：下表是各 App 原生 HTTP 接口的差异补充，以及本库 `fetch` 的内部映射方式。调用方使用统一入参即可。
 
@@ -398,6 +404,7 @@ const store = getStorage("@my_box", ["YouTube", "Global"], database);
 | Egern | `$httpClient[method]` | 秒 | 无专门映射 | `auto-redirect` | 同上 |
 | Shadowrocket | `$httpClient[method]` | 秒 | `headers.X-Surge-Proxy` | `auto-redirect` | 同上 |
 | Quantumult X | `$task.fetch` | 毫秒（内部乘 1000） | `opts.policy` | `opts.redirection` | `body(ArrayBuffer/TypedArray)` 转 `bodyBytes`；响应按 `Content-Type` 恢复到 `body` |
+| Worker | `globalThis.fetch`（不存在时回退 `node-fetch`）；共享 `auto-cookie` 处理 | 毫秒（内部乘 1000） | 无 | `redirect: follow/manual` | 返回 `body`(UTF-8 string) + `bodyBytes`(ArrayBuffer) |
 | Node.js | `globalThis.fetch`（不存在时回退 `node-fetch`）；默认按需包裹 `fetch-cookie` | 毫秒（内部乘 1000） | 无 | `redirect: follow/manual` | 返回 `body`(UTF-8 string) + `bodyBytes`(ArrayBuffer) |
 
 返回对象（统一后）常见字段：
@@ -410,9 +417,9 @@ const store = getStorage("@my_box", ["YouTube", "Global"], database);
 - `bodyBytes`
 
 不可用/差异点：
-- `policy` 在 Surge / Egern / Node.js 分支没有额外适配逻辑。
+- `policy` 在 Surge / Egern / Worker / Node.js 分支没有额外适配逻辑。
 - `redirection` 在部分平台会映射为 `auto-redirect` 或 `opts.redirection`。
-- Node.js 分支优先复用 `globalThis.fetch`；若不存在则回退到 `node-fetch`，并在 `auto-cookie` 未关闭时按需包裹 `fetch-cookie`。
+- Worker / Node.js 共享基于 `fetch` 的请求分支；若 `globalThis.fetch` 不存在则回退到 `node-fetch`，并在 `auto-cookie` 未关闭时按需包裹 `fetch-cookie`。
 - 传入 `timeout` 时，`5` 和 `5000` 都会被接受；库会先将用户输入归一化，再按平台要求转换为秒或毫秒。
 - 返回结构是统一兼容结构，不等同于浏览器 `Response` 对象。
 
@@ -435,21 +442,24 @@ const store = getStorage("@my_box", ["YouTube", "Global"], database);
 #### `Storage.removeItem(keyName)`
 - Quantumult X：可用（`$prefs.removeValueForKey`）。
 - Surge：通过 `$persistentStore.write(null, keyName)` 删除。
+- Worker：可用（仅删除内存缓存中的对应 key，不持久化）。
 - Node.js：可用（删除 `box.dat` 中对应 key 并落盘）。
 - Loon / Stash / Egern / Shadowrocket：返回 `false`。
 
 #### `Storage.clear()`
 - Quantumult X：可用（`$prefs.removeAllValues`）。
+- Worker：可用（仅清空内存缓存，不持久化）。
 - Node.js：可用（清空 `box.dat` 并落盘）。
 - 其他平台：返回 `false`。
 
-#### Node.js 特性
+#### Worker / Node.js 特性
+- Worker：使用进程内内存缓存，不写文件。
 - 数据文件默认：`box.dat`。
 - 读取路径优先级：当前目录 -> `process.cwd()`。
 
 与 Web Storage 的行为差异：
 - 支持 `@key.path` 深路径读写（Web Storage 原生不支持）。
-- `removeItem/clear` 仅部分平台可用（目前为 Quantumult X、Node.js，以及 Surge 的 `removeItem`）。
+- `removeItem/clear` 仅部分平台可用（目前为 Quantumult X、Worker、Node.js，以及 Surge 的 `removeItem`）。
 - `getItem` 会尝试 `JSON.parse`，`setItem` 写入对象会 `JSON.stringify`。
 
 平台后端映射：
@@ -458,6 +468,7 @@ const store = getStorage("@my_box", ["YouTube", "Global"], database);
 | --- | --- |
 | Surge / Loon / Stash / Egern / Shadowrocket | `$persistentStore.read/write` |
 | Quantumult X | `$prefs.valueForKey/setValueForKey` |
+| Worker | 进程内内存缓存 |
 | Node.js | 本地 `box.dat` |
 
 ### `polyfill/Console.mjs`
@@ -507,7 +518,7 @@ console.log(Console.logLevel); // "WARN"
 | `count(label)` | `label?: string` | `void` | 计数并输出 |
 | `countReset(label)` | `label?: string` | `void` | 重置计数器 |
 | `debug(...msg)` | `...msg: any[]` | `void` | 仅 `DEBUG/ALL` 级别输出 |
-| `error(...msg)` | `...msg: any[]` | `void` | Node.js 优先输出 `stack` |
+| `error(...msg)` | `...msg: any[]` | `void` | Worker / Node.js 优先输出 `stack` |
 | `exception(...msg)` | `...msg: any[]` | `void` | `error` 别名 |
 | `group(label)` | `label: string` | `void` | 压栈分组 |
 | `groupEnd()` | 无 | `void` | 出栈分组 |
@@ -519,7 +530,7 @@ console.log(Console.logLevel); // "WARN"
 | `warn(...msg)` | `...msg: any[]` | `void` | `WARN` 及以上 |
 
 平台差异：
-- Node.js 下 `error` 会优先打印 `Error.stack`。
+- Worker / Node.js 下 `error` 会优先打印 `Error.stack`。
 - 其他平台统一加前缀符号输出（`❌/⚠️/ℹ️/🅱️`）。
 
 ### `polyfill/Lodash.mjs`
@@ -623,18 +634,19 @@ console.log(value); // 1
 
 说明：本节展示的是各平台原生脚本接口差异。实际在本库中，这些差异已由 `done`、`fetch`、`notification`、`Storage` 等模块做了统一适配。
 
-| 能力 | Quantumult X | Loon | Surge | Stash | Egern | Shadowrocket | Node.js |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| HTTP 请求 | `$task.fetch` | `$httpClient` | `$httpClient` | `$httpClient` | `$httpClient` | `$httpClient` | `fetch` |
-| 通知 | `$notify` | `$notification.post` | `$notification.post` | `$notification.post` | `$notification.post` | `$notification.post` | 无 |
-| 持久化 | `$prefs` | `$persistentStore` | `$persistentStore` | `$persistentStore` | `$persistentStore` | `$persistentStore` | `box.dat` |
-| 结束脚本 | `$done` | `$done` | `$done` | `$done` | `$done` | `$done` | `process.exit(1)` |
-| `removeItem/clear` | 可用 | 不可用 | `removeItem` 可用 / `clear` 不可用 | 不可用 | 不可用 | 不可用 | 可用 |
-| `policy` 注入（`fetch/done`） | `opts.policy` | `node` | `X-Surge-Policy`(done) | `X-Stash-Selected-Proxy` | 无专门映射 | `X-Surge-Proxy`(fetch) | 无 |
+| 能力 | Quantumult X | Loon | Surge | Stash | Egern | Shadowrocket | Worker | Node.js |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| HTTP 请求 | `$task.fetch` | `$httpClient` | `$httpClient` | `$httpClient` | `$httpClient` | `$httpClient` | `fetch` | `fetch` |
+| 通知 | `$notify` | `$notification.post` | `$notification.post` | `$notification.post` | `$notification.post` | `$notification.post` | 无 | 无 |
+| 持久化 | `$prefs` | `$persistentStore` | `$persistentStore` | `$persistentStore` | `$persistentStore` | `$persistentStore` | 内存缓存 | `box.dat` |
+| 结束脚本 | `$done` | `$done` | `$done` | `$done` | `$done` | `$done` | 仅日志 | `process.exit(1)` |
+| `removeItem/clear` | 可用 | 不可用 | `removeItem` 可用 / `clear` 不可用 | 不可用 | 不可用 | 不可用 | 可用 | 可用 |
+| `policy` 注入（`fetch/done`） | `opts.policy` | `node` | `X-Surge-Policy`(done) | `X-Stash-Selected-Proxy` | 无专门映射 | `X-Surge-Proxy`(fetch) | 无 | 无 |
 
 ## 已知限制与注意事项
 
 - `lib/argument.mjs` 为 `$argument` 标准化模块，`import` 时会按规则重写全局 `$argument`。
+- `lib/done.mjs` 在 Worker 仅记录结束日志。
 - `lib/done.mjs` 在 Node.js 固定 `process.exit(1)`。
 - `Storage.removeItem("@a.b")` 分支存在未声明变量写入风险；如要大量使用路径删除，建议先本地验证。
 - `lib/runScript.mjs` 未从包主入口导出，需要按文件路径直接导入。
@@ -662,6 +674,9 @@ console.log(value); // 1
 - [crossutility/Quantumult-X - sample-fetch-opts-policy.js](https://raw.githubusercontent.com/crossutility/Quantumult-X/master/sample-fetch-opts-policy.js)
 - [crossutility/Quantumult-X - sample-rewrite-response-header.js](https://github.com/crossutility/Quantumult-X/raw/refs/heads/master/sample-rewrite-response-header.js)
 
+### Worker
+- 以 `Cloudflare` 全局标记识别 Worker 运行时。
+
 ### Node.js
 - [Node.js Globals - fetch](https://nodejs.org/api/globals.html#fetch)
 

package/lib/app.mjs

@@ -10,8 +10,9 @@
  * 4) `Egern` -> Egern
  * 5) `$environment["surge-version"]` -> Surge
  * 6) `$environment["stash-version"]` -> Stash
- * 7) `process.versions.node` -> Node.js
- * 8) 默认回落 -> undefined
+ * 7) `Cloudflare` -> Worker
+ * 8) `process.versions.node` -> Node.js
+ * 9) 默认回落 -> undefined
  *    default fallback -> undefined
  *
  * 说明:
@@ -19,10 +20,10 @@
  * - 使用 `'key' in globalThis`，避免 `Object.keys` 对不可枚举全局变量漏检。
  * - Use `'key' in globalThis` to avoid missing non-enumerable globals with `Object.keys`.
  *
- * @type {("Quantumult X" | "Loon" | "Shadowrocket" | "Egern" | "Surge" | "Stash" | "Node.js" | undefined)}
+ * @type {("Quantumult X" | "Loon" | "Shadowrocket" | "Egern" | "Surge" | "Stash" | "Worker" | "Node.js" | undefined)}
  */
 export const $app = (() => {
-	const has = (key) => key in globalThis;
+	const has = key => key in globalThis;
 	switch (true) {
 		case has("$task"):
 			return "Quantumult X";
@@ -36,6 +37,9 @@ export const $app = (() => {
 			return "Surge";
 		case Boolean(globalThis.$environment?.["stash-version"]):
 			return "Stash";
+		case has("Cloudflare"):
+			//case has("ServiceWorkerGlobalScope") && has("self") && has("caches") && has("scheduler"):
+			return "Worker";
 		case Boolean(globalThis.process?.versions?.node):
 			return "Node.js";
 		default:

package/lib/done.mjs

@@ -24,6 +24,8 @@ import { StatusTexts } from "../polyfill/StatusTexts.mjs";
  * Notes:
  * - 这是调用入口，平台原生 `$done` 差异在内部处理
  * - This is the call entry and native `$done` differences are handled internally
+ * - Worker 不调用 `$done` 或退出进程，仅记录日志
+ * - Worker neither calls `$done` nor exits the process; it only logs
  * - Node.js 不调用 `$done`，而是直接退出进程
  * - Node.js does not call `$done`; it exits the process directly
  * - 未识别平台仅记录结束日志，不会强制退出
@@ -80,6 +82,9 @@ export function done(object = {}) {
 			Console.log("🚩 执行结束!");
 			$done(object);
 			break;
+		case "Worker":
+			Console.log("🚩 执行结束!");
+			break;
 		case "Node.js":
 			Console.log("🚩 执行结束!");
 			process.exit(1);

package/lib/environment.mjs

@@ -10,6 +10,8 @@ import { $app } from "./app.mjs";
  * - Loon: parse `$loon` into device/version fields
  * - Quantumult X: 仅返回 `{ app: "Quantumult X" }`
  * - Quantumult X: returns `{ app: "Quantumult X" }` only
+ * - Worker: 返回 `{ app: "Worker" }`
+ * - Worker: returns `{ app: "Worker" }`
  * - Node.js: 复用 `process.env` 并写入 `process.env.app`
  * - Node.js: reuses `process.env` and writes `process.env.app`
  *
@@ -47,6 +49,10 @@ export function environment() {
 			return {
 				app: "Quantumult X",
 			};
+		case "Worker":
+			return {
+				app: "Worker",
+			};
 		case "Node.js":
 			process.env.app = "Node.js";
 			return process.env;

package/lib/notification.mjs

@@ -29,6 +29,8 @@ import { Console } from "../polyfill/Console.mjs";
  * Notes:
  * - iOS App 平台调用 `$notification.post` 或 `$notify`
  * - iOS app platforms call `$notification.post` or `$notify`
+ * - Worker 不支持 iOS 通知接口，仅输出日志
+ * - Worker does not support iOS notification APIs; it logs only
  * - Node.js 不支持 iOS 通知接口，仅输出日志
  * - Node.js does not support iOS notification APIs; it logs only
  *
@@ -52,6 +54,7 @@ export function notification(title = `ℹ️ ${$app} 通知`, subtitle = "", bod
 		case "Quantumult X":
 			$notify(title, subtitle, body, mutableContent);
 			break;
+		case "Worker":
 		case "Node.js":
 			break;
 	}
@@ -90,6 +93,7 @@ const MutableContent = content => {
 				case "Quantumult X":
 					mutableContent["open-url"] = content;
 					break;
+				case "Worker":
 				case "Node.js":
 					break;
 			}
@@ -167,6 +171,7 @@ const MutableContent = content => {
 					if (copyUrl) mutableContent["update-pasteboard"] = copyUrl;
 					break;
 				}
+				case "Worker":
 				case "Node.js":
 					break;
 			}

package/package.json

@@ -35,11 +35,12 @@
     "types"
   ],
   "devDependencies": {
-    "typescript": "^5.6.3"
+    "@biomejs/biome": "2.4.6",
+    "typescript": "^5.9.3"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "version": "2.2.0"
+  "version": "2.2.4"
 }

package/polyfill/Console.mjs

@@ -1,8 +1,8 @@
 import { $app } from "../lib/app.mjs";
 
 /**
- * 统一日志工具，兼容各脚本平台与 Node.js。
- * Unified logger compatible with script platforms and Node.js.
+ * 统一日志工具，兼容各脚本平台、Worker 与 Node.js。
+ * Unified logger compatible with script platforms, Worker, and Node.js.
  *
  * logLevel 用法:
  * logLevel usage:
@@ -99,8 +99,9 @@ export class Console {
 			default:
 				msg = msg.map(m => `❌ ${m}`);
 				break;
+			case "Worker":
 			case "Node.js":
-				msg = msg.map(m => `❌ ${m.stack}`);
+				msg = msg.map(m => `❌ ${m?.stack ?? m}`);
 				break;
 		}
 		Console.log(...msg);

package/polyfill/Storage.mjs

@@ -16,6 +16,8 @@ import { Lodash as _ } from "./Lodash.mjs";
  * Supported backends:
  * - Surge/Loon/Stash/Egern/Shadowrocket: `$persistentStore`
  * - Quantumult X: `$prefs`
+ * - Worker: 内存缓存（非持久化）
+ * - Worker: in-memory cache (non-persistent)
  * - Node.js: 本地 `box.dat`
  * - Node.js: local `box.dat`
  *
@@ -37,8 +39,8 @@ import { Lodash as _ } from "./Lodash.mjs";
  */
 export class Storage {
 	/**
-	 * Node.js 环境下的内存数据缓存。
-	 * In-memory data cache for Node.js runtime.
+	 * Worker / Node.js 环境下的内存数据缓存。
+	 * In-memory data cache for Worker / Node.js runtime.
 	 *
 	 * @type {Record<string, any>|null}
 	 */
@@ -95,6 +97,10 @@ export class Storage {
 					case "Quantumult X":
 						keyValue = $prefs.valueForKey(keyName);
 						break;
+					case "Worker":
+						Storage.data = Storage.data ?? {};
+						keyValue = Storage.data[keyName];
+						break;
 					case "Node.js":
 						Storage.data = Storage.#loaddata(Storage.dataFile);
 						keyValue = Storage.data?.[keyName];
@@ -153,6 +159,11 @@ export class Storage {
 					case "Quantumult X":
 						result = $prefs.setValueForKey(keyValue, keyName);
 						break;
+					case "Worker":
+						Storage.data = Storage.data ?? {};
+						Storage.data[keyName] = keyValue;
+						result = true;
+						break;
 					case "Node.js":
 						Storage.data = Storage.#loaddata(Storage.dataFile);
 						Storage.data[keyName] = keyValue;
@@ -207,6 +218,11 @@ export class Storage {
 					case "Quantumult X":
 						result = $prefs.removeValueForKey(keyName);
 						break;
+					case "Worker":
+						Storage.data = Storage.data ?? {};
+						delete Storage.data[keyName];
+						result = true;
+						break;
 					case "Node.js":
 						// result = false;
 						Storage.data = Storage.#loaddata(Storage.dataFile);
@@ -224,8 +240,8 @@ export class Storage {
 	}
 
 	/**
-	 * 清空存储（仅 Quantumult X 支持）。
-	 * Clear storage (supported by Quantumult X only).
+	 * 清空存储。
+	 * Clear storage.
 	 *
 	 * @returns {boolean}
 	 */
@@ -242,6 +258,10 @@ export class Storage {
 			case "Quantumult X":
 				result = $prefs.removeAllValues();
 				break;
+			case "Worker":
+				Storage.data = {};
+				result = true;
+				break;
 			case "Node.js":
 				// result = false;
 				Storage.data = Storage.#loaddata(Storage.dataFile);

package/polyfill/fetch.mjs

@@ -17,7 +17,7 @@ import { StatusTexts } from "./StatusTexts.mjs";
  * @property {string} [policy] 指定策略 / Preferred policy.
  * @property {boolean} [redirection] 是否跟随重定向 / Whether to follow redirects.
  * @property {boolean} ["auto-redirect"] 平台重定向字段 / Platform redirect flag.
- * @property {boolean|number|string} ["auto-cookie"] Node.js Cookie 开关 / Node.js Cookie toggle.
+ * @property {boolean|number|string} ["auto-cookie"] Worker / Node.js Cookie 开关 / Worker / Node.js Cookie toggle.
  * @property {Record<string, any>} [opts] 平台扩展字段 / Platform extension fields.
  */
 
@@ -43,13 +43,13 @@ import { StatusTexts } from "./StatusTexts.mjs";
  * Design goal:
  * - 仿照 Web API `fetch`（`Window.fetch`）接口设计
  * - Modeled after Web API `fetch` (`Window.fetch`)
- * - 统一 VPN App 与 Node.js 环境中的请求调用
- * - Unify request calls across VPN apps and Node.js
+ * - 统一 VPN App、Worker 与 Node.js 环境中的请求调用
+ * - Unify request calls across VPN apps, Worker, and Node.js
  *
  * 功能:
  * Features:
- * - 统一 Quantumult X / Loon / Surge / Stash / Egern / Shadowrocket / Node.js 请求接口
- * - Normalize request APIs across Quantumult X / Loon / Surge / Stash / Egern / Shadowrocket / Node.js
+ * - 统一 Quantumult X / Loon / Surge / Stash / Egern / Shadowrocket / Worker / Node.js 请求接口
+ * - Normalize request APIs across Quantumult X / Loon / Surge / Stash / Egern / Shadowrocket / Worker / Node.js
  * - 统一返回体字段（`ok/status/statusText/body/bodyBytes`）
  * - Normalize response fields (`ok/status/statusText/body/bodyBytes`)
  *
@@ -57,8 +57,10 @@ import { StatusTexts } from "./StatusTexts.mjs";
  * Known differences from Web `fetch`:
  * - 支持 `policy`、`auto-redirect` 等平台扩展字段
  * - Supports platform extension fields like `policy` and `auto-redirect`
- * - Node.js 分支默认启用 Cookie 透传，可通过 `auto-cookie` 关闭
- * - Node.js enables Cookie forwarding by default and can disable it via `auto-cookie`
+ * - Worker / Node.js 共享基于 `fetch` 的请求分支
+ * - Worker / Node.js share the `fetch`-based request branch
+ * - `auto-cookie` 在 Worker / Node.js 共享分支中识别
+ * - `auto-cookie` is recognized by the shared Worker / Node.js branch
  * - 非浏览器平台通过 `$httpClient/$task` 实现，不是原生 Fetch 实现
  * - Non-browser platforms use `$httpClient/$task` instead of native Fetch engine
  * - 返回结构包含 `statusCode/bodyBytes` 等兼容字段
@@ -111,6 +113,26 @@ export async function fetch(resource, options = {}) {
 		// Convert to seconds first and treat values above 500 as milliseconds.
 		if (resource.timeout > 500) resource.timeout = Math.round(resource.timeout / 1000);
 	}
+	// 某些平台要求毫秒级超时，进行二次换算。
+	// Some platforms expect timeout in milliseconds, so convert again.
+	if (resource.timeout) {
+		switch ($app) {
+			case "Loon":
+			case "Quantumult X":
+			case "Worker":
+			case "Node.js":
+				// 这些平台要求毫秒，因此把秒重新换算为毫秒。
+				// These platforms expect milliseconds, so convert seconds back to milliseconds.
+				resource.timeout = resource.timeout * 1000;
+				break;
+			case "Shadowrocket":
+			case "Stash":
+			case "Egern":
+			case "Surge":
+			default:
+				break;
+		}
+	}
 	// 根据当前平台选择请求实现。
 	// Select the request engine for the current platform.
 	switch ($app) {
@@ -122,23 +144,6 @@ export async function fetch(resource, options = {}) {
 		default:
 			// 转换通用请求参数到 `$httpClient` 语义。
 			// Map shared request fields to `$httpClient` semantics.
-			if (resource.timeout) {
-				switch ($app) {
-					case "Loon":
-					case "Quantumult X":
-					case "Node.js":
-						// 这些平台要求毫秒，因此把秒重新换算为毫秒。
-						// These platforms expect milliseconds, so convert seconds back to milliseconds.
-						resource.timeout = resource.timeout * 1000;
-						break;
-					case "Shadowrocket":
-					case "Stash":
-					case "Egern":
-					case "Surge":
-					default:
-						break;
-				}
-			}
 			if (resource.policy) {
 				switch ($app) {
 					case "Loon":
@@ -236,10 +241,13 @@ export async function fetch(resource, options = {}) {
 					}, resource.timeout);
 				}),
 			]);
+		case "Worker":
 		case "Node.js": {
-			// Node.js 优先复用原生/宿主 `fetch`，缺失时再回退到 `node-fetch`。
-			// Reuse host `fetch` in Node.js when available and fall back to `node-fetch` otherwise.
-			if (!globalThis.fetch) globalThis.fetch = require("node-fetch");
+			// Worker 复用宿主 `fetch`；Node.js 优先复用原生 `fetch`，缺失时再回退到 `node-fetch`。
+			// Worker reuses host `fetch`; Node.js reuses native `fetch` first and falls back to `node-fetch`.
+			if (!globalThis.fetch) {
+				globalThis.fetch = require("node-fetch");
+			}
 			switch (resource["auto-cookie"]) {
 				case undefined:
 				case "true":
@@ -259,8 +267,8 @@ export async function fetch(resource, options = {}) {
 				case -1:
 					break;
 			}
-			// 将通用字段映射到 Node.js Fetch 语义。
-			// Map shared fields to Node.js Fetch semantics.
+			// 将通用字段映射到 Worker / Node.js Fetch 语义。
+			// Map shared fields to Worker / Node.js Fetch semantics.
 			resource.redirect = resource.redirection ? "follow" : "manual";
 			const { url, ...options } = resource;
 			// 发起请求并归一化响应头、文本与二进制响应体。

package/types/nsnanocat-util.d.ts

@@ -6,6 +6,7 @@ declare module "@nsnanocat/util" {
 		| "Egern"
 		| "Surge"
 		| "Stash"
+		| "Worker"
 		| "Node.js";
 
 	export const $app: AppName | undefined;