@civilization/dsh-workspace-files 0.2.0 → 0.3.1

package/lib/index.js

@@ -1,82 +1,119 @@
+import { exec, spawn } from "node:child_process";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import Schema from "@deepseek-ai/schemastery";
 import { promises } from "node:fs";
-import { join, relative, resolve } from "node:path";
 //#region src/files.ts
 const DEFAULT_IGNORED_DIRS = /* @__PURE__ */ new Set([
 	".git",
 	".svn",
 	".hg",
 	"node_modules",
+	".pnpm-store",
 	".turbo",
 	".next",
+	".nuxt",
+	".output",
 	"dist",
 	"build",
-	".pnpm-store"
+	"out",
+	".cache",
+	".idea",
+	".vscode",
+	".husky",
+	"venv",
+	".venv",
+	"env",
+	"__pycache__",
+	"target",
+	".gradle",
+	".cargo",
+	"vendor",
+	"coverage",
+	"tmp",
+	"temp",
+	"logs",
+	".dsh"
 ]);
 function isWithin(parent, child) {
 	const rel = relative(parent, child);
 	return !rel.startsWith("..") && !rel.includes(":");
 }
+async function loadGitIgnoreNames(rootDir) {
+	const names = /* @__PURE__ */ new Set();
+	try {
+		const gitignorePath = join(rootDir, ".gitignore");
+		const content = await promises.readFile(gitignorePath, "utf8");
+		for (const rawLine of content.split(/\r?\n/)) {
+			const line = rawLine.trim();
+			if (!line || line.startsWith("#") || line.startsWith("!")) continue;
+			const clean = line.replace(/^\/+/, "").replace(/\/+$/, "");
+			if (clean && !clean.includes("*") && !clean.includes("?") && !clean.includes("/")) names.add(clean);
+		}
+	} catch {}
+	return names;
+}
 async function scanWorkspaceTree(cwd, options = {}) {
 	const root = resolve(cwd);
-	const maxDepth = options.maxDepth ?? 8;
+	const maxDepth = options.maxDepth ?? 16;
 	const showHidden = options.showHidden ?? false;
 	const showIgnored = options.showIgnored ?? false;
+	const gitIgnoredNames = showIgnored ? /* @__PURE__ */ new Set() : await loadGitIgnoreNames(root);
 	let totalFiles = 0;
 	let totalDirs = 0;
+	let totalNodes = 0;
+	const MAX_NODES_SAFETY_LIMIT = 3e4;
 	async function walk(dirPath, currentDepth) {
-		if (currentDepth > maxDepth) return [];
+		if (currentDepth > maxDepth || totalNodes >= MAX_NODES_SAFETY_LIMIT) return [];
 		let dirents;
 		try {
 			dirents = await promises.readdir(dirPath, { withFileTypes: true });
 		} catch {
 			return [];
 		}
-		dirents.sort((a, b) => {
-			if (a.isDirectory() && !b.isDirectory()) return -1;
-			if (!a.isDirectory() && b.isDirectory()) return 1;
-			return a.name.localeCompare(b.name, void 0, {
-				numeric: true,
-				sensitivity: "base"
-			});
-		});
-		const items = [];
+		const dirTasks = [];
+		const fileItems = [];
 		for (const ent of dirents) {
+			if (totalNodes >= MAX_NODES_SAFETY_LIMIT) break;
 			const name = ent.name;
 			if (!showHidden && name.startsWith(".") && name !== ".gitignore" && name !== ".env") {
 				if (!showIgnored) continue;
 			}
-			if (!showIgnored && ent.isDirectory() && DEFAULT_IGNORED_DIRS.has(name)) continue;
+			if (!showIgnored) {
+				if (ent.isDirectory() && DEFAULT_IGNORED_DIRS.has(name)) continue;
+				if (gitIgnoredNames.has(name)) continue;
+			}
 			const fullPath = join(dirPath, name);
 			if (!isWithin(root, fullPath)) continue;
 			const relPath = relative(root, fullPath).replace(/\\/g, "/");
 			if (ent.isDirectory()) {
 				totalDirs += 1;
-				const children = await walk(fullPath, currentDepth + 1);
-				items.push({
+				totalNodes += 1;
+				dirTasks.push(walk(fullPath, currentDepth + 1).then((children) => ({
 					name,
 					path: relPath,
 					isDirectory: true,
 					children
-				});
+				})));
 			} else {
 				totalFiles += 1;
-				let size;
-				let mtime;
-				try {
-					const st = await promises.stat(fullPath);
-					size = st.size;
-					mtime = st.mtimeMs;
-				} catch {}
-				items.push({
+				totalNodes += 1;
+				fileItems.push({
 					name,
 					path: relPath,
-					isDirectory: false,
-					size,
-					mtime
+					isDirectory: false
 				});
 			}
 		}
-		return items;
+		const validDirs = (await Promise.all(dirTasks)).filter((d) => d !== null);
+		validDirs.sort((a, b) => a.name.localeCompare(b.name, void 0, {
+			numeric: true,
+			sensitivity: "base"
+		}));
+		fileItems.sort((a, b) => a.name.localeCompare(b.name, void 0, {
+			numeric: true,
+			sensitivity: "base"
+		}));
+		return [...validDirs, ...fileItems];
 	}
 	return {
 		root,
@@ -89,6 +126,10 @@ async function scanWorkspaceTree(cwd, options = {}) {
 //#region src/index.ts
 const name = "@civilization/dsh-workspace-files";
 const inject = ["webServer"];
+const Config = Schema.object({
+	maxDepth: Schema.natural().min(1).max(100).default(16).description("工作区文件树扫描的最大文件夹深度（层级）"),
+	showHidden: Schema.boolean().default(false).description("默认是否显示以点开头的隐藏文件")
+}).description("工作区文件：浏览与检索工作区文件树");
 async function readJsonBody(req) {
 	if (req.body && typeof req.body === "object") return req.body;
 	if (typeof req.body === "string" && req.body.trim()) try {
@@ -149,7 +190,28 @@ function resolveCwd(ctx, body) {
 	} catch {}
 	return process.cwd();
 }
-function apply(ctx) {
+const SETTINGS_NS = "workspace-files";
+const scanCache = /* @__PURE__ */ new Map();
+const CACHE_TTL_MS = 2e4;
+function apply(ctx, config = {}) {
+	const liveConfig = {
+		maxDepth: typeof config?.maxDepth === "number" && config.maxDepth > 0 ? config.maxDepth : 16,
+		showHidden: Boolean(config?.showHidden)
+	};
+	if (ctx.inject) ctx.inject(["settings"], (scopedCtx) => {
+		try {
+			const scope = scopedCtx.settings?.register(SETTINGS_NS, Config, { base: liveConfig });
+			const applyChange = () => {
+				const current = scope?.get?.();
+				if (typeof current?.maxDepth === "number") liveConfig.maxDepth = current.maxDepth;
+				if (typeof current?.showHidden === "boolean") liveConfig.showHidden = current.showHidden;
+			};
+			applyChange();
+			scope?.watch?.(applyChange);
+		} catch (err) {
+			console.warn("[dsh-workspace-files] failed to register settings scope:", err);
+		}
+	});
 	const webServer = ctx.webServer;
 	if (!webServer) return;
 	const handleRpc = async (req, res, prefix) => {
@@ -162,6 +224,83 @@ function apply(ctx) {
 		}
 		const pathname = new URL(req.url ?? "/", "http://dsh.internal").pathname;
 		const method = pathname.startsWith(prefix) ? pathname.slice(prefix.length) : void 0;
+		if (method === "config.get") {
+			writeJson(res, 200, {
+				ok: true,
+				value: liveConfig
+			});
+			return;
+		}
+		if (method === "config.set") {
+			try {
+				const body = await readJsonBody(req);
+				if (typeof body.maxDepth === "number" && body.maxDepth > 0) liveConfig.maxDepth = body.maxDepth;
+				if (typeof body.showHidden === "boolean") liveConfig.showHidden = body.showHidden;
+				writeJson(res, 200, {
+					ok: true,
+					value: liveConfig
+				});
+			} catch (err) {
+				writeJson(res, 500, {
+					ok: false,
+					error: { message: err?.message || String(err) }
+				});
+			}
+			return;
+		}
+		if (method === "files.open") {
+			try {
+				const body = await readJsonBody(req);
+				const cwd = resolveCwd(ctx, body);
+				const rawPath = String(body.path || "");
+				if (!rawPath) {
+					writeJson(res, 400, {
+						ok: false,
+						error: { message: "Missing path parameter" }
+					});
+					return;
+				}
+				const fullPath = isAbsolute(rawPath) ? rawPath : resolve(cwd, rawPath);
+				const action = body.action || "reveal";
+				const isDirectory = Boolean(body.isDirectory);
+				if (process.platform === "win32") {
+					const winPath = fullPath.replace(/\//g, "\\");
+					if (action === "reveal") {
+						if (isDirectory) spawn("explorer.exe", [winPath], {
+							detached: true,
+							stdio: "ignore"
+						}).unref();
+						else spawn("explorer.exe", [`/select,${winPath}`], {
+							detached: true,
+							stdio: "ignore"
+						}).unref();
+					} else exec(`start "" "${winPath.replace(/"/g, "\\\"")}"`, { windowsHide: true });
+				} else if (process.platform === "darwin") {
+					if (action === "reveal") spawn("open", [isDirectory ? fullPath : "-R", fullPath], {
+						detached: true,
+						stdio: "ignore"
+					}).unref();
+					else spawn("open", [fullPath], {
+						detached: true,
+						stdio: "ignore"
+					}).unref();
+				} else if (action === "reveal") spawn("xdg-open", [isDirectory ? fullPath : resolve(fullPath, "..")], {
+					detached: true,
+					stdio: "ignore"
+				}).unref();
+				else spawn("xdg-open", [fullPath], {
+					detached: true,
+					stdio: "ignore"
+				}).unref();
+				writeJson(res, 200, { ok: true });
+			} catch (err) {
+				writeJson(res, 500, {
+					ok: false,
+					error: { message: err?.message || String(err) }
+				});
+			}
+			return;
+		}
 		if (method !== "files.tree") {
 			writeJson(res, 404, {
 				ok: false,
@@ -171,13 +310,36 @@ function apply(ctx) {
 		}
 		try {
 			const body = await readJsonBody(req);
+			const cwd = resolveCwd(ctx, body);
+			const showHidden = typeof body.showHidden === "boolean" ? body.showHidden : liveConfig.showHidden;
+			const showIgnored = Boolean(body.showIgnored);
+			const maxDepth = typeof body.maxDepth === "number" && body.maxDepth > 0 ? body.maxDepth : liveConfig.maxDepth;
+			const forceRefresh = Boolean(body.forceRefresh);
+			const cacheKey = `${cwd}::${showHidden}::${showIgnored}::${maxDepth}`;
+			const now = Date.now();
+			if (!forceRefresh) {
+				const cached = scanCache.get(cacheKey);
+				if (cached && now - cached.timestamp < CACHE_TTL_MS) {
+					writeJson(res, 200, {
+						ok: true,
+						value: cached.result,
+						cached: true
+					});
+					return;
+				}
+			}
+			const result = await scanWorkspaceTree(cwd, {
+				showHidden,
+				showIgnored,
+				maxDepth
+			});
+			scanCache.set(cacheKey, {
+				timestamp: now,
+				result
+			});
 			writeJson(res, 200, {
 				ok: true,
-				value: await scanWorkspaceTree(resolveCwd(ctx, body), {
-					showHidden: Boolean(body.showHidden),
-					showIgnored: Boolean(body.showIgnored),
-					maxDepth: typeof body.maxDepth === "number" ? body.maxDepth : 8
-				})
+				value: result
 			});
 		} catch (err) {
 			writeJson(res, 500, {
@@ -193,4 +355,4 @@ function apply(ctx) {
 	}), "dsh-workspace-files: /dsh-workspace-files/api routes");
 }
 //#endregion
-export { apply, inject, name };
+export { Config, SETTINGS_NS, apply, inject, name };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@civilization/dsh-workspace-files",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Enhanced workspace file tree explorer with fuzzy search and @-mention for DeepSeek Harness.",
   "type": "module",
   "main": "lib/index.js",
@@ -25,7 +25,10 @@
     },
     "client": {
       "platform": "web",
-      "inject": []
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins"
+      ]
     }
   },
   "scripts": {
@@ -33,6 +36,9 @@
     "dev": "tsdown --watch",
     "typecheck": "tsc --noEmit"
   },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "3.18.2"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",
     "react": ">=18.0.0"

package/src/client/icons.tsx

@@ -159,3 +159,30 @@ export function IconTree({ size = 13 }: { size?: number }): JSX.Element {
   )
 }
 
+export function IconChevronDown({ size = 14 }: { size?: number }): JSX.Element {
+  return (
+    <svg width={size} height={size} viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" style={{ display: 'inline-block', verticalAlign: 'middle', flexShrink: 0 }}>
+      <polyline points="4 6 8 10 12 6" />
+    </svg>
+  )
+}
+
+export function IconExplorer({ size = 12 }: { size?: number }): JSX.Element {
+  return (
+    <svg width={size} height={size} viewBox="0 0 16 16" fill="currentColor" style={{ display: 'inline-block', verticalAlign: 'middle', flexShrink: 0 }}>
+      <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" />
+    </svg>
+  )
+}
+
+export function IconExternalApp({ size = 12 }: { size?: number }): JSX.Element {
+  return (
+    <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 }}>
+      <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" />
+      <polyline points="10 2 14 2 14 6" />
+      <line x1="6.5" y1="9.5" x2="13.5" y2="2.5" />
+    </svg>
+  )
+}
+
+