dsh-vscode-mode 0.1.46 → 0.1.48

package/lib/client.js

@@ -2601,6 +2601,154 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/addToConversation.ts
+		/** 把追加引用结果映射为可读文案（ok 用 okText；busy 提示已降级纯文本；unavailable 提示不可用）。
+		* @author ddj 2026年09月03号
+		* @param outcome 追加结果状态
+		* @param okText 成功文案（如「已添加文件引用」/「已添加文件夹引用」）
+		* @returns 状态栏/通知用文案
+		*/
+		function statusOfAdd(outcome, okText) {
+			if (outcome === "ok") return okText;
+			if (outcome === "busy") return okText + "（输入框忙，已降级纯文本）";
+			return "无法添加到对话（无会话或输入框不可用）";
+		}
+		/** DSH reference source 名（dsh-client-ui-reference 注册的 @file/@session 统一源）。 */
+		const REF_SOURCE = "reference";
+		/**
+		* 生成 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 文件引用插入载荷（source=reference，发送序列化为 mention(+range) 文本）。
+		* @param path 目标路径（相对 cwd 或绝对）
+		* @param cwd 会话工作区目录（可选）
+		* @param range 行区间（可选）
+		* @param appearance 引用外观：'file'（默认）| 'folder'
+		*/
+		function buildFileRef(path, cwd, range, appearance = "file") {
+			const mention = mentionOf(path, cwd);
+			return {
+				mention,
+				reference: {
+					source: REF_SOURCE,
+					ref: refOf(mention, range),
+					label: labelOf(path, range),
+					appearance,
+					clipboardText: mention
+				}
+			};
+		}
+		/**
+		* 解析会话输入门面；缺失时返回 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 = sessions?.scope?.(sessionId);
+				const shell = actx && conversation?.input?.for?.(actx);
+				return shell && typeof shell.setDraft === "function" ? shell : void 0;
+			} catch {
+				return;
+			}
+		}
+		/** 取当前草稿长度与版本；无输入门面时返回 null。
+		* @author ddj 2026年08月25号 */
+		function draftCursor(input) {
+			try {
+				const s = input?.state?.getSnapshot?.();
+				if (!s) return null;
+				return {
+					draft: String(s.draft ?? ""),
+					draftRev: Number(s.draftRev ?? 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;
+			}
+		}
+		/**
+		* 创建「添加到对话」动作集（apply 阶段构建一次，随 props 传给 EditorView）。
+		* @author ddj 2026年08月25号
+		* @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);
+				if (!safeInsert(input, reference, {
+					start: cur.draft.length,
+					end: cur.draft.length,
+					draftRev: cur.draftRev
+				})) {
+					const gap = cur.draft.length > 0 && !/\s$/.test(cur.draft) ? " " : "";
+					input.setDraft(cur.draft + gap + mention + " ");
+					return "busy";
+				}
+				return "ok";
+			};
+			return { appendReference };
+		}
+		//#endregion
 		//#region src/shared/lsp.ts
 		/** LSP semantic token 标准类型（host 归一化后，client 与 Monaco 共用）。 */
 		const LSP_SEMANTIC_TOKEN_TYPES = [
@@ -4551,14 +4699,7 @@ window.__ModuleLoader__.load({
 			const dismissMenus = () => {
 				setTabMenu(null);
 			};
-			/** 把「添加到对话」返回状态映射为状态栏文案。
-			* @author ddj 2026年08月25号 */
-			const statusOfAdd = (outcome, okText) => {
-				if (outcome === "ok") return okText;
-				if (outcome === "busy") return okText + "（输入框忙，已降级纯文本）";
-				return "无法添加到对话（无会话或输入框不可用）";
-			};
-			/** 添加文件/选中区引用到对话（异步，状态栏反馈）。 */
+			/** 添加文件/选中区引用到对话（异步，状态栏反馈；状态文案走共享 statusOfAdd）。 */
 			const addRefToChat = (path, range) => {
 				if (!path) {
 					setStatus("无活动文件");
@@ -4957,6 +5098,7 @@ window.__ModuleLoader__.load({
 				editor: () => editorRef.current,
 				outlineSources: props.outlineSources,
 				fileMenuItems: props.fileMenuItems,
+				addToConversation,
 				notify: (message) => setStatus(message)
 			};
 			const editorArea = react.default.createElement("div", { className: "edrv-editor-area" }, body, hoverEl, overlay);
@@ -5804,8 +5946,8 @@ window.__ModuleLoader__.load({
 			hint: "优先使用已安装 EmmyLua；未安装时回退 LuaLS 或 PATH 中的 lua-language-server"
 		}, {
 			id: "csharp",
-			label: "C#（Roslyn / OmniSharp）",
-			hint: "需 dotnet + ms-dotnettools.csharp 的 .roslyn 服务器，或手动指定"
+			label: "C#（Roslyn / DotRush / OmniSharp）",
+			hint: "优先自动发现 ms-dotnettools.csharp / DotRush 扩展（DotRush 需 .NET 10 运行时）；也可手动指定"
 		}];
 		const PHASE_LABEL = {
 			idle: "未启动",
@@ -5839,8 +5981,17 @@ window.__ModuleLoader__.load({
 				label: "更新"
 			}
 		];
-		/** 语言卡片：状态 + 启用开关 + 命令/路径配置 + 重新检测。 */
-		function LangCard({ lang, config, status, busy, onToggle, onSave, onRedetect }) {
+		/** 环境安装按钮文案（按安装进行态）。 */
+		function envButtonLabel(req, envStates) {
+			const state = (envStates ?? []).find((s) => s.id === req.id);
+			if (state?.phase === "downloading") return "下载中…";
+			if (state?.phase === "extracting") return "安装中…";
+			if (state?.phase === "done") return "已完成";
+			if (state?.phase === "failed") return "重试";
+			return "一键安装";
+		}
+		/** 语言卡片：状态 + 缺失环境提示（一键安装/官网下载） + 启用开关 + 命令/路径配置 + 重新检测。 */
+		function LangCard({ lang, config, status, busy, envStates, onInstallEnv, onToggle, onSave, onRedetect }) {
 			const [pathDraft, setPathDraft] = react.default.useState(config?.path ?? "");
 			const [commandDraft, setCommandDraft] = react.default.useState(config?.command ?? "");
 			react.default.useEffect(() => {
@@ -5852,7 +6003,23 @@ window.__ModuleLoader__.load({
 				className: "vsm-switch " + (config?.enabled !== false ? "on" : ""),
 				onClick: () => onToggle(lang.id, config?.enabled !== false ? false : true),
 				"aria-label": "启用/禁用"
-			}, config?.enabled !== false ? "●" : "○"))), react.default.createElement("div", { className: "vsm-mcp-meta" }, PHASE_LABEL[phase] ?? phase, " · ", SOURCE_LABEL[status?.source] ?? status?.source, status?.providerName ? " · " + status.providerName : "", status?.version ? " · v" + status.version : "", phase === "ready" && status?.root ? " · " + String(status.root).split(/[\\/]/).pop() : ""), status?.reason ? react.default.createElement("div", { className: "vsm-mcp-error" }, status.reason) : null, react.default.createElement("div", { className: "vsm-lsp-form" }, react.default.createElement("label", null, react.default.createElement("span", null, "可执行文件路径（绝对路径，优先）"), react.default.createElement("input", {
+			}, config?.enabled !== false ? "●" : "○"))), react.default.createElement("div", { className: "vsm-mcp-meta" }, PHASE_LABEL[phase] ?? phase, " · ", SOURCE_LABEL[status?.source] ?? status?.source, status?.providerName ? " · " + status.providerName : "", status?.version ? " · v" + status.version : "", phase === "ready" && status?.root ? " · " + String(status.root).split(/[\\/]/).pop() : ""), status?.reason ? react.default.createElement("div", { className: "vsm-mcp-error" }, status.reason) : null, Array.isArray(status?.missingEnv) && status.missingEnv.length ? react.default.createElement("div", { className: "vsm-lsp-hint" }, "缺少运行环境（一键安装后自动生效）：", status.missingEnv.map((req) => react.default.createElement("div", {
+				key: req.id,
+				className: "vsm-mcp-actions"
+			}, react.default.createElement("span", null, req.label, req.detail ? "（" + req.detail + "）" : ""), req.installable ? react.default.createElement("button", {
+				className: "vsm-primary vsm-small",
+				disabled: busy === "env:" + req.id,
+				onClick: () => onInstallEnv(lang.id, req)
+			}, envButtonLabel(req, envStates)) : null, req.manualUrl ? react.default.createElement("a", {
+				href: req.manualUrl,
+				target: "_blank",
+				rel: "noreferrer",
+				style: {
+					color: "inherit",
+					textDecoration: "underline",
+					alignSelf: "center"
+				}
+			}, req.manualLabel ?? "官网下载") : null))) : null, react.default.createElement("div", { className: "vsm-lsp-form" }, react.default.createElement("label", null, react.default.createElement("span", null, "可执行文件路径（绝对路径，优先）"), react.default.createElement("input", {
 				value: pathDraft,
 				placeholder: "如 C:/.../lua-language-server.exe",
 				onChange: (e) => setPathDraft(e.target.value)
@@ -5908,6 +6075,8 @@ window.__ModuleLoader__.load({
 			const [busy, setBusy] = react.default.useState("");
 			const [error, setError] = react.default.useState("");
 			const [loading, setLoading] = react.default.useState(true);
+			const [envStates, setEnvStates] = react.default.useState([]);
+			const [envLang, setEnvLang] = react.default.useState("");
 			const refreshServers = react.default.useCallback(() => {
 				Promise.all([rpc("edrv.lsp.configGet", {}), rpc("edrv.lsp.status", {})]).then(([cfg, st]) => {
 					if (cfg?.ok) setConfig(cfg.config ?? {});
@@ -5922,6 +6091,12 @@ window.__ModuleLoader__.load({
 					setError("");
 				}).catch((e) => setError(String(e)));
 			}, []);
+			const refreshEnvStates = react.default.useCallback(() => {
+				return rpc("edrv.lsp.envState", {}).then((res) => {
+					if (res?.ok) setEnvStates(res.states ?? []);
+					return res?.states ?? [];
+				}).catch(() => []);
+			}, []);
 			const refresh = react.default.useCallback(() => {
 				setLoading(true);
 				Promise.all([refreshServers(), refreshExt()]).finally(() => setLoading(false));
@@ -5941,9 +6116,56 @@ window.__ModuleLoader__.load({
 				setServers((prev) => Array.isArray(list) ? [...prev.filter((s) => s.languageId !== languageId), ...list] : prev);
 			};
 			/** 重检测后通知编辑器：与 host 重新同步已打开的模型（触发重新 acquire）。 */
-			const notifyResync = (languageId) => {
+			const notifyResync = react.default.useCallback((languageId) => {
 				window.dispatchEvent(new CustomEvent("edrv:lsp-redetect", { detail: { languageId } }));
+			}, []);
+			/** 一键安装缺失环境：启动内置安装器（成功后进入轮询，完成自动重同步）。 */
+			const installEnv = (languageId, req) => {
+				const key = "env:" + req.id;
+				setBusy(key);
+				setError("");
+				setEnvLang(languageId);
+				rpc("edrv.lsp.envInstall", {
+					languageId,
+					id: req.id
+				}).then((res) => {
+					if (!res?.ok) {
+						setError(res?.error ?? "无法启动安装");
+						return;
+					}
+					refreshEnvStates();
+					refreshServers();
+				}).catch((e) => setError(String(e))).finally(() => setBusy(""));
 			};
+			react.default.useEffect(() => {
+				if (!(envStates ?? []).some((s) => s.phase === "downloading" || s.phase === "extracting")) return;
+				const timer = setInterval(() => {
+					refreshEnvStates();
+					refreshServers();
+				}, 2e3);
+				return () => clearInterval(timer);
+			}, [
+				envStates,
+				refreshEnvStates,
+				refreshServers
+			]);
+			const prevEnvPhases = react.default.useRef({});
+			react.default.useEffect(() => {
+				const states = envStates ?? [];
+				for (const s of states) {
+					const prev = prevEnvPhases.current[s.id];
+					if (prev && prev !== "done" && s.phase === "done" && envLang) {
+						refreshServers();
+						notifyResync(envLang);
+					}
+					prevEnvPhases.current[s.id] = s.phase;
+				}
+			}, [
+				envStates,
+				envLang,
+				refreshServers,
+				notifyResync
+			]);
 			const saveLang = (languageId, path, command) => {
 				setBusy(languageId);
 				setError("");
@@ -6064,6 +6286,8 @@ window.__ModuleLoader__.load({
 				config: config[lang.id] ?? {},
 				status: servers.find((s) => s.languageId === lang.id),
 				busy,
+				envStates,
+				onInstallEnv: installEnv,
 				onToggle: toggleLang,
 				onSave: saveLang,
 				onRedetect: redetectLang
@@ -7148,147 +7372,6 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
-		//#region src/client/addToConversation.ts
-		/** DSH reference source 名（dsh-client-ui-reference 注册的 @file/@session 统一源）。 */
-		const REF_SOURCE = "reference";
-		/**
-		* 生成 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 文件引用插入载荷（source=reference，发送序列化为 mention(+range) 文本）。 */
-		function buildFileRef(path, cwd, range) {
-			const mention = mentionOf(path, cwd);
-			return {
-				mention,
-				reference: {
-					source: REF_SOURCE,
-					ref: refOf(mention, range),
-					label: labelOf(path, range),
-					appearance: "file",
-					clipboardText: mention
-				}
-			};
-		}
-		/**
-		* 解析会话输入门面；缺失时返回 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 = sessions?.scope?.(sessionId);
-				const shell = actx && conversation?.input?.for?.(actx);
-				return shell && typeof shell.setDraft === "function" ? shell : void 0;
-			} catch {
-				return;
-			}
-		}
-		/** 取当前草稿长度与版本；无输入门面时返回 null。
-		* @author ddj 2026年08月25号 */
-		function draftCursor(input) {
-			try {
-				const s = input?.state?.getSnapshot?.();
-				if (!s) return null;
-				return {
-					draft: String(s.draft ?? ""),
-					draftRev: Number(s.draftRev ?? 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;
-			}
-		}
-		/** 写入成功后的 composer 内联提示（门面可用时；失败静默）。
-		* @author ddj 2026年08月25号 */
-		function notify(input, text) {
-			try {
-				input.notify?.("info", text);
-			} catch {}
-		}
-		/** 输入门面插入引用（拦截异常视作未应用，走降级）。
-		* @author ddj 2026年08月25号 */
-		function safeInsert(input, reference, span) {
-			try {
-				return input.insertReference(reference, span) === true;
-			} catch {
-				return false;
-			}
-		}
-		/**
-		* 创建「添加到对话」动作集（apply 阶段构建一次，随 props 传给 EditorView）。
-		* @author ddj 2026年08月25号
-		* @param ctx 客户端服务上下文（sessions + conversation）
-		* @returns 动作集
-		*/
-		function createAddToConversation(ctx) {
-			const appendReference = async (sessionId, path, range) => {
-				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);
-				if (!safeInsert(input, reference, {
-					start: cur.draft.length,
-					end: cur.draft.length,
-					draftRev: cur.draftRev
-				})) {
-					const gap = cur.draft.length > 0 && !/\s$/.test(cur.draft) ? " " : "";
-					input.setDraft(cur.draft + gap + mention + " ");
-					notify(input, "已添加文件引用 " + mention);
-					return "busy";
-				}
-				notify(input, "已添加文件引用 " + mention);
-				return "ok";
-			};
-			return { appendReference };
-		}
-		//#endregion
 		//#region src/client/sidebar/registry.ts
 		/** 校验面板定义并写入注册表（缺 id/render 抛 TypeError）。 */
 		function panelRegister(entries, notify, panel) {
@@ -7346,24 +7429,6 @@ window.__ModuleLoader__.load({
 				top: Math.max(4, Math.min(y, maxTop))
 			};
 		}
-		/**
-		* 将文件树行右键菜单锚定到目标行右侧；无法测量时回退到鼠标坐标。
-		* @author ddj 2026年08月28号
-		* @param rect 目标行的布局矩形
-		* @param fallbackX 鼠标 viewport x 坐标
-		* @param fallbackY 鼠标 viewport y 坐标
-		* @returns 菜单初始位置
-		*/
-		function rowMenuPosition(rect, fallbackX, fallbackY) {
-			if (!rect || rect.width <= 0 || rect.height <= 0) return {
-				left: fallbackX,
-				top: fallbackY
-			};
-			return {
-				left: rect.right + 4,
-				top: rect.top
-			};
-		}
 		//#endregion
 		//#region src/client/ui/ContextMenu.ts
 		/**
@@ -7957,11 +8022,9 @@ window.__ModuleLoader__.load({
 					onContextMenu: (ev) => {
 						ev.preventDefault();
 						ev.stopPropagation();
-						const rect = ev.currentTarget?.getBoundingClientRect?.();
-						const position = rowMenuPosition(rect, ev.clientX, ev.clientY);
 						setMenu({
-							x: position.left,
-							y: position.top,
+							x: ev.clientX,
+							y: ev.clientY,
 							target: {
 								path: e.path,
 								type: e.type
@@ -8414,9 +8477,10 @@ window.__ModuleLoader__.load({
 		//#region src/client/sidebar/menuItems.ts
 		/**
 		* dsh-vscode-mode client — 文件管理右键菜单内置项。
-		* 首个内置项：「在文件浏览器中打开」（文件→OS Explorer 定位选中、目录→打开目录）。
+		* 内置项：「在文件浏览器中打开」（文件→OS Explorer 定位选中、目录→打开目录）；
+		* 「添加引用到对话」（文件/文件夹引用注入当前会话对话输入框）。
 		* 反馈统一走 ctx.notify（由 EditorView 提供，落到编辑区路径栏状态）。
-		* 作者 ddj 2026-08-27
+		* 作者 ddj 2026-08-27 / 2026-09-03
 		*/
 		/**
 		* 构造内置右键菜单项列表（后续内置项直接追加）。
@@ -8433,6 +8497,23 @@ window.__ModuleLoader__.load({
 						ctx.notify?.(outcome.ok ? "已在文件浏览器中打开" : "打开失败：" + (outcome.error ?? "未知错误"));
 					});
 				}
+			}, {
+				id: "add-to-conversation",
+				label: "添加引用到对话",
+				order: 1,
+				visible: (target, ctx) => Boolean(target.path && ctx.sessionId && ctx.addToConversation),
+				run: (target, ctx) => {
+					const isDir = target.type === "directory";
+					const add = ctx.addToConversation;
+					if (!add) {
+						ctx.notify?.("添加到对话不可用");
+						return;
+					}
+					const okText = isDir ? "已添加文件夹引用" : "已添加文件引用";
+					add.appendReference(ctx.sessionId, target.path, void 0, isDir ? "folder" : "file").then((outcome) => {
+						ctx.notify?.(statusOfAdd(outcome, okText));
+					});
+				}
 			}];
 		}
 		//#endregion