dsh-plugin-workbench 0.0.9 → 0.0.11

package/CHANGELOG.md

@@ -4,6 +4,40 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 版本号遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## [0.0.11] - 2026-08-21
+
+### Added
+
+- **README 互相引用**：新增「相关插件」段，列出同系列已发布插件（npm / GitHub 链接 + 一句话说明），互相引流。
+
+## [0.0.10] - 2026-08-21
+
+### Fixed
+
+- **「在资源管理器打开」不生效（窗口打开但不可见）**：Windows 下 `spawn` 传
+  `windowsHide: true` 会让新开的资源管理器文件夹窗口以**隐藏状态**创建
+  （CREATE_NO_WINDOW 沿请求一路传导，窗口存在但 `visible=False`，用户什么都
+  看不到）。`explorer.exe` 是 GUI 子系统程序，不带 `windowsHide` 也不会闪
+  控制台；`reveal` 端点现在对 explorer.exe 全部不传该标志（含 WSL 转译分支），
+  资源管理器窗口正常弹出并选中目标文件
+
+### Added
+
+- **整列右键菜单**：不只文件行——在左栏任何空白处、头部、剪贴板条上右键
+  都弹出当前工作区目录菜单（新建文件 / 新建文件夹 / 粘贴 / 全选 / 撤销 /
+  复制路径 / 在资源管理器打开 / 在系统中打开 / 刷新）；右键菜单自身不再触发
+  浏览器原生菜单
+- **@ 在消息中引用（Claude Code 式文件引用）**：文件右键菜单新增
+  「@ 在消息中引用」，把 `@相对工作区路径`（自动带尾随空格）插入聊天输入框
+  光标处；发送后消息里的 `@相对路径` 渲染为超链接（点击在工作台预览中打开
+  该文件），语法为 `@` + 相对工作区路径——`@src/a.ts`、`@README.md` 匹配，
+  绝对路径 / 邮箱 / 无路径形状的普通 `@文本` 一律按原样显示、无特殊含义；
+  中文句子标点跟尾视为普通文本
+- **拖文件进会话**：把左栏文件（含多选）拖到聊天区任意位置（不在左栏内）
+  即把路径文本插入聊天输入框光标处；拖到左栏目录行仍是原有的移动操作
+- **任意位置点击取消选中**：选中文件/文件夹后，点击树外任何地方（会话、
+  其他栏、左栏头部）都会清除选中；树内空白/提示行点击同样取消
+
 ## [0.0.9] - 2026-08-21
 
 ### Added

package/README.md

@@ -25,11 +25,17 @@
   干净标签页自动重读，带未保存编辑的标签页显示「⟳」徽标（点击重新加载）
 - **行号栏**：编辑器左侧逻辑行号，与文本滚动锁定对齐（纯文本/高亮模式均生效）
 - **图片预览**：png/jpg/gif/webp/avif/svg 等直接内联渲染（同源字节路由，20MB 上限）
-- **右键菜单**（VS Code 风格）：文件/文件夹/空白区域均可右键——
+- **右键菜单**（VS Code 风格）：文件/文件夹/**整列任意空白、头部**均可右键——
   新建文件、新建文件夹、重命名、删除（递归带确认）、复制路径、复制 / 剪切 / 粘贴、
-  刷新、在系统中打开、
+  刷新、在系统中打开、全选、撤销、
   在资源管理器打开（文件在所在文件夹中被选中，文件夹直接打开；
   Windows `explorer` / macOS `open`，WSL 自动转译）
+- **@ 在消息中引用**：文件右键「@ 在消息中引用」把 `@相对工作区路径` 插入聊天输入框；
+  发送后消息中的 `@相对路径` 渲染为超链接（点击在工作台预览打开），
+  语法为 `@` + 相对工作区路径，其它 `@文本` 一律按原样显示、无特殊含义
+- **拖文件进会话**：把文件/多选从左栏拖到聊天区任意位置，路径文本插入输入框光标处；
+  拖到左栏目录行仍是移动操作
+- **任意位置点击取消选中**：点击树外的任何地方（会话/其它栏/左栏头部）清除选中
 - **复制 / 剪切 / 粘贴**：Ctrl/Cmd+C/X/V（或右键菜单），支持跨工作区粘贴；
   复制到同名已存在的目标时询问「是否覆盖」，与系统文件管理器一致；
   剪切（移动）成功后自动清空剪贴板
@@ -123,6 +129,20 @@ dsh plugin --profile web remove dsh-plugin-workbench
 见 [CONTRIBUTING](./CONTRIBUTING.md) 与 [CODE_OF_CONDUCT](./CODE_OF_CONDUCT.md)；
 变更记录见 [CHANGELOG](./CHANGELOG.md)。
 
+## 相关插件
+
+本插件属于 **Pasumao 的 dsh 插件生态**，同系列已发布插件可搭配使用：
+
+| 插件（npm） | GitHub | 说明 |
+|---|---|---|
+| [dsh-notify](https://www.npmjs.com/package/dsh-notify) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-notify) | Windows 原生通知 + 系统托盘 |
+| [dsh-plugin-choice-refresh](https://www.npmjs.com/package/dsh-plugin-choice-refresh) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-choice-refresh) | 选择增强：重新生成选项 / 更多选项 |
+| [dsh-plugin-dev-kb](https://www.npmjs.com/package/dsh-plugin-dev-kb) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-dev-kb) | 插件开发知识库（官方文档完整镜像 + 技能） |
+| [dsh-plugin-image-tools](https://www.npmjs.com/package/dsh-plugin-image-tools) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-image-tools) | 图片选择卡 + 回复内嵌图片 + 盲模型收图 |
+| [dsh-plugin-table-zoom](https://www.npmjs.com/package/dsh-plugin-table-zoom) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-table-zoom) | 聊天长表格浮窗查看 + 一键复制 Markdown |
+
+> 本系列其余插件见 [Pasumao · dsh 插件](https://github.com/Pasumao)；觉得好用欢迎到 GitHub 点 ⭐。
+
 ## AI 生成声明
 
 部分源码与文档由 AI 辅助生成（DeepSeek Harness），均经人工审查与实机验证；

package/lib/client.js

@@ -855,6 +855,126 @@ window.__ModuleLoader__.load({
 			return entry;
 		}
 		//#endregion
+		//#region src/client/composer.ts
+		/**
+		* Composer integration for the workbench file column.
+		*
+		* Two gestures land text in the chat composer without touching the core:
+		*
+		* 1. Drag & drop — dragging one or more tree rows and dropping ANYWHERE
+		*    outside the file column (the chat, the composer, the message list)
+		*    inserts the dragged paths into the composer. Dropping INSIDE the file
+		*    column still performs the tree's own move operation — the tree's drop
+		*    handler runs first and stops propagation, so this document-level
+		*    listener never sees those drops.
+		*
+		* 2. Context-menu "@引用" — inserts `@<relative-workspace-path>` at the
+		*    composer caret.
+		*
+		* The composer is a controlled React textarea, so the value is updated
+		* through the native `value` setter + a bubbling `input` event (the standard
+		* trick that makes React's onChange see the change), and the caret is
+		* restored on the next frame because the React re-render may reset it.
+		*/
+		/** Custom dataTransfer type carrying the dragged workspace paths (JSON array). */
+		const DRAG_TYPE = "application/x-dsh-workbench-files";
+		/** One-time install guard (the client bundle re-applies on HMR). */
+		let dropsInstalled = false;
+		/** Start the document-level drop listener (idempotent). */
+		function installComposerDrops() {
+			if (dropsInstalled || typeof document === "undefined") return;
+			dropsInstalled = true;
+			document.addEventListener("drop", onDocumentDrop);
+		}
+		function onDocumentDrop(e) {
+			const dt = e.dataTransfer;
+			if (dt === null || !dt.types.includes("application/x-dsh-workbench-files")) return;
+			const paths = readDraggedPaths(dt);
+			if (paths.length === 0) return;
+			if (!insertIntoComposer(paths.join("\n"))) return;
+			e.preventDefault();
+			e.stopPropagation();
+		}
+		/** Read the JSON paths from the custom type; falls back to raw text. */
+		function readDraggedPaths(dt) {
+			if (dt === null) return [];
+			let raw = "";
+			try {
+				raw = dt.getData(DRAG_TYPE);
+			} catch {
+				return [];
+			}
+			try {
+				const parsed = JSON.parse(raw);
+				if (Array.isArray(parsed) && parsed.every((p) => typeof p === "string")) return parsed;
+			} catch {}
+			return raw.trim().length > 0 ? [raw] : [];
+		}
+		/** The visible composer textarea, or null when none is usable. */
+		function composerTextarea() {
+			if (typeof document === "undefined") return null;
+			const seat = document.querySelector("[data-composer-seat]");
+			if (seat === null) return null;
+			const input = seat.querySelector("textarea");
+			if (!(input instanceof HTMLTextAreaElement)) return null;
+			if (input.disabled || input.readOnly) return null;
+			return input;
+		}
+		/**
+		* Insert `text` into the composer. If the composer textarea has focus, the
+		* text goes at the caret; otherwise it is appended to the draft. Returns
+		* false when no usable composer is present.
+		*/
+		function insertIntoComposer(text) {
+			const textarea = composerTextarea();
+			if (textarea === null) return false;
+			const value = textarea.value;
+			const atCaret = document.activeElement === textarea;
+			const start = atCaret ? textarea.selectionStart : value.length;
+			const end = atCaret ? textarea.selectionEnd : value.length;
+			const next = value.slice(0, start) + text + value.slice(end);
+			const setter = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, "value")?.set;
+			if (setter !== void 0) setter.call(textarea, next);
+			else textarea.value = next;
+			textarea.dispatchEvent(new Event("input", { bubbles: true }));
+			const caret = start + text.length;
+			requestAnimationFrame(() => {
+				try {
+					textarea.setSelectionRange(caret, caret);
+				} catch {}
+			});
+			return true;
+		}
+		/** Relative workspace path of `path` under `cwd` ('' when it IS the cwd). */
+		function relPathOf(path, cwd) {
+			if (cwd === void 0 || cwd.length === 0) return path;
+			const sep = cwd.includes("\\") ? "\\" : "/";
+			const prefix = cwd.endsWith("\\") || cwd.endsWith("/") ? cwd : cwd + sep;
+			const lowerPath = path.toLowerCase();
+			if (lowerPath.startsWith(prefix.toLowerCase())) return path.slice(prefix.length);
+			if (lowerPath === cwd.toLowerCase()) return "";
+			return path;
+		}
+		/**
+		* Resolve an @-mention path (workspace-relative or absolute) against the
+		* current workspace cwd; returns the absolute OS path, or undefined when the
+		* mention cannot be resolved (no cwd and the path is not absolute).
+		*/
+		function resolveMentionPath(mention) {
+			const absolute = /^[A-Za-z]:[\\/]/.test(mention) || mention.startsWith("/") || mention.startsWith("\\");
+			const { cwd } = getTabsState();
+			if (absolute) return mention;
+			if (cwd === void 0) return void 0;
+			const sep = cwd.includes("\\") ? "\\" : "/";
+			return cwd.endsWith("\\") || cwd.endsWith("/") ? cwd + mention : cwd + sep + mention;
+		}
+		/** Open an @-mention's file in the workbench preview (used by the linkifier). */
+		function openMention(mention) {
+			const abs = resolveMentionPath(mention);
+			if (abs === void 0) return;
+			openFile(abs);
+		}
+		//#endregion
 		//#region src/client/FileExplorer.tsx
 		/**
 		* File tree column, registered into the `explorer` slot declared by the
@@ -1039,6 +1159,19 @@ window.__ModuleLoader__.load({
 					window.removeEventListener("blur", onBlur);
 				};
 			}, [menu]);
+			(0, react.useEffect)(() => {
+				const onDocMouseDown = (e) => {
+					const target = e.target;
+					if (!(target instanceof Node)) return;
+					const tree = treeAreaRef.current;
+					if (tree !== null && tree.contains(target)) return;
+					const m = menuRef.current;
+					if (m !== null && m.contains(target)) return;
+					setSelected({});
+				};
+				document.addEventListener("mousedown", onDocMouseDown);
+				return () => document.removeEventListener("mousedown", onDocMouseDown);
+			}, []);
 			const treeRef = (0, react.useRef)({
 				root,
 				children,
@@ -1217,6 +1350,19 @@ window.__ModuleLoader__.load({
 					y: e.clientY
 				});
 			}, []);
+			/** Right-click anywhere else in the column (header, clipboard bar, blank tree space): folder menu for the cwd. */
+			const onColumnContextMenu = (0, react.useCallback)((e) => {
+				e.preventDefault();
+				const el = menuRef.current;
+				if (el !== null && e.target instanceof Node && el.contains(e.target)) return;
+				if (cwd === void 0) return;
+				setMenu({
+					kind: "blank",
+					path: cwd,
+					x: e.clientX,
+					y: e.clientY
+				});
+			}, [cwd]);
 			const runAction = (0, react.useCallback)((action) => {
 				setMenu(void 0);
 				action();
@@ -1565,9 +1711,10 @@ window.__ModuleLoader__.load({
 				const paths = selected[entry.path] !== void 0 ? Object.keys(selected) : [entry.path];
 				dragPathsRef.current = paths;
 				try {
-					e.dataTransfer.setData("text/plain", entry.path);
+					e.dataTransfer.setData("text/plain", paths.join("\n"));
+					e.dataTransfer.setData(DRAG_TYPE, JSON.stringify(paths));
 				} catch {}
-				e.dataTransfer.effectAllowed = "move";
+				e.dataTransfer.effectAllowed = "copyMove";
 			}, [selected]);
 			const onRowDragEnd = (0, react.useCallback)(() => {
 				dragPathsRef.current = null;
@@ -1646,6 +1793,30 @@ window.__ModuleLoader__.load({
 				if (entry.kind !== "file") return;
 				openPath(entry.path);
 			}, [openPath]);
+			/** Explorer-style "Select All": every visible (non-trash) entry at any depth. */
+			const selectAllEntries = (0, react.useCallback)(() => {
+				const all = {};
+				const collect = (entries) => {
+					for (const entry of entries) {
+						if (entry.name === TRASH_NAME) continue;
+						all[entry.path] = entry.kind;
+						if (entry.kind === "dir" && expanded.has(entry.path) && children[entry.path] !== void 0) collect(children[entry.path]);
+					}
+				};
+				const rootEntries = root !== void 0 ? children[root] : void 0;
+				if (rootEntries !== void 0) collect(rootEntries);
+				setSelected(all);
+			}, [
+				children,
+				expanded,
+				root
+			]);
+			/** Insert `@<relative-workspace-path>` into the composer (Claude Code-style mention). */
+			const onMention = (0, react.useCallback)((path) => {
+				const mention = relPathOf(path, cwd);
+				if (mention.length === 0) return;
+				insertIntoComposer(`@${mention} `);
+			}, [cwd]);
 			const onTreeKeyDown = (0, react.useCallback)((e) => {
 				const mod = e.ctrlKey || e.metaKey;
 				const key = e.key.toLowerCase();
@@ -1677,17 +1848,7 @@ window.__ModuleLoader__.load({
 				}
 				if (mod && key === "a") {
 					e.preventDefault();
-					const all = {};
-					const collect = (entries) => {
-						for (const entry of entries) {
-							if (entry.name === TRASH_NAME) continue;
-							all[entry.path] = entry.kind;
-							if (entry.kind === "dir" && expanded.has(entry.path) && children[entry.path] !== void 0) collect(children[entry.path]);
-						}
-					};
-					const rootEntries = root !== void 0 ? children[root] : void 0;
-					if (rootEntries !== void 0) collect(rootEntries);
-					setSelected(all);
+					selectAllEntries();
 					return;
 				}
 				if (mod && key === "z" && !e.shiftKey) {
@@ -1708,13 +1869,11 @@ window.__ModuleLoader__.load({
 				}
 			}, [
 				cancelCut,
-				children,
 				clipboard.items.length,
 				deleteSelection,
-				expanded,
 				onPaste,
 				performUndo,
-				root,
+				selectAllEntries,
 				selectedItems,
 				undoEntries.length
 			]);
@@ -1785,9 +1944,13 @@ window.__ModuleLoader__.load({
 				} : {
 					label: t("menu.delete"),
 					danger: true,
-					onClick: () => onDelete(m.path, m.kind)
+					onClick: () => onDelete(m.path, m.kind === "blank" ? "dir" : m.kind)
 				};
 				if (m.kind === "file") return [
+					{
+						label: t("menu.atFile"),
+						onClick: () => onMention(m.path)
+					},
 					{
 						label: t("menu.open"),
 						onClick: () => openFile(m.path)
@@ -1868,6 +2031,51 @@ window.__ModuleLoader__.load({
 					},
 					deleteItem
 				];
+				if (m.kind === "blank") {
+					const dirPath = m.path;
+					return [
+						{
+							label: t("menu.newFile"),
+							onClick: () => onNewFile(dirPath)
+						},
+						{
+							label: t("menu.newFolder"),
+							onClick: () => onNewFolder(dirPath)
+						},
+						{
+							label: t("menu.paste"),
+							disabled: clipboard.items.length === 0,
+							onClick: () => void onPaste()
+						},
+						"divider",
+						{
+							label: t("menu.selectAll"),
+							onClick: selectAllEntries
+						},
+						{
+							label: t("menu.undo"),
+							disabled: undoEntries.length === 0,
+							onClick: () => void performUndo()
+						},
+						"divider",
+						{
+							label: t("menu.copyPath"),
+							onClick: () => onCopyPath(dirPath)
+						},
+						{
+							label: t("menu.revealInExplorer"),
+							onClick: () => onReveal(dirPath, "dir")
+						},
+						{
+							label: t("menu.openSystem"),
+							onClick: () => void openPath(dirPath)
+						},
+						{
+							label: t("menu.refresh"),
+							onClick: () => refreshDir(dirPath)
+						}
+					];
+				}
 				return [{
 					label: t("menu.paste"),
 					disabled: clipboard.items.length === 0,
@@ -1879,6 +2087,7 @@ window.__ModuleLoader__.load({
 				style: { width: width > 0 ? width : void 0 },
 				"data-pane": "explorer",
 				"data-fe-theme": theme,
+				onContextMenu: onColumnContextMenu,
 				children: [
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: files_module_css_default.header,
@@ -1947,7 +2156,7 @@ window.__ModuleLoader__.load({
 						className: files_module_css_default.treeArea,
 						onKeyDown: onTreeKeyDown,
 						onClick: (e) => {
-							if (e.target === e.currentTarget) setSelected({});
+							if (e.target.closest("[role=\"treeitem\"]") === null) setSelected({});
 						},
 						onDragOver: (e) => {
 							if (dragPathsRef.current === null) return;
@@ -1977,6 +2186,10 @@ window.__ModuleLoader__.load({
 						ref: menuRef,
 						className: files_module_css_default.contextMenu,
 						role: "menu",
+						onContextMenu: (e) => {
+							e.preventDefault();
+							e.stopPropagation();
+						},
 						style: menuPos !== void 0 ? {
 							left: menuPos.x,
 							top: menuPos.y
@@ -15677,6 +15890,7 @@ window.__ModuleLoader__.load({
 			"tab.expand": "弹出文件详情",
 			"tab.diskChanged": "文件已在磁盘上被修改，点击重新加载（会放弃未保存的编辑）",
 			"menu.open": "打开预览",
+			"menu.atFile": "@ 在消息中引用",
 			"menu.newFile": "新建文件",
 			"menu.newFolder": "新建文件夹",
 			"menu.rename": "重命名",
@@ -15689,6 +15903,8 @@ window.__ModuleLoader__.load({
 			"menu.openSystem": "在系统中打开",
 			"menu.revealInExplorer": "在资源管理器打开",
 			"menu.deleteSelected": "删除选中的 {count} 项",
+			"menu.selectAll": "全选",
+			"menu.undo": "撤销",
 			"action.undo": "撤销（Ctrl+Z）",
 			"undo.copy": "复制「{name}」",
 			"undo.move": "移动「{name}」",
@@ -15732,6 +15948,7 @@ window.__ModuleLoader__.load({
 			"tab.expand": "Expand file details",
 			"tab.diskChanged": "File changed on disk — click to reload (discards unsaved edits)",
 			"menu.open": "Open preview",
+			"menu.atFile": "@ Mention in message",
 			"menu.newFile": "New File",
 			"menu.newFolder": "New Folder",
 			"menu.rename": "Rename",
@@ -15744,6 +15961,8 @@ window.__ModuleLoader__.load({
 			"menu.openSystem": "Open in System",
 			"menu.revealInExplorer": "Reveal in Explorer",
 			"menu.deleteSelected": "Delete {count} selected item(s)",
+			"menu.selectAll": "Select All",
+			"menu.undo": "Undo",
 			"action.undo": "Undo (Ctrl+Z)",
 			"undo.copy": "Copy \"{name}\"",
 			"undo.move": "Move \"{name}\"",
@@ -15772,6 +15991,211 @@ window.__ModuleLoader__.load({
 			"preview.mdRenderOff": "Large file: source view (still editable)"
 		};
 		//#endregion
+		//#region src/client/mentions.ts
+		/**
+		* @-mention linkifier for the conversation.
+		*
+		* The workbench inserts `@<relative-workspace-path>` into the composer (menu
+		* gesture "在消息中引用"), and this module makes the mention VISIBLE as a
+		* hyperlink once the message is rendered: any `@` followed by a token that
+		* matches the mention grammar is wrapped in an anchor, and clicking it opens
+		* the file in the workbench preview.
+		*
+		* Grammar (anything else stays plain text with no special meaning):
+		*   - `@` must sit at a token boundary (start of text, whitespace, or
+		*     punctuation like `（(` `，,` `。.` quotes and brackets) — so `user@x`,
+		*     `a.b@c` and URLs never match;
+		*   - the token is the longest run of non-whitespace, non-`@` characters,
+		*     with trailing sentence punctuation trimmed (`.。 ,， ;； :： !！ ?？ )）`…);
+		*   - the remaining token must be a RELATIVE path (never drive-absolute or
+		*     leading-slash), and path-shaped: either contains a `/` or `\` directory
+		*     separator, or is a single segment ending in a file extension.
+		*
+		* Scanning mirrors the table-zoom enhancer: a MutationObserver on
+		* `document.body`, rAF-coalesced, walks the text nodes of every
+		* `[data-conversation-scroll]` subtree and skips protected containers
+		* (code blocks, existing links, aria-hidden overlays like the composer
+		* mirror/backdrop, the composer seat, popups, and the workbench column).
+		*/
+		/** Mention pattern: `@` + token (no whitespace, no embedded `@`). */
+		const MENTION_RE = /@([^\s@]+)/g;
+		/** Trailing characters trimmed from a mention token before validation. */
+		const TRAILING = /* @__PURE__ */ new Set([
+			".",
+			",",
+			";",
+			":",
+			"!",
+			"?",
+			"。",
+			"，",
+			"；",
+			"：",
+			"！",
+			"？",
+			")",
+			"）",
+			"]",
+			"】",
+			"}",
+			"》",
+			"」",
+			"』",
+			"\"",
+			"'"
+		]);
+		/** Characters that may legally precede `@` in a mention (start/whitespace/punctuation). */
+		function isBoundaryBefore(ch) {
+			if (ch === void 0) return true;
+			return /[\s(（[【「『"'`、，。；：！？,.!?:;>\])}）]/.test(ch);
+		}
+		/** Whether `token` (already trailing-trimmed) matches the relative-path grammar. */
+		function isMentionToken(token) {
+			if (token.length === 0) return false;
+			if (/[。，、；：！？（）、【】「」『』《》]/.test(token)) return false;
+			if (/^[A-Za-z]:[\\/]/.test(token)) return false;
+			if (token.startsWith("/") || token.startsWith("\\")) return false;
+			if (token.startsWith("..")) return false;
+			if (token.includes("/") || token.includes("\\")) return true;
+			return /^[^\\/]+\.[A-Za-z0-9_][A-Za-z0-9._~+-]*$/.test(token);
+		}
+		/** Trim trailing sentence punctuation from a raw mention token. */
+		function trimMentionToken(raw) {
+			let token = raw;
+			while (token.length > 0 && TRAILING.has(token[token.length - 1])) token = token.slice(0, -1);
+			return token;
+		}
+		/**
+		* Extract every valid mention from `text` as [start, end, mention] ranges.
+		* `end` covers `@` + the TRIMMED token (trailing punctuation stays outside the
+		* link). Pure and testable: the DOM walk uses it and then splits the text node.
+		*/
+		function findMentions(text) {
+			const hits = [];
+			MENTION_RE.lastIndex = 0;
+			let match;
+			while ((match = MENTION_RE.exec(text)) !== null) {
+				const at = match.index;
+				const raw = match[1];
+				if (!isBoundaryBefore(at > 0 ? text[at - 1] : void 0)) continue;
+				const token = trimMentionToken(raw);
+				if (!isMentionToken(token)) continue;
+				hits.push({
+					start: at,
+					end: at + 1 + token.length,
+					mention: token
+				});
+			}
+			return hits;
+		}
+		/** Containers whose text is never linkified (code, existing links, overlays). */
+		const SKIP_SELECTOR = [
+			"code",
+			"pre",
+			"a",
+			"script",
+			"style",
+			"textarea",
+			"[data-composer-seat]",
+			"[data-input-mirror]",
+			"[data-input-backdrop]",
+			"[data-pane=\"explorer\"]",
+			"[aria-hidden=\"true\"]",
+			".dstz-popup",
+			".dshpick-lightbox",
+			"[data-wb-mention]"
+		].join(",");
+		/** Walk the text nodes of one conversation scroll container and linkify. */
+		function linkifyRoot(root) {
+			const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
+			const toCheck = [];
+			let node = walker.nextNode();
+			while (node !== null) {
+				if (node.parentElement !== null && node.parentElement.closest(SKIP_SELECTOR) === null) toCheck.push(node);
+				node = walker.nextNode();
+			}
+			for (const textNode of toCheck) linkifyTextNode(textNode);
+		}
+		/** Wrap every mention in one text node; returns true when anything changed. */
+		function linkifyTextNode(node) {
+			const text = node.data;
+			const hits = findMentions(text);
+			if (hits.length === 0) return false;
+			const frag = document.createDocumentFragment();
+			let cursor = 0;
+			for (const hit of hits) {
+				if (hit.start > cursor) frag.appendChild(document.createTextNode(text.slice(cursor, hit.start)));
+				const anchor = document.createElement("a");
+				anchor.className = "dswb-mention";
+				anchor.dataset.wbMention = hit.mention;
+				anchor.textContent = text.slice(hit.start, hit.end);
+				anchor.title = `@${hit.mention}`;
+				frag.appendChild(anchor);
+				cursor = hit.end;
+			}
+			if (cursor < text.length) frag.appendChild(document.createTextNode(text.slice(cursor)));
+			node.parentNode?.replaceChild(frag, node);
+			return true;
+		}
+		/** Style tag guard (the bundle may re-apply on HMR). */
+		let styleInstalled = false;
+		const MENTION_CSS = [".dswb-mention{color:var(--dsw-alias-state-business-primary);text-decoration:underline;text-underline-offset:2px;cursor:pointer;border-radius:4px;padding:0 1px}", ".dswb-mention:hover{background:var(--dsw-alias-interactive-bg-hover)}"].join("");
+		function installStyle() {
+			if (styleInstalled || typeof document === "undefined") return;
+			styleInstalled = true;
+			const tagId = "dsh-plugin-workbench/mention.module.css";
+			if (document.querySelector(`style[data-plugin-css=${JSON.stringify(tagId)}]`) === null) {
+				const tag = document.createElement("style");
+				tag.dataset.plugin = "dsh-plugin-workbench";
+				tag.dataset.pluginCss = tagId;
+				tag.textContent = MENTION_CSS;
+				document.head.appendChild(tag);
+			}
+		}
+		/** Click handler: open the mentioned file in the workbench preview. */
+		function onDocumentClick(e) {
+			const target = e.target;
+			if (!(target instanceof Element)) return;
+			const anchor = target.closest("a.dswb-mention");
+			if (anchor === null) return;
+			const mention = anchor.getAttribute("data-wb-mention");
+			if (mention === null) return;
+			e.preventDefault();
+			e.stopPropagation();
+			openMention(mention);
+		}
+		/** One-time install guard (HMR re-applies must not double-observe). */
+		let linkifierInstalled = false;
+		/** Start the linkifier: initial scan + MutationObserver with rAF coalescing. */
+		function installMentionLinkifier() {
+			if (typeof document === "undefined" || typeof MutationObserver === "undefined") return () => void 0;
+			if (linkifierInstalled) return () => void 0;
+			linkifierInstalled = true;
+			installStyle();
+			document.addEventListener("click", onDocumentClick);
+			let pending = false;
+			const scan = () => {
+				pending = false;
+				for (const root of document.querySelectorAll("[data-conversation-scroll]")) linkifyRoot(root);
+			};
+			const observer = new MutationObserver(() => {
+				if (pending) return;
+				pending = true;
+				requestAnimationFrame(scan);
+			});
+			observer.observe(document.body, {
+				childList: true,
+				subtree: true,
+				characterData: true
+			});
+			scan();
+			return () => {
+				observer.disconnect();
+				document.removeEventListener("click", onDocumentClick);
+				linkifierInstalled = false;
+			};
+		}
+		//#endregion
 		//#region src/client/index.ts
 		const CHANNEL = "/dsh-plugin-files";
 		/** Required client services (sequencing only — data reads use global hooks). */
@@ -15787,6 +16211,8 @@ window.__ModuleLoader__.load({
 				zh,
 				en
 			}), "files-explorer: dictionaries");
+			installComposerDrops();
+			ctx.effect(() => installMentionLinkifier(), "files-explorer: @mention linkifier");
 			const listDir = (path, signal) => unwrap(ctx.connection.rpc.call(CHANNEL, "list", { path }, signal));
 			const readFile = (path, signal) => unwrap(ctx.connection.rpc.call(CHANNEL, "read", { path }, signal));
 			const writeFile = (path, content, signal) => unwrap(ctx.connection.rpc.call(CHANNEL, "write", {