@nsnanocat/util 2.2.3 → 2.3.0

package/README.md

@@ -1,11 +1,11 @@
 # @nsnanocat/util
 
-用于统一 Quantumult X / Loon / Shadowrocket / Node.js / Egern / Surge / Stash 脚本接口的通用工具库。
+用于统一 Quantumult X / Loon / Shadowrocket / Worker / Node.js / Egern / Surge / Stash 脚本接口的通用工具库。
 
 核心目标：
 - 统一不同平台的 HTTP、通知、持久化、结束脚本等调用方式。
 - 在一个脚本里尽量少写平台分支。
-- 提供一组可直接复用的 polyfill（`fetch` / `Storage` / `Console` / `Lodash`）。
+- 提供一组可直接复用的 polyfill（`fetch` / `Storage` / `KV` / `Console` / `Lodash`）。
 
 ## 目录
 - [安装与导入](#安装与导入)
@@ -56,16 +56,17 @@ 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 / 文件）
+  KV,         // Cloudflare Workers KV 异步适配器（显式传入 namespace binding）
+  Storage,    // 统一持久化存储接口（适配 $prefs / $persistentStore / 内存 / 文件）
 } from "@nsnanocat/util";
 ```
 
@@ -80,6 +81,7 @@ import {
 - `lib/wait.mjs`
 - `polyfill/Console.mjs`
 - `polyfill/fetch.mjs`
+- `polyfill/KV.mjs`
 - `polyfill/Lodash.mjs`
 - `polyfill/StatusTexts.mjs`
 - `polyfill/Storage.mjs`
@@ -104,8 +106,9 @@ 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/KV.mjs` | `lib/app.mjs`, `polyfill/Lodash.mjs`, `polyfill/Storage.mjs` | `$app`, `Lodash.get`, `Lodash.set`, `Lodash.unset`, `Storage` | 为 Cloudflare Workers KV 提供异步适配，并在非 Worker 平台回退到 `Storage` |
 | `polyfill/Storage.mjs` | `lib/app.mjs`, `polyfill/Lodash.mjs` | `$app`, `Lodash.get`, `Lodash.set`, `Lodash.unset` | 按平台选持久化后端并支持 `@key.path` 读写 |
 | `polyfill/Lodash.mjs` | 无 | 无 | 提供路径/合并等基础能力，被多个模块复用 |
 | `polyfill/StatusTexts.mjs` | 无 | 无 | 提供 HTTP 状态文案，供 `fetch/done` 使用 |
@@ -116,7 +119,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 +136,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 +161,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 +199,7 @@ console.log($argument); // { mode: "on", a: { b: "1" } }
 
 #### `done(object = {})`
 - 签名：`done(object?: object): void`
-- 作用：统一不同平台的脚本结束接口（`$done` / Node 退出）。
+- 作用：统一不同平台的脚本结束接口（`$done` / Worker 日志结束 / Node 退出）。
 
 说明：下表描述的是各 App 原生接口差异与本库内部映射逻辑。调用方只需要按 `done` 的统一参数传值即可，不需要自己再写平台分支。
 
@@ -216,12 +221,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 +259,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 +393,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 +407,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 +420,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 +445,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,8 +471,42 @@ 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/KV.mjs`
+
+`KV` 是面向 Cloudflare Workers KV 的异步适配器：
+- 调用方显式传入 namespace binding：`new KV(env.NAMESPACE)`
+- Worker 分支直接调用 `namespace.get/put/delete/list`
+- `get()` 不传 `type`，默认按 Cloudflare 行为读取字符串
+- 非 Worker 平台会回退到 `Storage.getItem/setItem/removeItem`
+- `list()` 仅支持 Worker，返回 Cloudflare KV 原生列举结果
+- `clear()` 始终返回 `false`
+
+#### `new KV(namespace)`
+- `namespace` 需提供 `get(key)` / `put(key, value)` / `delete(key)`。
+
+#### `await kv.getItem(keyName, defaultValue = null)`
+- 支持普通 key。
+- 支持路径 key：`@root.path.to.key`。
+- 读取后会尝试 `JSON.parse`。
+
+#### `await kv.setItem(keyName, keyValue)`
+- 支持普通 key 与路径 key。
+- `keyValue` 为对象时自动 `JSON.stringify`。
+
+#### `await kv.removeItem(keyName)`
+- 支持普通 key 与路径 key。
+
+#### `await kv.list(options = {})`
+- 仅支持 Worker。
+- 透传 `prefix` / `limit` / `cursor` 到 `namespace.list(options)`。
+- 返回 Cloudflare KV 的原生结果：`keys` / `list_complete` / `cursor`。
+
+#### `await kv.clear()`
+- 始终返回 `false`。
+
 ### `polyfill/Console.mjs`
 
 `Console` 是统一日志工具（静态类）。
@@ -507,7 +554,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 +566,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 +670,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 +710,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/index.js

@@ -6,6 +6,7 @@ export * from "./lib/time.mjs";
 export * from "./lib/wait.mjs";
 export * from "./polyfill/Console.mjs";
 export * from "./polyfill/fetch.mjs";
+export * from "./polyfill/KV.mjs";
 export * from "./polyfill/Lodash.mjs";
 export * from "./polyfill/StatusTexts.mjs";
 export * from "./polyfill/Storage.mjs";

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

@@ -42,5 +42,5 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "version": "2.2.3"
+  "version": "2.3.0"
 }

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/KV.mjs

@@ -0,0 +1,240 @@
+import { $app } from "../lib/app.mjs";
+import { Lodash as _ } from "./Lodash.mjs";
+import { Storage } from "./Storage.mjs";
+
+/**
+ * Cloudflare Workers KV 异步适配器。
+ * Async adapter for Cloudflare Workers KV.
+ *
+ * 设计目标:
+ * Design goal:
+ * - 提供与 `Storage` 接近的异步接口
+ * - Provide an async API close to `Storage`
+ * - 在 Worker 中使用显式传入的 KV namespace binding
+ * - Use an explicitly passed KV namespace binding in Workers
+ * - 在非 Worker 平台回退到 `Storage`
+ * - Fall back to `Storage` on non-Worker platforms
+ *
+ * 支持路径键:
+ * Supports path key:
+ * - `@root.path.to.value`
+ *
+ * @link https://developers.cloudflare.com/kv/get-started/#5-access-your-kv-namespace-from-your-worker
+ * @link https://developers.cloudflare.com/kv/api/read-key-value-pairs/
+ * @link https://developers.cloudflare.com/kv/api/write-key-value-pairs/
+ * @link https://developers.cloudflare.com/kv/api/delete-key-value-pairs/
+ * @link https://developers.cloudflare.com/kv/api/list-keys/
+ */
+export class KV {
+	/**
+	 * `@key.path` 解析正则。
+	 * Regex for `@key.path` parsing.
+	 *
+	 * @type {RegExp}
+	 */
+	static #nameRegex = /^@(?<key>[^.]+)(?:\.(?<path>.*))?$/;
+
+	/**
+	 * Cloudflare KV namespace 绑定。
+	 * Cloudflare KV namespace binding.
+	 *
+	 * @type {{ get(key: string): Promise<string|null>; put(key: string, value: string): Promise<void>; delete(key: string): Promise<void>; list?(options?: { prefix?: string; limit?: number; cursor?: string }): Promise<{ keys: { name: string; expiration?: number; metadata?: object }[]; list_complete: boolean; cursor: string }> } | undefined}
+	 */
+	namespace;
+
+	/**
+	 * 创建 KV 适配器实例。
+	 * Create a KV adapter instance.
+	 *
+	 * @param {{ get(key: string): Promise<string|null>; put(key: string, value: string): Promise<void>; delete(key: string): Promise<void>; list?(options?: { prefix?: string; limit?: number; cursor?: string }): Promise<{ keys: { name: string; expiration?: number; metadata?: object }[]; list_complete: boolean; cursor: string }> } | null | undefined} namespace KV namespace 绑定 / KV namespace binding.
+	 */
+	constructor(namespace) {
+		this.namespace = namespace ?? undefined;
+	}
+
+	/**
+	 * 读取存储值。
+	 * Read value from persistent storage.
+	 *
+	 * @param {string} keyName 键名或路径键 / Key or path key.
+	 * @param {*} [defaultValue=null] 默认值 / Default value when key is missing.
+	 * @returns {Promise<*>}
+	 */
+	async getItem(keyName, defaultValue = null) {
+		let keyValue = defaultValue;
+		switch (keyName.startsWith("@")) {
+			case true: {
+				const { key, path } = keyName.match(KV.#nameRegex)?.groups ?? {};
+				keyName = key;
+				let value = await this.getItem(keyName, {});
+				if (typeof value !== "object" || value === null) value = {};
+				keyValue = _.get(value, path);
+				keyValue = KV.#deserialize(keyValue);
+				break;
+			}
+			default:
+				switch ($app) {
+					case "Worker":
+						keyValue = await this.#getNamespace().get(keyName);
+						break;
+					default:
+						keyValue = Storage.getItem(keyName, defaultValue);
+						break;
+				}
+				keyValue = KV.#deserialize(keyValue);
+				break;
+		}
+		return keyValue ?? defaultValue;
+	}
+
+	/**
+	 * 写入存储值。
+	 * Write value into persistent storage.
+	 *
+	 * @param {string} keyName 键名或路径键 / Key or path key.
+	 * @param {*} keyValue 写入值 / Value to store.
+	 * @returns {Promise<boolean>}
+	 */
+	async setItem(keyName = new String(), keyValue = new String()) {
+		let result = false;
+		keyValue = KV.#serialize(keyValue);
+		switch (keyName.startsWith("@")) {
+			case true: {
+				const { key, path } = keyName.match(KV.#nameRegex)?.groups ?? {};
+				keyName = key;
+				let value = await this.getItem(keyName, {});
+				if (typeof value !== "object" || value === null) value = {};
+				_.set(value, path, keyValue);
+				result = await this.setItem(keyName, value);
+				break;
+			}
+			default:
+				switch ($app) {
+					case "Worker":
+						await this.#getNamespace().put(keyName, keyValue);
+						result = true;
+						break;
+					default:
+						result = Storage.setItem(keyName, keyValue);
+						break;
+				}
+				break;
+		}
+		return result;
+	}
+
+	/**
+	 * 删除存储值。
+	 * Remove value from persistent storage.
+	 *
+	 * @param {string} keyName 键名或路径键 / Key or path key.
+	 * @returns {Promise<boolean>}
+	 */
+	async removeItem(keyName) {
+		let result = false;
+		switch (keyName.startsWith("@")) {
+			case true: {
+				const { key, path } = keyName.match(KV.#nameRegex)?.groups ?? {};
+				keyName = key;
+				let value = await this.getItem(keyName);
+				if (typeof value !== "object" || value === null) value = {};
+				_.unset(value, path);
+				result = await this.setItem(keyName, value);
+				break;
+			}
+			default:
+				switch ($app) {
+					case "Worker":
+						await this.#getNamespace().delete(keyName);
+						result = true;
+						break;
+					default:
+						result = Storage.removeItem(keyName);
+						break;
+				}
+				break;
+		}
+		return result;
+	}
+
+	/**
+	 * 清空存储。
+	 * Clear storage.
+	 *
+	 * @returns {Promise<boolean>}
+	 */
+	async clear() {
+		return false;
+	}
+
+	/**
+	 * 列出命名空间中的键。
+	 * List keys in the namespace.
+	 *
+	 * @param {{ prefix?: string; limit?: number; cursor?: string }} [options={}] 列举选项 / List options.
+	 * @returns {Promise<{ keys: { name: string; expiration?: number; metadata?: object }[]; list_complete: boolean; cursor: string }>}
+	 */
+	async list(options = {}) {
+		switch ($app) {
+			case "Worker": {
+				const namespace = this.#getNamespace();
+				if (typeof namespace.list !== "function") throw new TypeError("KV namespace binding with list() is required in Worker runtime.");
+				return await namespace.list(options);
+			}
+			default:
+				throw new TypeError("KV.list() is only supported in Worker runtime.");
+		}
+	}
+
+	/**
+	 * 解析 Worker 所需的 namespace 绑定。
+	 * Resolve the namespace binding required by Workers.
+	 *
+	 * @private
+	 * @returns {{ get(key: string): Promise<string|null>; put(key: string, value: string): Promise<void>; delete(key: string): Promise<void>; list?(options?: { prefix?: string; limit?: number; cursor?: string }): Promise<{ keys: { name: string; expiration?: number; metadata?: object }[]; list_complete: boolean; cursor: string }> }}
+	 */
+	#getNamespace() {
+		if (
+			!this.namespace ||
+			typeof this.namespace.get !== "function" ||
+			typeof this.namespace.put !== "function" ||
+			typeof this.namespace.delete !== "function"
+		) {
+			throw new TypeError("KV namespace binding is required in Worker runtime.");
+		}
+		return this.namespace;
+	}
+
+	/**
+	 * 尝试将字符串反序列化为原始值。
+	 * Try to deserialize a string into its original value.
+	 *
+	 * @private
+	 * @param {*} value 原始值 / Raw value.
+	 * @returns {*}
+	 */
+	static #deserialize(value) {
+		try {
+			return JSON.parse(value);
+		} catch (e) {
+			return value;
+		}
+	}
+
+	/**
+	 * 规范化待写入的值。
+	 * Normalize a value before persisting it.
+	 *
+	 * @private
+	 * @param {*} value 原始值 / Raw value.
+	 * @returns {string}
+	 */
+	static #serialize(value) {
+		switch (typeof value) {
+			case "object":
+				return JSON.stringify(value);
+			default:
+				return String(value);
+		}
+	}
+}

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` 等兼容字段
@@ -117,6 +119,7 @@ export async function fetch(resource, options = {}) {
 		switch ($app) {
 			case "Loon":
 			case "Quantumult X":
+			case "Worker":
 			case "Node.js":
 				// 这些平台要求毫秒，因此把秒重新换算为毫秒。
 				// These platforms expect milliseconds, so convert seconds back to milliseconds.
@@ -238,9 +241,10 @@ 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.
+			// 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:
@@ -261,8 +265,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/polyfill/index.js

@@ -1,5 +1,6 @@
 export * from "./Console.mjs";
 export * from "./fetch.mjs";
+export * from "./KV.mjs";
 export * from "./Lodash.mjs";
 export * from "./StatusTexts.mjs";
 export * from "./Storage.mjs";

package/types/modules/core.d.ts

@@ -0,0 +1,54 @@
+declare module "@nsnanocat/util" {
+	export type AppName =
+		| "Quantumult X"
+		| "Loon"
+		| "Shadowrocket"
+		| "Egern"
+		| "Surge"
+		| "Stash"
+		| "Worker"
+		| "Node.js";
+
+	export const $app: AppName | undefined;
+	export const $argument: Record<string, unknown>;
+	export const argument: typeof $argument;
+
+	export interface DonePayload {
+		status?: number | string;
+		url?: string;
+		headers?: Record<string, unknown>;
+		body?: string | ArrayBuffer | ArrayBufferView;
+		bodyBytes?: ArrayBuffer;
+		policy?: string;
+	}
+
+	export function done(object?: DonePayload): void;
+
+	export interface NotificationContentObject {
+		open?: string;
+		"open-url"?: string;
+		url?: string;
+		openUrl?: string;
+		copy?: string;
+		"update-pasteboard"?: string;
+		updatePasteboard?: string;
+		media?: string;
+		"media-url"?: string;
+		mediaUrl?: string;
+		mime?: string;
+		"auto-dismiss"?: number;
+		sound?: string;
+	}
+
+	export type NotificationContent = NotificationContentObject | string | number | boolean;
+
+	export function notification(
+		title?: string,
+		subtitle?: string,
+		body?: string,
+		content?: NotificationContent,
+	): void;
+
+	export function time(format: string, ts?: number): string;
+	export function wait(delay?: number): Promise<void>;
+}

package/types/modules/environment.d.ts

@@ -0,0 +1,4 @@
+declare module "@nsnanocat/util/lib/environment.mjs" {
+	export const $environment: Record<string, unknown>;
+	export function environment(): Record<string, unknown>;
+}

package/types/modules/fetch.d.ts

@@ -0,0 +1,29 @@
+declare module "@nsnanocat/util" {
+	export interface FetchRequest {
+		url: string;
+		method?: string;
+		headers?: Record<string, unknown>;
+		body?: string | ArrayBuffer | ArrayBufferView | object;
+		bodyBytes?: ArrayBuffer;
+		timeout?: number | string;
+		policy?: string;
+		redirection?: boolean;
+		"auto-redirect"?: boolean;
+		"auto-cookie"?: boolean | number | string;
+		opts?: Record<string, unknown>;
+		[key: string]: unknown;
+	}
+
+	export interface FetchResponse {
+		ok: boolean;
+		status: number;
+		statusCode?: number;
+		statusText?: string;
+		headers?: Record<string, unknown>;
+		body?: string | ArrayBuffer;
+		bodyBytes?: ArrayBuffer;
+		[key: string]: unknown;
+	}
+
+	export function fetch(resource: FetchRequest | string, options?: Partial<FetchRequest>): Promise<FetchResponse>;
+}

package/types/modules/getStorage.d.ts

@@ -0,0 +1,22 @@
+declare module "@nsnanocat/util/getStorage.mjs" {
+	export interface StorageProfile {
+		Settings: Record<string, unknown>;
+		Configs: Record<string, unknown>;
+		Caches: Record<string, unknown>;
+	}
+
+	export function traverseObject(
+		o: Record<string, unknown>,
+		c: (key: string, value: unknown) => unknown,
+	): Record<string, unknown>;
+
+	export function string2number(string: string): string | number;
+
+	export function value2array(value: string | number | boolean | string[] | null | undefined): Array<string | number | boolean>;
+
+	export default function getStorage(
+		key: string,
+		names: string | string[] | Array<string | string[]>,
+		database: Record<string, unknown>,
+	): StorageProfile;
+}

package/types/modules/kv.d.ts

@@ -0,0 +1,35 @@
+declare module "@nsnanocat/util" {
+	export interface KVNamespaceLike {
+		get(key: string): Promise<string | null>;
+		put(key: string, value: string): Promise<void>;
+		delete(key: string): Promise<void>;
+		list?(options?: KVListOptions): Promise<KVListResult>;
+	}
+
+	export interface KVListOptions {
+		prefix?: string;
+		limit?: number;
+		cursor?: string;
+	}
+
+	export interface KVListKey {
+		name: string;
+		expiration?: number;
+		metadata?: Record<string, unknown>;
+	}
+
+	export interface KVListResult {
+		keys: KVListKey[];
+		list_complete: boolean;
+		cursor: string;
+	}
+
+	export class KV {
+		constructor(namespace?: KVNamespaceLike | null);
+		getItem<T = unknown>(keyName: string, defaultValue?: T): Promise<T>;
+		setItem(keyName: string, keyValue: unknown): Promise<boolean>;
+		removeItem(keyName: string): Promise<boolean>;
+		clear(): Promise<boolean>;
+		list(options?: KVListOptions): Promise<KVListResult>;
+	}
+}

package/types/modules/polyfills.d.ts

@@ -0,0 +1,34 @@
+declare module "@nsnanocat/util" {
+	export class Console {
+		static clear(): void;
+		static count(label?: string): void;
+		static countReset(label?: string): void;
+		static debug(...msg: unknown[]): void;
+		static error(...msg: unknown[]): void;
+		static exception(...msg: unknown[]): void;
+		static group(label: string): number;
+		static groupEnd(): string | undefined;
+		static info(...msg: unknown[]): void;
+		static get logLevel(): "OFF" | "ERROR" | "WARN" | "INFO" | "DEBUG" | "ALL";
+		static set logLevel(level: number | string);
+		static log(...msg: unknown[]): void;
+		static time(label?: string): Map<string, number>;
+		static timeEnd(label?: string): boolean;
+		static timeLog(label?: string): void;
+		static warn(...msg: unknown[]): void;
+	}
+
+	export class Lodash {
+		static escape(string: string): string;
+		static get<T = unknown, D = undefined>(object?: Record<string, unknown>, path?: string | string[], defaultValue?: D): T | D;
+		static merge<T extends Record<string, unknown>>(object: T, ...sources: Array<Record<string, unknown> | null | undefined>): T;
+		static omit<T extends Record<string, unknown>>(object?: T, paths?: string | string[]): T;
+		static pick<T extends Record<string, unknown>, K extends keyof T>(object?: T, paths?: K | K[]): Pick<T, K>;
+		static set<T extends Record<string, unknown>>(object: T, path: string | string[], value: unknown): T;
+		static toPath(value: string): string[];
+		static unescape(string: string): string;
+		static unset(object?: Record<string, unknown>, path?: string | string[]): boolean;
+	}
+
+	export const StatusTexts: Record<number, string>;
+}

package/types/modules/storage.d.ts

@@ -0,0 +1,10 @@
+declare module "@nsnanocat/util" {
+	export class Storage {
+		static data: Record<string, unknown> | null;
+		static dataFile: string;
+		static getItem<T = unknown>(keyName: string, defaultValue?: T): T;
+		static setItem(keyName: string, keyValue: unknown): boolean;
+		static removeItem(keyName: string): boolean;
+		static clear(): boolean;
+	}
+}

package/types/nsnanocat-util.d.ts

@@ -1,151 +1,7 @@
-declare module "@nsnanocat/util" {
-	export type AppName =
-		| "Quantumult X"
-		| "Loon"
-		| "Shadowrocket"
-		| "Egern"
-		| "Surge"
-		| "Stash"
-		| "Node.js";
-
-	export const $app: AppName | undefined;
-	export const $argument: Record<string, unknown>;
-	export const argument: typeof $argument;
-
-	export interface DonePayload {
-		status?: number | string;
-		url?: string;
-		headers?: Record<string, unknown>;
-		body?: string | ArrayBuffer | ArrayBufferView;
-		bodyBytes?: ArrayBuffer;
-		policy?: string;
-	}
-
-	export function done(object?: DonePayload): void;
-
-	export interface NotificationContentObject {
-		open?: string;
-		"open-url"?: string;
-		url?: string;
-		openUrl?: string;
-		copy?: string;
-		"update-pasteboard"?: string;
-		updatePasteboard?: string;
-		media?: string;
-		"media-url"?: string;
-		mediaUrl?: string;
-		mime?: string;
-		"auto-dismiss"?: number;
-		sound?: string;
-	}
-
-	export type NotificationContent = NotificationContentObject | string | number | boolean;
-
-	export function notification(
-		title?: string,
-		subtitle?: string,
-		body?: string,
-		content?: NotificationContent,
-	): void;
-
-	export function time(format: string, ts?: number): string;
-	export function wait(delay?: number): Promise<void>;
-
-	export interface FetchRequest {
-		url: string;
-		method?: string;
-		headers?: Record<string, unknown>;
-		body?: string | ArrayBuffer | ArrayBufferView | object;
-		bodyBytes?: ArrayBuffer;
-		timeout?: number | string;
-		policy?: string;
-		redirection?: boolean;
-		"auto-redirect"?: boolean;
-		"auto-cookie"?: boolean | number | string;
-		opts?: Record<string, unknown>;
-		[key: string]: unknown;
-	}
-
-	export interface FetchResponse {
-		ok: boolean;
-		status: number;
-		statusCode?: number;
-		statusText?: string;
-		headers?: Record<string, unknown>;
-		body?: string | ArrayBuffer;
-		bodyBytes?: ArrayBuffer;
-		[key: string]: unknown;
-	}
-
-	export function fetch(resource: FetchRequest | string, options?: Partial<FetchRequest>): Promise<FetchResponse>;
-
-	export class Console {
-		static clear(): void;
-		static count(label?: string): void;
-		static countReset(label?: string): void;
-		static debug(...msg: unknown[]): void;
-		static error(...msg: unknown[]): void;
-		static exception(...msg: unknown[]): void;
-		static group(label: string): number;
-		static groupEnd(): string | undefined;
-		static info(...msg: unknown[]): void;
-		static get logLevel(): "OFF" | "ERROR" | "WARN" | "INFO" | "DEBUG" | "ALL";
-		static set logLevel(level: number | string);
-		static log(...msg: unknown[]): void;
-		static time(label?: string): Map<string, number>;
-		static timeEnd(label?: string): boolean;
-		static timeLog(label?: string): void;
-		static warn(...msg: unknown[]): void;
-	}
-
-	export class Lodash {
-		static escape(string: string): string;
-		static get<T = unknown, D = undefined>(object?: Record<string, unknown>, path?: string | string[], defaultValue?: D): T | D;
-		static merge<T extends Record<string, unknown>>(object: T, ...sources: Array<Record<string, unknown> | null | undefined>): T;
-		static omit<T extends Record<string, unknown>>(object?: T, paths?: string | string[]): T;
-		static pick<T extends Record<string, unknown>, K extends keyof T>(object?: T, paths?: K | K[]): Pick<T, K>;
-		static set<T extends Record<string, unknown>>(object: T, path: string | string[], value: unknown): T;
-		static toPath(value: string): string[];
-		static unescape(string: string): string;
-		static unset(object?: Record<string, unknown>, path?: string | string[]): boolean;
-	}
-
-	export const StatusTexts: Record<number, string>;
-
-	export class Storage {
-		static data: Record<string, unknown> | null;
-		static dataFile: string;
-		static getItem<T = unknown>(keyName: string, defaultValue?: T): T;
-		static setItem(keyName: string, keyValue: unknown): boolean;
-		static removeItem(keyName: string): boolean;
-		static clear(): boolean;
-	}
-}
-
-declare module "@nsnanocat/util/getStorage.mjs" {
-	export interface StorageProfile {
-		Settings: Record<string, unknown>;
-		Configs: Record<string, unknown>;
-		Caches: Record<string, unknown>;
-	}
-
-	export function traverseObject(
-		o: Record<string, unknown>,
-		c: (key: string, value: unknown) => unknown,
-	): Record<string, unknown>;
-
-	export function string2number(string: string): string | number;
-
-	export function value2array(value: string | number | boolean | string[] | null | undefined): Array<string | number | boolean>;
-
-	export default function getStorage(
-		key: string,
-		names: string | string[] | Array<string | string[]>,
-		database: Record<string, unknown>,
-	): StorageProfile;
-}
-
-declare module "@nsnanocat/util/lib/environment.mjs" {
-	export const $environment: Record<string, unknown>;
-	export function environment(): Record<string, unknown>;
-}
+/// <reference path="./modules/core.d.ts" />
+/// <reference path="./modules/fetch.d.ts" />
+/// <reference path="./modules/polyfills.d.ts" />
+/// <reference path="./modules/storage.d.ts" />
+/// <reference path="./modules/kv.d.ts" />
+/// <reference path="./modules/getStorage.d.ts" />
+/// <reference path="./modules/environment.d.ts" />