dsh-vscode-mode 0.26.0 → 0.27.0

package/lib/client.js

@@ -414,6 +414,16 @@ window.__ModuleLoader__.load({
 				}
 				/** @private @author ddj 2026年10月14号 @param event Keyboard activation. */
 				function key(event) {
+					if (event.key === "ContextMenu" || event.shiftKey && event.key === "F10") {
+						event.preventDefault();
+						event.stopPropagation();
+						const rect = event.currentTarget.getBoundingClientRect();
+						props.onMenu(tab.path, {
+							clientX: rect.left,
+							clientY: rect.bottom
+						});
+						return;
+					}
 					if (event.key === "Enter" || event.key === " ") {
 						event.preventDefault();
 						props.onSelect(group.id, tab.path);
@@ -3469,11 +3479,23 @@ window.__ModuleLoader__.load({
 		*/
 		function refreshFeed(sessionId, skipStale = false) {
 			const entry = entryOf(sessionId);
+			entry.queuedSkipStale = entry.queuedSkipStale === void 0 ? skipStale : entry.queuedSkipStale && skipStale;
+			if (typeof document !== "undefined" && document.hidden) {
+				entry.queued = true;
+				return Promise.resolve();
+			}
+			if (entry.inflight) {
+				entry.queued = true;
+				return entry.request ?? Promise.resolve();
+			}
+			skipStale = entry.queuedSkipStale ?? skipStale;
+			entry.queuedSkipStale = void 0;
 			const current = ++entry.seq;
 			entry.inflight = true;
+			entry.controller = new AbortController();
 			const payload = { sessionId };
 			if (skipStale) payload.skipStale = true;
-			return rpc("edrv.list", payload).then((res) => {
+			entry.request = rpc("edrv.list", payload, entry.controller.signal).then((res) => {
 				if (current !== entry.seq) return;
 				if (!res || !res.ok || !Array.isArray(res.records)) return;
 				entry.records = res.records;
@@ -3485,8 +3507,14 @@ window.__ModuleLoader__.load({
 					listener(message);
 				} catch {}
 			}).finally(() => {
-				if (current === entry.seq) entry.inflight = false;
+				if (current !== entry.seq) return;
+				entry.inflight = false;
+				if (entry.queued) {
+					entry.queued = false;
+					if (feeds$1.get(sessionId) === entry) return refreshFeed(sessionId, entry.queuedSkipStale ?? false);
+				}
 			});
+			return entry.request;
 		}
 		/**
 		* 确保该会话的定时器与 refresh 事件监听已就绪（首个订阅者到来时启动）。
@@ -3496,12 +3524,26 @@ window.__ModuleLoader__.load({
 		*/
 		function ensureTimer$1(sessionId, entry) {
 			if (entry.timer === null) entry.timer = setInterval(() => {
+				if (typeof document !== "undefined" && document.hidden) return;
 				const tickers = Array.from(entry.tickers);
 				for (const tick of tickers) try {
 					tick();
 				} catch {}
 				if (entry.listeners.size > 0 || entry.errorListeners.size > 0) refreshFeed(sessionId);
 			}, FEED_INTERVAL_MS);
+			if (!entry.onVisible && typeof document !== "undefined") {
+				entry.onVisible = () => {
+					if (document.hidden) return;
+					for (const tick of entry.tickers) try {
+						tick();
+					} catch {}
+					if (entry.listeners.size || entry.errorListeners.size) {
+						entry.queued = false;
+						refreshFeed(sessionId);
+					}
+				};
+				document.addEventListener("visibilitychange", entry.onVisible);
+			}
 			if (entry.onRefresh === null) {
 				const handler = () => {
 					refreshFeed(sessionId);
@@ -3518,12 +3560,16 @@ window.__ModuleLoader__.load({
 		* @param entry 订阅槽位
 		*/
 		function releaseIfIdle(sessionId, entry) {
-			if (entry.listeners.size || entry.tickers.size || entry.errorListeners.size) return;
+			if (feeds$1.get(sessionId) !== entry || entry.listeners.size || entry.tickers.size || entry.errorListeners.size) return;
 			if (entry.timer !== null) clearInterval(entry.timer);
 			if (entry.onRefresh !== null) {
 				const target = win();
 				if (target) target.removeEventListener("edrv:refresh", entry.onRefresh);
 			}
+			entry.seq++;
+			entry.queued = false;
+			entry.controller?.abort();
+			if (entry.onVisible && typeof document !== "undefined") document.removeEventListener("visibilitychange", entry.onVisible);
 			feeds$1.delete(sessionId);
 		}
 		/**
@@ -3588,6 +3634,10 @@ window.__ModuleLoader__.load({
 		/** @private @author ddj 2026年10月26号 @param sessionId Scope. @param entry Current generation. @returns First-page metadata update; no overlap or late publication. */
 		async function refresh(sessionId, entry, force = false) {
 			if (entry.controller.signal.aborted) return;
+			if (typeof document !== "undefined" && document.hidden) {
+				entry.again = true;
+				return;
+			}
 			if (entry.loading) {
 				entry.again = true;
 				return;
@@ -3641,17 +3691,25 @@ window.__ModuleLoader__.load({
 				};
 				feeds.set(sessionId, entry);
 				if (typeof window !== "undefined") window.addEventListener("edrv:refresh", onRefresh);
+				if (typeof document !== "undefined") {
+					const current = entry;
+					entry.onVisible = () => {
+						if (!document.hidden) refresh(sessionId, current);
+					};
+					document.addEventListener("visibilitychange", entry.onVisible);
+				}
 				refresh(sessionId, entry);
 			}
 			entry.listeners.add(listener);
 			listener(entry.value);
 			return () => {
 				entry.listeners.delete(listener);
-				if (entry.listeners.size) return;
+				if (entry.listeners.size || feeds.get(sessionId) !== entry) return;
 				entry.controller.abort();
 				clearTimeout(entry.timer);
 				feeds.delete(sessionId);
 				if (typeof window !== "undefined") window.removeEventListener("edrv:refresh", entry.onRefresh);
+				if (entry.onVisible && typeof document !== "undefined") document.removeEventListener("visibilitychange", entry.onVisible);
 			};
 		}
 		/** @public @author ddj 2026年10月26号 @param sessionId Refresh metadata after a decision; does not alter legacy or disk. */
@@ -376726,9 +376784,15 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 		*/
 		function resolveNavLine(params) {
 			const line = (params ?? {})?.line;
-			if (typeof line !== "number" || !Number.isFinite(line) || line <= 0) return void 0;
+			if (typeof line !== "number" || !Number.isFinite(line) || line < 1) return void 0;
 			return Math.floor(line);
 		}
+		/** @public @author ddj 2026年11月04号 @param params Plugin navigation extension. @returns Positive column only alongside a valid line; official line-only callers remain unchanged. */
+		function resolveNavColumn(params) {
+			if (!resolveNavLine(params)) return void 0;
+			const column = params?.column;
+			return typeof column === "number" && Number.isFinite(column) && column >= 1 ? Math.floor(column) : void 0;
+		}
 		/** 逐段 component 解码（失败返回 null，对齐官方 parseFileAddress 的容错语义）。 */
 		function decodeSegment(raw) {
 			if (raw === void 0) return null;
@@ -376749,7 +376813,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 		*/
 		function parseOfficialFileAddress(address) {
 			if (typeof address !== "string" || !address.startsWith("dsh-resource://file/")) return null;
-			const [scope, ...tail] = address.slice(20).split("/");
+			const [scope, ...tail] = address.split(/[?#]/, 1)[0].slice(20).split("/");
 			const kind = decodeSegment(scope);
 			if (kind === "session") {
 				const sessionId = decodeSegment(tail[0]);
@@ -376817,10 +376881,16 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 		* @param preview 可选 Markdown 渲染模式（行号导航优先源码）
 		* @returns 转发是否成功（openTab 抛错返回 false，由调用方决定重试或兜底）
 		*/
-		function forwardToEditor(service, path, line, preview) {
+		function forwardToEditor(service, path, line, preview, column) {
 			if (!service || typeof service.openTab !== "function" || !path) return false;
 			const params = { openPath: path };
-			if (line !== void 0) params.line = line;
+			const validLine = resolveNavLine({ line });
+			if (validLine !== void 0) params.line = validLine;
+			const validColumn = resolveNavColumn({
+				line: validLine,
+				column
+			});
+			if (validColumn !== void 0) params.column = validColumn;
 			if (preview !== void 0) params.preview = preview;
 			try {
 				service.openTab(OFFICIAL_TAB_KIND, { params });
@@ -386122,6 +386192,8 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			at: 0
 		};
 		let progressListeners = /* @__PURE__ */ new Set();
+		let statusRequest = null;
+		let statusEpoch = 0;
 		/** 会话 id 变更通知（EditorView 持有权威 sessionId，经窗口事件回填）。 */
 		const SESSION_EVENT = "edrv:lsp-session";
 		/** 上报可见状态（复用 EditorView 的状态通道；失败不再静默）。 */
@@ -386141,6 +386213,11 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			syncTimers.clear();
 			docVersions.clear();
 			sessionId$1 = id;
+			statusEpoch++;
+			statusCache = {
+				servers: [],
+				at: 0
+			};
 			refreshStatus();
 		}
 		/**
@@ -386400,17 +386477,35 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			if (!res || !res.tokens || !Array.isArray(res.tokens.data)) return null;
 			return res.tokens;
 		}
-		/** 拉取服务器状态（带 5s 缓存）。 */
+		/** @public @author ddj 2026年11月04号 @param force Bypass cached data, not the in-flight guard. @returns Current-session server status; stale responses never publish. */
 		async function refreshStatus(force = false) {
+			if (statusRequest) {
+				const pending = statusRequest;
+				await pending.promise;
+				if (pending.epoch !== statusEpoch) return refreshStatus(force);
+				return statusCache.servers;
+			}
+			if (typeof document !== "undefined" && document.hidden) return statusCache.servers;
 			if (!force && Date.now() - statusCache.at < 1500) return statusCache.servers;
-			const res = await rpc("edrv.lsp.status", { sessionId: sessionId$1 }).catch(() => null);
-			const servers = res && res.ok && Array.isArray(res.servers) ? res.servers : [];
-			statusCache = {
-				servers,
-				at: Date.now()
+			const epoch = statusEpoch, owner = sessionId$1;
+			const request = {
+				epoch,
+				promise: rpc("edrv.lsp.status", { sessionId: owner }).catch(() => null)
 			};
-			publishProgress();
-			return servers;
+			statusRequest = request;
+			try {
+				const res = await request.promise;
+				if (epoch !== statusEpoch || owner !== sessionId$1) return statusCache.servers;
+				const servers = res && res.ok && Array.isArray(res.servers) ? res.servers : [];
+				statusCache = {
+					servers,
+					at: Date.now()
+				};
+				publishProgress();
+				return servers;
+			} finally {
+				if (statusRequest === request) statusRequest = null;
+			}
 		}
 		/** file:// 或已转 edrv:// 的 LSP location → Monaco Location（edrv:// uri + 1-based range）。 */
 		function toClientLocation(loc) {
@@ -389483,6 +389578,13 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 					label: "添加到对话",
 					disabled: !(hasSession && canAddToConversation)
 				},
+				...state.forgeReady ? [{
+					id: "forge-open",
+					label: "打开 Forge"
+				}, {
+					id: "forge-local",
+					label: "查看本地变更（Forge）"
+				}] : [],
 				{
 					id: "close",
 					label: "关闭",
@@ -394409,9 +394511,11 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 					page: null,
 					error: ""
 				});
-				if (!sessionId) return void 0;
-				return subscribeReview(sessionId, setReview);
 			}, [sessionId]);
+			react$1.default.useEffect(() => {
+				if (!sessionId || props.visible === false) return void 0;
+				return subscribeReview(sessionId, setReview);
+			}, [sessionId, props.visible]);
 			const [tabs, setTabs] = react$1.default.useState([]);
 			const [active, setDiskActive] = react$1.default.useState(null);
 			const [planTabs, setPlanTabs] = react$1.default.useState([]);
@@ -395720,7 +395824,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				});
 			};
 			react$1.default.useEffect(() => {
-				if (!sessionId) return void 0;
+				if (!sessionId || props.visible === false) return void 0;
 				const offRecords = subscribeRecords(sessionId, applyRecords);
 				const offErrors = subscribeErrors(sessionId, (message) => setError("list异常:" + message));
 				refreshRecords();
@@ -395728,7 +395832,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 					offRecords();
 					offErrors();
 				};
-			}, [sessionId]);
+			}, [sessionId, props.visible]);
 			/**
 			* 展示外部同步提示（按路径+类型去重：同一文件重复回调不重置已关闭的提示）。
 			* @author ddj 2026年09月15号
@@ -395847,17 +395951,31 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				onDiskChange: (change) => diskChangeRef.current?.(change)
 			});
 			react$1.default.useEffect(() => {
-				const publishLsp = (servers) => setLspServers(Array.isArray(servers) ? servers : []);
+				let alive = true;
+				let loading = false;
+				const publishLsp = (servers) => {
+					if (alive) setLspServers(Array.isArray(servers) ? servers : []);
+				};
+				const refreshLsp = async () => {
+					if (loading || props.visible === false || document.hidden) return;
+					loading = true;
+					try {
+						publishLsp(await refreshStatus(true));
+					} finally {
+						loading = false;
+					}
+				};
 				const unsubscribe = onLspProgress(publishLsp);
-				refreshStatus(true).then(publishLsp);
-				const timer = setInterval(() => {
-					refreshStatus(true).then(publishLsp);
-				}, 1500);
+				refreshLsp();
+				const timer = setInterval(refreshLsp, 1500);
+				document.addEventListener("visibilitychange", refreshLsp);
 				return () => {
+					alive = false;
 					unsubscribe();
 					clearInterval(timer);
+					document.removeEventListener("visibilitychange", refreshLsp);
 				};
-			}, [sessionId]);
+			}, [sessionId, props.visible]);
 			react$1.default.useEffect(() => {
 				if (!sessionId) return;
 				setSession(sessionId);
@@ -395907,6 +396025,9 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			const fileOpenRef = react$1.default.useRef(null);
 			/** @private @author ddj 2026年10月08号 @param e Routed file request. Always uses the current workspace and save/preview callbacks. */
 			fileOpenRef.current = (e) => {
+				if (e?.detail?.sessionId && e.detail.sessionId !== sessionId) return;
+				if (e?.detail?.ownerId && e.detail.ownerId !== props?.ownerId) return;
+				if (!e?.detail?.ownerId && props?.visible === false) return;
 				const p = e?.detail?.path;
 				if (!p) return;
 				const normalized = tabPath(p);
@@ -398670,6 +398791,8 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			}
 			const tabMenuActions = (path) => ({
 				"add-to-conversation": () => addRefToChat(path),
+				"forge-open": () => props.forge?.open(sessionId),
+				"forge-local": () => props.forge?.open(sessionId, true),
 				"split-left": () => splitTab(path, "left"),
 				"split-right": () => splitTab(path, "right"),
 				"split-top": () => splitTab(path, "top"),
@@ -398716,6 +398839,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 					cwd,
 					hasSession: Boolean(sessionId),
 					canAddToConversation: Boolean(addToConversation),
+					forgeReady: props.forge?.available() === true,
 					canSplit: workbench.groups.length < 8 && !workbench.floats.some((item) => item.group === ownerOf(workbench, tabMenu.path)?.id),
 					canFloat: workbench.groups.length < 8,
 					canReturn: ownerOf(workbench, tabMenu.path)?.id !== MAIN_GROUP,
@@ -399098,6 +399222,48 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 					y: event.clientY
 				});
 			}
+			const menuOwner = react$1.default.useRef({
+				sessionId,
+				scope,
+				alive: true
+			});
+			menuOwner.current.sessionId = sessionId;
+			menuOwner.current.scope = scope;
+			const menuValid = react$1.default.useRef(null);
+			react$1.default.useEffect(() => {
+				menuOwner.current.alive = props.visible !== false;
+				return () => {
+					menuOwner.current.alive = false;
+					if (menuValid.current) props.officialMenus?.invalidate(menuValid.current);
+				};
+			}, [
+				sessionId,
+				scope,
+				props.visible,
+				props.officialMenus
+			]);
+			react$1.default.useEffect(() => {
+				if (!tabMenu || !props.officialMenus || !sessionId) return;
+				const capturedSession = sessionId;
+				const capturedScope = scope;
+				const path = tabMenu.path;
+				const groupId = ownerOf(benchRef.current, path)?.id;
+				const valid = () => menuOwner.current.alive && menuOwner.current.sessionId === capturedSession && menuOwner.current.scope === capturedScope && ownerOf(benchRef.current, path)?.id === groupId && tabsRef.current.some((tab) => tab.path === path);
+				menuValid.current = valid;
+				const items = tabMenuEntries().map((entry) => ({
+					...entry,
+					run: entry.onClick ?? (() => {})
+				}));
+				if (props.officialMenus.open("tab", sessionId, path, {
+					x: tabMenu.x,
+					y: tabMenu.y
+				}, items, valid)) setTabMenu(null);
+			}, [
+				tabMenu,
+				props.officialMenus,
+				sessionId,
+				scope
+			]);
 			/** @private @author ddj 2026年10月14号 @param group Auxiliary group. Return documents rather than closing them. */
 			function returnPane(group) {
 				acceptLayout(returnGroup(benchRef.current, group));
@@ -399877,6 +400043,9 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				editor: () => editorRef.current,
 				outlineSources: props.outlineSources,
 				fileMenuItems: props.fileMenuItems,
+				officialMenus: props.officialMenus,
+				visible: props.visible,
+				forge: props.forge,
 				addToConversation,
 				svn: svnStatus,
 				svnChanges,
@@ -403933,6 +404102,144 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			return new McpSessionState(fetchStatus, document);
 		}
 		//#endregion
+		//#region src/client/forgeBridge.ts
+		/** @public @author ddj 2026年11月04号 @param ctx Client capabilities. @param current Current session reader. @returns Capability-gated official navigation, with no polling or writes. */
+		function forgeBridge(ctx, current) {
+			const capabilities = () => {
+				try {
+					return {
+						tabs: ctx.get("sidebarRightTabs"),
+						service: ctx.get("sidebarRight")
+					};
+				} catch {
+					return;
+				}
+			};
+			return {
+				available() {
+					const capabilitiesNow = capabilities();
+					return Boolean(capabilitiesNow?.tabs?.get?.("forge-panel") && capabilitiesNow.tabs.get("forge-changes") && capabilitiesNow.service?.openTab && capabilitiesNow.service.openResource);
+				},
+				open(sessionId, local = false) {
+					if (!sessionId || current() !== sessionId || !this.available()) return false;
+					const service = capabilities().service;
+					try {
+						if (local) service.openResource("dsh-resource://forge-changes/" + encodeURIComponent(sessionId) + "/local", { kind: "forge-changes" });
+						else service.openTab("forge-panel");
+						return true;
+					} catch {
+						return false;
+					}
+				}
+			};
+		}
+		//#endregion
+		//#region src/client/contextMenusOfficial.ts
+		let ownerSeq = 0;
+		/** @public @author ddj 2026年11月04号 @param ctx Optional service context. @returns Retry-on-use bridge for late service registration, with legacy fallback. */
+		function lazyMenus(ctx) {
+			let bridge;
+			let stopped = false;
+			return {
+				open(...args) {
+					if (stopped) return false;
+					bridge ??= officialMenus(ctx);
+					return bridge?.open(...args) ?? false;
+				},
+				invalidate(valid) {
+					bridge?.invalidate(valid);
+				},
+				dispose() {
+					stopped = true;
+					bridge?.dispose();
+					bridge = void 0;
+				}
+			};
+		}
+		/** @public @author ddj 2026年11月04号 @param ctx Optional service context. @returns Scoped bridge or no capability, preserving the existing popup. */
+		function officialMenus(ctx) {
+			let service;
+			try {
+				service = ctx.get("contextMenus");
+			} catch {
+				return;
+			}
+			if (!service || typeof service.register !== "function" || typeof service.open !== "function" || typeof service.close !== "function") return void 0;
+			const owner = "edrv-menu-" + ++ownerSeq;
+			let current;
+			let revision = 0;
+			let stopped = false;
+			const disposers = [];
+			try {
+				for (const kind of ["resource", "tab"]) disposers.push(service.register({
+					id: owner + "-" + kind,
+					target: "edrv." + kind,
+					order: 30,
+					resolve: (target, signal) => {
+						const opening = current;
+						if (stopped || target.owner !== owner || !opening || !opening.valid() || signal.aborted) return [];
+						return opening.items.map((item) => ({
+							id: item.id,
+							label: item.label,
+							disabled: item.disabled,
+							danger: item.danger,
+							separatorBefore: item.separator,
+							commandId: item.commandId,
+							run: async () => {
+								if (stopped || opening.revision !== revision || !opening.valid() || item.disabled) return;
+								await item.run();
+							}
+						}));
+					}
+				}));
+			} catch {
+				for (const dispose of disposers) dispose();
+				return;
+			}
+			/** @private @author ddj 2026年11月04号 Close only this bridge's active shared popup. */
+			function closeOwned() {
+				const active = service.active?.getSnapshot();
+				if (active?.value?.owner === owner && (active.kind === "edrv.resource" || active.kind === "edrv.tab")) service.close();
+			}
+			return {
+				open(kind, sessionId, path, point, items, valid) {
+					if (stopped || !sessionId || !valid()) return false;
+					current = {
+						items,
+						valid,
+						revision: ++revision
+					};
+					try {
+						service.open({
+							kind: "edrv." + kind,
+							value: {
+								owner,
+								sessionId,
+								path
+							}
+						}, point);
+						return true;
+					} catch {
+						current = void 0;
+						return false;
+					}
+				},
+				invalidate(valid) {
+					if (current?.valid !== valid) return;
+					revision++;
+					current = void 0;
+					closeOwned();
+				},
+				dispose() {
+					stopped = true;
+					revision++;
+					current = void 0;
+					closeOwned();
+					for (const dispose of disposers) dispose();
+				}
+			};
+		}
+		//#endregion
 		//#region src/client/ui/McpSessionStatus.ts
 		/** Official session-row slots; no DOM patching or session activation. @author ddj 2026年10月20号 */
 		const labels = {
@@ -404271,6 +404578,16 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				active: state.fileClaim,
 				note: state.fileClaim ? "聊天文件链接转发进单一编辑器页签" : "官方文件链接认领未安装"
 			});
+			if (state.officialMenus !== void 0) items.push({
+				name: "官方右键菜单",
+				active: state.officialMenus,
+				note: state.officialMenus ? "插件动作接入共享菜单" : "服务缺失或装配失败，保留插件菜单"
+			});
+			if (state.forge !== void 0) items.push({
+				name: "Forge 导航",
+				active: state.forge,
+				note: state.forge ? "导航至官方面板与本地变更；PR 保持官方审查" : "官方 Forge 未安装或未启用，不自动启用"
+			});
 			return items;
 		}
 		//#endregion
@@ -404339,8 +404656,12 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			const sessionId = props?.sessionId;
 			const useTabInfo = props?.useTabInfo;
 			let navigation;
+			let tab;
+			let visible = true;
 			if (typeof useTabInfo === "function") try {
-				navigation = useTabInfo()?.tab?.navigation;
+				tab = useTabInfo()?.tab;
+				navigation = tab?.navigation;
+				visible = tab?.visible !== false;
 			} catch {
 				navigation = void 0;
 			}
@@ -404371,19 +404692,25 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				if (revision <= 0) return;
 				const fileHit = parseOfficialFileAddress(navigation?.address);
 				if (fileHit) {
-					const line = navigation?.params?.line;
+					const line = resolveNavLine(navigation?.params);
 					window.dispatchEvent(new CustomEvent("edrv:open-editor", { detail: {
+						sessionId,
+						ownerId: tab?.id,
 						path: fileHit.path,
-						line: typeof line === "number" ? line : void 0,
+						line,
+						column: resolveNavColumn(navigation?.params),
 						preview: navigation?.params?.preview
 					} }));
 					return;
 				}
 				const request = resolveNavOpen(navigation?.params);
 				window.dispatchEvent(new CustomEvent("edrv:open-editor", { detail: {
+					sessionId,
+					ownerId: tab?.id,
 					path: request.path,
 					focusDiff: request.focusDiff,
 					line: resolveNavLine(navigation?.params),
+					column: resolveNavColumn(navigation?.params),
 					preview: navigation?.params?.preview
 				} }));
 			});
@@ -404391,11 +404718,15 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				key: sessionId,
 				sessionId,
 				layout: "side",
+				visible,
+				ownerId: tab?.id,
 				schedule: props?.schedule,
 				addToConversation: props?.addToConversation,
 				sidebarPanels: props?.sidebarPanels,
 				outlineSources: props?.outlineSources,
 				fileMenuItems: props?.fileMenuItems,
+				officialMenus: props?.officialMenus,
+				forge: props?.forge,
 				fileOpeners: props?.fileOpeners,
 				sessions: props?.sessions
 			});
@@ -404462,17 +404793,27 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				const [failed, setFailed] = react$1.default.useState(false);
 				const doneRef = react$1.default.useRef(-1);
 				react$1.default.useEffect(() => {
-					if (revision === doneRef.current) return;
-					doneRef.current = revision;
+					const intent = JSON.stringify([
+						props?.sessionId,
+						tab?.id,
+						revision,
+						navigation?.address
+					]);
+					if (intent === doneRef.current) return;
 					const parsed = parseOfficialFileAddress(navigation?.address);
 					if (!parsed) {
 						setFailed(true);
 						return;
 					}
 					const line = resolveNavLine(navigation?.params);
+					const column = resolveNavColumn(navigation?.params);
+					let alive = true;
+					setFailed(false);
 					let left = FORWARD_ATTEMPTS;
 					const attempt = () => {
-						if (forwardToEditor(service, parsed.path, line, navigation?.params?.preview)) {
+						if (!alive || tab?.signal?.aborted) return;
+						if (forwardToEditor(typeof tab?.actions?.openTab === "function" ? tab.actions : service, parsed.path, line, navigation?.params?.preview, column)) {
+							doneRef.current = intent;
 							closeTab(tab);
 							return;
 						}
@@ -404481,7 +404822,15 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 						else setFailed(true);
 					};
 					attempt();
-				}, [revision]);
+					return () => {
+						alive = false;
+					};
+				}, [
+					revision,
+					props?.sessionId,
+					tab?.id,
+					navigation?.address
+				]);
 				if (!failed || typeof fallback !== "function") return null;
 				return react$1.default.createElement(fallback, props);
 			}
@@ -408716,13 +409065,26 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			function menu(event) {
 				onContext(path, type, event);
 			}
+			/** @private @author ddj 2026年11月04号 @param event Keyboard context trigger anchored to the focused row. */
+			function menuKey(event) {
+				if (event.key !== "ContextMenu" && !(event.shiftKey && event.key === "F10")) return;
+				const rect = event.currentTarget.getBoundingClientRect();
+				onContext(path, type, {
+					preventDefault: () => event.preventDefault(),
+					stopPropagation: () => event.stopPropagation(),
+					clientX: rect.left,
+					clientY: rect.bottom
+				});
+			}
 			return react$1.default.createElement("div", {
 				className: "edrv-tree-row" + (active ? " edrv-tree-active" : "") + (context ? " edrv-tree-context" : "") + (reveal ? " edrv-tree-reveal" : "") + (mark?.stale ? " edrv-tree-stale" : ""),
 				title: path + (mark?.stale ? "；SVN 状态陈旧，等待确认" : ""),
 				"data-edrv-path": path,
 				style: { paddingLeft: 6 + depth * 14 },
+				tabIndex: 0,
 				onClick: select,
-				onContextMenu: menu
+				onContextMenu: menu,
+				onKeyDown: menuKey
 			}, react$1.default.createElement("span", { className: "edrv-tree-chev" }, isDir ? isOpen ? "▾" : "▸" : ""), react$1.default.createElement("span", { className: "edrv-tree-iconbox" }, rowIconEl({ name }, isDir, isOpen), svnOverlayEl(viewOverlayOf(mark), remote)), react$1.default.createElement("span", { className: "edrv-tree-name" + (type === "other" ? " edrv-tree-dim" : "") }, name), pending > 0 ? react$1.default.createElement("span", { className: "edrv-tree-badge" }, String(pending)) : null);
 		}
 		const ExplorerRow = react$1.default.memo(rowView);
@@ -409182,6 +409544,54 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				if (menu && !menuValid) setMenu(null);
 			}
 			react$1.default.useEffect(closeLostMenu, [menu, menuValid]);
+			const liveMenu = react$1.default.useRef({
+				scope,
+				treeRows,
+				sessionId: ctx?.sessionId,
+				alive: true
+			});
+			const openingValid = react$1.default.useRef(null);
+			liveMenu.current = {
+				scope,
+				treeRows,
+				sessionId: ctx?.sessionId,
+				alive: liveMenu.current.alive
+			};
+			react$1.default.useEffect(() => {
+				liveMenu.current.alive = ctx?.visible !== false;
+				return () => {
+					liveMenu.current.alive = false;
+					if (openingValid.current) ctx?.officialMenus?.invalidate(openingValid.current);
+				};
+			}, [
+				scope,
+				ctx?.sessionId,
+				ctx?.officialMenus,
+				ctx?.visible
+			]);
+			react$1.default.useEffect(() => {
+				if (!menuValid || !ctx?.officialMenus || !ctx.sessionId) return;
+				const target = { ...menu.target };
+				const sessionId = ctx.sessionId;
+				const valid = () => liveMenu.current.alive && liveMenu.current.sessionId === sessionId && liveMenu.current.scope === menu.scope && (target.path === "" || liveMenu.current.treeRows.some((row) => row.e?.path === target.path));
+				openingValid.current = valid;
+				const items = buildTreeMenu(ctx.fileMenuItems, target, ctx).map((item) => ({
+					id: item.id,
+					label: item.label,
+					disabled: item.disabled,
+					danger: item.danger,
+					separator: item.separator,
+					run: () => item.run(target, ctx)
+				}));
+				if (ctx.officialMenus.open("resource", ctx.sessionId, target.path, {
+					x: menu.x,
+					y: menu.y
+				}, items, valid)) setMenu(null);
+			}, [
+				menu,
+				menuValid,
+				ctx?.officialMenus
+			]);
 			const menuEntries = menuValid ? buildTreeMenu(ctx?.fileMenuItems, menu.target, ctx).map((item) => ({
 				id: item.id,
 				label: item.label,
@@ -412672,6 +413082,26 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 		function createDefaultFileMenuItems() {
 			return [
 				...openGroupItems(),
+				{
+					id: "forge-open",
+					label: "打开 Forge",
+					order: 6,
+					group: GROUP_OPEN,
+					visible: (_target, ctx) => ctx.forge?.available() === true,
+					run: (_target, ctx) => {
+						if (ctx.sessionId) ctx.forge?.open(ctx.sessionId);
+					}
+				},
+				{
+					id: "forge-local",
+					label: "查看本地变更（Forge）",
+					order: 7,
+					group: GROUP_OPEN,
+					visible: (_target, ctx) => ctx.forge?.available() === true,
+					run: (_target, ctx) => {
+						if (ctx.sessionId) ctx.forge?.open(ctx.sessionId, true);
+					}
+				},
 				...revealGroupItems(),
 				...refGroupItems(),
 				...clipGroupItems(),
@@ -414513,7 +414943,9 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				officialSidebar: officialService !== void 0,
 				fileClaim: claimDisposer !== null,
 				claimWanted: shouldClaimFiles(selected),
-				selected
+				selected,
+				officialMenus: Boolean(ctx.get("contextMenus")),
+				forge: forge.available()
 			}, version);
 			ctx.provide("fileOpeners", registry);
 			ctx.effect(() => registry.register(vscodeOpener()), "vscode-mode: file opener");
@@ -414545,12 +414977,17 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				const sidebar = scanSidebar(ctx);
 				return sidebar ? registry.register(sidebar) : void 0;
 			}, "vscode-mode: sidebar file opener");
+			const forge = forgeBridge(ctx, () => readSessionScope(ctx).sessionId ?? void 0);
+			const menuBridge = lazyMenus(ctx);
+			if (menuBridge) ctx.effect(() => () => menuBridge.dispose(), "vscode-mode: official menus");
 			const officialRenderTab = (props) => react$1.default.createElement(OfficialSideTab, Object.assign({}, props, {
 				schedule,
 				addToConversation,
 				sidebarPanels,
 				outlineSources,
 				fileMenuItems,
+				officialMenus: menuBridge,
+				forge,
 				fileOpeners: registry,
 				sessions,
 				readSessionScope: () => readSessionScope(ctx)
@@ -414735,6 +415172,8 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 					sidebarPanels,
 					outlineSources,
 					fileMenuItems,
+					officialMenus: menuBridge,
+					forge,
 					fileOpeners: registry,
 					sessions
 				})));
@@ -414820,6 +415259,8 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 							sidebarPanels,
 							outlineSources,
 							fileMenuItems,
+							officialMenus: menuBridge,
+							forge,
 							fileOpeners: registry,
 							sessions
 						})),
@@ -414929,6 +415370,17 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				compatSummary,
 				getShortcuts: () => detectShortcuts(ctx)
 			})));
+			registerSlotSafely(ctx, {
+				name: "settings.section.icon",
+				id: "vscode-mode",
+				order: 30
+			}, (input) => {
+				const props = input;
+				return react$1.default.createElement(IconCodeOutline16, {
+					size: props.size ?? 16,
+					className: props.active ? "edrv-settings-active" : void 0
+				});
+			});
 			registerSlotSafely(ctx, {
 				name: "plugins.detail.section",
 				id: "edrv-plugin-status",