@takboo/dsh-session-bin 0.1.1 → 0.2.1

package/README.md

@@ -6,23 +6,25 @@
 
 ## 功能
 
-- 按会话名称及工作区元数据搜索，按工作区筛选。
+- 默认按工作区分组；按会话名称及工作区元数据搜索、筛选。
 - 单项或批量取消归档，让会话回到原生会话列表。
 - 单项永久删除、固定选择的批量永久删除，以及清空点击时的全部归档。
-- 删除前展示确认和阻止原因，删除后显示逐项结果；中断或断线后可查询结果并明确继续。
+- 简洁的删除确认，可在设置中全局关闭；批量操作显示进度和日志，完成后保留简短统计及失败项。中断或断线后可查询结果并明确继续。
 - 中英文界面，使用宿主控件、浅色和深色主题。
 
-当前版本为 `0.1.1`，包名为 `@takboo/dsh-session-bin`。GitHub Release 提供预编译 tarball；npm 通过 trusted publishing 自动发布同一份产物，dsh-market 收录另行提交。核心功能已完成跨平台验收；运行证据见 [Host 验证](docs/verification/host-lifecycle.md#跨平台生产删除资格晋级验证)和[客户端验证](docs/verification/client-interface.md#跨平台生产删除客户端验证)。
+当前版本为 `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)。
 
 ## 界面预览
 
-![原生归档管理与批量选择](https://raw.githubusercontent.com/takboo/dsh-session-bin/v0.1.0/docs/images/archives-light.png)
+![原生归档管理与批量选择](https://raw.githubusercontent.com/takboo/dsh-session-bin/v0.2.0/docs/images/archives-light.png)
 
-[深色界面](docs/images/archives-dark.png) · [批量永久删除确认](docs/images/batch-deletion.png)。截图来自 `0.1.0` 的真实安装验收，使用隔离测试会话。
+[深色界面](docs/images/archives-dark.png) · [批量永久删除确认](docs/images/batch-deletion.png)。截图来自 `0.2.0` 的真实安装验收，使用隔离测试会话。
 
 ## 兼容性
 
-永久删除绑定 DSH `0.2.0-rc.2`、Node `24.18.1` / libuv `1.52.1`，使用单 Host 和已验证的 JSONL raw/zstd 存储组合。
+本版适配 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.1`、Node `24.18.1` / libuv `1.52.1`，使用单 Host 和已验证的 JSONL raw/zstd 存储组合。
 
 | 已验收环境 | CPU 架构 | 文件系统 |
 | --- | --- | --- |
@@ -34,14 +36,13 @@
 
 ## 安装
 
-当前可从源码构建预编译 tarball。先完成下方[开发入门](#开发入门)，再在仓库根目录运行：
+从 npm 安装已发布的预编译包：
 
 ```sh
-mise exec -- pnpm exec npm pack --ignore-scripts
-dsh plugin --profile web add ./takboo-dsh-session-bin-0.1.1.tgz
+dsh plugin --profile web add @takboo/dsh-session-bin@0.2.1
 ```
 
-以上命令使用已安装的 DSH `0.2.0-rc.2`，将完整插件 bundle 安装到 `web` profile；该路径已通过真实 CLI/GUI 验证。启动或重新启动该 profile 后，从侧栏打开“会话回收站”（Session Bin）。tarball 包含预编译 Host 和 Client，使用者安装时无需编译 TypeScript。
+以上命令使用已安装的 DSH `0.2.1-rc.1`，将完整插件 bundle 安装到 `web` profile。桌面版请在其对应 profile 的插件管理页面安装同一个 npm 包。启动或重新启动该 profile 后，从侧栏打开“会话回收站”（Session Bin）。发布包包含预编译 Host 和 Client，使用者安装时无需编译 TypeScript；其 tarball 已通过真实 CLI/GUI 验证。
 
 卸载同一 profile 中的插件：
 
@@ -49,7 +50,7 @@ dsh plugin --profile web add ./takboo-dsh-session-bin-0.1.1.tgz
 dsh plugin --profile web remove @takboo/dsh-session-bin
 ```
 
-也可下载 [v0.1.1 Release](https://github.com/takboo/dsh-session-bin/releases/tag/v0.1.1) 中的 `dsh-session-bin.tgz`，通过同一个 `dsh plugin --profile web add` 命令安装。也可从 npm 安装：`dsh plugin --profile web add @takboo/dsh-session-bin@0.1.1`。
+也可下载 [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`。
 
 如安装过早期未加 scope 的开发包，先从同一 profile 卸载 `dsh-session-bin`，再安装 scoped 包，避免重复注册；原生归档和已有操作记录保留。分发契约见[发布文档](docs/release.md)。
 
@@ -63,8 +64,8 @@ dsh plugin --profile web remove @takboo/dsh-session-bin
 
 1. 使用 Harness 原生“归档会话”操作归档目标会话。
 2. 打开“会话回收站”，搜索或筛选已有归档；选择单项或多项取消归档。
-3. 永久删除时，先核对确认窗口中的对象、范围和阻止原因，再明确确认执行。
-4. 如出现部分失败或连接中断，查看逐项结果，检查操作状态后再决定是否继续。
+3. 永久删除时，核对确认窗口中的对象和阻止原因，再确认执行。设置中的“永久删除会话前进行确认”默认开启；关闭后，点击单项删除、删除所选或清空将直接开始永久删除。
+4. 批量操作期间查看进度和日志，完成后只保留统计及需要处理的项。如出现部分失败或连接中断，先检查操作状态，再决定是否继续。
 
 **“清空全部归档”包含点击时的全部归档，搜索和工作区筛选不会缩小其范围。** 批量删除固定开始时的对象，后来新增的归档不会加入。
 

package/dist/client-model.js

@@ -637,10 +637,11 @@ function frozenPurgeKey(plan) {
   ]);
 }
 var SessionBinClientModel = class {
-  constructor(api, createStream, cache) {
+  constructor(api, createStream, cache, preferences) {
     this.api = api;
     this.createStream = createStream;
     this.cache = cache;
+    this.preferences = preferences;
     try {
       this.state = { ...this.state, pending: pendingPlans(cache?.load()) };
     } catch {
@@ -696,7 +697,12 @@ var SessionBinClientModel = class {
     }
     const purgeCacheBlocked = Boolean(cache?.isPurgeCacheBlocked?.()) || purgeCacheOverflow(rawPurgePlans, rawPurgeGrants, rawPurgeObservations, rawPurgeBatchOperations);
     this.state = { ...this.state, purgeCacheBlocked };
+    try {
+      this.state.confirmDeletion = preferences?.load() !== false;
+    } catch {
+    }
     this.snapshot = structuredClone(this.state);
+    this.stopPreferences = preferences?.subscribe?.((confirmDeletion) => this.publish({ confirmDeletion }));
   }
   state = {
     phase: "loading",
@@ -711,7 +717,8 @@ var SessionBinClientModel = class {
     purgeResults: [],
     purgeBatch: null,
     purgeBatchOperationIds: [],
-    purgeCacheBlocked: false
+    purgeCacheBlocked: false,
+    confirmDeletion: true
   };
   snapshot = structuredClone(this.state);
   listeners = /* @__PURE__ */ new Set();
@@ -733,6 +740,14 @@ var SessionBinClientModel = class {
   purgeBatch = null;
   purgeBatchRun = null;
   purgePreparationEpoch = 0;
+  stopPreferences;
+  setConfirmDeletion(confirmDeletion) {
+    try {
+      this.preferences?.save(confirmDeletion);
+    } catch {
+    }
+    this.publish({ confirmDeletion });
+  }
   getSnapshot = () => this.snapshot;
   subscribe = (listener) => {
     this.listeners.add(listener);
@@ -781,6 +796,7 @@ var SessionBinClientModel = class {
     })();
   }
   async dispose() {
+    this.stopPreferences?.();
     this.lifetime.abort();
     ++this.epoch;
     await this.stream?.dispose();
@@ -929,6 +945,25 @@ var SessionBinClientModel = class {
       return { plan: null, reason: "connection-failed" };
     }
   }
+  /** Only a fresh user click can opt out of the presentation confirmation. */
+  async requestPurge(entry, title) {
+    const skip = !this.state.confirmDeletion;
+    const epoch = this.epoch;
+    const plan = await this.preparePurge(entry, title);
+    if (skip && !this.state.confirmDeletion && epoch === this.epoch && plan && this.confirmation?.plan.operationId === plan.operationId) {
+      this.acknowledgePurge(true);
+      await this.confirmPurge();
+    }
+  }
+  async requestPurgeBatch(scope, titles = {}) {
+    const skip = !this.state.confirmDeletion;
+    const epoch = this.epoch;
+    const batch = await this.preparePurgeBatch(scope, titles);
+    if (skip && !this.state.confirmDeletion && epoch === this.epoch && batch?.phase === "confirming" && this.purgeBatch?.batchId === batch.batchId && batch.items.some((item) => item.state === "ready")) {
+      this.acknowledgePurgeBatch(true);
+      await this.runPurgeBatch();
+    }
+  }
   async preparePurge(entry, title) {
     const target = { sessionId: entry.sessionId, entryId: entry.entryId, title };
     if (this.rejectPurgeCacheCapacity() || this.state.phase !== "ready" || this.state.busy.includes(target.sessionId) || this.confirmation || this.hasActivePurgeBatch() || this.state.purgePending.length > 0 || this.state.pending.some((plan) => plan.schemaVersion === 2 && plan.sessionId === target.sessionId) || this.lifetime.signal.aborted) return null;
@@ -1666,8 +1701,32 @@ function browserPendingCache(storage) {
     }
   };
 }
+function browserDeletionPreferences(storage, events) {
+  const key2 = "dsh-session-bin.preferences.v1";
+  const parse = (raw) => {
+    try {
+      const value2 = JSON.parse(raw ?? "null");
+      return !(value2?.schemaVersion === 1 && value2.confirmDeletion === false);
+    } catch {
+      return true;
+    }
+  };
+  return {
+    load: () => parse(storage.getItem(key2)),
+    save: (confirmDeletion) => storage.setItem(key2, JSON.stringify({ schemaVersion: 1, confirmDeletion })),
+    subscribe: (listener) => {
+      const changed = (event) => {
+        const update = event;
+        if (update.storageArea === storage && (update.key === key2 || update.key === null)) listener(parse(update.newValue));
+      };
+      events?.addEventListener("storage", changed);
+      return () => events?.removeEventListener("storage", changed);
+    }
+  };
+}
 export {
   SessionBinClientModel,
+  browserDeletionPreferences,
   browserPendingCache,
   retirementManifestDigest
 };