dsh-sessions-manager 3.7.3 → 3.7.5

package/README.en.md

@@ -91,6 +91,7 @@ DSH 0.1.5 upgrades the session log format to **v3**, and 0.1.7 upgrades it again
 - Migration is **one-way, with no downgrade read**: after opening sessions on a newer runtime, rolling the runtime back makes those sessions unreadable. Back up `~/.dsh/sessions` before a rollback.
 - Only **supported** old logs are migrated; unknown events or corrupted data are **refused without any repair**. Such sessions surface as `SessionFormatUnsupportedMigrationError` / `SessionFormatError` on read/move — the plugin cannot repair them and reports the error verbatim.
 - **Since 0.1.7 newly created sessions strictly require a v4 header**: from v3.7.2 this plugin re-samples the session header against the current backend's format during cross-workspace moves — sessions created in older formats (v3 and earlier) can be moved again, and the relocated copy lands directly on the current format (verified end-to-end against a real v3 log). Earlier plugin versions fail to move such sessions on 0.1.7.
+- **0.2.0 is still v4**: the current format version is **probed dynamically** from the backend's format catalog package (never hardcoded), so 0.1.7 and 0.2.0 share one code path.
 
 ## Screenshots
 
@@ -212,6 +213,12 @@ lib/client.js      pre-built client (ModuleLoader CJS handshake)
 - `0.1.3-alpha.1`: snapshot lists and chunked `SessionHandle` read flows are supported. Permanent purge and cross-workspace move are available through guarded path derivation + write-ownership probes (see the behavior notes below), and disable themselves whenever a safe path cannot be verified; other management capabilities are unaffected. The panel shows the effective capabilities.
 - `0.1.5-rc.1` / `0.1.5-rc.2` (both verified): the session log format is upgraded to **v3** and this plugin is adapted — it reads the **highest generation** (matching the runtime), tolerates v0/v2/v3 generations side by side, follows the new `SessionHandle.read()` shape (`{ eventState, events }`), moves sessions as **whole-directory moves** (reclaiming superseded-generation copies automatically), and queues moves for sessions DSH holds open (see "Moving an active session" above).
 - `0.1.7-rc.2` (verified): the session format is upgraded again to **v4** and the format catalog moves to its own package; this plugin is adapted — reads go through the official automatic migration, and cross-workspace moves re-sample the header against the backend's current format (sessions created on older formats can be moved again, and the relocated copy lands on the current format).
+- `0.2.0-rc.1` / `0.2.0-rc.2` (both verified):
+  - Still format **v4** (the version is probed from the backend's format catalog, never hardcoded).
+  - `ctx.sessions` is now a session **data-stream** service with no `open`: opening a session goes through the official `uiWorkspace.openSession` — the settings panel's "open session" action and subagent navigation are both adapted (issue #12).
+  - Install gate: 0.2.0 validates the `@deepseek-ai/dsh*` ranges in a plugin's `peerDependencies`; this plugin widened them to `>=0.1.0-rc.6`, which passes on both `0.1.7-rc.2` and `0.2.0-rc.2` (issue #13).
+  - `ctx.storageDomain` is the **domain data form** in 0.2.0: writes are schema-validated and durable before they resolve. This plugin only writes fields that exist in the official domain schema, verified end-to-end against a **real domain + real WorkspaceRegistry** (archive / restore / list / storage stats / cross-workspace move) with a read-back from the storage medium to prove the archive state really persisted.
+  - Active-session detection: since 0.1.7 the host exposes no "current session" accessor (all three historical probes come back empty), so the **client reports the open session id every 15 seconds** and the host trusts it only within a 45-second freshness window. It backs two guards: refusing to move the session you are looking at (409 / queued) and skipping it in auto-archive. A stopped heartbeat (panel closed, tab hidden, process gone) means "cannot prove it is active" — the move is allowed rather than locking the session forever.
 - Unverified future runtimes expose only capabilities the plugin can safely identify; method presence alone is not presented as behavioral compatibility.
 
 ### Behavior differences and degradations on the SessionHandle era (`0.1.3+`)

package/README.md

@@ -91,6 +91,7 @@ DSH 0.1.5 把会话日志格式升级到 **v3**，0.1.7 再升到 **v4**，均
 - 迁移**单向、不支持降级读取**：升级并打开过会话之后，把 runtime 回滚到旧版本会导致那些会话无法读取。回滚前请先备份 `~/.dsh/sessions`。
 - 官方只迁移**受支持的旧日志**；遇到未知事件或损坏数据会**拒绝迁移且不做任何修复**。这类会话在插件里会表现为读取/移动报 `SessionFormatUnsupportedMigrationError` / `SessionFormatError`——插件无法代修，只能如实报错（可先确认该会话是否确实异常，再决定保留或删除）。
 - **0.1.7 起新建会话严格要求 v4 头部**：本插件自 v3.7.2 起在跨工作区移动时自动按当前后端的格式重新采样会话头——旧格式（v3 及更早）会话可以正常移动，且移动后的副本直接落在当前格式（已用真实 v3 旧日志端到端实测）。更早的插件版本在 0.1.7 上移动旧格式会话会失败。
+- **0.2.0 仍是 v4**：当前格式版本由插件从后端的格式目录包**动态探测**（不写死版本号），所以 0.1.7 / 0.2.0 共用同一套处理。
 
 ## 截图
 
@@ -213,6 +214,12 @@ lib/client.js      预构建 client（ModuleLoader CJS handshake）
 - `0.1.5-rc.1` / `0.1.5-rc.2`（已实测）：会话日志格式升级到 **v3**，本插件已适配——按**最高代**读取（与官方一致）、v0/v2/v3 多代共存、跟随 `SessionHandle.read()` 的新返回结构
   （`{ eventState, events }`）、跨工作区移动按**整目录搬运**并自动回收被取代的旧代副本；被 DSH 打开着的会话改为**排队延迟移动**（见上文「移动活跃会话」）。
 - `0.1.7-rc.2`（已实测）：会话格式再升 **v4**，格式版本目录拆分到独立包；本插件已适配——读取走官方自动迁移，跨工作区移动自动按后端当前格式重采样会话头（旧格式会话可正常移动，落盘即当前格式）。
+- `0.2.0-rc.1` / `0.2.0-rc.2`（均已实测）：
+  - 会话格式仍为 **v4**（版本由后端格式目录包动态探测，不写死）。
+  - `ctx.sessions` 已退化为会话**数据流**服务（不再提供 `open`）：打开会话改走官方 `uiWorkspace.openSession`——设置面板与侧栏的「打开会话」、子代理导航均已适配（issue #12）。
+  - 安装门禁：0.2.0 会校验插件 `peerDependencies` 中的 `@deepseek-ai/dsh*` 版本范围，本插件已放宽为 `>=0.1.0-rc.6`，`0.1.7-rc.2` 与 `0.2.0-rc.2` 通过（issue #13）。
+  - 存储域（`ctx.storageDomain`）在 0.2.0 是**领域数据形式**：写入经 schema 校验并在返回前落盘。本插件只写官方域 schema 内的字段，已用**真实域 + 真实 WorkspaceRegistry** 端到端实测（归档 / 恢复 / 列表 / 存储统计 / 跨工作区移动），并回到磁盘介质核验归档状态真的持久化。
+  - 活跃会话判定：0.1.7 起 host 侧不再有「当前会话」访问器（三个历史探测全部落空），改由**客户端每 15 秒上报**当前会话 id、host 只在 45 秒新鲜期内采信；用于「移动正在看的会话」（409 / 排队）与「自动归档跳过当前会话」两条保护。心跳停止（面板关闭、标签页隐藏、进程退出）即视为无法证明活跃，放行移动而不是把会话永久锁死。
 - 未经验证的未来 Runtime 默认只开放能够识别的安全能力；插件不会用方法存在与否冒充行为兼容。
 
 ### 新版 Runtime（SessionHandle 世代，`0.1.3+`）的行为差异与降级说明

package/lib/client.js

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   apply: () => apply,
+  dsmActiveSessionId: () => dsmActiveSessionId,
   inject: () => inject
 });
 module.exports = __toCommonJS(index_exports);
@@ -329,7 +330,8 @@ var CSS = `
 .archv{--dsm-radius-tag:9px;--dsm-radius-ctl:9px;--dsm-radius-sheet:10px;--dsm-radius-card:12px;display:flex;flex-direction:column;gap:4px;max-width:800px;padding:8px 2px 28px}
 .archv-head{display:flex;align-items:center;gap:10px;margin:0 0 2px}
 .archv-title{font-size:16px;font-weight:650;color:var(--dsw-alias-label-primary);letter-spacing:-0.01em;margin:0}
-.archv-stamp{font-size:11px;font-weight:500;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-fill-secondary);border:1px solid var(--dsw-alias-border-l1);border-radius:999px;padding:2px 8px;white-space:nowrap;cursor:default}
+.archv-stamp{font-size:11px;font-weight:500;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-fill-secondary);border:1px solid var(--dsw-alias-border-l1);border-radius:999px;padding:2px 8px;white-space:nowrap;cursor:pointer;transition:color .15s ease,border-color .15s ease}
+.archv-stamp:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-border-l3)}
 .archv-count{font-size:11px;font-weight:600;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-fill-subtle);border:1px solid var(--dsw-alias-border-l2);border-radius:999px;padding:1px 8px;flex:none}
 .archv-sub{font-size:12px;line-height:1.55;color:var(--dsw-alias-label-tertiary);margin:0 0 12px;max-width:64ch}
 .archv-err{display:flex;align-items:center;justify-content:space-between;gap:10px;padding:9px 12px;border:1px solid color-mix(in srgb,var(--dsw-alias-state-error-primary) 40%,transparent);background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 8%,transparent);border-radius:var(--dsm-radius-sheet);color:var(--dsw-alias-state-error-primary);font-size:12px;margin-bottom:10px}
@@ -354,8 +356,11 @@ var CSS = `
 .sess-fbtn-on{background:var(--dsw-alias-interactive-bg-active);color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-border-l3)}
 .sess-tools{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:8px;margin:0 0 8px}
 .sess-tools-4{grid-template-columns:repeat(auto-fit,minmax(132px,1fr))}
-/* T4 \u8D77\u641C\u7D22\u884C\u6709 5 \u4E2A\u5B57\u6BB5\uFF08\u641C\u7D22/\u5DE5\u4F5C\u533A/\u6807\u7B7E/\u6392\u5E8F/\u5206\u7EC4\uFF09\uFF1A\u6536\u7A84\u4E0B\u9650\u4FDD\u8BC1 800px \u5185\u4E00\u884C\u6392\u6EE1\u3002 */
-.sess-tools-5{grid-template-columns:repeat(auto-fit,minmax(124px,1fr))}
+/* T4 \u8D77\u641C\u7D22\u884C\u6709 5 \u4E2A\u5B57\u6BB5\uFF08\u641C\u7D22/\u5DE5\u4F5C\u533A/\u6807\u7B7E/\u6392\u5E8F/\u5206\u7EC4\uFF09\uFF1A\u56FA\u5B9A 5 \u5217 + minmax(0,1fr)
+   \u4E00\u884C\u6392\u6EE1\u2014\u2014auto-fit(minmax(124px,\u2026)) \u5728\u9762\u677F\u5BBD\u5EA6\u4E0D\u8DB3 5\xD7124+gap \u65F6\u4F1A\u628A\u6700\u540E
+   \u4E00\u5217\u6324\u5230\u7B2C\u4E8C\u884C\uFF08\u5206\u7EC4\u5B64\u884C\uFF09\u3002minmax(0,1fr) \u5141\u8BB8\u5217\u5747\u5206\u6536\u7F29\uFF0Cselect/input
+   \u5404\u81EA\u622A\u65AD\uFF1B<640px \u4ECD\u7531\u4E0B\u65B9\u65AD\u70B9\u6536\u6210\u5355\u5217\u3002 */
+.sess-tools-5{grid-template-columns:repeat(5,minmax(0,1fr))}
 .dsm-kids{display:flex;flex-direction:column;gap:6px;margin:10px 0 2px;margin-left:43px;padding-left:10px;border-left:2px solid var(--dsw-alias-border-l3)}
 .dsm-kid .dsm-kids{margin-left:8px;margin-top:6px}
 .dsm-kids-toggle{appearance:none;min-height:22px;padding:0 9px;border:1px solid color-mix(in srgb,var(--dsw-alias-state-business-primary) 40%,transparent);background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 10%,transparent);color:var(--dsw-alias-state-business-primary);border-radius:var(--dsm-radius-tag);font:inherit;font-size:11px;font-weight:500;cursor:pointer;flex:none;white-space:nowrap}
@@ -614,6 +619,49 @@ async function dsmOpenSessionById(childId, directParentId) {
   }
   return "failed";
 }
+var DSM_CLIENT_ID = (() => {
+  try {
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
+  } catch (e) {
+  }
+  return `c${Date.now().toString(36)}${Math.random().toString(36).slice(2, 10)}`;
+})();
+function dsmActiveSessionId() {
+  try {
+    if (!dsmClientCtx || typeof dsmClientCtx.get !== "function") return null;
+    const ui = dsmClientCtx.get("uiWorkspace");
+    if (ui) {
+      const snap = ui.selection && typeof ui.selection.getSnapshot === "function" ? ui.selection.getSnapshot() : null;
+      if (snap && snap.sessionId != null) return String(snap.sessionId);
+      const ref = ui.mainReference;
+      if (ref && ref.sessionId != null) return String(ref.sessionId);
+    }
+    const native = dsmClientCtx.get("sessions");
+    if (native && native.list && typeof native.list.getSnapshot === "function") {
+      const snap = native.list.getSnapshot();
+      if (snap && snap.current != null) return String(snap.current);
+    }
+  } catch (e) {
+  }
+  return null;
+}
+var DSM_ACTIVE_HEARTBEAT_MS = 15e3;
+var DSM_ACTIVE_MIN_REPORT_MS = 3e4;
+var dsmLastActiveReport = { id: null, at: 0 };
+async function reportActiveSession(force) {
+  const id = dsmActiveSessionId();
+  const now = Date.now();
+  if (!force && id === dsmLastActiveReport.id && now - dsmLastActiveReport.at < DSM_ACTIVE_MIN_REPORT_MS) return;
+  dsmLastActiveReport = { id, at: now };
+  try {
+    await postJSON("/archived-sessions/active-session", { clientId: DSM_CLIENT_ID, sessionId: id });
+  } catch (e) {
+  }
+}
+async function postActiveAware(path, body) {
+  await reportActiveSession(true).catch(() => null);
+  return postJSON(path, body);
+}
 var NAV_CSS = `
 [data-dsh-nav-sessions] > svg:first-child { display: none; }
 [data-dsh-nav-sessions]::before {
@@ -1018,6 +1066,33 @@ function SessionPanel({ workspacesSvc }) {
     setToast({ msg, kind: kind === "err" ? "err" : "ok" });
     timer.current = setTimeout(() => setToast(null), toastDurationFor(msg, kind));
   };
+  const copyBuildStamp = async () => {
+    const full = String(capabilities && capabilities.buildStamp || "");
+    if (!full) return;
+    try {
+      if (navigator.clipboard && navigator.clipboard.writeText) {
+        await navigator.clipboard.writeText(full);
+        showToast("\u5DF2\u590D\u5236\u5B8C\u6574\u7248\u672C\u53F7 " + full, "ok");
+        return;
+      }
+      throw new Error("clipboard unavailable");
+    } catch (e) {
+      try {
+        const ta = document.createElement("textarea");
+        ta.value = full;
+        ta.style.position = "fixed";
+        ta.style.opacity = "0";
+        document.body.appendChild(ta);
+        ta.select();
+        const ok = document.execCommand("copy");
+        document.body.removeChild(ta);
+        if (!ok) throw new Error("execCommand failed");
+        showToast("\u5DF2\u590D\u5236\u5B8C\u6574\u7248\u672C\u53F7 " + full, "ok");
+      } catch (e2) {
+        showToast("\u590D\u5236\u5931\u8D25\uFF0C\u5B8C\u6574\u7248\u672C\u53F7\uFF1A" + full, "err");
+      }
+    }
+  };
   const refresh = () => {
     setError(null);
     Promise.all([
@@ -1492,7 +1567,7 @@ function SessionPanel({ workspacesSvc }) {
     }
     setBusy(it.sessionId);
     setError(null);
-    postJSON("/archived-sessions/move", { sessionId: it.sessionId, targetPath }).then((r) => {
+    postActiveAware("/archived-sessions/move", { sessionId: it.sessionId, targetPath }).then((r) => {
       setBusy(null);
       setOpenMove(null);
       setMoveMode("existing");
@@ -1549,7 +1624,7 @@ function SessionPanel({ workspacesSvc }) {
     setBusy("__batch__");
     setError(null);
     setRetry(null);
-    postJSON("/archived-sessions/move-many", { sessionIds: ids, targetPath }).then((r) => {
+    postActiveAware("/archived-sessions/move-many", { sessionIds: ids, targetPath }).then((r) => {
       setBusy(null);
       setBatchMoveOpen(false);
       setMoveMode("existing");
@@ -1717,8 +1792,20 @@ function SessionPanel({ workspacesSvc }) {
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)("style", { children: CSS }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "archv-head", children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h2", { className: "archv-title", children: "\u4F1A\u8BDD\u7BA1\u7406" }),
-      capabilities && capabilities.buildStamp ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "archv-stamp", title: capabilities.buildStamp, onClick: () => navigator.clipboard && navigator.clipboard.writeText(capabilities.buildStamp).catch(() => {
-      }), children: capabilities.buildStamp }) : null,
+      capabilities && capabilities.buildStamp ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+        "span",
+        {
+          className: "archv-stamp",
+          role: "button",
+          "aria-label": "\u590D\u5236\u5B8C\u6574\u7248\u672C\u53F7",
+          title: capabilities.buildStamp,
+          onClick: copyBuildStamp,
+          children: [
+            "v",
+            String(capabilities.buildStamp).split("+")[0]
+          ]
+        }
+      ) : null,
       sessions !== null && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "archv-count", "aria-label": `${sessions.length} \u4E2A\u4F1A\u8BDD`, children: sessions.length })
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "archv-sub", children: "\u7EDF\u4E00\u7BA1\u7406\u5168\u90E8\u4F1A\u8BDD\uFF1A\u5F52\u6863 / \u6062\u590D / \u79FB\u52A8\u5230\u5176\u4ED6\u5DE5\u4F5C\u533A / \u4F1A\u8BDD\u8BE6\u60C5 / \u6279\u91CF\u64CD\u4F5C\uFF0C\u5220\u9664\u4F1A\u5148\u8FDB\u5165\u56DE\u6536\u7AD9\uFF0C\u53EF\u5728\u56DE\u6536\u7AD9\u5185\u6062\u590D\u6216\u5F7B\u5E95\u6E05\u7406\u3002" }),
@@ -2064,8 +2151,8 @@ function SessionPanel({ workspacesSvc }) {
           /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "sess-field", children: [
             /* @__PURE__ */ (0, import_jsx_runtime.jsx)("label", { htmlFor: "dsm-group", children: "\u5206\u7EC4" }),
             /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("select", { id: "dsm-group", value: groupByLineage ? "lineage" : "flat", onChange: (e) => setGroupByLineage(e.target.value === "lineage"), title: "\u8840\u7F18\u5206\u7EC4\uFF1A\u5B50\u4EE3\u7406\u6298\u53E0\u3001\u5206\u652F\u805A\u62E2\u6210\u7EC4\uFF1B\u5E73\u94FA\uFF1A\u4E0E DSH \u539F\u751F\u4E00\u81F4\uFF0C\u5168\u90E8\u5E76\u5217", children: [
-              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("option", { value: "lineage", children: "\u8840\u7F18\uFF08\u6298\u53E0\u5206\u7EC4\uFF09" }),
-              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("option", { value: "flat", children: "\u5E73\u94FA\uFF08\u5168\u90E8\u5E76\u5217\uFF09" })
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("option", { value: "lineage", children: "\u8840\u7F18\uFF08\u6298\u53E0\uFF09" }),
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("option", { value: "flat", children: "\u5E73\u94FA\uFF08\u5E76\u5217\uFF09" })
             ] })
           ] })
         ] }),
@@ -3069,7 +3156,7 @@ function installSidebarSessionMenuAug() {
           e.preventDefault();
           closeSub();
           closeMenu();
-          postJSON("/archived-sessions/move", { sessionId: info.id, targetPath: w.path }).then((r2) => {
+          postActiveAware("/archived-sessions/move", { sessionId: info.id, targetPath: w.path }).then((r2) => {
             const label = w.title || pathName(w.path) || "\u76EE\u6807\u5DE5\u4F5C\u533A";
             if (r2 && r2.queued) {
               toast(r2.notes && r2.notes.length ? r2.notes.join(" ") : "\u4F1A\u8BDD\u6B63\u88AB DSH \u6253\u5F00\uFF0C\u5DF2\u6392\u961F\u5F85\u79FB\u52A8\uFF1B\u91CD\u542F DSH \u540E\u4F1A\u81EA\u52A8\u5B8C\u6210\uFF08\u8BF7\u5148\u522B\u6253\u5F00\u5B83\uFF09\u3002");
@@ -3768,7 +3855,7 @@ function installSidebarWorkspaceDrag() {
     clearVisuals();
     row.classList.add("dsm-drag-busy");
     try {
-      const result = await postJSON("/archived-sessions/move", { sessionId: item.sessionId, targetPath: target.path });
+      const result = await postActiveAware("/archived-sessions/move", { sessionId: item.sessionId, targetPath: target.path });
       if (result && result.queued) {
         await dsmLoadTrashIds();
         toast(result.notes && result.notes.length ? result.notes.join(" ") : "\u4F1A\u8BDD\u6B63\u88AB DSH \u6253\u5F00\uFF0C\u5DF2\u6392\u961F\u5F85\u79FB\u52A8\uFF1B\u91CD\u542F DSH \u540E\u4F1A\u81EA\u52A8\u5B8C\u6210\uFF08\u8BF7\u5148\u522B\u6253\u5F00\u5B83\uFF09\u3002");
@@ -3824,6 +3911,23 @@ function installSidebarWorkspaceDrag() {
 function apply(ctx) {
   dsmClientCtx = ctx;
   dsmLoadCapabilities();
+  const beat = () => {
+    if (typeof document !== "undefined" && document.hidden) return;
+    reportActiveSession(false).catch(() => {
+    });
+  };
+  beat();
+  const beatTimer = setInterval(beat, DSM_ACTIVE_HEARTBEAT_MS);
+  const beatAc = typeof AbortController !== "undefined" ? new AbortController() : null;
+  if (beatAc && typeof document !== "undefined" && document.addEventListener) {
+    document.addEventListener("visibilitychange", () => {
+      if (!document.hidden) beat();
+    }, { signal: beatAc.signal });
+  }
+  ctx.effect(() => () => {
+    clearInterval(beatTimer);
+    if (beatAc) beatAc.abort();
+  });
   installSettingsNavIcons(ctx);
   installSidebarSessionMenuAug();
   const disposeSidebarDots = installSidebarStatusDots();