dsh-vscode-mode 0.15.4 → 0.15.5

package/README.md

@@ -465,13 +465,13 @@ profile 请替换为实际目标，不要把示例目录当成当前运行 profi
 
 ```bash
 # ① Git 安装（clone + prepare 构建；推荐打固定 tag）
-dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.15.4
+dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.15.5
 
 # ② npm 注册表（发布到 npm 后）
-dsh plugin --profile web add dsh-vscode-mode@0.15.4
+dsh plugin --profile web add dsh-vscode-mode@0.15.5
 
 # ③ GitHub Release tgz 直装（Release asset 可用后）
-dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.15.4/dsh-vscode-mode-0.15.4.tgz
+dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.15.5/dsh-vscode-mode-0.15.5.tgz
 ```
 
 > **DSH 版本政策（0.14.10 起）**：六项 DSH peer 统一声明为 `*`，不再维护逐版
@@ -809,6 +809,8 @@ Keep All / Undo All 却是亮的。修复：单文件 Keep / Undo 覆盖冲突
 完整变更见 [GitHub Releases](https://github.com/Lenonss/DSH_VsCodeMode/releases)。
 近期关键版本：
 
+- **v0.15.5**：**浮窗性能与客户端适配**——拖动/缩放改为逐帧直写几何、结束单次提交，多窗口共享视口监听；SVN 日志行表 memo 与选中集优化，冲突状态读取按批 4 并发。LSP 去抖发送前惰性读取全文，隐藏页面心跳目标周期降为 15 秒；兼容性摘要按版本、安装事实与用户选择显示适用诊断，补充搜索刷新回归。保留 0.15.4 全部功能；本次真实 GUI 未重测，用户已接受此发布缺口，未安装/重启当前实例，详见 [0.15.5 发布说明](docs/release-0.15.5.md)。
+
 - **v0.15.4**：**SVN 非模态浮窗与独立文件对比**——更新、日志、统计、补丁、目录对比及智能整理采用与文件编辑相同的页面内浮窗，支持移动、调整尺寸、点击置顶与后台 DSH 交互。文件对比不再占据主编辑区，保留二进制/编码提示和来源任务返回逻辑；确认类弹窗保持模态。真实 GUI 交互尚未验收，用户已接受此发布缺口；资源管理器“目录不存在”原因未定位，本版不宣称修复该提示。
 
 - **v0.15.3**：**搜索结果强制刷新**——目标文件内容被改动后，工作区搜索不再残留过期匹配：内容变更（编辑器保存、外部改动或结构变更）会自动重新执行当前查询，同关键词重搜不再命中 60 秒结果缓存（`edrv.searchContent` 新增 `force` 选项，仅本次调用跳过缓存读取、仍写入新结果）。更新后需重启 DSH Host；真实 GUI 现场重测尚未执行，发布不代表现场验收完成，详见 [0.15.3 发布说明](docs/release-0.15.3.md)。

package/lib/client.js

@@ -1258,32 +1258,38 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/ui/FloatingWindow.ts
 		/** Shared in-page window chrome, without a mask or focus trap. @author ddj 2026年10月14号 */
-		/** @private @author ddj 2026年10月14号 @param start Originating press. @param rect Initial bounds. @param sizing Resize mode. @param apply Commit bounds. @param done Gesture cleanup notification. @returns Gesture cancellation. */
-		function beginGesture(start, rect, sizing, apply, done) {
+		/** @private @author ddj 2026年10月14号 @param start Originating press. @param rect Initial bounds. @param sizing Resize mode. @param draw Paint live bounds without a render. @param apply Commit bounds once. @param done Gesture cleanup notification. @returns Gesture cancellation. */
+		function beginGesture(start, rect, sizing, draw, apply, done) {
 			let frame = null;
 			let next = rect;
-			/** @private @author ddj 2026年10月14号 Apply no more than once per frame. */
+			let moved = false;
+			/** @private @author ddj 2026年10月14号 Paint no more than once per frame. */
 			function paint() {
 				frame = null;
-				apply(next);
+				draw(next);
 			}
 			/** @private @author ddj 2026年10月14号 @param event Pointer motion. Ignore unrelated pointers. */
 			function move(event) {
 				if (event.pointerId !== start.pointerId) return;
 				event.preventDefault();
+				moved = true;
 				next = moveFloat(rect, event.clientX - start.clientX, event.clientY - start.clientY, sizing, window.innerWidth, window.innerHeight);
 				if (frame === null) frame = requestAnimationFrame(paint);
 			}
-			/** @private @author ddj 2026年10月14号 Remove listeners and commit pending geometry. */
+			/** @private @author ddj 2026年10月14号 Remove listeners, then commit the settled geometry exactly once. */
 			function stop() {
 				if (frame !== null) {
 					cancelAnimationFrame(frame);
-					paint();
+					frame = null;
 				}
 				window.removeEventListener("pointermove", move, true);
 				window.removeEventListener("pointerup", end, true);
 				window.removeEventListener("pointercancel", end, true);
 				window.removeEventListener("blur", stop);
+				if (moved) {
+					draw(next);
+					apply(next);
+				}
 				done();
 			}
 			/** @private @author ddj 2026年10月14号 @param event Pointer release. Only end originating gesture. */
@@ -1296,6 +1302,31 @@ window.__ModuleLoader__.load({
 			window.addEventListener("blur", stop);
 			return stop;
 		}
+		const resizeSinks = /* @__PURE__ */ new Set();
+		let resizeFrame = null;
+		/** @private @author ddj 2026年10月14号 Re-clamp every window at most once per frame. */
+		function onViewportResize() {
+			if (resizeFrame !== null) return;
+			resizeFrame = requestAnimationFrame(() => {
+				resizeFrame = null;
+				for (const sink of [...resizeSinks]) sink();
+			});
+		}
+		/** @private @author ddj 2026年10月14号 @param sink Per-window re-clamp callback. @returns Unsubscribe. */
+		function subscribeResize(sink) {
+			if (resizeSinks.size === 0) window.addEventListener("resize", onViewportResize);
+			resizeSinks.add(sink);
+			return () => {
+				resizeSinks.delete(sink);
+				if (resizeSinks.size === 0) {
+					window.removeEventListener("resize", onViewportResize);
+					if (resizeFrame !== null) {
+						cancelAnimationFrame(resizeFrame);
+						resizeFrame = null;
+					}
+				}
+			};
+		}
 		/** @public @author ddj 2026年10月14号 @param props Window contents and lifecycle callbacks. @returns Movable, resizable nonmodal portal. */
 		function FloatingWindow(props) {
 			const id = react.default.useId();
@@ -1306,29 +1337,40 @@ window.__ModuleLoader__.load({
 			const current = react.default.useRef(props.rect ?? bounds);
 			current.current = props.rect ?? bounds;
 			const cleanup = react.default.useRef(null);
+			const gesture = react.default.useRef(null);
 			react.default.useSyncExternalStore(watchFloats, floatVersion, floatVersion);
 			/** @private @author ddj 2026年10月14号 @param rect Next geometry. Notify controlled owner or retain local geometry. */
 			function apply(rect) {
 				if (latest.current.rect) latest.current.onBounds?.(rect);
 				else setBounds(rect);
 			}
+			/** @private @author ddj 2026年10月14号 @param rect Live gesture geometry. Write the DOM and hold it until the commit render lands. */
+			function draw(rect) {
+				gesture.current = rect;
+				const node = root.current;
+				if (!node) return;
+				node.style.left = rect.left + "px";
+				node.style.top = rect.top + "px";
+				node.style.width = rect.width + "px";
+				node.style.height = rect.height + "px";
+			}
 			/** @private @author ddj 2026年10月14号 End any active gesture. */
 			function cancel() {
 				cleanup.current?.();
 				cleanup.current = null;
 			}
-			/** @private @author ddj 2026年10月14号 Re-clamp after viewport resize. */
+			/** @private @author ddj 2026年10月14号 Re-clamp after viewport resize, preferring the gesture that just settled. */
 			function resize() {
 				cancel();
-				apply(clampFloat(current.current, window.innerWidth, window.innerHeight));
+				apply(clampFloat(gesture.current ?? current.current, window.innerWidth, window.innerHeight));
 			}
 			react.default.useEffect(() => {
 				raiseFloat(id);
-				window.addEventListener("resize", resize);
+				const off = subscribeResize(resize);
 				resize();
 				return () => {
+					off();
 					cancel();
-					window.removeEventListener("resize", resize);
 					dropFloat(id);
 				};
 			}, [id]);
@@ -1347,11 +1389,12 @@ window.__ModuleLoader__.load({
 				if (event.button !== 0 || !event.isPrimary) return;
 				cancel();
 				event.preventDefault();
-				cleanup.current = beginGesture(event, current.current, sizing, apply, clear);
+				cleanup.current = beginGesture(event, gesture.current ?? current.current, sizing, draw, apply, clear);
 			}
-			/** @private @author ddj 2026年10月14号 Clear completed gesture reference. */
+			/** @private @author ddj 2026年10月14号 Release the settled geometry once React has committed it. */
 			function clear() {
 				cleanup.current = null;
+				gesture.current = null;
 			}
 			/** @private @author ddj 2026年10月14号 @param event Title press. Preserve title action buttons. */
 			function moveStart(event) {
@@ -1372,7 +1415,8 @@ window.__ModuleLoader__.load({
 				}
 				props.onKeyDown?.(event);
 			}
-			const rect = clampFloat(props.rect ?? bounds, window.innerWidth, window.innerHeight);
+			const base = clampFloat(props.rect ?? bounds, window.innerWidth, window.innerHeight);
+			const rect = gesture.current ?? base;
 			return (0, react_dom.createPortal)(react.default.createElement("div", {
 				ref: root,
 				tabIndex: -1,
@@ -13177,19 +13221,21 @@ window.__ModuleLoader__.load({
 		/**
 		* 立即同步某文档到 host（首次打开/查询前保证服务器已认识该文档）。
 		* sessionId 缺失时仍发起请求：host 对唯一活跃会话有兜底解析，弃发会白白丢失文档归属。
-		* @author ddj 2026年08月27号 / 2026年09月11号
+		* @author ddj 2026年08月27号 / 2026年09月11号 / 2026年10月15号
 		* @param path 工作区相对路径
-		* @param text 文档全文
+		* @param text 文档全文；传函数表示**发送前才求值**（击键路径用它，避免为被去抖丢弃的中间态取全文）
 		* @param immediate true 立即发送，false 去抖
 		*/
 		async function syncDoc(path, text, immediate = false) {
-			if (!path || typeof text !== "string") return;
+			if (!path || typeof text !== "string" && typeof text !== "function") return;
 			if (immediate) {
 				clearPending(path);
+				const value = resolveText(text);
+				if (value === null) return;
 				await rpc("edrv.lsp.sync", {
 					sessionId: sessionId$1,
 					path,
-					text,
+					text: value,
 					version: nextDocVer(path)
 				}).catch(() => {});
 				return;
@@ -13197,14 +13243,32 @@ window.__ModuleLoader__.load({
 			clearPending(path);
 			syncTimers.set(path, setTimeout(() => {
 				syncTimers.delete(path);
+				const value = resolveText(text);
+				if (value === null) return;
 				rpc("edrv.lsp.sync", {
 					sessionId: sessionId$1,
 					path,
-					text,
+					text: value,
 					version: nextDocVer(path)
 				}).catch(() => {});
 			}, SYNC_DEBOUNCE_MS));
 		}
+		/**
+		* 取本次要同步的文本：字符串原样返回，函数形态在发送前求值。
+		* 取值抛错（model 已销毁）时返回 null 表示**放弃本次同步**——不能退回空串，
+		* 那会把 host 侧文档内容清掉，比漏一次同步严重得多（关闭路径由 closeDoc 负责）。
+		* @author ddj 2026年10月15号
+		* @param text 字符串或惰性取值函数
+		* @returns 待发送文本；无法取值时为 null
+		*/
+		function resolveText(text) {
+			if (typeof text === "string") return text;
+			try {
+				return String(text());
+			} catch (error) {
+				return null;
+			}
+		}
 		function clearPending(path) {
 			const timer = syncTimers.get(path);
 			if (timer) {
@@ -13677,7 +13741,7 @@ window.__ModuleLoader__.load({
 				if (!model || model.uri.scheme !== "edrv") return;
 				const path = pathOfModel(model);
 				if (!path) return;
-				const contentDisposer = model.onDidChangeContent(() => syncDoc(path, model.getValue()));
+				const contentDisposer = model.onDidChangeContent(() => syncDoc(path, () => model.getValue()));
 				const disposeDisposer = model.onWillDispose(() => {
 					closeDoc(path);
 					contentDisposer.dispose();
@@ -19045,10 +19109,38 @@ window.__ModuleLoader__.load({
 			}, item.copyFrom ? item.copyFrom + "@" + (item.copyFromRev ?? "?") : ""), buttons);
 		}
 		/**
+		* 单个数据行：浅比较包装（回调身份由父级 ref 转发保持稳定，故 memo 才可能命中）。
+		* @author ddj 2026年10月14号
+		*/
+		const LogItemRow = react.default.memo(LogItem);
+		/**
+		* 数据行容器（P0-14 上段）。独立 memo：只在条目列表/选中集/工作副本版号变化时重建行元素；
+		* 上段高度拖拽与弹窗缩放只改 LogList 的 height，不再逐帧重建整表（原先每帧 logRowsOf + N 个元素）。
+		* @author ddj 2026年10月14号
+		* @param props.list 过滤排序后的条目（非空）
+		* @param props.selectedRevs 可见选中的 revision 集合
+		* @param props.wcRev 工作副本版号（null = 不加粗）
+		* @param props.onPick 选中回调（event, item）
+		* @param props.onMenu 右键回调（event, item）
+		* @returns 行元素
+		*/
+		const LogRows = react.default.memo(function LogRows(props) {
+			const { list, selectedRevs, wcRev, onPick, onMenu } = props;
+			return react.default.createElement(react.default.Fragment, null, logRowsOf(list).map((row) => react.default.createElement(LogItemRow, {
+				key: row.item.revision + ":" + row.level,
+				item: row.item,
+				on: selectedRevs.has(row.item.revision),
+				wc: wcRev != null && row.item.revision === wcRev,
+				level: row.level,
+				onPick,
+				onMenu
+			})));
+		});
+		/**
 		* 上窗格列表（列头行 + 数据行 + 「加载更多」；P0-13 宽度受拖拽控制）。
 		* @author ddj 2026年09月16号 / 2026年09月17号
 		* @param props.list 过滤排序后的条目（null = 未加载）
-		* @param props.selected 选中条目数组（P1-3 多选；至少一条，由父级保证）
+		* @param props.selectedRevs 可见选中的 revision 集合（P1-3 多选；由父级按 revision 维护）
 		* @param props.keyword 过滤词（决定空态文案）
 		* @param props.busy 加载中
 		* @param props.truncated 是否可能还有更多
@@ -19061,19 +19153,17 @@ window.__ModuleLoader__.load({
 		* @returns 列表元素
 		*/
 		function LogList(props) {
-			const { list, selected, keyword, busy, truncated, sortKey, sortDir, onSort, onSortReset, onPick, onLoadMore, onItemMenu, height, wcRev } = props;
+			const { list, selectedRevs, keyword, busy, truncated, sortKey, sortDir, onSort, onSortReset, onPick, onLoadMore, onItemMenu, height, wcRev } = props;
 			let inner;
 			if (list === null) inner = react.default.createElement("div", { className: "edrv-tree-loading" }, busy ? "读取日志中…" : "尚未加载");
 			else if (!list.length) inner = react.default.createElement("div", { className: "edrv-tree-loading" }, keyword ? "无匹配条目" : "无提交历史");
-			else inner = logRowsOf(list).map((row) => react.default.createElement(LogItem, {
-				key: row.item.revision + ":" + row.level,
-				item: row.item,
-				on: selected.some((s) => s.revision === row.item.revision),
-				wc: wcRev != null && row.item.revision === wcRev,
-				level: row.level,
+			else inner = react.default.createElement(LogRows, {
+				list,
+				selectedRevs,
+				wcRev,
 				onPick,
 				onMenu: onItemMenu
-			}));
+			});
 			const more = truncated ? react.default.createElement("div", { className: "edrv-svnlog-more" }, react.default.createElement("button", {
 				className: "edrv-svn-act",
 				disabled: busy,
@@ -19393,7 +19483,9 @@ window.__ModuleLoader__.load({
 				sortKey,
 				sortDir
 			]);
-			const visibleSelected = sorted ? selected.filter((item) => sorted.some((x) => x.revision === item.revision)) : selected;
+			const sortedRevs = react.default.useMemo(() => sorted ? new Set(sorted.map((x) => x.revision)) : null, [sorted]);
+			const visibleSelected = react.default.useMemo(() => sortedRevs ? selected.filter((item) => sortedRevs.has(item.revision)) : selected, [sortedRevs, selected]);
+			const selectedRevs = react.default.useMemo(() => new Set(visibleSelected.map((item) => item.revision)), [visibleSelected]);
 			const current = visibleSelected.length ? visibleSelected[0] : sorted && sorted.length ? sorted[0] : null;
 			/** 点列头：同键切换升降，异键回落升序；复位入口在列头行（G10）。 */
 			const onSort = (key) => {
@@ -19492,24 +19584,26 @@ window.__ModuleLoader__.load({
 			* @param wantList 目标上段（修订列表）高度
 			* @param wantMsg 目标中段（提交信息）高度
 			*/
+			/** @private @author ddj 2026年10月14号 @param nextList 目标上段高度 @param nextMsg 目标中段高度 只在值真正变化时提交。 */
+			const applyFit = (nextList, nextMsg) => {
+				if (nextList !== listH) setListH(nextList);
+				if (nextMsg !== msgH) setMsgH(nextMsg);
+			};
 			const fitHeights = (wantList, wantMsg) => {
 				const total = bodyRef.current?.clientHeight ?? 0;
 				if (!total) {
-					setListH(wantList);
-					setMsgH(wantMsg);
+					applyFit(wantList, wantMsg);
 					return;
 				}
 				const paneOcc = paneRef.current?.offsetHeight ?? -1;
 				const chrome = paneOcc >= 0 ? Math.max(0, total - listH - msgH - paneOcc) : HSPLIT_TOTAL_PX;
 				const budget = total - PANE_KEEP_MIN - chrome;
 				if (budget < 260) {
-					setListH(Math.min(wantList, LIST_H_MIN));
-					setMsgH(Math.min(wantMsg, MSG_H_MIN));
+					applyFit(Math.min(wantList, LIST_H_MIN), Math.min(wantMsg, MSG_H_MIN));
 					return;
 				}
 				if (wantList + wantMsg <= budget) {
-					setListH(wantList);
-					setMsgH(wantMsg);
+					applyFit(wantList, wantMsg);
 					return;
 				}
 				const scale = budget / (wantList + wantMsg);
@@ -19522,8 +19616,7 @@ window.__ModuleLoader__.load({
 					nextMsg = MSG_H_MIN;
 					nextList = Math.min(nextList, budget - nextMsg);
 				}
-				setListH(nextList);
-				setMsgH(nextMsg);
+				applyFit(nextList, nextMsg);
 			};
 			const fitRef = react.default.useRef(null);
 			fitRef.current = () => fitHeights(listH, msgH);
@@ -19617,6 +19710,15 @@ window.__ModuleLoader__.load({
 					].filter(Boolean)
 				});
 			};
+			/** @author ddj 2026年10月14号 */
+			const rowCbs = react.default.useRef({
+				pick: null,
+				menu: null
+			});
+			rowCbs.current.pick = pickWithMods;
+			rowCbs.current.menu = onItemMenu;
+			const pickStable = react.default.useCallback((event, item) => rowCbs.current.pick?.(event, item), []);
+			const menuStable = react.default.useCallback((event, item) => rowCbs.current.menu?.(event, item), []);
 			/** 下窗格路径行右键菜单（P0-8；G8 目录不可开差异，G9 仓库外不可打开）。 */
 			const onPathMenu = (event, item, revision) => {
 				event.preventDefault();
@@ -19654,7 +19756,7 @@ window.__ModuleLoader__.load({
 				ref: bodyRef
 			}, react.default.createElement(LogList, {
 				list: sorted,
-				selected: visibleSelected,
+				selectedRevs,
 				keyword: query.trim(),
 				busy,
 				truncated,
@@ -19662,9 +19764,9 @@ window.__ModuleLoader__.load({
 				sortDir,
 				onSort,
 				onSortReset,
-				onPick: pickWithMods,
+				onPick: pickStable,
 				onLoadMore,
-				onItemMenu,
+				onItemMenu: menuStable,
 				height: listH,
 				wcRev
 			}), react.default.createElement(Splitter, {
@@ -26578,17 +26680,7 @@ window.__ModuleLoader__.load({
 				"aria-label": "关闭提示",
 				onClick: dismissHint
 			}, "×")) : null;
-			const fullView = (0, react_dom.createPortal)(react.default.createElement("div", {
-				"data-edrv-view": "1",
-				style: {
-					display: "flex",
-					flexDirection: "column",
-					flex: 1,
-					minWidth: 0,
-					minHeight: 0,
-					overflow: "hidden"
-				}
-			}, pathBar, sideHintEl, diskBanner(), editorArea, statusBar), fullHost, "edrv-full-editor");
+			const fullView = (0, react_dom.createPortal)(react.default.createElement(react.default.Fragment, null, pathBar, sideHintEl, diskBanner(), editorArea, statusBar), fullHost, "edrv-full-editor");
 			const mainCol = react.default.createElement("div", {
 				className: "edrv-main-col edrv-workbench",
 				style: {
@@ -26609,13 +26701,7 @@ window.__ModuleLoader__.load({
 				onBounds: floatBounds,
 				onFocus: selectGroup,
 				onReturn: returnPane
-			}, renderGroup(item.group))), dragPreview ? (0, react_dom.createPortal)(react.default.createElement("div", {
-				"data-edrv-view": "1",
-				style: {
-					display: "contents",
-					pointerEvents: "none"
-				}
-			}, dragPreview.rect ? react.default.createElement("div", {
+			}, renderGroup(item.group))), dragPreview ? (0, react_dom.createPortal)(react.default.createElement(react.default.Fragment, null, dragPreview.rect ? react.default.createElement("div", {
 				className: "edrv-drag-overlay",
 				style: dragPreview.rect
 			}, react.default.createElement("span", { className: "edrv-drop-label" }, dragPreview.label)) : null, react.default.createElement("div", {
@@ -29853,7 +29939,7 @@ window.__ModuleLoader__.load({
 			const warnings = report?.warnings ?? [];
 			const devForm = report?.devForm;
 			const versionText = report?.dshVersion ? "（DSH " + report.dshVersion + " · 插件 " + (report?.pluginVersion ?? "") + "）" : report?.pluginVersion ? "（插件版本 " + report.pluginVersion + "）" : "";
-			return react.default.createElement("section", { className: "vsm-general-page" }, react.default.createElement("h2", null, "兼容性"), react.default.createElement("p", null, "检测与其他插件 / DSH 版本的适配状态与已知问题。" + versionText), error && react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, error), devForm?.enabled && group("开发形态", react.default.createElement("div", { className: "vsm-compat-item ok" }, react.default.createElement("span", { className: "vsm-compat-name" }, "开发形态开启（工作区链接安装）"), react.default.createElement("span", { className: "vsm-compat-note" }, devForm.path))), group("版本适配", renderItems(report?.adapters)), group("外部插件与服务", renderItems(report?.external)), group("客户端适配", renderItems(getSummary?.() ?? [])), group("护栏", renderItems(report?.guards)), group("警告", warnings.length ? warnings.map((w, index) => react.default.createElement("div", {
+			return react.default.createElement("section", { className: "vsm-general-page" }, react.default.createElement("h2", null, "兼容性"), react.default.createElement("p", null, "检测与其他插件 / DSH 版本的适配状态与已知问题。" + versionText), error && react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, error), devForm?.enabled && group("开发形态", react.default.createElement("div", { className: "vsm-compat-item ok" }, react.default.createElement("span", { className: "vsm-compat-name" }, "开发形态开启（工作区链接安装）"), react.default.createElement("span", { className: "vsm-compat-note" }, devForm.path))), group("版本适配", renderItems(report?.adapters)), group("外部插件与服务", renderItems(report?.external)), group("客户端适配", renderItems(getSummary?.(report?.dshVersion ?? "") ?? [])), group("护栏", renderItems(report?.guards)), group("警告", warnings.length ? warnings.map((w, index) => react.default.createElement("div", {
 				key: index,
 				className: "vsm-mcp-error vsm-mcp-banner"
 			}, w)) : react.default.createElement("div", { className: "vsm-compat-item ok" }, react.default.createElement("span", { className: "vsm-compat-name" }, "未检测到兼容性问题"), react.default.createElement("span", { className: "vsm-compat-note" }, ""))));
@@ -30741,6 +30827,12 @@ window.__ModuleLoader__.load({
 		/** 深链移交轮询周期（兼活跃心跳）。 */
 		const HANDOFF_POLL_MS = 3e3;
 		/**
+		* 页面隐藏时的降频倍数（3s × 5 = 15s）。
+		* 必须仍短于 host 租约（src/externalHandoff.ts 的 LEASE_MS = 30s）：心跳一旦超期，
+		* host 判定该页面已死，launcher 会重复开新页——比多几次 RPC 更糟。
+		*/
+		const HIDDEN_POLL_EVERY = 5;
+		/**
 		* 装配外部深链：深链参数缺失时仅保持移交轮询（零额外开销）。
 		* @author ddj 2026年09月07号
 		* @param ctx 客户端根上下文（sessions/workspaces 服务）
@@ -30763,9 +30855,10 @@ window.__ModuleLoader__.load({
 			return dispose;
 		}
 		/**
-		* 深链移交轮询：每 3s 向 host 领取待打开请求（兼活跃心跳，launcher 据此决定是否开新页）。
+		* 深链移交轮询：可见时每 3s 向 host 领取待打开请求（兼活跃心跳，launcher 据此决定是否开新页）；
+		* 页面隐藏时降到 15s 一次——无人看页面时移交不必保持 3s 精度，但心跳不能停（超期会让 host 判页面已死）。
 		* 页面级单例（window 标记防 HMR 重复）；领取到即执行打开规则。
-		* @author ddj 2026年09月08号
+		* @author ddj 2026年09月08号 / 2026年10月15号
 		* @param ctx 客户端根上下文
 		*/
 		function startPresencePoll(ctx) {
@@ -30776,6 +30869,20 @@ window.__ModuleLoader__.load({
 			let disposed = false;
 			let polling = false;
 			let executing = false;
+			let ticks = 0;
+			/**
+			* 页面隐藏时按倍数跳轮；可见时每次都跑并清零计数。
+			* @author ddj 2026年10月15号
+			* @returns 是否跳过本轮
+			*/
+			function hiddenSkip() {
+				if (typeof document === "undefined" || document.visibilityState !== "hidden") {
+					ticks = 0;
+					return false;
+				}
+				ticks += 1;
+				return ticks % HIDDEN_POLL_EVERY !== 0;
+			}
 			/** @private @author ddj 2026年09月28号 Open all requested paths before acknowledging this exact lease. */
 			async function execute(open) {
 				executing = true;
@@ -30807,6 +30914,7 @@ window.__ModuleLoader__.load({
 				}
 			}
 			const timer = window.setInterval(() => {
+				if (hiddenSkip()) return;
 				tick().catch(() => {});
 			}, HANDOFF_POLL_MS);
 			/** @private @author ddj 2026年09月28号 Stop heartbeats and fail outstanding editor waits on plugin disposal. */
@@ -30882,6 +30990,80 @@ window.__ModuleLoader__.load({
 			setTimeout(() => toast.remove(), TOAST_MS);
 		}
 		//#endregion
+		//#region src/client/compatSummary.ts
+		/**
+		* Classify the API generation without importing the host's node-only version probe.
+		* @private @author ddj 2026年10月13号
+		* @param input Running DSH version from the compat RPC.
+		* @param patch First supported 0.1.x patch (alpha.1).
+		* @returns Whether that API generation is expected; undefined for unknown versions.
+		*/
+		function apiExpected(input, patch) {
+			const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z]+(?:\.[0-9A-Za-z]+)*))?(?:\+[0-9A-Za-z]+(?:\.[0-9A-Za-z]+)*)?$/.exec(input.trim());
+			if (!match) return void 0;
+			const major = Number(match[1]);
+			const minor = Number(match[2]);
+			const current = Number(match[3]);
+			if (major !== 0) return major > 0;
+			if (minor !== 1) return minor > 1;
+			if (current !== patch) return current > patch;
+			const pre = match[4];
+			if (!pre) return true;
+			const parts = pre.split(".");
+			if (/^\d+$/.test(parts[0])) return false;
+			if (parts[0] !== "alpha") return parts[0] > "alpha";
+			return parts.length > 1 && (/^\d+$/.test(parts[1]) ? Number(parts[1]) >= 1 : true);
+		}
+		/**
+		* Build only applicable diagnostics; explicit legacy choices still expose missing capabilities.
+		* @public @author ddj 2026年10月13号
+		* @param state Actual client installation facts and user selection.
+		* @param version Running DSH version; unknown versions retain conservative diagnostics.
+		* @returns Visible adapters, without changing routing or installation.
+		*/
+		function clientSummary(state, version = "") {
+			const remoteExpected = apiExpected(version, 3);
+			const officialExpected = apiExpected(version, 5);
+			const official = state.officialSidebar;
+			const legacyChosen = state.selected === SIDEBAR_PLUGIN;
+			const items = [{
+				name: "设置桥",
+				active: state.settingsReady,
+				note: state.settingsReady ? "使用 " + state.settingsService + " 桥" : "未绑定设置服务（持久化不可用，晚到重试窗口内自愈）"
+			}];
+			if (remoteExpected !== true && !state.remoteReady && !official) items.push({
+				name: "文件打开路由（workspaces.openPath）",
+				active: state.openPathReady,
+				note: "旧版对话文件链接路由，失败回退系统打开"
+			});
+			if (remoteExpected !== false || state.remoteReady) items.push({
+				name: "会话文件链接路由（remote.session.openWorkspacePath）",
+				active: state.remoteReady,
+				note: state.remoteReady ? "会话文件链接走插件打开器，失败回退系统打开" : "适用路由未安装（服务缺失或补丁失败）"
+			});
+			if (legacyChosen || state.sidebarOpener || !official && officialExpected !== true) items.push({
+				name: "侧边栏打开器（dsh-better-sidebar）",
+				active: state.sidebarOpener,
+				note: state.sidebarOpener ? "已注册（优先级 80）" : "未检测到侧边栏打开能力"
+			});
+			if (official || officialExpected !== false) items.push({
+				name: "侧边栏编辑区（官方 Sidebar）",
+				active: official,
+				note: official ? "编辑区=官方右侧 Sidebar Tab（对话+编辑同屏）" : "官方侧边栏服务未探测到"
+			});
+			if (!official && (state.legacySidebar || officialExpected !== true)) items.push({
+				name: "侧边栏编辑区（dsh-better-sidebar，归档）",
+				active: state.legacySidebar,
+				note: state.legacySidebar ? "编辑区=旧版侧边栏 Tab" : "旧版侧边栏回退能力未检测到"
+			});
+			if (state.fileClaim || state.claimWanted && (official || officialExpected !== false)) items.push({
+				name: "文件链接官方认领（dsh-resource://file）",
+				active: state.fileClaim,
+				note: state.fileClaim ? "聊天文件链接转发进单一编辑器页签" : "官方文件链接认领未安装"
+			});
+			return items;
+		}
+		//#endregion
 		//#region src/client/ui/SideEditorTab.ts
 		/**
 		* dsh-vscode-mode client — SideEditorTab：betterSidebar「文件编辑」Tab 的组件包装。
@@ -37841,44 +38023,24 @@ window.__ModuleLoader__.load({
 			let claimDisposer = null;
 			/** 「添加到对话」动作集：编辑区/Tab 右键菜单注入文件引用与代码块（conversation 服务缺失时各动作安全降级）。 */
 			const addToConversation = createAddToConversation(ctx);
-			/** 客户端侧兼容摘要（与 host 报告合并展示；惰性求值保证 HMR 后仍新鲜）。 */
-			const compatSummary = () => [
-				{
-					name: "设置桥",
-					active: bridge.scope() !== void 0,
-					note: bridge.scope() !== void 0 ? "使用 " + bridge.service() + " 桥" : "未绑定设置服务（fileOpenTool 持久化不可用，晚到重试窗口内自愈）"
-				},
-				{
-					name: "文件打开路由（workspaces.openPath）",
-					active: Boolean(workspaces?.openPath),
-					note: "vscode 打开器优先，失败回退系统打开（0.1.2 及更早 DSH 的对话文件链接主路径）"
-				},
-				{
-					name: "会话文件链接路由（remote.session.openWorkspacePath）",
-					active: remoteOpenInstalled,
-					note: "0.1.3+ 对话文件引用/产物打开优先走插件打开器，失败回退系统打开"
-				},
-				{
-					name: "侧边栏打开器（dsh-better-sidebar）",
-					active: registry.get(SIDEBAR_PLUGIN) !== void 0,
-					note: registry.get("dsh-better-sidebar") !== void 0 ? "已注册（优先级 80）" : "未检测到侧边栏打开能力"
-				},
-				{
-					name: "侧边栏编辑区（官方 Sidebar）",
-					active: officialService !== void 0,
-					note: officialService !== void 0 ? "编辑区=官方右侧 Sidebar Tab（对话+编辑同屏，DSH 0.1.5+）" : "官方侧边栏服务未探测到（DSH < 0.1.5-alpha.1 时属预期）"
-				},
-				{
-					name: "侧边栏编辑区（dsh-better-sidebar，归档）",
-					active: sideService !== void 0,
-					note: sideService !== void 0 ? "编辑区=侧边栏 Tab（旧版 DSH 回退形态）" : "未检测到；DSH ≥ 0.1.5 优先官方侧边栏，旧版可安装（" + SIDEBAR_INSTALL_CMD + "）"
-				},
-				{
-					name: "文件链接官方认领（dsh-resource://file）",
-					active: claimDisposer !== null,
-					note: claimDisposer !== null ? "聊天文件链接转发进单一编辑器页签（文件分页归编辑器自带页签栏）" : "链接走官方查看器或旧版路由（未认领）"
-				}
-			];
+			/**
+			* Build applicable client diagnostics from live installation state.
+			* @private @author ddj 2026年10月13号
+			* @param version Running DSH version supplied by the compat RPC.
+			* @returns Applicable adapters; routing behavior is unchanged.
+			*/
+			const compatSummary = (version = "") => clientSummary({
+				settingsService: bridge.service(),
+				settingsReady: bridge.scope() !== void 0,
+				openPathReady: Boolean(workspaces?.openPath),
+				remoteReady: remoteOpenInstalled,
+				sidebarOpener: registry.get(SIDEBAR_PLUGIN) !== void 0,
+				legacySidebar: sideService !== void 0,
+				officialSidebar: officialService !== void 0,
+				fileClaim: claimDisposer !== null,
+				claimWanted: shouldClaimFiles(selected),
+				selected
+			}, version);
 			ctx.provide("fileOpeners", registry);
 			ctx.effect(() => registry.register(vscodeOpener()), "vscode-mode: file opener");
 			const sidebarPanels = createSidebarPanelRegistry();