@civilization/dsh-workspace-files 0.2.0 → 0.3.1

package/src/files.ts

@@ -17,16 +17,37 @@ export interface WorkspaceFilesResult {
   totalDirs: number
 }
 
+// 常见大型构建产物、虚拟环境、开发缓存与三方依赖黑名单目录
 const DEFAULT_IGNORED_DIRS = 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',      // Rust / Cargo / Maven
+  '.gradle',
+  '.cargo',
+  'vendor',      // PHP / Go
+  'coverage',
+  'tmp',
+  'temp',
+  'logs',
+  '.dsh',
 ])
 
 function isWithin(parent: string, child: string): boolean {
@@ -34,20 +55,42 @@ function isWithin(parent: string, child: string): boolean {
   return !rel.startsWith('..') && !rel.includes(':')
 }
 
+// 快速解析工作区根目录的 .gitignore，避免深入被 git 忽略的庞大目录
+async function loadGitIgnoreNames(rootDir: string): Promise<Set<string>> {
+  const names = new Set<string>()
+  try {
+    const gitignorePath = join(rootDir, '.gitignore')
+    const content = await fs.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
+}
+
 export async function scanWorkspaceTree(
   cwd: string,
   options: { maxDepth?: number; showHidden?: boolean; showIgnored?: boolean } = {},
 ): Promise<WorkspaceFilesResult> {
   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 ? new Set<string>() : await loadGitIgnoreNames(root)
+
   let totalFiles = 0
   let totalDirs = 0
+  let totalNodes = 0
+  const MAX_NODES_SAFETY_LIMIT = 30000 // 防爆保护阈值
 
   async function walk(dirPath: string, currentDepth: number): Promise<FileItem[]> {
-    if (currentDepth > maxDepth) return []
+    if (currentDepth > maxDepth || totalNodes >= MAX_NODES_SAFETY_LIMIT) return []
 
     let dirents: import('node:fs').Dirent[]
     try {
@@ -56,26 +99,23 @@ export async function scanWorkspaceTree(
       return []
     }
 
-    // Sort: directories first, then files alphabetically
-    dirents.sort((a, b) => {
-      if (a.isDirectory() && !b.isDirectory()) return -1
-      if (!a.isDirectory() && b.isDirectory()) return 1
-      return a.name.localeCompare(b.name, undefined, { numeric: true, sensitivity: 'base' })
-    })
-
-    const items: FileItem[] = []
+    const dirTasks: Array<Promise<FileItem | null>> = []
+    const fileItems: FileItem[] = []
 
     for (const ent of dirents) {
+      if (totalNodes >= MAX_NODES_SAFETY_LIMIT) break
+
       const name = ent.name
 
-      // Hidden file filter (starts with .)
+      // 隐藏文件/文件夹过滤（以 . 开头）
       if (!showHidden && name.startsWith('.') && name !== '.gitignore' && name !== '.env') {
         if (!showIgnored) continue
       }
 
-      // Ignored directory filter
-      if (!showIgnored && ent.isDirectory() && DEFAULT_IGNORED_DIRS.has(name)) {
-        continue
+      // 忽略目录及 .gitignore 规则过滤
+      if (!showIgnored) {
+        if (ent.isDirectory() && DEFAULT_IGNORED_DIRS.has(name)) continue
+        if (gitIgnoredNames.has(name)) continue
       }
 
       const fullPath = join(dirPath, name)
@@ -85,34 +125,35 @@ export async function scanWorkspaceTree(
 
       if (ent.isDirectory()) {
         totalDirs += 1
-        const children = await walk(fullPath, currentDepth + 1)
-        items.push({
-          name,
-          path: relPath,
-          isDirectory: true,
-          children,
-        })
+        totalNodes += 1
+        dirTasks.push(
+          walk(fullPath, currentDepth + 1).then(children => ({
+            name,
+            path: relPath,
+            isDirectory: true,
+            children,
+          })),
+        )
       } else {
         totalFiles += 1
-        let size: number | undefined
-        let mtime: number | undefined
-        try {
-          const st = await fs.stat(fullPath)
-          size = st.size
-          mtime = st.mtimeMs
-        } catch {}
-
-        items.push({
+        totalNodes += 1
+        fileItems.push({
           name,
           path: relPath,
           isDirectory: false,
-          size,
-          mtime,
         })
       }
     }
 
-    return items
+    // 并行处理子目录
+    const dirResults = await Promise.all(dirTasks)
+    const validDirs = dirResults.filter((d): d is FileItem => d !== null)
+
+    // 目录优先，按自然字母排序
+    validDirs.sort((a, b) => a.name.localeCompare(b.name, undefined, { numeric: true, sensitivity: 'base' }))
+    fileItems.sort((a, b) => a.name.localeCompare(b.name, undefined, { numeric: true, sensitivity: 'base' }))
+
+    return [...validDirs, ...fileItems]
   }
 
   const items = await walk(root, 1)

package/src/index.ts

@@ -1,9 +1,22 @@
+import { exec, spawn } from 'node:child_process'
+import { isAbsolute, resolve } from 'node:path'
 import type { Context } from '@deepseek-ai/cordis'
+import Schema from '@deepseek-ai/schemastery'
 import { scanWorkspaceTree } from './files.js'
 
 export const name = '@civilization/dsh-workspace-files'
 export const inject = ['webServer']
 
+export interface Config {
+  maxDepth?: number
+  showHidden?: boolean
+}
+
+export const Config: Schema<Config> = Schema.object({
+  maxDepth: Schema.natural().min(1).max(100).default(16).description('工作区文件树扫描的最大文件夹深度（层级）'),
+  showHidden: Schema.boolean().default(false).description('默认是否显示以点开头的隐藏文件'),
+}).description('工作区文件：浏览与检索工作区文件树')
+
 async function readJsonBody(req: any): Promise<Record<string, any>> {
   if (req.body && typeof req.body === 'object') {
     return req.body
@@ -79,7 +92,41 @@ function resolveCwd(ctx: Context, body: Record<string, any>): string {
   return process.cwd()
 }
 
-export function apply(ctx: Context): void {
+export const SETTINGS_NS = 'workspace-files'
+
+interface CacheEntry {
+  timestamp: number
+  result: any
+}
+const scanCache = new Map<string, CacheEntry>()
+const CACHE_TTL_MS = 20_000 // 20 秒热缓存
+
+export function apply(ctx: Context, config: Config = {}): void {
+  const liveConfig = {
+    maxDepth: typeof config?.maxDepth === 'number' && config.maxDepth > 0 ? config.maxDepth : 16,
+    showHidden: Boolean(config?.showHidden),
+  }
+
+  // 关键：向 Host 的 settings 服务注册 settings namespace，使设置面板的前端控制器能够枚举到此插件卡片
+  if ((ctx as any).inject) {
+    (ctx as any).inject(['settings'], (scopedCtx: any) => {
+      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 as any).webServer
   if (!webServer) return
 
@@ -92,6 +139,69 @@ export function apply(ctx: Context): void {
     const pathname = new URL(req.url ?? '/', 'http://dsh.internal').pathname
     const method = pathname.startsWith(prefix) ? pathname.slice(prefix.length) : undefined
 
+    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: any) {
+        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: any) {
+        writeJson(res, 500, { ok: false, error: { message: err?.message || String(err) } })
+      }
+      return
+    }
+
     if (method !== 'files.tree') {
       writeJson(res, 404, { ok: false, error: { message: `Unknown method: ${method}` } })
       return
@@ -100,11 +210,29 @@ export function apply(ctx: Context): void {
     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: Boolean(body.showHidden),
-        showIgnored: Boolean(body.showIgnored),
-        maxDepth: typeof body.maxDepth === 'number' ? body.maxDepth : 8,
+        showHidden,
+        showIgnored,
+        maxDepth,
       })
+
+      scanCache.set(cacheKey, { timestamp: now, result })
       writeJson(res, 200, { ok: true, value: result })
     } catch (err: any) {
       writeJson(res, 500, { ok: false, error: { message: err?.message || String(err) } })