dsh-vscode-mode 0.1.36 → 0.1.43

package/lib/index.js

@@ -128,18 +128,9 @@ 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 而非抛错）。
+* 动态加载设置依赖（模块级缓存；任一缺失/失败返回 null 而非抛错）。
+* installSettingsSection 仅在 rc 线 dsh-settings 中存在时提供（alpha 起移除，
+* 属性探测得到 undefined，不抛错）。
 * @author ddj 2026年08月24号
 * @returns 设置依赖或 null
 */
@@ -150,6 +141,101 @@ function loadSettingsDeps() {
 	})).catch(() => null);
 	return depsPromise;
 }
+const INSTALL_UNMOUNTED = "设置 section 尚未装配";
+const INSTALL_LEGACY = "rc 线：dsh-settings.installSettingsSection";
+const INSTALL_SERVICE = "0.1.2-alpha 线：settings 服务 installSection";
+const INSTALL_NONE = "两路均不可用：设置持久化降级为配置值";
+let observedInstall = {
+	strategy: "unknown",
+	note: INSTALL_UNMOUNTED
+};
+/** 记录最近一次安装策略（供兼容报告展示；失败路径也记录，便于诊断）。 */
+function recordInstall(strategy, note) {
+	observedInstall = {
+		strategy,
+		note
+	};
+	return strategy;
+}
+/** 读取观测到的安装策略（供报告；测试可用 reset 复位）。 */
+function settingsInstallStrategy() {
+	return observedInstall.strategy;
+}
+/** 读取观测到的安装策略说明文案。 */
+function settingsInstallNote() {
+	return observedInstall.note;
+}
+/**
+* 设置 section 版本自适应安装（核心策略分派）。
+* legacy：dsh-settings 仍导出 installSettingsSection（rc 线）→ 原样调用，行为与旧版一致。
+* service：该导出已移除（0.1.2-alpha 起）→ 经 ctx.inject(['settings']) 走服务方法
+*          provider.installSection(owner, ns, schema, entry, hooks)（等义封装，含
+*          base 层与 fiber 卸载回退）。回调内方法缺失再降级记录 none。
+* none：两条路由都不存在 → 仅记录并告警，调用方按配置值运行。
+* 全程不抛错、不产生未捕获 rejection。
+* @author ddj 2026年09月02号
+* @param ctx DSH host 上下文（inject 可选探测）
+* @param ns 设置命名空间
+* @param schema schemastery schema
+* @param entry 初始设置值（作为 base 层）
+* @param hooks 设置源绑定与变更回调
+* @param loader 依赖装载器（测试注入）
+* @returns 采用/观测到的策略
+*/
+async function runSettingsInstall(ctx, ns, schema, entry, hooks, loader = loadSettingsDeps) {
+	let deps = null;
+	try {
+		deps = await loader();
+	} catch {}
+	if (!deps) {
+		console.warn("[dsh-vscode-mode] 设置依赖不可用，section " + ns + " 未安装（配置回退）");
+		return recordInstall("none", INSTALL_NONE);
+	}
+	const legacy = deps.installSettingsSection;
+	if (typeof legacy === "function") try {
+		legacy(ctx, ns, schema, entry, hooks);
+		return recordInstall("legacy", INSTALL_LEGACY);
+	} catch (error) {
+		console.warn("[dsh-vscode-mode] legacy 设置安装失败，尝试服务路由：" + String(error));
+	}
+	const ctxInject = ctx.inject;
+	if (typeof ctxInject !== "function") return recordInstall("none", INSTALL_NONE);
+	try {
+		ctxInject(["settings"], (sctx) => {
+			const sc = sctx;
+			const provider = typeof sc.get === "function" ? sc.get("settings") : sc.settings;
+			const install = provider?.installSection;
+			if (typeof install !== "function") {
+				console.warn("[dsh-vscode-mode] settings 服务无 installSection（DSH 版本 API 变化），section " + ns + " 降级为配置值");
+				recordInstall("none", INSTALL_NONE);
+				return;
+			}
+			try {
+				install.call(provider, ctx, ns, schema, entry, hooks);
+				recordInstall("service", INSTALL_SERVICE);
+			} catch (error) {
+				console.warn("[dsh-vscode-mode] settings.installSection 安装失败（" + String(error) + "），section " + ns + " 降级为配置值");
+				recordInstall("none", INSTALL_NONE);
+			}
+		});
+	} catch (error) {
+		console.warn("[dsh-vscode-mode] settings 服务路由不可用（" + String(error) + "）");
+		return recordInstall("none", INSTALL_NONE);
+	}
+	if (observedInstall.strategy !== "unknown") return observedInstall.strategy;
+	return recordInstall("service", "已调度 settings 服务 installSection（等待 settings 就绪）");
+}
+/**
+* 按命令目录构建 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;
+}
 function normalizeValue(value) {
 	if (typeof value !== "string" || value.trim() === "") return FILE_OPEN_DEFAULT;
 	return value.trim();
@@ -158,8 +244,8 @@ function configValue(config) {
 	return normalizeValue(config?.fileOpenTool);
 }
 /**
-* 安装设置 section（动态依赖；缺失返回 false 不抛错）。
-* @author ddj 2026年08月24号
+* 安装设置 section（版本自适应；任一策略不可用返回 false 不抛错）。
+* @author ddj 2026年08月24号 / 2026年09月02号
 * @param ctx DSH host 上下文
 * @param ns 设置命名空间
 * @param entry 初始设置值
@@ -168,14 +254,19 @@ function configValue(config) {
 * @returns 是否成功安装
 */
 async function installOpenSettingsSection(ctx, ns, entry, hooks, loader = loadSettingsDeps) {
-	const deps = await loader();
+	let deps = null;
+	try {
+		deps = await loader();
+	} catch {}
 	if (!deps) return false;
-	const schema = deps.z.object({
+	const strategy = await runSettingsInstall(ctx, ns, 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;
+	}), entry, {
+		setSource: (source) => hooks.setSource(source),
+		onChange: hooks.onChange
+	}, loader);
+	return strategy === "legacy" || strategy === "service";
 }
 /**
 * 注册设置命名空间，并提供 host 侧的读取与更新状态。
@@ -370,6 +461,101 @@ async function runPnpmInstall(ctx, profileDir) {
 	}
 }
 //#endregion
+//#region src/dshVersion.ts
+/**
+* dsh-vscode-mode host — DSH 核心版本探测与区间匹配（版本适配机制的地基）。
+* 约定：以运行时可解析的 @deepseek-ai/dsh-settings 包版本代表 DSH 核心版本——
+* 核心包发布锁步同版（rc.2 / alpha.2 全树同版实证），且该包是插件动态依赖面、
+* exports 已放行 ./package.json。解析失败按候选降级（dsh-web-app / dsh-base / dsh），
+* 全部失败返回空串（报告显示"未探测"，功能按能力探测运行）。
+* 纯函数（parse / compare / inRange / familyLabel）可在 node 环境单测。
+* 作者 ddj 2026-09-02
+*/
+const VERSION_RE = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+/** 解析版本串；非法返回 null（不抛错）。 */
+function parseDshVersion(input) {
+	const match = VERSION_RE.exec(input.trim());
+	if (!match) return null;
+	return {
+		major: Number(match[1]),
+		minor: Number(match[2]),
+		patch: Number(match[3]),
+		pre: match[4] ? match[4].split(".") : []
+	};
+}
+/** 预发布标识比较：纯数字按值；数字段 < 字母段；字母按字典序（semver 规则）。 */
+function comparePreId(a, b) {
+	const numericA = /^\d+$/.test(a);
+	const numericB = /^\d+$/.test(b);
+	if (numericA && numericB) return Number(a) - Number(b);
+	if (numericA !== numericB) return numericA ? -1 : 1;
+	return a < b ? -1 : a > b ? 1 : 0;
+}
+/** 比较两个已解析版本：a<b → -1；相等 → 0；a>b → 1。 */
+function compareDshVersions(a, b) {
+	for (const key of [
+		"major",
+		"minor",
+		"patch"
+	]) if (a[key] !== b[key]) return a[key] < b[key] ? -1 : 1;
+	if (a.pre.length === b.pre.length && a.pre.every((part, index) => part === b.pre[index])) return 0;
+	if (a.pre.length === 0) return 1;
+	if (b.pre.length === 0) return -1;
+	const length = Math.max(a.pre.length, b.pre.length);
+	for (let i = 0; i < length; i++) {
+		const left = a.pre[i];
+		const right = b.pre[i];
+		if (left === void 0) return -1;
+		if (right === void 0) return 1;
+		const cmp = comparePreId(left, right);
+		if (cmp !== 0) return cmp;
+	}
+	return 0;
+}
+/** 版本是否落在区间内（入参解析失败一律不命中）。 */
+function inDshRange(version, range) {
+	if (!version) return false;
+	if (range.from) {
+		const lower = parseDshVersion(range.from);
+		if (!lower || compareDshVersions(version, lower) < 0) return false;
+	}
+	if (range.to) {
+		const upper = parseDshVersion(range.to);
+		if (!upper || compareDshVersions(version, upper) > 0) return false;
+	}
+	return true;
+}
+/** 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。 */
+function familyLabel(input) {
+	const version = parseDshVersion(input);
+	if (!version) return "未知";
+	if (inDshRange(version, { from: "0.1.2-alpha.1" })) return "0.1.2-alpha 及更新（设置 API=settings.installSection）";
+	return "0.1.0/0.1.1 rc 线（设置 API=installSettingsSection）";
+}
+/** 探测候选：按与插件运行环境相关性排序，逐个尝试解析 package.json。 */
+const VERSION_CANDIDATES = [
+	"@deepseek-ai/dsh-settings/package.json",
+	"@deepseek-ai/dsh-web-app/package.json",
+	"@deepseek-ai/dsh-base/package.json",
+	"@deepseek-ai/dsh/package.json"
+];
+let detectedVersion;
+/** 探测运行中 DSH 核心版本（模块级缓存；失败空串，不抛错）。 */
+function detectDshVersion() {
+	if (detectedVersion !== void 0) return detectedVersion;
+	detectedVersion = "";
+	const require = createRequire(import.meta.url);
+	for (const specifier of VERSION_CANDIDATES) try {
+		const file = require.resolve(specifier);
+		const pkg = JSON.parse(readFileSync(file, "utf8"));
+		if (typeof pkg.version === "string" && parseDshVersion(pkg.version) !== null) {
+			detectedVersion = pkg.version;
+			break;
+		}
+	} catch {}
+	return detectedVersion;
+}
+//#endregion
 //#region src/shared/rpc.ts
 /** webServer 精确路由。 */
 const RPC_PATH = "/edrv/rpc";
@@ -485,6 +671,14 @@ function pluginCacheRoot(home = dshHome()) {
 function workspaceCacheDir(workspaceId, home = dshHome()) {
 	return join(pluginCacheRoot(home), "workspace", workspaceId);
 }
+/** 用户级缓存目录（跨工作区共享；当前无实例，预留供全局偏好类缓存使用）。 */
+function userCacheDir(home = dshHome()) {
+	return join(pluginCacheRoot(home), "user");
+}
+/** LSP provider 发现结果缓存文件（用户级：user/lsp-specs.v<schema>.json，跨会话/跨重启共享）。 */
+function lspSpecCacheFile(home = dshHome(), schema = 4) {
+	return join(userCacheDir(home), "lsp-specs.v" + schema + ".json");
+}
 /** 插件日志根（~/.dsh/dsh-vscode-mode/logs，用户级）。 */
 function pluginLogRoot(home = dshHome()) {
 	return join(home, PLUGIN_ID, "logs");
@@ -737,26 +931,63 @@ function detectGuards(ctx) {
 		note: duplicates[0] ?? "唯一装配"
 	}];
 }
+/** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
+const TESTED_DSH_MAX = "0.1.2-alpha.4";
+/** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
+function versionAdapters(dshVersion) {
+	const adapters = [];
+	const parsed = parseDshVersion(dshVersion);
+	if (dshVersion === "") adapters.push({
+		name: "DSH 版本",
+		active: false,
+		note: "未探测到版本号（能力探测模式运行）"
+	});
+	else if (!parsed) adapters.push({
+		name: "DSH 版本",
+		active: false,
+		note: "无法解析版本号 " + dshVersion + "（能力探测模式运行）"
+	});
+	else adapters.push({
+		name: "DSH 版本",
+		active: true,
+		note: dshVersion + " · " + familyLabel(dshVersion)
+	});
+	const strategy = settingsInstallStrategy();
+	adapters.push({
+		name: "设置 section 安装（版本适配）",
+		active: strategy === "legacy" || strategy === "service",
+		note: settingsInstallNote()
+	});
+	return adapters;
+}
 /**
 * 构建完整兼容性报告（RPC 与启动日志共用）。
-* @author ddj 2026年08月24号
+* @author ddj 2026年08月24号 / 2026年09月02号
 * @param ctx DSH host 上下文
-* @param options 测试注入：depsAvailable 跳过动态导入、version 固定版本号
+* @param options 测试注入：depsAvailable 跳过动态导入、version 固定插件版本、dshVersion 固定 DSH 版本
 * @returns 兼容性报告
 */
 async function buildReport(ctx, options) {
 	const deps = options?.depsAvailable ?? await loadSettingsDeps() !== null;
+	const dshVersion = options?.dshVersion ?? detectDshVersion();
 	const external = detectExternal(ctx, deps);
 	const guards = detectGuards(ctx);
+	const adapters = versionAdapters(dshVersion);
 	const warnings = [];
 	if (!deps) warnings.push("未安装 @deepseek-ai/dsh-settings：文件打开工具设置持久化不可用（降级为配置值）");
+	if (settingsInstallStrategy() === "none") warnings.push("设置 section 安装不可用：" + settingsInstallNote());
+	const parsed = parseDshVersion(dshVersion);
+	const testedMax = parseDshVersion(TESTED_DSH_MAX);
+	if (parsed && testedMax && compareDshVersions(parsed, testedMax) > 0) warnings.push("DSH " + dshVersion + " 高于已实测版本（0.1.2-alpha.4）：设置 API 按能力探测运行，异常时请回报适配矩阵");
 	for (const guard of guards) if (!guard.active && guard.note) warnings.push(guard.note);
 	return {
 		pluginVersion: options?.version ?? pluginVersionOf(),
 		external,
 		guards,
+		adapters,
 		warnings,
-		devForm: readDevForm()
+		devForm: readDevForm(),
+		dshVersion
 	};
 }
 //#endregion
@@ -4378,7 +4609,8 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				const info = await fs.stat(target);
 				if (!info || info.type !== "file") return {
 					ok: false,
-					error: "文件不存在"
+					error: "文件不存在",
+					resolvedPath: fs.processPath(target)
 				};
 				if ((info.size ?? 0) > 8388608) return {
 					ok: false,
@@ -5453,6 +5685,50 @@ function disposeAllServers() {
 	running.clear();
 }
 //#endregion
+//#region src/shared/lsp.ts
+/** LSP semantic token 标准类型（host 归一化后，client 与 Monaco 共用）。 */
+const LSP_SEMANTIC_TOKEN_TYPES = [
+	"namespace",
+	"type",
+	"class",
+	"enum",
+	"interface",
+	"struct",
+	"typeParameter",
+	"parameter",
+	"variable",
+	"property",
+	"enumMember",
+	"event",
+	"function",
+	"method",
+	"macro",
+	"label",
+	"comment",
+	"string",
+	"keyword",
+	"number",
+	"regexp",
+	"operator",
+	"decorator"
+];
+/** LSP semantic token 标准修饰符（host 归一化后，client 与 Monaco 共用）。 */
+const LSP_SEMANTIC_TOKEN_MODIFIERS = [
+	"declaration",
+	"definition",
+	"readonly",
+	"static",
+	"deprecated",
+	"abstract",
+	"async",
+	"modification",
+	"documentation",
+	"defaultLibrary",
+	"global",
+	"local",
+	"mutable"
+];
+//#endregion
 //#region src/lsp/client.ts
 /**
 * dsh-vscode-mode host — LSP 客户端（JSON-RPC over stdio）。
@@ -5484,7 +5760,10 @@ function createLspClient(transport, events = {}) {
 		references: false,
 		documentSymbol: false,
 		workspaceSymbol: false,
-		hover: false
+		hover: false,
+		semanticTokens: false,
+		semanticTokenTypes: [],
+		semanticTokenModifiers: []
 	};
 	const log = (line) => events.onLog?.(line);
 	createFrameParser();
@@ -5614,16 +5893,30 @@ function createLspClient(transport, events = {}) {
 						definition: { dynamicRegistration: false },
 						references: { dynamicRegistration: false },
 						documentSymbol: { dynamicRegistration: false },
-						hover: { dynamicRegistration: false }
+						hover: { dynamicRegistration: false },
+						semanticTokens: {
+							dynamicRegistration: false,
+							requests: {
+								range: false,
+								full: { delta: false }
+							},
+							tokenTypes: [...LSP_SEMANTIC_TOKEN_TYPES],
+							tokenModifiers: [...LSP_SEMANTIC_TOKEN_MODIFIERS],
+							formats: ["relative"]
+						}
 					}
 				}
 			}))?.capabilities ?? {};
+			const legend = caps.semanticTokensProvider?.legend;
 			serverCapabilities = {
 				definition: Boolean(caps.definitionProvider),
 				references: Boolean(caps.referencesProvider),
 				documentSymbol: Boolean(caps.documentSymbolProvider),
 				workspaceSymbol: Boolean(caps.workspaceSymbolProvider),
-				hover: Boolean(caps.hoverProvider)
+				hover: Boolean(caps.hoverProvider),
+				semanticTokens: Boolean(caps.semanticTokensProvider),
+				semanticTokenTypes: Array.isArray(legend?.tokenTypes) ? legend.tokenTypes.filter((item) => typeof item === "string") : [...LSP_SEMANTIC_TOKEN_TYPES],
+				semanticTokenModifiers: Array.isArray(legend?.tokenModifiers) ? legend.tokenModifiers.filter((item) => typeof item === "string") : [...LSP_SEMANTIC_TOKEN_MODIFIERS]
 			};
 			client.notify("initialized", {});
 			events.onReady?.(serverCapabilities);
@@ -5697,7 +5990,10 @@ function createLspServer(spec, root, languageId, logger) {
 		references: false,
 		documentSymbol: false,
 		workspaceSymbol: false,
-		hover: false
+		hover: false,
+		semanticTokens: false,
+		semanticTokenTypes: [...LSP_SEMANTIC_TOKEN_TYPES],
+		semanticTokenModifiers: [...LSP_SEMANTIC_TOKEN_MODIFIERS]
 	};
 	let disposed = false;
 	let readyWait = Promise.resolve(false);
@@ -5708,9 +6004,15 @@ function createLspServer(spec, root, languageId, logger) {
 		source: spec.kind,
 		phase: "idle",
 		reason: spec.ready ? void 0 : spec.reason,
-		root
+		root,
+		version: spec.version,
+		providerName: spec.providerName ?? (spec.version ? "语言服务器扩展" : void 0)
 	};
 	const log = (line) => logger?.("[" + languageId + "@" + root + "] " + line);
+	const providerInfo = {
+		version: spec.version,
+		providerName: spec.providerName ?? (spec.version ? "EmmyLua" : void 0)
+	};
 	const setPhase = (next, reason) => {
 		phase = next;
 		lastStatus = {
@@ -5719,6 +6021,7 @@ function createLspServer(spec, root, languageId, logger) {
 			phase: next,
 			reason,
 			root,
+			...providerInfo,
 			...progressFields()
 		};
 		server.onStateChange?.(lastStatus);
@@ -5913,6 +6216,17 @@ function createLspServer(spec, root, languageId, logger) {
 			if (!result || !result.contents) return null;
 			return { contents: stringifyHoverContents(result.contents) };
 		},
+		/** 查询全文 semantic tokens，并将服务器 legend 归一到插件固定 legend。 */
+		async semanticTokens(path) {
+			const doc = docs.get(path);
+			if (!doc || !await readyWait || !capabilities.semanticTokens) return null;
+			const result = await ensureClient().request("textDocument/semanticTokens/full", { textDocument: { uri: doc.uri } });
+			if (!result || !Array.isArray(result.data)) return null;
+			return {
+				data: normalizeSemanticData(result.data, capabilities.semanticTokenTypes ?? [], capabilities.semanticTokenModifiers ?? []),
+				resultId: typeof result.resultId === "string" ? result.resultId : void 0
+			};
+		},
 		async dispose() {
 			disposed = true;
 			resolveReady?.(false);
@@ -6021,6 +6335,39 @@ function toInt(value) {
 	const n = Number(value);
 	return Number.isFinite(n) ? Math.max(0, Math.floor(n)) : 0;
 }
+/** 把服务器 legend 下的 5 元组流转换为插件固定 legend 下的 5 元组流。 */
+function normalizeSemanticData(data, types, modifiers) {
+	const out = [];
+	let previousLine = 0;
+	let previousCharacter = 0;
+	let outputLine = 0;
+	let outputCharacter = 0;
+	for (let i = 0; i + 4 < data.length; i += 5) {
+		const deltaLine = toInt(data[i]);
+		const deltaCharacter = toInt(data[i + 1]);
+		const length = toInt(data[i + 2]);
+		const sourceType = types[toInt(data[i + 3])] ?? "variable";
+		const sourceModifiers = toInt(data[i + 4]);
+		const line = previousLine + deltaLine;
+		const character = deltaLine === 0 ? previousCharacter + deltaCharacter : deltaCharacter;
+		const typeIndex = Math.max(0, LSP_SEMANTIC_TOKEN_TYPES.indexOf(sourceType));
+		let modifierBits = 0;
+		for (let bit = 0; bit < modifiers.length; bit++) {
+			if ((sourceModifiers & 1 << bit) === 0) continue;
+			const modifier = modifiers[bit];
+			const targetBit = LSP_SEMANTIC_TOKEN_MODIFIERS.indexOf(modifier);
+			if (targetBit >= 0) modifierBits |= 1 << targetBit;
+		}
+		const outputDeltaLine = line - outputLine;
+		const outputDeltaCharacter = outputDeltaLine === 0 ? character - outputCharacter : character;
+		out.push(outputDeltaLine, outputDeltaCharacter, length, typeIndex, modifierBits);
+		previousLine = line;
+		previousCharacter = character;
+		outputLine = line;
+		outputCharacter = character;
+	}
+	return out;
+}
 //#endregion
 //#region src/lsp/manager.ts
 /**
@@ -6079,6 +6426,13 @@ function createLspManager(logger) {
 		releaseRoot(root) {
 			for (const entry of [...entries.values()]) if (entry.server.root === root) dropEntry(entry);
 		},
+		reset(root, languageId) {
+			const entry = entries.get(keyOf(root, languageId));
+			if (entry) dropEntry(entry);
+		},
+		resetLanguage(languageId) {
+			for (const entry of [...entries.values()]) if (entry.server.languageId === languageId) dropEntry(entry);
+		},
 		statusAll() {
 			return [...entries.values()].map((entry) => entry.server.status());
 		},
@@ -6388,7 +6742,9 @@ function extensionProviderFor(languageId) {
 		kind: "extension",
 		argv: p.argv,
 		cwd: p.cwd,
-		ready: true
+		ready: true,
+		version: p.version,
+		providerName: p.version ? "EmmyLua" : "语言服务器扩展"
 	};
 }
 /** PATH 中查找可执行文件（不含扩展名校验，交由 spawn 报错）。 */
@@ -6416,6 +6772,25 @@ function findDotnet() {
 	for (const c of ["C:/Program Files/dotnet/dotnet.exe", "C:/Program Files (x86)/dotnet/dotnet.exe"]) if (existsSync(c)) return c;
 	return null;
 }
+/** EmmyLua 自动发现候选（tangzx.emmylua-* / server/emmylua_ls）。 */
+function candidateEmmyLua(home = dshHome()) {
+	const candidates = [];
+	for (const dir of vscodeExtensionsDirs(home)) for (const extDir of listMatchingDirs(dir, "tangzx.emmylua-")) {
+		const server = join(extDir, "server", "emmylua_ls" + exeSuffix());
+		if (!existsSync(server)) continue;
+		let version;
+		try {
+			const manifest = JSON.parse(readFileSync(join(extDir, "package.json"), "utf8"));
+			if (typeof manifest.version === "string") version = manifest.version;
+		} catch (error) {}
+		candidates.push({
+			path: server,
+			version
+		});
+	}
+	candidates.sort((a, b) => (b.version ?? "").localeCompare(a.version ?? "", void 0, { numeric: true }) || a.path.localeCompare(b.path));
+	return candidates[0] ?? null;
+}
 /** LuaLS 自动发现候选（VSCode 扩展目录 + extmgr 目录下 sumneko.lua-* 的 server/bin 可执行）。 */
 function candidateLuaServers(home = dshHome()) {
 	const plat = platformServerDir();
@@ -6497,30 +6872,41 @@ function resolveLuaProvider(manual, home = dshHome()) {
 		cwd: manualResolved.cwd,
 		ready: true
 	};
-	const ext = extensionProviderFor("lua");
-	if (ext) return ext;
-	const candidates = candidateLuaServers(home);
-	if (candidates.length) return {
-		...base,
-		kind: "discover",
-		argv: [candidates[0]],
-		cwd: void 0,
-		ready: true
-	};
-	const inPath = findInPath("lua-language-server" + exeSuffix());
-	if (inPath) return {
-		...base,
-		kind: "discover",
-		argv: [inPath],
-		ready: true
-	};
-	return {
-		...base,
-		kind: "none",
-		argv: [],
-		ready: false,
-		reason: manualResolved.reason ?? "未发现 lua-language-server（可安装 LuaLS 或手动指定路径）"
-	};
+	return resolveCached("lua", manual, home, (h) => {
+		const ext = extensionProviderFor("lua");
+		if (ext) return ext;
+		const emmy = candidateEmmyLua(h);
+		if (emmy) return {
+			...base,
+			kind: "extension",
+			argv: [emmy.path],
+			ready: true,
+			version: emmy.version,
+			providerName: "EmmyLua"
+		};
+		const candidates = candidateLuaServers(h);
+		if (candidates.length) return {
+			...base,
+			kind: "discover",
+			argv: [candidates[0]],
+			cwd: void 0,
+			ready: true
+		};
+		const inPath = findInPath("lua-language-server" + exeSuffix());
+		if (inPath) return {
+			...base,
+			kind: "discover",
+			argv: [inPath],
+			ready: true
+		};
+		return {
+			...base,
+			kind: "none",
+			argv: [],
+			ready: false,
+			reason: manualResolved.reason ?? "未发现 lua-language-server（可安装 LuaLS 或手动指定路径）"
+		};
+	});
 }
 /**
 * 解析 C# provider（优先级：手动 > 扩展源 > 自动发现；需 dotnet + Roslyn dll；或 OmniSharp）。
@@ -6539,40 +6925,163 @@ function resolveCSharpProvider(manual, home = dshHome()) {
 		cwd: manualResolved.cwd,
 		ready: true
 	};
-	const ext = extensionProviderFor("csharp");
-	if (ext) return ext;
-	const discovered = candidateCSharpServers(home);
-	if (discovered.roslynDll && discovered.dotnet) return {
-		...base,
-		kind: "discover",
-		argv: [
-			discovered.dotnet,
-			discovered.roslynDll,
-			"--stdio"
-		],
-		ready: true
-	};
-	if (discovered.omnisharpExe) return {
-		...base,
-		kind: "discover",
-		argv: [discovered.omnisharpExe, "--stdio"],
-		ready: true
-	};
-	const reasons = [];
-	if (!discovered.dotnet) reasons.push("未找到 dotnet");
-	if (!discovered.roslynDll && !discovered.omnisharpExe) reasons.push("未发现 ms-dotnettools.csharp 扩展");
-	return {
-		...base,
-		kind: "none",
-		argv: [],
-		ready: false,
-		reason: reasons.join("；") + "（可手动指定 Roslyn/OmniSharp 入口）"
-	};
+	return resolveCached("csharp", manual, home, (h) => {
+		const ext = extensionProviderFor("csharp");
+		if (ext) return ext;
+		const discovered = candidateCSharpServers(h);
+		if (discovered.roslynDll && discovered.dotnet) return {
+			...base,
+			kind: "discover",
+			argv: [
+				discovered.dotnet,
+				discovered.roslynDll,
+				"--stdio"
+			],
+			ready: true
+		};
+		if (discovered.omnisharpExe) return {
+			...base,
+			kind: "discover",
+			argv: [discovered.omnisharpExe, "--stdio"],
+			ready: true
+		};
+		const reasons = [];
+		if (!discovered.dotnet) reasons.push("未找到 dotnet");
+		if (!discovered.roslynDll && !discovered.omnisharpExe) reasons.push("未发现 ms-dotnettools.csharp 扩展");
+		return {
+			...base,
+			kind: "none",
+			argv: [],
+			ready: false,
+			reason: reasons.join("；") + "（可手动指定 Roslyn/OmniSharp 入口）"
+		};
+	});
 }
 const PROVIDER_RESOLVERS = {
 	lua: resolveLuaProvider,
 	csharp: resolveCSharpProvider
 };
+/** 进程级缓存（home|languageId → 条目），同一 DSH home 的不同会话共享。 */
+const specCache = /* @__PURE__ */ new Map();
+/** 磁盘缓存是否已载入本进程（home → loaded），不同 profile 不串缓存。 */
+const diskLoaded = /* @__PURE__ */ new Set();
+/** 自动发现成功结果的复用时长；过期后才检查目录指纹。 */
+const SPEC_CACHE_TTL_MS = 18e5;
+/** 未发现结果的短缓存时长，避免缺失服务器时反复扫描 PATH。 */
+const SPEC_NEGATIVE_CACHE_MS = 6e4;
+/** 生成带 home 的缓存键，避免不同 profile 的 provider 结果串用。 */
+function cacheEntryKey(home, languageId) {
+	return home + "|" + languageId;
+}
+/**
+* 构造缓存 key：语言 + 手动配置（manual 结果不缓存，故只参与"是否走缓存"判定）。
+* @author ddj 2026年08月28号
+* @param languageId 语言 id
+* @param manual 手动配置
+* @returns 缓存 key（manual 有效时返回空串表示跳过缓存）
+*/
+function cacheKeyOf(languageId, manual) {
+	const pathValue = manual?.path?.trim() ?? "";
+	const commandValue = manual?.command?.trim() ?? "";
+	if (pathValue || commandValue) return "";
+	return languageId;
+}
+/**
+* 环境指纹：扩展目录清单 + 平台。目录增删/换平台即失效（防缓存陈旧指向已删扩展）。
+* @author ddj 2026年08月28号
+* @param home DSH home
+* @returns 指纹串
+*/
+function fingerprintOf(home) {
+	const marks = vscodeExtensionsDirs(home).map((dir) => {
+		try {
+			return readdirSync(dir).sort().join(",");
+		} catch (error) {
+			return "?";
+		}
+	});
+	return process.platform + "|" + marks.join("|");
+}
+/**
+* 读取磁盘缓存（幂等：每进程只载一次；schema 文件名已隔离版本）。
+* @author ddj 2026年08月28号
+* @param home DSH home
+*/
+function loadDiskCache(home) {
+	if (diskLoaded.has(home)) return;
+	diskLoaded.add(home);
+	const file = lspSpecCacheFile(home);
+	try {
+		const raw = JSON.parse(readFileSync(file, "utf8"));
+		for (const [languageId, entry] of Object.entries(raw)) if (entry && typeof entry === "object" && entry.spec && typeof entry.fingerprint === "string") specCache.set(cacheEntryKey(home, languageId), entry);
+	} catch (error) {}
+}
+/**
+* 写回磁盘缓存（best-effort；写失败不影响本次解析结果）。
+* @author ddj 2026年08月28号
+* @param home DSH home
+*/
+function saveDiskCache(home) {
+	const file = lspSpecCacheFile(home);
+	try {
+		mkdirSync(dirname(file), { recursive: true });
+		const out = {};
+		const prefix = home + "|";
+		for (const [key, entry] of specCache) if (key.startsWith(prefix)) out[key.slice(prefix.length)] = entry;
+		writeFileSync(file, JSON.stringify(out), "utf8");
+	} catch (error) {}
+}
+/**
+* 带缓存执行 provider 解析（自动发现路径专用）。
+* @author ddj 2026年08月28号
+* @param languageId 语言 id
+* @param manual 手动配置
+* @param home DSH home
+* @param resolve 真解析函数（未命中时调用）
+* @returns provider 规格
+*/
+function resolveCached(languageId, manual, home, resolve) {
+	const key = cacheKeyOf(languageId, manual);
+	if (!key) return resolve(home);
+	loadDiskCache(home);
+	const fullKey = cacheEntryKey(home, key);
+	const hit = specCache.get(fullKey);
+	if (hit && isCacheFresh(hit)) return hit.spec;
+	const fingerprint = fingerprintOf(home);
+	if (hit && hit.fingerprint === fingerprint) {
+		hit.at = Date.now();
+		return hit.spec;
+	}
+	const spec = resolve(home);
+	specCache.set(fullKey, {
+		spec,
+		fingerprint,
+		at: Date.now()
+	});
+	saveDiskCache(home);
+	return spec;
+}
+/** 判断缓存条目是否仍可直接复用，不触发扩展目录扫描。 */
+function isCacheFresh(entry) {
+	const age = Date.now() - entry.at;
+	const ttl = entry.spec.kind === "none" ? SPEC_NEGATIVE_CACHE_MS : SPEC_CACHE_TTL_MS;
+	if (age < 0 || age >= ttl) return false;
+	const executable = entry.spec.argv[0];
+	return !entry.spec.ready || !executable || existsSync(executable);
+}
+/**
+* 清空 provider 发现缓存（扩展安装/卸载、配置变更后调用；进程级 + 删磁盘文件）。
+* @author ddj 2026年08月28号
+* @param home DSH home（缺省真实）
+*/
+function clearProviderCache(home = dshHome()) {
+	const prefix = home + "|";
+	for (const key of specCache.keys()) if (key.startsWith(prefix)) specCache.delete(key);
+	diskLoaded.delete(home);
+	try {
+		rmSync(lspSpecCacheFile(home), { force: true });
+	} catch (error) {}
+}
 //#endregion
 //#region src/lsp/config.ts
 const LSP_SETTINGS_NS = "dsh-vscode-mode.languageServers";
@@ -6736,6 +7245,21 @@ function createDocTracker() {
 			}
 			sessionDocs.delete(sessionId);
 			return [...toRelease];
+		},
+		/** 清除指定语言的文档归属，让当前客户端重新同步时重新 acquire。 */
+		resetLanguage(languageId) {
+			for (const [docKey, owners] of openDocs) {
+				if (!docKey.includes("|" + languageId + "|")) continue;
+				for (const sessionId of owners) forgetDoc(sessionId, docKey);
+				openDocs.delete(docKey);
+			}
+			for (const key of [...rootLangRefs.keys()]) if (key.endsWith("|" + languageId)) rootLangRefs.delete(key);
+		},
+		/** 返回指定会话已打开的文档路径，用于重检测后恢复同步。 */
+		pathsFor(sessionId, languageId) {
+			const docs = sessionDocs.get(sessionId);
+			if (!docs) return [];
+			return [...docs].filter((key) => key.includes("|" + languageId + "|")).map((key) => key.slice(key.lastIndexOf("|") + 1));
 		}
 	};
 }
@@ -6768,6 +7292,39 @@ function createLspRpc(deps) {
 		...location,
 		root
 	}));
+	/** 当前 provider 检测结论 → 设置页 idle 状态（不启动 server）。 */
+	const detectedStatus = (languageId, root) => {
+		const spec = resolveProviderSpec(ctx, pluginConfig, languageId);
+		return {
+			languageId,
+			source: spec.kind,
+			phase: "idle",
+			reason: spec.ready ? void 0 : spec.reason,
+			version: spec.version,
+			providerName: spec.providerName,
+			root
+		};
+	};
+	/**
+	* 清发现缓存并重置旧 server（保留 tracker 文档记录）；
+	* 下一次模型同步会按最新配置重新 acquire，已打开文档无需重开。
+	* 作者 ddj 2026年09月02号
+	* @param languageId 语言 id
+	* @param sessionId 会话语境（缺省重置全部工作区该语言）
+	* @returns 检测后的 idle 状态列表
+	*/
+	const redetectLanguage = async (languageId, sessionId) => {
+		clearProviderCache();
+		if (sessionId) {
+			const sc = await rootOf(sessionId);
+			if ("err" in sc) return [];
+			manager.reset(sc.root, languageId);
+			return [detectedStatus(languageId, sc.root)];
+		}
+		const roots = [...new Set(manager.statusAll().filter((s) => s.languageId === languageId).map((s) => s.root))];
+		manager.resetLanguage(languageId);
+		return roots.length ? roots.map((root) => detectedStatus(languageId, root)) : [detectedStatus(languageId)];
+	};
 	const disposeSession = (sessionId) => {
 		for (const rl of tracker.closeSession(sessionId)) {
 			const sep = rl.lastIndexOf("|");
@@ -6825,13 +7382,15 @@ function createLspRpc(deps) {
 						error: "设置服务不可用"
 					};
 					await settings.update(LSP_SETTINGS_NS, { [lang]: target });
+					const servers = await redetectLanguage(lang);
 					const stored = (settings.describe?.({ redactSecrets: true })?.find((item) => item.ns === LSP_SETTINGS_NS))?.value;
 					return {
 						ok: true,
 						config: {
 							...configFromPlugin(pluginConfig),
 							...stored
-						}
+						},
+						servers
 					};
 				} catch (error) {
 					return {
@@ -7006,6 +7565,51 @@ function createLspRpc(deps) {
 					};
 				}
 			},
+			"edrv.lsp.semanticTokens": async (args) => {
+				const lang = langOfPath(args.path);
+				if (!lang) return {
+					ok: true,
+					tokens: void 0
+				};
+				const sc = await rootOf(args.sessionId);
+				if ("err" in sc) return {
+					ok: false,
+					error: sc.err
+				};
+				try {
+					const server = serverOf(sc.root, lang);
+					if (!server) return {
+						ok: true,
+						tokens: void 0
+					};
+					return {
+						ok: true,
+						tokens: await server.semanticTokens(args.path) ?? void 0
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "LSP 语义分色查询失败：" + String(error)
+					};
+				}
+			},
+			"edrv.lsp.redetect": async (args) => {
+				if (!LSP_LANGUAGES.includes(args.languageId)) return {
+					ok: false,
+					error: "不支持的语言：" + args.languageId
+				};
+				try {
+					return {
+						ok: true,
+						servers: await redetectLanguage(args.languageId)
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "重新检测失败：" + String(error)
+					};
+				}
+			},
 			"edrv.lsp.ext.list": async () => ({
 				ok: true,
 				extensions: listInstalled()
@@ -7032,6 +7636,7 @@ function createLspRpc(deps) {
 						ok: false,
 						error: "缺少安装源（vsixPath 或 namespace+name）"
 					};
+					clearProviderCache();
 					return {
 						ok: true,
 						extension: info
@@ -7044,7 +7649,9 @@ function createLspRpc(deps) {
 				}
 			},
 			"edrv.lsp.ext.uninstall": async (args) => {
-				return uninstall(args.id) ? { ok: true } : {
+				const ok = uninstall(args.id);
+				if (ok) clearProviderCache();
+				return ok ? { ok: true } : {
 					ok: false,
 					error: "扩展未安装：" + args.id
 				};
@@ -7063,6 +7670,7 @@ function createLspRpc(deps) {
 							error: "扩展未安装：" + args.id
 						};
 					}
+					clearProviderCache();
 					return {
 						ok: true,
 						extension: updated,
@@ -7113,7 +7721,10 @@ function createLspRpc(deps) {
 * @returns 是否成功安装
 */
 async function installLspSettingsSection(ctx, entry) {
-	const deps = await loadSettingsDeps();
+	let deps = null;
+	try {
+		deps = await loadSettingsDeps();
+	} catch {}
 	if (!deps) return false;
 	try {
 		const z = deps.z;
@@ -7124,11 +7735,11 @@ async function installLspSettingsSection(ctx, entry) {
 			path: z.string()
 		}).default({});
 		const schema = z.object(langShape).default({});
-		deps.installSettingsSection(ctx, LSP_SETTINGS_NS, schema, entry, {
+		const strategy = await runSettingsInstall(ctx, LSP_SETTINGS_NS, schema, entry, {
 			setSource: () => {},
 			onChange: () => {}
 		});
-		return true;
+		return strategy === "legacy" || strategy === "service";
 	} catch (error) {
 		console.error("[dsh-vscode-mode] LSP 设置 section 安装失败：" + String(error));
 		return false;
@@ -7214,7 +7825,7 @@ async function logCompatSummary(ctx, warnings) {
 		for (const warning of warnings) report.warnings.push(warning);
 		const logger = ctx.logger;
 		if (!logger?.info) return;
-		const head = "[dsh-vscode-mode] 兼容性：" + report.external.length + " 项外部适配 / " + report.guards.length + " 项护栏";
+		const head = "[dsh-vscode-mode] 兼容性：" + (report.dshVersion ? "DSH " + report.dshVersion : "DSH 未探测") + " · " + report.external.length + " 项外部适配 / " + report.guards.length + " 项护栏 / " + (report.adapters?.length ?? 0) + " 项版本适配";
 		if (report.warnings.length) logger.warn?.(head + "，警告 " + report.warnings.length + " 条：" + report.warnings.join("；"));
 		else logger.info?.(head + "，无警告");
 	} catch (error) {