dsh-vscode-mode 0.25.1 → 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. */
@@ -3686,7 +3744,15 @@ window.__ModuleLoader__.load({
 			if (page.nextCursor !== null || page.items.length !== page.pending) throw new Error("待审记录数量不完整，未执行批量操作");
 			return page.items;
 		}
-		/** @public @author ddj 2026年10月27号 @param port Guarded existing per-file decision adapter. @param reject Undo instead of Keep. @returns Precise partial result; Undo stops at first conflict, never claims atomic multi-file rollback. */
+		/**
+		* @public
+		* @author ddj 2026年10月27号
+		* @description: 逐条决策引擎，现仅供 Undo All 使用（Keep 已改走 `reviewKeepAll.ts` 的宿主批量通道）；
+		* 保留 reject 形态以便对照既有契约与测试。
+		* @param port Guarded existing per-file decision adapter.
+		* @param reject Undo instead of Keep.
+		* @returns Precise partial result; Undo stops at first conflict, never claims atomic multi-file rollback.
+		*/
 		async function runReviewBatch(port, reject) {
 			const result = {
 				completed: 0,
@@ -3721,6 +3787,1278 @@ window.__ModuleLoader__.load({
 			return result;
 		}
 		//#endregion
+		//#region src/client/reviewKeepAll.ts
+		/**
+		* @private
+		* @author ddj 2026年11月03号
+		* @description: 取一次完整待审快照；完整性校验失败时重取一次，避免瞬时漂移被当成不可恢复错误。
+		* @param port 已鉴权的 RPC 适配器
+		* @returns 冻结的批量目标
+		* @throws 两次都取不到一致快照时抛出原始原因
+		*/
+		async function snapshotOnce(port) {
+			try {
+				return toItems(await loadPending(port));
+			} catch {
+				port.guard();
+				return toItems(await loadPending(port));
+			}
+		}
+		/**
+		* @private
+		* @author ddj 2026年11月03号
+		* @description: 把快照条目裁成批量目标，只带 host 需要的身份与版本线索。
+		* @param items 完整待审集
+		* @returns 批量目标
+		*/
+		function toItems(items) {
+			return items.map((item) => ({
+				id: item.id,
+				display: item.display,
+				seq: item.seq,
+				revision: item.revision
+			}));
+		}
+		/**
+		* @public
+		* @author ddj 2026年11月03号
+		* @description: 批量保留全部待审记录（Keep 不改写磁盘）。一次往返完成，跳过项只进 skipped，
+		* 段级异常才写 error；guard 失效时保留已完成计数交给调用方呈现。
+		* @param port 已鉴权的 RPC 适配器
+		* @returns 与 BatchResult 同构的批量结果（含跳过明细）
+		*/
+		async function runKeepAll(port) {
+			const result = {
+				completed: 0,
+				total: 0,
+				paths: [],
+				skipped: [],
+				error: ""
+			};
+			try {
+				port.guard();
+				const items = await snapshotOnce(port);
+				result.total = items.length;
+				if (!items.length) return result;
+				port.guard();
+				const reply = await port.keepAll(items, crypto.randomUUID());
+				if (!reply.ok) {
+					result.error = reply.error;
+					return result;
+				}
+				return reply.result;
+			} catch (cause) {
+				result.error = cause instanceof Error ? cause.message : String(cause);
+				return result;
+			}
+		}
+		//#endregion
+		//#region src/shared/externalOpen.ts
+		/**
+		* dsh-vscode-mode shared — 外部深链 URL 契约（Windows launcher / Unity 包 / client 共用）。
+		* 形态：?<FLAG>=1&<PATHS_KEY>=<enc1>[,<enc2>…] [&<LINE_KEY>=N] [&<COLUMN_KEY>=M]
+		* 每个路径独立 percent-encode（encodeURIComponent / Uri.EscapeDataString）后以 `,` 连接：
+		* 编码结果不含裸逗号（Windows 路径本身不允许逗号，编码兜底其余字符），URLSearchParams
+		* 取值做一次标准解码即得 `enc1,enc2`，按 `,` split 即路径，无需二次 decode。
+		* Purity rule: no node/react imports（URLSearchParams 为标准全局）。
+		* 作者 ddj 2026-09-07
+		*/
+		/** 深链开关参数名（值恒为 '1'）。 */
+		const EDRV_OPEN_FLAG = "edrvOpen";
+		/** 路径列表参数名（逗号分隔的已编码路径）。 */
+		const EDRV_PATHS_KEY = "edrvPaths";
+		/** 目标行参数名（1-based，可选，作用于首个路径）。 */
+		const EDRV_LINE_KEY = "edrvLine";
+		/** 目标列参数名（1-based，可选，作用于首个路径）。 */
+		const EDRV_COLUMN_KEY = "edrvColumn";
+		/** 深链参数键全集（URL 清理用）。 */
+		const EDRV_PARAM_KEYS = [
+			EDRV_OPEN_FLAG,
+			EDRV_PATHS_KEY,
+			EDRV_LINE_KEY,
+			EDRV_COLUMN_KEY
+		];
+		/**
+		* 解析深链查询串：非深链/路径为空 → null；行列仅接受正整数，非法忽略。
+		* @author ddj 2026年09月07号
+		* @param search location.search（含或不含前导 ? 均可）
+		* @returns 深链参数或 null
+		*/
+		function parseOpenParams(search) {
+			const params = new URLSearchParams(search ?? "");
+			if (params.get("edrvOpen") !== "1") return null;
+			const paths = (params.get("edrvPaths") ?? "").split(",").map((item) => item.trim()).filter(Boolean);
+			if (!paths.length) return null;
+			return {
+				paths,
+				line: positiveIntOf(params.get(EDRV_LINE_KEY)),
+				column: positiveIntOf(params.get(EDRV_COLUMN_KEY))
+			};
+		}
+		/**
+		* 正整数解析（非法/非正 → undefined）。
+		* @author ddj 2026年09月07号
+		* @param raw 参数原文（可空）
+		* @returns 正整数或 undefined
+		*/
+		function positiveIntOf(raw) {
+			const value = Number(raw);
+			return Number.isInteger(value) && value > 0 ? value : void 0;
+		}
+		//#endregion
+		//#region src/client/chooseDialog.ts
+		/**
+		* dsh-vscode-mode client — 工作区选择弹窗（深链打开规则 1）。
+		* 复用与「添加 MCP」一致的 vsm-mcp-modal / vsm-mcp-dialog 模态（页面居中卡片 + 遮罩 + 主题
+		* token），React portal 挂 body；Esc / 遮罩点击 / 取消 → null（中止流程不改任何状态）。
+		* 作者 ddj 2026-09-07
+		*/
+		/** 选择弹窗（vsm-mcp-modal 遮罩 + vsm-mcp-dialog 卡片，Esc/遮罩点击取消）。 */
+		function ChoiceModal({ title, folder, done }) {
+			react$1.default.useEffect(() => {
+				const onKey = (event) => {
+					if (event.key === "Escape") done(null);
+				};
+				window.addEventListener("keydown", onKey);
+				return () => window.removeEventListener("keydown", onKey);
+			}, []);
+			return react$1.default.createElement("div", {
+				className: "vsm-mcp-modal",
+				onMouseDown: (event) => {
+					if (event.target === event.currentTarget) done(null);
+				}
+			}, react$1.default.createElement("div", { className: "vsm-mcp-dialog" }, react$1.default.createElement("h3", null, "在 DSH 中打开"), react$1.default.createElement("label", null, "文件夹 " + folder + " 位于已注册的工作区「" + title + "」内，选择打开方式："), react$1.default.createElement("div", { className: "vsm-mcp-dialog-actions" }, react$1.default.createElement("button", { onClick: () => done(null) }, "取消"), react$1.default.createElement("button", { onClick: () => done("create") }, "新建工作区"), react$1.default.createElement("button", {
+				className: "vsm-primary",
+				onClick: () => done("recent")
+			}, "使用最近的工作区"))));
+		}
+		/**
+		* 弹出工作区选择弹窗（深链打开规则 1）。
+		* @author ddj 2026年09月07号
+		* @param title 匹配到的工作区标题
+		* @param folder 文件夹路径
+		* @returns 用户选择；null = 取消/中止
+		*/
+		function chooseWorkspace(title, folder) {
+			return new Promise((resolve) => {
+				const host = document.createElement("div");
+				document.body.appendChild(host);
+				const root = (0, react_dom_client.createRoot)(host);
+				const done = (choice) => {
+					root.unmount();
+					host.remove();
+					resolve(choice);
+				};
+				root.render(react$1.default.createElement(ChoiceModal, {
+					title,
+					folder,
+					done
+				}));
+			});
+		}
+		//#endregion
+		//#region src/client/addToConversation.ts
+		/**
+		* dsh-vscode-mode client — 把文件/选中内容注入会话对话输入框（composer draft）。
+		* 复用 DSH 官方输入门面：ctx.conversation.input.for(sessions.scope(sessionId)) → SessionInput。
+		* 引用 chip：insertReference（reference source，发送时序列化为 @path 文本）；忙态降级为纯文本 setDraft。
+		* 纯函数部分 node 可单测。
+		* 作者 ddj 2026-08-25
+		*/
+		/** 把追加引用结果映射为可读文案（ok 用 okText；busy 提示已降级纯文本；unavailable 提示不可用）。
+		* @author ddj 2026年09月03号 / 2026年09月11号
+		* @param outcome 追加结果状态
+		* @param okText 成功文案（如「已添加文件引用」/「已添加文件夹引用」）
+		* @returns 状态栏/通知用文案
+		*/
+		function statusOfAdd(outcome, okText) {
+			if (outcome === "ok") return okText;
+			if (outcome === "busy") return okText + "（已降级纯文本）";
+			if (outcome === "failed") return "添加引用失败（输入框忙或未就绪，请重试）";
+			return "无法添加到对话（无会话或输入框不可用）";
+		}
+		/** DSH reference source 名（dsh-client-ui-reference 注册的 @file/@session 统一源）。 */
+		const REF_SOURCE = "reference";
+		/**
+		* 把 clipboard 投影的末尾折算成 **detect 投影**的末尾。
+		*
+		* ⚠️ 两个投影对 chip 的计长不同，混用会直接毁掉已插入的引用（真实缺陷，勿改回 `draft.length`）：
+		* DSH 的 `$composerLayout()` 中 chip 在 detect 投影里只贡献 **1 个 U+FFFC**，
+		* 在 clipboard 投影里贡献 `clipboardText` 全文
+		* （`pushLeaf('chip', kid, '', kid.getTextContent())`）。
+		* 而 `insertReference(ref, span)` 的 span 走 detect 坐标并经 `selectSpan` 校验：
+		* `span.end > layout.detectLength` 时返回 null → 插入失败。
+		*
+		* 旧实现直接用 `draft.length`（clipboard 长度）当 detect 起点：草稿里一旦有 chip，
+		* 该值就超出 detect 长度 → 插入被拒 → 落入 `setDraft` 兜底，
+		* 而 `setDraft` 会整篇重建并剔除 U+FFFC（`text.replace(REFERENCE_PLACEHOLDER_RE, '')`），
+		* 于是**既有 chip 被销毁、引用退化为重复的纯文本**（即「连续添加多个引用显示异常」）。
+		*
+		* 换算：每个 chip 在 clipboard 中多算了 `length - 1`，逐个扣回即得 detect 末尾。
+		* 无 occurrences（旧版 DSH）时退化为 `draft.length`，与旧行为一致。
+		* @author ddj 2026年09月11号
+		* @param snapshot 输入快照
+		* @returns detect 投影中的文档末尾偏移
+		*/
+		function detectEndOf(snapshot) {
+			const total = String(snapshot?.draft ?? "").length;
+			const occurrences = snapshot?.occurrences;
+			if (!Array.isArray(occurrences) || !occurrences.length) return total;
+			let clipped = 0;
+			for (const occurrence of occurrences) {
+				const length = Number(occurrence?.length ?? 0);
+				if (!Number.isFinite(length) || length <= 1) continue;
+				clipped += length - 1;
+			}
+			return Math.max(0, total - clipped);
+		}
+		/** chip 列表按 clipboard 偏移升序（官方已排序，此处防御性归一，丢弃非法项）。 */
+		function chipsOf(snapshot) {
+			const occurrences = snapshot?.occurrences;
+			if (!Array.isArray(occurrences) || !occurrences.length) return [];
+			const out = [];
+			for (const occurrence of occurrences) {
+				const offset = Number(occurrence?.offset ?? NaN);
+				const length = Number(occurrence?.length ?? NaN);
+				if (!Number.isFinite(offset) || !Number.isFinite(length) || length <= 1) continue;
+				out.push({
+					offset: Math.max(0, offset),
+					length
+				});
+			}
+			return out.sort((a, b) => a.offset - b.offset);
+		}
+		/**
+		* detect 偏移 → clipboard 偏移（paddingAt 用：draft 是 clipboard 投影，不能直接按下标取字符）。
+		* 每个位于该偏移之前的 chip 在 clipboard 中多占 `length − 1`，累计补上即可。
+		* @author ddj 2026年09月11号
+		* @param snapshot 输入快照
+		* @param detectOffset detect 投影偏移
+		* @returns clipboard 投影偏移（已夹到 draft 范围内）
+		*/
+		function detectToClipboardOf(snapshot, detectOffset) {
+			const total = String(snapshot?.draft ?? "").length;
+			const target = Math.max(0, Math.min(Number(detectOffset) || 0, detectEndOf(snapshot)));
+			let shift = 0;
+			for (const chip of chipsOf(snapshot)) {
+				if (chip.offset - shift >= target) break;
+				shift += chip.length - 1;
+			}
+			return Math.max(0, Math.min(target + shift, total));
+		}
+		/**
+		* 插入点两侧是否需要补空格（仅纯文本通道需要；chip 由 facade 自行补尾随空格）。
+		*
+		* 在 detect 坐标的任意位置求值，故**末尾追加的行为与旧实现逐字符一致**
+		* （末尾前为非空白 → 前后各补一个空格；末尾前已是空白 → 只补尾随空格），
+		* 同时正确支持「插在文本中间」不再贴字。
+		* @author ddj 2026年09月11号
+		* @param snapshot 输入快照
+		* @param detectOffset detect 投影插入点
+		* @returns 是否需要前导/尾随空格
+		*/
+		function paddingAt(snapshot, detectOffset) {
+			const draft = String(snapshot?.draft ?? "");
+			const at = detectToClipboardOf(snapshot, detectOffset);
+			const before = at > 0 ? draft.slice(at - 1, at) : "";
+			const after = at < draft.length ? draft.slice(at, at + 1) : "";
+			return {
+				lead: before !== "" && !/\s/.test(before),
+				tail: after === "" || !/\s/.test(after)
+			};
+		}
+		/**
+		* 解析插入点（detect 坐标）：优先用输入框**当前光标/选区**（`caretSpan()`，
+		* 官方契约即 detect 坐标，无选区时回落文档末尾），并夹到 `[0, detectLength]`。
+		*
+		* 选区非塌缩时取 `end`（右边界）—— 插入而非替换，绝不删除用户已选中的内容。
+		* caret 缺失/非法（旧版 facade 无该方法、抛异常、NaN 等）一律回落到文档末尾。
+		* @author ddj 2026年09月11号
+		* @param caret caretSpan() 的返回值（可为 null/非法）
+		* @param detectLength detect 投影文档长度
+		* @returns detect 投影插入偏移
+		*/
+		function insertOffsetOf(caret, detectLength) {
+			const max = Math.max(0, Number(detectLength) || 0);
+			if (!caret || typeof caret !== "object") return max;
+			const span = caret;
+			const raw = Number(span.end);
+			const value = Number.isFinite(raw) ? raw : Number(span.start);
+			if (!Number.isFinite(value)) return max;
+			return Math.max(0, Math.min(value, max));
+		}
+		/**
+		* 生成 DSH @file 语法引用串：cwd 相对化、\ → /、含空白时按 @"path" 语法加引号。
+		* cwd 外/无法相对化的路径回退原路径。
+		* @author ddj 2026年08月25号
+		* @param path 打开的文件路径（相对 cwd 或绝对）
+		* @param cwd 会话工作区目录（可选）
+		* @returns 引用串（如 @src/index.ts 或 @"a b.ts"）
+		*/
+		function mentionOf(path, cwd) {
+			const raw = String(path);
+			let rel = raw;
+			if (cwd) {
+				const base = String(cwd).replace(/[\\/]+$/, "");
+				const up = raw.replace(/\\/g, "/");
+				const baseUp = base.replace(/\\/g, "/");
+				if (up.startsWith(baseUp + "/")) rel = up.slice(baseUp.length + 1);
+				else if (up === baseUp) rel = "";
+			}
+			rel = rel.replace(/\\/g, "/").replace(/^\.\//, "");
+			if (!rel) rel = raw.replace(/\\/g, "/");
+			if (/[\u0000-\u001f\u007f-\u009f"]/u.test(rel)) return "@" + raw;
+			return /\s/u.test(rel) ? `@"${rel}"` : `@${rel}`;
+		}
+		/** 引用标签：文件名 + 可选行区间（chip 内展示，不带 @ 前缀）。
+		* @author ddj 2026年08月25号 */
+		function labelOf(path, range) {
+			const base = String(path).split(/[\\/]/).pop() || String(path);
+			if (!range || range.endLine < range.startLine) return base;
+			return range.startLine === range.endLine ? `${base} L${range.startLine}` : `${base} L${range.startLine}-${range.endLine}`;
+		}
+		/** 引用 ref：引用串 + 可选行区间（序列化直出，agent 据此读取对应片段）。
+		* @author ddj 2026年08月25号 */
+		function refOf(mention, range) {
+			if (!range || range.endLine < range.startLine) return mention;
+			return range.startLine === range.endLine ? `${mention} L${range.startLine}` : `${mention} L${range.startLine}-${range.endLine}`;
+		}
+		/** 构造 DSH 文件引用插入载荷，模型文本、剪贴板投影与降级文本共用完整行区间。
+		* @public
+		* @author ddj 2026年10月28号
+		* @returns 引用载荷与含可选行区间的完整引用文本
+		* @param path 目标路径（相对 cwd 或绝对）
+		* @param cwd 会话工作区目录（可选）
+		* @param range 行区间（可选）
+		* @param appearance 引用外观：'file'（默认）| 'folder'
+		*/
+		function buildFileRef(path, cwd, range, appearance = "file") {
+			const mention = refOf(mentionOf(path, cwd), range);
+			return {
+				mention,
+				reference: {
+					source: REF_SOURCE,
+					ref: mention,
+					label: labelOf(path, range),
+					appearance,
+					clipboardText: mention
+				}
+			};
+		}
+		/** @private @author ddj 2026年10月29号 @param receipt Raw selected-channel receipt. @returns Explicit admission evidence and the historical boolean. */
+		function taskReceipt(receipt) {
+			const ok = receipt?.ok;
+			if (ok === true) return {
+				status: "accepted",
+				legacyOk: true
+			};
+			if (ok === false) return {
+				status: "rejected",
+				legacyOk: false
+			};
+			return {
+				status: "unknown",
+				legacyOk: false
+			};
+		}
+		/** @private @author ddj 2026年10月29号 @param ctx Lifecycle owner. @param sessions Public Controller. @param id Fixed target. @param text Task body. @returns Admission evidence without switching transport. @sideEffects Retains and releases exactly one generation. */
+		async function sendOwned(ctx, sessions, id, text) {
+			const controller = new AbortController();
+			const reference = sessions.retain(id, {
+				source: "controllerOperation",
+				signal: controller.signal
+			});
+			let released = false;
+			let cleanupFailed = false;
+			/** @private @author ddj 2026年10月29号 Cancels and releases this exact generation once; remembers unload cleanup failures. */
+			function release() {
+				if (released) return;
+				released = true;
+				controller.abort();
+				try {
+					reference.release();
+				} catch (error) {
+					cleanupFailed = true;
+					throw error;
+				}
+			}
+			let remove;
+			let started = false;
+			let result = {
+				status: "unavailable",
+				legacyOk: false
+			};
+			try {
+				remove = ctx.effect?.(() => release, "vscode-mode: task session reference");
+				const binding = await reference.ready;
+				if (controller.signal.aborted) result = {
+					status: "cancelled",
+					legacyOk: false
+				};
+				else {
+					started = true;
+					result = taskReceipt(await binding.session.prompt([{
+						type: "text",
+						text
+					}], "queue", controller.signal));
+				}
+			} catch {
+				result = {
+					status: started ? "unknown" : "unavailable",
+					legacyOk: false
+				};
+			}
+			const cancelled = controller.signal.aborted;
+			try {
+				release();
+			} catch {
+				cleanupFailed = true;
+			}
+			try {
+				remove?.();
+			} catch {
+				cleanupFailed = true;
+			}
+			if (cleanupFailed) result = {
+				status: started ? "unknown" : "unavailable",
+				legacyOk: false
+			};
+			if (cancelled) result = {
+				status: "cancelled",
+				legacyOk: result.legacyOk
+			};
+			return result;
+		}
+		/** @private @author ddj 2026年10月29号 @param ctx Service owner. @param id Fixed target. @param text Task body. @returns One legacy-channel attempt; no cross-channel retry. */
+		async function sendLegacy(ctx, id, text) {
+			const input = inputFor(ctx, id);
+			if (typeof input?.setDraft === "function" && typeof input.submit === "function") {
+				let submitted = false;
+				try {
+					input.setDraft(text);
+					submitted = true;
+					input.submit();
+					return {
+						status: "submitted",
+						legacyOk: true
+					};
+				} catch {
+					return {
+						status: submitted ? "unknown" : "unavailable",
+						legacyOk: false
+					};
+				}
+			}
+			const remote = ctx.get("remote.session");
+			if (typeof remote?.prompt !== "function") return httpTaskResult(id, text);
+			try {
+				const payload = {
+					sessionId: id,
+					mode: "queue",
+					content: [{
+						type: "text",
+						text
+					}]
+				};
+				const receipt = await remote.prompt(slotArg(payload));
+				return taskReceipt(receipt?.result ?? receipt);
+			} catch {
+				return {
+					status: "unknown",
+					legacyOk: false
+				};
+			}
+		}
+		/** apiproxy wire 端点（POST /api/<method>；浏览器同源 fetch 自带 cookie 鉴权；实证 401=未鉴权而非 404）。 */
+		const SESSION_CREATE_PATH = "/api/session/create";
+		/** apiproxy wire 端点：发送任务（session/prompt；点击即发送方案）。 */
+		const SESSION_PROMPT_PATH = "/api/session/prompt";
+		/** mint RPC 请求 id（RpcId 品牌类型运行时即普通字符串）。 */
+		function mintRpcId() {
+			try {
+				return globalThis.crypto?.randomUUID?.() ?? "rpc-" + Date.now();
+			} catch {
+				return "rpc-" + Date.now();
+			}
+		}
+		/**
+		* wire 槽实参组装（gateway `invoke` 铁证：`request.args[parameter.wire]` 具名槽，
+		* `session/prompt` 的槽名 = "request"，值 = RpcRequest `{rpcId, payload}`）。
+		* @author ddj 2026年09月24号
+		* @param payload 业务载荷
+		* @returns 具名槽实参 `{ args: { request: RpcRequest } }`
+		*/
+		function slotArg(payload) {
+			return { args: { request: {
+				rpcId: mintRpcId(),
+				payload
+			} } };
+		}
+		/**
+		* RPC 返回解析（照官方 dsh-client-runtime 调用形态：`const { result } = await api.sessions.create(...)`）。
+		* 官方 api.sessions 面返回**信封** `{ rpcId, result: RpcResult }`——须解 .result；
+		* 兼容裸 RpcResult 形态（个别补丁面直接回 {ok, value}）。
+		* @author ddj 2026年09月23号
+		* @param res 信封或裸 RpcResult
+		* @returns 归一后的 { ok, value }
+		*/
+		function rpcOk(res) {
+			const r = res?.result ?? res;
+			return {
+				ok: r?.ok === true,
+				value: r?.value
+			};
+		}
+		/**
+		* wire 直调 session/create（主路径）：ClientRequest 信封 → ServerResponse.result（RpcResult 形态）。
+		* 契约以当前安装版 dsh-host-apiproxy 为准（api/sessions.d.ts「Method signatures are the
+		* source of truth」）：`create({cwd}) → {sessionId}`；信封 = `{type:'client-request', rpcId,
+		* method, payload}` → `{result: {ok:true, value:{sessionId}} | {ok:false, error}}`。
+		* @author ddj 2026年09月23号
+		* @param cwd 新会话工作区目录
+		* @returns 新会话 id（失败空串）
+		*/
+		async function apiSessionCreate(cwd) {
+			const json = await (await fetch(appUrl(SESSION_CREATE_PATH), {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify({
+					type: "client-request",
+					rpcId: mintRpcId(),
+					method: "session/create",
+					payload: cwd ? { cwd } : {}
+				})
+			})).json().catch(() => null);
+			const id = json?.result?.value?.sessionId;
+			return json?.result?.ok === true && typeof id === "string" ? id : "";
+		}
+		/** @private @author ddj 2026年10月29号 @param sessionId Fixed target. @param text Task body. @returns HTTP receipt evidence; errors after request entry are never safe rejection. */
+		async function httpTaskResult(sessionId, text) {
+			try {
+				const payload = {
+					sessionId,
+					mode: "queue",
+					content: [{
+						type: "text",
+						text
+					}]
+				};
+				return taskReceipt((await (await fetch(appUrl(SESSION_PROMPT_PATH), {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({
+						type: "client-request",
+						rpcId: mintRpcId(),
+						method: "session/prompt",
+						payload: slotArg(payload)
+					})
+				})).json().catch(() => null))?.result);
+			} catch {
+				return {
+					status: "unknown",
+					legacyOk: false
+				};
+			}
+		}
+		/**
+		* 新建独立会话承载旁路任务（02-deep-session-prompt：深度分析不污染当前对话）。
+		* 优先公开 sessions.create；旧 Host 按能力选择 remote 或 wire，调用后不换通道重试。
+		* 受理状态不明时返回 ok:false，不重复创建会话。
+		* @author ddj 2026年10月28号
+		* @author ddj 2026年09月23号
+		* @param ctx 客户端服务上下文（remote.session + sessions，仅回落用）
+		* @param cwd 新会话工作区目录（与当前会话同工作区）
+		* @returns 新会话结果（含 id）
+		*/
+		async function newDraftSession(ctx, cwd) {
+			try {
+				const sessions = ctx.get("sessions");
+				if (typeof sessions?.create === "function") {
+					const created = await sessions.create(cwd ? { cwd } : void 0);
+					const id = typeof created === "string" && created ? created : typeof created?.id === "string" ? created.id : typeof created?.sessionId === "string" ? created.sessionId : typeof created?.session?.id === "string" ? created.session.id : "";
+					if (id) return {
+						ok: true,
+						id
+					};
+				}
+				if (typeof sessions?.create === "function") return { ok: false };
+			} catch {
+				return { ok: false };
+			}
+			try {
+				const remote = ctx.get("remote.session");
+				if (typeof remote?.create === "function") {
+					const payload = cwd ? { cwd } : {};
+					const receipt = rpcOk(await remote.create(slotArg(payload)));
+					const created = receipt.value;
+					if (receipt.ok && typeof created?.sessionId === "string") return {
+						ok: true,
+						id: created.sessionId
+					};
+					return { ok: false };
+				}
+			} catch {
+				return { ok: false };
+			}
+			try {
+				const id = await apiSessionCreate(cwd);
+				if (id) return {
+					ok: true,
+					id
+				};
+			} catch {}
+			return { ok: false };
+		}
+		/**
+		* 解析会话输入门面；缺失时返回 undefined（动作侧守卫降级）。
+		* @author ddj 2026年08月25号
+		* @param ctx 客户端服务上下文
+		* @param sessionId 会话 id
+		* @returns SessionInput 或 undefined
+		*/
+		function inputFor(ctx, sessionId) {
+			if (!sessionId) return void 0;
+			try {
+				const sessions = ctx.get("sessions");
+				const conversation = ctx.get("conversation");
+				const actx = typeof sessions?.binding === "function" ? sessions.binding(sessionId)?.ctx : sessions?.scope?.(sessionId);
+				const shell = actx && conversation?.input?.for?.(actx);
+				return shell && typeof shell.insertReference === "function" ? shell : void 0;
+			} catch {
+				return;
+			}
+		}
+		/** 取当前草稿快照（长度/版本/chip 列表）；无输入门面时返回 null。
+		* @author ddj 2026年08月25号 / 2026年09月11号 */
+		function draftCursor(input) {
+			try {
+				const s = input?.state?.getSnapshot?.();
+				if (!s) return null;
+				return {
+					draft: String(s.draft ?? ""),
+					draftRev: Number(s.draftRev ?? 0),
+					occurrences: Array.isArray(s.occurrences) ? s.occurrences : void 0
+				};
+			} catch {
+				return null;
+			}
+		}
+		/** 从 sessions 列表快照读会话工作区目录（与 index.ts 既有读取方式一致）。
+		* @author ddj 2026年08月25号 */
+		function cwdOf(ctx, sessionId) {
+			if (!sessionId) return void 0;
+			try {
+				return ctx.get("sessions")?.list?.getSnapshot?.()?.byId?.[sessionId]?.cwd;
+			} catch {
+				return;
+			}
+		}
+		/** 输入门面插入引用（拦截异常视作未应用，走降级）。
+		* @author ddj 2026年08月25号 */
+		function safeInsert(input, reference, span) {
+			try {
+				return input.insertReference(reference, span) === true;
+			} catch {
+				return false;
+			}
+		}
+		/** 输入门面插入纯文本（官方 plain-text 通道；不存在或异常视作未应用）。
+		* @author ddj 2026年09月11号 */
+		function safeInsertText(input, text, span) {
+			if (typeof input.insertText !== "function") return false;
+			try {
+				return input.insertText(text, span) === true;
+			} catch {
+				return false;
+			}
+		}
+		/**
+		* 读输入框当前光标（detect 坐标）；门面缺失/异常返回 null（由调用方回落到文档末尾）。
+		* @author ddj 2026年09月11号
+		* @param input 输入门面
+		* @returns caretSpan 结果或 null
+		*/
+		function caretOf(input) {
+			if (typeof input.caretSpan !== "function") return null;
+			try {
+				return input.caretSpan() ?? null;
+			} catch {
+				return null;
+			}
+		}
+		/**
+		* 创建「添加到对话」动作集（apply 阶段构建一次，随 props 传给 EditorView）。
+		*
+		* 插入位置 = 输入框**当前光标**（`caretSpan()`，detect 坐标；无光标提示时回落文档末尾），
+		* 不再固定追加到最末尾。坐标一律用 **detect 投影**（见 detectEndOf 的缺陷说明）；
+		* 两条写入通道都失败时**不写任何内容**并返回 'failed' —— 旧实现在此处退回 `setDraft`
+		* 整篇重建，会把既有 chip 全部销毁（连续添加多个引用即触发）。
+		* @author ddj 2026年08月25号 / 2026年09月11号
+		* @param ctx 客户端服务上下文（sessions + conversation）
+		* @returns 动作集
+		*/
+		function createAddToConversation(ctx) {
+			const appendReference = async (sessionId, path, range, appearance) => {
+				const input = inputFor(ctx, sessionId);
+				if (!input) return "unavailable";
+				const cur = draftCursor(input);
+				if (!cur) return "unavailable";
+				const { reference, mention } = buildFileRef(path, cwdOf(ctx, sessionId), range, appearance);
+				const at = insertOffsetOf(caretOf(input), detectEndOf(cur));
+				const span = {
+					start: at,
+					end: at,
+					draftRev: cur.draftRev
+				};
+				if (safeInsert(input, reference, span)) return "ok";
+				const pad = paddingAt(cur, at);
+				if (safeInsertText(input, (pad.lead ? " " : "") + mention + (pad.tail ? " " : ""), span)) return "busy";
+				return "failed";
+			};
+			/**
+			* 追加纯文本（AI 深度分析任务注入）：走官方 plain-text 通道插到当前光标。
+			* 失败语义与 appendReference 一致：宁可不写也不整篇重建（保护既有 chip）。
+			* @author ddj 2026年09月23号
+			* @param sessionId 会话 id
+			* @param text 待注入文本
+			* @returns 注入结果（ok / unavailable / failed）
+			*/
+			const appendText = async (sessionId, text) => {
+				const input = inputFor(ctx, sessionId);
+				if (!input) return "unavailable";
+				const cur = draftCursor(input);
+				if (!cur) return "unavailable";
+				const at = insertOffsetOf(caretOf(input), detectEndOf(cur));
+				return safeInsertText(input, text, {
+					start: at,
+					end: at,
+					draftRev: cur.draftRev
+				}) ? "ok" : "failed";
+			};
+			/**
+			* 新建独立会话（02-deep-session-prompt：旁路任务不污染当前对话）。
+			* 闭包持有真服务 ctx（面板 SidebarCtx 无 .get，会话操作必须经此门面）；
+			* 新版仅返回已登记身份，视图选择由宿主负责；旧版保留可用的 open/select。
+			* @author ddj 2026年10月28号
+			* @author ddj 2026年09月23号
+			* @param cwd 新会话工作区目录（与当前会话同工作区）
+			* @returns 新会话结果（失败供降级）
+			*/
+			const startDraftSession = async (cwd) => {
+				const result = await newDraftSession(ctx, cwd);
+				if (typeof ctx.get("sessions")?.retain === "function") return result;
+				if (result.ok && result.id) try {
+					const sessions = ctx.get("sessions");
+					sessions?.materializeScope?.(result.id);
+					const title = "AI 深度分析 · " + (String(cwd ?? "").split(/[\\/]/).pop() || "SVN 变更");
+					sessions?.manager?.rename?.(result.id, title);
+					sessions?.manager?.select?.(result.id);
+					sessions?.open?.(result.id);
+				} catch {}
+				return result;
+			};
+			/**
+			* 发送任务给目标会话 agent（点击即发送方案：任务落地会话即非 blank，列表可见）。
+			* 新版持有目标 Controller 到 prompt 结束；旧版按能力选择唯一通道，不跨通道重发。
+			* @author ddj 2026年10月29号
+			* @param sessionId 目标会话 id
+			* @param text 任务文本
+			* @returns 同一次调用的历史boolean语义，不能作为受理事实
+			*/
+			const sendTask = async (sessionId, text) => (await sendTaskResult(sessionId, text)).legacyOk;
+			/** @private @author ddj 2026年10月29号 @param sessionId Fixed target. @param text Task body. @returns Detailed evidence from exactly one selected transport. */
+			async function sendTaskResult(sessionId, text) {
+				if (!sessionId) return {
+					status: "unavailable",
+					legacyOk: false
+				};
+				try {
+					const sessions = ctx.get("sessions");
+					if (typeof sessions?.retain === "function") return await sendOwned(ctx, sessions, sessionId, text);
+					return await sendLegacy(ctx, sessionId, text);
+				} catch {
+					return {
+						status: "unavailable",
+						legacyOk: false
+					};
+				}
+			}
+			return {
+				appendReference,
+				appendText,
+				startDraftSession,
+				sendTask,
+				sendTaskResult
+			};
+		}
+		//#endregion
+		//#region src/client/openFlow.ts
+		/**
+		* dsh-vscode-mode client — 深链打开规则引擎（资源管理器右键 / Unity 外部编辑器落地）。
+		* 规则：文件夹 ⊂ 某已注册工作区 → 页面内弹窗二选一（使用最近的工作区 / 新建工作区）；
+		* 文件夹不在任何工作区 → 直达最近对话所在工作区新增；文件 → 最近对话 + 编辑器展开
+		* （无任何会话 → 以文件父目录注册工作区引导创建）。首路径驱动规则，其余路径：文件进
+		* 编辑器、文件夹补引用。纯函数可单测；编排依赖经 OpenDeps 注入（mock 可测）。
+		* 作者 ddj 2026-09-07
+		*/
+		/** 等列表/输入就绪的节奏。 */
+		const READY_TIMEOUT_MS = 15e3;
+		const READY_TICK_MS = 300;
+		const REF_RETRY_MAX = 20;
+		const REF_RETRY_MS = 300;
+		/**
+		* 路径规范化：`\→/`、小写、去尾分隔符（Windows 大小写不敏感前缀匹配用）。
+		* @author ddj 2026年09月07号
+		*/
+		function normPath(p) {
+			return String(p ?? "").replace(/\\/g, "/").replace(/\/+$/, "").toLowerCase();
+		}
+		/**
+		* 目录包含判定：child === root 或 child 位于 root 之下。
+		* @author ddj 2026年09月07号
+		*/
+		function containsPath(root, child) {
+			const r = normPath(root);
+			const c = normPath(child);
+			return c === r || c.startsWith(r + "/");
+		}
+		/**
+		* 父目录（文件引导创建工作区用；根路径回退自身）。
+		* @author ddj 2026年09月07号
+		*/
+		function dirnameOf(p) {
+			const norm = String(p ?? "").replace(/[\\/]+$/, "");
+			const cut = Math.max(norm.lastIndexOf("/"), norm.lastIndexOf("\\"));
+			return cut > 0 ? norm.slice(0, cut) : norm;
+		}
+		/**
+		* 最近一次对话：排除子代理行，updatedAt 最新优先。
+		* @author ddj 2026年09月07号
+		*/
+		function recentSession(byId, ids) {
+			return (ids ?? Object.keys(byId)).map((id) => byId[id]).filter((row) => row && row.origin !== "subagent").sort((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0))[0];
+		}
+		/**
+		* 文件夹命中的已注册工作区（前缀包含），updatedAt 新者优先。
+		* @author ddj 2026年09月07号
+		*/
+		function matchWorkspaces(items, folder) {
+			return items.filter((ws) => containsPath(ws.path, folder));
+		}
+		/**
+		* 规则分派：目录+命中工作区 → choose；目录未命中 → folderNew（以该文件夹为根注册新工作区，
+		* 用户确认：一律取右键的文件夹本身）；文件有会话 → fileRecent；文件无会话 → bootstrap；
+		* 路径缺失 → abort。
+		* @author ddj 2026年09月08号
+		*/
+		function pickRule(kind, matched, hasSession) {
+			if (kind === "missing") return "abort";
+			if (kind === "directory") return matched ? "choose" : "folderNew";
+			return hasSession ? "fileRecent" : "bootstrap";
+		}
+		/**
+		* 深链打开编排入口：等列表就绪 → 判型 → 规则分派 → 编排 create/open/引用/编辑器。
+		* @author ddj 2026年09月07号
+		* @param ctx 客户端根上下文（sessions/workspaces 服务）
+		* @param params 深链参数（首路径驱动规则）
+		* @param overrides 依赖覆盖（测试注入）
+		*/
+		async function openDeepLink(ctx, params, overrides = {}) {
+			const deps = realDeps(ctx, overrides);
+			if (!await waitListsReady(deps)) {
+				deps.notify("DSH 会话列表未就绪，请稍后重试");
+				return false;
+			}
+			const primary = params.paths[0];
+			const kind = await deps.stat(primary).catch(() => "missing");
+			const sess = deps.sessions();
+			const rule = pickRule(kind, matchWorkspaces(deps.workspaces().items, primary).length > 0, Boolean(recentSession(sess.byId, sess.ids)));
+			try {
+				if (rule === "abort") {
+					deps.notify("路径不存在：" + primary);
+					return false;
+				}
+				if (rule === "choose") await runChoose(deps, primary, params);
+				else if (rule === "folderNew") await runFolderNew(deps, primary, params);
+				else if (rule === "fileRecent") await runFileRecent(deps, primary, params);
+				else await runFileBootstrap(deps, primary, params);
+				return true;
+			} catch (error) {
+				deps.notify("打开失败：" + String(error?.message ?? error));
+				return false;
+			}
+		}
+		/** 等待会话与工作区列表就绪（上限 15s；超时按当前态判定）。 */
+		async function waitListsReady(deps) {
+			for (let waited = 0; waited < READY_TIMEOUT_MS; waited += READY_TICK_MS) {
+				if (deps.sessions().ready && deps.workspaces().ready) return true;
+				await sleep(deps, READY_TICK_MS);
+			}
+			return deps.sessions().ready && deps.workspaces().ready;
+		}
+		/** 规则 1：命中工作区 → 弹窗分派（取消即中止）。 */
+		async function runChoose(deps, folder, params) {
+			const best = bestMatch(deps, matchWorkspaces(deps.workspaces().items, folder));
+			const choice = await deps.choose(best?.title ?? "工作区", folder);
+			if (choice === null) throw new Error("用户取消打开");
+			if (choice === "create") return runFolderNew(deps, folder, params);
+			const sessionId = await spawnInWorkspace(deps, (best ?? deps.workspaces().items[0]).workspaceId, void 0);
+			await settleRef(deps, sessionId, folder, "folder");
+			await openChecked(deps, sessionId, null);
+			await openRest(deps, sessionId, params, 1);
+		}
+		/** 规则 3a：文件 → 所属工作区优先（有会话打开其最近会话；无会话新建 + 文件引用）；无匹配 → 最近对话。 */
+		async function runFileRecent(deps, file, params) {
+			const ws = pickFileWorkspace(deps, file);
+			if (ws) {
+				const anchor = recentSessionIn(deps, ws);
+				if (anchor) {
+					deps.openSession(anchor.id);
+					await openChecked(deps, anchor.id, file, params.line, params.column);
+					await openRest(deps, anchor.id, params, 1);
+					return;
+				}
+				const sessionId = await spawnInWorkspace(deps, ws.workspaceId, void 0);
+				await settleRef(deps, sessionId, file, "file");
+				await openChecked(deps, sessionId, file, params.line, params.column);
+				await openRest(deps, sessionId, params, 1);
+				return;
+			}
+			const anchor = recentSession(deps.sessions().byId, deps.sessions().ids);
+			if (!anchor) return runFileBootstrap(deps, file, params);
+			deps.openSession(anchor.id);
+			await openChecked(deps, anchor.id, file, params.line, params.column);
+			await openRest(deps, anchor.id, params, 1);
+		}
+		/**
+		* 文件所属工作区：前缀命中的工作区里，优先取有会话且最近活跃的；都无会话取路径最具体的。
+		* @author ddj 2026年09月08号
+		*/
+		function pickFileWorkspace(deps, file) {
+			const matches = matchWorkspaces(deps.workspaces().items, file);
+			if (!matches.length) return void 0;
+			const withSessions = matches.filter((ws) => (ws.sessionIds ?? []).some((id) => Boolean(deps.sessions().byId[id])));
+			if (!withSessions.length) return [...matches].sort((a, b) => normPath(b.path).length - normPath(a.path).length)[0];
+			return withSessions.sort((a, b) => latestSessionAt(deps, b) - latestSessionAt(deps, a))[0];
+		}
+		/** 工作区内会话的最近活跃时间（无成员 → 0）。 */
+		function latestSessionAt(deps, ws) {
+			const byId = deps.sessions().byId;
+			return (ws.sessionIds ?? []).reduce((max, id) => Math.max(max, byId[id]?.updatedAt ?? 0), 0);
+		}
+		/** 工作区内最近一次会话（排除子代理与不在列表中的陈旧行）。 */
+		function recentSessionIn(deps, ws) {
+			const byId = deps.sessions().byId;
+			return (ws.sessionIds ?? []).map((id) => byId[id]).filter((row) => row && row.origin !== "subagent").sort((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0))[0];
+		}
+		/** 规则 3b：文件 + 无任何会话 → 父目录注册工作区 + 新对话 + 文件引用 + 编辑器打开。 */
+		async function runFileBootstrap(deps, file, params) {
+			const sessionId = await spawnInWorkspace(deps, (await deps.createWorkspace(dirnameOf(file))).workspaceId, void 0);
+			await settleRef(deps, sessionId, file, "file");
+			await openChecked(deps, sessionId, file, params.line, params.column);
+			await openRest(deps, sessionId, params, 1);
+		}
+		/** 规则 1.2：以文件夹注册新工作区 + 新对话 + 文件夹引用 + 编辑页。 */
+		async function runFolderNew(deps, folder, params) {
+			const sessionId = await spawnInWorkspace(deps, (await deps.createWorkspace(folder)).workspaceId, void 0);
+			await settleRef(deps, sessionId, folder, "folder");
+			await openChecked(deps, sessionId, null);
+			await openRest(deps, sessionId, params, 1);
+		}
+		/** 在指定工作区（或回退 cwd）新建对话并置为当前；返回新会话 id。 */
+		async function spawnInWorkspace(deps, workspaceId, fallbackCwd) {
+			const sessionId = await deps.createSession(workspaceId ? { workspaceId } : fallbackCwd ? { cwd: fallbackCwd } : {});
+			deps.openSession(sessionId);
+			return sessionId;
+		}
+		/** 命中工作区集中「最近」的一个（其成员会话 updatedAt 最新者优先）。 */
+		function bestMatch(deps, matches) {
+			const byId = deps.sessions().byId;
+			const score = (ws) => {
+				const sessionLatest = (ws.sessionIds ?? []).reduce((max, id) => Math.max(max, byId[id]?.updatedAt ?? 0), 0);
+				return Math.max(sessionLatest, Date.parse(ws.updatedAt ?? "") || 0);
+			};
+			return [...matches].sort((a, b) => score(b) - score(a))[0];
+		}
+		/** 引用插入轮询：输入门面就绪前每 300ms 重试（appendReference 忙态已降级视为成功）。 */
+		async function settleRef(deps, sessionId, path, appearance) {
+			for (let attempt = 0; attempt < REF_RETRY_MAX; attempt++) {
+				if (await deps.reference(sessionId, path, appearance)) return;
+				await sleep(deps, REF_RETRY_MS);
+			}
+			throw new Error("引用插入未完成");
+		}
+		/** 其余路径：文件进编辑器（步进），文件夹补文件夹引用。 */
+		async function openRest(deps, sessionId, params, from) {
+			const rest = params.paths.slice(from);
+			for (const path of rest) {
+				const kind = await deps.stat(path).catch(() => "missing");
+				if (kind === "file") await openChecked(deps, sessionId ?? void 0, path);
+				else if (kind === "directory" && sessionId) await settleRef(deps, sessionId, path, "folder");
+				else throw new Error("路径不存在：" + path);
+			}
+		}
+		/** 可注入 sleep。 */
+		function sleep(deps, ms) {
+			return new Promise((resolve) => deps.schedule(resolve, ms));
+		}
+		/** 真实依赖装配（全部来自 ctx 注入服务 + 既有 RPC/弹窗/编辑器入口）。 */
+		function realDeps(ctx, overrides = {}) {
+			const service = (name) => {
+				const get = ctx?.get;
+				return typeof get === "function" ? get.call(ctx, name) : void 0;
+			};
+			const add = createAddToConversation(ctx);
+			return {
+				stat: async (path) => {
+					const result = await rpc("edrv.externalStat", { path });
+					return result.ok ? result.kind : "missing";
+				},
+				workspaces: () => {
+					const snap = service("workspaces")?.list?.getSnapshot?.() ?? {};
+					return {
+						items: snap.items ?? [],
+						ready: snap.phase === "ready"
+					};
+				},
+				sessions: () => {
+					const snap = service("sessions")?.list?.getSnapshot?.() ?? {};
+					return {
+						ids: snap.ids ?? [],
+						byId: snap.byId ?? {},
+						ready: snap.phase !== "pending"
+					};
+				},
+				createSession: async (opts) => {
+					const sessions = service("sessions");
+					if (typeof sessions?.create === "function") try {
+						const created = await sessions.create(opts);
+						const id = typeof created === "string" && created ? created : typeof created?.id === "string" ? created.id : typeof created?.sessionId === "string" ? created.sessionId : "";
+						if (id) return id;
+					} catch {}
+					const draft = await newDraftSession(ctx, opts.cwd);
+					if (draft.ok && draft.id) return draft.id;
+					throw new Error("新建会话失败");
+				},
+				createWorkspace: async (path) => {
+					const ws = await service("workspaces").create({ path });
+					return {
+						workspaceId: ws.workspaceId,
+						title: ws.title
+					};
+				},
+				openSession: (id) => {
+					try {
+						const sessions = service("sessions");
+						sessions?.materializeScope?.(id);
+						sessions?.manager?.select?.(id);
+						sessions?.open?.(id);
+					} catch {}
+				},
+				reference: async (sessionId, path, appearance) => {
+					const outcome = await add.appendReference(sessionId, path, void 0, appearance);
+					return outcome === "ok" || outcome === "busy";
+				},
+				choose: (title, folder) => chooseWorkspace(title, folder),
+				openEditor: requestOpen,
+				schedule: (fn, ms) => setTimeout(fn, ms),
+				notify: (text) => toastDom(text),
+				...overrides
+			};
+		}
+		/** @private @author ddj 2026年09月28号
+		* Await actual editor completion and propagate failure to the request result.
+		* @param deps Open dependencies.
+		* @param sessionId Target session.
+		* @param path Target file or editor mount.
+		* @param line Optional line.
+		* @param column Optional column.
+		*/
+		async function openChecked(deps, sessionId, path, line, column) {
+			if (!await deps.openEditor(path, line, column, sessionId)) throw new Error("编辑器打开未完成：" + (path ?? "工作区"));
+		}
+		//#endregion
+		//#region src/client/externalOpen.ts
+		/**
+		* dsh-vscode-mode client — 外部深链落地（Windows 右键菜单 / Unity 外部编辑器）。
+		* 启动时解析 location.search 的 edrvOpen 深链：跨源 referrer 守卫防外部网页诱导；
+		* 处理完剥离 URL 参数防刷新重开；执行委托 openFlow 打开规则引擎（工作区/对话智能路由）。
+		* 另挂 3s 移交轮询（兼活跃心跳）：launcher 投递的打开请求由已打开页面就地执行，避免重复开新页。
+		* 作者 ddj 2026-09-07 / 2026-09-08
+		*/
+		/** toast 自隐时长。 */
+		const TOAST_MS = 5e3;
+		/** 深链移交轮询周期（兼活跃心跳）。 */
+		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 服务）
+		* @param options 可注入选项
+		*/
+		function setupExtOpen(ctx, options = {}) {
+			const dispose = startPresencePoll(ctx);
+			const params = parseOpenParams(options.search ?? (typeof location !== "undefined" ? location.search : ""));
+			if (!params) return dispose;
+			const referrer = options.referrer ?? (typeof document !== "undefined" ? document.referrer : "");
+			if (!referrerAllowed(referrer, options.origin ?? (typeof location !== "undefined" ? location.origin : ""))) {
+				log$2.warn("已忽略跨源深链请求（referrer=" + referrer + "）");
+				return dispose;
+			}
+			stripCurrentUrl();
+			openDeepLink(ctx, params).catch((error) => {
+				log$2.warn("深链打开失败：" + String(error));
+				toastDom("深链打开失败：" + String(error?.message ?? error));
+			});
+			return dispose;
+		}
+		/**
+		* 深链移交轮询：可见时每 3s 向 host 领取待打开请求（兼活跃心跳，launcher 据此决定是否开新页）；
+		* 页面隐藏时降到 15s 一次——无人看页面时移交不必保持 3s 精度，但心跳不能停（超期会让 host 判页面已死）。
+		* 页面级单例（window 标记防 HMR 重复）；领取到即执行打开规则。
+		* @author ddj 2026年09月08号 / 2026年10月15号
+		* @param ctx 客户端根上下文
+		*/
+		function startPresencePoll(ctx) {
+			if (typeof window === "undefined") return () => {};
+			const marker = window;
+			if (typeof marker.__edrvExtPoll === "function") marker.__edrvExtPoll();
+			const generatedId = createRequestId();
+			if (!generatedId) {
+				log$2.warn("安全随机源不可用，已停用外部打开心跳");
+				return () => {};
+			}
+			const clientId = generatedId;
+			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;
+				try {
+					const success = await openDeepLink(ctx, open);
+					if (!disposed) await rpc("edrv.external.ack", {
+						token: open.token,
+						leaseId: open.leaseId,
+						clientId,
+						success,
+						error: success ? void 0 : "编辑器打开失败或取消"
+					});
+				} finally {
+					executing = false;
+				}
+			}
+			/** @private @author ddj 2026年09月28号 Poll while opening to renew the lease without accepting a second request. */
+			async function tick() {
+				if (disposed || polling) return;
+				polling = true;
+				try {
+					const result = await rpc("edrv.external.pending", {
+						clientId,
+						busy: executing
+					});
+					if (!disposed && result.ok && result.open && !executing) execute(result.open).catch(() => {});
+				} finally {
+					polling = false;
+				}
+			}
+			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. */
+			function dispose() {
+				disposed = true;
+				window.clearInterval(timer);
+				disposeOpenWait();
+				if (marker.__edrvExtPoll === dispose) delete marker.__edrvExtPoll;
+			}
+			marker.__edrvExtPoll = dispose;
+			tick().catch(() => {});
+			return dispose;
+		}
+		/**
+		* 跨源守卫：referrer 为空（launcher/Unity 直开）或同源 → 允许。
+		* @author ddj 2026年09月07号
+		* @param referrer 文档 referrer
+		* @param origin 当前页面源
+		* @returns 是否允许处理深链
+		*/
+		function referrerAllowed(referrer, origin) {
+			if (!referrer) return true;
+			try {
+				return new URL(referrer).origin === origin;
+			} catch {
+				return false;
+			}
+		}
+		/**
+		* 剥离 URL 中的深链参数（保留其余参数与 hash，防刷新重开）。
+		* @author ddj 2026年09月07号
+		* @param href 完整 URL
+		* @returns 清理后的 URL（pathname+search+hash）
+		*/
+		function stripOpenHref(href) {
+			const url = new URL(href);
+			for (const key of EDRV_PARAM_KEYS) url.searchParams.delete(key);
+			return url.pathname + url.search + url.hash;
+		}
+		/** 清理当前页面 URL（best-effort，失败不阻塞打开）。 */
+		function stripCurrentUrl() {
+			try {
+				if (typeof location === "undefined" || typeof history === "undefined") return;
+				const next = stripOpenHref(location.href);
+				if (next !== location.pathname + location.search + location.hash) history.replaceState(null, "", next);
+			} catch {}
+		}
+		/**
+		* 轻量 toast（编辑器未挂载也能提示；5s 自隐；openFlow 通知与错误呈现共用）。
+		* @author ddj 2026年09月07号
+		* @param text 提示文本
+		*/
+		function toastDom(text) {
+			if (typeof document === "undefined") return;
+			const toast = document.createElement("div");
+			toast.textContent = text;
+			toast.setAttribute("style", [
+				"position:fixed",
+				"left:50%",
+				"bottom:28px",
+				"transform:translateX(-50%)",
+				"z-index:99999",
+				"padding:8px 14px",
+				"border-radius:8px",
+				"max-width:80vw",
+				"background:#2a2a2a",
+				"color:#ddd",
+				"border:1px solid #444",
+				"font-size:12px",
+				"box-shadow:0 4px 16px rgba(0,0,0,.35)"
+			].join(";"));
+			document.body?.appendChild(toast);
+			setTimeout(() => toast.remove(), TOAST_MS);
+		}
+		//#endregion
 		//#region src/client/ui/ReviewAllConfirm.ts
 		/**
 		* @public
@@ -3731,7 +5069,7 @@ window.__ModuleLoader__.load({
 		*/
 		function ReviewAllConfirm(props) {
 			const action = props.reject ? "Undo All" : "Keep All";
-			const warning = props.reject ? "撤销会改写磁盘；逐项安全校验，遇到冲突停止，已完成项不会自动恢复。" : "只标记待审修改为保留，不改写文件。";
+			const warning = props.reject ? "撤销会改写磁盘；逐项安全校验，遇到冲突停止，已完成项不会自动恢复。" : "只标记待审修改为保留，不改写文件；个别条目若已变化或需在活跃端判定会被跳过并留在列表里，可逐个处理。";
 			const footer = react$1.default.createElement(react$1.default.Fragment, null, react$1.default.createElement(_deepseek_ai_dsh_client_ui_primitives.Button, {
 				variant: "ghost",
 				onClick: props.onCancel,
@@ -4214,6 +5552,34 @@ window.__ModuleLoader__.load({
 			return !!page?.overview?.coveredPaths.some((candidate) => diffPathKey(candidate) === key);
 		}
 		/**
+		* @author ddj 2026年11月3号
+		* @description: 本页待审条目占用的路径键：路径本身与其身份各一份。
+		* @param page 审查页
+		* @returns 待审覆盖的路径键集合
+		*/
+		function pendingCoverKeys(page) {
+			const keys = /* @__PURE__ */ new Set();
+			for (const item of page?.items ?? []) {
+				if (!item.id.startsWith("pending:")) continue;
+				keys.add(diffPathKey(item.currentPath || item.path));
+				keys.add(diffPathKey(item.id.slice(8)));
+			}
+			return keys;
+		}
+		/**
+		* @public
+		* @author ddj 2026年11月3号
+		* @description: 取本页"已有权威通道在管"的路径键：官方汇总覆盖集 + 待审条目。
+		* 编辑器与差异汇总必须同口径，否则同一改动在列表里被压掉、在编辑器里却仍然画得出来并可以点。
+		* @param page 审查页
+		* @returns 路径比较键集合
+		*/
+		function coveredPathKeys(page) {
+			const keys = pendingCoverKeys(page);
+			for (const path of page?.overview?.coveredPaths ?? []) keys.add(diffPathKey(path));
+			return keys;
+		}
+		/**
 		* @author ddj 2026年10月30号
 		* @description: 取出本页待审条目（id 带待审前缀）并折算成文件行。
 		* @param page 审查页
@@ -4221,12 +5587,9 @@ window.__ModuleLoader__.load({
 		*/
 		function pendingRowsOf(page) {
 			const rows = [];
-			const covered = /* @__PURE__ */ new Set();
 			for (const item of page?.items ?? []) {
 				if (!item.id.startsWith("pending:")) continue;
 				const path = item.currentPath || item.path;
-				covered.add(diffPathKey(path));
-				covered.add(diffPathKey(item.id.slice(8)));
 				rows.push({
 					path,
 					label: item.display || path,
@@ -4239,7 +5602,7 @@ window.__ModuleLoader__.load({
 			}
 			return {
 				rows,
-				covered
+				covered: pendingCoverKeys(page)
 			};
 		}
 		/** @public @author ddj 2026年10月26号 @param records Tool-call history. @param page Official file navigation, never only its first 50 rows. @returns Pending first, then official; legacy paths remain explicitly labelled. */
@@ -145912,10 +147275,10 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 		var require_useMergeRef = /* @__PURE__ */ __commonJSMin(((exports) => {
 			Object.defineProperty(exports, "__esModule", { value: true });
 			exports.useMergeRefs = void 0;
-			var React$69 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports)).__importStar(require("react"));
+			var React$68 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports)).__importStar(require("react"));
 			var assignRef_1 = require_assignRef();
 			var useRef_1 = require_useRef();
-			var useIsomorphicLayoutEffect = typeof window !== "undefined" ? React$69.useLayoutEffect : React$69.useEffect;
+			var useIsomorphicLayoutEffect = typeof window !== "undefined" ? React$68.useLayoutEffect : React$68.useEffect;
 			var currentValues = /* @__PURE__ */ new WeakMap();
 			/**
 			* Merges two or more refs together providing a single interface to set their value
@@ -146195,7 +147558,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 			Object.defineProperty(exports, "__esModule", { value: true });
 			exports.sidecar = void 0;
 			var tslib_1 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports));
-			var React$68 = tslib_1.__importStar(require("react"));
+			var React$67 = tslib_1.__importStar(require("react"));
 			var hook_1 = require_hook$1();
 			function sidecar(importer, errorComponent) {
 				var ErrorCase = function() {
@@ -146204,7 +147567,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 				return function Sidecar(props) {
 					var _a = (0, hook_1.useSidecar)(importer, props.sideCar), Car = _a[0];
 					if (_a[1] && errorComponent) return ErrorCase;
-					return Car ? React$68.createElement(Car, tslib_1.__assign({}, props)) : null;
+					return Car ? React$67.createElement(Car, tslib_1.__assign({}, props)) : null;
 				};
 			}
 			exports.sidecar = sidecar;
@@ -146319,7 +147682,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 			Object.defineProperty(exports, "__esModule", { value: true });
 			exports.renderCar = void 0;
 			var tslib_1 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports));
-			var React$67 = tslib_1.__importStar(require("react"));
+			var React$66 = tslib_1.__importStar(require("react"));
 			var react_1 = require("react");
 			function renderCar(WrappedComponent, defaults) {
 				function State(_a) {
@@ -146332,9 +147695,9 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 						});
 						return null;
 					}, []);
-					return React$67.createElement(WrappedComponent, tslib_1.__assign({}, props, { children: renderTarget }));
+					return React$66.createElement(WrappedComponent, tslib_1.__assign({}, props, { children: renderTarget }));
 				}
-				var Children = React$67.memo(function(_a) {
+				var Children = React$66.memo(function(_a) {
 					var stateRef = _a.stateRef, defaultState = _a.defaultState, children = _a.children;
 					var _b = (0, react_1.useState)(defaultState.current), state = _b[0], setState = _b[1];
 					(0, react_1.useEffect)(function() {
@@ -146345,14 +147708,14 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 					return true;
 				});
 				return function Combiner(props) {
-					var defaultState = React$67.useRef(defaults(props));
-					var ref = React$67.useRef(function(state) {
+					var defaultState = React$66.useRef(defaults(props));
+					var ref = React$66.useRef(function(state) {
 						return defaultState.current = state;
 					});
-					return React$67.createElement(React$67.Fragment, null, React$67.createElement(State, {
+					return React$66.createElement(React$66.Fragment, null, React$66.createElement(State, {
 						stateRef: ref,
 						props
-					}), React$67.createElement(Children, {
+					}), React$66.createElement(Children, {
 						stateRef: ref,
 						defaultState,
 						children: props.children
@@ -146367,13 +147730,13 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 			Object.defineProperty(exports, "__esModule", { value: true });
 			exports.exportSidecar = void 0;
 			var tslib_1 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports));
-			var React$66 = tslib_1.__importStar(require("react"));
+			var React$65 = tslib_1.__importStar(require("react"));
 			var SideCar = function(_a) {
 				var sideCar = _a.sideCar, rest = tslib_1.__rest(_a, ["sideCar"]);
 				if (!sideCar) throw new Error("Sidecar: please provide `sideCar` property to import the right car");
 				var Target = sideCar.read();
 				if (!Target) throw new Error("Sidecar medium not found");
-				return React$66.createElement(Target, tslib_1.__assign({}, rest));
+				return React$65.createElement(Target, tslib_1.__assign({}, rest));
 			};
 			SideCar.isSideCarExport = true;
 			function exportSidecar(medium, exported) {
@@ -146449,7 +147812,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 			Object.defineProperty(exports, "__esModule", { value: true });
 			exports.RemoveScroll = void 0;
 			var tslib_1 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports));
-			var React$65 = tslib_1.__importStar(require("react"));
+			var React$64 = tslib_1.__importStar(require("react"));
 			var constants_1 = require_constants();
 			var use_callback_ref_1 = require_es5$5();
 			var medium_1 = require_medium();
@@ -146457,9 +147820,9 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 			/**
 			* Removes scrollbar from the page and contain the scroll within the Lock
 			*/
-			var RemoveScroll = React$65.forwardRef(function(props, parentRef) {
-				var ref = React$65.useRef(null);
-				var _a = React$65.useState({
+			var RemoveScroll = React$64.forwardRef(function(props, parentRef) {
+				var ref = React$64.useRef(null);
+				var _a = React$64.useState({
 					onScrollCapture: nothing,
 					onWheelCapture: nothing,
 					onTouchMoveCapture: nothing
@@ -146482,7 +147845,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 				var SideCar = sideCar;
 				var containerRef = (0, use_callback_ref_1.useMergeRefs)([ref, parentRef]);
 				var containerProps = tslib_1.__assign(tslib_1.__assign({}, rest), callbacks);
-				return React$65.createElement(React$65.Fragment, null, enabled && React$65.createElement(SideCar, {
+				return React$64.createElement(React$64.Fragment, null, enabled && React$64.createElement(SideCar, {
 					sideCar: medium_1.effectCar,
 					removeScrollBar,
 					shards,
@@ -146493,7 +147856,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 					allowPinchZoom: !!allowPinchZoom,
 					lockRef: ref,
 					gapMode
-				}), forwardProps ? React$65.cloneElement(React$65.Children.only(children), tslib_1.__assign(tslib_1.__assign({}, containerProps), { ref: containerRef })) : React$65.createElement(Container, tslib_1.__assign({}, containerProps, {
+				}), forwardProps ? React$64.cloneElement(React$64.Children.only(children), tslib_1.__assign(tslib_1.__assign({}, containerProps), { ref: containerRef })) : React$64.createElement(Container, tslib_1.__assign({}, containerProps, {
 					className,
 					ref: containerRef
 				}), children));
@@ -146572,7 +147935,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 		var require_hook = /* @__PURE__ */ __commonJSMin(((exports) => {
 			Object.defineProperty(exports, "__esModule", { value: true });
 			exports.styleHookSingleton = void 0;
-			var React$64 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports)).__importStar(require("react"));
+			var React$63 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports)).__importStar(require("react"));
 			var singleton_1 = require_singleton();
 			/**
 			* creates a hook to control style singleton
@@ -146586,7 +147949,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 			var styleHookSingleton = function() {
 				var sheet = (0, singleton_1.stylesheetSingleton)();
 				return function(styles, isDynamic) {
-					React$64.useEffect(function() {
+					React$63.useEffect(function() {
 						sheet.add(styles);
 						return function() {
 							sheet.remove();
@@ -146691,7 +148054,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 		var require_component = /* @__PURE__ */ __commonJSMin(((exports) => {
 			Object.defineProperty(exports, "__esModule", { value: true });
 			exports.RemoveScrollBar = exports.useLockAttribute = exports.lockAttribute = void 0;
-			var React$63 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports)).__importStar(require("react"));
+			var React$62 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports)).__importStar(require("react"));
 			var react_style_singleton_1 = require_es5$2();
 			var constants_1 = require_constants();
 			var utils_1 = require_utils();
@@ -146711,7 +148074,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 				return isFinite(counter) ? counter : 0;
 			};
 			var useLockAttribute = function() {
-				React$63.useEffect(function() {
+				React$62.useEffect(function() {
 					document.body.setAttribute(exports.lockAttribute, (getCurrentUseCounter() + 1).toString());
 					return function() {
 						var newCounter = getCurrentUseCounter() - 1;
@@ -146727,10 +148090,10 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 			var RemoveScrollBar = function(_a) {
 				var noRelative = _a.noRelative, noImportant = _a.noImportant, _b = _a.gapMode, gapMode = _b === void 0 ? "margin" : _b;
 				(0, exports.useLockAttribute)();
-				var gap = React$63.useMemo(function() {
+				var gap = React$62.useMemo(function() {
 					return (0, utils_1.getGapWidth)(gapMode);
 				}, [gapMode]);
-				return React$63.createElement(Style, { styles: getStyles(gap, !noRelative, gapMode, !noImportant ? "!important" : "") });
+				return React$62.createElement(Style, { styles: getStyles(gap, !noRelative, gapMode, !noImportant ? "!important" : "") });
 			};
 			exports.RemoveScrollBar = RemoveScrollBar;
 		}));
@@ -146892,7 +148255,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 			Object.defineProperty(exports, "__esModule", { value: true });
 			exports.RemoveScrollSideCar = exports.getDeltaXY = exports.getTouchXY = void 0;
 			var tslib_1 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports));
-			var React$62 = tslib_1.__importStar(require("react"));
+			var React$61 = tslib_1.__importStar(require("react"));
 			var react_remove_scroll_bar_1 = require_es5$1();
 			var react_style_singleton_1 = require_es5$2();
 			var aggresiveCapture_1 = require_aggresiveCapture();
@@ -146917,16 +148280,16 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 			var idCounter = 0;
 			var lockStack = [];
 			function RemoveScrollSideCar(props) {
-				var shouldPreventQueue = React$62.useRef([]);
-				var touchStartRef = React$62.useRef([0, 0]);
-				var activeAxis = React$62.useRef();
-				var id = React$62.useState(idCounter++)[0];
-				var Style = React$62.useState(react_style_singleton_1.styleSingleton)[0];
-				var lastProps = React$62.useRef(props);
-				React$62.useEffect(function() {
+				var shouldPreventQueue = React$61.useRef([]);
+				var touchStartRef = React$61.useRef([0, 0]);
+				var activeAxis = React$61.useRef();
+				var id = React$61.useState(idCounter++)[0];
+				var Style = React$61.useState(react_style_singleton_1.styleSingleton)[0];
+				var lastProps = React$61.useRef(props);
+				React$61.useEffect(function() {
 					lastProps.current = props;
 				}, [props]);
-				React$62.useEffect(function() {
+				React$61.useEffect(function() {
 					if (props.inert) {
 						document.body.classList.add("block-interactivity-".concat(id));
 						var allow_1 = tslib_1.__spreadArray([props.lockRef.current], (props.shards || []).map(extractRef), true).filter(Boolean);
@@ -146945,7 +148308,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 					props.lockRef.current,
 					props.shards
 				]);
-				var shouldCancelEvent = React$62.useCallback(function(event, parent) {
+				var shouldCancelEvent = React$61.useCallback(function(event, parent) {
 					if ("touches" in event && event.touches.length === 2 || event.type === "wheel" && event.ctrlKey) return !lastProps.current.allowPinchZoom;
 					var touch = (0, exports.getTouchXY)(event);
 					var touchStart = touchStartRef.current;
@@ -146971,7 +148334,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 					var cancelingAxis = activeAxis.current || currentAxis;
 					return (0, handleScroll_1.handleScroll)(cancelingAxis, parent, event, cancelingAxis === "h" ? deltaX : deltaY, true);
 				}, []);
-				var shouldPrevent = React$62.useCallback(function(_event) {
+				var shouldPrevent = React$61.useCallback(function(_event) {
 					var event = _event;
 					if (!lockStack.length || lockStack[lockStack.length - 1] !== Style) return;
 					var delta = "deltaY" in event ? (0, exports.getDeltaXY)(event) : (0, exports.getTouchXY)(event);
@@ -146991,7 +148354,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 						}
 					}
 				}, []);
-				var shouldCancel = React$62.useCallback(function(name, delta, target, should) {
+				var shouldCancel = React$61.useCallback(function(name, delta, target, should) {
 					var event = {
 						name,
 						delta,
@@ -147006,17 +148369,17 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 						});
 					}, 1);
 				}, []);
-				var scrollTouchStart = React$62.useCallback(function(event) {
+				var scrollTouchStart = React$61.useCallback(function(event) {
 					touchStartRef.current = (0, exports.getTouchXY)(event);
 					activeAxis.current = void 0;
 				}, []);
-				var scrollWheel = React$62.useCallback(function(event) {
+				var scrollWheel = React$61.useCallback(function(event) {
 					shouldCancel(event.type, (0, exports.getDeltaXY)(event), event.target, shouldCancelEvent(event, props.lockRef.current));
 				}, []);
-				var scrollTouchMove = React$62.useCallback(function(event) {
+				var scrollTouchMove = React$61.useCallback(function(event) {
 					shouldCancel(event.type, (0, exports.getTouchXY)(event), event.target, shouldCancelEvent(event, props.lockRef.current));
 				}, []);
-				React$62.useEffect(function() {
+				React$61.useEffect(function() {
 					lockStack.push(Style);
 					props.setCallbacks({
 						onScrollCapture: scrollWheel,
@@ -147036,7 +148399,7 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 					};
 				}, []);
 				var removeScrollBar = props.removeScrollBar, inert = props.inert;
-				return React$62.createElement(React$62.Fragment, null, inert ? React$62.createElement(Style, { styles: generateStyle(id) }) : null, removeScrollBar ? React$62.createElement(react_remove_scroll_bar_1.RemoveScrollBar, {
+				return React$61.createElement(React$61.Fragment, null, inert ? React$61.createElement(Style, { styles: generateStyle(id) }) : null, removeScrollBar ? React$61.createElement(react_remove_scroll_bar_1.RemoveScrollBar, {
 					noRelative: props.noRelative,
 					gapMode: props.gapMode
 				}) : null);
@@ -147068,11 +148431,11 @@ For more info please visit our website: https://redi.wzhu.dev/en-US/docs/faq#imp
 		var require_Combination = /* @__PURE__ */ __commonJSMin(((exports) => {
 			Object.defineProperty(exports, "__esModule", { value: true });
 			var tslib_1 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports));
-			var React$61 = tslib_1.__importStar(require("react"));
+			var React$60 = tslib_1.__importStar(require("react"));
 			var UI_1 = require_UI();
 			var sidecar_1 = tslib_1.__importDefault(require_sidecar());
-			var ReactRemoveScroll = React$61.forwardRef(function(props, ref) {
-				return React$61.createElement(UI_1.RemoveScroll, tslib_1.__assign({}, props, {
+			var ReactRemoveScroll = React$60.forwardRef(function(props, ref) {
+				return React$60.createElement(UI_1.RemoveScroll, tslib_1.__assign({}, props, {
 					ref,
 					sideCar: sidecar_1.default
 				}));
@@ -375421,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;
@@ -375444,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]);
@@ -375512,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 });
@@ -382739,6 +384114,8 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 		const SIDECAR_KEEP_TITLE = "标记这些历史改动为已看过：只改记录，不改写磁盘文件，也不影响官方审查。";
 		/** 非官方 Undo 的作用域说明：走原有回滚校验写回磁盘，但不影响官方记录。 */
 		const SIDECAR_UNDO_TITLE = "撤销这些历史改动（写回受回滚校验保护）：只影响这份历史记录，不影响官方审查。";
+		/** 非官方 Keep 之后的完成态：该通道 Keep 不写盘，不能沿用「已采纳」这种会让人以为改过文件的措辞。 */
+		const SIDECAR_KEEP_DONE = "已标记为看过（未改动文件）";
 		/** 当前端没有该会话时，差异栏里给中性说明而不是红色报错。 */
 		const SESSION_DOWN_NOTICE = "这个会话没在当前端激活，官方审查数据暂时读不到；下面的历史改动仍可查看、Keep、Undo。";
 		/**
@@ -384506,641 +385883,6 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				localStorage.setItem(key, text);
 			} catch (error) {}
 		}
-		//#endregion
-		//#region src/client/addToConversation.ts
-		/**
-		* dsh-vscode-mode client — 把文件/选中内容注入会话对话输入框（composer draft）。
-		* 复用 DSH 官方输入门面：ctx.conversation.input.for(sessions.scope(sessionId)) → SessionInput。
-		* 引用 chip：insertReference（reference source，发送时序列化为 @path 文本）；忙态降级为纯文本 setDraft。
-		* 纯函数部分 node 可单测。
-		* 作者 ddj 2026-08-25
-		*/
-		/** 把追加引用结果映射为可读文案（ok 用 okText；busy 提示已降级纯文本；unavailable 提示不可用）。
-		* @author ddj 2026年09月03号 / 2026年09月11号
-		* @param outcome 追加结果状态
-		* @param okText 成功文案（如「已添加文件引用」/「已添加文件夹引用」）
-		* @returns 状态栏/通知用文案
-		*/
-		function statusOfAdd(outcome, okText) {
-			if (outcome === "ok") return okText;
-			if (outcome === "busy") return okText + "（已降级纯文本）";
-			if (outcome === "failed") return "添加引用失败（输入框忙或未就绪，请重试）";
-			return "无法添加到对话（无会话或输入框不可用）";
-		}
-		/** DSH reference source 名（dsh-client-ui-reference 注册的 @file/@session 统一源）。 */
-		const REF_SOURCE = "reference";
-		/**
-		* 把 clipboard 投影的末尾折算成 **detect 投影**的末尾。
-		*
-		* ⚠️ 两个投影对 chip 的计长不同，混用会直接毁掉已插入的引用（真实缺陷，勿改回 `draft.length`）：
-		* DSH 的 `$composerLayout()` 中 chip 在 detect 投影里只贡献 **1 个 U+FFFC**，
-		* 在 clipboard 投影里贡献 `clipboardText` 全文
-		* （`pushLeaf('chip', kid, '', kid.getTextContent())`）。
-		* 而 `insertReference(ref, span)` 的 span 走 detect 坐标并经 `selectSpan` 校验：
-		* `span.end > layout.detectLength` 时返回 null → 插入失败。
-		*
-		* 旧实现直接用 `draft.length`（clipboard 长度）当 detect 起点：草稿里一旦有 chip，
-		* 该值就超出 detect 长度 → 插入被拒 → 落入 `setDraft` 兜底，
-		* 而 `setDraft` 会整篇重建并剔除 U+FFFC（`text.replace(REFERENCE_PLACEHOLDER_RE, '')`），
-		* 于是**既有 chip 被销毁、引用退化为重复的纯文本**（即「连续添加多个引用显示异常」）。
-		*
-		* 换算：每个 chip 在 clipboard 中多算了 `length - 1`，逐个扣回即得 detect 末尾。
-		* 无 occurrences（旧版 DSH）时退化为 `draft.length`，与旧行为一致。
-		* @author ddj 2026年09月11号
-		* @param snapshot 输入快照
-		* @returns detect 投影中的文档末尾偏移
-		*/
-		function detectEndOf(snapshot) {
-			const total = String(snapshot?.draft ?? "").length;
-			const occurrences = snapshot?.occurrences;
-			if (!Array.isArray(occurrences) || !occurrences.length) return total;
-			let clipped = 0;
-			for (const occurrence of occurrences) {
-				const length = Number(occurrence?.length ?? 0);
-				if (!Number.isFinite(length) || length <= 1) continue;
-				clipped += length - 1;
-			}
-			return Math.max(0, total - clipped);
-		}
-		/** chip 列表按 clipboard 偏移升序（官方已排序，此处防御性归一，丢弃非法项）。 */
-		function chipsOf(snapshot) {
-			const occurrences = snapshot?.occurrences;
-			if (!Array.isArray(occurrences) || !occurrences.length) return [];
-			const out = [];
-			for (const occurrence of occurrences) {
-				const offset = Number(occurrence?.offset ?? NaN);
-				const length = Number(occurrence?.length ?? NaN);
-				if (!Number.isFinite(offset) || !Number.isFinite(length) || length <= 1) continue;
-				out.push({
-					offset: Math.max(0, offset),
-					length
-				});
-			}
-			return out.sort((a, b) => a.offset - b.offset);
-		}
-		/**
-		* detect 偏移 → clipboard 偏移（paddingAt 用：draft 是 clipboard 投影，不能直接按下标取字符）。
-		* 每个位于该偏移之前的 chip 在 clipboard 中多占 `length − 1`，累计补上即可。
-		* @author ddj 2026年09月11号
-		* @param snapshot 输入快照
-		* @param detectOffset detect 投影偏移
-		* @returns clipboard 投影偏移（已夹到 draft 范围内）
-		*/
-		function detectToClipboardOf(snapshot, detectOffset) {
-			const total = String(snapshot?.draft ?? "").length;
-			const target = Math.max(0, Math.min(Number(detectOffset) || 0, detectEndOf(snapshot)));
-			let shift = 0;
-			for (const chip of chipsOf(snapshot)) {
-				if (chip.offset - shift >= target) break;
-				shift += chip.length - 1;
-			}
-			return Math.max(0, Math.min(target + shift, total));
-		}
-		/**
-		* 插入点两侧是否需要补空格（仅纯文本通道需要；chip 由 facade 自行补尾随空格）。
-		*
-		* 在 detect 坐标的任意位置求值，故**末尾追加的行为与旧实现逐字符一致**
-		* （末尾前为非空白 → 前后各补一个空格；末尾前已是空白 → 只补尾随空格），
-		* 同时正确支持「插在文本中间」不再贴字。
-		* @author ddj 2026年09月11号
-		* @param snapshot 输入快照
-		* @param detectOffset detect 投影插入点
-		* @returns 是否需要前导/尾随空格
-		*/
-		function paddingAt(snapshot, detectOffset) {
-			const draft = String(snapshot?.draft ?? "");
-			const at = detectToClipboardOf(snapshot, detectOffset);
-			const before = at > 0 ? draft.slice(at - 1, at) : "";
-			const after = at < draft.length ? draft.slice(at, at + 1) : "";
-			return {
-				lead: before !== "" && !/\s/.test(before),
-				tail: after === "" || !/\s/.test(after)
-			};
-		}
-		/**
-		* 解析插入点（detect 坐标）：优先用输入框**当前光标/选区**（`caretSpan()`，
-		* 官方契约即 detect 坐标，无选区时回落文档末尾），并夹到 `[0, detectLength]`。
-		*
-		* 选区非塌缩时取 `end`（右边界）—— 插入而非替换，绝不删除用户已选中的内容。
-		* caret 缺失/非法（旧版 facade 无该方法、抛异常、NaN 等）一律回落到文档末尾。
-		* @author ddj 2026年09月11号
-		* @param caret caretSpan() 的返回值（可为 null/非法）
-		* @param detectLength detect 投影文档长度
-		* @returns detect 投影插入偏移
-		*/
-		function insertOffsetOf(caret, detectLength) {
-			const max = Math.max(0, Number(detectLength) || 0);
-			if (!caret || typeof caret !== "object") return max;
-			const span = caret;
-			const raw = Number(span.end);
-			const value = Number.isFinite(raw) ? raw : Number(span.start);
-			if (!Number.isFinite(value)) return max;
-			return Math.max(0, Math.min(value, max));
-		}
-		/**
-		* 生成 DSH @file 语法引用串：cwd 相对化、\ → /、含空白时按 @"path" 语法加引号。
-		* cwd 外/无法相对化的路径回退原路径。
-		* @author ddj 2026年08月25号
-		* @param path 打开的文件路径（相对 cwd 或绝对）
-		* @param cwd 会话工作区目录（可选）
-		* @returns 引用串（如 @src/index.ts 或 @"a b.ts"）
-		*/
-		function mentionOf(path, cwd) {
-			const raw = String(path);
-			let rel = raw;
-			if (cwd) {
-				const base = String(cwd).replace(/[\\/]+$/, "");
-				const up = raw.replace(/\\/g, "/");
-				const baseUp = base.replace(/\\/g, "/");
-				if (up.startsWith(baseUp + "/")) rel = up.slice(baseUp.length + 1);
-				else if (up === baseUp) rel = "";
-			}
-			rel = rel.replace(/\\/g, "/").replace(/^\.\//, "");
-			if (!rel) rel = raw.replace(/\\/g, "/");
-			if (/[\u0000-\u001f\u007f-\u009f"]/u.test(rel)) return "@" + raw;
-			return /\s/u.test(rel) ? `@"${rel}"` : `@${rel}`;
-		}
-		/** 引用标签：文件名 + 可选行区间（chip 内展示，不带 @ 前缀）。
-		* @author ddj 2026年08月25号 */
-		function labelOf(path, range) {
-			const base = String(path).split(/[\\/]/).pop() || String(path);
-			if (!range || range.endLine < range.startLine) return base;
-			return range.startLine === range.endLine ? `${base} L${range.startLine}` : `${base} L${range.startLine}-${range.endLine}`;
-		}
-		/** 引用 ref：引用串 + 可选行区间（序列化直出，agent 据此读取对应片段）。
-		* @author ddj 2026年08月25号 */
-		function refOf(mention, range) {
-			if (!range || range.endLine < range.startLine) return mention;
-			return range.startLine === range.endLine ? `${mention} L${range.startLine}` : `${mention} L${range.startLine}-${range.endLine}`;
-		}
-		/** 构造 DSH 文件引用插入载荷，模型文本、剪贴板投影与降级文本共用完整行区间。
-		* @public
-		* @author ddj 2026年10月28号
-		* @returns 引用载荷与含可选行区间的完整引用文本
-		* @param path 目标路径（相对 cwd 或绝对）
-		* @param cwd 会话工作区目录（可选）
-		* @param range 行区间（可选）
-		* @param appearance 引用外观：'file'（默认）| 'folder'
-		*/
-		function buildFileRef(path, cwd, range, appearance = "file") {
-			const mention = refOf(mentionOf(path, cwd), range);
-			return {
-				mention,
-				reference: {
-					source: REF_SOURCE,
-					ref: mention,
-					label: labelOf(path, range),
-					appearance,
-					clipboardText: mention
-				}
-			};
-		}
-		/** @private @author ddj 2026年10月29号 @param receipt Raw selected-channel receipt. @returns Explicit admission evidence and the historical boolean. */
-		function taskReceipt(receipt) {
-			const ok = receipt?.ok;
-			if (ok === true) return {
-				status: "accepted",
-				legacyOk: true
-			};
-			if (ok === false) return {
-				status: "rejected",
-				legacyOk: false
-			};
-			return {
-				status: "unknown",
-				legacyOk: false
-			};
-		}
-		/** @private @author ddj 2026年10月29号 @param ctx Lifecycle owner. @param sessions Public Controller. @param id Fixed target. @param text Task body. @returns Admission evidence without switching transport. @sideEffects Retains and releases exactly one generation. */
-		async function sendOwned(ctx, sessions, id, text) {
-			const controller = new AbortController();
-			const reference = sessions.retain(id, {
-				source: "controllerOperation",
-				signal: controller.signal
-			});
-			let released = false;
-			let cleanupFailed = false;
-			/** @private @author ddj 2026年10月29号 Cancels and releases this exact generation once; remembers unload cleanup failures. */
-			function release() {
-				if (released) return;
-				released = true;
-				controller.abort();
-				try {
-					reference.release();
-				} catch (error) {
-					cleanupFailed = true;
-					throw error;
-				}
-			}
-			let remove;
-			let started = false;
-			let result = {
-				status: "unavailable",
-				legacyOk: false
-			};
-			try {
-				remove = ctx.effect?.(() => release, "vscode-mode: task session reference");
-				const binding = await reference.ready;
-				if (controller.signal.aborted) result = {
-					status: "cancelled",
-					legacyOk: false
-				};
-				else {
-					started = true;
-					result = taskReceipt(await binding.session.prompt([{
-						type: "text",
-						text
-					}], "queue", controller.signal));
-				}
-			} catch {
-				result = {
-					status: started ? "unknown" : "unavailable",
-					legacyOk: false
-				};
-			}
-			const cancelled = controller.signal.aborted;
-			try {
-				release();
-			} catch {
-				cleanupFailed = true;
-			}
-			try {
-				remove?.();
-			} catch {
-				cleanupFailed = true;
-			}
-			if (cleanupFailed) result = {
-				status: started ? "unknown" : "unavailable",
-				legacyOk: false
-			};
-			if (cancelled) result = {
-				status: "cancelled",
-				legacyOk: result.legacyOk
-			};
-			return result;
-		}
-		/** @private @author ddj 2026年10月29号 @param ctx Service owner. @param id Fixed target. @param text Task body. @returns One legacy-channel attempt; no cross-channel retry. */
-		async function sendLegacy(ctx, id, text) {
-			const input = inputFor(ctx, id);
-			if (typeof input?.setDraft === "function" && typeof input.submit === "function") {
-				let submitted = false;
-				try {
-					input.setDraft(text);
-					submitted = true;
-					input.submit();
-					return {
-						status: "submitted",
-						legacyOk: true
-					};
-				} catch {
-					return {
-						status: submitted ? "unknown" : "unavailable",
-						legacyOk: false
-					};
-				}
-			}
-			const remote = ctx.get("remote.session");
-			if (typeof remote?.prompt !== "function") return httpTaskResult(id, text);
-			try {
-				const payload = {
-					sessionId: id,
-					mode: "queue",
-					content: [{
-						type: "text",
-						text
-					}]
-				};
-				const receipt = await remote.prompt(slotArg(payload));
-				return taskReceipt(receipt?.result ?? receipt);
-			} catch {
-				return {
-					status: "unknown",
-					legacyOk: false
-				};
-			}
-		}
-		/** apiproxy wire 端点（POST /api/<method>；浏览器同源 fetch 自带 cookie 鉴权；实证 401=未鉴权而非 404）。 */
-		const SESSION_CREATE_PATH = "/api/session/create";
-		/** apiproxy wire 端点：发送任务（session/prompt；点击即发送方案）。 */
-		const SESSION_PROMPT_PATH = "/api/session/prompt";
-		/** mint RPC 请求 id（RpcId 品牌类型运行时即普通字符串）。 */
-		function mintRpcId() {
-			try {
-				return globalThis.crypto?.randomUUID?.() ?? "rpc-" + Date.now();
-			} catch {
-				return "rpc-" + Date.now();
-			}
-		}
-		/**
-		* wire 槽实参组装（gateway `invoke` 铁证：`request.args[parameter.wire]` 具名槽，
-		* `session/prompt` 的槽名 = "request"，值 = RpcRequest `{rpcId, payload}`）。
-		* @author ddj 2026年09月24号
-		* @param payload 业务载荷
-		* @returns 具名槽实参 `{ args: { request: RpcRequest } }`
-		*/
-		function slotArg(payload) {
-			return { args: { request: {
-				rpcId: mintRpcId(),
-				payload
-			} } };
-		}
-		/**
-		* RPC 返回解析（照官方 dsh-client-runtime 调用形态：`const { result } = await api.sessions.create(...)`）。
-		* 官方 api.sessions 面返回**信封** `{ rpcId, result: RpcResult }`——须解 .result；
-		* 兼容裸 RpcResult 形态（个别补丁面直接回 {ok, value}）。
-		* @author ddj 2026年09月23号
-		* @param res 信封或裸 RpcResult
-		* @returns 归一后的 { ok, value }
-		*/
-		function rpcOk(res) {
-			const r = res?.result ?? res;
-			return {
-				ok: r?.ok === true,
-				value: r?.value
-			};
-		}
-		/**
-		* wire 直调 session/create（主路径）：ClientRequest 信封 → ServerResponse.result（RpcResult 形态）。
-		* 契约以当前安装版 dsh-host-apiproxy 为准（api/sessions.d.ts「Method signatures are the
-		* source of truth」）：`create({cwd}) → {sessionId}`；信封 = `{type:'client-request', rpcId,
-		* method, payload}` → `{result: {ok:true, value:{sessionId}} | {ok:false, error}}`。
-		* @author ddj 2026年09月23号
-		* @param cwd 新会话工作区目录
-		* @returns 新会话 id（失败空串）
-		*/
-		async function apiSessionCreate(cwd) {
-			const json = await (await fetch(appUrl(SESSION_CREATE_PATH), {
-				method: "POST",
-				headers: { "content-type": "application/json" },
-				body: JSON.stringify({
-					type: "client-request",
-					rpcId: mintRpcId(),
-					method: "session/create",
-					payload: cwd ? { cwd } : {}
-				})
-			})).json().catch(() => null);
-			const id = json?.result?.value?.sessionId;
-			return json?.result?.ok === true && typeof id === "string" ? id : "";
-		}
-		/** @private @author ddj 2026年10月29号 @param sessionId Fixed target. @param text Task body. @returns HTTP receipt evidence; errors after request entry are never safe rejection. */
-		async function httpTaskResult(sessionId, text) {
-			try {
-				const payload = {
-					sessionId,
-					mode: "queue",
-					content: [{
-						type: "text",
-						text
-					}]
-				};
-				return taskReceipt((await (await fetch(appUrl(SESSION_PROMPT_PATH), {
-					method: "POST",
-					headers: { "content-type": "application/json" },
-					body: JSON.stringify({
-						type: "client-request",
-						rpcId: mintRpcId(),
-						method: "session/prompt",
-						payload: slotArg(payload)
-					})
-				})).json().catch(() => null))?.result);
-			} catch {
-				return {
-					status: "unknown",
-					legacyOk: false
-				};
-			}
-		}
-		/**
-		* 新建独立会话承载旁路任务（02-deep-session-prompt：深度分析不污染当前对话）。
-		* 优先公开 sessions.create；旧 Host 按能力选择 remote 或 wire，调用后不换通道重试。
-		* 受理状态不明时返回 ok:false，不重复创建会话。
-		* @author ddj 2026年10月28号
-		* @author ddj 2026年09月23号
-		* @param ctx 客户端服务上下文（remote.session + sessions，仅回落用）
-		* @param cwd 新会话工作区目录（与当前会话同工作区）
-		* @returns 新会话结果（含 id）
-		*/
-		async function newDraftSession(ctx, cwd) {
-			try {
-				const sessions = ctx.get("sessions");
-				if (typeof sessions?.create === "function") {
-					const created = await sessions.create(cwd ? { cwd } : void 0);
-					const id = typeof created === "string" && created ? created : typeof created?.id === "string" ? created.id : typeof created?.sessionId === "string" ? created.sessionId : typeof created?.session?.id === "string" ? created.session.id : "";
-					if (id) return {
-						ok: true,
-						id
-					};
-				}
-				if (typeof sessions?.create === "function") return { ok: false };
-			} catch {
-				return { ok: false };
-			}
-			try {
-				const remote = ctx.get("remote.session");
-				if (typeof remote?.create === "function") {
-					const payload = cwd ? { cwd } : {};
-					const receipt = rpcOk(await remote.create(slotArg(payload)));
-					const created = receipt.value;
-					if (receipt.ok && typeof created?.sessionId === "string") return {
-						ok: true,
-						id: created.sessionId
-					};
-					return { ok: false };
-				}
-			} catch {
-				return { ok: false };
-			}
-			try {
-				const id = await apiSessionCreate(cwd);
-				if (id) return {
-					ok: true,
-					id
-				};
-			} catch {}
-			return { ok: false };
-		}
-		/**
-		* 解析会话输入门面；缺失时返回 undefined（动作侧守卫降级）。
-		* @author ddj 2026年08月25号
-		* @param ctx 客户端服务上下文
-		* @param sessionId 会话 id
-		* @returns SessionInput 或 undefined
-		*/
-		function inputFor(ctx, sessionId) {
-			if (!sessionId) return void 0;
-			try {
-				const sessions = ctx.get("sessions");
-				const conversation = ctx.get("conversation");
-				const actx = typeof sessions?.binding === "function" ? sessions.binding(sessionId)?.ctx : sessions?.scope?.(sessionId);
-				const shell = actx && conversation?.input?.for?.(actx);
-				return shell && typeof shell.insertReference === "function" ? shell : void 0;
-			} catch {
-				return;
-			}
-		}
-		/** 取当前草稿快照（长度/版本/chip 列表）；无输入门面时返回 null。
-		* @author ddj 2026年08月25号 / 2026年09月11号 */
-		function draftCursor(input) {
-			try {
-				const s = input?.state?.getSnapshot?.();
-				if (!s) return null;
-				return {
-					draft: String(s.draft ?? ""),
-					draftRev: Number(s.draftRev ?? 0),
-					occurrences: Array.isArray(s.occurrences) ? s.occurrences : void 0
-				};
-			} catch {
-				return null;
-			}
-		}
-		/** 从 sessions 列表快照读会话工作区目录（与 index.ts 既有读取方式一致）。
-		* @author ddj 2026年08月25号 */
-		function cwdOf(ctx, sessionId) {
-			if (!sessionId) return void 0;
-			try {
-				return ctx.get("sessions")?.list?.getSnapshot?.()?.byId?.[sessionId]?.cwd;
-			} catch {
-				return;
-			}
-		}
-		/** 输入门面插入引用（拦截异常视作未应用，走降级）。
-		* @author ddj 2026年08月25号 */
-		function safeInsert(input, reference, span) {
-			try {
-				return input.insertReference(reference, span) === true;
-			} catch {
-				return false;
-			}
-		}
-		/** 输入门面插入纯文本（官方 plain-text 通道；不存在或异常视作未应用）。
-		* @author ddj 2026年09月11号 */
-		function safeInsertText(input, text, span) {
-			if (typeof input.insertText !== "function") return false;
-			try {
-				return input.insertText(text, span) === true;
-			} catch {
-				return false;
-			}
-		}
-		/**
-		* 读输入框当前光标（detect 坐标）；门面缺失/异常返回 null（由调用方回落到文档末尾）。
-		* @author ddj 2026年09月11号
-		* @param input 输入门面
-		* @returns caretSpan 结果或 null
-		*/
-		function caretOf(input) {
-			if (typeof input.caretSpan !== "function") return null;
-			try {
-				return input.caretSpan() ?? null;
-			} catch {
-				return null;
-			}
-		}
-		/**
-		* 创建「添加到对话」动作集（apply 阶段构建一次，随 props 传给 EditorView）。
-		*
-		* 插入位置 = 输入框**当前光标**（`caretSpan()`，detect 坐标；无光标提示时回落文档末尾），
-		* 不再固定追加到最末尾。坐标一律用 **detect 投影**（见 detectEndOf 的缺陷说明）；
-		* 两条写入通道都失败时**不写任何内容**并返回 'failed' —— 旧实现在此处退回 `setDraft`
-		* 整篇重建，会把既有 chip 全部销毁（连续添加多个引用即触发）。
-		* @author ddj 2026年08月25号 / 2026年09月11号
-		* @param ctx 客户端服务上下文（sessions + conversation）
-		* @returns 动作集
-		*/
-		function createAddToConversation(ctx) {
-			const appendReference = async (sessionId, path, range, appearance) => {
-				const input = inputFor(ctx, sessionId);
-				if (!input) return "unavailable";
-				const cur = draftCursor(input);
-				if (!cur) return "unavailable";
-				const { reference, mention } = buildFileRef(path, cwdOf(ctx, sessionId), range, appearance);
-				const at = insertOffsetOf(caretOf(input), detectEndOf(cur));
-				const span = {
-					start: at,
-					end: at,
-					draftRev: cur.draftRev
-				};
-				if (safeInsert(input, reference, span)) return "ok";
-				const pad = paddingAt(cur, at);
-				if (safeInsertText(input, (pad.lead ? " " : "") + mention + (pad.tail ? " " : ""), span)) return "busy";
-				return "failed";
-			};
-			/**
-			* 追加纯文本（AI 深度分析任务注入）：走官方 plain-text 通道插到当前光标。
-			* 失败语义与 appendReference 一致：宁可不写也不整篇重建（保护既有 chip）。
-			* @author ddj 2026年09月23号
-			* @param sessionId 会话 id
-			* @param text 待注入文本
-			* @returns 注入结果（ok / unavailable / failed）
-			*/
-			const appendText = async (sessionId, text) => {
-				const input = inputFor(ctx, sessionId);
-				if (!input) return "unavailable";
-				const cur = draftCursor(input);
-				if (!cur) return "unavailable";
-				const at = insertOffsetOf(caretOf(input), detectEndOf(cur));
-				return safeInsertText(input, text, {
-					start: at,
-					end: at,
-					draftRev: cur.draftRev
-				}) ? "ok" : "failed";
-			};
-			/**
-			* 新建独立会话（02-deep-session-prompt：旁路任务不污染当前对话）。
-			* 闭包持有真服务 ctx（面板 SidebarCtx 无 .get，会话操作必须经此门面）；
-			* 新版仅返回已登记身份，视图选择由宿主负责；旧版保留可用的 open/select。
-			* @author ddj 2026年10月28号
-			* @author ddj 2026年09月23号
-			* @param cwd 新会话工作区目录（与当前会话同工作区）
-			* @returns 新会话结果（失败供降级）
-			*/
-			const startDraftSession = async (cwd) => {
-				const result = await newDraftSession(ctx, cwd);
-				if (typeof ctx.get("sessions")?.retain === "function") return result;
-				if (result.ok && result.id) try {
-					const sessions = ctx.get("sessions");
-					sessions?.materializeScope?.(result.id);
-					const title = "AI 深度分析 · " + (String(cwd ?? "").split(/[\\/]/).pop() || "SVN 变更");
-					sessions?.manager?.rename?.(result.id, title);
-					sessions?.manager?.select?.(result.id);
-					sessions?.open?.(result.id);
-				} catch {}
-				return result;
-			};
-			/**
-			* 发送任务给目标会话 agent（点击即发送方案：任务落地会话即非 blank，列表可见）。
-			* 新版持有目标 Controller 到 prompt 结束；旧版按能力选择唯一通道，不跨通道重发。
-			* @author ddj 2026年10月29号
-			* @param sessionId 目标会话 id
-			* @param text 任务文本
-			* @returns 同一次调用的历史boolean语义，不能作为受理事实
-			*/
-			const sendTask = async (sessionId, text) => (await sendTaskResult(sessionId, text)).legacyOk;
-			/** @private @author ddj 2026年10月29号 @param sessionId Fixed target. @param text Task body. @returns Detailed evidence from exactly one selected transport. */
-			async function sendTaskResult(sessionId, text) {
-				if (!sessionId) return {
-					status: "unavailable",
-					legacyOk: false
-				};
-				try {
-					const sessions = ctx.get("sessions");
-					if (typeof sessions?.retain === "function") return await sendOwned(ctx, sessions, sessionId, text);
-					return await sendLegacy(ctx, sessionId, text);
-				} catch {
-					return {
-						status: "unavailable",
-						legacyOk: false
-					};
-				}
-			}
-			return {
-				appendReference,
-				appendText,
-				startDraftSession,
-				sendTask,
-				sendTaskResult
-			};
-		}
 		/**
 		* 由选区文本推导搜索种子。
 		* @author ddj 2026年09月18号
@@ -385450,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 的状态通道；失败不再静默）。 */
@@ -385469,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();
 		}
 		/**
@@ -385728,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) {
@@ -388811,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: "关闭",
@@ -393737,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([]);
@@ -394041,10 +394817,11 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			const layoutRef = react$1.default.useRef(layout);
 			layoutRef.current = layout;
 			if (!diffRendererRef.current) diffRendererRef.current = createDiffRenderer((sid, t) => dbg(sid, t));
+			const coveredPaths = react$1.default.useMemo(() => coveredPathKeys(review.page), [review.page]);
 			const currentRecords = react$1.default.useMemo(() => {
 				const list = [];
 				for (const rec of Object.values(records)) {
-					if (rec.archived === true || officialPath(rec.path, review.page)) continue;
+					if (rec.archived === true || coveredPaths.has(diffPathKey(rec.path))) continue;
 					if (sameFile(rec.path, active)) list.push(rec);
 				}
 				return list;
@@ -394052,7 +394829,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				records,
 				active,
 				cwd,
-				review.page
+				coveredPaths
 			]);
 			const reviewOpsRef = react$1.default.useRef(/* @__PURE__ */ new Map());
 			const settledRef = react$1.default.useRef(/* @__PURE__ */ new Set());
@@ -395047,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();
@@ -395055,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号
@@ -395174,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);
@@ -395234,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);
@@ -397043,11 +397837,13 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 						dbg(sessionId, `[DEBUG diffAction] stage=reply trace=${traceId} method=decideBatch items=${items.length} rpcMs=${(performance.now() - start).toFixed(1)} ok=${res?.ok === true}`);
 					} catch (e) {}
 					if (!res || !res.ok || !Array.isArray(res.results)) {
-						setError(res?.error ? String(res.error) : "批量处理失败");
+						const failure = res?.error ? String(res.error) : "批量处理失败";
+						setError(failure);
 						return {
 							ok: 0,
 							fail: items.length,
-							stale: 0
+							stale: 0,
+							error: failure
 						};
 					}
 					let ok = 0;
@@ -397066,11 +397862,13 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 						stale
 					};
 				}).catch((e) => {
-					setError("批量处理异常:" + String(e));
+					const failure = "批量处理异常:" + String(e);
+					setError(failure);
 					return {
 						ok: 0,
 						fail: items.length,
-						stale: 0
+						stale: 0,
+						error: failure
 					};
 				});
 			};
@@ -397239,6 +398037,27 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 					if (lifetime?.live) setReviewBatchBusy(false);
 				}
 			}
+			/**
+			* 批量失败提示：Host 原文优先，只有拿不到原因时才按计数兜底。
+			* @author ddj 2026年11月3号
+			* @param result actMany 的结果
+			* @returns 提示文案；没有失败返回 null
+			*/
+			const batchError = (result) => {
+				if (!result.error) return batchFailText(result);
+				if (isSessionMissingError(result.error)) return "这个会话没在当前端激活，Keep/Undo 没有执行（记录未改动）；在会话里发一条消息激活后重试";
+				return result.error;
+			};
+			/**
+			* 批量结果没有 Host 原文时的计数兜底文案。
+			* @author ddj 2026年11月3号
+			* @param result actMany 的结果
+			* @returns 提示文案；没有失败返回 null
+			*/
+			const batchFailText = (result) => {
+				if (!result.fail) return null;
+				return result.stale ? `${result.fail} 处未处理（其中 ${result.stale} 处已不在文件中，只更新了记录），可刷新后重试` : `${result.fail} 处未处理，可刷新后重试`;
+			};
 			const acceptFile = () => {
 				if (missingNow && !officialDetail) return decideMissing(false);
 				if (officialDetail) return decideOfficial(false);
@@ -397252,8 +398071,9 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 						paths: active ? [active] : void 0,
 						kind: "structure"
 					});
-					setStatus(decideStatus("已采纳 ", result));
-					if (result.fail) setError(result.fail + " 处差异处理失败（可能已被后续修改影响），可刷新后重试");
+					setStatus(result.ok ? `${SIDECAR_KEEP_DONE}（${result.ok} 处）` : decideStatus("已采纳 ", result));
+					const message = batchError(result);
+					if (message) setError(message);
 				}).catch(() => {
 					batchBusyRef.current = false;
 				});
@@ -397272,7 +398092,8 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 						kind: "structure"
 					});
 					setStatus(decideStatus("已不采纳 ", result));
-					if (result.fail) setError(result.fail + " 处差异处理失败（可能已被后续修改影响），可刷新后重试");
+					const message = batchError(result);
+					if (message) setError(message);
 				}).catch(() => {
 					batchBusyRef.current = false;
 				});
@@ -397280,7 +398101,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			const allPending = react$1.default.useMemo(() => {
 				const out = [];
 				for (const rec of Object.values(records)) {
-					if (rec.superseded === true || officialPath(rec.path, review.page)) continue;
+					if (rec.superseded === true || coveredPaths.has(diffPathKey(rec.path))) continue;
 					const perHunk = Array.isArray(rec.decisions?.perHunk) ? rec.decisions.perHunk : [];
 					const hunks = Array.isArray(rec.hunks) ? rec.hunks : [];
 					for (let i = 0; i < hunks.length; i++) if ((perHunk.length ? perHunk[i] : rec.decisions.call) === "pending" && !noopHunk(rec, hunks[i])) out.push({
@@ -397369,7 +398190,8 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 						kind: "structure"
 					});
 					setStatus(decideStatus(reject ? "已不采纳 " : "已采纳 ", result) + `；删除文件 ${handled.size} 个`);
-					if (result.fail) setError(result.fail + " 处差异处理失败，可刷新后重试");
+					const message = batchError(result);
+					if (message) setError(message);
 				} catch (cause) {
 					if (lifetime?.live) setError(String(cause));
 				} finally {
@@ -397414,6 +398236,88 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				setStatus(`官方待审列表正在载入，载入完成后请再次点击${action}`);
 				return false;
 			}
+			/** @private @author ddj 2026年11月03号 @description 批量通道的一次性完整快照（分页口径的 pending 只是页内计数）。 @returns 完整待审页 */
+			async function batchSnapshot() {
+				const res = await rpc("edrv.review.list", {
+					sessionId,
+					all: true
+				});
+				if (!res.ok) throw new Error(res.error);
+				return res.page;
+			}
+			/** @private @author ddj 2026年11月03号 @param token 起批时的会话寿命 @returns 逐条 Undo 的精确部分完成（冲突处停止） */
+			function undoAllBatch(token) {
+				return runReviewBatch({
+					snapshot: batchSnapshot,
+					detail: async (id) => {
+						const res = await rpc("edrv.review.detail", {
+							sessionId,
+							id
+						});
+						if (!res.ok) throw new Error(res.error);
+						return res.detail;
+					},
+					decide: (detail, undo, operationId) => rpc("edrv.review.decide", {
+						sessionId,
+						id: detail.item.id,
+						seq: detail.item.seq,
+						revision: detail.item.revision,
+						operationId,
+						scope: "file",
+						decision: undo ? "rejected" : "accepted"
+					}),
+					guard: () => guardReviewAll(true, token),
+					operation: batchOperation
+				}, true);
+			}
+			/** @private @author ddj 2026年11月03号 @param token 起批时的会话寿命 @returns 一次 RPC 的批量 Keep 结果（跳过项不算失败） */
+			function keepAllBatch(token) {
+				return runKeepAll({
+					snapshot: batchSnapshot,
+					keepAll: (items, batchId) => rpc("edrv.review.keepAll", {
+						sessionId,
+						batchId,
+						items
+					}),
+					guard: () => guardReviewAll(false, token)
+				});
+			}
+			/**
+			* @private
+			* @author ddj 2026年11月03号
+			* @description: 批量结果落界面：刷新列表、状态栏计数；Keep 的跳过只做提示不当错误，
+			* Undo 保持「遇冲突停止」口径。
+			* @param result 批量结果
+			* @param reject 本次是 Undo 还是 Keep
+			* @param undoPath 起批时的活动文件
+			* @param undoModel 起批时的编辑器模型
+			* @param undoVersion 起批时的模型版本
+			* @returns 官方段是否完全成功（legacy 通道是否继续）
+			*/
+			function finishReviewAll(result, reject, undoPath, undoModel, undoVersion) {
+				refreshReview(sessionId);
+				if (result.paths.length) emitRefresh({
+					scope,
+					paths: result.paths,
+					kind: "structure"
+				});
+				if (reject) {
+					if (result.paths.some((path) => sameFile(path, undoPath)) && activeRef.current === undoPath && !dirtyRef.current[undoPath] && !savingRef.current.has(undoPath) && undoModel?.getVersionId?.() === undoVersion) reloadFile(true);
+					setStatus(`Undo All：官方记录已完成 ${result.completed} / ${result.total}`);
+					if (result.error) setError(`批量已停止，已完成 ${result.completed} 项，其余未处理。${result.error}`);
+					return !result.error;
+				}
+				const skipped = result.skipped ?? [];
+				setStatus(`Keep All：已保留 ${result.completed} / ${result.total}` + (skipped.length ? `，跳过 ${skipped.length} 条` : ""));
+				if (result.error) setError(`Keep All 未全部完成：${result.error}`);
+				if (skipped.length) toastDom(skippedTip(skipped));
+				return !result.error;
+			}
+			/** @private @author ddj 2026年11月03号 @param skipped 被跳过的条目 @returns 最多 3 条、余量汇总的提示文案 */
+			function skippedTip(skipped) {
+				const head = skipped.slice(0, 3).map((item) => `${item.display}：${item.reason}`).join("；");
+				return skipped.length > 3 ? `${head}；等 ${skipped.length} 条` : head;
+			}
 			/** @private @author ddj 2026年10月27号 @param reject Undo or Keep all workspace pending records, including previous rounds. @returns Explicit partial results; legacy proceeds only when official stage fully succeeds. */
 			async function actReviewAll(reject) {
 				if (batchBusyRef.current) return;
@@ -397427,48 +398331,9 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				setReviewBatchBusy(true);
 				setStatus(reject ? "正在检查并 Undo 全部待审记录…" : "正在 Keep 全部待审记录…");
 				try {
-					const result = await runReviewBatch({
-						snapshot: async () => {
-							const res = await rpc("edrv.review.list", {
-								sessionId,
-								all: true
-							});
-							if (!res.ok) throw new Error(res.error);
-							return res.page;
-						},
-						detail: async (id) => {
-							const res = await rpc("edrv.review.detail", {
-								sessionId,
-								id
-							});
-							if (!res.ok) throw new Error(res.error);
-							return res.detail;
-						},
-						decide: (detail, undo, operationId) => rpc("edrv.review.decide", {
-							sessionId,
-							id: detail.item.id,
-							seq: detail.item.seq,
-							revision: detail.item.revision,
-							operationId,
-							scope: "file",
-							decision: undo ? "rejected" : "accepted"
-						}),
-						guard: () => guardReviewAll(reject, token),
-						operation: batchOperation
-					}, reject);
+					const result = reject ? await undoAllBatch(token) : await keepAllBatch(token);
 					if (!token?.live) return;
-					refreshReview(sessionId);
-					if (reject && result.paths.some((path) => sameFile(path, undoPath)) && activeRef.current === undoPath && !dirtyRef.current[undoPath] && !savingRef.current.has(undoPath) && undoModel?.getVersionId?.() === undoVersion) reloadFile(true);
-					if (result.paths.length) emitRefresh({
-						scope,
-						paths: result.paths,
-						kind: "structure"
-					});
-					setStatus(`${reject ? "Undo All" : "Keep All"}：官方记录已完成 ${result.completed} / ${result.total}`);
-					if (result.error) {
-						setError(`批量已停止，已完成 ${result.completed} 项，其余未处理。${result.error}`);
-						return;
-					}
+					if (!finishReviewAll(result, reject, undoPath, undoModel, undoVersion)) return;
 					guardReviewAll(reject, token);
 					if (allPending.length) {
 						batchBusyRef.current = false;
@@ -397926,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"),
@@ -397972,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,
@@ -398354,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));
@@ -399133,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,
@@ -403189,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 = {
@@ -403456,577 +404507,6 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			}
 		}
 		//#endregion
-		//#region src/shared/externalOpen.ts
-		/**
-		* dsh-vscode-mode shared — 外部深链 URL 契约（Windows launcher / Unity 包 / client 共用）。
-		* 形态：?<FLAG>=1&<PATHS_KEY>=<enc1>[,<enc2>…] [&<LINE_KEY>=N] [&<COLUMN_KEY>=M]
-		* 每个路径独立 percent-encode（encodeURIComponent / Uri.EscapeDataString）后以 `,` 连接：
-		* 编码结果不含裸逗号（Windows 路径本身不允许逗号，编码兜底其余字符），URLSearchParams
-		* 取值做一次标准解码即得 `enc1,enc2`，按 `,` split 即路径，无需二次 decode。
-		* Purity rule: no node/react imports（URLSearchParams 为标准全局）。
-		* 作者 ddj 2026-09-07
-		*/
-		/** 深链开关参数名（值恒为 '1'）。 */
-		const EDRV_OPEN_FLAG = "edrvOpen";
-		/** 路径列表参数名（逗号分隔的已编码路径）。 */
-		const EDRV_PATHS_KEY = "edrvPaths";
-		/** 目标行参数名（1-based，可选，作用于首个路径）。 */
-		const EDRV_LINE_KEY = "edrvLine";
-		/** 目标列参数名（1-based，可选，作用于首个路径）。 */
-		const EDRV_COLUMN_KEY = "edrvColumn";
-		/** 深链参数键全集（URL 清理用）。 */
-		const EDRV_PARAM_KEYS = [
-			EDRV_OPEN_FLAG,
-			EDRV_PATHS_KEY,
-			EDRV_LINE_KEY,
-			EDRV_COLUMN_KEY
-		];
-		/**
-		* 解析深链查询串：非深链/路径为空 → null；行列仅接受正整数，非法忽略。
-		* @author ddj 2026年09月07号
-		* @param search location.search（含或不含前导 ? 均可）
-		* @returns 深链参数或 null
-		*/
-		function parseOpenParams(search) {
-			const params = new URLSearchParams(search ?? "");
-			if (params.get("edrvOpen") !== "1") return null;
-			const paths = (params.get("edrvPaths") ?? "").split(",").map((item) => item.trim()).filter(Boolean);
-			if (!paths.length) return null;
-			return {
-				paths,
-				line: positiveIntOf(params.get(EDRV_LINE_KEY)),
-				column: positiveIntOf(params.get(EDRV_COLUMN_KEY))
-			};
-		}
-		/**
-		* 正整数解析（非法/非正 → undefined）。
-		* @author ddj 2026年09月07号
-		* @param raw 参数原文（可空）
-		* @returns 正整数或 undefined
-		*/
-		function positiveIntOf(raw) {
-			const value = Number(raw);
-			return Number.isInteger(value) && value > 0 ? value : void 0;
-		}
-		//#endregion
-		//#region src/client/chooseDialog.ts
-		/**
-		* dsh-vscode-mode client — 工作区选择弹窗（深链打开规则 1）。
-		* 复用与「添加 MCP」一致的 vsm-mcp-modal / vsm-mcp-dialog 模态（页面居中卡片 + 遮罩 + 主题
-		* token），React portal 挂 body；Esc / 遮罩点击 / 取消 → null（中止流程不改任何状态）。
-		* 作者 ddj 2026-09-07
-		*/
-		/** 选择弹窗（vsm-mcp-modal 遮罩 + vsm-mcp-dialog 卡片，Esc/遮罩点击取消）。 */
-		function ChoiceModal({ title, folder, done }) {
-			react$1.default.useEffect(() => {
-				const onKey = (event) => {
-					if (event.key === "Escape") done(null);
-				};
-				window.addEventListener("keydown", onKey);
-				return () => window.removeEventListener("keydown", onKey);
-			}, []);
-			return react$1.default.createElement("div", {
-				className: "vsm-mcp-modal",
-				onMouseDown: (event) => {
-					if (event.target === event.currentTarget) done(null);
-				}
-			}, react$1.default.createElement("div", { className: "vsm-mcp-dialog" }, react$1.default.createElement("h3", null, "在 DSH 中打开"), react$1.default.createElement("label", null, "文件夹 " + folder + " 位于已注册的工作区「" + title + "」内，选择打开方式："), react$1.default.createElement("div", { className: "vsm-mcp-dialog-actions" }, react$1.default.createElement("button", { onClick: () => done(null) }, "取消"), react$1.default.createElement("button", { onClick: () => done("create") }, "新建工作区"), react$1.default.createElement("button", {
-				className: "vsm-primary",
-				onClick: () => done("recent")
-			}, "使用最近的工作区"))));
-		}
-		/**
-		* 弹出工作区选择弹窗（深链打开规则 1）。
-		* @author ddj 2026年09月07号
-		* @param title 匹配到的工作区标题
-		* @param folder 文件夹路径
-		* @returns 用户选择；null = 取消/中止
-		*/
-		function chooseWorkspace(title, folder) {
-			return new Promise((resolve) => {
-				const host = document.createElement("div");
-				document.body.appendChild(host);
-				const root = (0, react_dom_client.createRoot)(host);
-				const done = (choice) => {
-					root.unmount();
-					host.remove();
-					resolve(choice);
-				};
-				root.render(react$1.default.createElement(ChoiceModal, {
-					title,
-					folder,
-					done
-				}));
-			});
-		}
-		//#endregion
-		//#region src/client/openFlow.ts
-		/**
-		* dsh-vscode-mode client — 深链打开规则引擎（资源管理器右键 / Unity 外部编辑器落地）。
-		* 规则：文件夹 ⊂ 某已注册工作区 → 页面内弹窗二选一（使用最近的工作区 / 新建工作区）；
-		* 文件夹不在任何工作区 → 直达最近对话所在工作区新增；文件 → 最近对话 + 编辑器展开
-		* （无任何会话 → 以文件父目录注册工作区引导创建）。首路径驱动规则，其余路径：文件进
-		* 编辑器、文件夹补引用。纯函数可单测；编排依赖经 OpenDeps 注入（mock 可测）。
-		* 作者 ddj 2026-09-07
-		*/
-		/** 等列表/输入就绪的节奏。 */
-		const READY_TIMEOUT_MS = 15e3;
-		const READY_TICK_MS = 300;
-		const REF_RETRY_MAX = 20;
-		const REF_RETRY_MS = 300;
-		/**
-		* 路径规范化：`\→/`、小写、去尾分隔符（Windows 大小写不敏感前缀匹配用）。
-		* @author ddj 2026年09月07号
-		*/
-		function normPath(p) {
-			return String(p ?? "").replace(/\\/g, "/").replace(/\/+$/, "").toLowerCase();
-		}
-		/**
-		* 目录包含判定：child === root 或 child 位于 root 之下。
-		* @author ddj 2026年09月07号
-		*/
-		function containsPath(root, child) {
-			const r = normPath(root);
-			const c = normPath(child);
-			return c === r || c.startsWith(r + "/");
-		}
-		/**
-		* 父目录（文件引导创建工作区用；根路径回退自身）。
-		* @author ddj 2026年09月07号
-		*/
-		function dirnameOf(p) {
-			const norm = String(p ?? "").replace(/[\\/]+$/, "");
-			const cut = Math.max(norm.lastIndexOf("/"), norm.lastIndexOf("\\"));
-			return cut > 0 ? norm.slice(0, cut) : norm;
-		}
-		/**
-		* 最近一次对话：排除子代理行，updatedAt 最新优先。
-		* @author ddj 2026年09月07号
-		*/
-		function recentSession(byId, ids) {
-			return (ids ?? Object.keys(byId)).map((id) => byId[id]).filter((row) => row && row.origin !== "subagent").sort((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0))[0];
-		}
-		/**
-		* 文件夹命中的已注册工作区（前缀包含），updatedAt 新者优先。
-		* @author ddj 2026年09月07号
-		*/
-		function matchWorkspaces(items, folder) {
-			return items.filter((ws) => containsPath(ws.path, folder));
-		}
-		/**
-		* 规则分派：目录+命中工作区 → choose；目录未命中 → folderNew（以该文件夹为根注册新工作区，
-		* 用户确认：一律取右键的文件夹本身）；文件有会话 → fileRecent；文件无会话 → bootstrap；
-		* 路径缺失 → abort。
-		* @author ddj 2026年09月08号
-		*/
-		function pickRule(kind, matched, hasSession) {
-			if (kind === "missing") return "abort";
-			if (kind === "directory") return matched ? "choose" : "folderNew";
-			return hasSession ? "fileRecent" : "bootstrap";
-		}
-		/**
-		* 深链打开编排入口：等列表就绪 → 判型 → 规则分派 → 编排 create/open/引用/编辑器。
-		* @author ddj 2026年09月07号
-		* @param ctx 客户端根上下文（sessions/workspaces 服务）
-		* @param params 深链参数（首路径驱动规则）
-		* @param overrides 依赖覆盖（测试注入）
-		*/
-		async function openDeepLink(ctx, params, overrides = {}) {
-			const deps = realDeps(ctx, overrides);
-			if (!await waitListsReady(deps)) {
-				deps.notify("DSH 会话列表未就绪，请稍后重试");
-				return false;
-			}
-			const primary = params.paths[0];
-			const kind = await deps.stat(primary).catch(() => "missing");
-			const sess = deps.sessions();
-			const rule = pickRule(kind, matchWorkspaces(deps.workspaces().items, primary).length > 0, Boolean(recentSession(sess.byId, sess.ids)));
-			try {
-				if (rule === "abort") {
-					deps.notify("路径不存在：" + primary);
-					return false;
-				}
-				if (rule === "choose") await runChoose(deps, primary, params);
-				else if (rule === "folderNew") await runFolderNew(deps, primary, params);
-				else if (rule === "fileRecent") await runFileRecent(deps, primary, params);
-				else await runFileBootstrap(deps, primary, params);
-				return true;
-			} catch (error) {
-				deps.notify("打开失败：" + String(error?.message ?? error));
-				return false;
-			}
-		}
-		/** 等待会话与工作区列表就绪（上限 15s；超时按当前态判定）。 */
-		async function waitListsReady(deps) {
-			for (let waited = 0; waited < READY_TIMEOUT_MS; waited += READY_TICK_MS) {
-				if (deps.sessions().ready && deps.workspaces().ready) return true;
-				await sleep(deps, READY_TICK_MS);
-			}
-			return deps.sessions().ready && deps.workspaces().ready;
-		}
-		/** 规则 1：命中工作区 → 弹窗分派（取消即中止）。 */
-		async function runChoose(deps, folder, params) {
-			const best = bestMatch(deps, matchWorkspaces(deps.workspaces().items, folder));
-			const choice = await deps.choose(best?.title ?? "工作区", folder);
-			if (choice === null) throw new Error("用户取消打开");
-			if (choice === "create") return runFolderNew(deps, folder, params);
-			const sessionId = await spawnInWorkspace(deps, (best ?? deps.workspaces().items[0]).workspaceId, void 0);
-			await settleRef(deps, sessionId, folder, "folder");
-			await openChecked(deps, sessionId, null);
-			await openRest(deps, sessionId, params, 1);
-		}
-		/** 规则 3a：文件 → 所属工作区优先（有会话打开其最近会话；无会话新建 + 文件引用）；无匹配 → 最近对话。 */
-		async function runFileRecent(deps, file, params) {
-			const ws = pickFileWorkspace(deps, file);
-			if (ws) {
-				const anchor = recentSessionIn(deps, ws);
-				if (anchor) {
-					deps.openSession(anchor.id);
-					await openChecked(deps, anchor.id, file, params.line, params.column);
-					await openRest(deps, anchor.id, params, 1);
-					return;
-				}
-				const sessionId = await spawnInWorkspace(deps, ws.workspaceId, void 0);
-				await settleRef(deps, sessionId, file, "file");
-				await openChecked(deps, sessionId, file, params.line, params.column);
-				await openRest(deps, sessionId, params, 1);
-				return;
-			}
-			const anchor = recentSession(deps.sessions().byId, deps.sessions().ids);
-			if (!anchor) return runFileBootstrap(deps, file, params);
-			deps.openSession(anchor.id);
-			await openChecked(deps, anchor.id, file, params.line, params.column);
-			await openRest(deps, anchor.id, params, 1);
-		}
-		/**
-		* 文件所属工作区：前缀命中的工作区里，优先取有会话且最近活跃的；都无会话取路径最具体的。
-		* @author ddj 2026年09月08号
-		*/
-		function pickFileWorkspace(deps, file) {
-			const matches = matchWorkspaces(deps.workspaces().items, file);
-			if (!matches.length) return void 0;
-			const withSessions = matches.filter((ws) => (ws.sessionIds ?? []).some((id) => Boolean(deps.sessions().byId[id])));
-			if (!withSessions.length) return [...matches].sort((a, b) => normPath(b.path).length - normPath(a.path).length)[0];
-			return withSessions.sort((a, b) => latestSessionAt(deps, b) - latestSessionAt(deps, a))[0];
-		}
-		/** 工作区内会话的最近活跃时间（无成员 → 0）。 */
-		function latestSessionAt(deps, ws) {
-			const byId = deps.sessions().byId;
-			return (ws.sessionIds ?? []).reduce((max, id) => Math.max(max, byId[id]?.updatedAt ?? 0), 0);
-		}
-		/** 工作区内最近一次会话（排除子代理与不在列表中的陈旧行）。 */
-		function recentSessionIn(deps, ws) {
-			const byId = deps.sessions().byId;
-			return (ws.sessionIds ?? []).map((id) => byId[id]).filter((row) => row && row.origin !== "subagent").sort((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0))[0];
-		}
-		/** 规则 3b：文件 + 无任何会话 → 父目录注册工作区 + 新对话 + 文件引用 + 编辑器打开。 */
-		async function runFileBootstrap(deps, file, params) {
-			const sessionId = await spawnInWorkspace(deps, (await deps.createWorkspace(dirnameOf(file))).workspaceId, void 0);
-			await settleRef(deps, sessionId, file, "file");
-			await openChecked(deps, sessionId, file, params.line, params.column);
-			await openRest(deps, sessionId, params, 1);
-		}
-		/** 规则 1.2：以文件夹注册新工作区 + 新对话 + 文件夹引用 + 编辑页。 */
-		async function runFolderNew(deps, folder, params) {
-			const sessionId = await spawnInWorkspace(deps, (await deps.createWorkspace(folder)).workspaceId, void 0);
-			await settleRef(deps, sessionId, folder, "folder");
-			await openChecked(deps, sessionId, null);
-			await openRest(deps, sessionId, params, 1);
-		}
-		/** 在指定工作区（或回退 cwd）新建对话并置为当前；返回新会话 id。 */
-		async function spawnInWorkspace(deps, workspaceId, fallbackCwd) {
-			const sessionId = await deps.createSession(workspaceId ? { workspaceId } : fallbackCwd ? { cwd: fallbackCwd } : {});
-			deps.openSession(sessionId);
-			return sessionId;
-		}
-		/** 命中工作区集中「最近」的一个（其成员会话 updatedAt 最新者优先）。 */
-		function bestMatch(deps, matches) {
-			const byId = deps.sessions().byId;
-			const score = (ws) => {
-				const sessionLatest = (ws.sessionIds ?? []).reduce((max, id) => Math.max(max, byId[id]?.updatedAt ?? 0), 0);
-				return Math.max(sessionLatest, Date.parse(ws.updatedAt ?? "") || 0);
-			};
-			return [...matches].sort((a, b) => score(b) - score(a))[0];
-		}
-		/** 引用插入轮询：输入门面就绪前每 300ms 重试（appendReference 忙态已降级视为成功）。 */
-		async function settleRef(deps, sessionId, path, appearance) {
-			for (let attempt = 0; attempt < REF_RETRY_MAX; attempt++) {
-				if (await deps.reference(sessionId, path, appearance)) return;
-				await sleep(deps, REF_RETRY_MS);
-			}
-			throw new Error("引用插入未完成");
-		}
-		/** 其余路径：文件进编辑器（步进），文件夹补文件夹引用。 */
-		async function openRest(deps, sessionId, params, from) {
-			const rest = params.paths.slice(from);
-			for (const path of rest) {
-				const kind = await deps.stat(path).catch(() => "missing");
-				if (kind === "file") await openChecked(deps, sessionId ?? void 0, path);
-				else if (kind === "directory" && sessionId) await settleRef(deps, sessionId, path, "folder");
-				else throw new Error("路径不存在：" + path);
-			}
-		}
-		/** 可注入 sleep。 */
-		function sleep(deps, ms) {
-			return new Promise((resolve) => deps.schedule(resolve, ms));
-		}
-		/** 真实依赖装配（全部来自 ctx 注入服务 + 既有 RPC/弹窗/编辑器入口）。 */
-		function realDeps(ctx, overrides = {}) {
-			const service = (name) => {
-				const get = ctx?.get;
-				return typeof get === "function" ? get.call(ctx, name) : void 0;
-			};
-			const add = createAddToConversation(ctx);
-			return {
-				stat: async (path) => {
-					const result = await rpc("edrv.externalStat", { path });
-					return result.ok ? result.kind : "missing";
-				},
-				workspaces: () => {
-					const snap = service("workspaces")?.list?.getSnapshot?.() ?? {};
-					return {
-						items: snap.items ?? [],
-						ready: snap.phase === "ready"
-					};
-				},
-				sessions: () => {
-					const snap = service("sessions")?.list?.getSnapshot?.() ?? {};
-					return {
-						ids: snap.ids ?? [],
-						byId: snap.byId ?? {},
-						ready: snap.phase !== "pending"
-					};
-				},
-				createSession: async (opts) => {
-					const sessions = service("sessions");
-					if (typeof sessions?.create === "function") try {
-						const created = await sessions.create(opts);
-						const id = typeof created === "string" && created ? created : typeof created?.id === "string" ? created.id : typeof created?.sessionId === "string" ? created.sessionId : "";
-						if (id) return id;
-					} catch {}
-					const draft = await newDraftSession(ctx, opts.cwd);
-					if (draft.ok && draft.id) return draft.id;
-					throw new Error("新建会话失败");
-				},
-				createWorkspace: async (path) => {
-					const ws = await service("workspaces").create({ path });
-					return {
-						workspaceId: ws.workspaceId,
-						title: ws.title
-					};
-				},
-				openSession: (id) => {
-					try {
-						const sessions = service("sessions");
-						sessions?.materializeScope?.(id);
-						sessions?.manager?.select?.(id);
-						sessions?.open?.(id);
-					} catch {}
-				},
-				reference: async (sessionId, path, appearance) => {
-					const outcome = await add.appendReference(sessionId, path, void 0, appearance);
-					return outcome === "ok" || outcome === "busy";
-				},
-				choose: (title, folder) => chooseWorkspace(title, folder),
-				openEditor: requestOpen,
-				schedule: (fn, ms) => setTimeout(fn, ms),
-				notify: (text) => toastDom(text),
-				...overrides
-			};
-		}
-		/** @private @author ddj 2026年09月28号
-		* Await actual editor completion and propagate failure to the request result.
-		* @param deps Open dependencies.
-		* @param sessionId Target session.
-		* @param path Target file or editor mount.
-		* @param line Optional line.
-		* @param column Optional column.
-		*/
-		async function openChecked(deps, sessionId, path, line, column) {
-			if (!await deps.openEditor(path, line, column, sessionId)) throw new Error("编辑器打开未完成：" + (path ?? "工作区"));
-		}
-		//#endregion
-		//#region src/client/externalOpen.ts
-		/**
-		* dsh-vscode-mode client — 外部深链落地（Windows 右键菜单 / Unity 外部编辑器）。
-		* 启动时解析 location.search 的 edrvOpen 深链：跨源 referrer 守卫防外部网页诱导；
-		* 处理完剥离 URL 参数防刷新重开；执行委托 openFlow 打开规则引擎（工作区/对话智能路由）。
-		* 另挂 3s 移交轮询（兼活跃心跳）：launcher 投递的打开请求由已打开页面就地执行，避免重复开新页。
-		* 作者 ddj 2026-09-07 / 2026-09-08
-		*/
-		/** toast 自隐时长。 */
-		const TOAST_MS = 5e3;
-		/** 深链移交轮询周期（兼活跃心跳）。 */
-		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 服务）
-		* @param options 可注入选项
-		*/
-		function setupExtOpen(ctx, options = {}) {
-			const dispose = startPresencePoll(ctx);
-			const params = parseOpenParams(options.search ?? (typeof location !== "undefined" ? location.search : ""));
-			if (!params) return dispose;
-			const referrer = options.referrer ?? (typeof document !== "undefined" ? document.referrer : "");
-			if (!referrerAllowed(referrer, options.origin ?? (typeof location !== "undefined" ? location.origin : ""))) {
-				log$2.warn("已忽略跨源深链请求（referrer=" + referrer + "）");
-				return dispose;
-			}
-			stripCurrentUrl();
-			openDeepLink(ctx, params).catch((error) => {
-				log$2.warn("深链打开失败：" + String(error));
-				toastDom("深链打开失败：" + String(error?.message ?? error));
-			});
-			return dispose;
-		}
-		/**
-		* 深链移交轮询：可见时每 3s 向 host 领取待打开请求（兼活跃心跳，launcher 据此决定是否开新页）；
-		* 页面隐藏时降到 15s 一次——无人看页面时移交不必保持 3s 精度，但心跳不能停（超期会让 host 判页面已死）。
-		* 页面级单例（window 标记防 HMR 重复）；领取到即执行打开规则。
-		* @author ddj 2026年09月08号 / 2026年10月15号
-		* @param ctx 客户端根上下文
-		*/
-		function startPresencePoll(ctx) {
-			if (typeof window === "undefined") return () => {};
-			const marker = window;
-			if (typeof marker.__edrvExtPoll === "function") marker.__edrvExtPoll();
-			const generatedId = createRequestId();
-			if (!generatedId) {
-				log$2.warn("安全随机源不可用，已停用外部打开心跳");
-				return () => {};
-			}
-			const clientId = generatedId;
-			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;
-				try {
-					const success = await openDeepLink(ctx, open);
-					if (!disposed) await rpc("edrv.external.ack", {
-						token: open.token,
-						leaseId: open.leaseId,
-						clientId,
-						success,
-						error: success ? void 0 : "编辑器打开失败或取消"
-					});
-				} finally {
-					executing = false;
-				}
-			}
-			/** @private @author ddj 2026年09月28号 Poll while opening to renew the lease without accepting a second request. */
-			async function tick() {
-				if (disposed || polling) return;
-				polling = true;
-				try {
-					const result = await rpc("edrv.external.pending", {
-						clientId,
-						busy: executing
-					});
-					if (!disposed && result.ok && result.open && !executing) execute(result.open).catch(() => {});
-				} finally {
-					polling = false;
-				}
-			}
-			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. */
-			function dispose() {
-				disposed = true;
-				window.clearInterval(timer);
-				disposeOpenWait();
-				if (marker.__edrvExtPoll === dispose) delete marker.__edrvExtPoll;
-			}
-			marker.__edrvExtPoll = dispose;
-			tick().catch(() => {});
-			return dispose;
-		}
-		/**
-		* 跨源守卫：referrer 为空（launcher/Unity 直开）或同源 → 允许。
-		* @author ddj 2026年09月07号
-		* @param referrer 文档 referrer
-		* @param origin 当前页面源
-		* @returns 是否允许处理深链
-		*/
-		function referrerAllowed(referrer, origin) {
-			if (!referrer) return true;
-			try {
-				return new URL(referrer).origin === origin;
-			} catch {
-				return false;
-			}
-		}
-		/**
-		* 剥离 URL 中的深链参数（保留其余参数与 hash，防刷新重开）。
-		* @author ddj 2026年09月07号
-		* @param href 完整 URL
-		* @returns 清理后的 URL（pathname+search+hash）
-		*/
-		function stripOpenHref(href) {
-			const url = new URL(href);
-			for (const key of EDRV_PARAM_KEYS) url.searchParams.delete(key);
-			return url.pathname + url.search + url.hash;
-		}
-		/** 清理当前页面 URL（best-effort，失败不阻塞打开）。 */
-		function stripCurrentUrl() {
-			try {
-				if (typeof location === "undefined" || typeof history === "undefined") return;
-				const next = stripOpenHref(location.href);
-				if (next !== location.pathname + location.search + location.hash) history.replaceState(null, "", next);
-			} catch {}
-		}
-		/**
-		* 轻量 toast（编辑器未挂载也能提示；5s 自隐；openFlow 通知与错误呈现共用）。
-		* @author ddj 2026年09月07号
-		* @param text 提示文本
-		*/
-		function toastDom(text) {
-			if (typeof document === "undefined") return;
-			const toast = document.createElement("div");
-			toast.textContent = text;
-			toast.setAttribute("style", [
-				"position:fixed",
-				"left:50%",
-				"bottom:28px",
-				"transform:translateX(-50%)",
-				"z-index:99999",
-				"padding:8px 14px",
-				"border-radius:8px",
-				"max-width:80vw",
-				"background:#2a2a2a",
-				"color:#ddd",
-				"border:1px solid #444",
-				"font-size:12px",
-				"box-shadow:0 4px 16px rgba(0,0,0,.35)"
-			].join(";"));
-			document.body?.appendChild(toast);
-			setTimeout(() => toast.remove(), TOAST_MS);
-		}
-		//#endregion
 		//#region src/client/compatSummary.ts
 		/**
 		* Classify the API generation without importing the host's node-only version probe.
@@ -404098,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
@@ -404166,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;
 			}
@@ -404198,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
 				} }));
 			});
@@ -404218,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
 			});
@@ -404289,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;
 						}
@@ -404308,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);
 			}
@@ -408543,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);
@@ -409009,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,
@@ -412499,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(),
@@ -414340,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");
@@ -414372,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)
@@ -414562,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
 				})));
@@ -414647,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
 						})),
@@ -414756,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",