dsh-vscode-mode 0.1.47 → 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);
@@ -7230,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) {
@@ -7428,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
 		/**
@@ -8039,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
@@ -8496,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
 		*/
 		/**
 		* 构造内置右键菜单项列表（后续内置项直接追加）。
@@ -8515,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