dsh-vscode-mode 0.1.28 → 0.1.30

package/lib/index.js

@@ -106,11 +106,37 @@ async function refreshMcp(ctx, id) {
 	return serverOf(ctx, loader.resolve(entry.id));
 }
 //#endregion
+//#region src/shared/keybindings.ts
+/**
+* dsh-vscode-mode shared — 快捷键命令目录与默认键位（双面契约）。
+* 纯数据模块：host（settings schema 默认值）与 client（执行匹配/设置页）共用。
+* 键位格式：修饰符 + 主键，`+` 连接，如 `Ctrl+Shift+F`；空串 = 未绑定。
+* 作者 ddj 2026年08月26号
+*/
+/** 命令 id → 默认键位。命令目录以此为准，新增命令只需加一项。 */
+const KEYBINDING_DEFAULTS = {
+	"edrv.save": "Ctrl+S",
+	"edrv.quickOpen": "Ctrl+P",
+	"edrv.toggleSidebar": "Ctrl+B",
+	"edrv.searchInFiles": "Ctrl+Shift+F"
+};
+//#endregion
 //#region src/fileOpenSettings.ts
 const FILE_OPEN_SETTINGS_NS = "dsh-vscode-mode";
 const FILE_OPEN_DEFAULT = "auto";
 let depsPromise;
 /**
+* 按命令目录构建 keybindings 显式键形状（每键独立默认值）。
+* @author ddj 2026年08月26号
+* @param z schemastery 命名空间
+* @returns keybindings 字段形状
+*/
+function keybindingsShape(z) {
+	const shape = {};
+	for (const [id, chord] of Object.entries(KEYBINDING_DEFAULTS)) shape[id] = z.string().default(chord);
+	return shape;
+}
+/**
 * 动态加载设置依赖（模块级缓存；任一缺失返回 null 而非抛错）。
 * @author ddj 2026年08月24号
 * @returns 设置依赖或 null
@@ -142,7 +168,10 @@ function configValue(config) {
 async function installOpenSettingsSection(ctx, ns, entry, hooks, loader = loadSettingsDeps) {
 	const deps = await loader();
 	if (!deps) return false;
-	const schema = deps.z.object({ fileOpenTool: deps.z.string().default(FILE_OPEN_DEFAULT) });
+	const schema = deps.z.object({
+		fileOpenTool: deps.z.string().default(FILE_OPEN_DEFAULT),
+		keybindings: deps.z.object(keybindingsShape(deps.z)).default({ ...KEYBINDING_DEFAULTS })
+	});
 	deps.installSettingsSection(ctx, ns, schema, entry, hooks);
 	return true;
 }
@@ -1457,9 +1486,10 @@ function pathMatch(value, query) {
 * 通过独立 argv 调用打包 rg，避免先构建巨型全量文件数组。
 * 作者 ddj 2026年08月24号
 */
-const STDOUT_CAP = 4 << 20;
-const STDERR_CAP = 65536;
-const GRACE_MS = 2e4;
+const STDOUT_CAP$1 = 4 << 20;
+const STDERR_CAP$1 = 65536;
+const GRACE_MS$1 = 2e4;
+/** 默认排除目录（文件/内容搜索共用，导出供 provider 复用）。 */
 const EXCLUDES = [
 	"node_modules",
 	".git",
@@ -1469,7 +1499,22 @@ const EXCLUDES = [
 	"build",
 	"vendor",
 	"coverage",
-	"__pycache__"
+	"__pycache__",
+	".pnpm-store",
+	".npm-cache",
+	".codegraph",
+	".workbuddy"
+];
+/**
+* 默认排除文件（glob 模式，文件/内容搜索共用）。
+* 插件自身 sidecar（内容搜索会命中其历史编辑文本，且单行巨型 JSON 会撑爆输出上限）；
+* *.map 源映射（纯构建产物，内容搜索无意义且常为单行巨文件）。
+*/
+const FILE_EXCLUDES = [
+	"**/.dsh-edit-review.json",
+	"**/.dsh-edit-review-archive.json",
+	"**/.dsh-edit-review-debug.log",
+	"**/*.map"
 ];
 /**
 * 将 query 转成 rg 的字面 glob。
@@ -1556,16 +1601,17 @@ async function searchRipgrep(input) {
 		queryGlob(prepareQuery(input.query).text)
 	];
 	for (const excluded of EXCLUDES) argv.push("--glob", "!**/" + excluded + "/**");
+	for (const excluded of FILE_EXCLUDES) argv.push("--glob", "!" + excluded);
 	argv.push("--", root);
 	const handle = sub.spawn({
 		argv,
 		cwd: root,
 		stdio: {
 			stdin: "ignore",
-			stdout: { maxBytes: STDOUT_CAP },
-			stderr: { maxBytes: STDERR_CAP }
+			stdout: { maxBytes: STDOUT_CAP$1 },
+			stderr: { maxBytes: STDERR_CAP$1 }
 		},
-		graceMs: GRACE_MS,
+		graceMs: GRACE_MS$1,
 		signal: input.signal
 	});
 	let outcome;
@@ -1603,7 +1649,14 @@ const EXCLUDED = /* @__PURE__ */ new Set([
 	"build",
 	"vendor",
 	"coverage",
-	"__pycache__"
+	"__pycache__",
+	".pnpm-store",
+	".npm-cache",
+	".codegraph",
+	".workbuddy",
+	".dsh-edit-review.json",
+	".dsh-edit-review-archive.json",
+	".dsh-edit-review-debug.log"
 ]);
 /**
 * 在一个目录树中递归查找匹配文件。
@@ -1710,16 +1763,25 @@ function rankCandidates(candidates, query) {
 const CACHE_TTL = 6e4;
 const CACHE_LIMIT = 100;
 const RESULT_LIMIT = 50;
-const PROVIDER_VERSION = "ripgrep-v1";
+const PROVIDER_VERSION$1 = "ripgrep-v1";
 const POLICY_VERSION = "search-policy-v1";
 /**
-* 短期有界搜索缓存。
+* 短期有界搜索缓存（泛型：文件/内容搜索共用；clone 由调用方保证写隔离）。
 * @author ddj 2026年08月24号
-* @returns 缓存对象
+* @param clone 结果写隔离克隆（缺省恒等）
 */
 var SearchCache = class {
+	clone;
 	entries = /* @__PURE__ */ new Map();
 	/**
+	* 创建缓存。
+	* @author ddj 2026年08月24号
+	* @param clone 结果克隆函数（缺省直接引用）
+	*/
+	constructor(clone = (value) => value) {
+		this.clone = clone;
+	}
+	/**
 	* 读取未过期条目。
 	* @author ddj 2026年08月24号
 	* @param key 缓存 key
@@ -1735,10 +1797,7 @@ var SearchCache = class {
 		}
 		this.entries.delete(key);
 		this.entries.set(key, entry);
-		return {
-			...entry.result,
-			files: [...entry.result.files]
-		};
+		return this.clone(entry.result);
 	}
 	/**
 	* 写入成功 provider 结果。
@@ -1751,10 +1810,7 @@ var SearchCache = class {
 		this.entries.delete(key);
 		this.entries.set(key, {
 			at: now,
-			result: {
-				...result,
-				files: [...result.files]
-			}
+			result: this.clone(result)
 		});
 		while (this.entries.size > CACHE_LIMIT) this.entries.delete(this.entries.keys().next().value);
 	}
@@ -1841,7 +1897,10 @@ function mergeCandidates(result, activePaths, root, query) {
 */
 var SearchOrchestrator = class {
 	ctx;
-	cache = new SearchCache();
+	cache = new SearchCache((r) => ({
+		...r,
+		files: [...r.files]
+	}));
 	inflight = /* @__PURE__ */ new Map();
 	rootsByCwd = /* @__PURE__ */ new Map();
 	provider;
@@ -1887,7 +1946,7 @@ var SearchOrchestrator = class {
 			rootKey,
 			query.text,
 			policyVersion(this.ctx, request.session),
-			PROVIDER_VERSION
+			PROVIDER_VERSION$1
 		].join("|");
 		const cached = this.cache.get(key);
 		if (cached) return this.finish(cached, request.activePaths, root, query);
@@ -2004,6 +2063,331 @@ function newSearcher(ctx) {
 	return new SearchOrchestrator(ctx);
 }
 //#endregion
+//#region src/search/content.ts
+const STDOUT_CAP = 16 << 20;
+const STDERR_CAP = 65536;
+const GRACE_MS = 2e4;
+const DEFAULT_MAX_MATCHES = 500;
+const DEFAULT_MAX_FILES = 100;
+const PROVIDER_VERSION = "content-ripgrep-v1";
+/** 单行 JSON 记录上限：巨型单行文件（源映射/打包产物）的命中行对搜索 UI 无意义，直接跳过。 */
+const MAX_RECORD_LINE = 1 << 20;
+/**
+* 把行内字节偏移转成 UTF-16 列（1-based；越界钳到行尾）。
+* @author ddj 2026年08月26号
+* @param text 行文本
+* @param byteOffset 行内字节偏移（rg submatches.start/end，实测为行相对）
+* @returns 1-based UTF-16 列
+*/
+function byteToUtf16Col(text, byteOffset) {
+	let bytes = 0;
+	let col = 1;
+	for (const char of text) {
+		if (bytes >= byteOffset) break;
+		bytes += Buffer.byteLength(char);
+		col++;
+	}
+	return col;
+}
+/**
+* 根内绝对路径 → 工作区相对显示路径（供 edrv.read 与面板展示）。
+* @author ddj 2026年08月26号
+* @param value rg 输出路径
+* @param root 搜索根（subprocess 执行世界）
+* @returns 相对路径（根外路径原样返回）
+*/
+function displayPathOf(value, root) {
+	const path = pathText(String(value ?? ""));
+	if (!path) return path;
+	const base = pathText(root).replace(/\/$/, "");
+	const lowerPath = path.toLocaleLowerCase("en-US");
+	const lowerBase = base.toLocaleLowerCase("en-US");
+	if (lowerPath === lowerBase) return ".";
+	if (lowerPath.startsWith(lowerBase + "/")) return path.slice(base.length + 1);
+	return path;
+}
+/**
+* 解析 rg --json 输出为扁平命中列表（多子匹配展开，列转 UTF-16）。
+* @author ddj 2026年08月26号
+* @param text stdout 文本
+* @param root 搜索根
+* @returns 命中列表
+*/
+function parseRgJsonLines(text, root) {
+	const matches = [];
+	for (const line of text.split(/\r?\n/)) {
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		let item;
+		try {
+			item = JSON.parse(trimmed);
+		} catch {
+			continue;
+		}
+		if (item?.type !== "match" || !item.data) continue;
+		const data = item.data;
+		const path = displayPathOf(data.path?.text, root);
+		const lineText = (data.lines?.text ?? "").replace(/\r?\n$/, "").replace(/\r$/, "");
+		if (lineText.length > MAX_RECORD_LINE) continue;
+		const lineNumber = data.line_number ?? 0;
+		for (const sub of data.submatches ?? []) matches.push({
+			path,
+			line: lineNumber,
+			startColumn: byteToUtf16Col(lineText, sub.start ?? 0),
+			endColumn: byteToUtf16Col(lineText, sub.end ?? 0),
+			text: lineText
+		});
+	}
+	return matches;
+}
+/**
+* 命中截断：匹配数/文件数双上限，超限标记 truncated。
+* @author ddj 2026年08月26号
+* @param matches 全部命中
+* @param maxMatches 匹配数上限
+* @param maxFiles 文件数上限
+* @returns 截断后的命中与标志
+*/
+function applyCaps(matches, maxMatches, maxFiles) {
+	const seen = /* @__PURE__ */ new Set();
+	const out = [];
+	let truncated = false;
+	for (const match of matches) {
+		if (out.length >= maxMatches) {
+			truncated = true;
+			break;
+		}
+		if (!seen.has(match.path)) {
+			if (seen.size >= maxFiles) {
+				truncated = true;
+				break;
+			}
+			seen.add(match.path);
+		}
+		out.push(match);
+	}
+	return {
+		matches: out,
+		truncated
+	};
+}
+/**
+* 构造 rg 内容搜索 argv（pattern 放 `--` 后首位置，支持前导 `-` 的查询）。
+* include/exclude 为用户 glob（gitignore 式，原样透传不转义），
+* 分别转正选 `--glob` 与排除 `--glob !`。
+* @author ddj 2026年08月26号
+* @param binary rg 路径
+* @param root 搜索根
+* @param input 搜索输入
+* @returns argv 数组
+*/
+function contentArgv(binary, root, input) {
+	const argv = [
+		binary,
+		"--no-config",
+		"--json",
+		"--line-number",
+		"--no-heading",
+		"--color",
+		"never",
+		"--hidden",
+		"--no-ignore"
+	];
+	if (input.matchCase === true) argv.push("--case-sensitive");
+	if (input.wholeWord === true) argv.push("--word-regexp");
+	if (input.regex !== true) argv.push("--fixed-strings");
+	for (const excluded of EXCLUDES) argv.push("--glob", "!**/" + excluded + "/**");
+	for (const excluded of FILE_EXCLUDES) argv.push("--glob", "!" + excluded);
+	for (const pattern of input.include ?? []) {
+		const glob = String(pattern).trim();
+		if (glob) argv.push("--glob", glob);
+	}
+	for (const pattern of input.exclude ?? []) {
+		const glob = String(pattern).trim();
+		if (glob) argv.push("--glob", "!" + glob);
+	}
+	argv.push("--", input.query, root);
+	return argv;
+}
+/**
+* 使用打包 ripgrep 搜索文件内容。
+* @author ddj 2026年08月26号
+* @param input provider 输入
+* @returns 有界内容搜索结果
+*/
+async function searchRipgrepContent(input) {
+	const sub = input.ctx.get("subprocess");
+	if (!sub) throw new Error("缺少 subprocess");
+	const binary = ripgrepPath();
+	if (!binary) throw new Error("ripgrep 不可用");
+	const root = input.root ?? await searchRoot(input.ctx, input.session);
+	const handle = sub.spawn({
+		argv: contentArgv(binary, root, input),
+		cwd: root,
+		stdio: {
+			stdin: "ignore",
+			stdout: { maxBytes: STDOUT_CAP },
+			stderr: { maxBytes: STDERR_CAP }
+		},
+		graceMs: GRACE_MS,
+		signal: input.signal
+	});
+	let outcome;
+	try {
+		outcome = await handle.done;
+	} catch (error) {
+		throw new Error("ripgrep 启动失败：" + String(error));
+	}
+	const code = outcome.exitCode ?? outcome.code;
+	if (code !== 0 && code !== 1) throw new Error("ripgrep 退出码：" + String(code));
+	const reader = handle.collected?.stdout;
+	if (!reader) throw new Error("ripgrep stdout 不可用");
+	const output = reader.readFrom(0);
+	const capped = applyCaps(parseRgJsonLines(output.text, root), Math.max(1, Math.min(input.maxResults ?? DEFAULT_MAX_MATCHES, DEFAULT_MAX_MATCHES)), DEFAULT_MAX_FILES);
+	const truncated = Boolean(output.lossy) || capped.truncated;
+	return {
+		...capped,
+		complete: !truncated,
+		source: "ripgrep"
+	};
+}
+/**
+* 内容搜索编排器：短期缓存 + 同根在途取消 + 会话清理。
+* @author ddj 2026年08月26号
+*/
+var ContentSearcher = class {
+	ctx;
+	provider;
+	cache = new SearchCache((r) => ({
+		...r,
+		matches: [...r.matches]
+	}));
+	inflight = /* @__PURE__ */ new Map();
+	rootsByCwd = /* @__PURE__ */ new Map();
+	/**
+	* 创建内容搜索编排器。
+	* @author ddj 2026年08月26号
+	* @param ctx DSH 上下文
+	* @param provider 内容搜索 provider（测试可替换）
+	*/
+	constructor(ctx, provider = { search: searchRipgrepContent }) {
+		this.ctx = ctx;
+		this.provider = provider;
+	}
+	/**
+	* 执行一次工作区内容搜索。
+	* @author ddj 2026年08月26号
+	* @param request 搜索请求
+	* @returns RPC 响应字段（provider 失败抛错，abort 返回空）
+	*/
+	async search(request) {
+		const query = String(request.query ?? "").trim();
+		if (query.length < 2) return {
+			matches: [],
+			truncated: false
+		};
+		let root;
+		try {
+			root = await searchRoot(this.ctx, request.session);
+		} catch {
+			return {
+				matches: [],
+				truncated: false
+			};
+		}
+		const rootKey = pathText(root);
+		const roots = this.rootsByCwd.get(request.cwd) ?? /* @__PURE__ */ new Set();
+		roots.add(rootKey);
+		this.rootsByCwd.set(request.cwd, roots);
+		const includeKey = (request.include ?? []).join(",");
+		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
+		};
+		this.inflight.get(root)?.abort();
+		const controller = new AbortController();
+		this.inflight.set(root, controller);
+		try {
+			const result = await this.provider.search({
+				ctx: this.ctx,
+				session: request.session,
+				cwd: request.cwd,
+				query,
+				matchCase: request.matchCase,
+				wholeWord: request.wholeWord,
+				regex: request.regex,
+				maxResults: request.maxResults,
+				include: request.include,
+				exclude: request.exclude,
+				signal: controller.signal,
+				root
+			});
+			if (controller.signal.aborted) return {
+				matches: [],
+				truncated: false
+			};
+			this.cache.set(key, result);
+			return {
+				matches: result.matches,
+				truncated: result.truncated
+			};
+		} catch (error) {
+			if (controller.signal.aborted) return {
+				matches: [],
+				truncated: false
+			};
+			throw error;
+		} finally {
+			if (this.inflight.get(root) === controller) this.inflight.delete(root);
+		}
+	}
+	/**
+	* 清理会话对应根目录的缓存和在途搜索。
+	* @author ddj 2026年08月26号
+	* @param cwd 会话工作区
+	*/
+	dispose(cwd) {
+		const roots = this.rootsByCwd.get(cwd) ?? /* @__PURE__ */ new Set([cwd]);
+		for (const root of roots) {
+			this.inflight.get(root)?.abort();
+			this.inflight.delete(root);
+			this.cache.clearRoot(root);
+		}
+		this.rootsByCwd.delete(cwd);
+	}
+	/**
+	* 清理全部状态。
+	* @author ddj 2026年08月26号
+	*/
+	disposeAll() {
+		for (const controller of this.inflight.values()) controller.abort();
+		this.inflight.clear();
+		this.rootsByCwd.clear();
+		this.cache.clear();
+	}
+};
+/**
+* 创建默认内容搜索编排器。
+* @author ddj 2026年08月26号
+* @param ctx DSH 上下文
+* @returns 内容搜索编排器
+*/
+function newContentSearcher(ctx) {
+	return new ContentSearcher(ctx);
+}
+//#endregion
 //#region src/revert.ts
 /**
 * 删除新建文件（拒绝创建时）：subprocess 删除，路径先经 fs.contains 校验工作区边界。
@@ -2543,10 +2927,73 @@ async function revealInExplorer(ctx, absPath, isDir) {
 }
 //#endregion
 //#region src/rpc.ts
-/** cwd → Promise 链：串行化 debug 日志追加（fs read+write 非原子，避免并发丢行）。 */
+/** cwd → 内存缓冲：行数组 + 累计字节数 + 待触发 flush 定时器（攒批落盘，避免每条日志全文件读改写）。 */
+const debugBuffers = /* @__PURE__ */ new Map();
+/** cwd → Promise 链：串行化 debug 日志落盘（fs read+write 非原子，避免并发丢行）。 */
 const debugWriteQueues = /* @__PURE__ */ new Map();
 /** debug 日志单文件上限：超限截断保留尾部，防文件无限增长拖慢每次追加。 */
 const DEBUG_LOG_CAP = 524288;
+/** debug 日志批量缓冲上限：攒满即落盘（一次读改写），上限内不逐条写文件。 */
+const DEBUG_BUF_CAP = 32768;
+/** debug 日志空闲 flush 延迟：缓冲未满时，静默一段时间后落盘一次。 */
+const DEBUG_FLUSH_IDLE_MS = 1e3;
+/** cwd → 上次 stale 自动清理时间：全量轮询（EditorView/DiffBadge/Dock 各自 5s）节流，避免每轮都读文件算指纹。 */
+const staleCheckedAt = /* @__PURE__ */ new Map();
+/** stale 自动清理最小间隔。 */
+const STALE_CHECK_MIN_MS = 1e4;
+/**
+* 调试日志入队：先攒内存缓冲（行 + 字节数），满 DEBUG_BUF_CAP 立即落盘，
+* 否则空闲 DEBUG_FLUSH_IDLE_MS 后落盘；落盘 = 读旧文件 + 追加整批 + 超限截断 + 一次写入。
+* @author ddj 2026年08月26号
+* @param ctx DSH 上下文
+* @param cwd 工作区（日志文件按工作区旁车存放）
+* @param policy 会话沙箱策略（入队时刻捕获）
+* @param line 单条日志文本（不含换行）
+*/
+function enqueueDebug(ctx, cwd, policy, line) {
+	const st = debugBuffers.get(cwd) ?? {
+		lines: [],
+		len: 0,
+		timer: null
+	};
+	st.lines.push(line);
+	st.len += line.length;
+	const flush = () => {
+		st.timer = null;
+		const batch = st.lines;
+		st.lines = [];
+		st.len = 0;
+		flushDebug(ctx, cwd, policy, batch);
+	};
+	if (st.len >= DEBUG_BUF_CAP) {
+		if (st.timer) clearTimeout(st.timer);
+		flush();
+	} else if (!st.timer) st.timer = setTimeout(flush, DEBUG_FLUSH_IDLE_MS);
+	debugBuffers.set(cwd, st);
+}
+/**
+* 批量落盘一条 debug 日志缓冲：读旧文件 → 追加 → 超上限截断保留尾部 → 一次写回。
+* 串行链保证同一 cwd 的读改写不交错丢行；写失败静默忽略（调试日志不阻塞业务）。
+* @author ddj 2026年08月26号
+* @param ctx DSH 上下文
+* @param cwd 工作区
+* @param policy 会话沙箱策略（enqueue 时刻捕获）
+* @param batch 本批日志行
+*/
+function flushDebug(ctx, cwd, policy, batch) {
+	const task = (debugWriteQueues.get(cwd) ?? Promise.resolve()).then(async () => {
+		try {
+			const fs = ctx.get("fs");
+			if (!fs) return;
+			const target = await fs.resolve(".dsh-edit-review-debug.log", { cwd });
+			const appended = await fs.readText(target).catch(() => "") + batch.map((l) => (/* @__PURE__ */ 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);
+		} catch (e) {}
+	});
+	debugWriteQueues.set(cwd, task);
+	return task;
+}
 /** 记录 → 客户端视图（不含 before 全文，仅长度）。 */
 function recView(record) {
 	return {
@@ -2627,7 +3074,7 @@ async function applyDecisions(ctx, session, cwd, bucket, items) {
 	return results;
 }
 /** 各方法 handler 表（类型由 shared/rpc 的 RpcHandlerMap 约束）。 */
-function buildHandlers(ctx, registry, searcher = newSearcher(ctx)) {
+function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx)) {
 	return {
 		"edrv.list": async (args) => {
 			const sc = await requireSession(ctx, args.sessionId);
@@ -2637,7 +3084,13 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx)) {
 			};
 			const bucket = await bucketOf(registry, ctx, sc.cwd);
 			const want = Array.isArray(args.callIds) ? new Set(args.callIds) : null;
-			if (!want && args.skipStale !== true) await autoArchiveStale(ctx, sc.session, sc.cwd, bucket);
+			if (!want && args.skipStale !== true) {
+				const now = Date.now();
+				if (now - (staleCheckedAt.get(sc.cwd) ?? 0) > STALE_CHECK_MIN_MS) {
+					staleCheckedAt.set(sc.cwd, now);
+					await autoArchiveStale(ctx, sc.session, sc.cwd, bucket);
+				}
+			}
 			const out = [];
 			for (const rec of bucket.values()) {
 				if (!want && rec.archived) continue;
@@ -2943,19 +3396,8 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx)) {
 				ok: false,
 				error: sc.err
 			};
-			const fs = ctx.get("fs");
 			const text = String(args.text ?? "");
-			const task = (debugWriteQueues.get(sc.cwd) || Promise.resolve()).then(async () => {
-				try {
-					const target = await fs.resolve(".dsh-edit-review-debug.log", { cwd: sc.cwd });
-					const old = await fs.readText(target).catch(() => "");
-					const line = (/* @__PURE__ */ new Date()).toISOString() + " " + text + "\n";
-					const next = old.length + line.length > DEBUG_LOG_CAP ? old.slice(-Math.floor(DEBUG_LOG_CAP / 2)) + line : old + line;
-					await fs.writeText(target, next, void 0, void 0, policyOf(ctx, sc.session));
-				} catch (e) {}
-			});
-			debugWriteQueues.set(sc.cwd, task);
-			await task;
+			enqueueDebug(ctx, sc.cwd, policyOf(ctx, sc.session), text);
 			console.error("[edrv-debug] " + text);
 			return { ok: true };
 		},
@@ -2978,6 +3420,34 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx)) {
 				})
 			};
 		},
+		"edrv.searchContent": async (args) => {
+			const sc = await requireSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			try {
+				return {
+					ok: true,
+					...await contentSearcher.search({
+						session: sc.session,
+						cwd: sc.cwd,
+						query: args.query,
+						matchCase: args.matchCase,
+						wholeWord: args.wholeWord,
+						regex: args.regex,
+						maxResults: args.maxResults,
+						include: args.include,
+						exclude: args.exclude
+					})
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "搜索失败：" + String(error)
+				};
+			}
+		},
 		"edrv.listDir": async (args) => {
 			const sc = await requireSession(ctx, args.sessionId);
 			if ("err" in sc) return {
@@ -3240,10 +3710,10 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx)) {
 }
 /**
 * 统一入口：按方法分发到 handler 表。
-* @author ddj 2026年08月20号
+* @author ddj 2026年08月20号 / 2026年08月26号
 */
-async function handleRpc(ctx, registry, method, args, searcher = newSearcher(ctx)) {
-	const handler = buildHandlers(ctx, registry, searcher)[method];
+async function handleRpc(ctx, registry, method, args, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx)) {
+	const handler = buildHandlers(ctx, registry, searcher, contentSearcher)[method];
 	if (!handler) return {
 		ok: false,
 		error: "未知方法: " + String(method)
@@ -3414,6 +3884,7 @@ const inject = [
 function apply(ctx, config) {
 	const registry = /* @__PURE__ */ new Map();
 	const searcher = newSearcher(ctx);
+	const contentSearcher = newContentSearcher(ctx);
 	/** 兼容性警告收集（route 护栏等写入，启动日志一并输出）。 */
 	const warnings = [];
 	setupOpenSettings(ctx, config, () => {});
@@ -3426,9 +3897,10 @@ function apply(ctx, config) {
 			registry.delete(cwd);
 			dropFileIndex(cwd);
 			searcher.dispose(cwd);
+			contentSearcher.dispose(cwd);
 		}
 	});
-	registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher), (warning) => warnings.push(warning));
+	registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher), (warning) => warnings.push(warning));
 	installIsolation(ctx);
 	logCompatSummary(ctx, warnings);
 	ctx.logger?.info?.("[dsh-vscode-mode] 编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用）");