@lijian-ui/dsh-session-cleaner 0.1.2 → 0.1.3

package/lib/index.js

@@ -5,18 +5,30 @@ 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 会话 ID ↔ 文件系统目录名 编解码（与 dsh-session-persistence-jsonl 的 encodeSegment 对齐）。
-
 * dsh 把 sessionId 中的非 [A-Za-z0-9._-] 字符编码为 ~XXXX（charCode 的 4 位十六进制大写）。
-
 * 例如 `im:qq-s5ey:c2c:...` → `im~003Aqq-s5ey~003Ac2c~003A...`。
-
 * session-cleaner 扫描文件系统得到编码后的目录名，需要解码回原始 ID 才能与 workspace.json 的 sessionIds 匹配。
-
 */
 function encodeSegment(raw) {
 	if (raw.length === 0) return raw;
@@ -100,11 +112,8 @@ function writeArchived(archived) {
 	writeJsonAtomic(workspaceFile(), ws);
 }
 /**
-
 * 扫描全部 session（文件层权威）。
-
 * 遍历 ~/.dsh/sessions/<workspace>/<sessionId>/，结合 workspace.json 标注状态。
-
 */
 function listSessions() {
 	const root = sessionsRoot();
@@ -112,7 +121,7 @@ function listSessions() {
 	if (!fs.existsSync(root)) return out;
 	const archived = readArchived();
 	const ws = readWorkspace();
-	const activeIds = new Set();
+	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;
@@ -179,13 +188,9 @@ function removeFromProjcache(id) {
 	if (walk(data)) writeJsonAtomic(file, data);
 }
 /**
-
 * 真删除会话（不可恢复，调用方必须已二次确认）：
-
 * ① 删会话目录；② 清 projcache；③ 清 workspace.json（sessionIds + archivedSessionIds）。
-
 * 返回已删除的目录路径。
-
 */
 function deleteSession(id) {
 	const root = sessionsRoot();
@@ -230,13 +235,9 @@ function unarchiveSession(id) {
 	return { ok: true };
 }
 /**
-
 * 多帧 zstd 解码：dsh 的 session 日志每次追加写一个独立 zstd 帧
-
 * （文件里多个 magic 头），Node 的 zstdDecompressSync 只解第一帧——
-
 * 必须按 magic 位置逐帧解压拼接。
-
 */
 function zstdDecompressAll(input) {
 	const magic = Buffer.from([
@@ -264,8 +265,7 @@ function zstdDecompressAll(input) {
 function readSessionLines(logFile) {
 	try {
 		if (!fs.existsSync(logFile)) return null;
-		const raw = zstdDecompressAll(fs.readFileSync(logFile));
-		return raw.toString("utf8").split("\n").filter(Boolean);
+		return zstdDecompressAll(fs.readFileSync(logFile)).toString("utf8").split("\n").filter(Boolean);
 	} catch {
 		return null;
 	}
@@ -292,15 +292,14 @@ function extractHeader(lines) {
 			cwd: header.cwd
 		};
 	} catch {
-		return void 0;
+		return;
 	}
 }
 /** 从消息事件提取纯文本（宽容解析各种 content 形态） */
 function messageText(message) {
 	if (typeof message === "string") return message;
 	if (!message || typeof message !== "object") return "";
-	const m = message;
-	const content = m["content"];
+	const content = message["content"];
 	if (typeof content === "string") return content;
 	if (Array.isArray(content)) return content.map((part) => {
 		if (typeof part === "string") return part;
@@ -325,11 +324,8 @@ function readSessionTitle(logFile) {
 	return extractTitle(lines);
 }
 /**
-
 * 读取会话预览：header 元数据 + 最近 N 条用户/助手消息文本。
-
 * 找不到文件抛错（调用方转 RPC 错误）。
-
 */
 function previewSession(id, limit = 12) {
 	const root = sessionsRoot();
@@ -373,7 +369,6 @@ function previewSession(id, limit = 12) {
 		messages: messages.slice(-limit)
 	});
 }
-
 //#endregion
 //#region src/remote.ts
 const SERVICE = "sessionCleanerRemote";
@@ -384,11 +379,8 @@ const codec = (typeSymbol) => ({
 	schema: { parse: (v) => v }
 });
 /**
-
 * 注册到 `ctx.typert` 的 host 面契约。
-
 * face: 'host' + invocations（client 侧的 $mount 贡献则带 descriptors）。
-
 */
 const CONTRIBUTION = {
 	package: PACKAGE,
@@ -474,11 +466,8 @@ const CONTRIBUTION = {
 	}
 };
 /**
-
 * Remote 服务实现。构造时注册 `sessionCleanerRemote` cordis 服务，
-
 * 上面的贡献让 API gateway 能分发四个方法。
-
 */
 var SessionCleanerApi = class extends TypertRemoteService {
 	constructor(ctx) {
@@ -510,7 +499,6 @@ function registerSessionCleanerRemote(ctx) {
 	new SessionCleanerApi(ctx);
 	ctx.effect(() => ctx.get("typert").register(CONTRIBUTION), "session-cleaner: typert contribution");
 }
-
 //#endregion
 //#region src/index.ts
 /**
@@ -543,19 +531,17 @@ function apply(ctx) {
 */
 function installConsoleLoggerExporter(ctx) {
 	try {
-		const logger = ctx.root.logger;
-		logger?.exporter?.({
+		ctx.root.logger?.exporter?.({
 			colors: 0,
 			export: (message) => {
 				const { name = "session-cleaner", type = "log", args = [] } = message;
-				const rendered = args.map((arg) => arg instanceof Error ? arg.stack ?? arg.message : typeof arg === "string" ? arg : (() => {
+				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(" ");
-				const line = `[${name}] ${rendered}`;
+				})()).join(" ")}`;
 				if (type === "error") console.error(line);
 				else if (type === "warn") console.warn(line);
 				else if (type === "debug") console.debug(line);
@@ -564,6 +550,5 @@ function installConsoleLoggerExporter(ctx) {
 		});
 	} catch {}
 }
-
 //#endregion
-export { Config, apply, inject };
+export { Config, apply, inject };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lijian-ui/dsh-session-cleaner",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "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",