dsh-sessions-manager 3.4.2 → 3.5.1

package/README.en.md

@@ -12,7 +12,7 @@
 
 > DSH session manager: archive, move, restore, and inspect sessions from **Settings → 会话管理**; mark unread, move, and delete sessions directly from the **main sidebar**. Deleted sessions go to the recycle bin first and can be restored or permanently purged.
 
-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.
+A persistent DSH plugin (host + browser halves) covering both the **settings panel** and the **main sidebar**, so frequent session actions don't require opening Settings. It understands both legacy header lists/`readFrom` and the new snapshot/`SessionHandle` API, enabling actions according to the current Runtime's verified capabilities. Unverified purge or migration paths are disabled in both UI and Host to prevent false success.
 
 ## Features
 
@@ -43,7 +43,7 @@ A small dot is rendered to the left of each session row. Its color is driven by
 | Color | State | Description |
 |---|---|---|
 | 🔵 Blue | Manually marked unread | Toggle via the ⋯ menu or by clicking the dot; auto-cleared when the session is opened |
-| 🟡 Yellow | Working | The session is currently running (`running`) |
+| 🟡 Yellow | Working | The session is currently running (`ongoing`, with legacy `running` compatibility) |
 | 🟠 Amber | Awaiting feedback | The session has a follow-up question and is waiting for your input or confirmation (`warning`) |
 | 🟢 Green | Completed but unread | The session is done (`done`) but you haven't reopened it yet; disappears after you view it |
 | 🔴 Red | Error / needs attention | The session hit an error (`error`) |
@@ -149,6 +149,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 +158,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

@@ -12,7 +12,7 @@
 
 > DSH 会话管理器：在**设置 → 会话管理**里统一归档、移动、恢复、查看详情；在**主页侧边栏**直接标记未读、移动、删除会话。删除先进入回收站，可恢复或彻底清理。
 
-一个 DSH 持久化插件（host + browser 双半）。v3.0.0 起同时覆盖「设置面板」与「主页侧边栏」两个入口，无需打开设置即可完成高频会话操作。
+一个 DSH 持久化插件（host + browser 双半），同时覆盖「设置面板」与「主页侧边栏」两个入口，无需打开设置即可完成高频会话操作。插件同时识别旧式 header 列表/`readFrom` 与新版 snapshot/`SessionHandle`，并按当前 Runtime 的实际能力启用安全操作；尚未验证的删除或迁移路径会在界面与 Host 端同步禁用，避免假成功。
 
 ## 功能
 
@@ -43,7 +43,7 @@
 | 颜色 | 状态 | 说明 |
 |---|---|---|
 | 🔵 蓝 | 手动标记未读 | 通过 ⋯ 菜单或点击圆点手动标记；进入会话后自动清除 |
-| 🟡 黄 | 工作中 | 会话正在运行（`running`） |
+| 🟡 黄 | 工作中 | 会话正在运行（新版 `ongoing`，兼容旧版 `running`） |
 | 🟠 琥珀 | 等待反馈 | 会话有追问，需要用户输入或确认（`warning`） |
 | 🟢 绿 | 完成后未读 | 会话已完成（`done`）但你还没重新打开看过；看过一次后不再显示 |
 | 🔴 红 | 出错 / 需关注 | 会话遇到错误（`error`） |
@@ -149,6 +149,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 +158,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

@@ -40,6 +40,7 @@ var import_react = __toESM(require("react"), 1);
 function dotStateFor({ manualUnread = false, dataState = "", isActive = false } = {}) {
   if (manualUnread) return "manual";
   switch (dataState) {
+    case "ongoing":
     case "running":
       return "running";
     case "warning":
@@ -52,6 +53,10 @@ function dotStateFor({ manualUnread = false, dataState = "", isActive = false }
       return null;
   }
 }
+function authoritativeTitleForFirstPaint({ firstPaint = false, rendered = "", authoritative = "" } = {}) {
+  if (!firstPaint || !authoritative || rendered === authoritative) return null;
+  return authoritative;
+}
 function canDropOnWorkspace(item, target) {
   if (!item || !target) return false;
   if (item.workspacePath && target.path === item.workspacePath) return false;
@@ -278,6 +283,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 +332,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 +436,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 +522,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 +625,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 +670,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 +759,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 +1217,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)) })
     ] }),
@@ -1258,7 +1287,7 @@ var SIDEBAR_AUG_CSS = `
 .dsm-sub-cur{font-size:11px;color:var(--dsw-alias-state-business-primary);flex:none;margin-left:8px}
 .dsm-dot{position:absolute;left:6px;top:50%;transform:translateY(-50%);width:8px;height:8px;border-radius:50%;box-sizing:border-box;cursor:pointer;pointer-events:auto;z-index:1}
 .dsm-dot-unread-manual{background:var(--dsw-alias-state-business-primary)}
-.dsm-dot-waiting{background:var(--dsw-alias-state-warning-primary)}
+.dsm-dot-waiting{background:var(--dsw-alias-state-warn-primary,#F59E0B)}
 .dsm-dot-unread{background:var(--dsw-alias-state-success-primary)}
 .dsm-drag-source{opacity:.48}
 .dsm-drop-target{position:relative;background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 10%,transparent)!important;outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:-2px;border-radius:8px}
@@ -1319,6 +1348,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 +1589,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";
@@ -1635,7 +1680,7 @@ function installSidebarStatusDots() {
     // 蓝 手动标记未读
     running: "#EAB308",
     // 黄 工作中 (DSH running)
-    feedback: "var(--dsw-alias-state-warning-primary)",
+    feedback: "var(--dsw-alias-state-warn-primary, #F59E0B)",
     // 琥珀 需用户反馈 (DSH warning)
     done: "var(--dsw-alias-state-success-primary)",
     // 绿 完成后未读 (DSH done)
@@ -1643,6 +1688,7 @@ function installSidebarStatusDots() {
     // 红 出错/需关注 (DSH error)
   };
   const manualUnread = dsmLoadManual();
+  const titleInitializedRows = /* @__PURE__ */ new WeakSet();
   const paint = () => {
     const activeId = activeRowId();
     if (activeId !== curActive && activeId && manualUnread.has(activeId)) {
@@ -1663,12 +1709,20 @@ function installSidebarStatusDots() {
       }
       if (row.style.display === "none") row.style.display = "";
       const authoritativeTitle = dsmAuthoritativeTitles.get(id);
-      if (authoritativeTitle) {
+      if (!titleInitializedRows.has(row)) {
         const node = rowNode(row) || {};
         const expected = new Set([node.title, node.displayTitle, node.name].filter((value) => typeof value === "string"));
         const spans = [...row.children].filter((el) => el.tagName === "SPAN" && !el.querySelector("[data-state]") && (el.textContent || "").trim());
         const titleEl = spans.find((el) => expected.has((el.textContent || "").trim())) || spans[0];
-        if (titleEl && titleEl.textContent !== authoritativeTitle) titleEl.textContent = authoritativeTitle;
+        if (titleEl) {
+          const correction = authoritativeTitleForFirstPaint({
+            firstPaint: true,
+            rendered: titleEl.textContent || "",
+            authoritative: authoritativeTitle || ""
+          });
+          if (correction) titleEl.textContent = correction;
+          titleInitializedRows.add(row);
+        }
       }
       const sd = row.querySelector("[data-state]");
       if (sd) sd.style.display = "none";
@@ -1785,6 +1839,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 +1920,7 @@ function installSidebarWorkspaceDrag() {
   }
 }
 function apply(ctx) {
+  dsmLoadCapabilities();
   installSettingsNavIcons(ctx);
   installSidebarSessionMenuAug();
   installSidebarStatusDots();