dsh-vscode-mode 0.1.42 → 0.1.44

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";
@@ -745,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
@@ -7498,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;
@@ -7509,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;
@@ -7599,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) {