dsh-vscode-mode 0.13.0 → 0.14.0

package/lib/index.js

@@ -2349,6 +2349,29 @@ function pluginLogRoot(home = dshHome()) {
 function treeCacheFile(cwd, home = dshHome(), schema = 1) {
 	return join(workspaceCacheDir(hashOf(cwd), home), "tree.v" + schema + ".json");
 }
+/**
+* 每工作区 UI 状态镜像文件（工作区级：workspace/<id>/ui.v<schema>.json）。
+* 存编辑器页签/侧栏/预览态等界面状态的 localStorage 原值副本，供换 origin 后回填。
+* @author ddj 2026年09月28号
+* @param cwd 工作区绝对路径
+* @param home DSH home（测试可注入）
+* @param schema schema 版本（缺省 UI_STATE_SCHEMA）
+* @returns UI 状态镜像文件绝对路径
+*/
+function uiStateFile(cwd, home = dshHome(), schema = 1) {
+	return join(workspaceCacheDir(hashOf(cwd), home), "ui.v" + schema + ".json");
+}
+/**
+* 用户级 UI 状态镜像文件（跨工作区共享：user/ui-globals.v<schema>.json）。
+* 存与工作区无关的全局键（侧栏提示已忽略、工作区折叠态等）。
+* @author ddj 2026年09月28号
+* @param home DSH home（测试可注入）
+* @param schema schema 版本（缺省 UI_STATE_SCHEMA）
+* @returns 全局 UI 状态镜像文件绝对路径
+*/
+function uiGlobalsFile(home = dshHome(), schema = 1) {
+	return join(userCacheDir(home), "ui-globals.v" + schema + ".json");
+}
 /** 每工作区 debug 日志文件（用户级日志根下，按 cwd hash 隔离）。 */
 function debugLogFile(cwd, home = dshHome()) {
 	return join(pluginLogRoot(home), "debug." + hashOf(cwd) + ".log");
@@ -2377,10 +2400,36 @@ function imageDirOf(config, moduleUrl) {
 	if (cfg && typeof cfg.imageDir === "string" && cfg.imageDir) return cfg.imageDir.replace(/\\/g, "/");
 	return assetsDirOf(moduleUrl);
 }
-/** 树缓存文件名 → schema 版本（不匹配返回 null）。 */
-function treeSchemaOf(filename) {
-	const m = /^tree\.v(\d+)\./.exec(filename);
-	return m ? Number(m[1]) : null;
+/**
+* 已知缓存文件种类 → 当前 schema 版本（sweep 判旧依据）。
+* 新增缓存文件必须登记在此，否则被当作未知残留清理。
+*/
+const CACHE_SCHEMAS = {
+	tree: 1,
+	"lsp-specs": 4,
+	ui: 1,
+	"ui-globals": 1
+};
+/** 缓存文件名 → 种类与 schema 版本（`<kind>.v<schema>.json`；未登记种类/命名不合规 → null）。 */
+function parseCacheName(filename) {
+	const m = /^([a-z-]+)\.v(\d+)\.json$/.exec(filename);
+	if (!m) return null;
+	const kind = m[1];
+	if (CACHE_SCHEMAS[kind] === void 0) return null;
+	return {
+		kind,
+		schema: Number(m[2])
+	};
+}
+/**
+* 该缓存文件名是否为已登记种类的当前 schema 版本（sweep 判旧/判残留依据）。
+* @author ddj 2026年09月28号
+* @param filename 缓存文件名（不含目录）
+* @returns 已登记种类且版本为当前版本
+*/
+function isCurrentCacheFile(filename) {
+	const parsed = parseCacheName(filename);
+	return parsed !== null && parsed.schema === CACHE_SCHEMAS[parsed.kind];
 }
 /** 按「schema 版本 + 保留期」清扫某目录内文件（目录级，返回相对路径清单）。 */
 async function sweepDirFiles(dir, removed, now, dropAll) {
@@ -2389,9 +2438,7 @@ async function sweepDirFiles(dir, removed, now, dropAll) {
 		const full = join(dir, name);
 		let drop = dropAll;
 		if (!drop) {
-			const schema = treeSchemaOf(name);
-			if (schema === null) drop = true;
-			else if (schema !== 1) drop = true;
+			if (!isCurrentCacheFile(name)) drop = true;
 			else try {
 				if (now - (await stat(full)).mtimeMs > 2592e6) drop = true;
 			} catch (error) {
@@ -9214,6 +9261,125 @@ async function revealInExplorer(absPath, isDir) {
 		};
 	}
 }
+/**
+* 合并增量补丁到键值表（不改入参）。
+* @author ddj 2026年09月28号
+* @param base 已有键值表
+* @param patch 增量补丁（null/undefined 值删除该键；空键跳过）
+* @returns 合并后的新键值表
+*/
+function mergeUiStateKeys(base, patch) {
+	const merged = { ...base };
+	for (const [key, value] of Object.entries(patch)) {
+		if (!key) continue;
+		if (value === null || value === void 0) delete merged[key];
+		else merged[key] = String(value);
+	}
+	return merged;
+}
+/**
+* 解析镜像文件文本；损坏/版本不符 → null（调用方视为空）。
+* @author ddj 2026年09月28号
+* @param text 文件文本（可为空）
+* @returns 解析后的文档；不可用时 null
+*/
+function parseUiState(text) {
+	if (!text) return null;
+	let raw;
+	try {
+		raw = JSON.parse(text);
+	} catch (error) {
+		return null;
+	}
+	if (!raw || typeof raw !== "object") return null;
+	const doc = raw;
+	if (doc.version !== 1) return null;
+	if (!doc.keys || typeof doc.keys !== "object") return null;
+	const keys = {};
+	for (const [key, value] of Object.entries(doc.keys)) {
+		if (!key || typeof value !== "string") continue;
+		keys[key] = value;
+	}
+	return {
+		version: 1,
+		updatedAt: typeof doc.updatedAt === "string" ? doc.updatedAt : "",
+		keys
+	};
+}
+/**
+* 序列化为镜像文件文本。
+* @author ddj 2026年09月28号
+* @param keys 键值表
+* @param updatedAt 更新时间（缺省当前时间）
+* @returns 文件文本
+*/
+function serializeUiState(keys, updatedAt = (/* @__PURE__ */ new Date()).toISOString()) {
+	return JSON.stringify({
+		version: 1,
+		updatedAt,
+		keys
+	});
+}
+/** 同文件写队列尾（串行化并发写入；队列清空即移除条目）。 */
+const writeChains = /* @__PURE__ */ new Map();
+/**
+* 把写任务挂到该文件的队尾串行执行（前序失败不影响后续）。
+* @author ddj 2026年09月28号
+* @param file 目标文件绝对路径
+* @param run 实际写操作
+* @returns 本次写操作结果
+*/
+function chainWrite(file, run) {
+	const next = (writeChains.get(file) ?? Promise.resolve()).then(run, run);
+	const tail = next.then(() => void 0, () => void 0);
+	writeChains.set(file, tail);
+	tail.then(() => {
+		if (writeChains.get(file) === tail) writeChains.delete(file);
+	});
+	return next;
+}
+/**
+* 读取镜像文件的键值表（文件缺失/损坏/不可读 → 空表，静默）。
+* @author ddj 2026年09月28号
+* @param file 镜像文件绝对路径
+* @returns 键值表（localStorage 键 → 字符串原值）
+*/
+async function readUiState(file) {
+	try {
+		const doc = parseUiState(await readFile(file, "utf8"));
+		return doc ? doc.keys : {};
+	} catch (error) {
+		return {};
+	}
+}
+/**
+* 合并写入镜像文件（读旧 → 合并补丁 → 容量校验 → 原子替换），同文件写操作串行。
+* @author ddj 2026年09月28号
+* @param file 镜像文件绝对路径
+* @param patch 增量补丁（null/undefined 值删除该键）
+* @returns ok；超限或写入失败时 ok:false + 中文错误文案
+*/
+async function writeUiState(file, patch) {
+	return chainWrite(file, async () => {
+		try {
+			const json = serializeUiState(mergeUiStateKeys(await readUiState(file), patch));
+			if (Buffer$1.byteLength(json, "utf8") > 524288) return {
+				ok: false,
+				error: "界面状态镜像超出容量上限（524288 字节）"
+			};
+			await mkdir(dirname(file), { recursive: true });
+			const tmp = file + ".tmp";
+			await writeFile(tmp, json, "utf8");
+			await rename(tmp, file);
+			return { ok: true };
+		} catch (error) {
+			return {
+				ok: false,
+				error: "界面状态写入失败: " + (error instanceof Error ? error.message : String(error))
+			};
+		}
+	});
+}
 //#endregion
 //#region src/debugLog.ts
 /**
@@ -9931,6 +10097,12 @@ function settingsDocPath(configuredPath, requestedPath, platform = process.platf
 const staleCheckedAt = /* @__PURE__ */ new Map();
 /** stale 自动清理最小间隔。 */
 const STALE_CHECK_MIN_MS = 1e4;
+/**
+* 无会话期诊断的伪 cwd：冷启动早期本插件客户端就会上报界面状态镜像事件
+* （此时 `sessions` 可能尚未就绪，`requireSession` 会失败），退回本固定值落盘
+* `logs/debug.<hashOf(该值)>.log`，保证「换 origin 后没恢复」这类问题的诊断不丢。
+*/
+const UI_AUDIT_CWD = "ui-state";
 /** 记录 → 客户端视图（不含 before 全文，仅长度）；远程工作区附远端展示路径（issue #7）。 */
 function recView(record, ws = null) {
 	return {
@@ -10296,6 +10468,49 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				records: out
 			};
 		},
+		/**
+		* 界面状态镜像读取：回填换 origin（Web GUI 重启换端口）后丢失的 localStorage 界面状态。
+		* 文件缺失/损坏 → 空表（客户端自然不动作）。
+		* @author ddj 2026年09月28号
+		*/
+		"edrv.uiState.get": async (args) => {
+			const sc = await requireSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			return {
+				ok: true,
+				keys: await readUiState(uiStateFile(sc.cwd)),
+				globals: await readUiState(uiGlobalsFile())
+			};
+		},
+		/**
+		* 界面状态镜像写入：把客户端改动过的 `edrv.*` 键增量同步到 host 文件（空补丁不落盘）。
+		* 失败时写一条诊断日志（默认静默的客户端 dbg 之外的可查证据），并如实回错误由客户端逐键回退。
+		* @author ddj 2026年09月28号 / 2026年09月29号
+		*/
+		"edrv.uiState.set": async (args) => {
+			const sc = await requireSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const tasks = [];
+			if (args.keys && Object.keys(args.keys).length) tasks.push(writeUiState(uiStateFile(sc.cwd), args.keys));
+			if (args.globals && Object.keys(args.globals).length) tasks.push(writeUiState(uiGlobalsFile(), args.globals));
+			const failed = (await Promise.all(tasks)).find((item) => !item.ok);
+			if (failed && !failed.ok) {
+				const keyCount = Object.keys(args.keys ?? {}).length;
+				const globalCount = Object.keys(args.globals ?? {}).length;
+				debugRecord(ctx, sc.cwd, "界面状态镜像写入失败: " + failed.error + "（keys=" + keyCount + " 键, globals=" + globalCount + " 键）", "warn");
+				return {
+					ok: false,
+					error: failed.error
+				};
+			}
+			return { ok: true };
+		},
 		"edrv.accept": async (args) => {
 			const sc = await requireSession(ctx, args.sessionId);
 			if ("err" in sc) return {
@@ -10784,12 +10999,13 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			};
 		},
 		"edrv.debug": async (args) => {
+			const text = String(args.text ?? "");
 			const sc = await requireSession(ctx, args.sessionId);
-			if ("err" in sc) return {
-				ok: false,
-				error: sc.err
-			};
-			debugRecord(ctx, sc.cwd, String(args.text ?? ""), args.level);
+			if ("err" in sc) {
+				debugRecord(ctx, UI_AUDIT_CWD, text, args.level);
+				return { ok: true };
+			}
+			debugRecord(ctx, sc.cwd, text, args.level);
 			return { ok: true };
 		},
 		"edrv.dlog.list": async (args) => {