dsh-vscode-mode 0.14.3 → 0.14.5

package/lib/index.js

@@ -108,6 +108,7 @@ function guardMcp(ctx, exec) {
 	const server = callServer(exec);
 	const owners = serverOwners(ctx);
 	const current = runtimeOf(ctx).workspace(exec.agent);
+	if (!RESOURCE_TOOLS.has(name) && [...mcpNames(ctx)].filter((key) => name.startsWith("mcp__" + key + "__")).length > 1) return "已拒绝：MCP 命名空间冲突，无法确认工具归属";
 	if (!(RESOURCE_TOOLS.has(name) ? [...owners].filter(([key]) => key === server) : [...owners].filter(([key]) => name.startsWith("mcp__" + key + "__"))).some(([, owner]) => owner !== current)) return void 0;
 	return current === void 0 ? "项目 MCP 需要在已注册工作区的对话中使用" : "已拒绝：当前对话工作区不能使用其他项目的 MCP";
 }
@@ -394,7 +395,7 @@ var McpRuntime = class {
 		const update = async () => {
 			this.projects.set(path, defs);
 			this.changed();
-			for (const [agent, record] of this.agents) await this.syncAgent(agent, record, refresh);
+			for (const [agent, record] of this.agents) await this.syncAgent(agent, record, this.workspace(agent) === path ? refresh : void 0);
 			this.changed();
 		};
 		return this.enqueue(update);
@@ -477,7 +478,7 @@ var McpRuntime = class {
 		const defs = this.projects.get(path ?? "") ?? /* @__PURE__ */ new Map();
 		for (const [name, instance] of record.instances) {
 			const def = defs.get(name);
-			if (def?.enabled && instance.key === JSON.stringify(def.config) && name !== refresh) continue;
+			if (def?.enabled && instance.path === path && instance.key === JSON.stringify(def.config) && name !== refresh) continue;
 			await this.stopOne(record, name);
 		}
 		for (const [name, def] of defs) {
@@ -487,6 +488,20 @@ var McpRuntime = class {
 		}
 	}
 	/**
+	* Cache successful module loads while allowing explicit refresh after transient failures.
+	* @private @author ddj 2026年10月08号
+	* @returns Official plugin module; load failures propagate to the instance diagnostic.
+	*/
+	async getModule() {
+		const loading = this.module ??= this.load();
+		try {
+			return await loading;
+		} catch (error) {
+			if (this.module === loading) this.module = void 0;
+			throw error;
+		}
+	}
+	/**
 	* Mount the official plugin through agent.ctx; ACTIVE is not connection evidence.
 	* @private @author ddj 2026年09月28号
 	* @param agent Scoped context owner.
@@ -502,7 +517,7 @@ var McpRuntime = class {
 		};
 		record.instances.set(config.serverName, instance);
 		try {
-			const officialMcp = await (this.module ??= this.load());
+			const officialMcp = await this.getModule();
 			if (!record.live || this.stopped) return;
 			if (entriesOf(this.ctx).find((entry) => !isProjectEntryId(String(entry.id ?? entry.options?.id ?? "")) && entry.options?.config?.serverName === config.serverName)) throw new Error("serverName 已被全局 MCP 使用：" + config.serverName);
 			const options = config.transport === "stdio" ? {
@@ -630,6 +645,7 @@ async function installMcpRuntime(ctx) {
 //#region src/mcpProject.ts
 /** Project MCP configuration; .mcp.json is the source of truth. @author ddj 2026年09月28号 */
 const FILE_NAME = ".mcp.json";
+const projectStates = /* @__PURE__ */ new WeakMap();
 /**
 * Require an exact registered workspace before any project file mutation.
 * @private @author ddj 2026年09月28号
@@ -671,7 +687,17 @@ function projectEntryId(workspacePath, serverName) {
 	return PROJECT_ENTRY_PREFIX + hashWorkspace(workspacePath) + "." + serverName;
 }
 /**
-* Read the complete source document; only ENOENT denotes an absent configuration.
+* Identify an absent target using official host and legacy Node filesystem codes.
+* @private @author ddj 2026年10月08号
+* @param error Filesystem failure; messages and class identity are not authoritative.
+* @returns Whether the backend explicitly reports a missing target.
+*/
+function isMissingFile(error) {
+	const code = error?.code;
+	return code === "FS_NOT_FOUND" || code === "ENOENT";
+}
+/**
+* Read the complete source document; only missing-target codes denote an absent configuration.
 * @private @author ddj 2026年09月28号
 * @param ctx Host filesystem.
 * @param workspacePath Registered workspace path.
@@ -685,7 +711,7 @@ async function readProjectJson(ctx, workspacePath) {
 	try {
 		text = await fs.readText(target);
 	} catch (error) {
-		if (error?.code === "ENOENT") return {};
+		if (isMissingFile(error)) return {};
 		throw new Error(".mcp.json 读取失败：" + String(error));
 	}
 	let data;
@@ -723,7 +749,17 @@ function serversOf(data) {
 */
 function configFromDef(def, serverName) {
 	if (!def) return null;
-	const transport = typeof def.url === "string" ? "streamable-http" : "stdio";
+	if (def.transport !== void 0 && !["stdio", "streamable-http"].includes(def.transport)) throw new Error("不支持的 MCP transport：" + serverName);
+	if (def.args !== void 0 && (!Array.isArray(def.args) || def.args.some((arg) => typeof arg !== "string"))) throw new Error("MCP args 必须是字符串数组：" + serverName);
+	for (const field of ["env", "headers"]) {
+		const values = def[field];
+		if (values !== void 0 && (!values || typeof values !== "object" || Array.isArray(values) || Object.values(values).some((value) => value === null || ![
+			"string",
+			"number",
+			"boolean"
+		].includes(typeof value)))) throw new Error("MCP " + field + " 必须是标量字典：" + serverName);
+	}
+	const transport = def.transport ?? (typeof def.url === "string" ? "streamable-http" : "stdio");
 	const config = {
 		serverName,
 		transport
@@ -766,15 +802,19 @@ async function writeProjectJson(ctx, workspacePath, data) {
 * @returns Completion; throws on collision or an unreadable competing source document.
 */
 async function checkMcpName(ctx, serverName, workspacePath) {
-	const conflict = "serverName \"" + serverName + "\" 已被另一个 MCP 使用（全局或其他项目），请换一个名称";
+	/** @private @author ddj 2026年10月08号 @param other Existing name. @param sameOwner Whether updates share ownership. @throws Error for ambiguous namespaces. */
+	const checkName = (other, sameOwner) => {
+		if (nameOverlap(serverName, other)) throw new Error("MCP 命名空间冲突：" + serverName + " / " + other + "，请避免 __ 前缀交叠");
+		if (other === serverName && !sameOwner) throw new Error("serverName \"" + serverName + "\" 已被另一个 MCP 使用（全局或其他项目），请换一个名称");
+	};
 	for (const entry of entriesOf(ctx)) {
-		if (isProjectEntryId(String(entry.id ?? entry.options?.id ?? "")) || workspacePath === void 0) continue;
-		if (entry.options?.config?.serverName === serverName) throw new Error(conflict);
+		if (isProjectEntryId(String(entry.id ?? entry.options?.id ?? ""))) continue;
+		const name = entry.options?.config?.serverName;
+		if (typeof name === "string") checkName(name, workspacePath === void 0);
 	}
 	for (const ws of ctx.get("workspaceRegistry")?.list?.() ?? []) {
-		if (ws.path === workspacePath) continue;
 		const servers = serversOf(await readProjectJson(ctx, ws.path));
-		if (Object.hasOwn(servers, serverName)) throw new Error(conflict);
+		for (const name of Object.keys(servers)) checkName(name, ws.path === workspacePath);
 	}
 }
 /**
@@ -818,9 +858,16 @@ async function projectOf(ctx, workspacePath, title) {
 		missingDir = !info || info.type !== "directory";
 		if (!missingDir) await reconcileProject(ctx, workspacePath);
 	} catch (error) {
-		missingDir = error?.code === "ENOENT" || void 0;
+		missingDir = isMissingFile(error) || void 0;
 		fileError = String(error);
 	}
+	const owner = ctx.root ?? ctx;
+	const states = projectStates.get(owner) ?? /* @__PURE__ */ new Map();
+	states.set(workspacePath, {
+		missingDir,
+		fileError
+	});
+	projectStates.set(owner, states);
 	return {
 		workspacePath,
 		title,
@@ -842,6 +889,26 @@ async function listProjects(ctx) {
 	return { projects };
 }
 /**
+* Read the current ledger only; polling never reconciles files or starts connections.
+* @public @author ddj 2026年10月08号
+* @param ctx Host services.
+* @returns Masked global/project snapshots with last configuration diagnostics.
+*/
+function mcpSnapshot(ctx) {
+	const states = projectStates.get(ctx.root ?? ctx);
+	const projects = (ctx.get("workspaceRegistry")?.list?.() ?? []).map((ws) => ({
+		workspacePath: ws.path,
+		title: ws.title ?? "",
+		source: "project",
+		servers: runtimeOf(ctx).views(ws.path),
+		...states?.get(ws.path)
+	}));
+	return {
+		...listMcp(ctx),
+		projects
+	};
+}
+/**
 * Merge editable fields while retaining advanced fields and unchanged masked credentials.
 * @private @author ddj 2026年09月28号
 * @param previous Persisted server definition.
@@ -849,20 +916,10 @@ async function listProjects(ctx) {
 * @returns Enabled source definition without runtime-only keys or stale transport fields.
 */
 function mergeDefinition(previous, config) {
-	const next = mergeSecrets({
-		...previous,
-		...config
-	}, previous);
+	const next = mergeMcp(previous, config);
 	delete next.serverName;
 	delete next.transport;
 	delete next.disabled;
-	const stale = config.transport === "stdio" ? ["url", "headers"] : [
-		"command",
-		"args",
-		"cwd",
-		"env"
-	];
-	for (const key of stale) delete next[key];
 	return next;
 }
 /**
@@ -875,6 +932,10 @@ function mergeDefinition(previous, config) {
 * @returns Updated project view; invalid sources or conflicts reject before writing.
 */
 async function projectSave(ctx, workspacePath, serverName, config) {
+	return mcpEdit(ctx, () => saveProject(ctx, workspacePath, serverName, config));
+}
+/** @private @author ddj 2026年10月08号 @param ctx Host services. @param workspacePath Owner. @param serverName Namespace. @param config Editable fields. @returns Persisted project status. */
+async function saveProject(ctx, workspacePath, serverName, config) {
 	const workspace = requireWorkspace$2(ctx, workspacePath);
 	validateConfig({
 		...config,
@@ -903,6 +964,10 @@ async function projectSave(ctx, workspacePath, serverName, config) {
 * @returns Updated project view; write failures leave active configuration intact.
 */
 async function projectRemove(ctx, workspacePath, serverName) {
+	return mcpEdit(ctx, () => removeProject(ctx, workspacePath, serverName));
+}
+/** @private @author ddj 2026年10月08号 @param ctx Host services. @param workspacePath Owner. @param serverName Namespace. @returns Project after persisted removal. */
+async function removeProject(ctx, workspacePath, serverName) {
 	const workspace = requireWorkspace$2(ctx, workspacePath);
 	const data = await readProjectJson(ctx, workspacePath);
 	const servers = serversOf(data);
@@ -924,6 +989,10 @@ async function projectRemove(ctx, workspacePath, serverName) {
 * @returns Updated project view, including retained disabled definitions.
 */
 async function projectToggle(ctx, workspacePath, serverName, enabled) {
+	return mcpEdit(ctx, () => toggleProject(ctx, workspacePath, serverName, enabled));
+}
+/** @private @author ddj 2026年10月08号 @param ctx Host services. @param workspacePath Owner. @param serverName Namespace. @param enabled Desired state. @returns Project after persisted toggle. */
+async function toggleProject(ctx, workspacePath, serverName, enabled) {
 	const workspace = requireWorkspace$2(ctx, workspacePath);
 	const data = await readProjectJson(ctx, workspacePath);
 	const servers = serversOf(data);
@@ -947,6 +1016,10 @@ async function projectToggle(ctx, workspacePath, serverName, enabled) {
 * @returns Updated project view; disabled or idle definitions stay connection-free.
 */
 async function projectRefresh(ctx, workspacePath, serverName) {
+	return mcpEdit(ctx, () => refreshProject(ctx, workspacePath, serverName));
+}
+/** @private @author ddj 2026年10月08号 @param ctx Host services. @param workspacePath Owner. @param serverName Namespace. @returns Refreshed project status without racing edits. */
+async function refreshProject(ctx, workspacePath, serverName) {
 	const workspace = requireWorkspace$2(ctx, workspacePath);
 	const data = await readProjectJson(ctx, workspacePath);
 	if (!Object.hasOwn(serversOf(data), serverName)) throw new Error("项目中不存在该 MCP");
@@ -961,6 +1034,44 @@ async function projectRefresh(ctx, workspacePath, serverName) {
 * 身份常量（包名/条目前缀/新旧格式判定）统一由 compat 层持有，本模块再导出保持既有 import 面。
 * 作者 ddj 2026年08月22号
 */
+/**
+* Compare the official tool-name namespaces without guessing the longest prefix.
+* @public @author ddj 2026年10月08号
+* @param left First server name.
+* @param right Second server name.
+* @returns Whether distinct names generate overlapping public tool names.
+*/
+function nameOverlap(left, right) {
+	return left !== right && (left.startsWith(right + "__") || right.startsWith(left + "__"));
+}
+/**
+* Collect known global and project namespaces without opening connections.
+* @public @author ddj 2026年10月08号
+* @param ctx Host context.
+* @returns Distinct server names used for fail-closed attribution.
+*/
+function mcpNames(ctx) {
+	const names = new Set(runtimeOf(ctx).owners().keys());
+	for (const entry of entriesOf(ctx)) {
+		const name = entry.options?.config?.serverName;
+		if (typeof name === "string") names.add(name);
+	}
+	return names;
+}
+const edits = /* @__PURE__ */ new WeakMap();
+/**
+* Serialize profile/project edits together to preserve files and cross-scope name reservations.
+* @public @author ddj 2026年10月08号
+* @param ctx Host owner.
+* @param action Validated configuration operation.
+* @returns Operation result; a rejection never poisons the next edit.
+*/
+function mcpEdit(ctx, action) {
+	const owner = ctx.root ?? ctx;
+	const next = (edits.get(owner) ?? Promise.resolve()).then(action, action);
+	edits.set(owner, next);
+	return next;
+}
 /** 列出当前 loader 中的 MCP entry。 */
 function entriesOf(ctx) {
 	const loader = ctx.get("loader");
@@ -986,7 +1097,10 @@ function toolsOf(ctx, serverName, agent) {
 	const visible = (ctx.get("tools")?.view?.(agent))?.visible;
 	if (!(visible instanceof Map)) return [];
 	const prefix = `mcp__${serverName}__`;
-	return [...visible.entries()].filter(([name]) => String(name).startsWith(prefix)).map(([name, definition]) => ({
+	const namespaces = mcpNames(ctx);
+	namespaces.add(serverName);
+	const belongs = (name) => name.startsWith(prefix) && [...namespaces].filter((server) => name.startsWith("mcp__" + server + "__")).length === 1;
+	return [...visible.entries()].filter(([name]) => belongs(String(name))).map(([name, definition]) => ({
 		name: String(name).slice(prefix.length),
 		description: typeof definition?.description === "string" ? definition.description : void 0
 	}));
@@ -1018,6 +1132,27 @@ function mergeSecrets(next, previous) {
 	return merged;
 }
 /**
+* Merge editable transport fields while retaining advanced settings and secret values.
+* @public @author ddj 2026年10月08号
+* @param previous Last saved configuration.
+* @param config Submitted transport configuration.
+* @returns Detached configuration without fields belonging to the old transport.
+*/
+function mergeMcp(previous, config) {
+	const next = mergeSecrets({
+		...previous,
+		...config
+	}, previous);
+	const stale = config.transport === "stdio" ? ["url", "headers"] : [
+		"command",
+		"args",
+		"cwd",
+		"env"
+	];
+	for (const key of stale) delete next[key];
+	return next;
+}
+/**
 * Summarize a global entry without treating plugin activation as a successful handshake.
 * @public @author ddj 2026年09月28号
 * @param ctx Host services.
@@ -1042,11 +1177,42 @@ function serverOf(ctx, entry) {
 		error: state === 3 ? "MCP 插件未正常运行" : void 0
 	};
 }
-/** 校验 MCP 配置。 */
+/**
+* Validate transport fields before any loader or source mutation.
+* @public @author ddj 2026年10月08号
+* @param config Submitted configuration.
+* @throws Error for unsupported transport or malformed endpoint/arguments/maps.
+*/
 function validateConfig(config) {
-	if (!/^[A-Za-z0-9_-]{1,32}$/.test(config.serverName)) throw new Error("serverName 只能包含字母、数字、下划线和连字符（最多 32 位）");
-	if (config.transport === "stdio" && !config.command?.trim()) throw new Error("stdio MCP 必须填写 command");
-	if (config.transport === "streamable-http" && !/^https?:\/\//.test(config.url ?? "")) throw new Error("HTTP MCP 必须填写 http(s) URL");
+	if (!config || typeof config !== "object") throw new Error("MCP 配置必须是对象");
+	if (typeof config.serverName !== "string" || !/^[A-Za-z0-9_-]{1,32}$/.test(config.serverName)) throw new Error("serverName 只能包含字母、数字、下划线和连字符（最多 32 位）");
+	if (!["stdio", "streamable-http"].includes(config.transport)) throw new Error("不支持的 MCP transport");
+	if (config.transport === "stdio") {
+		if (typeof config.command !== "string" || !config.command.trim()) throw new Error("stdio MCP 必须填写 command");
+		if (config.args !== void 0 && (!Array.isArray(config.args) || config.args.some((arg) => typeof arg !== "string"))) throw new Error("MCP args 必须是字符串数组");
+		if (config.cwd !== void 0 && typeof config.cwd !== "string") throw new Error("MCP cwd 必须是字符串");
+		validatePairs(config.env, "env");
+	} else {
+		let url;
+		try {
+			url = new URL(config.url ?? "");
+		} catch {
+			throw new Error("HTTP MCP 必须填写有效 http(s) URL");
+		}
+		if (!["http:", "https:"].includes(url.protocol) || !url.hostname || url.username || url.password) throw new Error("HTTP MCP 必须填写有效 http(s) URL，凭据请使用请求头");
+		validatePairs(config.headers, "headers");
+	}
+}
+/**
+* Validate an optional string-valued map without coercing malformed input.
+* @private @author ddj 2026年10月08号
+* @param values Submitted map.
+* @param field Field used in the diagnostic.
+* @throws Error for non-object or non-string values.
+*/
+function validatePairs(values, field) {
+	if (values === void 0) return;
+	if (!values || typeof values !== "object" || Array.isArray(values) || Object.entries(values).some(([key, value]) => !key || typeof value !== "string")) throw new Error("MCP " + field + " 必须是字符串字典");
 }
 /** 列出全局（profile）MCP 服务，过滤掉新旧格式的项目级条目。 */
 function listMcp(ctx) {
@@ -1060,16 +1226,16 @@ function listMcp(ctx) {
 * @returns Masked server status; project name collisions reject before writing.
 */
 async function saveMcp(ctx, config) {
+	return mcpEdit(ctx, () => saveGlobal(ctx, config));
+}
+/** @private @author ddj 2026年10月08号 @param ctx Host services. @param config Configuration. @returns Saved status; validation failures do not write. */
+async function saveGlobal(ctx, config) {
 	validateConfig(config);
 	await checkMcpName(ctx, config.serverName);
 	const loader = ctx.get("loader");
 	if (!loader) throw new Error("缺少 loader 服务");
 	const existing = entriesOf(ctx).find((entry) => !isProjectEntryId(String(entry.id ?? entry.options?.id ?? "")) && entry.options?.config?.serverName === config.serverName);
-	const previous = existing?.options?.config ?? {};
-	const next = mergeSecrets({
-		...previous,
-		...config
-	}, previous);
+	const next = mergeMcp(existing?.options?.config ?? {}, config);
 	if (existing) {
 		await loader.update(existing.id, { config: next });
 		return serverOf(ctx, loader.resolve(existing.id));
@@ -1080,31 +1246,46 @@ async function saveMcp(ctx, config) {
 	});
 	return serverOf(ctx, loader.resolve(id));
 }
-/** 删除 MCP 服务。 */
-async function removeMcp(ctx, id) {
+/** @private @author ddj 2026年10月08号 @param ctx Host services. @param id Global identity. @returns Loader and verified global entry. @throws Missing service, entry or wrong scope. */
+function globalEntry(ctx, id) {
 	const loader = ctx.get("loader");
 	if (!loader) throw new Error("缺少 loader 服务");
 	const entry = entriesOf(ctx).find((candidate) => String(candidate.id) === id);
 	if (!entry) throw new Error("MCP 服务不存在");
-	await loader.remove(entry.id);
+	if (isProjectEntryId(String(entry.id ?? entry.options?.id ?? ""))) throw new Error("项目 MCP 必须通过项目入口操作");
+	return {
+		loader,
+		entry
+	};
+}
+/** @public @author ddj 2026年10月08号 @param ctx Host services. @param id Global identity. @returns Persisted removal, serialized with all settings writes. */
+async function removeMcp(ctx, id) {
+	/** @private @author ddj 2026年10月08号 @returns Loader removal after scope validation. */
+	const remove = async () => {
+		const { loader, entry } = globalEntry(ctx, id);
+		await loader.remove(entry.id);
+	};
+	return mcpEdit(ctx, remove);
 }
-/** 切换 MCP 服务启用状态。 */
+/** @public @author ddj 2026年10月08号 @param ctx Host services. @param id Global identity. @param enabled Desired state. @returns Persisted status after serialized toggle. */
 async function toggleMcp(ctx, id, enabled) {
-	const loader = ctx.get("loader");
-	if (!loader) throw new Error("缺少 loader 服务");
-	const entry = entriesOf(ctx).find((candidate) => String(candidate.id) === id);
-	if (!entry) throw new Error("MCP 服务不存在");
-	await loader.update(entry.id, { disabled: !enabled });
-	return serverOf(ctx, loader.resolve(entry.id));
+	/** @private @author ddj 2026年10月08号 @returns Loader status after toggle. */
+	const toggle = async () => {
+		const { loader, entry } = globalEntry(ctx, id);
+		await loader.update(entry.id, { disabled: !enabled });
+		return serverOf(ctx, loader.resolve(entry.id));
+	};
+	return mcpEdit(ctx, toggle);
 }
-/** 重新加载 MCP 服务。 */
+/** @public @author ddj 2026年10月08号 @param ctx Host services. @param id Global identity. @returns Loader status after serialized refresh. */
 async function refreshMcp(ctx, id) {
-	const loader = ctx.get("loader");
-	if (!loader) throw new Error("缺少 loader 服务");
-	const entry = entriesOf(ctx).find((candidate) => String(candidate.id) === id);
-	if (!entry) throw new Error("MCP 服务不存在");
-	await loader.update(entry.id, { config: { ...entry.options?.config ?? {} } });
-	return serverOf(ctx, loader.resolve(entry.id));
+	/** @private @author ddj 2026年10月08号 @returns Loader status after refresh. */
+	const refresh = async () => {
+		const { loader, entry } = globalEntry(ctx, id);
+		await loader.update(entry.id, { config: { ...entry.options?.config ?? {} } });
+		return serverOf(ctx, loader.resolve(entry.id));
+	};
+	return mcpEdit(ctx, refresh);
 }
 //#endregion
 //#region src/shared/keybindings.ts
@@ -2942,19 +3123,23 @@ function inDshRange(version, range) {
 }
 /**
 * 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。
-* 逐线自新到旧匹配，先命中先返回；仅 0.2.0-rc.1 精确标记为已审计版本。
-* @author ddj 2026年09月02号 / 2026年09月18号 / 2026年09月22号 / 2026年09月29号
+* 逐线自新到旧匹配，先命中先返回；仅已静态审计的 0.2.0-rc.1/rc.2 精确标记。
+* @author ddj 2026年09月02号 / 2026年09月18号 / 2026年09月22号 / 2026年09月29号 / 2026年10月08号
 * @param input 版本串（如 '0.1.6-alpha.2'）
 * @returns 版本线标签
 */
 function familyLabel(input) {
 	const version = parseDshVersion(input);
 	if (!version) return "未知";
+	if (inDshRange(version, {
+		from: "0.2.0-rc.2",
+		to: "0.2.0-rc.2"
+	})) return "0.2.0-rc.2（设置=profile Config；按能力探测）";
 	if (inDshRange(version, {
 		from: "0.2.0-rc.1",
 		to: "0.2.0-rc.1"
 	})) return "0.2.0-rc.1（设置=profile Config；按能力探测）";
-	if (inDshRange(version, { from: "0.2.0-0" })) return "0.2.0 及更新（除 rc.1 外未经逐版适配；按能力探测）";
+	if (inDshRange(version, { from: "0.2.0-0" })) return "0.2.0 及更新（除 rc.1/rc.2 外未经逐版适配；按能力探测）";
 	if (inDshRange(version, { from: "0.1.7-alpha.1" })) return "0.1.7-alpha.1 及更新（设置=profile Config + configForms 客户端面 + 会话 V4）";
 	if (inDshRange(version, { from: "0.1.6-alpha.2" })) return "0.1.6-alpha.2 及更新（会话多实例共存 + 回合改动卡片 + Office 侧栏预览 + 侧栏浏览器）";
 	if (inDshRange(version, { from: "0.1.6-alpha.1" })) return "0.1.6-alpha 及更新（MCP SDK v2 + Web 侧边栏终端 + 文件链接默认侧栏预览）";
@@ -12162,6 +12347,10 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			ok: true,
 			...listMcp(ctx)
 		}),
+		"mcp.snapshot": async () => ({
+			ok: true,
+			...mcpSnapshot(ctx)
+		}),
 		"mcp.save": async (args) => {
 			try {
 				return {