dsh-vscode-mode 0.25.0 → 0.26.0

package/lib/client.js

@@ -3686,7 +3686,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 +3729,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 +5011,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 +5494,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 +5529,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 +5544,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 +147217,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 +147500,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 +147509,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 +147624,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 +147637,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 +147650,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 +147672,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 +147754,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 +147762,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 +147787,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 +147798,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 +147877,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 +147891,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 +147996,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 +148016,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 +148032,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 +148197,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 +148222,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 +148250,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 +148276,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 +148296,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 +148311,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 +148341,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 +148373,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
 				}));
@@ -382739,6 +384044,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 +385813,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号
@@ -394041,10 +394713,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 +394725,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());
@@ -397043,11 +397716,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 +397741,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 +397916,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 +397950,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 +397971,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 +397980,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 +398069,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 +398115,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 +398210,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;
@@ -403456,577 +404200,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.
@@ -411139,6 +411312,107 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 		function clearFileClip() {
 			clip = null;
 		}
+		//#endregion
+		//#region src/client/downloadSink.ts
+		/**
+		* 让用户选择保存目录。
+		* @author ddj 2026年11月03号
+		* @returns 所选目录 / 回落原因 / 'cancelled'（用户取消，整批终止）
+		* @sideEffects 弹出系统目录选择器，成功后可能触发一次写权限请求
+		*/
+		async function pickSaveSink() {
+			if (globalThis.isSecureContext === false) return {
+				kind: "browser",
+				reason: "insecure"
+			};
+			const picker = pickerOf();
+			if (!picker) return {
+				kind: "browser",
+				reason: "unsupported"
+			};
+			let dir;
+			try {
+				dir = await picker({
+					id: "vsm-download",
+					mode: "readwrite",
+					startIn: "downloads"
+				});
+			} catch (error) {
+				return isAbort(error) ? "cancelled" : {
+					kind: "browser",
+					reason: "denied"
+				};
+			}
+			return await ensureWritable(dir) ? {
+				kind: "dir",
+				dir
+			} : {
+				kind: "browser",
+				reason: "denied"
+			};
+		}
+		/**
+		* 取回 `showDirectoryPicker`（不安全上下文视为没有）。
+		* @author ddj 2026年11月03号
+		* @returns 绑定到 globalThis 的选目录函数；不可用为 undefined
+		*/
+		function pickerOf() {
+			const win = globalThis;
+			if (win.isSecureContext === false) return void 0;
+			return typeof win.showDirectoryPicker === "function" ? win.showDirectoryPicker.bind(win) : void 0;
+		}
+		/**
+		* 确认目录可写（部分浏览器选择后仍需显式请求一次 readwrite 权限）。
+		* @author ddj 2026年11月03号
+		* @param dir 目录句柄
+		* @returns 已获得写权限为 true
+		* @throws 权限查询本身抛错时向上透传（由调用方按回落处理）
+		*/
+		async function ensureWritable(dir) {
+			if (!dir.queryPermission) return true;
+			if (await dir.queryPermission({ mode: "readwrite" }) === "granted") return true;
+			if (!dir.requestPermission) return false;
+			return await dir.requestPermission({ mode: "readwrite" }) === "granted";
+		}
+		/**
+		* 把字节写到所选目录下的相对路径处（自动逐级建子目录）。
+		* @author ddj 2026年11月03号
+		* @param dir 目标目录句柄
+		* @param relPath 工作区相对路径（分隔符 `/`；越界段 `..` 会被丢弃）
+		* @param bytes 原始字节
+		* @sideEffects 在用户所选目录内创建目录与文件并覆盖同名文件
+		* @throws 磁盘写入失败或文件名非法时透传底层错误
+		*/
+		async function writeFileToDir(dir, relPath, bytes) {
+			const parts = pathSegments(relPath);
+			const fileName = parts.pop() ?? "download";
+			let parent = dir;
+			for (const part of parts) parent = await parent.getDirectoryHandle(part, { create: true });
+			const writable = await (await parent.getFileHandle(fileName, { create: true })).createWritable();
+			try {
+				await writable.write(bytes);
+			} finally {
+				await writable.close();
+			}
+		}
+		/**
+		* 相对路径切段（过滤空段、`.` 与越界 `..`，兼容反斜杠）。
+		* @author ddj 2026年11月03号
+		* @param relPath 工作区相对路径
+		* @returns 安全的路径段（末段为文件名）
+		*/
+		function pathSegments(relPath) {
+			return relPath.split(/[\\/]+/).map((part) => part.trim()).filter((part) => part !== "" && part !== "." && part !== "..");
+		}
+		/**
+		* 判断是否用户取消（AbortError），不依赖 DOMException 构造函数的存在。
+		* @author ddj 2026年11月03号
+		* @param error 捕获值
+		* @returns 取消为 true
+		*/
+		function isAbort(error) {
+			return typeof error === "object" && error !== null && error.name === "AbortError";
+		}
 		/**
 		* 初始状态：根目录默认展开，等待首层 listDir 填充。
 		* @author ddj 2026年11月03号
@@ -411513,7 +411787,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				dialogClass: "edrv-dl-dialog",
 				width: "min(640px, calc(100vw - 40px))",
 				onClose
-			}, react$1.default.createElement("h3", null, "下载到本机"), react$1.default.createElement("div", { className: "edrv-dl-sub" }, root ? "/" + root : "工作区根目录"), renderTree({
+			}, react$1.default.createElement("h3", null, "下载到本机"), react$1.default.createElement("div", { className: "edrv-dl-sub" }, root ? "/" + root : "工作区根目录"), react$1.default.createElement("div", { className: "edrv-dl-hint" }, "点下载后会先选择保存文件夹，文件按相对路径写入"), renderTree({
 				state,
 				root,
 				rows,
@@ -411565,7 +411839,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				className: "edrv-dl-go",
 				disabled: !picked.length,
 				onClick: () => onConfirm(picked)
-			}, "下载 " + picked.length + " 个文件"));
+			}, "选择位置并下载 " + picked.length + " 个文件"));
 		}
 		/**
 		* 目录行：三角展开 / 收起，名称后带加载或错误提示。
@@ -411723,16 +411997,17 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			};
 		}
 		/**
-		* 下载单个文件并交给浏览器落盘。
+		* 下载单个文件并落盘（所选目录则按相对路径写入，否则交给浏览器 `<a download>`）。
 		* @author ddj 2026年11月03号
 		* @param path 工作区相对路径
-		* @param opts 会话 / 取消选项
+		* @param opts 会话 / 取消 / 落盘选项
 		* @returns 路径与字节数
-		* @throws 读取失败透传主机错误
+		* @throws 读取失败透传主机错误；目录写入失败透传底层错误
 		*/
 		async function downloadOne(path, opts = {}) {
 			const file = await fetchDownload(path, opts.sessionId);
-			downloadBytes(file.bytes, baseNameOf$1(path) || "download", file.mime);
+			if (opts.sink?.kind === "dir") await writeFileToDir(opts.sink.dir, path, file.bytes);
+			else downloadBytes(file.bytes, baseNameOf$1(path) || "download", file.mime);
 			return {
 				path,
 				size: file.size
@@ -411787,22 +412062,43 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			});
 		}
 		/**
-		* 批量下载并统一反馈（开始一条、结束一条，避免逐文件刷屏）。
+		* 批量下载并统一反馈（先选保存目录，再逐文件落盘；开始一条、结束一条，避免逐文件刷屏）。
 		* @author ddj 2026年11月03号
 		* @param paths 勾选路径
 		* @param ctx 面板上下文
+		* @sideEffects 弹出目录选择器；用户取消则整批中止
 		*/
 		async function runBatch(paths, ctx) {
 			if (!paths.length) return;
+			const sink = await pickSaveSink();
+			if (sink === "cancelled") {
+				ctx?.notify?.("已取消下载");
+				return;
+			}
+			if (sink.kind === "browser") ctx?.notify?.(fallbackText(sink.reason));
 			if (paths.length > 1) ctx?.notify?.("正在下载 " + paths.length + " 个文件…");
 			try {
-				const out = await downloadMany(paths, { sessionId: ctx?.sessionId });
+				const out = await downloadMany(paths, {
+					sessionId: ctx?.sessionId,
+					sink
+				});
 				ctx?.notify?.(batchText(out));
 			} catch (error) {
 				ctx?.notify?.("下载失败：" + textOfError(error));
 			}
 		}
 		/**
+		* 目录选择不可用时的提示文案（说明文件去了浏览器默认下载目录）。
+		* @author ddj 2026年11月03号
+		* @param reason 回落原因
+		* @returns 单行提示文案
+		*/
+		function fallbackText(reason) {
+			if (reason === "unsupported") return "浏览器不支持选择保存目录，已保存到默认下载目录";
+			if (reason === "insecure") return "当前页面不是安全上下文（需 https 或 localhost），已保存到默认下载目录";
+			return "未获得目录写入权限，已保存到默认下载目录";
+		}
+		/**
 		* 批量结果口播文案。
 		* @author ddj 2026年11月03号
 		* @param out 批量结果