@takboo/dsh-session-bin 0.2.1 → 0.2.4

package/README.md

@@ -12,7 +12,7 @@
 - 简洁的删除确认，可在设置中全局关闭；批量操作显示进度和日志，完成后保留简短统计及失败项。中断或断线后可查询结果并明确继续。
 - 中英文界面，使用宿主控件、浅色和深色主题。
 
-当前版本为 `0.2.1`，包名为 `@takboo/dsh-session-bin`。GitHub Release 提供预编译 tarball；npm 通过 trusted publishing 自动发布同一份产物。[dshmarket 收录流程](docs/release.md#dshmarket)独立于 npm 发布，须经目录检查与维护者审核。核心功能的分平台运行证据见[当前兼容性验证](docs/verification/dsh-0.2.1-rc1.md)。
+当前版本为 `0.2.4`，包名为 `@takboo/dsh-session-bin`。GitHub Release 提供预编译 tarball；npm 通过 trusted publishing 自动发布同一份产物。[dshmarket 收录流程](docs/release.md#dshmarket)独立于 npm 发布，须经目录检查与维护者审核。核心功能的分平台运行证据见[当前桌面兼容性验证](docs/verification/desktop-runtime.md)。
 
 ## 界面预览
 
@@ -22,27 +22,28 @@
 
 ## 兼容性
 
-本版适配 DSH `0.2.1-rc.1`，修复 JSONL 插件入口及 API Session 生命周期的兼容性；详细证据见[兼容性验证](docs/verification/dsh-0.2.1-rc1.md)。使用旧宿主 `0.2.0-rc.2` 时请保留插件 `0.2.0`。
+本版适配 DSH `0.2.1-rc.2`，修复 macOS ARM64 桌面版内置运行时被拒绝永久删除的问题，见[桌面兼容性验证](docs/verification/desktop-runtime.md)。此前 CLI/Web 的 SDK 适配证据见[rc.2 验证](docs/verification/dsh-0.2.1-rc2.md)。使用 DSH `0.2.1-rc.1` 时请保留插件 `0.2.1`；旧宿主 `0.2.0-rc.2` 对应插件 `0.2.0`。
 
-永久删除绑定 DSH `0.2.1-rc.1`、Node `24.18.1` / libuv `1.52.1`，使用单 Host 和已验证的 JSONL raw/zstd 存储组合。
+永久删除仅对以下精确运行时及环境启用，使用单 Host 和已验证的 JSONL raw/zstd 存储组合：
 
-| 已验收环境 | CPU 架构 | 文件系统 |
-| --- | --- | --- |
-| Windows Server 2025 | x64 | NTFS |
-| macOS 15 | Apple Silicon ARM64、Intel x64 | APFS |
-| Ubuntu 24.04 | ARM64、x64 | ext2/ext3/ext4 family（type `0xef53`） |
+| 宿主运行时 | 已验收环境 | CPU 架构 | 文件系统 |
+| --- | --- | --- | --- |
+| 独立 Node `24.18.1` / libuv `1.52.1` | Windows Server 2025 | x64 | NTFS |
+| 独立 Node `24.18.1` / libuv `1.52.1` | macOS 15 | Apple Silicon ARM64、Intel x64 | APFS |
+| 独立 Node `24.18.1` / libuv `1.52.1` | Ubuntu 24.04 | ARM64、x64 | ext2/ext3/ext4 family（type `0xef53`） |
+| Electron `44.7.0` / Node `24.21.0` / libuv `1.52.1` | macOS 15 桌面运行时 | Apple Silicon ARM64 | APFS |
 
-表格记录实际验收环境，不代表所有 Windows、macOS 或 Linux 版本均已验证。Windows ARM64、其他运行时及未验证的存储组合不在支持范围内。永久删除还会检查宿主源码、资源身份和当前状态；不满足条件时明确拒绝。完整准入与限制见 [Host 生命周期](docs/host-lifecycle.md)。
+表格记录实际验收环境，不代表所有 Windows、macOS 或 Linux 版本均已验证。Windows ARM64、其他桌面架构/版本、普通 Node `24.21.0` 及未验证的存储组合不在永久删除支持范围内。永久删除还会检查宿主源码、资源身份和当前状态；不满足条件时明确拒绝。完整准入与限制见 [Host 生命周期](docs/host-lifecycle.md)。
 
 ## 安装
 
 从 npm 安装已发布的预编译包：
 
 ```sh
-dsh plugin --profile web add @takboo/dsh-session-bin@0.2.1
+dsh plugin --profile web add @takboo/dsh-session-bin@0.2.4
 ```
 
-以上命令使用已安装的 DSH `0.2.1-rc.1`，将完整插件 bundle 安装到 `web` profile。桌面版请在其对应 profile 的插件管理页面安装同一个 npm 包。启动或重新启动该 profile 后，从侧栏打开“会话回收站”（Session Bin）。发布包包含预编译 Host 和 Client，使用者安装时无需编译 TypeScript；其 tarball 已通过真实 CLI/GUI 验证。
+以上命令使用已安装的 DSH `0.2.1-rc.2`，将完整插件 bundle 安装到 `web` profile。已验证的 macOS ARM64 桌面版请在 `desktop` profile 的插件管理页面安装同一个 npm 包，并重新启动该 profile 的宿主。启动或重新启动该 profile 后，从侧栏打开“会话回收站”（Session Bin）。发布包包含预编译 Host 和 Client，使用者安装时无需编译 TypeScript；其 tarball 已通过真实 CLI/GUI 验证。
 
 卸载同一 profile 中的插件：
 
@@ -50,7 +51,7 @@ dsh plugin --profile web add @takboo/dsh-session-bin@0.2.1
 dsh plugin --profile web remove @takboo/dsh-session-bin
 ```
 
-也可下载 [v0.2.1 Release](https://github.com/takboo/dsh-session-bin/releases/tag/v0.2.1) 中的三个附件，核对 `SHA256SUMS` 后运行 `dsh plugin --profile web add ./dsh-session-bin.tgz`。自行构建时，先完成下方[开发入门](#开发入门)，再运行 `mise exec -- pnpm exec npm pack --ignore-scripts`。
+也可下载 [v0.2.4 Release](https://github.com/takboo/dsh-session-bin/releases/tag/v0.2.4) 中的三个附件，核对 `SHA256SUMS` 后运行 `dsh plugin --profile web add ./dsh-session-bin.tgz`。自行构建时，先完成下方[开发入门](#开发入门)，再运行 `mise exec -- pnpm exec npm pack --ignore-scripts`。
 
 如安装过早期未加 scope 的开发包，先从同一 profile 卸载 `dsh-session-bin`，再安装 scoped 包，避免重复注册；原生归档和已有操作记录保留。分发契约见[发布文档](docs/release.md)。
 
@@ -93,6 +94,8 @@ mise run verify
 | `mise run build` | 生成预编译产物和类型声明 |
 | `mise run verify` | 完整本地行为与打包验证 |
 | `mise run verify:gui` | 隔离 Web profile 中的双语 CLI/GUI 验证 |
+| `mise run verify:desktop` | 已安装桌面 Electron 与真实 ASAR Host 的隔离完整回归 |
+| `mise run verify:desktop:gui` | 在已安装桌面 Electron 上运行隔离 Web 双语 CLI/GUI |
 | `mise run verify:platform` | 记录实际操作系统的候选组合验收证据 |
 | `mise run verify:linux` | 在固定 Node 的 Linux 容器内验证，需要 Docker |
 

package/dist/host/native-retirement-sdk.d.ts

@@ -7,70 +7,70 @@ export declare const nativeRetirementSdkSources: {
         };
     };
     readonly "dsh-session": {
-        readonly version: "0.2.1-rc.1";
+        readonly version: "0.2.1-rc.2";
         readonly files: {
             readonly "lib/index.js": "2f5dd07cb5c744a29abbb8003a8a4cefd9e582c6e2538074ca299a0ddd02a3bf";
             readonly "lib/types/index.js": "59cced30c7ee65813c62f4858c2fc15c8c636df96507b60c15543468178b72f2";
         };
     };
     readonly "dsh-session-persistence": {
-        readonly version: "0.2.1-rc.1";
+        readonly version: "0.2.1-rc.2";
         readonly files: {
             readonly "lib/index.js": "cc0b6d3a224133af611b428d5a49020e300f86c3b4ba28037aeb219029bde3eb";
         };
     };
     readonly "dsh-session-persistence-jsonl": {
-        readonly version: "0.2.1-rc.1";
+        readonly version: "0.2.1-rc.2";
         readonly files: {
             readonly "lib/index.js": "973dd78679b2661d6f492343bc22b124ae958aa597d3b36c698a2c650f909984";
         };
     };
     readonly "dsh-session-format-catalog": {
-        readonly version: "0.2.1-rc.1";
+        readonly version: "0.2.1-rc.2";
         readonly files: {
             readonly "lib/index.js": "836bbb772ab505c299f1a4a246164c50c7c08b67ab0d17f1251d7ea2cd8c1818";
             readonly "lib/types/index.js": "c7d797760bf2b9bc654751f2f8cb0b8a6b98998c8d9c1e41323c71a4d5f316f2";
         };
     };
     readonly "dsh-storage-domain": {
-        readonly version: "0.2.1-rc.1";
+        readonly version: "0.2.1-rc.2";
         readonly files: {
             readonly "lib/index.js": "a54f7664d2f64fe04a08c7058ca5bff4fc69ed6a0d30c2bc11561b620698ef16";
         };
     };
     readonly "dsh-storage-json": {
-        readonly version: "0.2.1-rc.1";
+        readonly version: "0.2.1-rc.2";
         readonly files: {
             readonly "lib/index.js": "0a6b75d5569db3379edd93e863570170e1f4121b6c9fabd856f5b476cffe8df4";
         };
     };
     readonly "dsh-workspace": {
-        readonly version: "0.2.1-rc.1";
+        readonly version: "0.2.1-rc.2";
         readonly files: {
             readonly "lib/index.js": "931ca0cb10c5102066c7723690a887f0e6e8e7ab0ffdee1a782686745b0b934f";
             readonly "lib/types/index.js": "ed69989d8286598fddb3a40030723810a1238968e91ccfec05fc84657bb5ec74";
         };
     };
     readonly "dsh-session-query": {
-        readonly version: "0.2.1-rc.1";
+        readonly version: "0.2.1-rc.2";
         readonly files: {
             readonly "lib/index.js": "76ce2944e561c12f48b5e240d68cafe54ce6d667b1d20722e6939ed834489939";
         };
     };
     readonly "dsh-session-query-sqlite": {
-        readonly version: "0.2.1-rc.1";
+        readonly version: "0.2.1-rc.2";
         readonly files: {
             readonly "lib/index.js": "dbecf83320e10d93d735b3d01384ab817a0b90102ccecb0a22c013c71dfe70a0";
         };
     };
     readonly "dsh-session-projection-cache": {
-        readonly version: "0.2.1-rc.1";
+        readonly version: "0.2.1-rc.2";
         readonly files: {
             readonly "lib/index.js": "faf307dce5db2fb7ff58b4c7d9e544fc7cad5de2f270a89326a8d7bb2bda9c80";
         };
     };
     readonly "dsh-api-session-controller": {
-        readonly version: "0.2.1-rc.1";
+        readonly version: "0.2.1-rc.2";
         readonly files: {
             readonly "lib/index.js": "a9801acb577b03053c5d5a3191ff555c5f1d791d0acddec113bea4511e33b386";
             readonly "lib/types/index.js": "616ced16623b7448afa908ff65093eb6ef2a478d32e5ef9bc22634bfa9f80472";

package/dist/host/platform-files.d.ts

@@ -1,8 +1,10 @@
 import type { FileHandle } from 'node:fs/promises';
 export type NativePlatform = 'darwin' | 'linux' | 'win32';
 export declare function nativePlatformCandidate(platform?: NodeJS.Platform, arch?: NodeJS.Architecture): boolean;
+/** Audited runtime carriers; production OS qualification remains independent. */
+export declare function nativeRuntimeCandidate(node?: string, uv?: string, electron?: string | undefined): boolean;
 /** Actual erasure evidence is promoted separately from an implemented Adapter. */
-export declare function nativePlatformVerified(platform?: NodeJS.Platform, arch?: NodeJS.Architecture, node?: string, uv?: string): boolean;
+export declare function nativePlatformVerified(platform?: NodeJS.Platform, arch?: NodeJS.Architecture, node?: string, uv?: string, electron?: string | undefined): boolean;
 /** Session namespace matches the audited JSONL writer; plugin ownership is independent. */
 export declare function windowsSemaphoreName(path: string, purpose: 'session' | 'plugin'): string;
 /** Same-volume rename whose metadata acknowledgement is written through. */

package/dist/index.js

@@ -19,8 +19,12 @@ import { resolve, toNamespacedPath } from "node:path";
 function nativePlatformCandidate(platform = process.platform, arch = process.arch) {
   return ["darwin", "linux", "win32"].includes(platform) && ["arm64", "x64"].includes(arch);
 }
-function nativePlatformVerified(platform = process.platform, arch = process.arch, node = process.versions.node, uv = process.versions.uv) {
-  if (node !== "24.18.1" || uv !== "1.52.1") return false;
+function nativeRuntimeCandidate(node = process.versions.node, uv = process.versions.uv, electron = process.versions.electron) {
+  return uv === "1.52.1" && (node === "24.18.1" && !electron || node === "24.21.0" && electron === "44.7.0");
+}
+function nativePlatformVerified(platform = process.platform, arch = process.arch, node = process.versions.node, uv = process.versions.uv, electron = process.versions.electron) {
+  if (node === "24.21.0" && uv === "1.52.1" && electron === "44.7.0") return platform === "darwin" && arch === "arm64";
+  if (node !== "24.18.1" || uv !== "1.52.1" || electron) return false;
   return (/* @__PURE__ */ new Set(["darwin/arm64", "darwin/x64", "linux/arm64", "linux/x64", "win32/x64"])).has(`${platform}/${arch}`);
 }
 var windowsKernel;
@@ -1806,70 +1810,70 @@ var nativeRetirementSdkSources = {
     }
   },
   "dsh-session": {
-    "version": "0.2.1-rc.1",
+    "version": "0.2.1-rc.2",
     "files": {
       "lib/index.js": "2f5dd07cb5c744a29abbb8003a8a4cefd9e582c6e2538074ca299a0ddd02a3bf",
       "lib/types/index.js": "59cced30c7ee65813c62f4858c2fc15c8c636df96507b60c15543468178b72f2"
     }
   },
   "dsh-session-persistence": {
-    "version": "0.2.1-rc.1",
+    "version": "0.2.1-rc.2",
     "files": {
       "lib/index.js": "cc0b6d3a224133af611b428d5a49020e300f86c3b4ba28037aeb219029bde3eb"
     }
   },
   "dsh-session-persistence-jsonl": {
-    "version": "0.2.1-rc.1",
+    "version": "0.2.1-rc.2",
     "files": {
       "lib/index.js": "973dd78679b2661d6f492343bc22b124ae958aa597d3b36c698a2c650f909984"
     }
   },
   "dsh-session-format-catalog": {
-    "version": "0.2.1-rc.1",
+    "version": "0.2.1-rc.2",
     "files": {
       "lib/index.js": "836bbb772ab505c299f1a4a246164c50c7c08b67ab0d17f1251d7ea2cd8c1818",
       "lib/types/index.js": "c7d797760bf2b9bc654751f2f8cb0b8a6b98998c8d9c1e41323c71a4d5f316f2"
     }
   },
   "dsh-storage-domain": {
-    "version": "0.2.1-rc.1",
+    "version": "0.2.1-rc.2",
     "files": {
       "lib/index.js": "a54f7664d2f64fe04a08c7058ca5bff4fc69ed6a0d30c2bc11561b620698ef16"
     }
   },
   "dsh-storage-json": {
-    "version": "0.2.1-rc.1",
+    "version": "0.2.1-rc.2",
     "files": {
       "lib/index.js": "0a6b75d5569db3379edd93e863570170e1f4121b6c9fabd856f5b476cffe8df4"
     }
   },
   "dsh-workspace": {
-    "version": "0.2.1-rc.1",
+    "version": "0.2.1-rc.2",
     "files": {
       "lib/index.js": "931ca0cb10c5102066c7723690a887f0e6e8e7ab0ffdee1a782686745b0b934f",
       "lib/types/index.js": "ed69989d8286598fddb3a40030723810a1238968e91ccfec05fc84657bb5ec74"
     }
   },
   "dsh-session-query": {
-    "version": "0.2.1-rc.1",
+    "version": "0.2.1-rc.2",
     "files": {
       "lib/index.js": "76ce2944e561c12f48b5e240d68cafe54ce6d667b1d20722e6939ed834489939"
     }
   },
   "dsh-session-query-sqlite": {
-    "version": "0.2.1-rc.1",
+    "version": "0.2.1-rc.2",
     "files": {
       "lib/index.js": "dbecf83320e10d93d735b3d01384ab817a0b90102ccecb0a22c013c71dfe70a0"
     }
   },
   "dsh-session-projection-cache": {
-    "version": "0.2.1-rc.1",
+    "version": "0.2.1-rc.2",
     "files": {
       "lib/index.js": "faf307dce5db2fb7ff58b4c7d9e544fc7cad5de2f270a89326a8d7bb2bda9c80"
     }
   },
   "dsh-api-session-controller": {
-    "version": "0.2.1-rc.1",
+    "version": "0.2.1-rc.2",
     "files": {
       "lib/index.js": "a9801acb577b03053c5d5a3191ff555c5f1d791d0acddec113bea4511e33b386",
       "lib/types/index.js": "616ced16623b7448afa908ff65093eb6ef2a478d32e5ef9bc22634bfa9f80472"
@@ -1881,7 +1885,7 @@ var legacyDurableContractFingerprint = "2618a33decce99fe8ae893245236273d10ac5536
 async function nativeRetirementSdkFingerprint() {
   const root = createRequire(import.meta.url);
   const hostPath = root.resolve("@deepseek-ai/dsh/package.json");
-  if (JSON.parse(await readFile(hostPath, "utf8")).version !== "0.2.1-rc.1") return null;
+  if (JSON.parse(await readFile(hostPath, "utf8")).version !== "0.2.1-rc.2") return null;
   const base = createRequire(hostPath);
   for (const [name2, expected] of Object.entries(nativeRetirementSdkSources)) {
     let path;
@@ -1914,7 +1918,7 @@ async function nativeRetirementSdkFingerprint() {
       if (error.code === "MODULE_NOT_FOUND") return null;
       throw error;
     }
-    if (JSON.parse(await readFile(path, "utf8")).version !== "0.2.1-rc.1" || createHash3("sha256").update(await readFile(join2(dirname(path), "lib/index.js"))).digest("hex") !== expected) return null;
+    if (JSON.parse(await readFile(path, "utf8")).version !== "0.2.1-rc.2" || createHash3("sha256").update(await readFile(join2(dirname(path), "lib/index.js"))).digest("hex") !== expected) return null;
   }
   return legacyDurableContractFingerprint;
 }
@@ -2425,7 +2429,7 @@ var NativeJsonlFiles = class _NativeJsonlFiles {
     if (typeof internals.root !== "string" || !isAbsolute2(internals.root) || internals.compression !== "none" && internals.compression !== "zstd" || typeof config?.root !== "string" || resolve2(config.root) !== internals.root || (config.compression ?? "zstd") !== internals.compression) return;
     const require2 = createRequire2(import.meta.url);
     const metadata = require2("@deepseek-ai/dsh-session-persistence-jsonl/package.json");
-    if (metadata.version !== "0.2.1-rc.1") return;
+    if (metadata.version !== "0.2.1-rc.2") return;
     let root;
     try {
       root = await realpath2(internals.root);
@@ -4176,7 +4180,7 @@ var NativeRetirementOwner = class _NativeRetirementOwner {
   observationsClosed = false;
   closing;
   static async open(ctx, options = {}) {
-    if (process.versions.node !== "24.18.1" || process.versions.uv !== "1.52.1" || !nativePlatformCandidate()) return;
+    if (!nativeRuntimeCandidate() || !nativePlatformCandidate()) return;
     if (!nativePlatformVerified() && !options.platformQualification?.({
       platform: process.platform,
       arch: process.arch,
@@ -5054,6 +5058,7 @@ export {
   nativePlatformVerified,
   nativeRetirementDomainSpec,
   nativeRetirementOwnerDomainSpec,
+  nativeRuntimeCandidate,
   nativeServiceInstance,
   openRegularFile,
   preparePurgeRequestSchema,