@tobycaimf/dsh-archived-sessions 1.0.0

package/lib/index.js

@@ -0,0 +1,280 @@
+// src/index.js
+import { unlink } from "node:fs/promises";
+var name = "dsh-archived-sessions";
+var inject = ["webServer", "workspaceRegistry", "sessionPersistence", "sessionQuery", "storageDomain"];
+var MAX_TITLE = 80;
+function json(res, value, status = 200) {
+  res.writeHead(status, { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" });
+  res.end(JSON.stringify(value));
+}
+async function readJsonBody(req) {
+  const chunks = [];
+  let total = 0;
+  for await (const chunk of req) {
+    chunks.push(chunk);
+    total += chunk.length;
+    if (total > 1 << 20) return null;
+  }
+  try {
+    return JSON.parse(Buffer.concat(chunks).toString("utf8"));
+  } catch {
+    return null;
+  }
+}
+function parseIds(body) {
+  const raw = body && body.sessionIds;
+  if (!Array.isArray(raw)) return null;
+  const ids = [];
+  for (const v of raw) if (typeof v === "string" && v) ids.push(v);
+  return ids;
+}
+function foldTitle(events) {
+  let found = null;
+  let firstUser = null;
+  for (const ev of events) {
+    if (ev.type === "session/title" && ev.data && typeof ev.data.title === "string" && ev.data.title.length) {
+      found = ev.data.title;
+    }
+    if (firstUser === null && ev.type === "user/message" && ev.data && Array.isArray(ev.data.content)) {
+      const txt = ev.data.content.filter((b) => b && b.type === "text").map((b) => b.text).filter(Boolean).join(" ").trim();
+      if (txt) firstUser = txt;
+    }
+  }
+  return found || firstUser || null;
+}
+function apply(ctx) {
+  const w = ctx.workspaceRegistry;
+  const sp = ctx.sessionPersistence;
+  const sq = ctx.sessionQuery;
+  const dom = () => ctx.storageDomain.get("workspace");
+  async function archivedState() {
+    const d = dom();
+    if (!d) throw new Error("workspace domain is not open");
+    return d.global.get();
+  }
+  async function writeArchived(nextIds) {
+    const d = dom();
+    if (!d) throw new Error("workspace domain is not open");
+    const cur = d.global.get();
+    const next = Object.assign({}, cur, { archivedSessionIds: nextIds });
+    await d.global.set(next);
+    if (w && "state" in w) {
+      try {
+        w.state = next;
+      } catch (e) {
+      }
+    }
+    return next;
+  }
+  let wsByPath = {};
+  async function resolveOne(id) {
+    let title = null, createdAt = null, cwd = null;
+    try {
+      const o = await sq.readTitleSnapshot(id);
+      if (o) {
+        if (o.title && o.title.title) title = String(o.title.title);
+        if (o.session) {
+          cwd = o.session.cwd || null;
+          createdAt = o.session.createdAt || null;
+        }
+      }
+    } catch (e) {
+    }
+    if (!title || !cwd) {
+      try {
+        const r = await sp.readFrom(id, 0);
+        if (r.meta) {
+          if (!cwd) cwd = r.meta.cwd || null;
+          if (!createdAt) createdAt = r.meta.createdAt || null;
+        }
+        if (!title && Array.isArray(r.events)) title = foldTitle(r.events);
+      } catch (e2) {
+      }
+    }
+    const ws = cwd ? wsByPath[cwd] : void 0;
+    const workspaceGone = !!(cwd && !ws);
+    const display = title ? String(title).length > MAX_TITLE ? String(title).slice(0, MAX_TITLE) + "\u2026" : String(title) : null;
+    return {
+      sessionId: id,
+      title: display,
+      createdAt: createdAt || null,
+      workspacePath: cwd || null,
+      workspaceTitle: ws && ws.title ? ws.title : null,
+      workspaceGone: workspaceGone ? true : false,
+      hasWorkspace: !!cwd
+    };
+  }
+  async function restoreOne(sid) {
+    const state = await archivedState();
+    const list = state.archivedSessionIds.map(String);
+    if (!list.includes(sid)) return { ok: true, restored: false };
+    await writeArchived(list.filter((x) => x !== sid));
+    return { ok: true, restored: true };
+  }
+  async function deleteOne(sid) {
+    const sessions = ctx.get("sessions");
+    if (sessions && sessions.get(sid)) {
+      throw new Error("\u8BE5\u4F1A\u8BDD\u5F53\u524D\u5904\u4E8E\u6253\u5F00\u72B6\u6001\uFF0C\u8BF7\u5148\u5207\u6362\u5230\u522B\u7684\u4F1A\u8BDD\u518D\u5220\u9664\u3002");
+    }
+    let removedPath = null;
+    try {
+      const headers = await sp.list();
+      const header = headers.find((h) => String(h.id) === sid);
+      if (header) {
+        const loc = sp.locate(header);
+        if (loc && typeof loc.path === "string") removedPath = loc.path;
+      } else {
+        const r = await sp.readFrom(sid, 0);
+        if (r && r.meta && r.meta.cwd) {
+          const loc = sp.locate({ id: sid, cwd: r.meta.cwd });
+          if (loc && typeof loc.path === "string") removedPath = loc.path;
+        }
+      }
+    } catch (e) {
+    }
+    if (removedPath) {
+      try {
+        await unlink(removedPath);
+      } catch (e) {
+        if (e && e.code !== "ENOENT") throw new Error("\u5220\u9664\u65E5\u5FD7\u6587\u4EF6\u5931\u8D25\uFF1A" + String(e && e.message || e));
+      }
+    }
+    try {
+      for (const ent of w.list()) {
+        if (ent.sessionIds.includes(sid)) {
+          try {
+            await ent.detachSession(sid);
+          } catch (e) {
+          }
+        }
+      }
+    } catch (e) {
+    }
+    try {
+      if (w.sessionPaths && w.sessionPaths.delete) w.sessionPaths.delete(sid);
+    } catch (e) {
+    }
+    try {
+      if (w.headers && w.headers.delete) w.headers.delete(sid);
+    } catch (e) {
+    }
+    return { ok: true, deleted: true, removedPath };
+  }
+  ctx.effect(() => {
+    const disposers = [];
+    disposers.push(ctx.webServer.register({
+      kind: "exact",
+      path: "/archived-sessions/list",
+      handler: async (req, res) => {
+        try {
+          const state = await archivedState();
+          const ids = state.archivedSessionIds || [];
+          let materialized = /* @__PURE__ */ new Set();
+          let live = ctx.get("sessions");
+          try {
+            const headers = await sp.list();
+            materialized = new Set(headers.map((h) => String(h.id)));
+          } catch (e) {
+          }
+          const idStrs = ids.map(String).filter((id) => materialized.has(id) || live && live.get(id));
+          wsByPath = {};
+          try {
+            for (const ent of w.list()) wsByPath[ent.path] = ent;
+          } catch (e) {
+            wsByPath = {};
+          }
+          const items = [];
+          const CHUNK = 6;
+          for (let i = 0; i < idStrs.length; i += CHUNK) {
+            const res2 = await Promise.all(idStrs.slice(i, i + CHUNK).map(resolveOne));
+            items.push.apply(items, res2);
+          }
+          json(res, { items });
+        } catch (e) {
+          json(res, { error: String(e && e.message || e) }, 500);
+        }
+      }
+    }));
+    disposers.push(ctx.webServer.register({
+      kind: "exact",
+      path: "/archived-sessions/restore",
+      handler: async (req, res) => {
+        try {
+          const body = await readJsonBody(req);
+          const sid = body && typeof body.sessionId === "string" ? body.sessionId : null;
+          if (!sid) return json(res, { ok: false, error: "missing sessionId" }, 400);
+          json(res, await restoreOne(sid));
+        } catch (e) {
+          json(res, { ok: false, error: String(e && e.message || e) }, 500);
+        }
+      }
+    }));
+    disposers.push(ctx.webServer.register({
+      kind: "exact",
+      path: "/archived-sessions/restore-many",
+      handler: async (req, res) => {
+        try {
+          const body = await readJsonBody(req);
+          const ids = parseIds(body);
+          if (!ids || ids.length === 0) return json(res, { ok: false, error: "missing sessionIds" }, 400);
+          const results = [];
+          for (const sid of ids) {
+            try {
+              results.push({ sessionId: sid, ok: true, ...await restoreOne(sid) });
+            } catch (e) {
+              results.push({ sessionId: sid, ok: false, error: String(e && e.message || e) });
+            }
+          }
+          json(res, { ok: true, restored: results.filter((r) => r.ok).length, results });
+        } catch (e) {
+          json(res, { ok: false, error: String(e && e.message || e) }, 500);
+        }
+      }
+    }));
+    disposers.push(ctx.webServer.register({
+      kind: "exact",
+      path: "/archived-sessions/delete",
+      handler: async (req, res) => {
+        try {
+          const body = await readJsonBody(req);
+          const sid = body && typeof body.sessionId === "string" ? body.sessionId : null;
+          if (!sid) return json(res, { ok: false, error: "missing sessionId" }, 400);
+          json(res, await deleteOne(sid));
+        } catch (e) {
+          json(res, { ok: false, error: String(e && e.message || e) }, 500);
+        }
+      }
+    }));
+    disposers.push(ctx.webServer.register({
+      kind: "exact",
+      path: "/archived-sessions/delete-many",
+      handler: async (req, res) => {
+        try {
+          const body = await readJsonBody(req);
+          const ids = parseIds(body);
+          if (!ids || ids.length === 0) return json(res, { ok: false, error: "missing sessionIds" }, 400);
+          const results = [];
+          for (const sid of ids) {
+            try {
+              results.push({ sessionId: sid, ok: true, ...await deleteOne(sid) });
+            } catch (e) {
+              results.push({ sessionId: sid, ok: false, error: String(e && e.message || e) });
+            }
+          }
+          json(res, { ok: true, deleted: results.filter((r) => r.ok).length, results });
+        } catch (e) {
+          json(res, { ok: false, error: String(e && e.message || e) }, 500);
+        }
+      }
+    }));
+    return () => {
+      for (const d of disposers) d();
+    };
+  }, "dsh-archived-sessions: routes");
+}
+export {
+  apply,
+  inject,
+  name
+};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.js"],
+  "sourcesContent": ["// dsh-archived-sessions \u2014 host half.\n//\n// Serves /archived-sessions/* JSON routes (list / restore / restore-many /\n// delete / delete-many) over the host `webServer`. The browser Settings\n// section (\"\u5F52\u6863\u4F1A\u8BDD\") talks to these. Reads/writes the durable workspace\n// archive set (workspaceRegistry + storageDomain), folds titles/dates/workspace\n// tags from session persistence, and physically removes a session's log file\n// on delete.\nimport { unlink } from 'node:fs/promises'\n\nexport const name = 'dsh-archived-sessions'\nexport const inject = ['webServer', 'workspaceRegistry', 'sessionPersistence', 'sessionQuery', 'storageDomain']\n\nconst MAX_TITLE = 80\n\nfunction json(res, value, status = 200) {\n  res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' })\n  res.end(JSON.stringify(value))\n}\n\nasync function readJsonBody(req) {\n  const chunks = []\n  let total = 0\n  for await (const chunk of req) {\n    chunks.push(chunk)\n    total += chunk.length\n    if (total > 1 << 20) return null\n  }\n  try {\n    return JSON.parse(Buffer.concat(chunks).toString('utf8'))\n  } catch {\n    return null\n  }\n}\n\nfunction parseIds(body) {\n  const raw = body && body.sessionIds\n  if (!Array.isArray(raw)) return null\n  const ids = []\n  for (const v of raw) if (typeof v === 'string' && v) ids.push(v)\n  return ids\n}\n\nfunction foldTitle(events) {\n  let found = null\n  let firstUser = null\n  for (const ev of events) {\n    if (ev.type === 'session/title' && ev.data && typeof ev.data.title === 'string' && ev.data.title.length) {\n      found = ev.data.title\n    }\n    if (firstUser === null && ev.type === 'user/message' && ev.data && Array.isArray(ev.data.content)) {\n      const txt = ev.data.content.filter((b) => b && b.type === 'text').map((b) => b.text).filter(Boolean).join(' ').trim()\n      if (txt) firstUser = txt\n    }\n  }\n  return found || firstUser || null\n}\n\nexport function apply(ctx) {\n  const w = ctx.workspaceRegistry\n  const sp = ctx.sessionPersistence\n  const sq = ctx.sessionQuery\n  const dom = () => ctx.storageDomain.get('workspace')\n\n  async function archivedState() {\n    const d = dom()\n    if (!d) throw new Error('workspace domain is not open')\n    return d.global.get()\n  }\n\n  async function writeArchived(nextIds) {\n    const d = dom()\n    if (!d) throw new Error('workspace domain is not open')\n    const cur = d.global.get()\n    const next = Object.assign({}, cur, { archivedSessionIds: nextIds })\n    await d.global.set(next)\n    // Keep the registry's in-memory cache in sync so the live sidebar refreshes.\n    if (w && 'state' in w) { try { w.state = next } catch (e) { /* best-effort */ } }\n    return next\n  }\n\n  let wsByPath = {}\n\n  async function resolveOne(id) {\n    let title = null, createdAt = null, cwd = null\n    try {\n      const o = await sq.readTitleSnapshot(id)\n      if (o) {\n        if (o.title && o.title.title) title = String(o.title.title)\n        if (o.session) { cwd = o.session.cwd || null; createdAt = o.session.createdAt || null }\n      }\n    } catch (e) { /* fall back to raw log */ }\n    if (!title || !cwd) {\n      try {\n        const r = await sp.readFrom(id, 0)\n        if (r.meta) {\n          if (!cwd) cwd = r.meta.cwd || null\n          if (!createdAt) createdAt = r.meta.createdAt || null\n        }\n        if (!title && Array.isArray(r.events)) title = foldTitle(r.events)\n      } catch (e2) { /* keep what we have */ }\n    }\n    const ws = cwd ? wsByPath[cwd] : undefined\n    const workspaceGone = !!(cwd && !ws)\n    const display = title ? (String(title).length > MAX_TITLE ? String(title).slice(0, MAX_TITLE) + '\u2026' : String(title)) : null\n    return {\n      sessionId: id,\n      title: display,\n      createdAt: createdAt || null,\n      workspacePath: cwd || null,\n      workspaceTitle: (ws && ws.title) ? ws.title : null,\n      workspaceGone: workspaceGone ? true : false,\n      hasWorkspace: !!cwd,\n    }\n  }\n\n  // Restore (unarchive) one session; throws on failure.\n  async function restoreOne(sid) {\n    const state = await archivedState()\n    const list = state.archivedSessionIds.map(String)\n    if (!list.includes(sid)) return { ok: true, restored: false }\n    await writeArchived(list.filter((x) => x !== sid))\n    return { ok: true, restored: true }\n  }\n\n  // Physically delete one session log + clear archive/workspace accounting;\n  // throws on failure (live sessions are rejected).\n  async function deleteOne(sid) {\n    const sessions = ctx.get('sessions')\n    if (sessions && sessions.get(sid)) {\n      throw new Error('\u8BE5\u4F1A\u8BDD\u5F53\u524D\u5904\u4E8E\u6253\u5F00\u72B6\u6001\uFF0C\u8BF7\u5148\u5207\u6362\u5230\u522B\u7684\u4F1A\u8BDD\u518D\u5220\u9664\u3002')\n    }\n    let removedPath = null\n    try {\n      const headers = await sp.list()\n      const header = headers.find((h) => String(h.id) === sid)\n      if (header) {\n        const loc = sp.locate(header)\n        if (loc && typeof loc.path === 'string') removedPath = loc.path\n      } else {\n        // Session not in the materialized list \u2014 use its header cwd to locate the log anyway.\n        const r = await sp.readFrom(sid, 0)\n        if (r && r.meta && r.meta.cwd) {\n          const loc = sp.locate({ id: sid, cwd: r.meta.cwd })\n          if (loc && typeof loc.path === 'string') removedPath = loc.path\n        }\n      }\n    } catch (e) { /* best-effort */ }\n    if (removedPath) {\n      try {\n        await unlink(removedPath)\n      } catch (e) {\n        if (e && e.code !== 'ENOENT') throw new Error('\u5220\u9664\u65E5\u5FD7\u6587\u4EF6\u5931\u8D25\uFF1A' + String((e && e.message) || e))\n      }\n    }\n    try {\n      for (const ent of w.list()) {\n        if (ent.sessionIds.includes(sid)) { try { await ent.detachSession(sid) } catch (e) { /* ignore */ } }\n      }\n    } catch (e) { /* ignore */ }\n    try { if (w.sessionPaths && w.sessionPaths.delete) w.sessionPaths.delete(sid) } catch (e) {}\n    try { if (w.headers && w.headers.delete) w.headers.delete(sid) } catch (e) {}\n    // NOTE: intentionally do NOT unarchive (keep the id in the archive set).\n    // Removing it from the archive set would make DSH re-show the session in the\n    // sidebar; with its workspace gone it would land in \u672A\u5206\u7EC4 until the index\n    // rebuilds. Keeping it hidden keeps the deleted session out of every list\n    // immediately. The stale hidden id is inert (no log -> no session resolves).\n    return { ok: true, deleted: true, removedPath }\n  }\n\n  ctx.effect(() => {\n    const disposers = []\n\n    disposers.push(ctx.webServer.register({\n      kind: 'exact',\n      path: '/archived-sessions/list',\n      handler: async (req, res) => {\n        try {\n          const state = await archivedState()\n          const ids = state.archivedSessionIds || []\n          // Only surface archived ids that still exist (materialized log or live).\n          // Deleted sessions keep a hidden archive id but no log, so they drop out here.\n          let materialized = new Set()\n          let live = ctx.get('sessions')\n          try {\n            const headers = await sp.list()\n            materialized = new Set(headers.map((h) => String(h.id)))\n          } catch (e) { /* best-effort */ }\n          const idStrs = ids.map(String).filter((id) => materialized.has(id) || (live && live.get(id)))\n          wsByPath = {}\n          try { for (const ent of w.list()) wsByPath[ent.path] = ent } catch (e) { wsByPath = {} }\n          const items = []\n          const CHUNK = 6\n          for (let i = 0; i < idStrs.length; i += CHUNK) {\n            const res2 = await Promise.all(idStrs.slice(i, i + CHUNK).map(resolveOne))\n            items.push.apply(items, res2)\n          }\n          json(res, { items })\n        } catch (e) {\n          json(res, { error: String((e && e.message) || e) }, 500)\n        }\n      },\n    }))\n\n    disposers.push(ctx.webServer.register({\n      kind: 'exact',\n      path: '/archived-sessions/restore',\n      handler: async (req, res) => {\n        try {\n          const body = await readJsonBody(req)\n          const sid = body && typeof body.sessionId === 'string' ? body.sessionId : null\n          if (!sid) return json(res, { ok: false, error: 'missing sessionId' }, 400)\n          json(res, await restoreOne(sid))\n        } catch (e) {\n          json(res, { ok: false, error: String((e && e.message) || e) }, 500)\n        }\n      },\n    }))\n\n    disposers.push(ctx.webServer.register({\n      kind: 'exact',\n      path: '/archived-sessions/restore-many',\n      handler: async (req, res) => {\n        try {\n          const body = await readJsonBody(req)\n          const ids = parseIds(body)\n          if (!ids || ids.length === 0) return json(res, { ok: false, error: 'missing sessionIds' }, 400)\n          const results = []\n          for (const sid of ids) {\n            try { results.push({ sessionId: sid, ok: true, ...(await restoreOne(sid)) }) }\n            catch (e) { results.push({ sessionId: sid, ok: false, error: String((e && e.message) || e) }) }\n          }\n          json(res, { ok: true, restored: results.filter((r) => r.ok).length, results })\n        } catch (e) {\n          json(res, { ok: false, error: String((e && e.message) || e) }, 500)\n        }\n      },\n    }))\n\n    disposers.push(ctx.webServer.register({\n      kind: 'exact',\n      path: '/archived-sessions/delete',\n      handler: async (req, res) => {\n        try {\n          const body = await readJsonBody(req)\n          const sid = body && typeof body.sessionId === 'string' ? body.sessionId : null\n          if (!sid) return json(res, { ok: false, error: 'missing sessionId' }, 400)\n          json(res, await deleteOne(sid))\n        } catch (e) {\n          json(res, { ok: false, error: String((e && e.message) || e) }, 500)\n        }\n      },\n    }))\n\n    disposers.push(ctx.webServer.register({\n      kind: 'exact',\n      path: '/archived-sessions/delete-many',\n      handler: async (req, res) => {\n        try {\n          const body = await readJsonBody(req)\n          const ids = parseIds(body)\n          if (!ids || ids.length === 0) return json(res, { ok: false, error: 'missing sessionIds' }, 400)\n          const results = []\n          for (const sid of ids) {\n            try { results.push({ sessionId: sid, ok: true, ...(await deleteOne(sid)) }) }\n            catch (e) { results.push({ sessionId: sid, ok: false, error: String((e && e.message) || e) }) }\n          }\n          json(res, { ok: true, deleted: results.filter((r) => r.ok).length, results })\n        } catch (e) {\n          json(res, { ok: false, error: String((e && e.message) || e) }, 500)\n        }\n      },\n    }))\n\n    return () => { for (const d of disposers) d() }\n  }, 'dsh-archived-sessions: routes')\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@tobycaimf/dsh-archived-sessions",
+  "description": "DSH 设置面板「归档会话」管理器：查看、恢复、彻底删除已归档的 session，带所属工作区标签与会话日期。",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "node build.mjs"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-workspace": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-query": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "react": "^18.2.0"
+  }
+}

package/scripts/check-session-health.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+// dsh-sessions-manager — session log health check.
+//
+// Scans every session.jsonl.zstd under ~/.dsh/sessions and verifies that each
+// log's first zstd frame is exactly one session-header line. This is the
+// invariant DSH's persistence layer enforces on startup
+// (assertZstdHeaderFrame): when it breaks, the workspace plugin fails to load
+// and the whole web profile refuses to start.
+//
+// Usage:  node scripts/check-session-health.mjs
+// Exit:   0 = all healthy, 1 = at least one damaged log
+
+import { readFileSync } from 'node:fs'
+import { execSync } from 'node:child_process'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { findZstdFrameStarts, readFrame0 } from '../src/zstd-frame.js'
+
+const root = join(homedir(), '.dsh', 'sessions')
+
+let files
+try {
+  files = execSync(`find "${root}" -name "session.jsonl.zstd"`, { encoding: 'utf8' })
+    .trim()
+    .split('\n')
+    .filter(Boolean)
+} catch (_) {
+  console.log('未找到会话目录:', root)
+  process.exit(0)
+}
+
+if (files.length === 0) {
+  console.log('没有找到会话日志文件')
+  process.exit(0)
+}
+
+let damaged = 0
+for (const file of files) {
+  try {
+    const buf = readFileSync(file)
+    const { obj, lineCount } = readFrame0(buf)
+    const label = file.replace(homedir(), '~')
+    if (obj.type !== 'session') {
+      console.log(`✗ ${label}`)
+      console.log(`    frame0 type=${obj.type}（期望 session）`)
+      damaged++
+    } else if (lineCount !== 1) {
+      console.log(`✗ ${label}`)
+      console.log(`    frame0 有 ${lineCount} 行（期望 1）`)
+      damaged++
+    }
+  } catch (e) {
+    console.log(`✗ ${file.replace(homedir(), '~')}`)
+    console.log(`    ${e.message}`)
+    damaged++
+  }
+}
+
+console.log('')
+if (damaged === 0) {
+  console.log(`✓ 全部正常：${files.length} 个会话日志，frame0 均为单行 session header`)
+  process.exit(0)
+}
+console.log(`✗ ${damaged}/${files.length} 个会话日志损坏`)
+console.log('  损坏的日志会让 dsm web 无法启动。备份后删除对应文件即可恢复。')
+process.exit(1)

package/src/client/index.jsx

@@ -0,0 +1,204 @@
+/**
+ * dsh-archived-sessions — browser half: renders the "归档会话" Settings
+ * section (settings.section list slot). It talks to the host half's
+ * /archived-sessions/* JSON routes (list / restore / delete) by fetch,
+ * showing title, session date, and a workspace tag (handles deleted
+ * workspaces). All DOM/runtime wiring failures are logged, never thrown — a
+ * thrown plugin apply takes down the whole web-shell boot.
+ *
+ * @module dsh-archived-sessions/client
+ */
+
+import React, { useEffect, useRef, useState } from 'react'
+
+export const inject = ['slots']
+
+const CSS = `
+.archv{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-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:10px;color:var(--dsw-alias-state-error-primary);font-size:12px;margin-bottom:10px}
+.archv-errretry{appearance:none;border:1px solid color-mix(in srgb,var(--dsw-alias-state-error-primary) 45%,transparent);background:transparent;color:inherit;border-radius:8px;padding:4px 10px;font-size:11px;cursor:pointer;flex:none}
+.archv-errretry:focus-visible,.archv-btn:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}
+.archv-list{display:flex;flex-direction:column;gap:8px}
+.archv-card{display:flex;align-items:center;justify-content:space-between;gap:14px;padding:12px 14px;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;background:var(--dsw-alias-fill-elevated);transition:border-color .15s ease,background-color .15s ease}
+.archv-card:hover{border-color:var(--dsw-alias-border-l4)}
+.archv-main{min-width:0;display:flex;flex-direction:column;gap:4px}
+.archv-name{font-size:13px;font-weight:550;color:var(--dsw-alias-label-primary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.archv-meta{display:flex;align-items:center;gap:7px;flex-wrap:wrap;min-width:0}
+.archv-wtag{display:inline-flex;align-items:center;gap:4px;max-width:100%;font-size:11px;font-weight:500;line-height:1;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-fill-subtle);border:1px solid var(--dsw-alias-border-l2);border-radius:999px;padding:3px 8px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.archv-wgone{border-style:dashed;color:var(--dsw-alias-state-error-primary);border-color:color-mix(in srgb,var(--dsw-alias-state-error-primary) 55%,transparent);background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 7%,transparent)}
+.archv-date{font-size:11px;color:var(--dsw-alias-label-tertiary);white-space:nowrap;flex:none}
+.archv-id{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:10.5px;color:var(--dsw-alias-label-tertiary);flex:none}
+.archv-dot{color:var(--dsw-alias-border-l3);flex:none}
+.archv-actions{display:flex;gap:8px;flex:none}
+.archv-btn{appearance:none;min-height:32px;padding:0 12px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-fill-subtle);color:var(--dsw-alias-label-secondary);border-radius:9px;font-size:12px;font-weight:500;cursor:pointer;display:inline-flex;align-items:center;gap:6px;transition:background-color .15s ease,border-color .15s ease,color .15s ease}
+.archv-btn:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}
+.archv-btn:disabled{opacity:.5;cursor:default}
+.archv-restore{min-width:62px;justify-content:center}
+.archv-del{color:var(--dsw-alias-state-error-primary);border-color:color-mix(in srgb,var(--dsw-alias-state-error-primary) 45%,transparent)}
+.archv-del:hover:not(:disabled){background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,transparent);color:var(--dsw-alias-state-error-primary)}
+.archv-empty{display:flex;align-items:center;gap:10px;padding:20px 14px;border:1px dashed var(--dsw-alias-border-l3);border-radius:12px;color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}
+.archv-skel{display:flex;flex-direction:column;gap:8px}
+.archv-skel-card{height:58px;border-radius:12px;background:var(--dsw-alias-fill-subtle);position:relative;overflow:hidden}
+.archv-skel-card::after{content:'';position:absolute;inset:0;transform:translateX(-100%);background:linear-gradient(90deg,transparent,color-mix(in srgb,var(--dsw-alias-fill-elevated) 75%,transparent),transparent);animation:archv-shimmer 1.4s infinite}
+.archv-status{position:fixed;bottom:20px;left:50%;transform:translateX(-50%);z-index:60;background:var(--dsw-alias-fill-elevated);border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);padding:9px 16px;border-radius:999px;font-size:12px;box-shadow:0 8px 24px rgb(0 0 0/.18);display:flex;align-items:center;gap:8px;animation:archv-pop .18s ease-out;max-width:min(90vw,420px)}
+.archv-spin{width:12px;height:12px;border:2px solid color-mix(in srgb,var(--dsw-alias-label-secondary) 35%,transparent);border-top-color:var(--dsw-alias-label-secondary);border-radius:50%;animation:archv-rot .8s linear infinite;flex:none}
+@keyframes archv-shimmer{100%{transform:translateX(100%)}}
+@keyframes archv-rot{to{transform:rotate(360deg)}}
+@keyframes archv-pop{from{opacity:0;transform:translateX(-50%) translateY(10px)}}
+@media (prefers-reduced-motion:reduce){.archv-skel-card::after{animation:none}.archv-card,.archv-btn{transition:none}.archv-status,.archv-spin{animation:none}}
+@media (max-width:560px){.archv-card{flex-direction:column;align-items:stretch;gap:10px}.archv-actions{justify-content:flex-end}}
+`
+
+function fmtDate(iso) {
+  if (!iso) return null
+  const d = new Date(iso)
+  if (isNaN(d.getTime())) return null
+  try {
+    return new Intl.DateTimeFormat('zh-CN', { year: 'numeric', month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' }).format(d)
+  } catch {
+    return String(iso)
+  }
+}
+
+function pathName(p) {
+  if (!p) return null
+  const parts = String(p).replace(/\\+$/, '').split(/[/\\]/)
+  return parts[parts.length - 1] || p
+}
+
+async function postJSON(path, body) {
+  const res = await fetch(path, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json', accept: 'application/json' },
+    body: JSON.stringify(body || {}),
+  })
+  const data = await res.json().catch(() => null)
+  if (!res.ok || !data) throw new Error((data && (data.error || data.message)) || `request failed (${res.status})`)
+  return data
+}
+
+function ArchivedPanel() {
+  const [items, setItems] = useState(null)
+  const [busy, setBusy] = useState(null)
+  const [confirmId, setConfirmId] = useState(null)
+  const [error, setError] = useState(null)
+  const [toast, setToast] = useState(null)
+  const timer = useRef(null)
+
+  const showToast = (msg) => {
+    if (timer.current) clearTimeout(timer.current)
+    setToast(msg)
+    timer.current = setTimeout(() => setToast(null), 2400)
+  }
+
+  const refresh = () => {
+    setError(null)
+    postJSON('/archived-sessions/list', {})
+      .then((r) => setItems(r.items || []))
+      .catch((e) => setError(String((e && e.message) || e)))
+  }
+
+  useEffect(() => {
+    refresh()
+    return () => { if (timer.current) clearTimeout(timer.current) }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [])
+
+  const act = (action, it) => {
+    if (busy) return
+    if (action === 'delete') {
+      if (confirmId !== it.sessionId) { setConfirmId(it.sessionId); return }
+      setConfirmId(null)
+    } else { setConfirmId(null); setError(null) }
+    setBusy(it.sessionId)
+    postJSON('/archived-sessions/' + action, { sessionId: it.sessionId })
+      .then(() => {
+        setBusy(null)
+        showToast(action === 'restore' ? `已恢复「${it.title || it.sessionId}」` : `已删除 ${it.title || it.sessionId}`)
+        refresh()
+      })
+      .catch((e) => { setBusy(null); setConfirmId(null); setError(String((e && e.message) || e)) })
+  }
+
+  const workspaceTag = (it) => {
+    if (it.hasWorkspace && it.workspaceGone) {
+      return (
+        <span className="archv-wtag archv-wgone" title={(it.workspacePath || '') + '（原工作区已删除）'}>
+          工作区已删 · {pathName(it.workspacePath) || '?'}
+        </span>
+      )
+    }
+    const wName = it.workspaceTitle || pathName(it.workspacePath)
+    if (wName) return <span className="archv-wtag" title={it.workspacePath || ''}>{wName}</span>
+    return null
+  }
+
+  return (
+    <div className="archv" role="region" aria-label="归档会话">
+      <style>{CSS}</style>
+      <div className="archv-head">
+        <h2 className="archv-title">归档会话</h2>
+        {items !== null && <span className="archv-count" aria-label={`${items.length} 个归档会话`}>{items.length}</span>}
+      </div>
+      <p className="archv-sub">
+        被归档（从侧栏隐藏）的会话都在这里。恢复会把会话放回原分组；删除会彻底移除日志文件，不可恢复。
+      </p>
+      {error && (
+        <div className="archv-err" role="alert">
+          <span>{error}</span>
+          <button type="button" className="archv-errretry" onClick={refresh}>重试</button>
+        </div>
+      )}
+      {items === null ? (
+        <div className="archv-skel" aria-label="加载中">
+          {[0, 1, 2].map((i) => <div key={i} className="archv-skel-card" />)}
+        </div>
+      ) : items.length === 0 ? (
+        <div className="archv-empty">目前没有归档会话。在侧栏任一会话的菜单里选择「归档」即可收纳进来。</div>
+      ) : (
+        <div className="archv-list" role="list">
+          {items.map((it) => {
+            const isConfirm = confirmId === it.sessionId
+            const date = fmtDate(it.createdAt)
+            const wtag = workspaceTag(it)
+            return (
+              <div key={it.sessionId} className="archv-card" role="listitem">
+                <div className="archv-main">
+                  <div className="archv-name" title={it.title || ''}>{it.title || '(无标题)'}</div>
+                  <div className="archv-meta">
+                    {date && <span className="archv-date">{date}</span>}
+                    {date && wtag && <span className="archv-dot">·</span>}
+                    {wtag}
+                    <span className="archv-id">{it.sessionId}</span>
+                  </div>
+                </div>
+                <div className="archv-actions">
+                  <button type="button" className="archv-btn archv-restore" disabled={busy !== null} aria-label={'恢复 ' + (it.title || it.sessionId)} onClick={() => act('restore', it)}>
+                    {busy === it.sessionId && <span className="archv-spin" aria-hidden="true" />}恢复
+                  </button>
+                  <button type="button" className="archv-btn archv-del" disabled={busy !== null} aria-label={(isConfirm ? '确认删除 ' : '删除 ') + (it.title || it.sessionId)} onClick={() => act('delete', it)}>
+                    {isConfirm ? '确认删除?' : '删除'}
+                  </button>
+                </div>
+              </div>
+            )
+          })}
+        </div>
+      )}
+      {toast && <div className="archv-status" role="status">{toast}</div>}
+    </div>
+  )
+}
+
+export function apply(ctx) {
+  ctx.slots.inject('settings.section', () =>
+    ctx.slots.register(
+      { name: 'settings.section', id: 'archived-sessions', order: 90, label: '归档会话' },
+      (props) => <ArchivedPanel {...props} />,
+    ),
+  )
+}