@takboo/dsh-session-bin 0.1.0 → 0.2.0

package/README.md

@@ -6,19 +6,19 @@
 
 ## 功能
 
-- 按会话名称及工作区元数据搜索，按工作区筛选。
+- 默认按工作区分组；按会话名称及工作区元数据搜索、筛选。
 - 单项或批量取消归档，让会话回到原生会话列表。
 - 单项永久删除、固定选择的批量永久删除，以及清空点击时的全部归档。
-- 删除前展示确认和阻止原因，删除后显示逐项结果；中断或断线后可查询结果并明确继续。
+- 简洁的删除确认，可在设置中全局关闭；批量操作显示进度和日志，完成后保留简短统计及失败项。中断或断线后可查询结果并明确继续。
 - 中英文界面，使用宿主控件、浅色和深色主题。
 
-首发版本为 `0.1.0`，包名为 `@takboo/dsh-session-bin`。GitHub Release 提供预编译 tarball；npm 发布由维护者完成，dsh-market 收录另行提交。核心功能已完成跨平台验收；运行证据见 [Host 验证](docs/verification/host-lifecycle.md#跨平台生产删除资格晋级验证)和[客户端验证](docs/verification/client-interface.md#跨平台生产删除客户端验证)。
+当前版本为 `0.2.0`，包名为 `@takboo/dsh-session-bin`。GitHub Release 提供预编译 tarball；npm 通过 trusted publishing 自动发布同一份产物，dsh-market 收录另行提交。核心功能已完成跨平台验收；运行证据见 [Host 验证](docs/verification/host-lifecycle.md#跨平台生产删除资格晋级验证)和[客户端验证](docs/verification/client-interface.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` 的真实安装验收，使用隔离测试会话。
 
 ## 兼容性
 
@@ -38,7 +38,7 @@
 
 ```sh
 mise exec -- pnpm exec npm pack --ignore-scripts
-dsh plugin --profile web add ./takboo-dsh-session-bin-0.1.0.tgz
+dsh plugin --profile web add ./takboo-dsh-session-bin-0.2.0.tgz
 ```
 
 以上命令使用已安装的 DSH `0.2.0-rc.2`，将完整插件 bundle 安装到 `web` profile；该路径已通过真实 CLI/GUI 验证。启动或重新启动该 profile 后，从侧栏打开“会话回收站”（Session Bin）。tarball 包含预编译 Host 和 Client，使用者安装时无需编译 TypeScript。
@@ -49,7 +49,7 @@ dsh plugin --profile web add ./takboo-dsh-session-bin-0.1.0.tgz
 dsh plugin --profile web remove @takboo/dsh-session-bin
 ```
 
-也可下载 [v0.1.0 Release](https://github.com/takboo/dsh-session-bin/releases/tag/v0.1.0) 中的 `dsh-session-bin.tgz`，通过同一个 `dsh plugin --profile web add` 命令安装。npm 发布后可使用 `dsh plugin --profile web add @takboo/dsh-session-bin@0.1.0`。
+也可下载 [v0.2.0 Release](https://github.com/takboo/dsh-session-bin/releases/tag/v0.2.0) 中的 `dsh-session-bin.tgz`，通过同一个 `dsh plugin --profile web add` 命令安装。也可从 npm 安装：`dsh plugin --profile web add @takboo/dsh-session-bin@0.2.0`。
 
 如安装过早期未加 scope 的开发包，先从同一 profile 卸载 `dsh-session-bin`，再安装 scoped 包，避免重复注册；原生归档和已有操作记录保留。分发契约见[发布文档](docs/release.md)。
 
@@ -63,12 +63,12 @@ dsh plugin --profile web remove @takboo/dsh-session-bin
 
 1. 使用 Harness 原生“归档会话”操作归档目标会话。
 2. 打开“会话回收站”，搜索或筛选已有归档；选择单项或多项取消归档。
-3. 永久删除时，先核对确认窗口中的对象、范围和阻止原因，再明确确认执行。
-4. 如出现部分失败或连接中断，查看逐项结果，检查操作状态后再决定是否继续。
+3. 永久删除时，核对确认窗口中的对象和阻止原因，再确认执行。设置中的“永久删除会话前进行确认”默认开启；关闭后，点击单项删除、删除所选或清空将直接开始永久删除。
+4. 批量操作期间查看进度和日志，完成后只保留统计及需要处理的项。如出现部分失败或连接中断，先检查操作状态，再决定是否继续。
 
 **“清空全部归档”包含点击时的全部归档，搜索和工作区筛选不会缩小其范围。** 批量删除固定开始时的对象，后来新增的归档不会加入。
 
-永久删除不可撤销，仅允许已归档、无活动且无未释放读写引用的冷会话；宿主仍加载的会话会被阻止。清除范围是目标会话日志及已声明的会话元数据、索引；共享附件、外部副本和独立 fork 会保留。插件不提供共享附件垃圾回收或安全擦除保证，也不支持自动定期清空、跨设备同步或多 Host 协调。可通过 Host 配置 `permanentDeletion: false` 关闭永久删除，配置说明见 [Host 生命周期](docs/host-lifecycle.md)。
+永久删除不可撤销，仅允许已归档、无活动且无未释放读写引用的冷会话；删除准备会释放由 API Session 激活且确认空闲的目标 Agent，再复核冷会话条件；活动任务、其他所有者的 Agent 和未释放的读写引用仍会阻止删除。清除范围是目标会话日志及已声明的会话元数据、索引；共享附件、外部副本和独立 fork 会保留。插件不提供共享附件垃圾回收或安全擦除保证，也不支持自动定期清空、跨设备同步或多 Host 协调。可通过 Host 配置 `permanentDeletion: false` 关闭永久删除，配置说明见 [Host 生命周期](docs/host-lifecycle.md)。
 
 ## 开发入门
 

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
 };