dsh-vscode-mode 0.1.30 → 0.1.32

package/src/perfPatch.ts

@@ -0,0 +1,76 @@
+/**
+ * dsh-vscode-mode host — profile patch 压缩调优（文本行级，零 YAML 依赖）。
+ * 在 ~/.dsh/profiles/<profile>/cordis.patch.yml 末尾追加/移除一段带标记注释的
+ * id 定向覆盖块（compaction-basic / tool-result-pruner 更低阈值）。
+ * 纯文本函数可单测：幂等追加、整段移除、无块原样返回。
+ * 作者 ddj 2026-09-02
+ */
+
+/** 性能块起始标记注释（文件内唯一锚点）。 */
+export const PERF_MARK_START = '# dsh-vscode-mode perf tuning (start)'
+/** 性能块结束标记注释。 */
+export const PERF_MARK_END = '# dsh-vscode-mode perf tuning (end)'
+
+/**
+ * 建议的压缩调优 YAML 块（顶层 loader patch 条目，id 定向覆盖）。
+ * - compaction-basic：thresholdRatio 0.8→0.6、retainRatio 0.16→0.12（更早触发压缩）；
+ * - tool-result-pruner：thresholdChars 8192→4096、head/tail 同步收窄（大 tool result 提前截断）。
+ * 注意：压缩只降低模型可见上下文压力，不重写已持久化会话日志（append-only）。
+ * @author ddj 2026年09月02号
+ * @returns 带前后标记注释与尾换行的 YAML 块
+ */
+export function perfConfigBlock(): string {
+  return [
+    PERF_MARK_START,
+    '# 更早触发会话内压缩：降低模型可见上下文压力（仅影响后续轮次，不缩小已持久化日志）。',
+    '- id: compaction-basic',
+    '  config:',
+    '    thresholdRatio: 0.6',
+    '    retainRatio: 0.12',
+    '- id: tool-result-pruner',
+    '  config:',
+    '    thresholdChars: 4096',
+    '    headChars: 2048',
+    '    tailChars: 512',
+    PERF_MARK_END,
+    '',
+  ].join('\n')
+}
+
+/** 当前文本是否已包含性能块。 */
+export function patchHasPerfConfig(text: string): boolean {
+  return text.includes(PERF_MARK_START)
+}
+
+/**
+ * 移除性能块（起止标记注释之间的整段，含所在行），无块时原样返回。
+ * 移除后压缩多余空行、确保以单个换行结尾。
+ * @author ddj 2026年09月02号
+ * @param text 原 patch 文本
+ * @returns 移除后的文本
+ */
+export function patchRemovePerfConfig(text: string): string {
+  const start = text.indexOf(PERF_MARK_START)
+  if (start === -1) return text
+  const end = text.indexOf(PERF_MARK_END, start)
+  const lineStart = text.lastIndexOf('\n', start - 1) + 1
+  if (end === -1) return text.slice(0, lineStart).replace(/\n+$/, '\n')
+  const after = (() => {
+    const nl = text.indexOf('\n', end)
+    return nl === -1 ? text.length : nl + 1
+  })()
+  const removed = (text.slice(0, lineStart) + text.slice(after)).replace(/\n{3,}/g, '\n\n')
+  return removed.replace(/\n+$/, '\n')
+}
+
+/**
+ * 幂等追加性能块：已有块先整段移除再追加到文件末尾（保证全文件只有一份、位置固定）。
+ * @author ddj 2026年09月02号
+ * @param text 原 patch 文本
+ * @returns 追加后的文本
+ */
+export function patchInsertPerfConfig(text: string): string {
+  const base = patchRemovePerfConfig(text)
+  const trimmed = base.replace(/\n+$/, '')
+  return trimmed + '\n' + perfConfigBlock()
+}

package/src/routes.ts

@@ -4,12 +4,12 @@
  * 作者 ddj 2026-08-20
  */
 import { readFile, stat } from 'node:fs/promises'
-import { dirname, extname, join, normalize, resolve, sep } from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { extname, join, normalize, resolve, sep } from 'node:path'
 import { ROUTE_PREFIX, noteOwnRoute, resetOwnRoutes, routeConflict } from './compat.js'
 import { RPC_PATH } from './shared/rpc.js'
 import type { RpcMethod, RpcRequestMap } from './shared/rpc.js'
 import type { Ctx } from './store.js'
+import { VENDOR_PREFIX, imageDirOf, vendorDirOf } from './paths.js'
 
 const IMG_ROUTES = [
   { url: '/edrv/assets/compare-idle.png', file: 'compare_idle.png' },
@@ -17,7 +17,6 @@ const IMG_ROUTES = [
 ]
 
 /** Monaco AMD 构建静态资源（随包发布，离线可用；前缀路由 /edrv/vendor/*）。 */
-const VENDOR_PREFIX = '/edrv/vendor'
 const VENDOR_MIME: Record<string, string> = {
   '.js': 'text/javascript; charset=utf-8',
   '.css': 'text/css; charset=utf-8',
@@ -35,15 +34,11 @@ const VENDOR_MIME: Record<string, string> = {
   '.md': 'text/markdown',
 }
 
-/** 图标目录：默认插件包内 assets/（随包发布）；config.imageDir 可覆盖（用于自定义换图）。 */
-function imageDirOf(config: unknown): string {
-  const cfg = config as { imageDir?: unknown } | undefined
-  if (cfg && typeof cfg.imageDir === 'string' && cfg.imageDir) return cfg.imageDir.replace(/\\/g, '/')
-  return join(dirname(fileURLToPath(import.meta.url)), '..', 'assets')
-}
+/** 图标目录（paths.ts 统一解析：config.imageDir 覆盖优先，否则插件包 assets/）。 */
+const imgDirOf = (config: unknown): string => imageDirOf(config, import.meta.url)
 
-/** Monaco AMD 静态目录（随包发布）。 */
-const vendorDir = join(dirname(fileURLToPath(import.meta.url)), '..', 'assets', 'vendor')
+/** Monaco AMD 静态目录（随包发布，paths.ts 统一解析）。 */
+const vendorDir = vendorDirOf(import.meta.url)
 
 /**
  * 注册全部 webServer 路由（带兼容护栏：前缀冲突预警 + 注册失败降级跳过）。
@@ -59,7 +54,7 @@ export function registerRoutes(
   handleRpc: <M extends RpcMethod>(method: M, args: RpcRequestMap[M]) => Promise<unknown>,
   onWarning?: (warning: string) => void,
 ): void {
-  const imgDir = imageDirOf(config)
+  const imgDir = imgDirOf(config)
   const web = ctx.get('webServer')
   if (!web) return
 

package/src/rpc.ts

@@ -18,6 +18,8 @@ import {
   resolveTarget,
   saveBucket,
 } from './store.js'
+import { mkdir, readFile, rm, writeFile, readdir } from 'node:fs/promises'
+import { basename, join } from 'node:path'
 import { archiveEntryFor, markDecision, recordResolved, reconstructOriginal } from './model.js'
 import type { Registry } from './registry.js'
 import { bucketOf, cwdOf, sessionOf } from './registry.js'
@@ -30,9 +32,13 @@ import { listMcp, refreshMcp, removeMcp, saveMcp, toggleMcp } from './mcp.js'
 import { listProjects, projectRefresh, projectRemove, projectSave, projectToggle } from './mcpProject.js'
 import { normalizeFileOpenTool, FILE_OPEN_DEFAULT, FILE_OPEN_SETTINGS_NS } from './fileOpenSettings.js'
 import { buildReport } from './compat.js'
-import { readDevForm, setDevForm } from './devForm.js'
-import { normalizeRel, toTreeEntries } from './tree.js'
+import { findProfileDir, readDevForm, setDevForm } from './devForm.js'
+import { normalizeRel } from './tree.js'
+import { invalidateIndex, listDirCached } from './treeIndex.js'
 import { revealInExplorer } from './reveal.js'
+import { DEBUG_LOG, debugLogFile, dshHome, pluginLogRoot } from './paths.js'
+import { markActiveSessions, moveOutSessions, planMoveOut, purgeArchive, restoreSession, scanSessionInventory, sessionsArchiveRoot, sessionSizeOf, sidecarSummaryOf } from './perf.js'
+import { patchHasPerfConfig, patchInsertPerfConfig, patchRemovePerfConfig, perfConfigBlock } from './perfPatch.js'
 
 /** cwd → 内存缓冲：行数组 + 累计字节数 + 待触发 flush 定时器（攒批落盘，避免每条日志全文件读改写）。 */
 const debugBuffers = new Map<string, { lines: string[]; len: number; timer: ReturnType<typeof setTimeout> | null }>()
@@ -52,13 +58,12 @@ const STALE_CHECK_MIN_MS = 10_000
 /**
  * 调试日志入队：先攒内存缓冲（行 + 字节数），满 DEBUG_BUF_CAP 立即落盘，
  * 否则空闲 DEBUG_FLUSH_IDLE_MS 后落盘；落盘 = 读旧文件 + 追加整批 + 超限截断 + 一次写入。
- * @author ddj 2026年08月26号
+ * @author ddj 2026年08月26号 / 2026年09月01号
  * @param ctx DSH 上下文
- * @param cwd 工作区（日志文件按工作区旁车存放）
- * @param policy 会话沙箱策略（入队时刻捕获）
+ * @param cwd 工作区（日志按 cwd hash 存 ~/.dsh/dsh-vscode-mode/logs/）
  * @param line 单条日志文本（不含换行）
  */
-function enqueueDebug(ctx: Ctx, cwd: string, policy: unknown, line: string): void {
+function enqueueDebug(ctx: Ctx, cwd: string, line: string): void {
   const st = debugBuffers.get(cwd) ?? { lines: [], len: 0, timer: null }
   st.lines.push(line)
   st.len += line.length
@@ -67,7 +72,7 @@ function enqueueDebug(ctx: Ctx, cwd: string, policy: unknown, line: string): voi
     const batch = st.lines
     st.lines = []
     st.len = 0
-    void flushDebug(ctx, cwd, policy, batch)
+    void flushDebug(cwd, batch)
   }
   if (st.len >= DEBUG_BUF_CAP) {
     if (st.timer) clearTimeout(st.timer)
@@ -78,26 +83,31 @@ function enqueueDebug(ctx: Ctx, cwd: string, policy: unknown, line: string): voi
   debugBuffers.set(cwd, st)
 }
 
+/** cwd → 已清理旧工作区 debug 日志标记（一次性）。 */
+const debugLegacyCleaned = new Set<string>()
+
 /**
  * 批量落盘一条 debug 日志缓冲：读旧文件 → 追加 → 超上限截断保留尾部 → 一次写回。
  * 串行链保证同一 cwd 的读改写不交错丢行；写失败静默忽略（调试日志不阻塞业务）。
- * @author ddj 2026年08月26号
- * @param ctx DSH 上下文
- * @param cwd 工作区
- * @param policy 会话沙箱策略（enqueue 时刻捕获）
+ * @author ddj 2026年08月26号 / 2026年09月01号
+ * @param cwd 工作区（日志落 ~/.dsh/dsh-vscode-mode/logs/debug.<cwdHash>.log）
  * @param batch 本批日志行
  */
-function flushDebug(ctx: Ctx, cwd: string, policy: unknown, batch: string[]): Promise<void> {
+function flushDebug(cwd: string, batch: string[]): Promise<void> {
   const prev = debugWriteQueues.get(cwd) ?? Promise.resolve()
   const task = prev.then(async () => {
     try {
-      const fs = ctx.get('fs')
-      if (!fs) return
-      const target = await fs.resolve('.dsh-edit-review-debug.log', { cwd })
-      const old = await fs.readText(target).catch(() => '')
+      await mkdir(pluginLogRoot(), { recursive: true })
+      const target = debugLogFile(cwd)
+      const old = await readFile(target, 'utf8').catch(() => '')
       const appended = old + batch.map((l) => new Date().toISOString() + ' ' + l + '\n').join('')
       const next = appended.length > DEBUG_LOG_CAP ? appended.slice(-Math.floor(DEBUG_LOG_CAP / 2)) : appended
-      await fs.writeText(target, next, void 0, void 0, policy)
+      await writeFile(target, next, 'utf8')
+      // 迁移后一次性清理旧工作区 debug 日志（best-effort）
+      if (!debugLegacyCleaned.has(cwd)) {
+        debugLegacyCleaned.add(cwd)
+        await rm(join(cwd, DEBUG_LOG), { force: true }).catch(() => {})
+      }
     } catch (e) { /* 写日志失败忽略 */ }
   })
   debugWriteQueues.set(cwd, task)
@@ -183,6 +193,28 @@ async function applyDecisions(
   return results
 }
 
+/** 当前活跃会话 id 集合（live sessions，用于移出/恢复护栏）。 */
+function activeSessionIds(ctx: Ctx): Set<string> {
+  const sessions = ctx.get('sessions')
+  if (!sessions || typeof sessions.list !== 'function') return new Set()
+  return new Set((sessions.list() as Session[]).map((s) => s.id).filter(Boolean))
+}
+
+/** profile patch 文件定位（依赖本插件的 profile，同 devForm）。 */
+async function patchFileInfo(): Promise<{ profileDir?: string; patchPath?: string }> {
+  const profileDir = findProfileDir()
+  if (!profileDir) return {}
+  return { profileDir, patchPath: join(profileDir, 'cordis.patch.yml') }
+}
+
+/** 最新一次压缩配置备份文件名（cordis.patch.yml.bak-<ts>，按名倒序取新）。 */
+async function latestPatchBackup(patchPath: string): Promise<string | undefined> {
+  const dir = join(patchPath, '..')
+  const base = basename(patchPath)
+  const names = await readdir(dir).catch(() => [])
+  return names.filter((n) => n.startsWith(base + '.bak-')).sort().reverse()[0]
+}
+
 /** 各方法 handler 表（类型由 shared/rpc 的 RpcHandlerMap 约束）。 */
 export function buildHandlers(ctx: Ctx, registry: Registry, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx)): RpcHandlerMap {
   return {
@@ -285,6 +317,8 @@ export function buildHandlers(ctx: Ctx, registry: Registry, searcher = newSearch
       try {
         const target = await resolveTarget(ctx, sc.session, args.path)
         await fs.writeText(target, args.content, void 0, void 0, policyOf(ctx, sc.session))
+        // 手动保存后目录树可能变化（新建/删除文件）：父目录+祖先进失效，后台自愈。
+        invalidateIndex(ctx, sc.cwd, args.path)
         const bucket = await bucketOf(registry, ctx, sc.cwd)
         let changed = false
         for (const rec of bucket.values()) {
@@ -372,7 +406,7 @@ export function buildHandlers(ctx: Ctx, registry: Registry, searcher = newSearch
       const sc = await requireSession(ctx, args.sessionId)
       if ('err' in sc) return { ok: false, error: sc.err }
       const text = String(args.text ?? '')
-      enqueueDebug(ctx, sc.cwd, policyOf(ctx, sc.session), text)
+      enqueueDebug(ctx, sc.cwd, text)
       console.error('[edrv-debug] ' + text)
       return { ok: true }
     },
@@ -407,24 +441,15 @@ export function buildHandlers(ctx: Ctx, registry: Registry, searcher = newSearch
       }
     },
     'edrv.listDir': async (args) => {
-      // 目录树（侧边栏文件管理用）：按会话 cwd 解析，与 edrv.read 同基准，树内相对路径点开即打开。
+      // 目录树（侧边栏文件管理用）：树索引命中直出（内存，0 IO）；失效/force 时
+      // 走快路径（resolve + listDirCheap + putIndex）；同路径在途请求去重复用。
       const sc = await requireSession(ctx, args.sessionId)
       if ('err' in sc) return { ok: false, error: sc.err }
-      const fs = ctx.get('fs')
-      if (!fs) return { ok: false, error: '缺少 fs' }
-      try {
-        const rel = normalizeRel(args.path)
-        if (rel === null) return { ok: false, error: '路径不合法' }
-        const target = await resolveTarget(ctx, sc.session, rel || '.')
-        const info = await fs.stat(target)
-        if (!info) return { ok: false, error: '目录不存在' }
-        if (info.type !== 'directory') return { ok: false, error: '不是目录' }
-        const children = await fs.listDir(target)
-        const root = fs.processPath(await fs.resolve('.', { cwd: sc.cwd }))
-        return { ok: true, root, path: rel, entries: toTreeEntries(rel, children) }
-      } catch (error) {
-        return { ok: false, error: '读取目录失败：' + String(error) }
-      }
+      const rel = normalizeRel(args.path)
+      if (rel === null) return { ok: false, error: '路径不合法' }
+      const res = await listDirCached(ctx, sc.cwd, rel, args.force === true)
+      if ('error' in res) return { ok: false, error: res.error }
+      return { ok: true, root: res.root, path: rel, entries: res.entries }
     },
     'edrv.revealInExplorer': async (args) => {
       // 在 OS 文件浏览器中打开/定位路径（树行/编辑器右键菜单用），相对工作区解析。
@@ -511,6 +536,120 @@ export function buildHandlers(ctx: Ctx, registry: Registry, searcher = newSearch
         return { ok: false, error: String(error) }
       }
     },
+    'edrv.perf.inventory': async () => {
+      try {
+        const home = dshHome()
+        const inventory = await scanSessionInventory(home, sessionsArchiveRoot(home))
+        const active = activeSessionIds(ctx)
+        markActiveSessions(inventory.sessions, active)
+        return { ok: true, ...inventory, activeIds: [...active] }
+      } catch (error) {
+        return { ok: false, error: '盘点失败：' + String(error) }
+      }
+    },
+    'edrv.perf.sessionSize': async (args) => {
+      try {
+        const size = await sessionSizeOf(dshHome(), args.cwd, args.sessionId ?? '')
+        return { ok: true, ...size }
+      } catch (error) {
+        return { ok: false, error: '读取会话体积失败：' + String(error) }
+      }
+    },
+    'edrv.perf.movePlan': async (args) => {
+      try {
+        const home = dshHome()
+        const inventory = await scanSessionInventory(home, sessionsArchiveRoot(home))
+        markActiveSessions(inventory.sessions, activeSessionIds(ctx))
+        const plan = planMoveOut(inventory, { workspaceKey: args.workspaceKey, sessionIds: args.sessionIds, minBytes: args.minBytes, olderThanDays: args.olderThanDays })
+        return { ok: true, ...plan }
+      } catch (error) {
+        return { ok: false, error: '移出规划失败：' + String(error) }
+      }
+    },
+    'edrv.perf.moveOut': async (args) => {
+      try {
+        const home = dshHome()
+        const items = (args.sessionIds ?? []).map((sessionId) => ({ workspaceKey: args.workspaceKey, sessionId, bytes: 0 }))
+        const result = await moveOutSessions(home, sessionsArchiveRoot(home), items, activeSessionIds(ctx), args.dryRun === true)
+        return { ok: true, ...result }
+      } catch (error) {
+        return { ok: false, error: '移出失败：' + String(error) }
+      }
+    },
+    'edrv.perf.restore': async (args) => {
+      try {
+        const result = await restoreSession(dshHome(), sessionsArchiveRoot(dshHome()), args.workspaceKey, args.sessionId)
+        return result.ok ? { ok: true, restored: true } : { ok: false, error: result.error ?? '恢复失败' }
+      } catch (error) {
+        return { ok: false, error: '恢复失败：' + String(error) }
+      }
+    },
+    'edrv.perf.purgeArchive': async (args) => {
+      try {
+        const result = await purgeArchive(sessionsArchiveRoot(dshHome()), args.olderThanDays)
+        return { ok: true, ...result }
+      } catch (error) {
+        return { ok: false, error: '清除失败：' + String(error) }
+      }
+    },
+    'edrv.perf.sidecarSummary': async (args) => {
+      const sc = await requireSession(ctx, args.sessionId)
+      const cwd = 'err' in sc ? null : sc.cwd
+      try {
+        const summary = await sidecarSummaryOf(ctx, cwd)
+        return { ok: true, ...summary }
+      } catch (error) {
+        return { ok: false, error: '读取侧车摘要失败：' + String(error) }
+      }
+    },
+    'edrv.perf.configGet': async () => {
+      try {
+        const { profileDir, patchPath } = await patchFileInfo()
+        const block = perfConfigBlock()
+        if (!patchPath) return { ok: true, applied: false, block }
+        const text = await readFile(patchPath, 'utf8').catch(() => '')
+        const backup = await latestPatchBackup(patchPath)
+        return { ok: true, profileDir, patchPath, applied: patchHasPerfConfig(text), block, backup }
+      } catch (error) {
+        return { ok: false, error: '读取压缩配置失败：' + String(error) }
+      }
+    },
+    'edrv.perf.configApply': async () => {
+      try {
+        const { patchPath } = await patchFileInfo()
+        if (!patchPath) return { ok: false, error: '未找到依赖本插件的 profile（检查 DSH_HOME/profiles）' }
+        const text = await readFile(patchPath, 'utf8').catch(() => '')
+        const backup = patchPath + '.bak-' + Date.now()
+        if (text) await writeFile(backup, text, 'utf8')
+        await mkdir(join(patchPath, '..'), { recursive: true })
+        await writeFile(patchPath, patchInsertPerfConfig(text), 'utf8')
+        return { ok: true, applied: true, backup, restart: true }
+      } catch (error) {
+        return { ok: false, error: '写入压缩配置失败：' + String(error) }
+      }
+    },
+    'edrv.perf.configUndo': async () => {
+      try {
+        const { patchPath } = await patchFileInfo()
+        if (!patchPath) return { ok: false, error: '未找到依赖本插件的 profile（检查 DSH_HOME/profiles）' }
+        const backup = await latestPatchBackup(patchPath)
+        if (backup) {
+          const backupPath = join(join(patchPath, '..'), backup)
+          const saved = await readFile(backupPath, 'utf8').catch(() => null)
+          if (saved !== null) {
+            await writeFile(patchPath, saved, 'utf8')
+            await rm(backupPath, { force: true }).catch(() => {})
+            return { ok: true, restored: true, backup }
+          }
+        }
+        const text = await readFile(patchPath, 'utf8').catch(() => '')
+        if (!patchHasPerfConfig(text)) return { ok: false, error: '没有可撤销的压缩配置' }
+        await writeFile(patchPath, patchRemovePerfConfig(text), 'utf8')
+        return { ok: true, restored: true }
+      } catch (error) {
+        return { ok: false, error: '撤销压缩配置失败：' + String(error) }
+      }
+    },
   }
 }
 

package/src/search/content.ts

@@ -6,7 +6,7 @@
  */
 import type { Ctx, Session } from '../store.js'
 import { pathText } from './query.js'
-import { EXCLUDES, FILE_EXCLUDES, ripgrepPath, searchRoot } from './ripgrep.js'
+import { EXCLUDES, FILE_EXCLUDES, readStderr, rgExitFailure, ripgrepPath, searchRoot } from './ripgrep.js'
 import { SearchCache } from './orchestrator.js'
 import type { ContentMatch, ContentSearchInput, ContentSearchProvider, ContentSearchResult } from './types.js'
 
@@ -47,7 +47,7 @@ export interface ContentSearchRequest {
   exclude?: string[]
 }
 
-type ContentSearchResponse = { matches: ContentMatch[]; truncated: boolean }
+type ContentSearchResponse = { matches: ContentMatch[]; truncated: boolean; warning?: string }
 
 /**
  * 把行内字节偏移转成 UTF-16 列（1-based；越界钳到行尾）。
@@ -181,7 +181,7 @@ export function contentArgv(binary: string, root: string, input: ContentSearchIn
  * @returns 有界内容搜索结果
  */
 export async function searchRipgrepContent(input: ContentSearchInput): Promise<ContentSearchResult> {
-  const sub = input.ctx.get('subprocess') as { spawn(spec: unknown): { done: Promise<{ exitCode: number | null; code?: number | null }>; collected?: { stdout?: { readFrom(offset: number): { text: string; lossy?: boolean } } } } } | undefined
+  const sub = input.ctx.get('subprocess') as { spawn(spec: unknown): { done: Promise<{ exitCode: number | null; code?: number | null }>; collected?: { stdout?: { readFrom(offset: number): { text: string; lossy?: boolean } }; stderr?: { readFrom(offset: number): { text: string } } } } } | undefined
   if (!sub) throw new Error('缺少 subprocess')
   const binary = ripgrepPath()
   if (!binary) throw new Error('ripgrep 不可用')
@@ -200,7 +200,8 @@ export async function searchRipgrepContent(input: ContentSearchInput): Promise<C
     throw new Error('ripgrep 启动失败：' + String(error))
   }
   const code = outcome.exitCode ?? outcome.code
-  if (code !== 0 && code !== 1) throw new Error('ripgrep 退出码：' + String(code))
+  const failure = code !== 0 && code !== 1 ? rgExitFailure(code, readStderr(handle).text) : null
+  if (failure && failure.kind !== 'partial') throw new Error(failure.message)
   const reader = handle.collected?.stdout
   if (!reader) throw new Error('ripgrep stdout 不可用')
   const output = reader.readFrom(0)
@@ -208,7 +209,13 @@ export async function searchRipgrepContent(input: ContentSearchInput): Promise<C
   const maxMatches = Math.max(1, Math.min(input.maxResults ?? DEFAULT_MAX_MATCHES, DEFAULT_MAX_MATCHES))
   const capped = applyCaps(all, maxMatches, DEFAULT_MAX_FILES)
   const truncated = Boolean(output.lossy) || capped.truncated
-  return { ...capped, complete: !truncated, source: 'ripgrep' }
+  const result: ContentSearchResult = { ...capped, complete: !truncated, source: 'ripgrep' }
+  // 遍历错误（退出码 2）：rg 已输出的命中仍有效，保留结果、标记不完整并附部分结果提示
+  if (failure) {
+    result.complete = false
+    result.warning = failure.message
+  }
+  return result
 }
 
 /**
@@ -251,7 +258,7 @@ export class ContentSearcher {
     const excludeKey = (request.exclude ?? []).join(',')
     const key = [rootKey, query, request.matchCase ? 'mc' : '', request.wholeWord ? 'ww' : '', request.regex ? 'rx' : '', includeKey, excludeKey, PROVIDER_VERSION].join('|')
     const cached = this.cache.get(key)
-    if (cached) return { matches: cached.matches, truncated: cached.truncated }
+    if (cached) return { matches: cached.matches, truncated: cached.truncated, warning: cached.warning }
     this.inflight.get(root)?.abort()
     const controller = new AbortController()
     this.inflight.set(root, controller)
@@ -272,7 +279,7 @@ export class ContentSearcher {
       })
       if (controller.signal.aborted) return { matches: [], truncated: false }
       this.cache.set(key, result)
-      return { matches: result.matches, truncated: result.truncated }
+      return { matches: result.matches, truncated: result.truncated, warning: result.warning }
     } catch (error) {
       if (controller.signal.aborted) return { matches: [], truncated: false }
       throw error

package/src/search/ripgrep.ts

@@ -112,6 +112,53 @@ export function parseOutput(handle: SearchHandle, maxResults: number): { files:
   return { files: unique.slice(0, maxResults).map(pathText), truncated, complete: !truncated }
 }
 
+/**
+ * 读取已收集的 stderr（无收集器 → 空文本）。
+ * @author ddj 2026年08月27号
+ * @param handle subprocess handle
+ * @returns stderr 文本
+ */
+export function readStderr(handle: SearchHandle): { text: string } {
+  const reader = handle.collected?.stderr
+  return reader ? reader.readFrom(0) : { text: '' }
+}
+
+/**
+ * 取 stderr 首条非空行（去 \r，截断 300 字符防撑爆 UI）。
+ * @author ddj 2026年08月27号
+ * @param text stderr 全文
+ * @returns 首条诊断行（无则空串）
+ */
+export function firstStderrLine(text: string): string {
+  for (const raw of String(text ?? '').split(/\r?\n/)) {
+    const line = raw.trim()
+    if (!line) continue
+    return line.length > 300 ? line.slice(0, 300) + '…' : line
+  }
+  return ''
+}
+
+/**
+ * 分类 rg 非 0/1 退出：pattern=模式错误（正则/glob 无效，无结果），
+ * partial=遍历错误（rg 已输出的命中仍有效，结果不完整），hard=硬失败（其他退出码/超时被杀）。
+ * @author ddj 2026年08月27号
+ * @param code 退出码（null/undefined = 被终止，通常为 20s 超时）
+ * @param stderrText stderr 全文
+ * @returns 分类与中文提示文案（partial 的 message 即 warning 内容）
+ */
+export function rgExitFailure(code: number | null | undefined, stderrText: string): { kind: 'pattern' | 'partial' | 'hard'; message: string } {
+  const detail = firstStderrLine(stderrText)
+  if (/regex parse error/i.test(detail)) return { kind: 'pattern', message: '正则表达式无效：' + detail }
+  if (/error parsing glob/i.test(detail)) return { kind: 'pattern', message: '文件过滤模式无效：' + detail }
+  if (code === 2) {
+    const count = String(stderrText ?? '').split(/\r?\n/).filter((line) => line.trim()).length
+    const suffix = count > 1 ? '（共 ' + count + ' 处）' : ''
+    return { kind: 'partial', message: (detail ? '部分路径无法访问，结果可能不完整：' + detail + suffix : '部分路径无法访问，结果可能不完整') }
+  }
+  if (code === null || code === undefined) return { kind: 'hard', message: '搜索超时（20 秒内未完成，已终止）' }
+  return { kind: 'hard', message: 'ripgrep 退出码：' + String(code) + (detail ? '（' + detail + '）' : '') }
+}
+
 /**
  * 使用打包 ripgrep 搜索工作区文件。
  * @author ddj 2026年08月24号
@@ -143,7 +190,13 @@ export async function searchRipgrep(input: WorkspaceSearchInput): Promise<Worksp
     throw new Error('ripgrep 启动失败：' + String(error))
   }
   const code = outcome.exitCode ?? outcome.code
-  if (code !== 0 && code !== 1) throw new Error('ripgrep 退出码：' + String(code))
+  if (code !== 0 && code !== 1) {
+    const failure = rgExitFailure(code, readStderr(handle).text)
+    if (failure.kind !== 'partial') throw new Error(failure.message)
+    // 遍历错误：已收集的文件列表仍有效，保留并标记不完整（warning 供上层展示，编排层丢弃不抛错）
+    const parsed = parseOutput(handle, input.maxResults)
+    return { ...parsed, warning: failure.message, complete: false, source: 'ripgrep' }
+  }
   const parsed = parseOutput(handle, input.maxResults)
   if (!handle.collected?.stdout) throw new Error('ripgrep stdout 不可用')
   return { ...parsed, source: 'ripgrep' }

package/src/search/types.ts

@@ -22,6 +22,8 @@ export interface WorkspaceSearchResult {
   truncated: boolean
   complete: boolean
   source: SearchSource
+  /** rg 遍历错误（退出码 2）时的部分结果提示；无则缺省。 */
+  warning?: string
 }
 
 export interface WorkspaceSearchProvider {
@@ -73,12 +75,13 @@ export interface ContentSearchInput {
   root?: string
 }
 
-/** 内容搜索输出：扁平命中列表 + 截断标志。 */
+/** 内容搜索输出：扁平命中列表 + 截断标志（warning = rg 遍历错误时的部分结果提示）。 */
 export interface ContentSearchResult {
   matches: ContentMatch[]
   truncated: boolean
   complete: boolean
   source: SearchSource
+  warning?: string
 }
 
 /** 内容搜索 provider（rg JSON 主路径；无 fallback，失败抛错由调用方处理）。 */