dsh-vscode-mode 0.7.0 → 0.8.0

package/lib/index.js

@@ -7,6 +7,7 @@ import { homedir, tmpdir } from "node:os";
 import { createHash, randomUUID } from "node:crypto";
 import { Buffer as Buffer$1 } from "node:buffer";
 import { execFile, spawn } from "node:child_process";
+import z from "@deepseek-ai/schemastery";
 import { inflateRawSync } from "node:zlib";
 //#region src/mcp.ts
 /**
@@ -208,6 +209,103 @@ function contentGuardOf(text) {
 	return {};
 }
 //#endregion
+//#region src/shared/nativeOpen.ts
+/**
+* dsh-vscode-mode shared — 原生打开范围判定（host/client 双面契约）。
+* 背景：DSH 文件预览双形态——本插件认领 `dsh-resource://file/**` 进 Monaco 编辑，
+* 官方渲染器（Office 预览/不可预览提示/表格预览）看认领让位。本模块承载「原生打开」
+* 范围的单一事实源：默认集 = 让位清单（插件本来就不认领的后缀），用户可经设置
+* `nativeOpenExts`（逗号分隔）增删；host 的 Config schema 默认值与 client 的
+* 文件树点击判定 / claim 认领判定共用，保证三处永不同源漂移。
+* 决策沿袭（不因本模块迁移而变）：CSV/TSV **不在**默认集——官方 0.1.7 有表格预览，
+* 但编辑器可编辑性优先，仅用户显式加入 nativeOpenExts 才让位（同 avif 例外先例）。
+* 作者 ddj 2026年09月22号
+*/
+/**
+* Office 文档后缀：官方 `dsh-client-ui-sidebar-documentpreview` 的 Office 渲染器
+* 声明 `doc/docx/xls/xlsx/ppt/pptx`（0.1.6 起侧栏 Office 预览；0.1.7 扩展表格 CSV/TSV
+* 只读预览——本清单刻意不含 csv/tsv，见文件头决策）。本插件让位官方（不认领），
+* 否则会把这些文件路由进 Monaco 而丢掉官方预览。
+*/
+const OFFICE_EXT = [
+	"doc",
+	"docx",
+	"xls",
+	"xlsx",
+	"ppt",
+	"pptx",
+	"odt",
+	"ods",
+	"odp",
+	"pages",
+	"numbers"
+];
+/**
+* 官方「不可预览二进制容器」清单（`UNVIEWABLE_BINARY_EXTENSIONS`，逐项取自
+* `dsh-client-ui-sidebar-documentpreview/lib/client.js`）。这些后缀官方会给出
+* 「无法预览」提示；本插件让位官方，避免把二进制当文本读成乱码。
+*
+* ⚠️ 刻意例外：官方清单含 `avif`，但本插件图片预览支持 avif（浏览器原生解码），
+* 故从本表**移除** `avif` —— 保留本插件的图片预览优于官方的「不可预览」。
+* @author ddj 2026年09月18号
+*/
+const BLIND_EXT = [
+	"mp4",
+	"mov",
+	"avi",
+	"mkv",
+	"webm",
+	"flv",
+	"wmv",
+	"m4v",
+	"mp3",
+	"wav",
+	"flac",
+	"ogg",
+	"m4a",
+	"aac",
+	"wma",
+	"opus",
+	"zip",
+	"gz",
+	"tgz",
+	"bz2",
+	"xz",
+	"zst",
+	"7z",
+	"rar",
+	"tar",
+	"jar",
+	"exe",
+	"dll",
+	"so",
+	"dylib",
+	"bin",
+	"o",
+	"class",
+	"pyc",
+	"wasm",
+	"ttf",
+	"otf",
+	"woff",
+	"woff2",
+	"eot",
+	"dmg",
+	"iso",
+	"img",
+	"sqlite",
+	"db",
+	"psd",
+	"ai",
+	"sketch",
+	"tiff",
+	"tif",
+	"heic",
+	"heif"
+];
+/** 默认范围的设置序列（逗号分隔；Config schema 默认值与设置页回显同源）。 */
+const DEFAULT_NATIVE_CSV = [...OFFICE_EXT, ...BLIND_EXT].join(",");
+//#endregion
 //#region src/shared/logger.ts
 /**
 * dsh-vscode-mode — 统一日志核心（双面共享，平台中立）。
@@ -322,10 +420,11 @@ function bindHostLog(ctx) {
 * dsh-vscode-mode host — 文件链接打开工具 + 快捷键的持久化设置。
 * 依赖守卫：schemastery 动态加载；@deepseek-ai/dsh-settings 仅作 legacy 探测——
 * rc 线导出 installSettingsSection free function，0.1.2-alpha 起移除（改由 settings
-* 服务的 installSection 方法承载，见 runSettingsInstall 三策略）。
+* 服务的 installSection 方法承载），0.1.7 再移除 installSection（设置并入 profile
+* 插件 Config schema，见 runSettingsInstall 四策略：legacy/service/forms/none）。
 * 缺失/任一策略失败时插件仍可加载（fileOpenTool 降级为配置值，compat 报告可见），
 * 全程 try/catch，不产生未捕获 rejection。
-* 作者 ddj 2026年08月24号 / 2026年08月26号 / 2026年09月02号
+* 作者 ddj 2026年08月24号 / 2026年08月26号 / 2026年09月02号 / 2026年09月22号
 */
 const FILE_OPEN_SETTINGS_NS = "dsh-vscode-mode";
 const FILE_OPEN_DEFAULT = "auto";
@@ -437,6 +536,7 @@ function loadSettingsDeps(importFn = hostImport) {
 const INSTALL_UNMOUNTED = "设置 section 尚未装配";
 const INSTALL_LEGACY = "rc 线：dsh-settings.installSettingsSection";
 const INSTALL_SERVICE = "0.1.2-alpha 线：settings 服务 installSection";
+const INSTALL_FORMS = "0.1.7 线：设置并入插件 Config schema（SettingsForms）";
 const INSTALL_NONE = "两路均不可用：设置持久化降级为配置值";
 let observedInstall = {
 	strategy: "unknown",
@@ -459,14 +559,51 @@ function settingsInstallNote() {
 	return observedInstall.note;
 }
 /**
+* 判定设置写冲突错误（0.1.7 SettingsConflictError：code 常量 / 构造器名双通道）。
+* @author ddj 2026年09月22号
+* @param error 捕获到的错误
+* @returns 是否为 revision 冲突
+*/
+function isConflictError(error) {
+	if (!error || typeof error !== "object") return false;
+	const e = error;
+	return e.code === "SETTINGS_CONFLICT" || e.name === "SettingsConflictError";
+}
+/**
+* 0.1.7 forms 策略：订阅 settings/document-updated 事件，目标 namespace 变化时
+* 把 describe 最新值推给 hooks（setSource + onChange），替代旧 installSection 的
+* 变更回调；disposer 经 ctx.effect 随插件 fiber 卸载（热重载不泄漏）。
+* @author ddj 2026年09月22号
+* @param ctx DSH host 上下文
+* @param provider settings 服务（SettingsForms）
+* @param ns 目标设置命名空间
+* @param hooks 设置源绑定与变更回调
+*/
+function watchDocUpdates(ctx, provider, ns, hooks) {
+	try {
+		const bus = ctx;
+		if (typeof bus.on !== "function") return;
+		const off = bus.on("settings/document-updated", (updatedNs) => {
+			if (updatedNs !== ns) return;
+			hooks.setSource(() => readSectionValue(provider, ns));
+			hooks.onChange();
+		});
+		if (typeof bus.effect === "function" && typeof off === "function") bus.effect(() => off);
+	} catch (error) {
+		log.warn("settings/document-updated 订阅失败：" + String(error));
+	}
+}
+/**
 * 设置 section 版本自适应安装（核心策略分派）。
 * legacy：dsh-settings 仍导出 installSettingsSection（rc 线）→ 原样调用，行为与旧版一致。
 * service：该导出已移除（0.1.2-alpha 起）→ 经 ctx.inject(['settings']) 走服务方法
 *          provider.installSection(owner, ns, schema, entry, hooks)（等义封装，含
-*          base 层与 fiber 卸载回退）。回调内方法缺失再降级记录 none。
+*          base 层与 fiber 卸载回退）。
+* forms：0.1.7 起 installSection 移除，设置并入 profile 插件 Config（SettingsForms
+*          的 describe+update 在场即成立）→ 不装 section，改订阅 document-updated。
 * none：两条路由都不存在 → 仅记录并告警，调用方按配置值运行。
 * 全程不抛错、不产生未捕获 rejection。
-* @author ddj 2026年09月02号
+* @author ddj 2026年09月02号（2026年09月22号 增补 forms 策略）
 * @param ctx DSH host 上下文（inject 可选探测）
 * @param ns 设置命名空间
 * @param schema schemastery schema
@@ -499,6 +636,12 @@ async function runSettingsInstall(ctx, ns, schema, entry, hooks, loader = loadSe
 			const provider = typeof sc.get === "function" ? sc.get("settings") : sc.settings;
 			const install = provider?.installSection;
 			if (typeof install !== "function") {
+				const forms = provider;
+				if (typeof forms?.describe === "function" && typeof forms?.update === "function") {
+					recordInstall("forms", INSTALL_FORMS);
+					watchDocUpdates(ctx, forms, ns, hooks);
+					return;
+				}
 				log.warn("settings 服务无 installSection（DSH 版本 API 变化），section " + ns + " 降级为配置值");
 				recordInstall("none", INSTALL_NONE);
 				return;
@@ -529,6 +672,99 @@ function keybindingsShape(z) {
 	for (const [id, chord] of Object.entries(KEYBINDING_DEFAULTS)) shape[id] = z.string().default(chord);
 	return shape;
 }
+/**
+* 设置节 describe 项的形状校验：value 须为普通对象。
+* ns 在两代语义不同（旧=自装 section 名，0.1.7=profile entry id），同名撞车时
+* 以形状兜底防误命中非设置数据；0.1.7 下本插件 entry 的 Config 值与旧 section
+* 值同为设置键对象，两形状天然兼容。
+* @author ddj 2026年09月22号
+* @param value describe 项的 value 字段
+* @returns 是否具备设置节形状
+*/
+function isSectionShaped(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* 按 ns + 形状校验查找设置节（host 读路径统一入口）。
+* @author ddj 2026年09月22号
+* @param provider settings 服务（可空）
+* @param ns 设置命名空间
+* @returns 命中的 describe 项；未命中返回 undefined
+*/
+function sectionOf(provider, ns) {
+	const items = provider?.describe?.({ redactSecrets: true });
+	if (!items) return void 0;
+	return items.find((item) => item.ns === ns && isSectionShaped(item.value));
+}
+/** 读设置节存储值（未就绪/形状不符返回 undefined）。 */
+function readSectionValue(provider, ns) {
+	return sectionOf(provider, ns)?.value;
+}
+/**
+* 带冲突自愈的设置写入：0.1.7 SettingsConflictError（revision 拒写）时重读
+* revision 重试一次；其余错误与服务缺失一律结构化返回，绝不抛未捕获异常。
+* @author ddj 2026年09月22号
+* @param provider settings 服务（可空）
+* @param ns 设置命名空间
+* @param patch 写入字段
+* @param expectedRevision 读侧携带的 revision（缺省用 describe 最新值）
+* @returns 写入结果
+*/
+async function updateSection(provider, ns, patch, expectedRevision) {
+	if (!provider?.update) return {
+		ok: false,
+		error: "settings 服务无 update"
+	};
+	const first = expectedRevision ?? sectionOf(provider, ns)?.revision;
+	try {
+		await provider.update(ns, patch, first);
+		return { ok: true };
+	} catch (error) {
+		if (!isConflictError(error)) return {
+			ok: false,
+			error: String(error)
+		};
+	}
+	const fresh = sectionOf(provider, ns)?.revision;
+	try {
+		await provider.update(ns, patch, fresh);
+		return {
+			ok: true,
+			conflict: true
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			conflict: true,
+			error: String(error)
+		};
+	}
+}
+/**
+* 构建设置 section schema（install 路径与插件 Config 声明共用，保证两代形状同源）。
+* 字段集 = fileOpenTool/keybindings/sidebarMinWidth/maxOpenEditors/integrationBaseUrl/
+* aiInline/aiProvider/aiModel/aiEffort/svnPath/tortoisePath/nativeOpenExts，全部带默认值
+* （Config 启动校验在 undefined/空配置下自动填充，rc/alpha 两代 cordis 均通过）。
+* @author ddj 2026年09月22号
+* @param z schemastery 命名空间（静态 import 或动态加载均可）
+* @returns schemastery object schema
+*/
+function buildSettingsSchema(z) {
+	return z.object({
+		fileOpenTool: z.string().default(FILE_OPEN_DEFAULT),
+		keybindings: z.object(keybindingsShape(z)).default({ ...KEYBINDING_DEFAULTS }),
+		sidebarMinWidth: z.number().default(300),
+		maxOpenEditors: z.number().default(10),
+		integrationBaseUrl: z.string().default(INTEGRATION_BASE_DEFAULT),
+		aiInline: z.boolean().default(AI_CONFIG_DEFAULT.enabled),
+		aiProvider: z.string().default(AI_CONFIG_DEFAULT.provider),
+		aiModel: z.string().default(AI_CONFIG_DEFAULT.model),
+		aiEffort: z.string().default(AI_CONFIG_DEFAULT.effort),
+		svnPath: z.string().default(""),
+		tortoisePath: z.string().default(TORTOISE_DIR_DEFAULT),
+		nativeOpenExts: z.string().default(DEFAULT_NATIVE_CSV)
+	});
+}
 function normalizeValue(value) {
 	if (typeof value !== "string" || value.trim() === "") return FILE_OPEN_DEFAULT;
 	return value.trim();
@@ -567,23 +803,11 @@ async function installOpenSettingsSection(ctx, ns, entry, hooks, loader = loadSe
 		deps = await loader();
 	} catch {}
 	if (!deps) return false;
-	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 }),
-		sidebarMinWidth: deps.z.number().default(300),
-		maxOpenEditors: deps.z.number().default(10),
-		integrationBaseUrl: deps.z.string().default(INTEGRATION_BASE_DEFAULT),
-		aiInline: deps.z.boolean().default(AI_CONFIG_DEFAULT.enabled),
-		aiProvider: deps.z.string().default(AI_CONFIG_DEFAULT.provider),
-		aiModel: deps.z.string().default(AI_CONFIG_DEFAULT.model),
-		aiEffort: deps.z.string().default(AI_CONFIG_DEFAULT.effort),
-		svnPath: deps.z.string().default(""),
-		tortoisePath: deps.z.string().default(TORTOISE_DIR_DEFAULT)
-	}), entry, {
+	const strategy = await runSettingsInstall(ctx, ns, buildSettingsSchema(deps.z), entry, {
 		setSource: (source) => hooks.setSource(source),
 		onChange: hooks.onChange
 	}, loader);
-	return strategy === "legacy" || strategy === "service";
+	return strategy === "legacy" || strategy === "service" || strategy === "forms";
 }
 /** AI 配置脏值读取（settings 未就绪时回退默认）。 */
 function aiValueOf(stored) {
@@ -612,13 +836,13 @@ function setupOpenSettings(ctx, config, onChange) {
 		onChange(current);
 	};
 	const syncRevision = () => {
-		revision = (provider?.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS))?.revision;
+		revision = sectionOf(provider, FILE_OPEN_SETTINGS_NS)?.revision;
 	};
 	const settingsChange = () => syncRevision();
 	/** AI 配置当前值（settings 未就绪回退默认）。 */
 	let aiCurrent = { ...AI_CONFIG_DEFAULT };
 	const aiSync = () => {
-		const stored = (provider?.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS))?.value;
+		const stored = readSectionValue(provider, FILE_OPEN_SETTINGS_NS);
 		aiCurrent = stored !== void 0 ? aiValueOf(stored) : aiCurrent;
 	};
 	/** SVN 路径当前值（settings 未就绪回退配置值）。 */
@@ -634,7 +858,7 @@ function setupOpenSettings(ctx, config, onChange) {
 	};
 	/** 读取 settings 存储值（describe 未就绪返回 undefined）。 */
 	const storedValue = () => {
-		return provider?.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS)?.value;
+		return readSectionValue(provider, FILE_OPEN_SETTINGS_NS);
 	};
 	installOpenSettingsSection(ctx, FILE_OPEN_SETTINGS_NS, {
 		fileOpenTool: current,
@@ -665,25 +889,15 @@ function setupOpenSettings(ctx, config, onChange) {
 		},
 		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;
+			const result = await updateSection(provider, FILE_OPEN_SETTINGS_NS, { fileOpenTool: next }, expectedRevision);
+			if (!result.ok) log.warn("fileOpenTool 设置写入失败：" + (result.error ?? "未知原因"));
+			const stored = readSectionValue(provider, FILE_OPEN_SETTINGS_NS);
 			notify(stored?.fileOpenTool ?? next);
 			syncRevision();
 		},
 		ai: () => aiCurrent,
 		svn: () => svnCurrent,
 		aiUpdate: async (patch, expectedRevision) => {
-			if (!provider?.update) {
-				if (patch.enabled !== void 0) aiCurrent.enabled = patch.enabled;
-				if (patch.provider !== void 0) aiCurrent.provider = patch.provider;
-				if (patch.model !== void 0) aiCurrent.model = patch.model;
-				if (patch.effort !== void 0) aiCurrent.effort = patch.effort;
-				return aiCurrent;
-			}
 			const stored = { ...aiCurrent };
 			const body = {};
 			if (patch.enabled !== void 0) {
@@ -702,7 +916,10 @@ function setupOpenSettings(ctx, config, onChange) {
 				stored.effort = patch.effort;
 				body.aiEffort = patch.effort;
 			}
-			await provider.update(FILE_OPEN_SETTINGS_NS, body, expectedRevision);
+			if (!(await updateSection(provider, "dsh-vscode-mode", body, expectedRevision)).ok) {
+				aiCurrent = stored;
+				return aiCurrent;
+			}
 			aiSync();
 			return aiCurrent;
 		}
@@ -919,13 +1136,14 @@ function inDshRange(version, range) {
 /**
 * 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。
 * 逐线自新到旧匹配，先命中先返回（区间无上界，故顺序即优先级）。
-* @author ddj 2026年09月02号 / 2026年09月18号
+* @author ddj 2026年09月02号 / 2026年09月18号 / 2026年09月22号
 * @param input 版本串（如 '0.1.6-alpha.2'）
 * @returns 版本线标签
 */
 function familyLabel(input) {
 	const version = parseDshVersion(input);
 	if (!version) return "未知";
+	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 侧边栏终端 + 文件链接默认侧栏预览）";
 	if (inDshRange(version, { from: "0.1.5-alpha.1" })) return "0.1.5-alpha 及更新（官方右侧 Sidebar 编辑区 + sidebar.panellist）";
@@ -1864,7 +2082,7 @@ function detectGuards(ctx) {
 	}];
 }
 /** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
-const TESTED_DSH_MAX = "0.1.6-alpha.2";
+const TESTED_DSH_MAX = "0.1.7-alpha.1";
 /** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
 function versionAdapters(dshVersion) {
 	const adapters = [];
@@ -1887,7 +2105,7 @@ function versionAdapters(dshVersion) {
 	const strategy = settingsInstallStrategy();
 	adapters.push({
 		name: "设置 section 安装（版本适配）",
-		active: strategy === "legacy" || strategy === "service",
+		active: strategy === "legacy" || strategy === "service" || strategy === "forms",
 		note: settingsInstallNote()
 	});
 	return adapters;
@@ -1910,7 +2128,7 @@ async function buildReport(ctx, options) {
 	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.6-alpha.2）：设置 API 按能力探测运行，异常时请回报适配矩阵");
+	if (parsed && testedMax && compareDshVersions(parsed, testedMax) > 0) warnings.push("DSH " + dshVersion + " 高于已实测版本（0.1.7-alpha.1）：设置 API 按能力探测运行，异常时请回报适配矩阵");
 	for (const guard of guards) if (!guard.active && guard.note) warnings.push(guard.note);
 	return {
 		pluginVersion: options?.version ?? pluginVersionOf(),
@@ -2000,6 +2218,16 @@ function registerRoutes(ctx, config, handleRpc, onWarning) {
 					input = {};
 				}
 				const result = await handleRpc(typeof input.method === "string" ? input.method : "", input.args ?? {});
+				const bin = result?.binary;
+				if (result && result.ok === true && bin?.bytes instanceof Uint8Array) {
+					res.statusCode = 200;
+					res.setHeader("content-type", "application/octet-stream");
+					res.setHeader("x-edrv-mime", String(bin.mime ?? ""));
+					res.setHeader("x-edrv-version", String(bin.version ?? ""));
+					res.setHeader("x-edrv-size", String(bin.size ?? bin.bytes.byteLength));
+					res.end(Buffer.from(bin.bytes));
+					return;
+				}
 				res.statusCode = 200;
 				res.setHeader("content-type", "application/json");
 				res.end(JSON.stringify(result));
@@ -7104,12 +7332,70 @@ async function scanSessionInventory(home = dshHome(), archive = sessionsArchiveR
 		}
 	};
 }
-/** 标记活跃会话（live id 与目录段名双向匹配，兼容编码差异）。 */
-function markActiveSessions(sessions, activeIds) {
-	const raw = new Set(activeIds);
+/** id 双向匹配器：原始 id 与编码段名任一命中（兼容编码差异）。 */
+function idMatcher(ids) {
+	const raw = new Set(ids);
 	const encoded = /* @__PURE__ */ new Set();
 	for (const id of raw) encoded.add(sessionIdSegment(id));
-	for (const s of sessions) if (raw.has(s.sessionId) || encoded.has(s.sessionId)) s.active = true;
+	return (id) => raw.has(id) || encoded.has(id);
+}
+/** 标记活跃会话（live id 与目录段名双向匹配，兼容编码差异）。 */
+function markActiveSessions(sessions, activeIds) {
+	const match = idMatcher(activeIds);
+	for (const s of sessions) if (match(s.sessionId)) s.active = true;
+}
+/** 空标志集合（服务/字段缺失的统一降级返回值）。 */
+function emptyFlagIds() {
+	return {
+		archived: /* @__PURE__ */ new Set(),
+		pinned: /* @__PURE__ */ new Set()
+	};
+}
+/** 任意值 → id 字符串集合（非数组或非字符串元素一律丢弃）。 */
+function toIdSet(ids) {
+	if (!Array.isArray(ids)) return /* @__PURE__ */ new Set();
+	return new Set(ids.filter((id) => typeof id === "string"));
+}
+/**
+* 一次读取 workspaceRegistry 的官方归档/置顶 id 集合（摊到盘点各行使用）。
+* 服务缺失、字段缺失或非数组（DSH 0.1.6 及更旧没有）一律视为空集，绝不抛错。
+* @author ddj 2026年09月22号
+* @param ctx DSH 上下文
+* @returns archived/pinned 两组 id 集合（缺失即空集）
+*/
+function registryFlags(ctx) {
+	try {
+		const registry = ctx.get("workspaceRegistry");
+		if (!registry) return emptyFlagIds();
+		return {
+			archived: toIdSet(registry.archivedSessionIds),
+			pinned: toIdSet(registry.pinnedSessionIds)
+		};
+	} catch (error) {
+		log.debug("registryFlags 跳过（服务缺失或读取失败）：" + String(error));
+		return emptyFlagIds();
+	}
+}
+/**
+* 给盘点行附官方归档/置顶标志（best-effort：仅命中附 true，缺失/未命中不附字段），
+* 让 PerfSettings 会话行能看到官方侧栏的归档/置顶状态。id 匹配复用 markActiveSessions
+* 的双向（原始 id / 编码段名）口径；服务/字段缺失不附字段、绝不抛错（旧 host 兼容降级）。
+* @author ddj 2026年09月22号
+* @param sessions 盘点会话行（就地附加 archived/pinned）
+* @param ctx DSH 上下文
+*/
+function markOfficialFlags(sessions, ctx) {
+	try {
+		const flags = registryFlags(ctx);
+		const archived = idMatcher(flags.archived);
+		const pinned = idMatcher(flags.pinned);
+		for (const s of sessions) {
+			if (archived(s.sessionId)) s.archived = true;
+			if (pinned(s.sessionId)) s.pinned = true;
+		}
+	} catch (error) {
+		log.debug("markOfficialFlags 跳过（读取失败，保持无标志）：" + String(error));
+	}
 }
 /**
 * 移出规划（纯函数）：从盘点中按「显式集合」或「规则（minBytes / olderThanDays）」
@@ -7273,6 +7559,27 @@ async function restoreSession(home, archive, workspaceKey, sessionId) {
 		};
 	}
 }
+/**
+* 恢复后对齐官方归档标志（best-effort）：官方 archive 是 workspaceRegistry 的
+* archivedSessionIds 持久标志（只藏 UI/拦模型步骤，不搬目录；dsh-workspace 源码注明
+* unarchiveSession 对未归档与未知 id 均为无写入 no-op、对失踪会话也容忍）。
+* 插件把目录搬回后若该会话曾被官方归档，官方侧栏会继续隐藏它、0.1.7 的
+* archived-session-gate 会继续拦它的模型步骤——这里探测 host 的 workspaceRegistry
+* 服务做一次幂等清除；服务缺失、id 编码差异未命中或调用抛错一律静默跳过
+* （保持现状，不加猜的行为）。有效期：仅恢复成功后触发一次，不轮询不重试。
+* @author ddj 2026年09月22号
+* @param ctx DSH 上下文
+* @param sessionId 恢复的会话 id（目录段名与原始 id 同形时可命中官方标志）
+*/
+async function unarchiveOfficial(ctx, sessionId) {
+	try {
+		const registry = ctx.get("workspaceRegistry");
+		if (!registry || typeof registry.unarchiveSession !== "function") return;
+		await registry.unarchiveSession(sessionId);
+	} catch (error) {
+		log.debug("unarchiveOfficial 跳过（服务缺失或调用失败，保持现状）：" + String(error));
+	}
+}
 /** 清除归档区早于 N 天的会话（破坏性，仅限归档区）。 */
 async function purgeArchive(archive, olderThanDays) {
 	const cutoff = Date.now() - olderThanDays * 24 * 60 * 60 * 1e3;
@@ -7508,6 +7815,52 @@ function snippetTargetOf(path) {
 	return isSnippetFilePath(path) ? path.replace(/\\/g, "/") : null;
 }
 /**
+* 二进制/文本读取共用前置（edrv.read 与 edrv.readBinary）：解析路径 + debugRecord +
+* stat + 文件类型校验 + 32MB 二进制上限，保证两条读通道的错误口径完全一致。
+* @author ddj 2026年09月22号
+* @param ctx DSH 上下文
+* @param sc requireSession 成功结果（session + cwd）
+* @param path 客户端请求路径
+* @returns 成功返回解析目标与 stat；失败返回错误文案（文件不存在时附 resolvedPath）
+*/
+async function readTargetOf(ctx, sc, path) {
+	const fs = ctx.get("fs");
+	if (!fs) return { err: "缺少 fs" };
+	try {
+		const target = await resolveTarget(ctx, sc.session, path);
+		debugRecord(ctx, sc.cwd, "[DEBUG path.resolve] input=" + String(path ?? "") + " resolved=" + fs.processPath(target), "debug");
+		const info = await fs.stat(target);
+		if (!info || info.type !== "file") return {
+			err: "文件不存在",
+			resolvedPath: fs.processPath(target)
+		};
+		if ((info.size ?? 0) > 33554432) return { err: "文件过大（>32MB），不支持整文件预览" };
+		return {
+			target,
+			fs,
+			info
+		};
+	} catch (error) {
+		return { err: "读取失败：" + String(error) };
+	}
+}
+/**
+* readTargetOf 失败结果 → RPC 错误载荷（文件不存在时保留 resolvedPath 供诊断）。
+* @author ddj 2026年09月22号
+* @param prep readTargetOf 的失败分支
+* @returns { ok:false } 形态载荷
+*/
+function targetErrOf(prep) {
+	return prep.resolvedPath !== void 0 ? {
+		ok: false,
+		error: prep.err,
+		resolvedPath: prep.resolvedPath
+	} : {
+		ok: false,
+		error: prep.err
+	};
+}
+/**
 * 本地文件系统版本令牌（mtime+size）：与 ctx.fs 的不透明版本串用途相同，
 * 仅供全局片段文件（走 node:fs 直读、不经 ctx.fs）在 edrv.read 时回带。
 * @author ddj 2026年09月15号
@@ -7633,7 +7986,7 @@ async function latestPatchBackup(patchPath) {
 }
 /** 读取设置中的深链基址（缺省/非法回退默认 3080）。 */
 async function integrationBaseUrlOf(ctx) {
-	const value = (ctx.get("settings")?.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS))?.value;
+	const value = sectionOf(ctx.get("settings"), FILE_OPEN_SETTINGS_NS)?.value;
 	return (typeof value?.integrationBaseUrl === "string" ? value.integrationBaseUrl.trim() : "") || "http://127.0.0.1:3080";
 }
 /**
@@ -7846,45 +8199,56 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				ok: false,
 				error: sc.err
 			};
-			const fs = ctx.get("fs");
-			if (!fs) return {
-				ok: false,
-				error: "缺少 fs"
-			};
+			const prep = await readTargetOf(ctx, sc, args.path);
+			if ("err" in prep) return targetErrOf(prep);
 			try {
-				const target = await resolveTarget(ctx, sc.session, args.path);
-				debugRecord(ctx, sc.cwd, "[DEBUG path.resolve] input=" + String(args.path ?? "") + " resolved=" + fs.processPath(target), "debug");
-				const info = await fs.stat(target);
-				if (!info || info.type !== "file") return {
-					ok: false,
-					error: "文件不存在",
-					resolvedPath: fs.processPath(target)
-				};
-				if ((info.size ?? 0) > 33554432) return {
-					ok: false,
-					error: "文件过大（>32MB），不支持整文件预览"
-				};
 				if (args.encoding === "base64") {
-					const bytes = await fs.readBytes(target, void 0, BINARY_READ_CAP);
+					const bytes = await prep.fs.readBytes(prep.target, void 0, BINARY_READ_CAP);
 					return {
 						ok: true,
 						content: Buffer.from(bytes).toString("base64"),
 						size: bytes.byteLength,
 						encoding: "base64",
 						mime: binaryMimeOf(args.path),
-						version: String(info.version ?? "")
+						version: String(prep.info.version ?? "")
 					};
 				}
-				if ((info.size ?? 0) > 8388608) return {
+				if ((prep.info.size ?? 0) > 8388608) return {
 					ok: false,
 					error: "文件过大（>8MB），不支持整文件预览"
 				};
-				const content = await fs.readText(target);
+				const content = await prep.fs.readText(prep.target);
 				return {
 					ok: true,
 					content,
 					size: content.length,
-					version: String(info.version ?? "")
+					version: String(prep.info.version ?? "")
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "读取失败：" + String(error)
+				};
+			}
+		},
+		"edrv.readBinary": async (args) => {
+			const sc = await requireSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const prep = await readTargetOf(ctx, sc, args.path);
+			if ("err" in prep) return targetErrOf(prep);
+			try {
+				const bytes = await prep.fs.readBytes(prep.target, void 0, BINARY_READ_CAP);
+				return {
+					ok: true,
+					binary: {
+						bytes,
+						mime: binaryMimeOf(args.path),
+						size: bytes.byteLength,
+						version: String(prep.info.version ?? "")
+					}
 				};
 			} catch (error) {
 				return {
@@ -8633,39 +8997,32 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			}
 		},
 		"vscode.fileOpenSettingsGet": async () => {
-			const descriptor = ctx.get("settings")?.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS);
-			const value = descriptor?.value;
+			const section = sectionOf(ctx.get("settings"), FILE_OPEN_SETTINGS_NS);
+			const value = section?.value;
 			return {
 				ok: true,
 				fileOpenTool: normalizeFileOpenTool(value?.fileOpenTool ?? "auto"),
 				integrationBaseUrl: await integrationBaseUrlOf(ctx),
-				revision: descriptor?.revision
+				revision: section?.revision
 			};
 		},
 		"vscode.fileOpenSettingsUpdate": async (args) => {
 			const settings = ctx.get("settings");
-			if (!settings?.update) return {
+			const patch = { fileOpenTool: normalizeFileOpenTool(args.fileOpenTool) };
+			if (typeof args.integrationBaseUrl === "string" && args.integrationBaseUrl.trim()) patch.integrationBaseUrl = args.integrationBaseUrl.trim();
+			const result = await updateSection(settings, FILE_OPEN_SETTINGS_NS, patch, args.expectedRevision);
+			if (!result.ok) return {
 				ok: false,
-				error: "设置服务不可用"
+				error: result.error ?? "设置服务不可用"
+			};
+			const section = sectionOf(settings, FILE_OPEN_SETTINGS_NS);
+			const value = section?.value;
+			return {
+				ok: true,
+				fileOpenTool: normalizeFileOpenTool(value?.fileOpenTool),
+				integrationBaseUrl: await integrationBaseUrlOf(ctx),
+				revision: section?.revision
 			};
-			try {
-				const patch = { fileOpenTool: normalizeFileOpenTool(args.fileOpenTool) };
-				if (typeof args.integrationBaseUrl === "string" && args.integrationBaseUrl.trim()) patch.integrationBaseUrl = args.integrationBaseUrl.trim();
-				await settings.update(FILE_OPEN_SETTINGS_NS, patch, 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),
-					integrationBaseUrl: await integrationBaseUrlOf(ctx),
-					revision: descriptor?.revision
-				};
-			} catch (error) {
-				return {
-					ok: false,
-					error: String(error)
-				};
-			}
 		},
 		"compat": async () => ({
 			ok: true,
@@ -8829,6 +9186,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				const inventory = await scanSessionInventory(home, sessionsArchiveRoot(home));
 				const active = activeSessionIds(ctx);
 				markActiveSessions(inventory.sessions, active);
+				markOfficialFlags(inventory.sessions, ctx);
 				return {
 					ok: true,
 					...inventory,
@@ -8897,13 +9255,15 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 		"edrv.perf.restore": async (args) => {
 			try {
 				const result = await restoreSession(dshHome(), sessionsArchiveRoot(dshHome()), args.workspaceKey, args.sessionId);
-				return result.ok ? {
-					ok: true,
-					restored: true
-				} : {
+				if (!result.ok) return {
 					ok: false,
 					error: result.error ?? "恢复失败"
 				};
+				await unarchiveOfficial(ctx, args.sessionId);
+				return {
+					ok: true,
+					restored: true
+				};
 			} catch (error) {
 				return {
 					ok: false,
@@ -9616,6 +9976,9 @@ function createLspClient(transport, events = {}) {
 		workspaceSymbol: false,
 		hover: false,
 		semanticTokens: false,
+		completion: false,
+		completionResolve: false,
+		signatureHelp: false,
 		semanticTokenTypes: [],
 		semanticTokenModifiers: []
 	};
@@ -9749,6 +10112,23 @@ function createLspClient(transport, events = {}) {
 						references: { dynamicRegistration: false },
 						documentSymbol: { dynamicRegistration: false },
 						hover: { dynamicRegistration: false },
+						completion: {
+							dynamicRegistration: false,
+							contextSupport: true,
+							completionItem: {
+								snippetSupport: true,
+								documentationFormat: ["markdown", "plaintext"],
+								resolveSupport: { properties: [
+									"documentation",
+									"detail",
+									"additionalTextEdits"
+								] }
+							}
+						},
+						signatureHelp: {
+							dynamicRegistration: false,
+							signatureInformation: { documentationFormat: ["markdown", "plaintext"] }
+						},
 						semanticTokens: {
 							dynamicRegistration: false,
 							requests: {
@@ -9771,6 +10151,9 @@ function createLspClient(transport, events = {}) {
 				workspaceSymbol: Boolean(caps.workspaceSymbolProvider),
 				hover: Boolean(caps.hoverProvider),
 				semanticTokens: Boolean(caps.semanticTokensProvider),
+				completion: Boolean(caps.completionProvider),
+				completionResolve: Boolean(caps.completionProvider?.resolveProvider),
+				signatureHelp: Boolean(caps.signatureHelpProvider),
 				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]
 			};
@@ -9972,6 +10355,9 @@ function createLspServer(spec, root, languageId, logger) {
 		workspaceSymbol: false,
 		hover: false,
 		semanticTokens: false,
+		completion: false,
+		completionResolve: false,
+		signatureHelp: false,
 		semanticTokenTypes: [...LSP_SEMANTIC_TOKEN_TYPES],
 		semanticTokenModifiers: [...LSP_SEMANTIC_TOKEN_MODIFIERS]
 	};
@@ -10228,6 +10614,68 @@ function createLspServer(spec, root, languageId, logger) {
 			if (!result || !result.contents) return null;
 			return { contents: stringifyHoverContents(result.contents) };
 		},
+		/**
+		* 查询补全列表（textDocument/completion）。
+		*
+		* 列表阶段**剥离 documentation**：EmmyLua 把文档挂在 resolve 阶段（我方 initialize 已声明
+		* resolveSupport），但并非所有服务器都遵守；每条都带长文档会让单次 RPC 载荷暴涨。
+		* `data` 原样透传，resolve 时由服务器回认该条目。
+		* @author ddj 2026年09月22号
+		* @param path 工作区相对路径
+		* @param line 0-based 行
+		* @param character 0-based 列
+		* @param context LSP CompletionContext（触发字符/触发类型）
+		* @returns 归一化补全列表；不支持或文档未打开时 null
+		*/
+		async completion(path, line, character, context) {
+			const doc = docs.get(path);
+			if (!doc || !await readyWait || !capabilities.completion) return null;
+			const params = {
+				textDocument: { uri: doc.uri },
+				position: {
+					line,
+					character
+				}
+			};
+			if (context) params.context = context;
+			return normCompletion(await ensureClient().request("textDocument/completion", params));
+		},
+		/**
+		* 补全项惰性补全（completionItem/resolve）：按 `data` 取回 documentation/detail/additionalTextEdits。
+		*
+		* 必须回传**完整条目**（服务器按 data + label 精确匹配），只发 label/data 可能被服务器忽略。
+		* @author ddj 2026年09月22号
+		* @param path 工作区相对路径
+		* @param item 列表阶段返回的补全项
+		* @returns 补全后的条目；服务器不支持时原样返回
+		*/
+		async resolveCompletion(path, item) {
+			if (!item || typeof item.label !== "string") return null;
+			if (!await readyWait || !capabilities.completionResolve) return item;
+			return normCompItem(await ensureClient().request("completionItem/resolve", toLspCompItem(item))) ?? item;
+		},
+		/**
+		* 查询签名帮助（textDocument/signatureHelp）。
+		*
+		* activeSignature/activeParameter 做边界裁剪：服务器可能给越界值（多签名时按实参推进出错），
+		* Monaco 拿到越界索引会取不到签名而不渲染 —— 裁剪后至少显示首个签名。
+		* @author ddj 2026年09月22号
+		* @param path 工作区相对路径
+		* @param line 0-based 行
+		* @param character 0-based 列
+		* @returns 归一化签名帮助；无签名/不支持时 null
+		*/
+		async signatureHelp(path, line, character) {
+			const doc = docs.get(path);
+			if (!doc || !await readyWait || !capabilities.signatureHelp) return null;
+			return toSignatureHelp(await ensureClient().request("textDocument/signatureHelp", {
+				textDocument: { uri: doc.uri },
+				position: {
+					line,
+					character
+				}
+			}));
+		},
 		/** 查询全文 semantic tokens，并将服务器 legend 归一到插件固定 legend。 */
 		async semanticTokens(path) {
 			const doc = docs.get(path);
@@ -10333,8 +10781,205 @@ function normalizeSymbol(item) {
 	}
 	return symbol;
 }
-/** hover contents → 文本行（MarkupContent | MarkedString | MarkedString[]）。 */
-function stringifyHoverContents(contents) {
+/** hover/markdown 内容 → 纯文本（string | MarkupContent | MarkedString[] | MarkedString）。 */
+function plainText(value) {
+	if (typeof value === "string") return value || void 0;
+	if (Array.isArray(value)) {
+		const parts = value.map(plainText).filter((part) => Boolean(part));
+		return parts.length ? parts.join("\n\n") : void 0;
+	}
+	if (value && typeof value === "object") {
+		const text = value.value;
+		if (typeof text === "string") return text || void 0;
+	}
+}
+/**
+* 归一化补全文本编辑范围（单 range 与 insert/replace 双 range 两种形态）。
+*
+* 两种形态必须都认：只认一种会让采用另一种形态的服务器补全落点错位（替换范围算错，
+* 已输入的前缀被重复插入）。双 range 时 insert 用于「保留前缀插入」，replace 用于覆盖。
+* @author ddj 2026年09月22号
+* @param raw 原始 textEdit
+* @returns 归一化文本编辑；无有效范围或文本时 null
+*/
+function normalizeTextEdit(raw) {
+	if (!raw || typeof raw !== "object") return null;
+	const obj = raw;
+	const newText = typeof obj.newText === "string" ? obj.newText : "";
+	if (!newText) return null;
+	const single = normalizeRange(obj.range);
+	if (single) return {
+		range: single,
+		newText
+	};
+	const insert = normalizeRange(obj.insert);
+	const replace = normalizeRange(obj.replace);
+	if (!insert && !replace) return null;
+	return {
+		insert: insert ?? replace,
+		replace: replace ?? insert,
+		newText
+	};
+}
+/** 归一化 LSP Range（缺字段返回 null，避免产出畸形范围）。 */
+function normalizeRange(raw) {
+	if (!raw || typeof raw !== "object") return null;
+	const r = raw;
+	if (!r.start || !r.end) return null;
+	return {
+		start: {
+			line: toInt(r.start.line),
+			character: toInt(r.start.character)
+		},
+		end: {
+			line: toInt(r.end.line),
+			character: toInt(r.end.character)
+		}
+	};
+}
+/**
+* 归一化单个补全项。
+* @author ddj 2026年09月22号
+* @param raw 原始条目
+* @returns 归一化条目；缺 label 时 null
+*/
+function normCompItem(raw) {
+	if (!raw || typeof raw !== "object") return null;
+	const obj = raw;
+	const label = typeof obj.label === "string" ? obj.label : "";
+	if (!label) return null;
+	const item = { label };
+	if (typeof obj.kind === "number") item.kind = toInt(obj.kind);
+	if (typeof obj.detail === "string" && obj.detail) item.detail = obj.detail;
+	const documentation = plainText(obj.documentation);
+	if (documentation) item.documentation = documentation;
+	if (typeof obj.insertText === "string") item.insertText = obj.insertText;
+	if (typeof obj.insertTextFormat === "number") item.insertTextFormat = toInt(obj.insertTextFormat);
+	const textEdit = normalizeTextEdit(obj.textEdit);
+	if (textEdit) item.textEdit = textEdit;
+	if (obj.data !== void 0) item.data = obj.data;
+	if (typeof obj.sortText === "string") item.sortText = obj.sortText;
+	if (typeof obj.filterText === "string") item.filterText = obj.filterText;
+	if (obj.preselect === true) item.preselect = true;
+	if (Array.isArray(obj.commitCharacters)) {
+		const chars = obj.commitCharacters.filter((c) => typeof c === "string");
+		if (chars.length) item.commitCharacters = chars;
+	}
+	const tags = Array.isArray(obj.tags) ? obj.tags : [];
+	if (obj.deprecated === true || tags.some((tag) => toInt(tag) === 1)) item.deprecated = true;
+	if (Array.isArray(obj.additionalTextEdits)) {
+		const edits = obj.additionalTextEdits.map((edit) => {
+			const range = normalizeRange(edit?.range);
+			const text = edit?.newText;
+			if (!range || typeof text !== "string") return null;
+			return {
+				range,
+				newText: text
+			};
+		}).filter((edit) => edit !== null);
+		if (edits.length) item.additionalTextEdits = edits;
+	}
+	return item;
+}
+/**
+* 归一化补全结果（CompletionList | CompletionItem[]）。
+*
+* 两种顶层形态都要认：`{ isIncomplete, items }` 与裸数组。裸数组是最常见形态，
+* 只认 CompletionList 会让「补全列表恒为空」且无报错。
+* @author ddj 2026年09月22号
+* @param result 原始响应
+* @returns 归一化列表；无效时 null
+*/
+function normCompletion(result) {
+	if (result == null) return null;
+	const list = Array.isArray(result) ? {
+		items: result,
+		isIncomplete: false
+	} : result;
+	if (!Array.isArray(list.items)) return null;
+	return {
+		items: list.items.map(normCompItem).filter((item) => item !== null),
+		incomplete: list.isIncomplete === true
+	};
+}
+/**
+* 补全项 → LSP 载荷（resolve 回传用）。
+* 只回传协议字段，剔除 client 侧衍生字段；`data` 必须原样带上，服务器靠它认条目。
+* @author ddj 2026年09月22号
+* @param item 归一化条目
+* @returns LSP CompletionItem 载荷
+*/
+function toLspCompItem(item) {
+	const out = { label: item.label };
+	if (item.kind !== void 0) out.kind = item.kind;
+	if (item.detail !== void 0) out.detail = item.detail;
+	if (item.documentation !== void 0) out.documentation = item.documentation;
+	if (item.insertText !== void 0) out.insertText = item.insertText;
+	if (item.insertTextFormat !== void 0) out.insertTextFormat = item.insertTextFormat;
+	if (item.data !== void 0) out.data = item.data;
+	if (item.sortText !== void 0) out.sortText = item.sortText;
+	if (item.filterText !== void 0) out.filterText = item.filterText;
+	if (item.textEdit) out.textEdit = item.textEdit.range ? {
+		range: item.textEdit.range,
+		newText: item.textEdit.newText
+	} : item.textEdit;
+	if (item.additionalTextEdits) out.additionalTextEdits = item.additionalTextEdits;
+	if (item.commitCharacters) out.commitCharacters = item.commitCharacters;
+	return out;
+}
+/** 归一化单个签名参数（label 支持字符串与 [start, end] 元组，两者原样透传）。 */
+function toSignatureParam(raw) {
+	if (!raw || typeof raw !== "object") return null;
+	const obj = raw;
+	const tuple = Array.isArray(obj.label) && obj.label.length >= 2 ? [toInt(obj.label[0]), toInt(obj.label[1])] : null;
+	if (typeof obj.label !== "string" && !tuple) return null;
+	const param = { label: typeof obj.label === "string" ? obj.label : tuple };
+	const documentation = plainText(obj.documentation);
+	if (documentation) param.documentation = documentation;
+	return param;
+}
+/** 归一化单个签名。 */
+function toSignature(raw) {
+	if (!raw || typeof raw !== "object") return null;
+	const obj = raw;
+	if (typeof obj.label !== "string") return null;
+	const signature = {
+		label: obj.label,
+		parameters: []
+	};
+	const documentation = plainText(obj.documentation);
+	if (documentation) signature.documentation = documentation;
+	if (Array.isArray(obj.parameters)) signature.parameters = obj.parameters.map(toSignatureParam).filter((param) => param !== null);
+	if (typeof obj.activeParameter === "number") signature.activeParameter = toInt(obj.activeParameter);
+	return signature;
+}
+/**
+* 归一化签名帮助，并裁剪越界的 activeSignature / activeParameter。
+*
+* 为什么必须裁：Monaco 用这两个索引直接取签名与参数，越界时取不到签名就整个浮窗不渲染；
+* 服务器在「实参刚敲下逗号」等边界时刻常给超前一位的索引。裁剪后至少显示首个签名/末个参数，
+* 观感是「高亮没跟上」，而不是「参数提示整个不见」。
+* @author ddj 2026年09月22号
+* @param result 原始响应
+* @returns 归一化结果；无有效签名时 null
+*/
+function toSignatureHelp(result) {
+	if (!result || typeof result !== "object") return null;
+	const obj = result;
+	if (!Array.isArray(obj.signatures)) return null;
+	const signatures = obj.signatures.map(toSignature).filter((signature) => signature !== null);
+	if (!signatures.length) return null;
+	const activeSignature = Math.min(Math.max(0, toInt(obj.activeSignature)), signatures.length - 1);
+	const current = signatures[activeSignature];
+	const rawActive = typeof obj.activeParameter === "number" ? toInt(obj.activeParameter) : current.activeParameter ?? 0;
+	const count = current.parameters.length;
+	return {
+		signatures,
+		activeSignature,
+		activeParameter: count > 0 ? Math.min(Math.max(0, rawActive), count - 1) : 0
+	};
+}
+/** hover contents → 文本行（MarkupContent | MarkedString | MarkedString[]）。 */ function stringifyHoverContents(contents) {
 	if (typeof contents === "string") return [contents];
 	if (Array.isArray(contents)) return contents.map(stringifyHoverContents).flat().filter(Boolean);
 	if (contents && typeof contents === "object") {
@@ -12243,6 +12888,99 @@ function createLspRpc(deps) {
 					};
 				}
 			},
+			"edrv.lsp.completion": async (args) => {
+				const lang = langOfPath(args.path);
+				if (!lang) return {
+					ok: true,
+					completions: 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,
+						completions: void 0
+					};
+					const completions = await server.completion(wsPath(sc.root, args.path), args.position.line, args.position.character, args.context);
+					if (!completions) return {
+						ok: true,
+						completions: void 0
+					};
+					return {
+						ok: true,
+						completions: completions.items.length > 500 ? {
+							...completions,
+							items: completions.items.slice(0, 500),
+							truncated: true
+						} : completions
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "LSP 补全查询失败：" + String(error)
+					};
+				}
+			},
+			"edrv.lsp.resolveCompletion": async (args) => {
+				const lang = langOfPath(args.path);
+				if (!lang) return {
+					ok: true,
+					item: 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,
+						item: args.item
+					};
+					return {
+						ok: true,
+						item: await server.resolveCompletion(wsPath(sc.root, args.path), args.item) ?? void 0
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "LSP 补全解析失败：" + String(error)
+					};
+				}
+			},
+			"edrv.lsp.signatureHelp": async (args) => {
+				const lang = langOfPath(args.path);
+				if (!lang) return {
+					ok: true,
+					signatureHelp: 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,
+						signatureHelp: void 0
+					};
+					return {
+						ok: true,
+						signatureHelp: await server.signatureHelp(wsPath(sc.root, args.path), args.position.line, args.position.character) ?? void 0
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "LSP 签名帮助查询失败：" + String(error)
+					};
+				}
+			},
 			"edrv.lsp.semanticTokens": async (args) => {
 				const lang = langOfPath(args.path);
 				if (!lang) return {
@@ -16428,6 +17166,17 @@ const inject = [
 	"agents"
 ];
 /**
+* 插件 Config schema（cordis 从 module 导出读 `plugin.Config` 做启动校验；
+* DSH 0.1.7 起设置页按此 schema 自动生成表单，设置值 = profile 插件配置）。
+* 字段集与 installOpenSettingsSection 的 section schema 同源（buildSettingsSchema），
+* 全字段带默认值——undefined/空配置经 schemastery 校验自动填充（rc/alpha 两代
+* cordis 均读该导出，实测 4.0.0-rc.8 与 0.1.7 行为一致，校验必过）。
+* 运行时解析：@deepseek-ai/schemastery 经插件自身 node_modules（link/dev/npm 安装
+* 三形态均在 peer/dev 依赖面内，先于宿主树命中）。
+* @author ddj 2026年09月22号
+*/
+const Config = buildSettingsSchema(z);
+/**
 * 装配插件：挂事件监听、注册路由、安装兼容层。
 * @author ddj 2026年08月20号
 * @param ctx DSH 上下文（sessions/fs/webServer 由 inject 提供；sandboxPolicy/subprocess 惰性获取）
@@ -16517,6 +17266,6 @@ async function logCompatSummary(ctx, warnings) {
 	}
 }
 //#endregion
-export { apply, inject, name };
+export { Config, apply, inject, name };
 
 //# sourceMappingURL=index.js.map