@civilization/dsh-workspace-files 0.3.0 → 0.3.2

package/README.md

@@ -17,7 +17,12 @@ DeepSeek Harness (DSH) 原生增强型文件浏览器插件。
 - 🎯 **官方原生交互式 Tag 胶囊引用 (ReferenceChipNode)**：
   - 深度贯通会话输入框的 Lexical AST 引擎，点击 `@引用` 直接生成与官方敲 `@` 回车 100% 一模一样带图标的深色圆角 **Tag 胶囊卡片**（`[📁 folder/]` 与 `[📄 file]`）；
   - 智能消除用户光标前已键入的 `@` 字符，杜绝 `@@path` 冗余；文件与文件夹均支持一键引用。
-- 📂 **默认折叠与持久化展开记忆 (localStorage)**：
+- 📂 **在文件资源管理器中显示 (Reveal in Explorer)**：
+  - 悬浮在文件上点击，即刻在 Windows 资源管理器中打开并高亮选中该文件（`explorer.exe /select`）；
+  - 悬浮在目录上点击，直接在资源管理器中打开该文件夹，告别手动层层翻找目录的繁琐操作。
+- 🚀 **用系统默认应用打开 (Open with Default App)**：
+  - 悬浮在任意文件/目录上点击，直接调起系统默认程序打开；对于图片、音频、PDF、Office 文档等外部文件极为方便。
+- 📁 **默认折叠与持久化展开记忆 (localStorage)**：
   - 首次打开默认全部折叠关闭，清爽简洁；
   - 用户展开的每一个文件夹均按工作区独立持久化记忆，无论刷新页面还是切换会话再切回，均完美保持展开状态。
 - 📋 **快速复制相对路径**：支持一键复制文件/目录的相对工作区路径，方便在终端或配置中直接使用。

package/lib/client.js

@@ -265,6 +265,47 @@ window.__ModuleLoader__.load({
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("polyline", { points: "4 6 8 10 12 6" })
 			});
 		}
+		function IconExplorer({ size = 12 }) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+				width: size,
+				height: size,
+				viewBox: "0 0 16 16",
+				fill: "currentColor",
+				style: {
+					display: "inline-block",
+					verticalAlign: "middle",
+					flexShrink: 0
+				},
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M1.75 2A1.75 1.75 0 000 3.75v8.5C0 13.216.784 14 1.75 14h12.5A1.75 1.75 0 0016 12.25v-6.5A1.75 1.75 0 0014.25 4H7.5a.25.25 0 01-.2-.1l-.9-1.2C6.07 2.26 5.55 2 5 2H1.75zM1.5 5.5h13v6.75a.25.25 0 01-.25.25H1.75a.25.25 0 01-.25-.25V5.5z" })
+			});
+		}
+		function IconExternalApp({ size = 12 }) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+				width: size,
+				height: size,
+				viewBox: "0 0 16 16",
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: "1.35",
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				style: {
+					display: "inline-block",
+					verticalAlign: "middle",
+					flexShrink: 0
+				},
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M12.5 9.5v3.25a1.25 1.25 0 01-1.25 1.25H3.25A1.25 1.25 0 012 12.75V4.75A1.25 1.25 0 013.25 3.5H6.5" }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("polyline", { points: "10 2 14 2 14 6" }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("line", {
+						x1: "6.5",
+						y1: "9.5",
+						x2: "13.5",
+						y2: "2.5"
+					})
+				]
+			});
+		}
 		//#endregion
 		//#region src/client/index.tsx
 		const inject = ["slots", "sidebarRightTabs"];
@@ -327,23 +368,12 @@ window.__ModuleLoader__.load({
 					key: OFFICIAL_FILES_TAB_ID
 				}, WorkspaceFilesTabTitle)), "dsh-workspace-files: official tab title");
 			}
-			const registerSettingsCard = (targetCtx) => {
-				if (!targetCtx?.slots) return;
-				targetCtx.effect?.(() => targetCtx.slots.inject("settings.plugin.item", function* () {
-					yield targetCtx.slots.register({
-						name: "settings.plugin.item",
-						key: "workspace-files"
-					}, WorkspaceFilesSettingsCard);
-					yield targetCtx.slots.register({
-						name: "settings.plugin.item",
-						key: "@civilization/dsh-workspace-files"
-					}, WorkspaceFilesSettingsCard);
-				}), "dsh-workspace-files: settings card");
-			};
-			if (slots) registerSettingsCard(ctx);
-			if (ctx.inject) ctx.inject(["settingsScope"], (scoped) => {
-				registerSettingsCard(scoped);
-			});
+			if (slots) ctx.effect(() => slots.inject("settings.plugins.tab", () => slots.register({
+				name: "settings.plugins.tab",
+				id: "workspace-files",
+				order: 20,
+				label: () => "工作区文件"
+			}, WorkspaceFilesSettingsCard)), "dsh-workspace-files: settings card");
 		}
 		const CONFIG_STORAGE_KEY = "dsh_workspace_files_config";
 		function loadWorkspaceFilesConfig() {
@@ -644,9 +674,9 @@ window.__ModuleLoader__.load({
 						className: "dsh-wf-head-text",
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: "dsh-wf-name",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "工作区文件" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "工作区文件" }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 								className: "dsh-wf-version",
-								children: "v0.3.0"
+								children: ["v", "0.3.2"]
 							})]
 						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 							className: "dsh-wf-desc",
@@ -769,7 +799,7 @@ window.__ModuleLoader__.load({
 				window.addEventListener("dsh-workspace-files:config-change", handleCfgChange);
 				return () => window.removeEventListener("dsh-workspace-files:config-change", handleCfgChange);
 			}, []);
-			const loadTree = (0, react.useCallback)(async (quiet = false) => {
+			const loadTree = (0, react.useCallback)(async (quiet = false, forceRefresh = false) => {
 				if (!quiet) setLoading(true);
 				setError(null);
 				try {
@@ -777,7 +807,8 @@ window.__ModuleLoader__.load({
 						sessionId,
 						cwd,
 						showHidden,
-						maxDepth: activeConfig.maxDepth
+						maxDepth: activeConfig.maxDepth,
+						forceRefresh
 					});
 					setData(res);
 					setExpandedPaths((prev) => {
@@ -885,6 +916,44 @@ window.__ModuleLoader__.load({
 					else showToastMsg(`已复制引用: ${mentionText.trim()}`);
 				});
 			};
+			const handleRevealInExplorer = (e, item) => {
+				e.stopPropagation();
+				fetch("/dsh-workspace-files/api/files.open", {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({
+						action: "reveal",
+						path: item.path,
+						isDirectory: Boolean(item.isDirectory),
+						sessionId,
+						cwd
+					})
+				}).then((res) => res.json()).then((data) => {
+					if (data.ok) showToastMsg(`已在资源管理器中显示: ${item.name}`);
+					else showToastMsg(`打开失败: ${data.error?.message || "未知错误"}`);
+				}).catch((err) => {
+					showToastMsg(`请求失败: ${err?.message || String(err)}`);
+				});
+			};
+			const handleOpenDefaultApp = (e, item) => {
+				e.stopPropagation();
+				fetch("/dsh-workspace-files/api/files.open", {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({
+						action: "openDefault",
+						path: item.path,
+						isDirectory: Boolean(item.isDirectory),
+						sessionId,
+						cwd
+					})
+				}).then((res) => res.json()).then((data) => {
+					if (data.ok) showToastMsg(`已启动系统应用打开: ${item.name}`);
+					else showToastMsg(`打开失败: ${data.error?.message || "未知错误"}`);
+				}).catch((err) => {
+					showToastMsg(`请求失败: ${err?.message || String(err)}`);
+				});
+			};
 			const [searchViewMode, setSearchViewMode] = (0, react.useState)("flat");
 			const [searchExpandedPaths, setSearchExpandedPaths] = (0, react.useState)(() => /* @__PURE__ */ new Set());
 			const { filteredTreeItems, flatSearchResults } = (0, react.useMemo)(() => {
@@ -1044,7 +1113,7 @@ window.__ModuleLoader__.load({
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
 									className: "dsh-files-tool-btn",
-									onClick: () => void loadTree(true),
+									onClick: () => void loadTree(false, true),
 									disabled: loading,
 									title: "刷新文件树",
 									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconRefresh, { size: 13 })
@@ -1107,7 +1176,8 @@ window.__ModuleLoader__.load({
 									children: [
 										"找到 ",
 										flatSearchResults.length,
-										" 个匹配项"
+										" 个匹配项",
+										flatSearchResults.length > 150 ? "（展示前 150 项）" : ""
 									]
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 									type: "button",
@@ -1116,9 +1186,9 @@ window.__ModuleLoader__.load({
 									title: "切换为可折叠的树形视图",
 									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconTree, { size: 12 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "切为树形" })]
 								})]
-							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								className: "dsh-files-flat-list",
-								children: flatSearchResults.map(({ item, parentDir }) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								children: [flatSearchResults.slice(0, 150).map(({ item, parentDir }) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 									className: `dsh-files-flat-row ${item.isDirectory ? "is-directory" : ""}`,
 									onClick: () => {
 										if (item.isDirectory) handleJumpToFolderInTree(item.path);
@@ -1162,25 +1232,51 @@ window.__ModuleLoader__.load({
 										}),
 										/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 											className: "dsh-files-row-actions",
-											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-												type: "button",
-												className: "dsh-files-action-btn dsh-files-action-at",
-												onClick: (e) => handleMention(e, item),
-												title: `一键 @ 引用此${item.isDirectory ? "目录" : "文件"}到当前会话`,
-												children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconAt, { size: 13 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-													className: "dsh-files-action-at-text",
-													children: "@引用"
-												})]
-											}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-												type: "button",
-												className: "dsh-files-action-btn",
-												onClick: (e) => handleCopyPath(e, item.path),
-												title: "复制相对路径",
-												children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconCopy, { size: 12 })
-											})]
+											children: [
+												/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+													type: "button",
+													className: "dsh-files-action-btn dsh-files-action-at",
+													onClick: (e) => handleMention(e, item),
+													title: `一键 @ 引用此${item.isDirectory ? "目录" : "文件"}到当前会话`,
+													children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconAt, { size: 13 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+														className: "dsh-files-action-at-text",
+														children: "@引用"
+													})]
+												}),
+												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+													type: "button",
+													className: "dsh-files-action-btn",
+													onClick: (e) => handleRevealInExplorer(e, item),
+													title: `在文件资源管理器中显示此${item.isDirectory ? "目录" : "文件"}`,
+													children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconExplorer, { size: 12 })
+												}),
+												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+													type: "button",
+													className: "dsh-files-action-btn",
+													onClick: (e) => handleOpenDefaultApp(e, item),
+													title: `用系统默认应用打开此${item.isDirectory ? "目录" : "文件"}`,
+													children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconExternalApp, { size: 12 })
+												}),
+												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+													type: "button",
+													className: "dsh-files-action-btn",
+													onClick: (e) => handleCopyPath(e, item.path),
+													title: "复制相对路径",
+													children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconCopy, { size: 12 })
+												})
+											]
 										})
 									]
-								}, item.path))
+								}, item.path)), flatSearchResults.length > 150 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									style: {
+										padding: "10px 14px",
+										fontSize: 11,
+										textAlign: "center",
+										color: "var(--dsw-alias-label-tertiary, #8b93a1)",
+										borderTop: "1px dashed var(--dsw-alias-border-l2, #e5e7eb)"
+									},
+									children: "匹配项较多，已限制展示前 150 项以保证流畅度，请输入更详细关键字"
+								})]
 							})]
 						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: "dsh-files-tree",
@@ -1213,7 +1309,9 @@ window.__ModuleLoader__.load({
 								},
 								onOpenFile,
 								onMention: handleMention,
-								onCopyPath: handleCopyPath
+								onCopyPath: handleCopyPath,
+								onRevealInExplorer: handleRevealInExplorer,
+								onOpenDefaultApp: handleOpenDefaultApp
 							}, item.path))]
 						})
 					}),
@@ -1225,7 +1323,7 @@ window.__ModuleLoader__.load({
 			});
 		}
 		function FileTreeNode(props) {
-			const { item, depth, query, isSearchMode, expandedPaths, onToggleExpand, onOpenFile, onMention, onCopyPath } = props;
+			const { item, depth, query, isSearchMode, expandedPaths, onToggleExpand, onOpenFile, onMention, onCopyPath, onRevealInExplorer, onOpenDefaultApp } = props;
 			const isExpanded = expandedPaths.has(item.path);
 			if (item.isDirectory) {
 				const childCount = item.children?.length ?? 0;
@@ -1263,22 +1361,39 @@ window.__ModuleLoader__.load({
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								className: "dsh-files-row-actions",
-								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-									type: "button",
-									className: "dsh-files-action-btn dsh-files-action-at",
-									onClick: (e) => onMention(e, item),
-									title: "一键 @ 引用此目录到当前会话",
-									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconAt, { size: 13 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-										className: "dsh-files-action-at-text",
-										children: "@引用"
-									})]
-								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-									type: "button",
-									className: "dsh-files-action-btn",
-									onClick: (e) => onCopyPath(e, item.path),
-									title: "复制目录路径",
-									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconCopy, { size: 12 })
-								})]
+								children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+										type: "button",
+										className: "dsh-files-action-btn dsh-files-action-at",
+										onClick: (e) => onMention(e, item),
+										title: "一键 @ 引用此目录到当前会话",
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconAt, { size: 13 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "dsh-files-action-at-text",
+											children: "@引用"
+										})]
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dsh-files-action-btn",
+										onClick: (e) => onRevealInExplorer(e, item),
+										title: "在文件资源管理器中打开此目录",
+										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconExplorer, { size: 12 })
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dsh-files-action-btn",
+										onClick: (e) => onOpenDefaultApp(e, item),
+										title: "用系统默认应用打开此目录",
+										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconExternalApp, { size: 12 })
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dsh-files-action-btn",
+										onClick: (e) => onCopyPath(e, item.path),
+										title: "复制目录路径",
+										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconCopy, { size: 12 })
+									})
+								]
 							})
 						]
 					}), isExpanded && item.children && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -1292,7 +1407,9 @@ window.__ModuleLoader__.load({
 							onToggleExpand,
 							onOpenFile,
 							onMention,
-							onCopyPath
+							onCopyPath,
+							onRevealInExplorer,
+							onOpenDefaultApp
 						}, child.path))
 					})]
 				});
@@ -1322,22 +1439,39 @@ window.__ModuleLoader__.load({
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: "dsh-files-row-actions",
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-							type: "button",
-							className: "dsh-files-action-btn dsh-files-action-at",
-							onClick: (e) => onMention(e, item),
-							title: "一键 @ 引用此文件到当前会话",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconAt, { size: 13 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								className: "dsh-files-action-at-text",
-								children: "@引用"
-							})]
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-							type: "button",
-							className: "dsh-files-action-btn",
-							onClick: (e) => onCopyPath(e, item.path),
-							title: "复制相对路径",
-							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconCopy, { size: 12 })
-						})]
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+								type: "button",
+								className: "dsh-files-action-btn dsh-files-action-at",
+								onClick: (e) => onMention(e, item),
+								title: "一键 @ 引用此文件到当前会话",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconAt, { size: 13 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "dsh-files-action-at-text",
+									children: "@引用"
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dsh-files-action-btn",
+								onClick: (e) => onRevealInExplorer(e, item),
+								title: "在文件资源管理器中显示此文件",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconExplorer, { size: 12 })
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dsh-files-action-btn",
+								onClick: (e) => onOpenDefaultApp(e, item),
+								title: "用系统默认应用打开此文件",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconExternalApp, { size: 12 })
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dsh-files-action-btn",
+								onClick: (e) => onCopyPath(e, item.path),
+								title: "复制相对路径",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconCopy, { size: 12 })
+							})
+						]
 					})
 				]
 			});