dsh-sessions-manager 3.4.2 → 3.5.0

package/README.en.md

@@ -14,6 +14,8 @@
 
 A persistent DSH plugin (host + browser halves). Starting with v3.0.0, it covers both the **settings panel** and the **main sidebar**, so frequent session actions don't require opening Settings.
 
+v3.5.0 adds a two-generation DSH persistence adapter. It understands both legacy header lists/`readFrom` and the new snapshot/`SessionHandle` API, and reports action-level capabilities to the UI. When a runtime has no verified safe purge or migration path, the corresponding controls explain why they are disabled and the Host rejects direct calls, preventing false success messages.
+
 ## Features
 
 ### Settings panel: Session Manager
@@ -149,6 +151,7 @@ lib/client.js      pre-built client (ModuleLoader CJS handshake)
 | POST | `/archived-sessions/storage` | Storage-usage aggregation (per-workspace ranking + largest sessions) `{ topN }` |
 | POST | `/archived-sessions/auto-archive/settings` | Read or update the auto-archive policy `{ inactiveDays, skipStarred }`; reading lazily triggers the daily check |
 | POST | `/archived-sessions/auto-archive/run` | Run a one-off auto-archive check immediately (ignores the daily throttle) |
+| POST | `/archived-sessions/capabilities` | Report the persistence generation and per-action read/archive/trash/purge/cross-workspace-move capabilities |
 
 > Deleting a session moves it to the recycle bin by default; only "permanently delete" inside the recycle bin physically removes the log. Permanently deleted sessions are hidden forever on the client side so they don't reappear in the sidebar or "ungrouped" due to DSH runtime caching.
 
@@ -157,6 +160,9 @@ lib/client.js      pre-built client (ModuleLoader CJS handshake)
 - **Supported platforms**: cross-platform (macOS / Windows / Linux) — wherever DSH runs the plugin runs; the host half is Node (about `^22.19` or `>=24`) and the client is React, with no OS-specific APIs.
 - Works in both DSH Desktop and DSH web (same host + client halves).
 - Peer dependencies are listed in `package.json`; `react` and `@deepseek-ai/*` are provided by the DSH runtime.
+- `0.1.2-rc.1`: the existing read, archive, recycle-bin, permanent-purge, and cross-workspace move paths remain available.
+- `0.1.3-alpha.1`: snapshot lists and read-only `SessionHandle` flows are supported. Permanent purge and cross-workspace move are disabled when no verified safe path is available; other management functions continue to work. The panel shows the effective capabilities.
+- Unverified future runtimes expose only capabilities the plugin can safely identify; method presence alone is not presented as behavioral compatibility.
 
 ## License
 

package/README.md

@@ -14,6 +14,8 @@
 
 一个 DSH 持久化插件（host + browser 双半）。v3.0.0 起同时覆盖「设置面板」与「主页侧边栏」两个入口，无需打开设置即可完成高频会话操作。
 
+v3.5.0 新增 DSH 双代持久化适配：同时识别旧式 header 列表/`readFrom` 与新版 snapshot/`SessionHandle`，并向界面报告每项操作的实际能力。当前 Runtime 没有经过验证的安全删除或迁移路径时，相关按钮会显示禁用原因，Host 也会拒绝调用，避免出现“提示成功但日志没有删除/移动”的假成功。
+
 ## 功能
 
 ### 设置面板：会话管理
@@ -149,6 +151,7 @@ lib/client.js      预构建 client（ModuleLoader CJS handshake）
 | POST | `/archived-sessions/storage` | 存储占用聚合（按工作区排行 + 最大的会话）`{ topN }` |
 | POST | `/archived-sessions/auto-archive/settings` | 读取或更新自动归档策略 `{ inactiveDays, skipStarred }`；读取时惰性触发每日检查 |
 | POST | `/archived-sessions/auto-archive/run` | 立即执行一次自动归档检查（忽略每日节流） |
+| POST | `/archived-sessions/capabilities` | 返回当前持久化代际及读取、归档、回收站、永久删除、跨工作区移动能力 |
 
 > 删除会话默认进入回收站，只有回收站内的「彻底删除」才会物理移除日志。被彻底删除的会话由前端永久隐藏，避免 DSH 运行时缓存使其重新出现在侧栏或「未分组」中。
 
@@ -157,6 +160,9 @@ lib/client.js      预构建 client（ModuleLoader CJS handshake）
 - **适配系统**：跨平台（macOS / Windows / Linux）——只要 DSH 能在该系统运行即可；本插件 host 基于 Node（约 `^22.19` 或 `>=24`）、浏览器端为 React，不依赖特定操作系统 API。
 - DSH Desktop / web 均可（同一套 host + client）。
 - peerDependencies 见 `package.json`；`react`、`@deepseek-ai/*` 由 DSH 运行时提供。
+- `0.1.2-rc.1`：现有读取、归档、回收站、永久删除和跨工作区移动能力保持可用。
+- `0.1.3-alpha.1`：支持 snapshot 列表和 `SessionHandle` 只读流程；永久删除与跨工作区移动在缺少已验证安全路径时自动禁用，其余管理能力继续工作。能力以面板实际提示为准。
+- 未经验证的未来 Runtime 默认只开放能够识别的安全能力；插件不会用方法存在与否冒充行为兼容。
 
 ## License
 

package/lib/client.js

@@ -278,6 +278,7 @@ function installSettingsNavIcons(ctx) {
 function SessionPanel({ workspacesSvc }) {
   const [sessions, setSessions] = (0, import_react.useState)(null);
   const [workspaces, setWorkspaces] = (0, import_react.useState)([]);
+  const [capabilities, setCapabilities] = (0, import_react.useState)(null);
   const initialPrefs = (0, import_react.useRef)(loadPanelPrefs()).current;
   const [filter, setFilter] = (0, import_react.useState)(() => ["all", "active", "archived", "starred", "trash"].includes(initialPrefs.filter) ? initialPrefs.filter : "all");
   const [query, setQuery] = (0, import_react.useState)("");
@@ -326,12 +327,14 @@ function SessionPanel({ workspacesSvc }) {
     setError(null);
     Promise.all([
       postJSON("/archived-sessions/sessions", {}),
-      postJSON("/archived-sessions/workspaces", {})
-    ]).then(([s, works]) => {
+      postJSON("/archived-sessions/workspaces", {}),
+      postJSON("/archived-sessions/capabilities", {})
+    ]).then(([s, works, caps]) => {
       const purged = dsmLoadPurged();
       const visible = (s.items || []).filter((x) => !purged.has(String(x.sessionId)));
       setSessions(visible);
       setWorkspaces(works.items || []);
+      setCapabilities(caps || null);
       setSelected({});
       setDelTarget(null);
       setConfirmBatch(false);
@@ -428,6 +431,9 @@ function SessionPanel({ workspacesSvc }) {
     const w = workspaces.find((x) => x.workspaceId === id);
     return w ? w.path : "";
   };
+  const actionCapability = (name) => capabilities && capabilities.actions && capabilities.actions[name] || { available: false, reason: "\u6B63\u5728\u68C0\u67E5\u5F53\u524D DSH \u7684\u517C\u5BB9\u80FD\u529B\u2026" };
+  const canPurge = actionCapability("purge");
+  const canMove = actionCapability("move");
   const archivedList = sessions ? sessions.filter((x) => x.archived) : [];
   const activeList = sessions ? sessions.filter((x) => !x.archived) : [];
   const starredList = starredOf(sessions);
@@ -511,7 +517,9 @@ function SessionPanel({ workspacesSvc }) {
     postJSON("/archived-sessions/trash/verify", {}).then((r) => {
       setTrashBusy(null);
       setTrashCheck(r);
-      showToast(r.missing ? `\u53D1\u73B0 ${r.missing} \u6761\u65E5\u5FD7\u7F3A\u5931` : "\u56DE\u6536\u7AD9\u6821\u9A8C\u901A\u8FC7");
+      if (r.missing) showToast(`\u53D1\u73B0 ${r.missing} \u6761\u65E5\u5FD7\u7F3A\u5931`);
+      else if (r.unverified) showToast(`${r.unverified} \u6761\u65E5\u5FD7\u4F4D\u7F6E\u7531\u5F53\u524D Runtime \u7BA1\u7406\uFF0C\u65E0\u6CD5\u76F4\u63A5\u6838\u9A8C`);
+      else showToast("\u56DE\u6536\u7AD9\u6821\u9A8C\u901A\u8FC7");
     }).catch((e) => {
       setTrashBusy(null);
       setError(String(e && e.message || e));
@@ -612,6 +620,10 @@ function SessionPanel({ workspacesSvc }) {
     });
   };
   const doMove = (it) => {
+    if (!canMove.available) {
+      setError(canMove.reason || "\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301\u8DE8\u5DE5\u4F5C\u533A\u79FB\u52A8");
+      return;
+    }
     const targetPath = moveMode === "new" ? newPath.trim() : wsPath(targetWs);
     if (!targetPath) {
       setError("\u8BF7\u9009\u62E9\u5DF2\u6709\u5DE5\u4F5C\u533A\u6216\u8F93\u5165\u65B0\u7684\u76EE\u6807\u76EE\u5F55\u8DEF\u5F84");
@@ -653,6 +665,10 @@ function SessionPanel({ workspacesSvc }) {
     });
   };
   const openMoveFor = (it) => {
+    if (!canMove.available) {
+      setError(canMove.reason || "\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301\u8DE8\u5DE5\u4F5C\u533A\u79FB\u52A8");
+      return;
+    }
     if (openMove === it.sessionId) {
       setOpenMove(null);
       return;
@@ -738,17 +754,22 @@ function SessionPanel({ workspacesSvc }) {
           children: "\u22EF"
         }
       ),
-      openMenu === it.sessionId && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "more-menu", role: "menu", children: items.map(([id, label]) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-        "button",
-        {
-          type: "button",
-          role: "menuitem",
-          className: "more-item" + (id === "delete" ? " more-item-danger" : ""),
-          onClick: () => runMenu(id, it),
-          children: label
-        },
-        id
-      )) })
+      openMenu === it.sessionId && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "more-menu", role: "menu", children: items.map(([id, label]) => {
+        const blocked = id === "move" && !canMove.available;
+        return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          "button",
+          {
+            type: "button",
+            role: "menuitem",
+            className: "more-item" + (id === "delete" ? " more-item-danger" : ""),
+            disabled: blocked,
+            title: blocked ? canMove.reason : void 0,
+            onClick: () => runMenu(id, it),
+            children: label
+          },
+          id
+        );
+      }) })
     ] });
   };
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "archv", role: "region", "aria-label": "\u4F1A\u8BDD\u7BA1\u7406", children: [
@@ -1191,22 +1212,25 @@ function SessionPanel({ workspacesSvc }) {
         ] }),
         /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "sess-field", children: [
           /* @__PURE__ */ (0, import_jsx_runtime.jsx)("label", { children: "\u6C38\u4E45\u6E05\u7406" }),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", className: "archv-btn archv-del", disabled: trashBusy !== null || !trash.length, onClick: () => setPurgeTarget("__all"), children: "\u6E05\u7A7A\u56DE\u6536\u7AD9" })
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", className: "archv-btn archv-del", disabled: trashBusy !== null || !trash.length || !canPurge.available, title: !canPurge.available ? canPurge.reason : void 0, onClick: () => setPurgeTarget("__all"), children: "\u6E05\u7A7A\u56DE\u6536\u7AD9" })
         ] })
       ] }),
+      !canPurge.available && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "archv-empty", role: "status", children: canPurge.reason }),
       trashCheck && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: trashCheck.missing ? "archv-err" : "archv-empty", role: "status", children: [
         "\u6821\u9A8C\u5B8C\u6210\uFF1A",
         trashCheck.healthy,
         " \u6761\u6B63\u5E38\uFF0C",
         trashCheck.missing,
-        " \u6761\u65E5\u5FD7\u7F3A\u5931\u3002"
+        " \u6761\u65E5\u5FD7\u7F3A\u5931\uFF0C",
+        trashCheck.unverified || 0,
+        " \u6761\u65E0\u6CD5\u76F4\u63A5\u6838\u9A8C\u3002"
       ] }),
       trash.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "dsm-trash-empty", children: "\u56DE\u6536\u7AD9\u4E3A\u7A7A\u3002\u5220\u9664\u7684\u4F1A\u8BDD\u4F1A\u5148\u8FDB\u5165\u8FD9\u91CC\uFF0C\u53EF\u6062\u590D\u6216\u5F7B\u5E95\u5220\u9664\u3002" }) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "dsm-trash-list", children: trash.map((t) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dsm-trash-row", children: [
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "dsm-trash-name", title: t.sessionId, children: t.title || t.sessionId }),
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "dsm-trash-date", children: fmtDate(t.deletedAt) }),
         /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { className: "dsm-trash-actions", children: [
           /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", className: "archv-btn", disabled: trashBusy !== null, onClick: () => restoreTrash(t.sessionId), children: "\u6062\u590D" }),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", className: "archv-btn archv-del", disabled: trashBusy !== null, onClick: () => setPurgeTarget(t.sessionId), children: "\u5F7B\u5E95\u5220\u9664" })
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", className: "archv-btn archv-del", disabled: trashBusy !== null || !canPurge.available, title: !canPurge.available ? canPurge.reason : void 0, onClick: () => setPurgeTarget(t.sessionId), children: "\u5F7B\u5E95\u5220\u9664" })
         ] })
       ] }, t.sessionId)) })
     ] }),
@@ -1319,6 +1343,17 @@ var dsmTrashIds = null;
 var dsmServerPurgedIds = /* @__PURE__ */ new Set();
 var dsmAuthoritativeTitles = /* @__PURE__ */ new Map();
 var dsmTrashTick = 0;
+var dsmCapabilities = null;
+async function dsmLoadCapabilities() {
+  try {
+    dsmCapabilities = await postJSON("/archived-sessions/capabilities", {});
+  } catch (e) {
+  }
+  return dsmCapabilities;
+}
+function dsmActionCapability(name) {
+  return dsmCapabilities && dsmCapabilities.actions && dsmCapabilities.actions[name];
+}
 async function dsmLoadTrashIds() {
   try {
     const r = await postJSON("/archived-sessions/sidebar-state", {});
@@ -1549,6 +1584,11 @@ function installSidebarSessionMenuAug() {
     const move = mk("\u79FB\u52A8\u4F1A\u8BDD", ICON_MOVE, false);
     const del = mk("\u5220\u9664\u4F1A\u8BDD", ICON_DEL, true);
     const mark = mk(dsmLoadManual().has(info.id) ? "\u6807\u8BB0\u5DF2\u8BFB" : "\u6807\u8BB0\u672A\u8BFB", ICON_UNREAD, false);
+    const moveCapability = dsmActionCapability("move");
+    if (!moveCapability || !moveCapability.available) {
+      move.btn.disabled = true;
+      move.btn.title = moveCapability && moveCapability.reason || "\u6B63\u5728\u68C0\u67E5\u5F53\u524D\u7248\u672C\u7684\u79FB\u52A8\u80FD\u529B";
+    }
     if (mark.btn.firstChild) mark.btn.firstChild.style.color = "var(--dsw-alias-state-business-primary)";
     const chev = document.createElement("span");
     chev.style.cssText = "margin-left:auto;flex:none;color:var(--dsw-alias-label-tertiary);font-size:14px;line-height:1";
@@ -1785,6 +1825,8 @@ function installSidebarWorkspaceDrag() {
     maybeRefresh();
   }, true);
   document.addEventListener("dragstart", (event) => {
+    const moveCapability = dsmActionCapability("move");
+    if (!moveCapability || !moveCapability.available) return;
     const row = eventRow(event);
     const item = row && sessionForRow(row);
     if (!item || moving) return;
@@ -1864,6 +1906,7 @@ function installSidebarWorkspaceDrag() {
   }
 }
 function apply(ctx) {
+  dsmLoadCapabilities();
   installSettingsNavIcons(ctx);
   installSidebarSessionMenuAug();
   installSidebarStatusDots();