dsh-vscode-mode 0.1.12 → 0.1.15

package/lib/index.js

@@ -1,7 +1,11 @@
+import { createRequire } from "node:module";
 import { readFile } from "node:fs/promises";
 import { dirname, extname, join, normalize, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
 import { createHash } from "node:crypto";
+import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
+import z from "schemastery";
 //#region src/shared/rpc.ts
 /** webServer 精确路由。 */
 const RPC_PATH = "/edrv/rpc";
@@ -888,9 +892,6 @@ async function captureToolResult(ctx, registry, exec, result) {
 		}
 		record.batch = fileMaxBatch(bucket, path) + 1;
 		bucket.set(exec.callId, record);
-		const prior = [];
-		for (const r of bucket.values()) if (r.path === path && r.callId !== exec.callId && !r.archived && (r.batch ?? 0) < record.batch) prior.push(r);
-		if (prior.length) await archiveRecords(ctx, session, cwd, bucket, prior, prior.every(recordResolved) ? "已处理且被后续修改取代" : "被后续修改融合（内容已含其效果）");
 		prune(bucket);
 		await saveBucket(ctx, cwd, bucket, session);
 	} catch (error) {
@@ -898,82 +899,600 @@ async function captureToolResult(ctx, registry, exec, result) {
 	}
 }
 //#endregion
-//#region src/workspace.ts
-/** 文件清单缓存 TTL 与扫描上限（避免大工作区反复全量扫描）。 */
-const FILE_INDEX_TTL = 6e4;
-const SCAN_CAP = 6e3;
-/** cwd → { at, files }（随会话销毁清理）。 */
-const fileIndex = /* @__PURE__ */ new Map();
+//#region src/search/query.ts
 /**
-* 扫描工作区文件清单（快速打开/搜索用）：subprocess（Windows powershell / POSIX find），
-* 排除常见重目录，容量上限 SCAN_CAP；结果缓存（TTL FILE_INDEX_TTL）。失败返回 null。
-* @author ddj 2026年08月20号
+* 规范化用户搜索文本。
+* @author ddj 2026年08月24号
+* @param raw 原始搜索文本
+* @returns 用于比较和缓存的 query
+*/
+function prepareQuery(raw) {
+	const value = String(raw ?? "").trim();
+	return {
+		raw: value,
+		text: value.replaceAll("\\", "/").toLocaleLowerCase("en-US")
+	};
+}
+/**
+* 归一化路径分隔符并移除无意义前缀。
+* @author ddj 2026年08月24号
+* @param value 原始路径
+* @returns 比较用路径
+*/
+function pathText(value) {
+	return value.replaceAll("\\", "/").replace(/^\.\//, "");
+}
+/**
+* 生成不区分大小写的路径 key。
+* @author ddj 2026年08月24号
+* @param value 原始路径
+* @returns 去重 key
+*/
+function pathKey(value) {
+	return pathText(value).toLocaleLowerCase("en-US");
+}
+/**
+* 判断路径是否包含连续 query。
+* @author ddj 2026年08月24号
+* @param value 文件路径
+* @param query 已规范化 query
+* @returns 是否命中
+*/
+function pathMatch(value, query) {
+	return pathText(value).toLocaleLowerCase("en-US").includes(query.text);
+}
+//#endregion
+//#region src/search/ripgrep.ts
+/**
+* dsh-vscode-mode host — ripgrep 文件发现 provider。
+* 通过独立 argv 调用打包 rg，避免先构建巨型全量文件数组。
+* 作者 ddj 2026年08月24号
+*/
+const STDOUT_CAP = 4 << 20;
+const STDERR_CAP = 65536;
+const GRACE_MS = 2e4;
+const EXCLUDES = [
+	"node_modules",
+	".git",
+	".tmp",
+	".cache",
+	"dist",
+	"build",
+	"vendor",
+	"coverage",
+	"__pycache__"
+];
+/**
+* 将 query 转成 rg 的字面 glob。
+* @author ddj 2026年08月24号
+* @param query 已规范化 query
+* @returns 安全 glob
+*/
+function queryGlob(query) {
+	return "**/*" + pathText(query).replace(/[\*?\[\]{}!]/g, (char) => "\\" + char) + "*";
+}
+/**
+* 返回当前平台的 rg 可执行文件路径，不让可选依赖影响模块加载。
+* @author ddj 2026年08月24号
+* @returns rg 路径或 null
+*/
+function ripgrepPath() {
+	try {
+		const ripgrep = createRequire(import.meta.url)("@vscode/ripgrep");
+		if (typeof ripgrep.rgPath !== "string" || !existsSync(ripgrep.rgPath)) return null;
+		return join(ripgrep.rgPath);
+	} catch (error) {
+		return null;
+	}
+}
+/**
+* 解析会话搜索根目录，并转换到 subprocess 执行世界。
+* @author ddj 2026年08月24号
 * @param ctx DSH 上下文
-* @param session 会话（取工作区根）
-* @param cwd 工作区目录
-* @returns 绝对路径清单；不可用（无 subprocess/fs）或扫描失败返回 null
+* @param session 当前会话
+* @returns subprocess 可访问的根目录
 */
-async function listWorkspaceFiles(ctx, session, cwd) {
-	const cached = fileIndex.get(cwd);
-	if (cached && Date.now() - cached.at < FILE_INDEX_TTL) return cached.files;
-	const sub = ctx.get("subprocess");
+async function searchRoot(ctx, session) {
 	const fs = ctx.get("fs");
-	if (!sub || !fs) return null;
+	if (!fs) throw new Error("缺少 fs");
 	const policy = policyOf(ctx, session);
-	let root;
+	const cwd = session?.header?.cwd;
+	const rootTarget = await fs.resolve(policy?.workspaceRoot ?? ".", cwd ? { cwd } : {});
+	return fs.processPath(rootTarget);
+}
+/**
+* 读取收集输出并解析为路径候选。
+* @author ddj 2026年08月24号
+* @param handle subprocess handle
+* @param maxResults 候选上限
+* @returns 路径与完整性状态
+*/
+function parseOutput(handle, maxResults) {
+	const reader = handle.collected?.stdout;
+	if (!reader) return {
+		files: [],
+		truncated: false,
+		complete: false
+	};
+	const output = reader.readFrom(0);
+	const values = output.text.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+	const unique = [...new Set(values)];
+	const truncated = Boolean(output.lossy) || unique.length > maxResults;
+	return {
+		files: unique.slice(0, maxResults).map(pathText),
+		truncated,
+		complete: !truncated
+	};
+}
+/**
+* 使用打包 ripgrep 搜索工作区文件。
+* @author ddj 2026年08月24号
+* @param input provider 输入
+* @returns 有界搜索结果
+*/
+async function searchRipgrep(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 argv = [
+		binary,
+		"--no-config",
+		"--files",
+		"--hidden",
+		"--no-ignore",
+		"--glob-case-insensitive",
+		"--glob",
+		queryGlob(prepareQuery(input.query).text)
+	];
+	for (const excluded of 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 }
+		},
+		graceMs: GRACE_MS,
+		signal: input.signal
+	});
+	let outcome;
 	try {
-		const rootTarget = await fs.resolve(policy?.workspaceRoot ?? ".", {});
-		root = fs.processPath(rootTarget);
+		outcome = await handle.done;
 	} catch (error) {
-		root = cwd;
+		throw new Error("ripgrep 启动失败：" + String(error));
 	}
-	const lines = [];
-	const run = async (argv) => {
-		const handle = sub.spawn({
-			argv,
-			stdio: {
-				stdout: { maxBytes: 8 << 20 },
-				stderr: { maxBytes: 65536 },
-				stdin: "ignore"
-			},
-			graceMs: 2e4
-		});
-		const outcome = await handle.done;
-		const code = outcome?.exitCode ?? outcome?.code;
-		if (code !== 0) throw new Error("scan exit " + code);
-		const text = handle.collected?.stdout?.readFrom(0).text ?? "";
-		for (const ln of text.split(/\r?\n/)) {
-			const s = ln.trim();
-			if (s) lines.push(s);
+	const code = outcome.exitCode ?? outcome.code;
+	if (code !== 0 && code !== 1) throw new Error("ripgrep 退出码：" + String(code));
+	const parsed = parseOutput(handle, input.maxResults);
+	if (!handle.collected?.stdout) throw new Error("ripgrep stdout 不可用");
+	return {
+		...parsed,
+		source: "ripgrep"
+	};
+}
+/**
+* 构造 ripgrep provider。
+* @author ddj 2026年08月24号
+* @returns provider 实例
+*/
+function newRgProvider() {
+	return { search: searchRipgrep };
+}
+//#endregion
+//#region src/search/fallback.ts
+const RESULT_CAP = 500;
+const EXCLUDED = /* @__PURE__ */ new Set([
+	"node_modules",
+	".git",
+	".tmp",
+	".cache",
+	"dist",
+	"build",
+	"vendor",
+	"coverage",
+	"__pycache__"
+]);
+/**
+* 在一个目录树中递归查找匹配文件。
+* @author ddj 2026年08月24号
+* @param fs 文件系统能力
+* @param target 当前目录目标
+* @param input 搜索输入
+* @param files 已保留候选
+* @param signal 取消信号
+* @returns 是否因达到上限而截断
+*/
+async function walk(fs, target, input, files, signal) {
+	if (signal.aborted) throw new DOMException("搜索已取消", "AbortError");
+	const entries = await fs.listDir(target, signal);
+	for (const entry of entries) {
+		if (signal.aborted) throw new DOMException("搜索已取消", "AbortError");
+		if (entry.type === "directory") {
+			if (EXCLUDED.has(entry.name)) continue;
+			if (await walk(fs, entry.target, input, files, signal)) return true;
+			continue;
 		}
+		if (entry.type !== "file") continue;
+		const path = pathText(entry.target.displayPath ?? entry.name);
+		if (!pathMatch(path, {
+			raw: input.query,
+			text: pathText(input.query).toLocaleLowerCase("en-US")
+		})) continue;
+		files.push(path);
+		if (files.length >= Math.min(input.maxResults, RESULT_CAP)) return true;
+	}
+	return false;
+}
+/**
+* 使用 ctx.fs.listDir 搜索文件。
+* @author ddj 2026年08月24号
+* @param input provider 输入
+* @returns 有界 fallback 结果
+*/
+async function searchFallback(input) {
+	const fs = input.ctx.get("fs");
+	if (!fs) throw new Error("缺少 fs");
+	const policy = policyOf(input.ctx, input.session);
+	const cwd = input.session?.header?.cwd;
+	const rootTarget = await fs.resolve(policy?.workspaceRoot ?? ".", cwd ? {
+		cwd,
+		signal: input.signal
+	} : { signal: input.signal });
+	const signal = input.signal ?? new AbortController().signal;
+	const files = [];
+	const truncated = await walk(fs, rootTarget, input, files, signal);
+	return {
+		files,
+		truncated,
+		complete: !truncated,
+		source: "fallback"
 	};
-	try {
-		if (process.platform === "win32") await run([
-			"powershell",
-			"-NoProfile",
-			"-NonInteractive",
-			"-Command",
-			"Get-ChildItem -LiteralPath \"" + String(root).replace(/"/g, "\"\"") + "\" -Recurse -File -ErrorAction SilentlyContinue | Where-Object { $_.FullName -notmatch '(node_modules|\\.git|\\.tmp|\\.cache|dist|build|vendor|coverage|__pycache__)' } | Select-Object -First 6000 | ForEach-Object { $_.FullName }"
-		]);
-		else await run([
-			"/bin/sh",
-			"-c",
-			"find " + JSON.stringify(root) + " -type f -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/.tmp/*' -not -path '*/.cache/*' -not -path '*/dist/*' -not -path '*/build/*' -not -path '*/vendor/*' -not -path '*/coverage/*' 2>/dev/null | head -n 6000"
-		]);
-	} catch (error) {
-		console.error("edrv scan failed", error);
-		return null;
+}
+/**
+* 构造 fallback provider。
+* @author ddj 2026年08月24号
+* @returns provider 实例
+*/
+function newFallback() {
+	return { search: searchFallback };
+}
+//#endregion
+//#region src/search/ranker.ts
+/**
+* 生成搜索候选。
+* @author ddj 2026年08月24号
+* @param path 文件路径
+* @param source 候选来源
+* @returns 内部候选
+*/
+function candidateOf(path, source) {
+	const normalizedPath = pathText(path);
+	return {
+		path,
+		basename: normalizedPath.split("/").pop() ?? normalizedPath,
+		normalizedPath: normalizedPath.toLocaleLowerCase("en-US"),
+		source
+	};
+}
+/**
+* 对连续匹配候选进行排序。
+* @author ddj 2026年08月24号
+* @param candidates 候选列表
+* @param query 已规范化 query
+* @returns 排序后的候选
+*/
+function rankCandidates(candidates, query) {
+	const text = query.text;
+	const score = (candidate) => {
+		const base = candidate.basename.toLocaleLowerCase("en-US");
+		if (base.startsWith(text)) return 0;
+		if (base.includes(text)) return 1;
+		if (candidate.normalizedPath.includes(text)) return 2;
+		return 3;
+	};
+	return [...candidates].sort((left, right) => score(left) - score(right) || left.normalizedPath.localeCompare(right.normalizedPath, "en-US"));
+}
+//#endregion
+//#region src/search/orchestrator.ts
+const CACHE_TTL = 6e4;
+const CACHE_LIMIT = 100;
+const RESULT_LIMIT = 50;
+const PROVIDER_VERSION = "ripgrep-v1";
+const POLICY_VERSION = "search-policy-v1";
+/**
+* 短期有界搜索缓存。
+* @author ddj 2026年08月24号
+* @returns 缓存对象
+*/
+var SearchCache = class {
+	entries = /* @__PURE__ */ new Map();
+	/**
+	* 读取未过期条目。
+	* @author ddj 2026年08月24号
+	* @param key 缓存 key
+	* @param now 当前时间
+	* @returns 缓存结果或 undefined
+	*/
+	get(key, now = Date.now()) {
+		const entry = this.entries.get(key);
+		if (!entry) return void 0;
+		if (now - entry.at >= CACHE_TTL) {
+			this.entries.delete(key);
+			return;
+		}
+		this.entries.delete(key);
+		this.entries.set(key, entry);
+		return {
+			...entry.result,
+			files: [...entry.result.files]
+		};
 	}
-	const files = lines.slice(0, SCAN_CAP);
-	if (files.length) fileIndex.set(cwd, {
-		at: Date.now(),
-		files
-	});
-	return files;
+	/**
+	* 写入成功 provider 结果。
+	* @author ddj 2026年08月24号
+	* @param key 缓存 key
+	* @param result provider 结果
+	* @param now 当前时间
+	*/
+	set(key, result, now = Date.now()) {
+		this.entries.delete(key);
+		this.entries.set(key, {
+			at: now,
+			result: {
+				...result,
+				files: [...result.files]
+			}
+		});
+		while (this.entries.size > CACHE_LIMIT) this.entries.delete(this.entries.keys().next().value);
+	}
+	/**
+	* 清理指定根目录的缓存。
+	* @author ddj 2026年08月24号
+	* @param root 工作区根目录
+	*/
+	clearRoot(root) {
+		for (const key of this.entries.keys()) if (key.startsWith(root + "|")) this.entries.delete(key);
+	}
+	/**
+	* 清空全部缓存。
+	* @author ddj 2026年08月24号
+	*/
+	clear() {
+		this.entries.clear();
+	}
+};
+/**
+* 获取 policy 版本，未知策略使用固定插件版本。
+* @author ddj 2026年08月24号
+* @param ctx DSH 上下文
+* @param session 当前会话
+* @returns 稳定版本文本
+*/
+function policyVersion(ctx, session) {
+	const policy = policyOf(ctx, session);
+	const version = policy?.version ?? policy?.policyVersion;
+	return typeof version === "string" || typeof version === "number" ? String(version) : POLICY_VERSION;
 }
-/** 会话销毁时清理文件索引缓存。 */
-function dropFileIndex(cwd) {
-	fileIndex.delete(cwd);
+/**
+* 将 root 内绝对路径统一成相对显示路径。
+* @author ddj 2026年08月24号
+* @param value 原始路径
+* @param root 搜索根
+* @returns 兼容 edrv.read 的路径
+*/
+function displayPath(value, root) {
+	const path = pathText(value);
+	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;
+}
+/**
+* 为显示路径生成跨绝对/相对形式的去重 key。
+* @author ddj 2026年08月24号
+* @param value 原始路径
+* @param root 搜索根
+* @returns 去重 key
+*/
+function displayKey(value, root) {
+	return pathKey(displayPath(value, root));
+}
+/**
+* 合并 provider 与 active diff 候选并去重。
+* @author ddj 2026年08月24号
+* @param result provider 结果
+* @param activePaths 活跃差异路径
+* @param root 搜索根
+* @param query 已规范化 query
+* @returns 候选列表
+*/
+function mergeCandidates(result, activePaths, root, query) {
+	const candidates = /* @__PURE__ */ new Map();
+	for (const path of result.files) {
+		const shown = displayPath(path, root);
+		if (pathMatch(shown, query)) candidates.set(displayKey(path, root), candidateOf(shown, "workspace"));
+	}
+	for (const path of activePaths) {
+		const shown = displayPath(path, root);
+		if (!pathMatch(shown, query)) continue;
+		const key = displayKey(path, root);
+		if (!candidates.has(key)) candidates.set(key, candidateOf(shown, "active-diff"));
+	}
+	return [...candidates.values()];
+}
+/**
+* 搜索编排器。
+* @author ddj 2026年08月24号
+*/
+var SearchOrchestrator = class {
+	ctx;
+	cache = new SearchCache();
+	inflight = /* @__PURE__ */ new Map();
+	rootsByCwd = /* @__PURE__ */ new Map();
+	provider;
+	fallback;
+	ranker;
+	/**
+	* 创建搜索编排器。
+	* @author ddj 2026年08月24号
+	* @param ctx DSH 上下文
+	* @param provider 主 provider，可替换测试
+	* @param fallback 降级 provider，可替换测试
+	* @param ranker 排序器，可替换测试
+	*/
+	constructor(ctx, provider = newRgProvider(), fallback = newFallback(), ranker = { rank: rankCandidates }) {
+		this.ctx = ctx;
+		this.provider = provider;
+		this.fallback = fallback;
+		this.ranker = ranker;
+	}
+	/**
+	* 执行一次工作区搜索。
+	* @author ddj 2026年08月24号
+	* @param request 搜索请求
+	* @returns 旧 RPC 响应字段
+	*/
+	async search(request) {
+		const query = prepareQuery(request.query);
+		if (query.text.length < 2) return {
+			files: [],
+			truncated: false
+		};
+		let root;
+		try {
+			root = await searchRoot(this.ctx, request.session);
+		} catch (error) {
+			return this.rankActive(request.activePaths, request.cwd, query);
+		}
+		const rootKey = pathText(root);
+		const roots = this.rootsByCwd.get(request.cwd) ?? /* @__PURE__ */ new Set();
+		roots.add(rootKey);
+		this.rootsByCwd.set(request.cwd, roots);
+		const key = [
+			rootKey,
+			query.text,
+			policyVersion(this.ctx, request.session),
+			PROVIDER_VERSION
+		].join("|");
+		const cached = this.cache.get(key);
+		if (cached) return this.finish(cached, request.activePaths, root, query);
+		this.inflight.get(root)?.abort();
+		const controller = new AbortController();
+		this.inflight.set(root, controller);
+		try {
+			let result;
+			let providerOk = true;
+			try {
+				result = await this.provider.search({
+					ctx: this.ctx,
+					session: request.session,
+					cwd: request.cwd,
+					query: query.raw,
+					maxResults: 500,
+					signal: controller.signal,
+					root
+				});
+			} catch (error) {
+				providerOk = false;
+				if (controller.signal.aborted) return {
+					files: [],
+					truncated: false
+				};
+				try {
+					result = await this.fallback.search({
+						ctx: this.ctx,
+						session: request.session,
+						cwd: request.cwd,
+						query: query.raw,
+						maxResults: 500,
+						signal: controller.signal,
+						root
+					});
+				} catch (fallbackError) {
+					return this.rankActive(request.activePaths, root, query);
+				}
+			}
+			if (controller.signal.aborted) return {
+				files: [],
+				truncated: false
+			};
+			if (providerOk) this.cache.set(key, result);
+			return this.finish(result, request.activePaths, root, query);
+		} finally {
+			if (this.inflight.get(root) === controller) this.inflight.delete(root);
+		}
+	}
+	/**
+	* 清理会话对应根目录的缓存和在途搜索。
+	* @author ddj 2026年08月24号
+	* @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月24号
+	*/
+	disposeAll() {
+		for (const controller of this.inflight.values()) controller.abort();
+		this.inflight.clear();
+		this.rootsByCwd.clear();
+		this.cache.clear();
+	}
+	/**
+	* 将 provider 结果与 active diff 合并、排序和截断。
+	* @author ddj 2026年08月24号
+	* @param result provider 结果
+	* @param activePaths active diff 路径
+	* @param root 搜索根
+	* @param query 已规范化 query
+	* @returns 旧 RPC 响应字段
+	*/
+	finish(result, activePaths, root, query) {
+		const candidates = this.ranker.rank(mergeCandidates(result, activePaths, root, query), query);
+		return {
+			files: candidates.slice(0, RESULT_LIMIT).map((candidate) => candidate.path),
+			truncated: result.truncated || candidates.length > RESULT_LIMIT
+		};
+	}
+	/**
+	* provider 失败时仅保留 active diff 命中。
+	* @author ddj 2026年08月24号
+	* @param paths active diff 路径
+	* @param root 搜索根
+	* @param query 已规范化 query
+	* @returns 旧 RPC 响应字段
+	*/
+	rankActive(paths, root, query) {
+		return this.finish({
+			files: [],
+			truncated: false,
+			complete: true,
+			source: "active-diff"
+		}, paths, root, query);
+	}
+};
+/**
+* 创建默认编排器。
+* @author ddj 2026年08月24号
+* @param ctx DSH 上下文
+* @returns 搜索编排器
+*/
+function newSearcher(ctx) {
+	return new SearchOrchestrator(ctx);
 }
 //#endregion
 //#region src/revert.ts
@@ -1504,6 +2023,74 @@ async function projectRefresh(ctx, workspacePath, serverName) {
 	return projectOf(ctx, workspacePath, workspace.title ?? "");
 }
 //#endregion
+//#region src/fileOpenSettings.ts
+/**
+* dsh-vscode-mode host — 文件链接打开工具的持久化设置。
+* @author ddj 2026年08月24号
+*/
+const FILE_OPEN_SETTINGS_NS = settingsNamespace("dsh-vscode-mode");
+const FILE_OPEN_DEFAULT = "auto";
+const FILE_OPEN_SCHEMA = z.object({ fileOpenTool: z.string().default(FILE_OPEN_DEFAULT) });
+function normalizeValue(value) {
+	if (typeof value !== "string" || value.trim() === "") return FILE_OPEN_DEFAULT;
+	return value.trim();
+}
+function configValue(config) {
+	return normalizeValue(config?.fileOpenTool);
+}
+/**
+* 注册设置命名空间，并提供 host 侧的读取与更新状态。
+* @author ddj 2026年08月24号
+* @param ctx DSH host 上下文
+* @param config 插件组合配置
+* @param onChange 设置变化回调
+* @returns 设置状态
+*/
+function setupOpenSettings(ctx, config, onChange) {
+	let current = configValue(config);
+	let revision;
+	let provider;
+	const notify = (value) => {
+		current = normalizeValue(value);
+		onChange(current);
+	};
+	const syncRevision = () => {
+		revision = (provider?.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS))?.revision;
+	};
+	const setSource = (source) => notify(source().fileOpenTool);
+	const settingsChange = () => syncRevision();
+	installSettingsSection(ctx, FILE_OPEN_SETTINGS_NS, FILE_OPEN_SCHEMA, { fileOpenTool: current }, {
+		setSource,
+		onChange: settingsChange
+	});
+	ctx.inject?.(["settings"], (settingsCtx) => {
+		provider = settingsCtx.get("settings");
+		syncRevision();
+	});
+	return {
+		get value() {
+			return current;
+		},
+		get revision() {
+			return revision;
+		},
+		update: async (value, expectedRevision) => {
+			const next = normalizeValue(value);
+			if (!provider?.update) {
+				notify(next);
+				return;
+			}
+			await provider.update(FILE_OPEN_SETTINGS_NS, { fileOpenTool: next }, expectedRevision);
+			const stored = (provider.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS))?.value;
+			notify(stored?.fileOpenTool ?? next);
+			syncRevision();
+		}
+	};
+}
+function normalizeFileOpenTool(value) {
+	return normalizeValue(value);
+}
+//#endregion
 //#region src/rpc.ts
 /** cwd → Promise 链：串行化 debug 日志追加（fs read+write 非原子，避免并发丢行）。 */
 const debugWriteQueues = /* @__PURE__ */ new Map();
@@ -1540,7 +2127,7 @@ async function requireSession(ctx, sessionId) {
 	};
 }
 /** 各方法 handler 表（类型由 shared/rpc 的 RpcHandlerMap 约束）。 */
-function buildHandlers(ctx, registry) {
+function buildHandlers(ctx, registry, searcher = newSearcher(ctx)) {
 	return {
 		"edrv.list": async (args) => {
 			const sc = await requireSession(ctx, args.sessionId);
@@ -1868,28 +2455,17 @@ function buildHandlers(ctx, registry) {
 				ok: false,
 				error: sc.err
 			};
-			const query = String(args.query ?? "").trim().toLowerCase();
-			const files = [];
-			if (query.length >= 2) {
-				const bucket = await bucketOf(registry, ctx, sc.cwd);
-				const pool = /* @__PURE__ */ new Set();
-				for (const rec of bucket.values()) if (rec.path) pool.add(rec.path);
-				const listed = await listWorkspaceFiles(ctx, sc.session, sc.cwd);
-				if (listed) for (const f of listed) pool.add(f);
-				const score = (p) => {
-					const pl = p.toLowerCase();
-					if ((pl.split(/[\\/]/).pop() || "").includes(query)) return 0;
-					if (pl.includes(query)) return 1;
-					return -1;
-				};
-				const hit = [...pool].filter((p) => score(p) >= 0);
-				hit.sort((a, b) => score(a) - score(b) || (a < b ? -1 : 1));
-				files.push(...hit.slice(0, 50));
-			}
+			const bucket = await bucketOf(registry, ctx, sc.cwd);
+			const activePaths = [];
+			for (const record of bucket.values()) if (record.path) activePaths.push(record.path);
 			return {
 				ok: true,
-				files,
-				truncated: files.length >= 50
+				...await searcher.search({
+					session: sc.session,
+					cwd: sc.cwd,
+					query: args.query,
+					activePaths
+				})
 			};
 		},
 		"mcp.list": async () => ({
@@ -2010,6 +2586,37 @@ function buildHandlers(ctx, registry) {
 					error: String(error)
 				};
 			}
+		},
+		"vscode.fileOpenSettingsGet": async () => {
+			const descriptor = ctx.get("settings")?.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS);
+			const value = descriptor?.value;
+			return {
+				ok: true,
+				fileOpenTool: normalizeFileOpenTool(value?.fileOpenTool ?? "auto"),
+				revision: descriptor?.revision
+			};
+		},
+		"vscode.fileOpenSettingsUpdate": async (args) => {
+			const settings = ctx.get("settings");
+			if (!settings?.update) return {
+				ok: false,
+				error: "设置服务不可用"
+			};
+			try {
+				await settings.update(FILE_OPEN_SETTINGS_NS, { fileOpenTool: normalizeFileOpenTool(args.fileOpenTool) }, args.expectedRevision);
+				const descriptor = settings.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS);
+				const value = descriptor?.value;
+				return {
+					ok: true,
+					fileOpenTool: normalizeFileOpenTool(value?.fileOpenTool),
+					revision: descriptor?.revision
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: String(error)
+				};
+			}
 		}
 	};
 }
@@ -2017,8 +2624,8 @@ function buildHandlers(ctx, registry) {
 * 统一入口：按方法分发到 handler 表。
 * @author ddj 2026年08月20号
 */
-async function handleRpc(ctx, registry, method, args) {
-	const handler = buildHandlers(ctx, registry)[method];
+async function handleRpc(ctx, registry, method, args, searcher = newSearcher(ctx)) {
+	const handler = buildHandlers(ctx, registry, searcher)[method];
 	if (!handler) return {
 		ok: false,
 		error: "未知方法: " + String(method)
@@ -2161,6 +2768,14 @@ function installIsolation(ctx) {
 	}, "vscode-mode:mcp-isolation");
 }
 //#endregion
+//#region src/workspace.ts
+/** cwd → { at, files }（随会话销毁清理）。 */
+const fileIndex = /* @__PURE__ */ new Map();
+/** 会话销毁时清理文件索引缓存。 */
+function dropFileIndex(cwd) {
+	fileIndex.delete(cwd);
+}
+//#endregion
 //#region src/index.ts
 /**
 * @dsh-external 生态 → dsh-vscode-mode：DSH 上的类 VSCode 编码体验（Host 半入口）。
@@ -2187,6 +2802,8 @@ const inject = [
 */
 function apply(ctx, config) {
 	const registry = /* @__PURE__ */ new Map();
+	const searcher = newSearcher(ctx);
+	setupOpenSettings(ctx, config, () => {});
 	ctx.on("tools/result", (exec, result) => {
 		captureToolResult(ctx, registry, exec, result);
 	});
@@ -2195,9 +2812,10 @@ function apply(ctx, config) {
 		if (cwd) {
 			registry.delete(cwd);
 			dropFileIndex(cwd);
+			searcher.dispose(cwd);
 		}
 	});
-	registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args));
+	registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher));
 	installIsolation(ctx);
 	ctx.logger?.info?.("[dsh-vscode-mode] 编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用）");
 }