dsh-vscode-mode 0.1.25 → 0.1.26

package/lib/client.js

@@ -1603,6 +1603,109 @@ window.__ModuleLoader__.load({
 			}
 		}
 		//#endregion
+		//#region src/client/state/viewStateCache.ts
+		/**
+		* dsh-vscode-mode client — 编辑器视图状态持久化（纯函数，可单测）。
+		* 对齐 VSCode workbench.editor.restoreViewState：恢复每个文件的光标/滚动/折叠位置。
+		* 视图状态 = Monaco editor.saveViewState() 返回值（JSON 可序列化），按 path 存储。
+		* 作者 ddj 2026-08-28
+		*/
+		/** localStorage 键前缀（按会话隔离）。 */
+		const KEY_PREFIX$1 = "edrv.cache.viewstate.v1.";
+		/**
+		* 判断对象是否为合法的 Monaco view state（保守形状校验，非深校验）。
+		* @author ddj 2026年08月28号
+		* @param value 待校验对象
+		* @returns 是否可接受
+		*/
+		function isViewStateLike(value) {
+			if (!value || typeof value !== "object") return false;
+			const v = value;
+			return Array.isArray(v.cursorState) || typeof v.viewState === "object" || Array.isArray(v.contributionsState);
+		}
+		/**
+		* 序列化视图状态映射（path → viewState）。
+		* @author ddj 2026年08月28号
+		* @param states path → viewState 映射
+		* @returns JSON 字符串
+		*/
+		function serializeViewStates(states) {
+			return JSON.stringify({
+				v: 1,
+				states
+			});
+		}
+		/**
+		* 解析视图状态文本；损坏/格式不符 → null。
+		* @author ddj 2026年08月28号
+		* @param text localStorage 原文
+		* @returns path → viewState 映射，非法返回 null
+		*/
+		function parseViewStates(text) {
+			if (!text) return null;
+			try {
+				const data = JSON.parse(text);
+				if (!data || typeof data !== "object") return null;
+				const states = data.states;
+				if (!states || typeof states !== "object" || Array.isArray(states)) return null;
+				const out = {};
+				for (const [path, state] of Object.entries(states)) {
+					if (typeof path !== "string" || !path) continue;
+					if (!isViewStateLike(state)) continue;
+					out[path] = state;
+				}
+				return out;
+			} catch (error) {
+				return null;
+			}
+		}
+		/**
+		* 把新视图状态并入既有映射：同 path 覆盖、按写入顺序裁剪到容量上限。
+		* @author ddj 2026年08月28号
+		* @param states 既有映射
+		* @param path 文件路径
+		* @param state 视图状态
+		* @returns 新映射（容量裁剪后）
+		*/
+		function upsertViewState(states, path, state) {
+			if (!path || !isViewStateLike(state)) return states;
+			try {
+				if (JSON.stringify(state).length > 65536) return states;
+			} catch (error) {
+				return states;
+			}
+			const next = Object.assign({}, states);
+			delete next[path];
+			next[path] = state;
+			const keys = Object.keys(next);
+			if (keys.length > 50) for (const k of keys.slice(0, keys.length - 50)) delete next[k];
+			return next;
+		}
+		/**
+		* 读取某会话的视图状态缓存（localStorage 不可用 → 空映射）。
+		* @author ddj 2026年08月28号
+		* @param sessionId 会话 id
+		* @returns path → viewState 映射
+		*/
+		function viewStatesLoad(sessionId) {
+			try {
+				return parseViewStates(window.localStorage.getItem(KEY_PREFIX$1 + String(sessionId))) ?? {};
+			} catch (error) {
+				return {};
+			}
+		}
+		/**
+		* 写入某会话的视图状态缓存（损坏/配额满 → 忽略）。
+		* @author ddj 2026年08月28号
+		* @param sessionId 会话 id
+		* @param states path → viewState 映射
+		*/
+		function viewStatesSave(sessionId, states) {
+			try {
+				window.localStorage.setItem(KEY_PREFIX$1 + String(sessionId), serializeViewStates(states));
+			} catch (error) {}
+		}
+		//#endregion
 		//#region src/client/ui/EditorView.ts
 		/**
 		* dsh-vscode-mode client — EditorView：中央 VSCode 式文件编辑器（编排层）。
@@ -1663,6 +1766,7 @@ window.__ModuleLoader__.load({
 			const viewRootRef = react.default.useRef(null);
 			const monacoRef = react.default.useRef(null);
 			const modelsRef = react.default.useRef(/* @__PURE__ */ new Map());
+			const viewStatesRef = react.default.useRef({});
 			const saveTimerRef = react.default.useRef(null);
 			const loadSeqRef = react.default.useRef(0);
 			const programmaticRef = react.default.useRef(false);
@@ -1714,8 +1818,42 @@ window.__ModuleLoader__.load({
 				});
 				if (select) setActive(path);
 			};
+			/**
+			* 保存当前活动文件的视图状态（光标/滚动/折叠）到会话缓存。
+			* @author ddj 2026年08月28号
+			* @param path 要保存的文件路径（缺省 = 当前 active）
+			*/
+			const saveViewState = (path) => {
+				const ed = editorRef.current;
+				const target = path ?? active;
+				if (!ed || !target) return;
+				try {
+					const state = ed.saveViewState();
+					if (!state) return;
+					viewStatesRef.current = upsertViewState(viewStatesRef.current, target, state);
+					viewStatesSave(sessionId, viewStatesRef.current);
+				} catch (e) {}
+			};
+			/**
+			* 恢复指定文件的视图状态（内容就绪、setModel 后调用；恢复后即消费删除）。
+			* @author ddj 2026年08月28号
+			* @param path 文件路径
+			*/
+			const restoreViewState = (path) => {
+				const ed = editorRef.current;
+				if (!ed || !path) return;
+				const saved = viewStatesRef.current[path];
+				if (!saved) return;
+				const next = Object.assign({}, viewStatesRef.current);
+				delete next[path];
+				viewStatesRef.current = next;
+				try {
+					ed.restoreViewState(saved);
+				} catch (e) {}
+			};
 			const closeTab = (path) => {
 				flushSave();
+				if (path === active) saveViewState(path);
 				setTabs((prev) => {
 					const idx = prev.findIndex((t) => t.path === path);
 					if (idx < 0) return prev;
@@ -1757,8 +1895,38 @@ window.__ModuleLoader__.load({
 					setRecords((prev) => sameRecords(prev, map) ? prev : map);
 				}).catch((e) => setError("list异常:" + String(e)));
 			};
-			const loadContent = (path, sid) => {
+			/**
+			* 加载文件内容（对齐 VSCode model 复用：会话内已打开的 model 直接秒显，
+			* 后台静默 RPC 校验防陈旧；首次打开走原读取流程）。
+			* @author ddj 2026年08月28号
+			* @param path 文件路径
+			* @param sid 会话 id
+			* @param force 强制走 RPC（reloadFile 用，跳过 model 复用）
+			*/
+			const loadContent = (path, sid, force) => {
 				const seq = ++loadSeqRef.current;
+				const cachedModel = force ? null : modelsRef.current.get(path);
+				if (cachedModel) {
+					setContent(cachedModel.getValue());
+					setContentPath(path);
+					setLoadStage((prev) => ({
+						progress: Math.max(84, prev.progress),
+						message: "文件已读取，准备创建编辑器…"
+					}));
+					setStatus("已加载");
+					rpc("edrv.read", {
+						sessionId: sid,
+						path
+					}).then((res) => {
+						if (seq !== loadSeqRef.current || path !== active) return;
+						if (res && res.ok && res.content !== cachedModel.getValue()) {
+							saveViewState(path);
+							setContent(res.content);
+							setStatus("已加载");
+						}
+					}).catch(() => {});
+					return;
+				}
 				setLoadError(null);
 				setLoadStage({
 					progress: monaco ? 72 : 12,
@@ -1886,6 +2054,7 @@ window.__ModuleLoader__.load({
 			react.default.useEffect(() => {
 				if (bootRef.current || !sessionId) return;
 				bootRef.current = true;
+				viewStatesRef.current = viewStatesLoad(sessionId);
 				try {
 					const raw = localStorage.getItem("edrv.editor.v2." + String(sessionId));
 					if (raw) {
@@ -2056,6 +2225,7 @@ window.__ModuleLoader__.load({
 				const ed = editorRef.current;
 				const model = getModel(active, content);
 				if (ed.getModel() !== model) ed.setModel(model);
+				restoreViewState(active);
 				setLoadStage((prev) => ({
 					progress: Math.max(96, prev.progress),
 					message: "创建编辑器视图…"
@@ -2080,6 +2250,7 @@ window.__ModuleLoader__.load({
 			]);
 			react.default.useEffect(() => () => {
 				flushSave();
+				saveViewState(active);
 				diffRendererRef.current?.dispose?.();
 				if (editorRef.current) {
 					editorRef.current.dispose();
@@ -2291,7 +2462,7 @@ window.__ModuleLoader__.load({
 			};
 			const reloadFile = (skipStale) => {
 				if (!active) return;
-				loadContent(active, sessionId);
+				loadContent(active, sessionId, true);
 				refreshRecords(skipStale === true);
 			};
 			/**
@@ -2556,6 +2727,7 @@ window.__ModuleLoader__.load({
 				onClick: () => {
 					if (t.path !== active) {
 						flushSave();
+						saveViewState(active);
 						setActive(t.path);
 					}
 				},
@@ -4297,6 +4469,108 @@ window.__ModuleLoader__.load({
 			return out;
 		}
 		//#endregion
+		//#region src/client/state/explorerCache.ts
+		/**
+		* dsh-vscode-mode client — 资源管理栏展开状态持久化（纯函数，可单测）。
+		* 对齐 VSCode：只持久化展开路径集合，不缓存目录条目数据（条目实时 listDir）。
+		* 作者 ddj 2026-08-28
+		*/
+		/** localStorage 键前缀（按会话隔离）。 */
+		const KEY_PREFIX = "edrv.cache.explorer.v1.";
+		/**
+		* 归一化展开路径：去空白、反斜杠→斜杠、去首尾斜杠，`..` 段拒绝。
+		* @author ddj 2026年08月28号
+		* @param rel 目录相对路径（'' = 根）
+		* @returns 归一化路径，非法返回 null
+		*/
+		function normalizeExpanded(rel) {
+			const s = String(rel ?? "").trim().replace(/\\/g, "/").replace(/^\/+|\/+$/g, "");
+			if (!s) return "";
+			const segs = s.split("/").filter((seg) => seg !== ".");
+			if (!segs.length) return "";
+			for (const seg of segs) if (seg === "..") return null;
+			return segs.join("/");
+		}
+		/**
+		* 裁剪展开路径集：去重、丢弃非法路径、超容量丢弃尾部（保持传入顺序）。
+		* @author ddj 2026年08月28号
+		* @param expanded 原始展开路径集合
+		* @returns 规范化后的路径数组
+		*/
+		function sanitizeExpanded(expanded) {
+			if (!Array.isArray(expanded)) return [];
+			const seen = /* @__PURE__ */ new Set();
+			const out = [];
+			for (const item of expanded) {
+				const rel = normalizeExpanded(typeof item === "string" ? item : null);
+				if (rel === null || seen.has(rel)) continue;
+				seen.add(rel);
+				out.push(rel);
+				if (out.length >= 500) break;
+			}
+			return out;
+		}
+		/**
+		* 序列化缓存数据（JSON；root 为 null 时省略，减小体积）。
+		* @author ddj 2026年08月28号
+		* @param data 缓存数据
+		* @returns JSON 字符串
+		*/
+		function serializeExplorer(data) {
+			const payload = data.root === null || data.root === void 0 ? {
+				v: 1,
+				expanded: data.expanded
+			} : {
+				v: 1,
+				root: data.root,
+				expanded: data.expanded
+			};
+			return JSON.stringify(payload);
+		}
+		/**
+		* 解析缓存文本；损坏/格式不符 → null。
+		* @author ddj 2026年08月28号
+		* @param text localStorage 原文
+		* @returns 解析后的缓存数据，非法返回 null
+		*/
+		function parseExplorer(text) {
+			if (!text) return null;
+			try {
+				const data = JSON.parse(text);
+				if (!data || typeof data !== "object") return null;
+				return {
+					root: typeof data.root === "string" && data.root ? data.root : null,
+					expanded: sanitizeExpanded(data.expanded)
+				};
+			} catch (error) {
+				return null;
+			}
+		}
+		/**
+		* 读取某会话的展开状态缓存（localStorage 不可用 → null）。
+		* @author ddj 2026年08月28号
+		* @param sessionId 会话 id
+		* @returns 缓存数据或 null
+		*/
+		function explorerLoad(sessionId) {
+			try {
+				return parseExplorer(window.localStorage.getItem(KEY_PREFIX + String(sessionId)));
+			} catch (error) {
+				return null;
+			}
+		}
+		/**
+		* 写入某会话的展开状态缓存（损坏/配额满 → 忽略）。
+		* @author ddj 2026年08月28号
+		* @param sessionId 会话 id
+		* @param data 缓存数据
+		*/
+		function explorerSave(sessionId, data) {
+			try {
+				window.localStorage.setItem(KEY_PREFIX + String(sessionId), serializeExplorer(data));
+			} catch (error) {}
+		}
+		//#endregion
 		//#region src/client/sidebar/panels/FileExplorer.ts
 		/**
 		* dsh-vscode-mode client — 侧边栏「文件管理」面板（懒加载目录树）。
@@ -4307,6 +4581,7 @@ window.__ModuleLoader__.load({
 		* 作者 ddj 2026-08-26 / 2026-08-27
 		*/
 		const DIR_CAP = 4e3;
+		const SAVE_DEBOUNCE_MS = 300;
 		/**
 		* 目录树面板主体。
 		* @param props.ctx 面板共享上下文（sessionId/openFile/activePath/pendingByPath/fileMenuItems/notify）
@@ -4326,6 +4601,7 @@ window.__ModuleLoader__.load({
 			const tokensRef = react.default.useRef({});
 			const expandedRef = react.default.useRef({});
 			expandedRef.current = expanded;
+			const saveTimerRef = react.default.useRef(null);
 			const loadDir = (rel) => {
 				const token = (tokensRef.current[rel] || 0) + 1;
 				tokensRef.current[rel] = token;
@@ -4383,8 +4659,42 @@ window.__ModuleLoader__.load({
 				setError(null);
 				setMenu(null);
 				setRoot(null);
+				const cached = sessionId ? explorerLoad(sessionId) : null;
+				const restored = cached?.expanded ?? [];
+				if (cached?.root) setRoot(cached.root);
+				if (restored.length) {
+					const next = {};
+					for (const rel of restored) next[rel] = true;
+					setExpanded(next);
+				}
 				loadDir("");
+				for (const rel of restored) if (rel) loadDir(rel);
 			}, [sessionId]);
+			react.default.useEffect(() => {
+				if (saveTimerRef.current) {
+					clearTimeout(saveTimerRef.current);
+					saveTimerRef.current = null;
+				}
+				if (!sessionId) return;
+				saveTimerRef.current = setTimeout(() => {
+					saveTimerRef.current = null;
+					const expandedList = Object.keys(expanded).filter((k) => expanded[k] === true);
+					explorerSave(sessionId, {
+						root,
+						expanded: expandedList
+					});
+				}, SAVE_DEBOUNCE_MS);
+				return () => {
+					if (saveTimerRef.current) {
+						clearTimeout(saveTimerRef.current);
+						saveTimerRef.current = null;
+					}
+				};
+			}, [
+				expanded,
+				root,
+				sessionId
+			]);
 			react.default.useEffect(() => {
 				const onRefresh = () => refresh();
 				window.addEventListener("edrv:refresh", onRefresh);