@chaoset/session-archive 0.1.2 → 0.2.0

package/client/index.tsx

@@ -0,0 +1,501 @@
+import * as React from "react";
+import type { TypertRemoteContribution } from "@deepseek-ai/dsh-typert-protocol";
+
+// ── 样式（注入 style 标签，复用 DSH 设计变量）────────────────────────
+var css = [
+  ".sa_badge{width:100%;height:49px;color:var(--dsw-alias-label-primary);cursor:pointer;background:0 0;border:none;border-radius:12px;align-items:center;gap:8px;padding:0 8px 0 6px;font-family:inherit;font-size:14px;display:inline-flex;overflow:hidden}",
+  ".sa_badge:hover{background:var(--dsw-alias-interactive-bg-hover)}",
+  ".sa_badgeIcon{flex:none;display:inline-flex;align-items:center;justify-content:center;width:18px;height:18px;color:var(--dsw-alias-label-primary)}",
+  ".sa_badgeIcon svg{width:18px;height:18px;display:block}",
+  ".sa_badgeLabel{text-overflow:ellipsis;white-space:nowrap;min-width:0;overflow:hidden}",
+  ".sa_badgeCount{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;flex:none;margin-left:auto;font-size:12px;line-height:16px}",
+  ".sa_badge--collapsed{width:auto;justify-content:center;padding:0}",
+  ".sa_badge--collapsed .sa_badgeLabel,.sa_badge--collapsed .sa_badgeCount{display:none}",
+  ".sa_panel{z-index:30;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-base);width:440px;max-width:calc(100vw - 24px);max-height:62vh;box-shadow:var(--dsw-shadow-lv2);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border-radius:12px;flex-direction:column;display:flex;position:fixed;bottom:128px;left:12px;overflow:hidden}",
+  ".sa_header{box-sizing:border-box;border-bottom:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-base);flex:none;justify-content:space-between;align-items:center;min-height:44px;padding:8px 12px;display:flex}",
+  ".sa_title{color:var(--dsw-alias-label-primary);font-size:13px;font-weight:500;line-height:20px}",
+  ".sa_iconBtn{font:inherit;cursor:pointer;border:0;border-radius:8px;width:36px;height:36px;color:var(--dsw-alias-label-secondary,#666);background:0 0;display:inline-flex;align-items:center;justify-content:center;font-size:18px}",
+  ".sa_refresh{font:inherit;cursor:pointer;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;min-height:36px;padding:5px 14px;font-size:13px;line-height:20px;background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);display:inline-flex;align-items:center;gap:5px}",
+  ".sa_refresh:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}",
+  ".sa_refresh:disabled{opacity:.4;cursor:default}",
+  ".sa_iconBtn:hover{background:var(--dsw-alias-interactive-bg-hover)}",
+  ".sa_iconBtn:disabled{opacity:.4;cursor:default}",
+  ".sa_toolbar{flex:none;border-bottom:1px solid var(--dsw-alias-border-l2);align-items:center;gap:8px;padding:8px 12px;display:flex;flex-wrap:wrap}",
+  ".sa_check{accent-color:var(--dsw-alias-label-primary);width:14px;height:14px;flex:none;cursor:pointer}",
+  ".sa_check:disabled{cursor:default;opacity:.45}",
+  ".sa_toolLabel{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px;user-select:none;cursor:pointer;display:inline-flex;align-items:center;gap:6px}",
+  ".sa_count{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px;flex:1}",
+  ".sa_action{font:inherit;cursor:pointer;border:1px solid var(--dsw-alias-border-l1);border-radius:6px;padding:3px 10px;font-size:12px;line-height:18px;background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary)}",
+  ".sa_action:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}",
+  ".sa_action:disabled{opacity:.4;cursor:default}",
+  ".sa_actionDanger{border-color:transparent;background:var(--dsw-alias-state-error-primary);color:#fff}",
+  ".sa_actionDanger:hover:not(:disabled){background:var(--dsw-alias-state-error-primary)}",
+  ".sa_actionDanger:disabled{opacity:.4}",
+  ".sa_confirm{color:var(--dsw-alias-state-error-primary);border:1px solid var(--dsw-alias-state-error-primary);background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,transparent)}",
+  ".sa_confirm:hover:not(:disabled){background:var(--dsw-alias-state-error-primary);color:#fff}",
+  ".sa_body{flex:1;min-height:0;padding:4px 12px 12px;overflow-y:auto}",
+  ".sa_empty{color:var(--dsw-alias-label-tertiary);margin:24px 0;text-align:center;font-size:12px;line-height:18px}",
+  ".sa_error{color:var(--dsw-alias-state-error-primary);margin:8px 0;font-size:12px;line-height:18px}",
+  ".sa_rows{flex-direction:column;gap:8px;margin:0;padding:0;list-style:none;display:flex}",
+  ".sa_row{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-base);border-radius:12px;flex-direction:column;gap:6px;padding:8px 10px;display:flex}",
+  ".sa_rowHead{align-items:center;gap:8px;display:flex}",
+  ".sa_rowTitle{min-width:0;color:var(--dsw-alias-label-primary);text-overflow:ellipsis;white-space:nowrap;flex:1;font-size:13px;font-weight:500;line-height:20px;overflow:hidden;cursor:pointer}",
+  ".sa_rowTitle:hover{text-decoration:underline}",
+  ".sa_live{background:var(--dsw-alias-state-warn-tertiary);color:var(--dsw-alias-state-warn-label);height:18px;border-radius:9px;flex:none;align-items:center;padding:0 6px;font-size:11px;line-height:18px;display:inline-flex}",
+  ".sa_rowMeta{color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px;overflow-wrap:anywhere}",
+  ".sa_rowMeta code{font-family:var(--dsh-font-mono,monospace)}",
+  ".sa_rowFoot{justify-content:space-between;align-items:center;gap:8px;display:flex}",
+  ".sa_rowActions{flex:none;align-items:center;gap:8px;display:flex}",
+  ".sa_detail{border-top:1px dashed var(--dsw-alias-border-l2);padding-top:8px;flex-direction:column;gap:6px;display:flex;max-height:260px;overflow-y:auto}",
+  ".sa_msg{flex-direction:column;gap:2px;display:flex}",
+  ".sa_msgRole{color:var(--dsw-alias-label-tertiary);font-size:10px;line-height:14px;text-transform:uppercase;letter-spacing:.04em}",
+  ".sa_msgText{color:var(--dsw-alias-label-primary);white-space:pre-wrap;overflow-wrap:anywhere;font-size:12px;line-height:18px}",
+  ".sa_msgTextUser{color:var(--dsw-alias-label-secondary)}",
+  ".sa_busy{opacity:.55;pointer-events:none}"
+].join("");
+var tagId = "@chaoset/session-archive/client.css";
+if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=\"" + tagId + "\"]") === null) {
+  var tag = document.createElement("style");
+  tag.dataset.plugin = "@chaoset/session-archive";
+  tag.dataset.pluginCss = tagId;
+  tag.textContent = css;
+  document.head.appendChild(tag);
+}
+
+// ── 字典 ─────────────────────────────────────────────────────────────
+const NS = "sidebar.sessionArchive";
+const zh = {
+  badge: "归档",
+  panelTitle: "归档会话",
+  refresh: "刷新",
+  close: "关闭",
+  empty: "暂无归档会话。在会话列表的更多菜单中归档会话后会出现在这里。",
+  loadFailed: "加载归档列表失败",
+  selectAll: "全选",
+  selected: "已选 {n} 项",
+  restore: "恢复所选",
+  restoreDone: "已恢复 {n} 个归档会话",
+  restoreFailed: "恢复失败",
+  delete: "删除所选",
+  deleteConfirm: "再次点击确认删除",
+  deleteDone: "已删除 {n} 个归档会话",
+  deleteFailed: "部分删除失败：{n} 个",
+  confirmAll: "确认删除全部 {n} 个？",
+  noSelection: "请先勾选会话",
+  view: "查看",
+  collapse: "收起",
+  live: "运行中",
+  detailLoadFailed: "读取会话内容失败",
+  noneTitle: "（无标题）",
+  user: "用户",
+  assistant: "助手",
+  messages: "共 {n} 条消息",
+  noMessages: "（无文本消息）",
+  sizeBytes: "{n} B",
+  sizeKB: "{n} KB",
+  sizeMB: "{n} MB",
+  runningHint: "运行中的会话不能删除，请先停止"
+};
+const en = {
+  badge: "Archive",
+  panelTitle: "Archived sessions",
+  refresh: "Refresh",
+  close: "Close",
+  empty: "No archived sessions. Archive a session from its menu in the session list and it will show up here.",
+  loadFailed: "Failed to load archive list",
+  selectAll: "Select all",
+  selected: "{n} selected",
+  restore: "Restore",
+  restoreDone: "Restored {n} archived sessions",
+  restoreFailed: "Restore failed",
+  delete: "Delete",
+  deleteConfirm: "Click again to confirm delete",
+  deleteDone: "Deleted {n} archived sessions",
+  deleteFailed: "Some deletions failed: {n}",
+  confirmAll: "Delete all {n}?",
+  noSelection: "Select sessions first",
+  view: "View",
+  collapse: "Collapse",
+  live: "Running",
+  detailLoadFailed: "Failed to read session content",
+  noneTitle: "(no title)",
+  user: "User",
+  assistant: "Assistant",
+  messages: "{n} messages",
+  noMessages: "(no text messages)",
+  sizeBytes: "{n} B",
+  sizeKB: "{n} KB",
+  sizeMB: "{n} MB",
+  runningHint: "Running sessions cannot be deleted; stop them first"
+};
+
+// ── 工具函数 ─────────────────────────────────────────────────────────
+function formatBytes(bytes: any, t: any) {
+  if (bytes < 1024) return t("sizeBytes").replace("{n}", String(bytes));
+  if (bytes < 1024 * 1024) return t("sizeKB").replace("{n}", (bytes / 1024).toFixed(1));
+  return t("sizeMB").replace("{n}", (bytes / (1024 * 1024)).toFixed(1));
+}
+function formatTime(ms: any) {
+  try { return new Date(ms).toLocaleString(); } catch { return String(ms); }
+}
+function shortId(id: any) {
+  return id.length > 12 ? id.slice(0, 12) + "…" : id;
+}
+
+// ── 归档面板 ─────────────────────────────────────────────────────────
+function ArchivePanel(props: any) {
+  const t = props.t;
+  const call = props.call;
+  // 侧边栏收起（icon rail）时，DSH 通过 wide=false 告知（侧边栏 footer 注入点
+  // 下发的是 wide，而非 collapsed）。以 wide 为准；仅当宿主未下发 wide 时，才用
+  // ResizeObserver 观察所在格宽度（<80px 视为收起）兜底，避免窄格把文字标签挤变形。
+  const wideExplicit = typeof props.wide === "boolean" ? props.wide : void 0;
+  const [narrow, setNarrow] = React.useState(false);
+  const collapsed = wideExplicit === void 0 ? narrow : !wideExplicit;
+  const badgeRef = React.useRef<any>(null);
+  React.useEffect(() => {
+    const el = badgeRef.current?.parentElement;
+    if (el === undefined || el === null || typeof (globalThis as any).ResizeObserver === "undefined") return;
+    const ro = new (globalThis as any).ResizeObserver((entries: any[]) => {
+      for (const entry of entries) {
+        const w = entry.contentRect?.width ?? el.clientWidth;
+        setNarrow(w > 0 && w < 80);
+      }
+    });
+    ro.observe(el);
+    return () => ro.disconnect();
+  }, []);
+  // 有显式 wide 时完全以宿主状态为准，避免 ResizeObserver 的窄格判断在
+  // 展开后仍残留，导致展开态误用 collapsed 样式（图标不居中、文字丢失）。
+  const iconOnly = collapsed;
+  const rootRef = React.useRef<any>(null);
+  const [open, setOpen] = React.useState(false);
+  const [items, setItems] = React.useState<any[]>([]);
+  const [loading, setLoading] = React.useState(false);
+  const [error, setError] = React.useState<any>(null);
+  const [selected, setSelected] = React.useState<Set<any>>(new Set());
+  const [expanded, setExpanded] = React.useState<any>(null);
+  const [details, setDetails] = React.useState<Map<any, any>>(new Map());
+  const [detailLoading, setDetailLoading] = React.useState<Set<any>>(new Set());
+  const [busy, setBusy] = React.useState(false);
+  const [confirmingDelete, setConfirmingDelete] = React.useState(false);
+  const [notice, setNotice] = React.useState<any>(null);
+
+  const load = React.useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await call("list");
+      setItems(Array.isArray(result.items) ? result.items : []);
+    } catch (loadError: any) {
+      setError(t("loadFailed") + ": " + (loadError && loadError.message || loadError));
+    } finally {
+      setLoading(false);
+    }
+  }, [call, t]);
+
+  React.useEffect(() => {
+    if (open) { setNotice(null); load(); }
+  }, [open, load]);
+
+  // 后台静默刷新归档计数：侧边栏徽标要在「聊天列表里出现归档」时就同步显示数量，
+  // 而不是等到打开弹窗才更新。面板打开时由上面的 load() 负责，这里只在关闭态轮询，
+  // 避免刷新打断用户在面板里的勾选/操作；同时监听标签页重新可见。
+  const refreshSilently = React.useCallback(async () => {
+    try {
+      const result = await call("list");
+      setItems(Array.isArray(result.items) ? result.items : []);
+    } catch {}
+  }, [call]);
+  React.useEffect(() => {
+    if (open) return;
+    refreshSilently();
+    const id = globalThis.setInterval(refreshSilently, 5000);
+    const onVis = () => { if (document.visibilityState === "visible") refreshSilently(); };
+    document.addEventListener("visibilitychange", onVis);
+    return () => { clearInterval(id); document.removeEventListener("visibilitychange", onVis); };
+  }, [open, refreshSilently]);
+
+  // 提示（如「已恢复/已删除 N 个会话」）几秒后自动消失，避免残留误导用户，
+  // 也避免删除全部归档后仍挂着上一条提示。
+  React.useEffect(() => {
+    if (notice === null) return;
+    const id = globalThis.setTimeout(() => setNotice(null), 4000);
+    return () => clearTimeout(id);
+  }, [notice]);
+
+  React.useEffect(() => {
+    if (!open) return;
+    const onPointerDown = (event: any) => {
+      if (rootRef.current !== null && !rootRef.current.contains(event.target)) {
+        setOpen(false);
+      }
+    };
+    document.addEventListener("pointerdown", onPointerDown);
+    return () => document.removeEventListener("pointerdown", onPointerDown);
+  }, [open]);
+
+  const selectable = items.filter((item) => !item.live);
+  const allSelected = selectable.length > 0 && selectable.every((item) => selected.has(item.sessionId));
+
+  const toggleAll = (checked: any) => {
+    if (checked) {
+      setSelected(new Set(selectable.map((item) => item.sessionId)));
+    } else {
+      setSelected(new Set());
+    }
+  };
+  const toggleOne = (sessionId: any, checked: any) => {
+    setSelected((current) => {
+      const next = new Set(current);
+      if (checked) next.add(sessionId); else next.delete(sessionId);
+      return next;
+    });
+  };
+
+  const toggleDetail = (item: any) => {
+    if (expanded === item.sessionId) {
+      setExpanded(null);
+      return;
+    }
+    setExpanded(item.sessionId);
+    if (!details.has(item.sessionId)) {
+      setDetailLoading((current) => new Set(current).add(item.sessionId));
+      call("detail", item.sessionId).then((detail: any) => {
+        setDetails((current) => new Map(current).set(item.sessionId, detail));
+      }).catch((detailError: any) => {
+        setDetails((current) => new Map(current).set(item.sessionId, {
+          error: t("detailLoadFailed") + ": " + (detailError && detailError.message || detailError)
+        }));
+      }).finally(() => {
+        setDetailLoading((current) => {
+          const next = new Set(current);
+          next.delete(item.sessionId);
+          return next;
+        });
+      });
+    }
+  };
+
+  const runBatch = async (action: any, doneKey: any, failKey: any) => {
+    const ids = [...selected];
+    if (ids.length === 0) {
+      setNotice({ kind: "warn", text: t("noSelection") });
+      return;
+    }
+    setBusy(true);
+    setNotice(null);
+    try {
+      const result = await call(action, ids);
+      const doneIds = result.deleted || result.restored || [];
+      const n = doneIds.length;
+      if (result.failed && result.failed.length > 0) {
+        setNotice({ kind: "error", text: t(failKey).replace("{n}", String(result.failed.length)) });
+      } else {
+        setNotice({ kind: "ok", text: t(doneKey).replace("{n}", String(n)) });
+      }
+      if (doneIds.length > 0) {
+        const done = new Set(doneIds);
+        setItems((current) => current.filter((item) => !done.has(item.sessionId)));
+      }
+      setSelected(new Set());
+      setConfirmingDelete(false);
+      await load();
+    } catch (actionError: any) {
+      setNotice({ kind: "error", text: t(failKey).replace("{n}", "?") + ": " + (actionError && actionError.message || actionError) });
+    } finally {
+      setBusy(false);
+    }
+  };
+  const restoreSelected = () => runBatch("unarchive", "restoreDone", "restoreFailed");
+  const deleteSelected = () => {
+    if (!confirmingDelete) {
+      setConfirmingDelete(true);
+      window.setTimeout(() => setConfirmingDelete(false), 4000);
+      return;
+    }
+    runBatch("delete", "deleteDone", "deleteFailed");
+  };
+
+  const hasSelection = selected.size > 0;
+
+  return React.createElement(
+    "div",
+    { className: "sa_root", ref: rootRef },
+      React.createElement(
+        "button",
+        {
+          ref: badgeRef,
+          className: "sa_badge" + (iconOnly ? " sa_badge--collapsed" : ""),
+          type: "button",
+          onClick: () => setOpen(!open),
+          "aria-expanded": open,
+          title: t("badge")
+        },
+        React.createElement("span", { className: "sa_badgeIcon", "aria-hidden": true },
+          React.createElement("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round" },
+            React.createElement("rect", { x: 3, y: 4, width: 18, height: 4, rx: 1 }),
+            React.createElement("path", { d: "M5 8v11a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1V8" }),
+            React.createElement("path", { d: "M10 12h4" })
+          )
+        ),
+        iconOnly ? null : React.createElement("span", { className: "sa_badgeLabel" }, t("badge")),
+        iconOnly ? null : React.createElement("span", { className: "sa_badgeCount" }, String(items.length))
+      ),
+    open ? React.createElement(
+      "div",
+      { className: "sa_panel" },
+      React.createElement(
+        "div",
+        { className: "sa_header" },
+        React.createElement("span", { className: "sa_title" }, t("panelTitle")),
+        React.createElement(
+          "span",
+          { style: { display: "inline-flex", gap: "6px", alignItems: "center" } },
+          React.createElement("button", { className: "sa_refresh", type: "button", title: t("refresh"), disabled: busy || loading, onClick: load }, t("refresh")),
+          React.createElement("button", { className: "sa_iconBtn", type: "button", title: t("close"), disabled: busy, onClick: () => setOpen(false) }, "✕")
+        )
+      ),
+      React.createElement(
+        "div",
+        { className: "sa_toolbar" },
+        React.createElement("label", { className: "sa_toolLabel" },
+          React.createElement("input", {
+            className: "sa_check",
+            type: "checkbox",
+            checked: allSelected,
+            disabled: busy || selectable.length === 0,
+            onChange: (e) => toggleAll(e.target.checked)
+          }),
+          t("selectAll")
+        ),
+        React.createElement("span", { className: "sa_count" }, t("selected").replace("{n}", String(selected.size))),
+        React.createElement("button", {
+          className: "sa_action",
+          type: "button",
+          disabled: busy || !hasSelection,
+          onClick: restoreSelected
+        }, t("restore")),
+        React.createElement("button", {
+          className: "sa_action " + (confirmingDelete ? "sa_actionDanger sa_confirm" : "sa_actionDanger"),
+          type: "button",
+          disabled: busy || !hasSelection,
+          onClick: deleteSelected
+        }, confirmingDelete ? t("deleteConfirm") : t("delete"))
+      ),
+      React.createElement(
+        "div",
+        { className: "sa_body" },
+        notice !== null ? React.createElement("p", { className: "sa_error" + (notice.kind === "ok" ? "" : ""), role: "status" }, notice.text) : null,
+        error !== null ? React.createElement("p", { className: "sa_error", role: "alert" }, error) : null,
+        loading && items.length === 0 ? React.createElement("p", { className: "sa_empty" }, "…") : null,
+        !loading && items.length === 0 && error === null ? React.createElement("p", { className: "sa_empty" }, t("empty")) : null,
+        items.length > 0 ? React.createElement(
+          "ul",
+          { className: "sa_rows" },
+          items.map((item) => {
+            const isExpanded = expanded === item.sessionId;
+            const detail = details.get(item.sessionId);
+            const detailPending = detailLoading.has(item.sessionId);
+            return React.createElement(
+              "li",
+              { className: "sa_row" + (busy ? " sa_busy" : ""), key: item.sessionId },
+              React.createElement(
+                "div",
+                { className: "sa_rowHead" },
+                React.createElement("input", {
+                  className: "sa_check",
+                  type: "checkbox",
+                  checked: selected.has(item.sessionId),
+                  disabled: busy || item.live,
+                  title: item.live ? t("runningHint") : void 0,
+                  onChange: (e: any) => toggleOne(item.sessionId, e.target.checked)
+                }),
+                React.createElement(
+                  "span",
+                  { className: "sa_rowTitle", onClick: () => toggleDetail(item), title: t("view") },
+                  item.title !== null && item.title !== void 0 && item.title !== "" ? item.title : t("noneTitle")
+                ),
+                item.live ? React.createElement("span", { className: "sa_live" }, t("live")) : null
+              ),
+              React.createElement("div", { className: "sa_rowMeta" },
+                React.createElement("span", null, formatTime(item.updatedAt)),
+                item.cwd !== null && item.cwd !== void 0 ? React.createElement("span", null, " · ", React.createElement("code", null, item.cwd)) : null,
+                React.createElement("span", null, " · ", formatBytes(item.size, t))
+              ),
+              React.createElement(
+                "div",
+                { className: "sa_rowFoot" },
+                React.createElement("span", { className: "sa_rowMeta" },
+                  React.createElement("code", null, shortId(item.sessionId)),
+                  detail !== void 0 && !detail.error && detail.messageCount !== void 0
+                    ? " · " + t("messages").replace("{n}", String(detail.messageCount))
+                    : null
+                ),
+                React.createElement(
+                  "div",
+                  { className: "sa_rowActions" },
+                  React.createElement("button", {
+                    className: "sa_action",
+                    type: "button",
+                    disabled: busy || detailPending,
+                    onClick: () => toggleDetail(item)
+                  }, isExpanded ? t("collapse") : t("view"))
+                )
+              ),
+              isExpanded ? React.createElement(
+                "div",
+                { className: "sa_detail" },
+                detailPending ? React.createElement("p", { className: "sa_empty" }, "…") : null,
+                detail === void 0 ? null :
+                  detail.error !== void 0 ? React.createElement("p", { className: "sa_error" }, detail.error) :
+                  detail.messages.length === 0 ? React.createElement("p", { className: "sa_empty" }, t("noMessages")) :
+                  detail.messages.map((message: any, index: any) => React.createElement(
+                    "div",
+                    { className: "sa_msg", key: index },
+                    React.createElement("span", { className: "sa_msgRole" }, message.role === "user" ? t("user") : t("assistant") + " · " + formatTime(message.time)),
+                    React.createElement("span", { className: "sa_msgText" + (message.role === "user" ? " sa_msgTextUser" : "") }, message.text)
+                  ))
+              ) : null
+            );
+          })
+        ) : null
+      )
+    ) : null
+  );
+}
+
+// ── 插件 apply ───────────────────────────────────────────────────────
+// DSH 客户端的 remote.<ns> 服务不会自动生成：必须由客户端代码用
+// ctx.remote.$mount(contribution) 显式挂载（官方 dsh-api-remotes 即如此）。
+const inject = ["slots", "locale", "remote"];
+const passthroughSchema = { parse: (value: any) => value };
+const REMOTE_CONTRIBUTION: TypertRemoteContribution = {
+  package: "@chaoset/session-archive",
+  descriptors: [
+    { id: "@chaoset/session-archive#sessionArchive/list", service: "sessionArchive", namespace: "sessionArchive", method: "list", invocation: { kind: "direct" }, parameters: [], result: { mode: "strict", typeSymbol: "sessionArchive/list:result", schema: passthroughSchema } },
+    { id: "@chaoset/session-archive#sessionArchive/detail", service: "sessionArchive", namespace: "sessionArchive", method: "detail", invocation: { kind: "direct" }, parameters: [{ name: "sessionId", wire: "sessionId", source: "json", codec: { mode: "strict", typeSymbol: "sessionArchive/detail:sessionId", schema: passthroughSchema } }], result: { mode: "strict", typeSymbol: "sessionArchive/detail:result", schema: passthroughSchema } },
+    { id: "@chaoset/session-archive#sessionArchive/delete", service: "sessionArchive", namespace: "sessionArchive", method: "delete", invocation: { kind: "direct" }, parameters: [{ name: "sessionIds", wire: "sessionIds", source: "json", codec: { mode: "strict", typeSymbol: "sessionArchive/delete:sessionIds", schema: passthroughSchema } }], result: { mode: "strict", typeSymbol: "sessionArchive/delete:result", schema: passthroughSchema } },
+    { id: "@chaoset/session-archive#sessionArchive/unarchive", service: "sessionArchive", namespace: "sessionArchive", method: "unarchive", invocation: { kind: "direct" }, parameters: [{ name: "sessionIds", wire: "sessionIds", source: "json", codec: { mode: "strict", typeSymbol: "sessionArchive/unarchive:sessionIds", schema: passthroughSchema } }], result: { mode: "strict", typeSymbol: "sessionArchive/unarchive:result", schema: passthroughSchema } }
+  ]
+};
+async function apply(ctx: any) {
+  const t = ctx.locale.bind(NS);
+  ctx.effect(() => ctx.locale.register(NS, { zh, en }), "session-archive: dictionaries");
+  await ctx.remote.$mount(REMOTE_CONTRIBUTION);
+  const archiveService = ctx.get("remote.sessionArchive");
+  if (archiveService === void 0) throw new Error("session-archive: remote.sessionArchive did not materialize after mount");
+  const call = (method: any, ...args: any[]) => archiveService[method](...args).then((result: any) => {
+    if (!result.ok) throw new Error(method + " failed: " + result.error.code + ": " + result.error.message);
+    return result.value;
+  });
+  ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register({
+    name: "sidebar.footer.action",
+    id: "session-archive",
+    order: 20,
+    locale: NS,
+    inject: () => ({ call })
+  }, ArchivePanel));
+}
+
+export { apply, inject };

package/lib/config-store.d.ts

@@ -0,0 +1,32 @@
+/**
+ * config-store — 插件配置持久化
+ *
+ * 配置文件位于 $DSH_HOME/plugins/<name>/config.json（默认 ~/.dsh，与
+ * file:// 部署模式共用）。生效顺序（后者覆盖前者）：
+ *   1. 插件内置默认值（DEFAULT_CONFIG）
+ *   2. cordis.patch.yml 传入的 config（安装时生成的默认块）
+ *   3. config.json（设置页 UI 保存，权威）
+ *
+ * 保存后通过 onUpdate 回调立即热更新运行中的配置（包装闭包读共享 state）。
+ * 写入采用随机临时文件 + fsync + rename，权限 0600；损坏 JSON 只告警并回退。
+ */
+export interface ConfigStoreOptions {
+    name: string;
+    defaults: Record<string, any>;
+    patchConfig: Record<string, any>;
+    onUpdate?: (merged: Record<string, any>, next: Record<string, any>) => void;
+    validate?: (partial: Record<string, any>) => void;
+    warn?: (message: string) => void;
+}
+export interface ConfigStore {
+    file: string;
+    effective(): Record<string, any>;
+    set(partial: Record<string, any>): Record<string, any>;
+}
+/**
+ * 创建配置存储。
+ * @param options - { name, defaults, patchConfig, onUpdate,
+ *   validate?: (partial) => void, warn?: (message) => void }
+ */
+export declare function createConfigStore(options: ConfigStoreOptions): ConfigStore;
+//# sourceMappingURL=config-store.d.ts.map

package/lib/config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../src/config-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAC5E,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAClD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAyE1E"}

package/lib/config-store.js

@@ -0,0 +1,107 @@
+/**
+ * config-store — 插件配置持久化
+ *
+ * 配置文件位于 $DSH_HOME/plugins/<name>/config.json（默认 ~/.dsh，与
+ * file:// 部署模式共用）。生效顺序（后者覆盖前者）：
+ *   1. 插件内置默认值（DEFAULT_CONFIG）
+ *   2. cordis.patch.yml 传入的 config（安装时生成的默认块）
+ *   3. config.json（设置页 UI 保存，权威）
+ *
+ * 保存后通过 onUpdate 回调立即热更新运行中的配置（包装闭包读共享 state）。
+ * 写入采用随机临时文件 + fsync + rename，权限 0600；损坏 JSON 只告警并回退。
+ */
+import { randomUUID } from "node:crypto";
+import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
+/**
+ * 创建配置存储。
+ * @param options - { name, defaults, patchConfig, onUpdate,
+ *   validate?: (partial) => void, warn?: (message) => void }
+ */
+export function createConfigStore(options) {
+    // 与 harness 的 DSH_HOME 约定保持一致：默认 ~/.dsh，可用 $DSH_HOME 覆盖。
+    const dshHome = process.env.DSH_HOME?.trim() ? resolve(process.env.DSH_HOME) : join(homedir(), ".dsh");
+    const file = join(dshHome, "plugins", options.name, "config.json");
+    const warn = options.warn ?? (() => { });
+    let readWarningShown = false;
+    function readJson() {
+        try {
+            if (!existsSync(file))
+                return {};
+            const parsed = JSON.parse(readFileSync(file, "utf8"));
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                readWarningShown = false;
+                return parsed;
+            }
+            if (!readWarningShown) {
+                readWarningShown = true;
+                warn(`config file ${file} must contain a JSON object; using empty config`);
+            }
+            return {};
+        }
+        catch (error) {
+            if (!readWarningShown) {
+                readWarningShown = true;
+                warn(`failed to read config file ${file}: ${error?.message ?? String(error)}; using empty config`);
+            }
+            return {};
+        }
+    }
+    /** 当前生效配置（默认 + patch + json 合并）。 */
+    function effective() {
+        return { ...options.defaults, ...options.patchConfig, ...readJson() };
+    }
+    /** 保存部分配置到 config.json 并触发热更新，返回新的生效配置。 */
+    function set(partial) {
+        if (partial === null || typeof partial !== "object" || Array.isArray(partial)) {
+            throw new TypeError("set expects a plain config object");
+        }
+        options.validate?.(partial);
+        const merged = { ...readJson(), ...partial };
+        mkdirSync(dirname(file), { recursive: true });
+        const tmp = `${file}.${process.pid}.${randomUUID()}.tmp`;
+        let fd;
+        try {
+            fd = openSync(tmp, "w", 0o600);
+            writeFileSync(fd, JSON.stringify(merged, null, 2) + "\n", "utf8");
+            fsyncSync(fd);
+            closeSync(fd);
+            fd = void 0;
+            renameSync(tmp, file);
+            // POSIX 目录项持久化（Windows 上目录句柄不可打开时忽略）。
+            try {
+                const dir = openSync(dirname(file), "r");
+                try {
+                    fsyncSync(dir);
+                }
+                finally {
+                    closeSync(dir);
+                }
+            }
+            catch { }
+        }
+        catch (error) {
+            if (fd !== void 0)
+                try {
+                    closeSync(fd);
+                }
+                catch { }
+            try {
+                unlinkSync(tmp);
+            }
+            catch { }
+            throw error;
+        }
+        const next = { ...options.defaults, ...options.patchConfig, ...merged };
+        try {
+            options.onUpdate?.(merged, next);
+        }
+        catch (error) {
+            warn(`onUpdate failed after config save: ${error?.message ?? String(error)}`);
+        }
+        return next;
+    }
+    return { file, effective, set };
+}
+//# sourceMappingURL=config-store.js.map

package/lib/config-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.js","sourceRoot":"","sources":["../src/config-store.ts"],"names":[],"mappings":"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"}