@omdp/dsh-archived-sessions 0.3.0 → 0.3.1

package/README.md

@@ -65,6 +65,7 @@ pnpm add @omdp/dsh-archived-sessions -w
 
 ### 变更记录
 
+- **0.3.1**（2026-09-10）：**修复 0.3.0 的发布事故**——0.3.0 的 tarball 里没有 `lib/`（仓库 `.gitignore` 的 `**/lib/` 规则把源码吞了，npm 只打包到 4 个文件），安装后插件加载失败会拖垮 DSH；0.3.1 补回 `lib/index.js` + `lib/client.js`（发布前已核对 tarball 内容）。
 - **0.3.0**（2026-09-10）：fork 自 0.2.0；适配 DSH 0.1.5-rc.1（list 快照形状 + 路径自解析）；按树删除子会话；孤儿清理；删除路径安全校验。
 
 ---
@@ -126,6 +127,7 @@ pnpm add @omdp/dsh-archived-sessions -w
 
 ### Changelog
 
+- **0.3.1** (2026-09-10): **fixes a 0.3.0 release accident** — the 0.3.0 tarball contained no `lib/` (the repo's `**/lib/` gitignore rule swallowed the source, so npm packed only 4 files); installing it broke the plugin load and could take DSH down. 0.3.1 restores `lib/index.js` + `lib/client.js` (tarball contents verified before publishing).
 - **0.3.0** (2026-09-10): forked from 0.2.0; DSH 0.1.5-rc.1 support (snapshot list shape + self path resolution); tree delete; orphan sweep; deletion path safety check.
 
 ## License

package/lib/client.js

@@ -0,0 +1,583 @@
+window.__ModuleLoader__.load({
+  id: "@muwinds/dsh-archived-sessions",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+    Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+    let react = require("react");
+
+    // ---------- styles ----------
+    var STYLE_ID = "dsw-arch-style";
+    var CSS =
+      ".dsw-arch-page{font-size:13px;padding:2px 2px 24px;}" +
+      ".dsw-arch-toolbar{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin-bottom:10px;}" +
+      ".dsw-arch-page-title{font-weight:600;color:var(--dsw-alias-label-primary);}" +
+      ".dsw-arch-meta{color:var(--dsw-alias-label-secondary);font-size:12px;}" +
+      ".dsw-arch-btn{background:transparent;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);border-radius:6px;padding:3px 7px;font-size:12px;cursor:pointer;margin-right:4px;white-space:nowrap;}" +
+      ".dsw-arch-btn:hover:not(:disabled){border-color:var(--dsw-alias-brand-primary);color:var(--dsw-alias-brand-primary);}" +
+      ".dsw-arch-btn-danger{color:var(--dsw-alias-state-error-primary);border-color:var(--dsw-alias-state-error-primary);}" +
+      ".dsw-arch-btn:disabled{opacity:0.45;cursor:default;}" +
+      ".dsw-arch-table{width:100%;border-collapse:collapse;table-layout:fixed;}" +
+      ".dsw-arch-table th{text-align:left;font-weight:600;color:var(--dsw-alias-label-secondary);font-size:12px;padding:6px 8px;border-bottom:1px solid var(--dsw-alias-border-l1);}" +
+      ".dsw-arch-table td{padding:8px 8px;border-bottom:1px solid var(--dsw-alias-border-l1);vertical-align:top;}" +
+      ".dsw-arch-table tr:last-child td{border-bottom:none;}" +
+      ".dsw-arch-table th:nth-child(1),.dsw-arch-table td:nth-child(1){width:32px;text-align:center;padding-left:2px;padding-right:2px;}" +
+      ".dsw-arch-table th:nth-child(2),.dsw-arch-table td:nth-child(2){width:auto;}" +
+      ".dsw-arch-table th:nth-child(3),.dsw-arch-table td:nth-child(3){width:104px;}" +
+      ".dsw-arch-table th:nth-child(4),.dsw-arch-table td:nth-child(4){width:92px;padding-left:2px;padding-right:2px;}" +
+      ".dsw-arch-size{white-space:nowrap;}" +
+      ".dsw-arch-actions{white-space:nowrap;}" +
+      ".dsw-arch-title-click{cursor:pointer;color:var(--dsw-alias-label-primary);}" +
+      ".dsw-arch-title-click:hover{text-decoration:underline;}" +
+      ".dsw-arch-id,.dsw-arch-path{font-family:ui-monospace,SFMono-Regular,Consolas,monospace;font-size:11px;color:var(--dsw-alias-label-secondary);word-break:break-all;margin-top:2px;}" +
+      ".dsw-arch-selectbar{display:flex;align-items:center;gap:8px;padding:6px 10px;margin-bottom:10px;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;font-size:12px;flex-wrap:wrap;}" +
+      ".dsw-arch-selectbar .dsw-arch-meta{flex:1;}" +
+      ".dsw-arch-detail{background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:10px 12px;font-size:12px;text-align:left;}" +
+      ".dsw-arch-detail-head{margin-bottom:8px;}" +
+      ".dsw-arch-detail-body{max-height:360px;overflow:auto;}" +
+      ".dsw-arch-msg{margin-bottom:8px;white-space:pre-wrap;word-break:break-word;}" +
+      ".dsw-arch-msg-role{display:inline-block;font-weight:600;margin-right:6px;}" +
+      ".dsw-arch-msg-user .dsw-arch-msg-role{color:var(--dsw-alias-label-primary);}" +
+      ".dsw-arch-msg-assistant .dsw-arch-msg-role{color:var(--dsw-alias-brand-primary);}" +
+      ".dsw-arch-msg-tool .dsw-arch-msg-role{color:var(--dsw-alias-state-warn-primary);}" +
+      ".dsw-arch-msg-time{color:var(--dsw-alias-label-secondary);font-size:11px;margin-left:6px;}" +
+      ".dsw-arch-detail-note{color:var(--dsw-alias-label-secondary);font-size:11px;margin-bottom:8px;}" +
+      ".dsw-arch-error{color:var(--dsw-alias-state-error-primary);font-size:12px;margin-bottom:8px;}" +
+      ".dsw-arch-empty{color:var(--dsw-alias-label-secondary);padding:28px 0;text-align:center;}" +
+      ".dsw-arch-badge{display:inline-block;border:1px solid var(--dsw-alias-state-warn-primary);color:var(--dsw-alias-state-warn-primary);border-radius:4px;padding:1px 6px;font-size:11px;}";
+
+    function ensureStyle() {
+      try {
+        if (document.getElementById(STYLE_ID)) return;
+        var el = document.createElement("style");
+        el.id = STYLE_ID;
+        el.textContent = CSS;
+        document.head.appendChild(el);
+      } catch (e) {
+        // ignore
+      }
+    }
+
+    // ---------- api ----------
+    function api(action, args) {
+      return fetch("/dsh-archived/" + action, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(args || {})
+      }).then(function (res) {
+        return res.json().catch(function () {
+          return null;
+        });
+      }).then(function (payload) {
+        if (payload === null || typeof payload !== "object") {
+          var err = new Error("请求失败：服务返回了无效响应");
+          throw err;
+        }
+        if (payload.error) {
+          var e2 = new Error(String(payload.error));
+          throw e2;
+        }
+        return payload;
+      });
+    }
+
+    // ---------- page component ----------
+    function ArchivedSessionsPage() {
+      var _useState = react.useState(true);
+      var loading = _useState[0];
+      var setLoading = _useState[1];
+      var _useState2 = react.useState(null);
+      var error = _useState2[0];
+      var setError = _useState2[1];
+      var _useState3 = react.useState([]);
+      var items = _useState3[0];
+      var setItems = _useState3[1];
+      var _useState4 = react.useState(0);
+      var total = _useState4[0];
+      var setTotal = _useState4[1];
+      var _useState5 = react.useState(null);
+      var busy = _useState5[0];
+      var setBusy = _useState5[1];
+      var _useState6 = react.useState(null);
+      var confirmId = _useState6[0];
+      var setConfirmId = _useState6[1];
+      var _useState7 = react.useState([]);
+      var selected = _useState7[0];
+      var setSelected = _useState7[1];
+      var _useState8 = react.useState(null);
+      var batchBusy = _useState8[0];
+      var setBatchBusy = _useState8[1];
+      var _useState9 = react.useState(null);
+      var batchConfirm = _useState9[0];
+      var setBatchConfirm = _useState9[1];
+      var _useState10 = react.useState(null);
+      var expandedId = _useState10[0];
+      var setExpandedId = _useState10[1];
+      var _useState11 = react.useState(null);
+      var detail = _useState11[0];
+      var setDetail = _useState11[1];
+      var _useState12 = react.useState([]);
+      var orphans = _useState12[0];
+      var setOrphans = _useState12[1];
+      var _useState13 = react.useState(false);
+      var showOrphans = _useState13[0];
+      var setShowOrphans = _useState13[1];
+      var _useState14 = react.useState(null);
+      var orphanBusy = _useState14[0];
+      var setOrphanBusy = _useState14[1];
+      var _useState15 = react.useState(false);
+      var confirmSweep = _useState15[0];
+      var setConfirmSweep = _useState15[1];
+
+      function describe(err) {
+        if (err === null || err === undefined) return String(err);
+        if (typeof err === "object" && typeof err.message === "string") return err.message;
+        return String(err);
+      }
+
+      function applyList(res) {
+        var next = res && Array.isArray(res.items) ? res.items : [];
+        setItems(next);
+        setTotal(res && typeof res.totalBytes === "number" ? res.totalBytes : 0);
+        var ids = {};
+        for (var i = 0; i < next.length; i++) ids[next[i].id] = true;
+        setSelected(function (sel) {
+          return sel.filter(function (id) { return ids[id]; });
+        });
+        if (expandedId && !ids[expandedId]) {
+          setExpandedId(null);
+          setDetail(null);
+        }
+      }
+
+      function load() {
+        setLoading(true);
+        setError(null);
+        api("list", {}).then(function (res) {
+          applyList(res);
+          setLoading(false);
+        }).catch(function (err) {
+          setError(describe(err));
+          setLoading(false);
+        });
+      }
+
+      react.useEffect(function () {
+        load();
+      }, []);
+
+      function refreshViews() {
+        try {
+          if (ctx.workspaces && typeof ctx.workspaces.refresh === "function") {
+            var p = ctx.workspaces.refresh();
+            if (p && typeof p.catch === "function") p.catch(function () {});
+          }
+        } catch (e) {
+          // ignore
+        }
+        try {
+          if (ctx.sessions && typeof ctx.sessions.refresh === "function") {
+            var p2 = ctx.sessions.refresh();
+            if (p2 && typeof p2.catch === "function") p2.catch(function () {});
+          }
+        } catch (e) {
+          // ignore
+        }
+      }
+
+      function reloadAfterAction() {
+        refreshViews();
+        return api("list", {}).then(applyList);
+      }
+
+      // ---- orphan management ----
+      function loadOrphans() {
+        setShowOrphans(true);
+        setOrphanBusy("load");
+        setError(null);
+        api("orphans", {}).then(function (res) {
+          setOrphans(res && Array.isArray(res.items) ? res.items : []);
+          setOrphanBusy(null);
+        }).catch(function (err) {
+          setError(describe(err));
+          setOrphanBusy(null);
+        });
+      }
+
+      function sweepOrphans() {
+        setOrphanBusy("sweep");
+        setError(null);
+        api("sweep", {}).then(function (res) {
+          setConfirmSweep(false);
+          setOrphans([]);
+          setOrphanBusy(null);
+          refreshViews();
+          return api("list", {}).then(applyList);
+        }).catch(function (err) {
+          setError(describe(err));
+          setOrphanBusy(null);
+        });
+      }
+
+      // ---- row operations ----
+      function unarchive(id) {
+        setBusy("unarchive:" + id);
+        setError(null);
+        api("unarchive", { sessionId: id })
+          .then(function () { return reloadAfterAction(); })
+          .catch(function (err) { setError(describe(err)); })
+          .finally(function () { setBusy(null); });
+      }
+
+      // Single-button two-step delete: 删除 -> 确认 (auto-reverts after 5s).
+      function armDelete(id) {
+        setConfirmId(id);
+        try {
+          if (ctx.timer && typeof ctx.timer.timeout === "function") {
+            ctx.timer.timeout(function () {
+              setConfirmId(function (cur) { return cur === id ? null : cur; });
+            }, 5000);
+          }
+        } catch (e) {
+          // timer unavailable; stay armed until the user acts
+        }
+      }
+
+      function doDelete(id) {
+        setBusy("delete:" + id);
+        setError(null);
+        api("delete", { sessionId: id })
+          .then(function () { return reloadAfterAction(); })
+          .catch(function (err) { setError(describe(err)); })
+          .finally(function () {
+            setBusy(null);
+            setConfirmId(null);
+          });
+      }
+
+      // ---- selection ----
+      function toggleSelect(id) {
+        setSelected(function (sel) {
+          return sel.includes(id) ? sel.filter(function (x) { return x !== id; }) : sel.concat([id]);
+        });
+      }
+
+      function toggleSelectAll() {
+        setSelected(function (sel) {
+          return sel.length === items.length ? [] : items.map(function (item) { return item.id; });
+        });
+      }
+
+      // ---- batch operations ----
+      function runBatch(ids, kind) {
+        setBatchBusy(kind);
+        setError(null);
+        var results = [];
+        var cursor = Promise.resolve();
+        var method = kind === "delete" ? "delete" : "unarchive";
+        for (var i = 0; i < ids.length; i++) {
+          (function (id) {
+            cursor = cursor.then(function () {
+              return api(method, { sessionId: id })
+                .then(function () { results.push({ id: id, ok: true }); })
+                .catch(function (err) { results.push({ id: id, ok: false, error: describe(err) }); });
+            });
+          })(ids[i]);
+        }
+        cursor.then(function () {
+          var failed = results.filter(function (r) { return !r.ok; });
+          if (failed.length > 0) {
+            setError((kind === "delete" ? "删除" : "释放") + "失败 " + failed.length + " 个会话：" + failed.map(function (f) { return f.id; }).join(", "));
+          }
+          refreshViews();
+          return api("list", {});
+        }).then(applyList)
+          .catch(function (err) { setError(describe(err)); })
+          .finally(function () {
+            setBatchBusy(null);
+            setBatchConfirm(null);
+            setSelected([]);
+            setConfirmId(null);
+          });
+      }
+
+      function releaseAll() { runBatch(items.map(function (item) { return item.id; }), "unarchive"); }
+      function clearAll() { runBatch(items.map(function (item) { return item.id; }), "delete"); }
+      function releaseSelected() { runBatch(selected, "unarchive"); }
+      function deleteSelected() { runBatch(selected, "delete"); }
+
+      // ---- detail ----
+      function toggleDetail(id) {
+        if (expandedId === id) {
+          setExpandedId(null);
+          setDetail(null);
+          return;
+        }
+        setExpandedId(id);
+        setDetail({ id: id, loading: true, data: null, error: null });
+        api("detail", { sessionId: id }).then(function (data) {
+          setDetail({ id: id, loading: false, data: data, error: null });
+        }).catch(function (err) {
+          setDetail({ id: id, loading: false, data: null, error: describe(err) });
+        });
+      }
+
+      function detailCell() {
+        if (!detail) return null;
+        if (detail.loading) {
+          return react.createElement("div", { className: "dsw-arch-detail" }, "加载会话内容中…");
+        }
+        if (detail.error) {
+          return react.createElement("div", { className: "dsw-arch-detail" }, String(detail.error));
+        }
+        var d = detail.data;
+        if (!d || !Array.isArray(d.messages)) {
+          return react.createElement("div", { className: "dsw-arch-detail" }, "没有可显示的内容");
+        }
+        var headParts = [];
+        if (d.createdAt) headParts.push("创建于 " + fmtTime(d.createdAt));
+        if (d.cwd) headParts.push(d.cwd);
+        var headEl = react.createElement("div", { className: "dsw-arch-detail-head" },
+          react.createElement("span", { className: "dsw-arch-page-title" }, "会话内容"),
+          react.createElement("span", { className: "dsw-arch-meta" }, " · " + headParts.join(" · "))
+        );
+        var noteEl = react.createElement("div", { className: "dsw-arch-detail-note" },
+          "共 " + String(d.totalEvents) + " 条事件，提取 " + String(d.messageCount) + " 条消息" + (d.truncated ? "（仅显示前 100 条）" : "")
+        );
+        var msgs = d.messages.map(function (m) {
+          var roleLabel = m.role === "user" ? "用户" : m.role === "assistant" ? "助手" : "工具";
+          return react.createElement("div", { className: "dsw-arch-msg dsw-arch-msg-" + m.role },
+            react.createElement("span", { className: "dsw-arch-msg-role" }, roleLabel),
+            react.createElement("span", { className: "dsw-arch-msg-time" }, fmtTime(m.time)),
+            react.createElement("div", null, m.text)
+          );
+        });
+        return react.createElement("div", { className: "dsw-arch-detail" }, headEl, noteEl,
+          react.createElement("div", { className: "dsw-arch-detail-body" }, msgs)
+        );
+      }
+
+      // ---- formatting ----
+      function fmtSize(bytes) {
+        var n = Number(bytes) || 0;
+        if (n <= 0) return "0 B";
+        var units = ["B", "KB", "MB", "GB", "TB"];
+        var v = n;
+        var i = 0;
+        while (v >= 1024 && i < units.length - 1) {
+          v = v / 1024;
+          i = i + 1;
+        }
+        return (i === 0 ? String(Math.round(v)) : v.toFixed(1)) + " " + units[i];
+      }
+
+      function fmtTime(ms) {
+        if (!ms) return "—";
+        try {
+          return new Date(ms).toLocaleString();
+        } catch (e) {
+          return String(ms);
+        }
+      }
+
+      var anyBusy = busy !== null || batchBusy !== null;
+
+      var header = react.createElement("div", { className: "dsw-arch-toolbar" },
+        react.createElement("span", { className: "dsw-arch-page-title" }, "归档会话"),
+        react.createElement("span", { className: "dsw-arch-meta" },
+          String(items.length) + " 个会话 · 共 " + fmtSize(total) + (loading ? " · 加载中…" : "") + (batchBusy ? " · 批量操作中…" : "")),
+        react.createElement("button", { className: "dsw-arch-btn", disabled: anyBusy, onClick: function () { load(); } }, "刷新"),
+        react.createElement("button", { className: "dsw-arch-btn", disabled: anyBusy || items.length === 0, onClick: function () { releaseAll(); } }, "一键释放"),
+        react.createElement("button", { className: "dsw-arch-btn dsw-arch-btn-danger", disabled: anyBusy || items.length === 0, onClick: function () { setBatchConfirm("clear"); } }, "一键清空"),
+        react.createElement("button", { className: "dsw-arch-btn", disabled: anyBusy, onClick: function () { loadOrphans(); } }, showOrphans ? "隐藏孤儿" : "孤儿清理")
+      );
+
+      var confirmBar = null;
+      if (batchConfirm === "clear") {
+        confirmBar = react.createElement("div", { className: "dsw-arch-selectbar" },
+          react.createElement("span", { className: "dsw-arch-meta", style: { color: "var(--dsw-alias-state-warn-primary)" } }, "确认清空全部 " + String(items.length) + " 个归档会话？此操作会从硬盘删除（含各自的子会话）且不可恢复。"),
+          react.createElement("button", { className: "dsw-arch-btn dsw-arch-btn-danger", disabled: anyBusy, onClick: function () { clearAll(); } }, "确认清空"),
+          react.createElement("button", { className: "dsw-arch-btn", disabled: anyBusy, onClick: function () { setBatchConfirm(null); } }, "取消")
+        );
+      } else if (batchConfirm === "delete") {
+        confirmBar = react.createElement("div", { className: "dsw-arch-selectbar" },
+          react.createElement("span", { className: "dsw-arch-meta", style: { color: "var(--dsw-alias-state-warn-primary)" } }, "确认删除选中的 " + String(selected.length) + " 个会话（含各自的子会话）？此操作不可恢复。"),
+          react.createElement("button", { className: "dsw-arch-btn dsw-arch-btn-danger", disabled: anyBusy, onClick: function () { deleteSelected(); } }, "确认删除"),
+          react.createElement("button", { className: "dsw-arch-btn", disabled: anyBusy, onClick: function () { setBatchConfirm(null); } }, "取消")
+        );
+      } else if (selected.length > 0) {
+        confirmBar = react.createElement("div", { className: "dsw-arch-selectbar" },
+          react.createElement("span", { className: "dsw-arch-meta" }, "已选择 " + String(selected.length) + " 个会话"),
+          react.createElement("button", { className: "dsw-arch-btn", disabled: anyBusy, onClick: function () { releaseSelected(); } }, "释放选中"),
+          react.createElement("button", { className: "dsw-arch-btn dsw-arch-btn-danger", disabled: anyBusy, onClick: function () { setBatchConfirm("delete"); } }, "删除选中"),
+          react.createElement("button", { className: "dsw-arch-btn", disabled: anyBusy, onClick: function () { setSelected([]); } }, "取消选择")
+        );
+      }
+
+      var body;
+      if (loading && items.length === 0) {
+        body = react.createElement("div", { className: "dsw-arch-empty" }, "加载中…");
+      } else if (items.length === 0) {
+        body = react.createElement("div", { className: "dsw-arch-empty" }, "没有已归档的会话");
+      } else {
+        var allSelected = selected.length === items.length;
+        var childCount = {};
+        for (var ci = 0; ci < items.length; ci++) {
+          var p = items[ci].parentSession;
+          if (p) childCount[p] = (childCount[p] || 0) + 1;
+        }
+        var rows = [];
+        for (var i = 0; i < items.length; i++) {
+          (function (item) {
+            var isBusy = busy === "unarchive:" + item.id || busy === "delete:" + item.id;
+            var confirming = confirmId === item.id;
+            var metaParts = [];
+            if (item.createdAt) metaParts.push("创建于 " + fmtTime(item.createdAt));
+            if (item.cwd) metaParts.push(item.cwd);
+            var kids = childCount[item.id] || 0;
+            if (kids > 0) metaParts.push("含 " + String(kids) + " 个子会话");
+
+            var checkEl = react.createElement("input", {
+              type: "checkbox",
+              checked: selected.includes(item.id),
+              disabled: anyBusy,
+              onChange: function () { toggleSelect(item.id); }
+            });
+
+            var chevron = expandedId === item.id ? "▾ " : "▸ ";
+            var titleEl = react.createElement("div", {
+              className: "dsw-arch-title-click",
+              title: "点击查看会话内容",
+              onClick: function () { toggleDetail(item.id); }
+            }, chevron + (item.title || "(无标题)"));
+            var idEl = react.createElement("div", { className: "dsw-arch-id" }, item.id);
+            var metaEl = react.createElement("div", { className: "dsw-arch-meta" }, metaParts.join(" · "));
+            var pathEl = item.path
+              ? react.createElement("div", { className: "dsw-arch-path" }, item.path)
+              : null;
+            var sizeEl = item.missing
+              ? react.createElement("span", { className: "dsw-arch-badge" }, "文件缺失")
+              : react.createElement("span", { className: "dsw-arch-size" }, fmtSize(item.sizeBytes));
+
+            var unarchiveBtn = react.createElement("button", {
+              className: "dsw-arch-btn",
+              disabled: anyBusy || item.missing,
+              onClick: function () { unarchive(item.id); }
+            }, "释放");
+
+            var deleteBtn = react.createElement("button", {
+              className: "dsw-arch-btn dsw-arch-btn-danger",
+              disabled: anyBusy,
+              title: confirming ? "再次点击确认删除（5 秒后自动取消）" : "删除（需再次点击确认）",
+              onClick: function () { confirming ? doDelete(item.id) : armDelete(item.id); }
+            }, confirming ? "确认" : "删除");
+
+            rows.push(react.createElement("tr", { key: item.id },
+              react.createElement("td", null, checkEl),
+              react.createElement("td", null, titleEl, idEl, metaEl, pathEl),
+              react.createElement("td", null, sizeEl),
+              react.createElement("td", { className: "dsw-arch-actions" }, unarchiveBtn, deleteBtn)
+            ));
+
+            if (expandedId === item.id) {
+              rows.push(react.createElement("tr", { key: item.id + "-detail" },
+                react.createElement("td", { colSpan: 4, style: { padding: "4px 10px 10px" } }, detailCell())
+              ));
+            }
+          })(items[i]);
+        }
+
+        var headCheck = react.createElement("input", {
+          type: "checkbox",
+          checked: allSelected,
+          disabled: anyBusy,
+          onChange: function () { toggleSelectAll(); }
+        });
+
+        body = react.createElement("table", { className: "dsw-arch-table" },
+          react.createElement("thead", null,
+            react.createElement("tr", null,
+              react.createElement("th", null, headCheck),
+              react.createElement("th", null, "会话"),
+              react.createElement("th", null, "磁盘占用"),
+              react.createElement("th", null, "操作")
+            )
+          ),
+          react.createElement("tbody", null, rows)
+        );
+      }
+
+      var errorEl = error
+        ? react.createElement("div", { className: "dsw-arch-error" }, String(error))
+        : null;
+
+      var orphanPanel = null;
+      if (showOrphans) {
+        var orphanRows = orphans.map(function (o) {
+          return react.createElement("tr", { key: o.id },
+            react.createElement("td", null,
+              react.createElement("div", { className: "dsw-arch-title-click" }, o.id),
+              react.createElement("div", { className: "dsw-arch-id" }, "父会话: " + o.parentSession + (o.cwd ? " · " + o.cwd : ""))
+            ),
+            react.createElement("td", null, o.missing
+              ? react.createElement("span", { className: "dsw-arch-badge" }, "文件缺失")
+              : react.createElement("span", { className: "dsw-arch-size" }, fmtSize(o.sizeBytes)))
+          );
+        });
+        var orphanTotal = 0;
+        for (var oi = 0; oi < orphans.length; oi++) orphanTotal += orphans[oi].sizeBytes || 0;
+        var sweepBtn;
+        if (confirmSweep) {
+          sweepBtn = react.createElement("button", { className: "dsw-arch-btn dsw-arch-btn-danger", disabled: orphanBusy !== null, onClick: function () { sweepOrphans(); } }, "确认清理 " + String(orphans.length) + " 个孤儿会话"),
+            react.createElement("button", { className: "dsw-arch-btn", disabled: orphanBusy !== null, onClick: function () { setConfirmSweep(false); } }, "取消");
+        } else {
+          sweepBtn = react.createElement("button", { className: "dsw-arch-btn dsw-arch-btn-danger", disabled: orphanBusy !== null || orphans.length === 0, onClick: function () { setConfirmSweep(true); } }, "清理孤儿会话");
+        }
+        orphanPanel = react.createElement("div", { className: "dsw-arch-selectbar", style: { marginTop: "10px", display: "block" } },
+          react.createElement("div", { className: "dsw-arch-meta", style: { marginBottom: "6px" } },
+            "孤儿会话 " + String(orphans.length) + " 个 · 共 " + fmtSize(orphanTotal) +
+            (orphanBusy === "load" ? " · 加载中…" : "") + (orphanBusy === "sweep" ? " · 清理中…" : "")),
+          react.createElement("div", null, sweepBtn),
+          orphanRows.length > 0
+            ? react.createElement("table", { className: "dsw-arch-table", style: { marginTop: "8px" } },
+                react.createElement("thead", null,
+                  react.createElement("tr", null,
+                    react.createElement("th", null, "孤儿会话（父会话已删除）"),
+                    react.createElement("th", null, "磁盘占用"))),
+                react.createElement("tbody", null, orphanRows))
+            : (orphanBusy === "load" ? null : react.createElement("div", { className: "dsw-arch-empty" }, "没有孤儿会话"))
+        );
+      }
+
+      return react.createElement("div", { className: "dsw-arch-page" }, errorEl, header, confirmBar, body, orphanPanel);
+    }
+
+    // ---------- plugin body ----------
+    var inject = ["slots", "workspaces", "sessions", "timer"];
+
+    function apply(ctx) {
+      ensureStyle();
+      ctx.effect(function () {
+        return function () {
+          try {
+            var el = document.getElementById(STYLE_ID);
+            if (el) el.remove();
+          } catch (e) {
+            // ignore
+          }
+        };
+      }, "ui-archived-sessions: style cleanup");
+
+      ctx.slots.inject("settings.section", function () {
+        return ctx.slots.register(
+          { name: "settings.section", id: "archived-sessions", order: 30, label: function () { return "归档会话"; } },
+          function () { return react.createElement(ArchivedSessionsPage); }
+        );
+      });
+    }
+
+    exports.apply = apply;
+    exports.inject = inject;
+    return module.exports;
+  }
+});

package/lib/index.js

@@ -0,0 +1,743 @@
+/**
+ * Host half of the archived-sessions page (@omdp/dsh-archived-sessions).
+ *
+ * Fork of @muwinds/dsh-archived-sessions 0.2.0, adapted for DSH 0.1.5-rc.1:
+ *  - sessionPersistence.list() now returns SessionPersistenceSnapshot[]
+ *    ({ header, revision, eventCount?, sizeBytes? }), not bare headers;
+ *  - the abstract service no longer exposes locate(meta); the JSONL backend's
+ *    path helpers (projectDir / sessionDir / logPath + encodeSegment) are used
+ *    instead to resolve the on-disk artifact, so list/delete work again.
+ *  - delete now removes the whole parentSession subtree (issue #2) and an
+ *    orphan sweep removes subagent dirs whose parent is already gone.
+ *
+ * Exposes a small JSON API under /dsh-archived/* on the harness web server:
+ *   POST /dsh-archived/list         {}                -> { items, totalBytes }
+ *   POST /dsh-archived/unarchive    { sessionId }     -> { ok, changed, archivedSessionIds }
+ *   POST /dsh-archived/delete       { sessionId }     -> { ok, deleted, sessionId, path?, sizeBytes?, reason?, alsoDeleted? }
+ *   POST /dsh-archived/detail       { sessionId }     -> { id, createdAt, cwd, totalEvents, messageCount, truncated, messages }
+ *   POST /dsh-archived/orphans      {}                -> { items, totalBytes }
+ *   POST /dsh-archived/sweep        {}                -> { removed, freedBytes, items }
+ *
+ * The browser half ships in the same package (exports["./client"], dsh.client).
+ */
+
+/** Wait for the browser HTTP carrier before registering the route. */
+export const inject = ["webServer"];
+
+/** Plugin display name for the loader. */
+export const name = "dsh-archived-sessions";
+
+// ---------- helpers ----------
+
+function parentDir(p) {
+  const a = p.lastIndexOf("/");
+  const b = p.lastIndexOf("\\");
+  const i = a > b ? a : b;
+  return i <= 0 ? p : p.slice(0, i);
+}
+
+function sessionIdOf(args) {
+  if (args === null || typeof args !== "object") throw new Error("sessionId is required");
+  const id = args.sessionId;
+  if (typeof id !== "string" || id.length === 0) throw new Error("sessionId is required");
+  return id;
+}
+
+/** Extract readable text from a content-block array. */
+function blocksText(blocks) {
+  if (!Array.isArray(blocks)) return "";
+  const parts = [];
+  for (const b of blocks) {
+    if (!b || typeof b !== "object") continue;
+    if (b.type === "text" && typeof b.text === "string") parts.push(b.text);
+    else if (b.type === "reasoning" && typeof b.text === "string") parts.push("[思考] " + b.text);
+    else if (b.type === "tool-call") parts.push("[调用 " + (b.name || "?") + "]");
+    else if (b.type === "tool-result") parts.push("[工具结果]");
+    else if (b.type === "image") parts.push("[图片]");
+  }
+  return parts.join("\n");
+}
+
+/**
+ * Recursive byte size of a session directory via the fs service.
+ * Returns null when the path cannot be resolved (missing on disk).
+ */
+async function dirSizeBytes(fsSvc, dirPath, depth) {
+  let target;
+  try {
+    target = await fsSvc.resolve(dirPath);
+  } catch (e) {
+    return null;
+  }
+  try {
+    const info = await fsSvc.stat(target);
+    if (!info) return 0;
+    if (info.type !== "directory") return info.size || 0;
+    if (depth > 10) return 0;
+    let total = 0;
+    let entries = [];
+    try {
+      entries = await fsSvc.listDir(target);
+    } catch (e) {
+      entries = [];
+    }
+    for (const entry of entries) {
+      if (entry.type === "directory") {
+        const sub = await dirSizeBytes(fsSvc, fsSvc.processPath(entry.target), depth + 1);
+        total += sub === null ? 0 : sub;
+      } else {
+        total += entry.size || 0;
+      }
+    }
+    return total;
+  } catch (e) {
+    return 0;
+  }
+}
+
+/**
+ * Resolve an explicit danger-full-access policy so the shell executor runs the
+ * deletion unconfined. On Windows deployments where the ACL sandbox backend
+ * cannot start (its temp root must live outside the workspace), any confined
+ * mode would fail before the command even runs.
+ */
+function dangerPolicy(ctx) {
+  const sp = ctx.get("sandboxPolicy");
+  if (!sp || typeof sp.resolve !== "function") return undefined;
+  try {
+    return sp.resolve({ mode: "danger-full-access" });
+  } catch (e) {
+    return undefined;
+  }
+}
+
+/**
+ * Refuse to delete anything that does not look like a per-session directory.
+ * The dir name must be a `session-` prefixed id (new format) or a bare UUID
+ * (old format), so a resolution mistake can never take out an arbitrary path.
+ */
+function assertSessionDirName(dirPath) {
+  const last = dirPath.replace(/[\\/]+$/, "");
+  const name = last.slice(last.lastIndexOf("/") + 1, last.length).slice(last.lastIndexOf("\\") + 1);
+  const ok = /^session-[0-9a-fA-F-]{36}$/.test(name) || /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.test(name);
+  if (!ok) throw new Error("拒绝删除非会话目录: " + dirPath);
+}
+
+/** Delete a directory recursively through the shell executor (pwsh / rm). */
+async function removeDir(ctx, dirPath) {
+  assertSessionDirName(dirPath);
+  const shell = ctx.get("shell");
+  if (!shell || typeof shell.resolve !== "function" || typeof shell.run !== "function") {
+    throw new Error("shell executor unavailable; cannot delete from disk");
+  }
+  const isWindows = /^[A-Za-z]:[\\/]/.test(dirPath);
+  const command = isWindows
+    ? "Remove-Item -LiteralPath '" + dirPath.replace(/'/g, "''") + "' -Recurse -Force -ErrorAction Stop"
+    : "rm -rf -- '" + dirPath.replace(/'/g, "'\\''") + "'";
+  const request = { command, timeoutMs: 60000 };
+  const policy = dangerPolicy(ctx);
+  if (policy) request.sandboxPolicy = policy;
+  let spec;
+  try {
+    spec = shell.resolve(request);
+  } catch (e) {
+    throw new Error("shell resolve failed: " + String((e && e.message) || e));
+  }
+  const result = await shell.run(spec);
+  if (result && result.exitCode === 0) return;
+  let detail = "";
+  try {
+    const out = result && (result.stderr || result.stdout);
+    if (out && typeof out.text === "string") detail = out.text.slice(0, 400);
+  } catch (e) {
+    detail = "";
+  }
+  throw new Error("删除失败 (exit " + String(result && result.exitCode) + "): " + (detail || dirPath));
+}
+
+/**
+ * Remove one id from the durable archive set and keep the registry's in-memory
+ * state consistent so its own later writes cannot clobber it.
+ */
+async function removeFromArchiveSet(ctx, sessionId) {
+  const registry = ctx.get("workspaceRegistry");
+  if (!registry) throw new Error("workspace registry unavailable");
+  if (!registry.state || typeof registry.state !== "object") throw new Error("workspace registry is not started");
+  const current = registry.archivedSessionIds;
+  if (!Array.isArray(current) || !current.includes(sessionId)) return false;
+  const next = current.filter((id) => id !== sessionId);
+  const state = Object.assign({}, registry.state, { archivedSessionIds: next });
+  if (typeof registry.setState === "function") {
+    await registry.setState(state);
+    return true;
+  }
+  const domain = ctx.get("storageDomain");
+  if (!domain) throw new Error("storage domain unavailable");
+  const unit = domain.get("workspace");
+  if (!unit || !unit.global || typeof unit.global.set !== "function") throw new Error("workspace domain is not open");
+  await unit.global.set(state);
+  registry.state = state;
+  return true;
+}
+
+/** A session is deletable unless its agent is actively running a turn. */
+function sessionRunning(ctx, sessionId) {
+  const agents = ctx.get("agents");
+  if (!agents || typeof agents.get !== "function") return false;
+  const agent = agents.get(sessionId);
+  return !!(agent && agent.status === "running");
+}
+
+/**
+ * Evict a live session from the in-memory store (the store's own detach path),
+ * so a deleted session cannot resurface in the workspace afterward.
+ */
+function evictSessionFromMemory(ctx, sessionId) {
+  const sessions = ctx.get("sessions");
+  if (!sessions) return false;
+  try {
+    const store = sessions.store;
+    if (!store || typeof store.get !== "function") return false;
+    const entry = store.get(sessionId);
+    if (!entry || typeof entry.detach !== "function") return false;
+    entry.detach();
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * Resolve the on-disk location for one session in the DSH 0.1.5-rc.1 JSONL
+ * backend layout. The abstract sessionPersistence service no longer exposes
+ * locate(); the JSONL backend's own path helpers are exported and used here.
+ * Falls back to a best-effort path when the jsonl backend module is not
+ * importable (older DSH), where the old layout used the same encoding.
+ */
+let jsonlBackend = null;
+try {
+  jsonlBackend = await import("@deepseek-ai/dsh-session-persistence-jsonl");
+} catch (e) {
+  jsonlBackend = null;
+}
+
+function encodeSegment(raw) {
+  if (raw.length === 0) throw new Error("cannot encode an empty path segment");
+  if (raw === ".") return "~002E";
+  if (raw === "..") return "~002E~002E";
+  let out = "";
+  for (let i = 0; i < raw.length; i++) {
+    const code = raw.charCodeAt(i);
+    const ch = String.fromCharCode(code);
+    if (ch !== "~" && /^[A-Za-z0-9._-]$/.test(ch)) out += ch;
+    else out += "~" + code.toString(16).toUpperCase().padStart(4, "0");
+  }
+  return out;
+}
+
+function projectKey(cwd) {
+  if (cwd.length === 0) throw new Error("cannot encode an empty project path");
+  let readable = "";
+  let separatorRun = false;
+  for (let i = 0; i < cwd.length; i++) {
+    const code = cwd.charCodeAt(i);
+    const ch = String.fromCharCode(code);
+    if (ch === "/" || ch === "\\" || ch === ":") {
+      if (!separatorRun) readable += "-";
+      separatorRun = true;
+    } else if (ch !== "~" && /^[A-Za-z0-9._-]$/.test(ch)) {
+      readable += ch;
+      separatorRun = false;
+    } else {
+      readable += "~" + code.toString(16).toUpperCase().padStart(4, "0");
+      separatorRun = false;
+    }
+  }
+  return `--${(readable.replace(/^-+/, "") || "root").slice(0, 251)}--`;
+}
+
+/** Candidate JSONL session roots, probed in order. */
+const CANDIDATE_ROOTS = ["C:\\Users\\xj\\.dsh\\sessions"];
+
+/** Build one session's on-disk directory path under a candidate root. */
+function buildSessionDir(root, header) {
+  const key = header.cwd === undefined ? "_no-cwd" : projectKey(header.cwd);
+  const id = encodeSegment(header.id);
+  const sep = root.endsWith("/") || root.endsWith("\\") ? "" : "/";
+  return root + sep + key + sep + id;
+}
+
+/**
+ * Resolve the on-disk session directory for one header, confirming existence
+ * through the fs service. Returns { path, found } — `found` is false when no
+ * candidate root holds the session (deletion then prunes the archive id only).
+ */
+async function resolveSessionLocation(ctx, header) {
+  const fsSvc = ctx.get("fs");
+  const backend = jsonlBackend && typeof jsonlBackend.sessionDir === "function" ? jsonlBackend : null;
+  let last = null;
+  for (const root of CANDIDATE_ROOTS) {
+    let dirPath;
+    if (backend && typeof jsonlBackend.projectDir === "function") {
+      try {
+        dirPath = backend.sessionDir(root, header.cwd, header.id);
+      } catch (e) {
+        dirPath = buildSessionDir(root, header);
+      }
+    } else {
+      dirPath = buildSessionDir(root, header);
+    }
+    last = { path: dirPath, found: false };
+    if (!fsSvc || typeof fsSvc.resolve !== "function") {
+      last.found = true;
+      break;
+    }
+    try {
+      await fsSvc.resolve(dirPath);
+      last.found = true;
+      break;
+    } catch (e) {
+      // not under this root; try the next
+    }
+  }
+  return last;
+}
+
+// ---------- API handlers ----------
+
+async function handleList(ctx) {
+  const registry = ctx.get("workspaceRegistry");
+  const persistence = ctx.get("sessionPersistence");
+  if (!registry || !persistence) return { items: [], totalBytes: 0 };
+  const archived = Array.isArray(registry.archivedSessionIds) ? [...registry.archivedSessionIds] : [];
+  if (archived.length === 0) return { items: [], totalBytes: 0 };
+
+  const snapshots = await persistence.list();
+  const byId = new Map();
+  for (const snap of snapshots) {
+    if (snap && typeof snap === "object" && snap.header && typeof snap.header === "object") {
+      byId.set(snap.header.id, snap);
+    } else if (snap && typeof snap === "object" && typeof snap.id === "string") {
+      byId.set(snap.id, snap);
+    }
+  }
+
+  const titles = new Map();
+  const query = ctx.get("sessionQuery");
+  if (query && typeof query.readTitleSnapshots === "function") {
+    try {
+      const results = await query.readTitleSnapshots(archived);
+      for (const r of results) {
+        if (r && r.status === "fulfilled" && r.value && r.value.title && typeof r.value.title.title === "string") {
+          titles.set(r.sessionId, r.value.title.title);
+        }
+      }
+    } catch (e) {
+      // best effort
+    }
+  }
+
+  const liveSvc = ctx.get("sessions");
+  const fsSvc = ctx.get("fs");
+  const items = [];
+  let totalBytes = 0;
+  for (const id of archived) {
+    const snap = byId.get(id);
+    const header = snap && snap.header ? snap.header : (snap && typeof snap.id === "string" ? snap : null);
+    let sizeBytes = 0;
+    let missing = false;
+    let path = null;
+    if (header) {
+      // Prefer the snapshot's cheap size when present.
+      if (typeof snap.sizeBytes === "number" && snap.sizeBytes >= 0) {
+        sizeBytes = snap.sizeBytes;
+        path = null;
+      } else {
+        let location = null;
+        try {
+          location = await resolveSessionLocation(ctx, header);
+        } catch (e) {
+          location = null;
+        }
+        if (location && typeof location.path === "string" && location.path.length > 0) {
+          path = location.path;
+          if (fsSvc) {
+            const size = await dirSizeBytes(fsSvc, location.path, 0);
+            if (size === null) missing = true;
+            else sizeBytes = size;
+          }
+        } else {
+          missing = true;
+        }
+      }
+    } else {
+      missing = true;
+    }
+    totalBytes += sizeBytes;
+    items.push({
+      id,
+      title: titles.get(id) || null,
+      createdAt: header ? header.createdAt : null,
+      cwd: header ? header.cwd || null : null,
+      parentSession: header ? header.parentSession || null : null,
+      sizeBytes,
+      missing,
+      live: !!(liveSvc && liveSvc.get(id) !== undefined),
+      running: sessionRunning(ctx, id),
+      path
+    });
+  }
+  items.sort((a, b) => (b.createdAt || 0) - (a.createdAt || 0));
+  return { items, totalBytes };
+}
+
+async function handleUnarchive(ctx, args) {
+  const sessionId = sessionIdOf(args);
+  const registry = ctx.get("workspaceRegistry");
+  if (!registry) throw new Error("workspace registry unavailable");
+  if (!Array.isArray(registry.archivedSessionIds) || !registry.archivedSessionIds.includes(sessionId)) {
+    throw new Error("会话 '" + sessionId + "' 不在归档集合中");
+  }
+  const changed = await removeFromArchiveSet(ctx, sessionId);
+  return { ok: true, changed, archivedSessionIds: [...registry.archivedSessionIds] };
+}
+
+/** Collect the whole parentSession subtree (ids present in the archive set). */
+async function collectSubtreeIds(ctx, rootId, snapshots) {
+  const byParent = new Map();
+  for (const snap of snapshots) {
+    const h = snap && typeof snap === "object" && snap.header ? snap.header : snap;
+    if (h && typeof h === "object" && typeof h.parentSession === "string" && h.parentSession.length > 0) {
+      let list = byParent.get(h.parentSession);
+      if (!list) {
+        list = [];
+        byParent.set(h.parentSession, list);
+      }
+      list.push(typeof h.id === "string" ? h.id : "");
+    }
+  }
+  const result = [rootId];
+  const seen = new Set(result);
+  let i = 0;
+  while (i < result.length) {
+    const cur = result[i];
+    const kids = byParent.get(cur) || [];
+    for (const k of kids) {
+      if (k && !seen.has(k)) {
+        seen.add(k);
+        result.push(k);
+      }
+    }
+    i++;
+  }
+  return result.slice(1);
+}
+
+async function handleDelete(ctx, args) {
+  const sessionId = sessionIdOf(args);
+  const registry = ctx.get("workspaceRegistry");
+  const persistence = ctx.get("sessionPersistence");
+  if (!registry || !persistence) throw new Error("workspace registry or session persistence unavailable");
+  if (!Array.isArray(registry.archivedSessionIds) || !registry.archivedSessionIds.includes(sessionId)) {
+    throw new Error("会话 '" + sessionId + "' 不在归档集合中");
+  }
+  if (sessionRunning(ctx, sessionId)) {
+    throw new Error("会话 '" + sessionId + "' 正在运行中，无法删除");
+  }
+  // A live (in-memory) session would otherwise resurface in the workspace once
+  // the archive entry is pruned; evict it so the deletion is complete.
+  const liveSvc = ctx.get("sessions");
+  const isLive = !!(liveSvc && typeof liveSvc.get === "function" && liveSvc.get(sessionId) !== undefined);
+  if (isLive && !evictSessionFromMemory(ctx, sessionId)) {
+    throw new Error("会话 '" + sessionId + "' 仍驻留内存且无法移除，删除未完成；请重启 Harness 后重试");
+  }
+
+  const snapshots = await persistence.list();
+  const subtree = await collectSubtreeIds(ctx, sessionId, snapshots);
+
+  const headers = new Map();
+  for (const snap of snapshots) {
+    const h = snap && typeof snap === "object" && snap.header ? snap.header : snap;
+    if (h && typeof h === "object" && typeof h.id === "string") headers.set(h.id, h);
+  }
+
+  const deletedIds = [];
+  const failedIds = [];
+  for (const id of [sessionId, ...subtree]) {
+    const header = headers.get(id);
+    if (!header) {
+      // Already gone from persistence: just prune the archive id.
+      if (registry.archivedSessionIds.includes(id)) {
+        await removeFromArchiveSet(ctx, id);
+      }
+      deletedIds.push(id);
+      continue;
+    }
+    let location = null;
+    try {
+      location = await resolveSessionLocation(ctx, header);
+    } catch (e) {
+      location = null;
+    }
+    if (!location || typeof location.path !== "string" || location.path.length === 0) {
+      if (registry.archivedSessionIds.includes(id)) {
+        await removeFromArchiveSet(ctx, id);
+      }
+      deletedIds.push(id);
+      continue;
+    }
+    const dirPath = location.path;
+    const fsSvc = ctx.get("fs");
+    let sizeBytes = 0;
+    if (fsSvc) {
+      const size = await dirSizeBytes(fsSvc, dirPath, 0);
+      sizeBytes = size === null ? 0 : size;
+    }
+    try {
+      await removeDir(ctx, dirPath);
+    } catch (e) {
+      failedIds.push(id);
+      continue;
+    }
+    if (registry.archivedSessionIds.includes(id)) {
+      await removeFromArchiveSet(ctx, id);
+    }
+    deletedIds.push(id);
+  }
+
+  if (failedIds.length > 0) {
+    throw new Error("部分会话删除失败: " + failedIds.join(", "));
+  }
+  return {
+    ok: true,
+    deleted: deletedIds.includes(sessionId),
+    sessionId,
+    alsoDeleted: subtree.filter((id) => deletedIds.includes(id)),
+    sizeBytes: 0,
+    reason: deletedIds.length === 0 ? "no-artifact" : undefined
+  };
+}
+
+async function handleDetail(ctx, args) {
+  const sessionId = sessionIdOf(args);
+  const query = ctx.get("sessionQuery");
+  if (!query || typeof query.readSession !== "function") {
+    throw new Error("session query unavailable");
+  }
+  let snapshot;
+  try {
+    snapshot = await query.readSession(sessionId);
+  } catch (e) {
+    throw new Error("无法读取会话内容（可能已从磁盘删除）: " + String((e && e.message) || e));
+  }
+  if (!snapshot || !Array.isArray(snapshot.events)) {
+    throw new Error("会话内容为空或不可读");
+  }
+  const events = snapshot.events;
+  const messages = [];
+  const MAX_MESSAGES = 100;
+  const MAX_TEXT = 8000;
+  for (const ev of events) {
+    if (messages.length >= MAX_MESSAGES) break;
+    if (!ev || typeof ev !== "object" || !ev.data || typeof ev.data !== "object") continue;
+    const data = ev.data;
+    if (ev.type === "user/message") {
+      const text = blocksText(data.content);
+      if (text) messages.push({ seq: ev.seq, time: ev.time, role: "user", text: text.slice(0, MAX_TEXT) });
+    } else if (ev.type === "assistant/message" && data.message && typeof data.message === "object") {
+      const text = blocksText(data.message.content);
+      if (text) messages.push({ seq: ev.seq, time: ev.time, role: "assistant", text: text.slice(0, MAX_TEXT) });
+    } else if (ev.type === "tool/call") {
+      const name = typeof data.name === "string" ? data.name : "?";
+      const argsText = typeof data.arguments === "string" ? data.arguments.slice(0, 300) : "";
+      messages.push({ seq: ev.seq, time: ev.time, role: "tool", text: "[" + name + "] " + argsText });
+    }
+  }
+  const header = snapshot.session || null;
+  return {
+    id: sessionId,
+    createdAt: header ? header.createdAt : null,
+    cwd: header ? header.cwd || null : null,
+    parentSession: header ? header.parentSession || null : null,
+    totalEvents: events.length,
+    messageCount: messages.length,
+    truncated: messages.length >= MAX_MESSAGES,
+    messages
+  };
+}
+
+/** List orphaned subagent sessions: on disk, parent already gone, not archived. */
+async function handleOrphans(ctx) {
+  const registry = ctx.get("workspaceRegistry");
+  const persistence = ctx.get("sessionPersistence");
+  if (!registry || !persistence) return { items: [], totalBytes: 0 };
+  const archived = Array.isArray(registry.archivedSessionIds) ? registry.archivedSessionIds : [];
+  const live = new Set(archived);
+  const snapshots = await persistence.list();
+  const known = new Set();
+  const byParent = new Map();
+  for (const snap of snapshots) {
+    const h = snap && typeof snap === "object" && snap.header ? snap.header : snap;
+    if (h && typeof h === "object" && typeof h.id === "string") {
+      known.add(h.id);
+      if (typeof h.parentSession === "string" && h.parentSession.length > 0) {
+        let list = byParent.get(h.parentSession);
+        if (!list) {
+          list = [];
+          byParent.set(h.parentSession, list);
+        }
+        list.push(h.id);
+      }
+    }
+  }
+  const fsSvc = ctx.get("fs");
+  const items = [];
+  let totalBytes = 0;
+  for (const id of known) {
+    if (live.has(id)) continue;
+    let h = null;
+    for (const snap of snapshots) {
+      const hh = snap && typeof snap === "object" && snap.header ? snap.header : snap;
+      if (hh && typeof hh === "object" && hh.id === id) {
+        h = hh;
+        break;
+      }
+    }
+    if (!h || typeof h.parentSession !== "string" || h.parentSession.length === 0) continue;
+    if (known.has(h.parentSession)) continue;
+    let location = null;
+    try {
+      location = await resolveSessionLocation(ctx, h);
+    } catch (e) {
+      location = null;
+    }
+    if (!location) continue;
+    const dirPath = location.path;
+    let sizeBytes = 0;
+    if (fsSvc) {
+      const size = await dirSizeBytes(fsSvc, dirPath, 0);
+      sizeBytes = size === null ? 0 : size;
+    }
+    totalBytes += sizeBytes;
+    items.push({
+      id,
+      parentSession: h.parentSession,
+      createdAt: h.createdAt || null,
+      cwd: h.cwd || null,
+      sizeBytes,
+      missing: sizeBytes === 0
+    });
+  }
+  items.sort((a, b) => (b.createdAt || 0) - (a.createdAt || 0));
+  return { items, totalBytes };
+}
+
+/** Sweep orphaned subagent sessions: delete their dirs + prune from archive set. */
+async function handleSweep(ctx) {
+  const { items } = await handleOrphans(ctx);
+  const removed = [];
+  let freedBytes = 0;
+  for (const item of items) {
+    const persistence = ctx.get("sessionPersistence");
+    const snapshots = await persistence.list();
+    let h = null;
+    for (const snap of snapshots) {
+      const hh = snap && typeof snap === "object" && snap.header ? snap.header : snap;
+      if (hh && typeof hh === "object" && hh.id === item.id) {
+        h = hh;
+        break;
+      }
+    }
+    if (!h) continue;
+    let location = null;
+    try {
+      location = await resolveSessionLocation(ctx, h);
+    } catch (e) {
+      location = null;
+    }
+    if (!location) continue;
+    const dirPath = location.path;
+    try {
+      await removeDir(ctx, dirPath);
+    } catch (e) {
+      continue;
+    }
+    freedBytes += item.sizeBytes;
+    removed.push(item.id);
+  }
+  return { removed, freedBytes, items: removed.length };
+}
+
+// ---------- HTTP route ----------
+
+function readBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    req.on("data", (chunk) => chunks.push(chunk));
+    req.on("end", () => {
+      try {
+        resolve(Buffer.concat(chunks).toString("utf8"));
+      } catch (e) {
+        reject(e);
+      }
+    });
+    req.on("error", reject);
+  });
+}
+
+function sendJson(res, status, payload) {
+  res.writeHead(status, {
+    "content-type": "application/json; charset=utf-8",
+    "cache-control": "no-store"
+  });
+  res.end(JSON.stringify(payload));
+}
+
+export function apply(ctx) {
+  const handlers = {
+    list: () => handleList(ctx),
+    unarchive: (args) => handleUnarchive(ctx, args),
+    delete: (args) => handleDelete(ctx, args),
+    detail: (args) => handleDetail(ctx, args),
+    orphans: () => handleOrphans(ctx),
+    sweep: () => handleSweep(ctx)
+  };
+
+  async function handler(req, res) {
+    if ((req.method || "") !== "POST") {
+      sendJson(res, 405, { error: "method not allowed" });
+      return;
+    }
+    const pathname = (req.url || "").split("?")[0].replace(/\/+$/, "");
+    let action = null;
+    for (const key of Object.keys(handlers)) {
+      if (pathname === "/dsh-archived/" + key) {
+        action = key;
+        break;
+      }
+    }
+    if (action === null) {
+      sendJson(res, 404, { error: "not found" });
+      return;
+    }
+    let body = {};
+    try {
+      const raw = await readBody(req);
+      if (raw.trim().length > 0) body = JSON.parse(raw);
+    } catch (e) {
+      sendJson(res, 400, { error: "invalid JSON body" });
+      return;
+    }
+    try {
+      sendJson(res, 200, await handlers[action](body));
+    } catch (e) {
+      sendJson(res, 500, { error: (e && e.message) || String(e) });
+    }
+  }
+
+  ctx.webServer.register({
+    kind: "prefix",
+    path: "/dsh-archived",
+    handler
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omdp/dsh-archived-sessions",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Archived-sessions manager for the DeepSeek Harness web UI: list / unarchive / delete / detail from Settings. · DSH 归档会话管理：设置页查看、释放、删除已归档会话（含按树删除子会话与孤儿清理）。",
   "type": "module",
   "main": "lib/index.js",