@lijian-ui/dsh-session-cleaner 0.1.0

package/README.en.md

@@ -0,0 +1,41 @@
+# @lijian-ui/dsh-session-cleaner
+
+English | [简体中文](./README.md)
+
+> Session management for dsh: list (with titles), click-to-preview, real delete (with confirm), archive group & restore. 为 DeepSeek Harness 提供会话管理：列表（含标题）/ 点击预览 / 真删除（二次确认）/ 归档分组与恢复。
+
+The official dsh only has "archive" (no delete), and archived sessions are hidden from every view with no way back (files still occupy disk). This plugin fixes both, and adds **identifiability** (titles + content preview) so you never delete the wrong session by accident:
+
+- **Session list with titles** — scans `~/.dsh/sessions` on the file layer; shows the session title (extracted from the log's `session/title` event), time, size and status; grouped into 全部 (All) / 已归档 (Archived) / 游离 (Orphan)
+- **Click to preview** — clicking a row opens a preview dialog (last 12 messages, user/assistant bubbles); delete is also available inside the preview
+- **Real delete** — removes the session directory + projection cache (projcache) + workspace state in one pass; a **confirm dialog** clearly warns "permanent, not recoverable"
+- **Archive group** — archiving goes through the official `workspace.archiveSession` RPC (**instant hide in the official list**); restore/delete write `workspace.json` directly (the official UI syncs after a dsh restart)
+
+## Install
+
+```bash
+# Development (link)
+dsh plugin --profile web add ./extensions/session-cleaner
+# Or from npm once published
+dsh plugin --profile web add @lijian-ui/dsh-session-cleaner
+```
+
+## Usage
+
+Open Settings → **会话管理** (Session Manager) after starting dsh:
+
+- Top: session count and total disk usage
+- Tabs: 全部 (All) / 已归档 (Archived) / 游离 (Orphan)
+- Each row: **click** → preview dialog (title, ID, created time, size + recent conversation); row buttons: **归档** (Archive — hides in the official list instantly) / **恢复** (Restore) / **删除** (Delete — confirm dialog, real delete)
+- The preview dialog also has a "删除此会话" (Delete this session) entry
+
+## Known boundaries
+
+- **Archive**: goes through the official API — the official sidebar hides it **instantly** (no restart)
+- **Restore / Delete**: the official API has no such operations, so the plugin works on the file layer directly — the **official sidebar syncs after a dsh restart** (the plugin page itself is always accurate)
+- **Delete is permanent** (no trash); the confirm dialog warns about it explicitly
+- Session logs are **multi-frame zstd**; the plugin decompresses every frame to read titles and content
+
+## License
+
+MIT © lijian-ui

package/README.md

@@ -0,0 +1,40 @@
+# @lijian-ui/dsh-session-cleaner
+
+> 为 DeepSeek Harness (dsh) 提供会话管理：列表（含标题）/ 点击预览 / 真删除（二次确认）/ 归档分组与恢复。
+> Session management for dsh: list (with titles), click-to-preview, real delete (with confirm), archive group & restore.
+
+官方 dsh 只有"归档"没有"删除"，且归档后会话从所有视图隐藏、无恢复入口（会话记录仍占磁盘）。本插件修复这两个问题，并补上会话的**可识别性**（标题 + 内容预览），避免误删：
+
+- **会话列表（带标题）**：文件层扫描 `~/.dsh/sessions`，显示会话标题（从日志 `session/title` 事件提取）、时间、大小、状态；分组：全部 / 已归档 / 游离
+- **点击预览**：点击会话行弹出内容预览（最近 12 条对话，用户/助手气泡），预览内可直接删除
+- **真删除**：删除会话目录 + 投影缓存（projcache）+ workspace 状态三处清理；**二次确认弹窗**，明确"永久删除、不可恢复"
+- **归档分组**：归档走官方 `workspace.archiveSession` RPC（**官方列表即时隐藏**）；恢复/删除读写官方 `workspace.json`（官方 UI 重启后同步）
+
+## 安装
+
+```bash
+# 开发期（link 联调）
+dsh plugin --profile web add ./extensions/session-cleaner
+# 或发布后
+dsh plugin --profile web add @lijian-ui/dsh-session-cleaner
+```
+
+## 使用
+
+启动 dsh 后打开设置 → **会话管理**：
+
+- 顶部：会话总数与总占用
+- 标签页：全部 / 已归档 / 游离
+- 每行：**点击** → 预览弹窗（标题、ID、创建时间、大小 + 最近对话）；行内按钮：**归档**（官方列表即时隐藏）/ **恢复**（移出归档）/ **删除**（二次确认，真删除）
+- 预览弹窗底部也有「删除此会话」入口
+
+## 边界说明
+
+- **归档**：走官方 API，官方侧边栏**即时**隐藏（无需重启）
+- **恢复 / 删除**：官方无对应 API，插件直接操作文件层，**官方侧边栏在 dsh 重启后同步**（插件页面本身即时准确）
+- **删除**为**永久删除**（不经过回收站），插件会在确认框明确警告
+- 会话日志是**多帧 zstd** 格式，插件按帧完整解压读取标题与内容
+
+## 许可
+
+MIT © lijian-ui

package/cordis.patch.yml

@@ -0,0 +1,15 @@
+# @lijian-ui/dsh-session-cleaner bundle patch — SINGLE entry.
+#
+# One plugin (`@lijian-ui/dsh-session-cleaner`) provides the session
+# management UI + host RPC. It ships ZERO config (no instances needed):
+# sessions live in the official `~/.dsh/sessions` tree and the plugin
+# manages them directly on the file layer.
+#
+# This entry's package (package.json) also declares dsh.client → the same
+# package carries the browser half (lib/client.js), which client-modules
+# discovers from this entry's name.
+
+- insert:
+    - id: session-cleaner
+      name: '@lijian-ui/dsh-session-cleaner'
+      config: {}

package/lib/client.js

@@ -0,0 +1,644 @@
+window.__ModuleLoader__.load({
+	id: "@lijian-ui/dsh-session-cleaner",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		//#region src/client/SessionManagerSection.ts
+		/**
+		* 会话管理设置页（client half）
+		* ------------------------------------------------------------------
+		* 分组：全部 / 已归档 / 游离（无 workspace 归属）。
+		* 操作：归档（移入已归档分组）、恢复（移出）、删除（真删除 + 二次确认弹窗）。
+		* 样式走 dsh 设计 token（var(--dsw-alias-*)）自动适配明暗主题。
+		*/
+		const page = {
+			display: "flex",
+			flexDirection: "column",
+			gap: 12,
+			padding: "4px 0 24px",
+			width: "100%",
+			minHeight: 400
+		};
+		const header = {
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "space-between",
+			padding: "14px 0",
+			flexShrink: 0,
+			borderBottom: "1px solid var(--dsw-alias-border-l2, #eee)"
+		};
+		const title = {
+			fontSize: 17,
+			fontWeight: 500,
+			color: "var(--dsw-alias-label-primary, inherit)",
+			margin: 0,
+			whiteSpace: "nowrap"
+		};
+		const countBadge = {
+			display: "inline-flex",
+			alignItems: "center",
+			justifyContent: "center",
+			minWidth: 22,
+			height: 22,
+			padding: "0 7px",
+			borderRadius: 999,
+			background: "var(--dsw-alias-bg-layer-3, #eee)",
+			color: "var(--dsw-alias-label-secondary, #555)",
+			fontSize: 11,
+			fontWeight: 500,
+			marginLeft: 8
+		};
+		const toolbar = {
+			display: "flex",
+			alignItems: "center",
+			gap: 8
+		};
+		const btnGhost = {
+			display: "inline-flex",
+			alignItems: "center",
+			gap: 6,
+			height: 30,
+			padding: "0 12px",
+			background: "transparent",
+			color: "var(--dsw-alias-label-primary, inherit)",
+			border: "1px solid var(--dsw-alias-border-l2, #ddd)",
+			borderRadius: 6,
+			fontSize: 12,
+			cursor: "pointer"
+		};
+		const btnDanger = {
+			display: "inline-flex",
+			alignItems: "center",
+			gap: 6,
+			height: 26,
+			padding: "0 10px",
+			background: "transparent",
+			color: "var(--dsw-alias-state-error-primary, #e24b4a)",
+			border: "1px solid var(--dsw-alias-state-error-primary, #e24b4a)",
+			borderRadius: 6,
+			fontSize: 12,
+			cursor: "pointer"
+		};
+		const btnDangerSolid = {
+			display: "inline-flex",
+			alignItems: "center",
+			gap: 6,
+			height: 30,
+			padding: "0 14px",
+			background: "var(--dsw-alias-state-error-primary, #e24b4a)",
+			color: "#fff",
+			border: "none",
+			borderRadius: 6,
+			fontSize: 12,
+			fontWeight: 500,
+			cursor: "pointer"
+		};
+		const tabs = {
+			display: "flex",
+			gap: 4,
+			borderBottom: "1px solid var(--dsw-alias-border-l2, #eee)",
+			paddingBottom: 0
+		};
+		const tabStyle = {
+			padding: "8px 14px",
+			fontSize: 13,
+			color: "var(--dsw-alias-label-secondary, #666)",
+			background: "transparent",
+			border: "none",
+			borderBottom: "2px solid transparent",
+			cursor: "pointer"
+		};
+		const tabStyleActive = {
+			...tabStyle,
+			color: "var(--dsw-alias-state-business-primary, #185FA5)",
+			borderBottomColor: "var(--dsw-alias-state-business-primary, #185FA5)",
+			fontWeight: 500
+		};
+		const list = {
+			display: "flex",
+			flexDirection: "column",
+			gap: 6
+		};
+		const row = {
+			display: "flex",
+			alignItems: "center",
+			gap: 12,
+			padding: "10px 12px",
+			borderRadius: 8,
+			background: "var(--dsw-alias-bg-layer-2, #fafafa)",
+			border: "1px solid var(--dsw-alias-border-l3, #f0f0f0)",
+			cursor: "pointer"
+		};
+		const rowMain = {
+			flex: 1,
+			minWidth: 0,
+			display: "flex",
+			flexDirection: "column",
+			gap: 2
+		};
+		const rowTitle = {
+			fontSize: 13,
+			fontWeight: 500,
+			color: "var(--dsw-alias-label-primary, inherit)",
+			overflow: "hidden",
+			textOverflow: "ellipsis",
+			whiteSpace: "nowrap"
+		};
+		const rowMeta = {
+			fontSize: 11,
+			color: "var(--dsw-alias-label-secondary, #888)"
+		};
+		const rowActions = {
+			display: "flex",
+			alignItems: "center",
+			gap: 6,
+			flexShrink: 0
+		};
+		const badge = {
+			display: "inline-flex",
+			alignItems: "center",
+			padding: "1px 8px",
+			borderRadius: 999,
+			fontSize: 10,
+			background: "var(--dsw-alias-bg-layer-3, #eee)",
+			color: "var(--dsw-alias-label-secondary, #777)"
+		};
+		const badgeArchived = {
+			...badge,
+			color: "var(--dsw-alias-state-warning-primary, #b8860b)",
+			background: "rgba(184,134,11,0.12)"
+		};
+		const badgeStray = {
+			...badge,
+			color: "var(--dsw-alias-state-error-primary, #e24b4a)",
+			background: "rgba(226,75,74,0.10)"
+		};
+		const empty = {
+			display: "flex",
+			flexDirection: "column",
+			alignItems: "center",
+			justifyContent: "center",
+			gap: 6,
+			padding: "40px 24px",
+			border: "1px dashed var(--dsw-alias-border-l3, #ccc)",
+			borderRadius: 10,
+			background: "var(--dsw-alias-bg-layer-1, transparent)",
+			textAlign: "center"
+		};
+		const emptyText = {
+			margin: 0,
+			fontSize: 13,
+			color: "var(--dsw-alias-label-secondary, #555)"
+		};
+		const errorStyle = {
+			fontSize: 12,
+			lineHeight: 1.5,
+			color: "var(--dsw-alias-state-error-primary, #e24b4a)",
+			padding: "10px 14px",
+			background: "rgba(226,75,74,0.08)",
+			border: "1px solid rgba(226,75,74,0.35)",
+			borderRadius: 8,
+			whiteSpace: "pre-wrap"
+		};
+		const hint = {
+			fontSize: 12,
+			color: "var(--dsw-alias-label-secondary, #888)",
+			lineHeight: 1.6
+		};
+		const modalOverlay = {
+			position: "fixed",
+			inset: 0,
+			background: "rgba(0,0,0,0.45)",
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "center",
+			zIndex: 1e3
+		};
+		const modalCard = {
+			width: 420,
+			maxWidth: "86vw",
+			background: "var(--dsw-alias-bg-layer-3, #fff)",
+			color: "var(--dsw-alias-label-primary, #222)",
+			borderRadius: 12,
+			boxShadow: "0 8px 32px rgba(0,0,0,0.25)",
+			padding: "20px 22px",
+			display: "flex",
+			flexDirection: "column",
+			gap: 12
+		};
+		const modalTitle = {
+			margin: 0,
+			fontSize: 15,
+			fontWeight: 600
+		};
+		const modalBody = {
+			fontSize: 13,
+			lineHeight: 1.6,
+			color: "var(--dsw-alias-label-secondary, #555)"
+		};
+		const modalBodyStrong = {
+			fontSize: 13,
+			lineHeight: 1.6,
+			color: "var(--dsw-alias-state-error-primary, #e24b4a)",
+			fontWeight: 500
+		};
+		const modalActions = {
+			display: "flex",
+			justifyContent: "flex-end",
+			gap: 8,
+			marginTop: 4
+		};
+		const previewModalCard = {
+			...modalCard,
+			width: 560,
+			maxHeight: "70vh",
+			overflow: "hidden",
+			display: "flex",
+			flexDirection: "column"
+		};
+		const previewBody = {
+			flex: 1,
+			minHeight: 0,
+			overflowY: "auto",
+			display: "flex",
+			flexDirection: "column",
+			gap: 8,
+			padding: "4px 2px"
+		};
+		const msgBubble = {
+			maxWidth: "92%",
+			padding: "8px 12px",
+			borderRadius: 8,
+			fontSize: 12.5,
+			lineHeight: 1.6,
+			whiteSpace: "pre-wrap",
+			wordBreak: "break-word"
+		};
+		const msgUser = {
+			...msgBubble,
+			alignSelf: "flex-end",
+			background: "var(--dsw-alias-state-business-primary, #185FA5)",
+			color: "#fff"
+		};
+		const msgAssistant = {
+			...msgBubble,
+			alignSelf: "flex-start",
+			background: "var(--dsw-alias-bg-layer-3, #f0f0f0)",
+			color: "var(--dsw-alias-label-primary, #222)"
+		};
+		const previewMeta = {
+			fontSize: 11,
+			color: "var(--dsw-alias-label-secondary, #888)"
+		};
+		function fmtBytes(n) {
+			if (n < 1024) return `${n} B`;
+			if (n < 1048576) return `${(n / 1024).toFixed(1)} KB`;
+			return `${(n / 1024 / 1024).toFixed(1)} MB`;
+		}
+		function fmtTime(ms) {
+			const d = new Date(ms);
+			const p = (x) => String(x).padStart(2, "0");
+			return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
+		}
+		/** 会话展示名：优先标题，回退 workspace 解码 + id 短前缀 */
+		function fmtSessionName(s) {
+			if (s.title) return s.title;
+			return `${s.workspaceDir.replace(/~003A/g, ":").replace(/^--/, "").replace(/--$/, "")} / ${s.id.length > 8 ? `${s.id.slice(0, 8)}…` : s.id}`;
+		}
+		/** 格式化时间戳 */
+		function fmtDateTime(ms) {
+			if (!ms) return "—";
+			const d = new Date(ms);
+			const p = (x) => String(x).padStart(2, "0");
+			return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
+		}
+		function SessionManagerSection(props) {
+			const { api } = props;
+			const [sessions, setSessions] = (0, react.useState)([]);
+			const [loading, setLoading] = (0, react.useState)(true);
+			const [error, setError] = (0, react.useState)("");
+			const [tab, setTab] = (0, react.useState)("all");
+			const [confirmTarget, setConfirmTarget] = (0, react.useState)(null);
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [previewTarget, setPreviewTarget] = (0, react.useState)(null);
+			const [previewData, setPreviewData] = (0, react.useState)(null);
+			const [previewLoading, setPreviewLoading] = (0, react.useState)(false);
+			const mountedRef = (0, react.useRef)(true);
+			const refresh = async () => {
+				setLoading(true);
+				setError("");
+				const res = await api.list();
+				if (!mountedRef.current) return;
+				setLoading(false);
+				if (!res.ok) {
+					setError(`加载会话失败：${res.message ?? res.code ?? "未知错误"}`);
+					return;
+				}
+				setSessions(res.value ?? []);
+			};
+			(0, react.useEffect)(() => {
+				mountedRef.current = true;
+				refresh();
+				return () => {
+					mountedRef.current = false;
+				};
+			}, []);
+			const filtered = (0, react.useMemo)(() => {
+				if (tab === "archived") return sessions.filter((s) => s.archived);
+				if (tab === "stray") return sessions.filter((s) => !s.archived && !s.active);
+				return sessions;
+			}, [sessions, tab]);
+			const counts = (0, react.useMemo)(() => ({
+				all: sessions.length,
+				archived: sessions.filter((s) => s.archived).length,
+				stray: sessions.filter((s) => !s.archived && !s.active).length
+			}), [sessions]);
+			const run = async (fn) => {
+				if (busy) return;
+				setBusy(true);
+				setError("");
+				const res = await fn();
+				setBusy(false);
+				if (!res.ok) {
+					setError(`操作失败：${res.message ?? "未知错误"}`);
+					return;
+				}
+				await refresh();
+			};
+			const openPreview = async (s) => {
+				setPreviewTarget(s);
+				setPreviewData(null);
+				setPreviewLoading(true);
+				const res = await api.preview(s.id);
+				setPreviewLoading(false);
+				if (res.ok) setPreviewData(res.value ?? null);
+				else setError(`加载预览失败：${res.message ?? "未知错误"}`);
+			};
+			const handleDelete = (s) => {
+				setConfirmTarget(s);
+			};
+			const confirmDelete = async () => {
+				if (!confirmTarget) return;
+				const target = confirmTarget;
+				setConfirmTarget(null);
+				await run(() => api.remove(target.id));
+			};
+			const handleArchive = (s) => {
+				const { archiveSession } = props;
+				if (archiveSession) {
+					(async () => {
+						if (busy) return;
+						setBusy(true);
+						setError("");
+						const ok = await archiveSession(s.id);
+						setBusy(false);
+						if (!ok) setError("归档失败（官方 API 不可用，请重试或重启 dsh）");
+						await refresh();
+					})();
+					return;
+				}
+				run(() => api.archive(s.id));
+			};
+			const handleUnarchive = (s) => {
+				run(() => api.unarchive(s.id));
+			};
+			const totalBytes = (0, react.useMemo)(() => sessions.reduce((a, s) => a + s.sizeBytes, 0), [sessions]);
+			return (0, react.createElement)("div", { style: page }, (0, react.createElement)("div", { style: header }, (0, react.createElement)("h2", { style: title }, "会话管理", (0, react.createElement)("span", { style: countBadge }, `${sessions.length} 个会话 · ${fmtBytes(totalBytes)}`)), (0, react.createElement)("div", { style: toolbar }, (0, react.createElement)("button", {
+				style: btnGhost,
+				onClick: () => void refresh(),
+				disabled: loading
+			}, loading ? "加载中…" : "刷新"))), (0, react.createElement)("div", { style: tabs }, [
+				"all",
+				"archived",
+				"stray"
+			].map((k) => (0, react.createElement)("button", {
+				key: k,
+				style: tab === k ? tabStyleActive : tabStyle,
+				onClick: () => setTab(k)
+			}, k === "all" ? `全部 (${counts.all})` : k === "archived" ? `已归档 (${counts.archived})` : `游离 (${counts.stray})`))), error ? (0, react.createElement)("div", { style: errorStyle }, error) : null, (0, react.createElement)("div", { style: hint }, "会话以文件形式保存在 ~/.dsh/sessions。归档会从官方列表隐藏（与官方归档打通），删除为永久删除，不可恢复。"), (0, react.createElement)("div", { style: list }, filtered.map((s) => (0, react.createElement)("div", {
+				key: s.id,
+				style: row,
+				onClick: () => void openPreview(s)
+			}, (0, react.createElement)("div", { style: rowMain }, (0, react.createElement)("div", { style: rowTitle }, fmtSessionName(s)), (0, react.createElement)("div", { style: rowMeta }, `${fmtTime(s.mtimeMs)} · ${fmtBytes(s.sizeBytes)} · ${s.id}`)), s.archived ? (0, react.createElement)("span", { style: badgeArchived }, "已归档") : !s.active ? (0, react.createElement)("span", { style: badgeStray }, "游离") : null, (0, react.createElement)("div", {
+				style: rowActions,
+				onClick: (e) => e.stopPropagation()
+			}, s.archived ? (0, react.createElement)("button", {
+				style: btnGhost,
+				onClick: () => handleUnarchive(s),
+				disabled: busy
+			}, "恢复") : (0, react.createElement)("button", {
+				style: btnGhost,
+				onClick: () => handleArchive(s),
+				disabled: busy
+			}, "归档"), (0, react.createElement)("button", {
+				style: btnDanger,
+				onClick: () => handleDelete(s),
+				disabled: busy
+			}, "删除"))))), !loading && filtered.length === 0 ? (0, react.createElement)("div", { style: empty }, (0, react.createElement)("p", { style: emptyText }, tab === "archived" ? "没有已归档的会话" : tab === "stray" ? "没有游离会话" : "没有会话")) : null, confirmTarget ? (0, react.createElement)("div", {
+				style: modalOverlay,
+				onClick: () => setConfirmTarget(null)
+			}, (0, react.createElement)("div", {
+				style: modalCard,
+				onClick: (e) => e.stopPropagation()
+			}, (0, react.createElement)("h3", { style: modalTitle }, "删除会话？"), (0, react.createElement)("div", { style: modalBody }, `确定要删除会话「${fmtSessionName(confirmTarget)}」吗？`), (0, react.createElement)("div", { style: modalBodyStrong }, "此操作将永久删除该会话及其日志文件，无法恢复（不会进入回收站）。"), (0, react.createElement)("div", { style: modalActions }, (0, react.createElement)("button", {
+				style: btnGhost,
+				onClick: () => setConfirmTarget(null),
+				disabled: busy
+			}, "取消"), (0, react.createElement)("button", {
+				style: btnDangerSolid,
+				onClick: () => void confirmDelete(),
+				disabled: busy
+			}, busy ? "删除中…" : "永久删除")))) : null, previewTarget ? (0, react.createElement)("div", {
+				style: modalOverlay,
+				onClick: () => setPreviewTarget(null)
+			}, (0, react.createElement)("div", {
+				style: previewModalCard,
+				onClick: (e) => e.stopPropagation()
+			}, (0, react.createElement)("h3", { style: modalTitle }, fmtSessionName(previewTarget)), (0, react.createElement)("div", { style: previewMeta }, `ID: ${previewTarget.id} · 创建: ${fmtDateTime(previewData?.createdAt)} · ${fmtBytes(previewTarget.sizeBytes)}`), (0, react.createElement)("div", { style: previewBody }, previewLoading ? (0, react.createElement)("p", { style: emptyText }, "加载中…") : previewData && previewData.messages.length > 0 ? previewData.messages.map((m, i) => (0, react.createElement)("div", {
+				key: i,
+				style: m.role === "user" ? msgUser : msgAssistant
+			}, m.text)) : (0, react.createElement)("p", { style: emptyText }, "（该会话暂无文本消息）")), (0, react.createElement)("div", { style: modalActions }, (0, react.createElement)("button", {
+				style: btnDanger,
+				onClick: () => {
+					setPreviewTarget(null);
+					handleDelete(previewTarget);
+				}
+			}, "删除此会话"), (0, react.createElement)("button", {
+				style: btnGhost,
+				onClick: () => setPreviewTarget(null)
+			}, "关闭")))) : null);
+		}
+		//#endregion
+		//#region src/client/config-api.ts
+		const PACKAGE = "@lijian-ui/dsh-session-cleaner";
+		const SERVICE = "sessionCleanerRemote";
+		/** Identity codec — the host manifest owns strict validation. */
+		const identity = (value) => value;
+		const codec = (symbol) => ({
+			mode: "strict",
+			typeSymbol: symbol,
+			schema: { parse: identity }
+		});
+		/** Wire descriptors mirroring the host contribution (src/remote.ts). */
+		const CONTRIBUTION = {
+			package: PACKAGE,
+			descriptors: [
+				{
+					id: `${PACKAGE}#${SERVICE}/listSessions`,
+					service: SERVICE,
+					namespace: SERVICE,
+					method: "listSessions",
+					invocation: { kind: "direct" },
+					parameters: [],
+					result: codec(`${PACKAGE}#SessionList`)
+				},
+				{
+					id: `${PACKAGE}#${SERVICE}/previewSession`,
+					service: SERVICE,
+					namespace: SERVICE,
+					method: "previewSession",
+					invocation: { kind: "direct" },
+					parameters: [{
+						name: "sessionId",
+						wire: "sessionId",
+						source: "json",
+						codec: codec(`${PACKAGE}#SessionId`)
+					}, {
+						name: "limit",
+						wire: "limit",
+						source: "json",
+						acceptsUndefined: true,
+						codec: codec(`${PACKAGE}#Limit`)
+					}],
+					result: codec(`${PACKAGE}#SessionPreview`)
+				},
+				{
+					id: `${PACKAGE}#${SERVICE}/deleteSession`,
+					service: SERVICE,
+					namespace: SERVICE,
+					method: "deleteSession",
+					invocation: { kind: "direct" },
+					parameters: [{
+						name: "sessionId",
+						wire: "sessionId",
+						source: "json",
+						codec: codec(`${PACKAGE}#SessionId`)
+					}],
+					result: codec(`${PACKAGE}#DeleteResult`)
+				},
+				{
+					id: `${PACKAGE}#${SERVICE}/archiveSession`,
+					service: SERVICE,
+					namespace: SERVICE,
+					method: "archiveSession",
+					invocation: { kind: "direct" },
+					parameters: [{
+						name: "sessionId",
+						wire: "sessionId",
+						source: "json",
+						codec: codec(`${PACKAGE}#SessionId`)
+					}],
+					result: codec(`${PACKAGE}#ArchiveResult`)
+				},
+				{
+					id: `${PACKAGE}#${SERVICE}/unarchiveSession`,
+					service: SERVICE,
+					namespace: SERVICE,
+					method: "unarchiveSession",
+					invocation: { kind: "direct" },
+					parameters: [{
+						name: "sessionId",
+						wire: "sessionId",
+						source: "json",
+						codec: codec(`${PACKAGE}#SessionId`)
+					}],
+					result: codec(`${PACKAGE}#ArchiveResult`)
+				}
+			]
+		};
+		/**
+		* Create the session api bound to this browser plugin's context.
+		* Mounts the remote contribution once; every call awaits the mount, then
+		* invokes the namespace service and unwraps the envelope.
+		*/
+		function createSessionApi(ctx) {
+			const mount = ctx.remote.$mount(CONTRIBUTION);
+			const call = async (method, ...args) => {
+				try {
+					await mount;
+					const result = await ctx.get(`remote.${SERVICE}`)[method](...args);
+					if (!result.ok) return {
+						ok: false,
+						code: result.error?.code ?? "remote-error",
+						message: result.error?.message ?? `${SERVICE}.${method} failed`
+					};
+					return {
+						ok: true,
+						value: result.value
+					};
+				} catch (err) {
+					return {
+						ok: false,
+						code: "remote-error",
+						message: err instanceof Error ? err.message : String(err)
+					};
+				}
+			};
+			return {
+				list: () => call("listSessions"),
+				preview: (sessionId) => call("previewSession", sessionId, void 0),
+				remove: (sessionId) => call("deleteSession", sessionId),
+				archive: (sessionId) => call("archiveSession", sessionId),
+				unarchive: (sessionId) => call("unarchiveSession", sessionId)
+			};
+		}
+		//#endregion
+		//#region src/client/index.ts
+		/** Section identity in the Settings left-nav rail. */
+		const SECTION_ID = "session-cleaner";
+		/** Sits below Models (10) and IM 通道 (20). */
+		const SECTION_ORDER = 30;
+		/** Services this browser plugin requires (cordis fiber inject). */
+		const inject = [
+			"slots",
+			"locale",
+			"connection",
+			"remote"
+		];
+		/**
+		* Mount the session management settings page.
+		* @param ctx - the browser plugin context (guarded facade).
+		*/
+		function apply(ctx) {
+			const api = createSessionApi(ctx);
+			let officialArchive = null;
+			ctx.inject(["workspaces"], (sctx) => {
+				officialArchive = async (sessionId) => {
+					try {
+						return (await sctx.workspaces.archiveSession(sessionId)).ok === true;
+					} catch {
+						return false;
+					}
+				};
+			});
+			ctx.slots.inject("settings.section", () => ctx.slots.register({
+				name: "settings.section",
+				id: SECTION_ID,
+				order: SECTION_ORDER,
+				label: () => "会话管理",
+				inject: () => ({
+					api,
+					archiveSession: (sessionId) => officialArchive ? officialArchive(sessionId) : api.archive(sessionId).then((r) => r.ok)
+				})
+			}, SessionManagerSection));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index-DdPrDbW6.d.ts

@@ -0,0 +1,21 @@
+import Schema from "@deepseek-ai/schemastery";
+import { Context } from "@deepseek-ai/cordis";
+
+//#region src/index.d.ts
+
+/**
+ * Plugin-level dependency declaration: waits for the host services before
+ * apply runs (mirrors im-gateway / dsh-skill-viewer).
+ */
+declare const inject: string[];
+/** Empty config schema (the settings section needs a registered namespace). */
+declare const Config: Schema<Schemastery.ObjectS<{}>, Schemastery.ObjectT<{}>>;
+/**
+ * Session-cleaner bundle. One plugin (`@lijian-ui/dsh-session-cleaner`)
+ * provides a "会话管理" settings page + host RPC that lists / deletes /
+ * archives / restores dsh sessions on the file layer (official has no
+ * delete; archive is hidden-without-entry — this plugin fixes both).
+ */
+declare function apply(ctx: Context): void;
+//#endregion
+export { Config, apply, inject };

package/lib/index.js

@@ -0,0 +1,516 @@
+import Schema from "@deepseek-ai/schemastery";
+import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
+import { TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
+import * as fs from "fs";
+import * as path from "path";
+import { homedir } from "os";
+import { zstdDecompressSync } from "node:zlib";
+//#region src/session-store.ts
+/**
+* 会话存储层（session-cleaner host half）
+* ------------------------------------------------------------------
+* 直接操作 dsh 官方文件层（无需官方 API）：
+*
+*   sessions 树：  ~/.dsh/sessions/<encoded-workspace>/<sessionId>/session.jsonl.zstd
+*   workspace 状态：~/.dsh/storages/workspace.json
+*                    - global.archivedSessionIds   ← 归档状态（与官方 UI 共享）
+*                    - tables.workspaces[*].sessionIds ← 会话归属
+*   projcache：    ~/.dsh/storages/session_projcache.json（删除时必须清，否则旧投影残留）
+*
+* 删除 = 三处清理：session 目录 + projcache + workspace.json（sessionIds/archivedSessionIds）。
+* 归档/恢复 = 读写 workspace.json 的 global.archivedSessionIds（单真相源与官方打通）。
+*
+* ⚠️ 已知边界：归档/恢复直接改文件，host 内存态不会热更新——插件页面以文件为准（准确），
+* 官方 UI 的隐藏/恢复在 dsh 重启后同步。删除同理（已删除的会话从文件层消失，官方 UI
+* 重启后不再列出）。
+*/
+/** dsh 用户数据目录（与桌面壳 buildDshEnv 的 DSH_HOME 保持一致） */
+function dshHome() {
+	return process.env.DSH_HOME ?? path.join(homedir(), ".dsh");
+}
+function sessionsRoot() {
+	return path.join(dshHome(), "sessions");
+}
+function workspaceFile() {
+	return path.join(dshHome(), "storages", "workspace.json");
+}
+function projcacheFile() {
+	return path.join(dshHome(), "storages", "session_projcache.json");
+}
+/** 原子写 JSON（先写 .tmp 再 rename，避免半写损坏） */
+function writeJsonAtomic(file, data) {
+	const tmp = `${file}.tmp`;
+	fs.writeFileSync(tmp, JSON.stringify(data, null, 2), "utf-8");
+	fs.renameSync(tmp, file);
+}
+/** 剔除值为 undefined 的字段（typert 边界校验拒绝非 JSON-safe 值） */
+function stripUndefined(obj) {
+	const out = {};
+	for (const [k, v] of Object.entries(obj)) if (v !== void 0) out[k] = v;
+	return out;
+}
+/** 读 JSON（缺失/损坏返回默认值，不抛错） */
+function readJson(file, fallback) {
+	try {
+		if (!fs.existsSync(file)) return fallback;
+		return JSON.parse(fs.readFileSync(file, "utf-8"));
+	} catch {
+		return fallback;
+	}
+}
+/** 读 workspace 状态 */
+function readWorkspace() {
+	return readJson(workspaceFile(), {});
+}
+/** 读 archivedSessionIds 集合 */
+function readArchived() {
+	const ws = readWorkspace();
+	return new Set(ws.global?.archivedSessionIds ?? []);
+}
+/** 写 archivedSessionIds 集合（保留其他字段原样） */
+function writeArchived(archived) {
+	const ws = readWorkspace();
+	ws.global = {
+		...ws.global ?? {},
+		archivedSessionIds: [...archived]
+	};
+	writeJsonAtomic(workspaceFile(), ws);
+}
+/**
+* 扫描全部 session（文件层权威）。
+* 遍历 ~/.dsh/sessions/<workspace>/<sessionId>/，结合 workspace.json 标注状态。
+*/
+function listSessions() {
+	const root = sessionsRoot();
+	const out = [];
+	if (!fs.existsSync(root)) return out;
+	const archived = readArchived();
+	const ws = readWorkspace();
+	const activeIds = /* @__PURE__ */ new Set();
+	for (const w of Object.values(ws.tables?.workspaces ?? {})) for (const id of w.sessionIds ?? []) activeIds.add(id);
+	for (const workspaceDir of fs.readdirSync(root, { withFileTypes: true })) {
+		if (!workspaceDir.isDirectory()) continue;
+		const wsPath = path.join(root, workspaceDir.name);
+		for (const entry of fs.readdirSync(wsPath, { withFileTypes: true })) {
+			if (!entry.isDirectory()) continue;
+			const dir = path.join(wsPath, entry.name);
+			const logFile = path.join(dir, "session.jsonl.zstd");
+			if (!fs.existsSync(logFile)) continue;
+			let sizeBytes = 0;
+			let mtimeMs = 0;
+			try {
+				const st = fs.statSync(logFile);
+				sizeBytes = st.size;
+				mtimeMs = st.mtimeMs;
+			} catch {
+				continue;
+			}
+			out.push(stripUndefined({
+				id: entry.name,
+				workspaceDir: workspaceDir.name,
+				dir,
+				sizeBytes,
+				mtimeMs,
+				archived: archived.has(entry.name),
+				active: activeIds.has(entry.name),
+				title: readSessionTitle(logFile)
+			}));
+		}
+	}
+	out.sort((a, b) => b.mtimeMs - a.mtimeMs);
+	return out;
+}
+/** 从 workspace.json 的 sessionIds 里移除一个 id（若存在） */
+function removeFromWorkspaceSessionIds(id) {
+	const ws = readWorkspace();
+	let changed = false;
+	for (const w of Object.values(ws.tables?.workspaces ?? {})) if (w.sessionIds && w.sessionIds.includes(id)) {
+		w.sessionIds = w.sessionIds.filter((x) => x !== id);
+		changed = true;
+	}
+	if (changed) writeJsonAtomic(workspaceFile(), ws);
+}
+/** 从 projcache 里移除一个 session 的投影（嵌套结构，深度清理） */
+function removeFromProjcache(id) {
+	const file = projcacheFile();
+	if (!fs.existsSync(file)) return;
+	const data = readJson(file, null);
+	if (data === null) return;
+	const walk = (o) => {
+		if (!o || typeof o !== "object") return false;
+		let changed = false;
+		for (const k of Object.keys(o)) {
+			if (String(k).includes(id)) {
+				delete o[k];
+				changed = true;
+				continue;
+			}
+			if (walk(o[k])) changed = true;
+		}
+		return changed;
+	};
+	if (walk(data)) writeJsonAtomic(file, data);
+}
+/**
+* 真删除会话（不可恢复，调用方必须已二次确认）：
+* ① 删会话目录；② 清 projcache；③ 清 workspace.json（sessionIds + archivedSessionIds）。
+* 返回已删除的目录路径。
+*/
+function deleteSession(id) {
+	const root = sessionsRoot();
+	let target = null;
+	if (fs.existsSync(root)) for (const workspaceDir of fs.readdirSync(root, { withFileTypes: true })) {
+		if (!workspaceDir.isDirectory()) continue;
+		const dir = path.join(root, workspaceDir.name, id);
+		if (fs.existsSync(path.join(dir, "session.jsonl.zstd"))) {
+			target = dir;
+			break;
+		}
+	}
+	if (!target) throw new Error(`session ${id} 不存在（文件层未找到）`);
+	fs.rmSync(target, {
+		recursive: true,
+		force: true
+	});
+	removeFromProjcache(id);
+	removeFromWorkspaceSessionIds(id);
+	const archived = readArchived();
+	if (archived.has(id)) {
+		archived.delete(id);
+		writeArchived(archived);
+	}
+	return {
+		ok: true,
+		removedDir: target
+	};
+}
+/** 归档会话（写入官方 archivedSessionIds 集合，官方 UI 重启后同步隐藏） */
+function archiveSession(id) {
+	const archived = readArchived();
+	archived.add(id);
+	writeArchived(archived);
+	return { ok: true };
+}
+/** 恢复归档会话（从官方 archivedSessionIds 集合移除） */
+function unarchiveSession(id) {
+	const archived = readArchived();
+	if (archived.delete(id)) writeArchived(archived);
+	return { ok: true };
+}
+/**
+* 多帧 zstd 解码：dsh 的 session 日志每次追加写一个独立 zstd 帧
+* （文件里多个 magic 头），Node 的 zstdDecompressSync 只解第一帧——
+* 必须按 magic 位置逐帧解压拼接。
+*/
+function zstdDecompressAll(input) {
+	const magic = Buffer.from([
+		40,
+		181,
+		47,
+		253
+	]);
+	const chunks = [];
+	let start = 0;
+	while (start < input.length) {
+		const idx = input.indexOf(magic, start);
+		if (idx === -1) break;
+		const next = input.indexOf(magic, idx + 4);
+		const end = next === -1 ? input.length : next;
+		try {
+			chunks.push(zstdDecompressSync(input.subarray(idx, end)));
+		} catch {}
+		start = end;
+	}
+	if (chunks.length === 0) return zstdDecompressSync(input);
+	return Buffer.concat(chunks);
+}
+/** 解压 session.jsonl.zstd 返回文本行（失败返回 null） */
+function readSessionLines(logFile) {
+	try {
+		if (!fs.existsSync(logFile)) return null;
+		return zstdDecompressAll(fs.readFileSync(logFile)).toString("utf8").split("\n").filter(Boolean);
+	} catch {
+		return null;
+	}
+}
+/** 从日志行提取最后一个 session/title 事件的标题 */
+function extractTitle(lines) {
+	let title;
+	for (const line of lines) {
+		if (!line.includes("session/title")) continue;
+		try {
+			const event = JSON.parse(line);
+			if (event.type === "session/title" && event.data?.title) title = event.data.title;
+		} catch {}
+	}
+	return title;
+}
+/** 从日志行提取 header（第一行 session 元数据） */
+function extractHeader(lines) {
+	try {
+		const header = JSON.parse(lines[0] ?? "{}");
+		if (header.type !== "session") return void 0;
+		return {
+			createdAt: header.createdAt,
+			cwd: header.cwd
+		};
+	} catch {
+		return;
+	}
+}
+/** 从消息事件提取纯文本（宽容解析各种 content 形态） */
+function messageText(message) {
+	if (typeof message === "string") return message;
+	if (!message || typeof message !== "object") return "";
+	const content = message["content"];
+	if (typeof content === "string") return content;
+	if (Array.isArray(content)) return content.map((part) => {
+		if (typeof part === "string") return part;
+		if (part && typeof part === "object") {
+			const p = part;
+			if (p["type"] === "text" && typeof p["text"] === "string") return p["text"];
+			if (typeof p["text"] === "string") return p["text"];
+		}
+		return "";
+	}).filter(Boolean).join("\n");
+	return "";
+}
+/** 截断到 ~max 字符（保留首部） */
+function truncate(text, max = 200) {
+	if (text.length <= max) return text;
+	return text.slice(0, max) + "…";
+}
+/** 读取会话标题（不存在返回 undefined） */
+function readSessionTitle(logFile) {
+	const lines = readSessionLines(logFile);
+	if (!lines) return void 0;
+	return extractTitle(lines);
+}
+/**
+* 读取会话预览：header 元数据 + 最近 N 条用户/助手消息文本。
+* 找不到文件抛错（调用方转 RPC 错误）。
+*/
+function previewSession(id, limit = 12) {
+	const root = sessionsRoot();
+	let logFile = null;
+	if (fs.existsSync(root)) for (const workspaceDir of fs.readdirSync(root, { withFileTypes: true })) {
+		if (!workspaceDir.isDirectory()) continue;
+		const candidate = path.join(root, workspaceDir.name, id, "session.jsonl.zstd");
+		if (fs.existsSync(candidate)) {
+			logFile = candidate;
+			break;
+		}
+	}
+	if (!logFile) throw new Error(`session ${id} 不存在（文件层未找到）`);
+	const lines = readSessionLines(logFile);
+	if (!lines) throw new Error(`session ${id} 日志读取失败（可能损坏）`);
+	const header = extractHeader(lines);
+	const messages = [];
+	for (const line of lines.slice(1)) try {
+		const event = JSON.parse(line);
+		if (event.type === "user/message") {
+			const text = messageText(event.data);
+			if (text.trim()) messages.push({
+				role: "user",
+				text: truncate(text)
+			});
+		} else if (event.type === "assistant/message") {
+			const data = event.data;
+			const text = messageText(data?.message);
+			if (text.trim()) messages.push({
+				role: "assistant",
+				text: truncate(text)
+			});
+		}
+	} catch {}
+	return stripUndefined({
+		id,
+		title: extractTitle(lines),
+		createdAt: header?.createdAt,
+		cwd: header?.cwd,
+		messages: messages.slice(-limit)
+	});
+}
+//#endregion
+//#region src/remote.ts
+const SERVICE = "sessionCleanerRemote";
+const PACKAGE = "@lijian-ui/dsh-session-cleaner";
+const codec = (typeSymbol) => ({
+	mode: "strict",
+	typeSymbol,
+	schema: { parse: (v) => v }
+});
+/**
+* 注册到 `ctx.typert` 的 host 面契约。
+* face: 'host' + invocations（client 侧的 $mount 贡献则带 descriptors）。
+*/
+const CONTRIBUTION = {
+	package: PACKAGE,
+	face: "host",
+	schemas: [],
+	invocations: [
+		{
+			id: `${PACKAGE}#${SERVICE}/listSessions`,
+			service: SERVICE,
+			namespace: SERVICE,
+			method: "listSessions",
+			invocation: { kind: "direct" },
+			parameters: [],
+			result: codec(`${PACKAGE}#SessionList`)
+		},
+		{
+			id: `${PACKAGE}#${SERVICE}/previewSession`,
+			service: SERVICE,
+			namespace: SERVICE,
+			method: "previewSession",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "sessionId",
+				wire: "sessionId",
+				source: "json",
+				codec: codec(`${PACKAGE}#SessionId`)
+			}, {
+				name: "limit",
+				wire: "limit",
+				source: "json",
+				acceptsUndefined: true,
+				codec: codec(`${PACKAGE}#Limit`)
+			}],
+			result: codec(`${PACKAGE}#SessionPreview`)
+		},
+		{
+			id: `${PACKAGE}#${SERVICE}/deleteSession`,
+			service: SERVICE,
+			namespace: SERVICE,
+			method: "deleteSession",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "sessionId",
+				wire: "sessionId",
+				source: "json",
+				codec: codec(`${PACKAGE}#SessionId`)
+			}],
+			result: codec(`${PACKAGE}#DeleteResult`)
+		},
+		{
+			id: `${PACKAGE}#${SERVICE}/archiveSession`,
+			service: SERVICE,
+			namespace: SERVICE,
+			method: "archiveSession",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "sessionId",
+				wire: "sessionId",
+				source: "json",
+				codec: codec(`${PACKAGE}#SessionId`)
+			}],
+			result: codec(`${PACKAGE}#ArchiveResult`)
+		},
+		{
+			id: `${PACKAGE}#${SERVICE}/unarchiveSession`,
+			service: SERVICE,
+			namespace: SERVICE,
+			method: "unarchiveSession",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "sessionId",
+				wire: "sessionId",
+				source: "json",
+				codec: codec(`${PACKAGE}#SessionId`)
+			}],
+			result: codec(`${PACKAGE}#ArchiveResult`)
+		}
+	],
+	model: {
+		services: [],
+		events: [],
+		objects: []
+	}
+};
+/**
+* Remote 服务实现。构造时注册 `sessionCleanerRemote` cordis 服务，
+* 上面的贡献让 API gateway 能分发四个方法。
+*/
+var SessionCleanerApi = class extends TypertRemoteService {
+	constructor(ctx) {
+		super(ctx, SERVICE);
+	}
+	/** 全部会话摘要（文件层扫描 + 归档/归属状态） */
+	listSessions() {
+		return listSessions();
+	}
+	/** 会话预览：标题 + 最近消息文本 */
+	previewSession(sessionId, limit) {
+		return previewSession(sessionId, limit);
+	}
+	/** 真删除（调用方必须已二次确认） */
+	deleteSession(sessionId) {
+		return deleteSession(sessionId);
+	}
+	/** 归档（写入官方 archivedSessionIds 集合） */
+	archiveSession(sessionId) {
+		return archiveSession(sessionId);
+	}
+	/** 恢复归档 */
+	unarchiveSession(sessionId) {
+		return unarchiveSession(sessionId);
+	}
+};
+/** 注册 remote 服务 + typert 契约（对齐 im-gateway：effect 内取 typert 并 register） */
+function registerSessionCleanerRemote(ctx) {
+	new SessionCleanerApi(ctx);
+	ctx.effect(() => ctx.get("typert").register(CONTRIBUTION), "session-cleaner: typert contribution");
+}
+//#endregion
+//#region src/index.ts
+/**
+* Plugin-level dependency declaration: waits for the host services before
+* apply runs (mirrors im-gateway / dsh-skill-viewer).
+*/
+const inject = ["typert", "settings"];
+/** Settings namespace: no editable config — the page reads via Remote RPC. */
+const NS = settingsNamespace("session-cleaner");
+/** Empty config schema (the settings section needs a registered namespace). */
+const Config = Schema.object({});
+/**
+* Session-cleaner bundle. One plugin (`@lijian-ui/dsh-session-cleaner`)
+* provides a "会话管理" settings page + host RPC that lists / deletes /
+* archives / restores dsh sessions on the file layer (official has no
+* delete; archive is hidden-without-entry — this plugin fixes both).
+*/
+function apply(ctx) {
+	installConsoleLoggerExporter(ctx);
+	installSettingsSection(ctx, NS, Config, {}, {
+		setSource: () => {},
+		onChange: () => {}
+	});
+	registerSessionCleanerRemote(ctx);
+}
+/**
+* Route every cordis logger message to the native console (dsh stderr →
+* desktop shell "[dsh] " prefix). Without this, ctx.logger.* lands in
+* cordis's in-memory buffer only and is invisible while debugging.
+*/
+function installConsoleLoggerExporter(ctx) {
+	try {
+		ctx.root.logger?.exporter?.({
+			colors: 0,
+			export: (message) => {
+				const { name = "session-cleaner", type = "log", args = [] } = message;
+				const line = `[${name}] ${args.map((arg) => arg instanceof Error ? arg.stack ?? arg.message : typeof arg === "string" ? arg : (() => {
+					try {
+						return JSON.stringify(arg);
+					} catch {
+						return String(arg);
+					}
+				})()).join(" ")}`;
+				if (type === "error") console.error(line);
+				else if (type === "warn") console.warn(line);
+				else if (type === "debug") console.debug(line);
+				else console.info(line);
+			}
+		});
+	} catch {}
+}
+//#endregion
+export { Config, apply, inject };

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@lijian-ui/dsh-session-cleaner",
+  "version": "0.1.0",
+  "description": "Session management plugin for DeepSeek Harness (dsh): list / delete / archive & restore sessions, with a built-in \"Archived\" group and a delete confirm dialog (real delete, not trash). 为 DeepSeek Harness 提供会话管理：列表 / 真删除（二次确认）/ 归档分组与恢复。",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.d.ts",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "watch": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "session",
+    "session-cleaner",
+    "archive",
+    "delete",
+    "cordis"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lijian-ui/dsh-session-cleaner.git"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-api-gateway"
+      ],
+      "platform": "web",
+      "immediately": true
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "*",
+    "@deepseek-ai/schemastery": "*",
+    "@deepseek-ai/dsh-settings": "*",
+    "@deepseek-ai/dsh-typert-protocol": "*"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/schemastery": "3.18.1",
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-connection": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-schema-form": "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",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-api-gateway": "0.1.0-rc.6",
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.0",
+    "react": "^18.2.0",
+    "tsdown": "^0.12.0",
+    "typescript": "^5.6.0"
+  }
+}