dsh-vscode-mode 0.1.57 → 0.1.59

package/lib/index.js

@@ -140,9 +140,125 @@ const SHELL_MENU_LEAF = "DSHEditor";
 /** 深链基址默认值（DSH Web GUI 默认端口，dsh-web.cmd 实证）。 */
 const INTEGRATION_BASE_DEFAULT = "http://127.0.0.1:3080";
 //#endregion
+//#region src/shared/logger.ts
+/**
+* dsh-vscode-mode — 统一日志核心（双面共享，平台中立）。
+* 输出规范：
+* - 格式：`[dsh-vscode-mode][:scope] 消息`；前缀只在模块内部拼接，业务代码禁止手写前缀
+* - 级别语义：debug=诊断明细 / info=装配与路由里程碑 / warn=降级与兼容回退 / error=失败
+* - 出口：host 面经 bindHostLog(ctx) 绑定 ctx.logger（缺失回退 console）；client 面固定 console
+* - 诊断文件通道（edrv.debug → ~/.dsh/dsh-vscode-mode/logs/）见 debugLog.ts，与本模块前缀共用
+* 新增日志一律 `import { log } from '../log.js'`（client 为 './log.js'）后调 log.debug/info/warn/error；
+* 子域日志用 log.child('scope')，禁止另起 console。
+* 作者 ddj 2026-09-08
+*/
+/** 插件统一日志前缀（与包安装名一致）。 */
+const LOG_PREFIX = "[dsh-vscode-mode]";
+/** 默认级别到 console 方法名的映射。 */
+const CONSOLE_METHODS = {
+	debug: "debug",
+	info: "info",
+	warn: "warn",
+	error: "error"
+};
+/**
+* 默认出口：console（级别直映方法；方法缺失时静默丢弃，不抛错）。
+* @author ddj 2026年09月08号
+* @returns console 出口
+*/
+function consoleSink() {
+	return (level, line) => {
+		const emit = console[CONSOLE_METHODS[level]];
+		if (typeof emit === "function") emit.call(console, line);
+	};
+}
+/**
+* DSH host 出口工厂：转接 ctx.logger（方法级可选调用，缺服务/缺方法回退 console）。
+* @author ddj 2026年09月08号
+* @param ctx DSH host 上下文
+* @returns 日志出口
+*/
+function ctxLogSink(ctx) {
+	const base = consoleSink();
+	return (level, line) => {
+		const logger = ctx?.logger;
+		const emit = logger?.[level];
+		if (typeof emit === "function") emit.call(logger, line);
+		else base(level, line);
+	};
+}
+/**
+* 拼一行日志：`[dsh-vscode-mode][:scope] 消息`（scope 为空省略冒号段）。
+* @author ddj 2026年09月08号
+* @param scope 子域（可空）
+* @param message 消息文本
+* @returns 整行文本
+*/
+function formatLine(scope, message) {
+	const text = String(message);
+	return scope ? LOG_PREFIX + ":" + scope + " " + text : LOG_PREFIX + " " + text;
+}
+/**
+* 日志器工厂（内部）：emit 时读共享出口状态，保证父 bind 后子实例跟随。
+* @author ddj 2026年09月08号
+* @param state 共享出口状态
+* @param scope 子域文本（可空）
+* @returns 日志器
+*/
+function makeLogger(state, scope) {
+	const emit = (level, message) => state.sink(level, formatLine(scope, message));
+	return {
+		debug: (message) => emit("debug", message),
+		info: (message) => emit("info", message),
+		warn: (message) => emit("warn", message),
+		error: (message) => emit("error", message),
+		bind(next) {
+			state.sink = next;
+		},
+		child(next) {
+			return makeLogger(state, scope ? scope + "." + next : next);
+		}
+	};
+}
+/**
+* 创建插件日志器（默认 console 出口；host 面单例由 bindHostLog 换到 ctx.logger）。
+* @author ddj 2026年09月08号
+* @param sink 初始出口（缺省 console）
+* @param scope 初始子域（业务方一般经 child 派生，不直接传）
+* @returns 日志器
+*/
+function createLogger(sink = consoleSink(), scope = "") {
+	return makeLogger({ sink }, scope);
+}
+//#endregion
+//#region src/log.ts
+/**
+* dsh-vscode-mode host — 日志单例（全 host 面唯一日志入口）。
+* 默认 console 出口；apply() 首行调 bindHostLog(ctx) 切到 ctx.logger（缺失回退 console）。
+* 用法：`import { log } from './log.js'` → `log.debug/info/warn/error(msg)`；子域用 `log.child('scope')`。
+* 作者 ddj 2026-09-08
+*/
+/** host 面插件日志单例（格式/级别语义见 shared/logger.ts 头注释）。 */
+const log = createLogger();
+/**
+* 装配期绑定 host 日志出口：ctx.logger 可用时全部日志转经 DSH 日志系统。
+* @author ddj 2026年09月08号
+* @param ctx DSH host 上下文（logger 服务缺失时保持 console 出口）
+*/
+function bindHostLog(ctx) {
+	log.bind(ctxLogSink(ctx));
+}
+//#endregion
 //#region src/fileOpenSettings.ts
 const FILE_OPEN_SETTINGS_NS = "dsh-vscode-mode";
 const FILE_OPEN_DEFAULT = "auto";
+/** AI 内联补全配置默认值（默认关闭；路由空 = 自动；档位空 = 跟随模型默认）。 */
+const AI_CONFIG_DEFAULT = {
+	enabled: false,
+	provider: "",
+	model: "",
+	effort: ""
+};
 let depsPromise;
 /**
 * 动态加载设置依赖（模块级缓存；任一缺失/失败返回 null 而非抛错）。
@@ -205,7 +321,7 @@ async function runSettingsInstall(ctx, ns, schema, entry, hooks, loader = loadSe
 		deps = await loader();
 	} catch {}
 	if (!deps) {
-		console.warn("[dsh-vscode-mode] 设置依赖不可用，section " + ns + " 未安装（配置回退）");
+		log.warn("设置依赖不可用，section " + ns + " 未安装（配置回退）");
 		return recordInstall("none", INSTALL_NONE);
 	}
 	const legacy = deps.installSettingsSection;
@@ -213,7 +329,7 @@ async function runSettingsInstall(ctx, ns, schema, entry, hooks, loader = loadSe
 		legacy(ctx, ns, schema, entry, hooks);
 		return recordInstall("legacy", INSTALL_LEGACY);
 	} catch (error) {
-		console.warn("[dsh-vscode-mode] legacy 设置安装失败，尝试服务路由：" + String(error));
+		log.warn("legacy 设置安装失败，尝试服务路由：" + String(error));
 	}
 	const ctxInject = ctx.inject;
 	if (typeof ctxInject !== "function") return recordInstall("none", INSTALL_NONE);
@@ -223,7 +339,7 @@ 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") {
-				console.warn("[dsh-vscode-mode] settings 服务无 installSection（DSH 版本 API 变化），section " + ns + " 降级为配置值");
+				log.warn("settings 服务无 installSection（DSH 版本 API 变化），section " + ns + " 降级为配置值");
 				recordInstall("none", INSTALL_NONE);
 				return;
 			}
@@ -231,12 +347,12 @@ async function runSettingsInstall(ctx, ns, schema, entry, hooks, loader = loadSe
 				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 + " 降级为配置值");
+				log.warn("settings.installSection 安装失败（" + String(error) + "），section " + ns + " 降级为配置值");
 				recordInstall("none", INSTALL_NONE);
 			}
 		});
 	} catch (error) {
-		console.warn("[dsh-vscode-mode] settings 服务路由不可用（" + String(error) + "）");
+		log.warn("settings 服务路由不可用（" + String(error) + "）");
 		return recordInstall("none", INSTALL_NONE);
 	}
 	if (observedInstall.strategy !== "unknown") return observedInstall.strategy;
@@ -285,20 +401,34 @@ async function installOpenSettingsSection(ctx, ns, entry, hooks, loader = loadSe
 		fileOpenTool: deps.z.string().default(FILE_OPEN_DEFAULT),
 		keybindings: deps.z.object(keybindingsShape(deps.z)).default({ ...KEYBINDING_DEFAULTS }),
 		sidebarMinWidth: deps.z.number().default(300),
-		integrationBaseUrl: deps.z.string().default(INTEGRATION_BASE_DEFAULT)
+		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)
 	}), entry, {
 		setSource: (source) => hooks.setSource(source),
 		onChange: hooks.onChange
 	}, loader);
 	return strategy === "legacy" || strategy === "service";
 }
+/** AI 配置脏值读取（settings 未就绪时回退默认）。 */
+function aiValueOf(stored) {
+	const raw = stored ?? {};
+	return {
+		enabled: raw.aiInline === true,
+		provider: typeof raw.aiProvider === "string" ? raw.aiProvider : AI_CONFIG_DEFAULT.provider,
+		model: typeof raw.aiModel === "string" ? raw.aiModel : AI_CONFIG_DEFAULT.model,
+		effort: typeof raw.aiEffort === "string" ? raw.aiEffort : AI_CONFIG_DEFAULT.effort
+	};
+}
 /**
 * 注册设置命名空间，并提供 host 侧的读取与更新状态。
 * @author ddj 2026年08月24号
 * @param ctx DSH host 上下文
 * @param config 插件组合配置
 * @param onChange 设置变化回调
-* @returns 设置状态
+* @returns 设置状态（fileOpenTool 值 + AI 补全配置读写）
 */
 function setupOpenSettings(ctx, config, onChange) {
 	let current = configValue(config);
@@ -311,17 +441,27 @@ function setupOpenSettings(ctx, config, onChange) {
 	const syncRevision = () => {
 		revision = (provider?.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS))?.revision;
 	};
-	const setSource = (source) => notify(source().fileOpenTool);
 	const settingsChange = () => syncRevision();
+	/** AI 配置当前值（settings 未就绪回退默认）。 */
+	let aiCurrent = { ...AI_CONFIG_DEFAULT };
+	const aiSync = () => {
+		const stored = (provider?.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS))?.value;
+		aiCurrent = stored !== void 0 ? aiValueOf(stored) : aiCurrent;
+	};
 	installOpenSettingsSection(ctx, FILE_OPEN_SETTINGS_NS, {
 		fileOpenTool: current,
 		integrationBaseUrl: baseValueOf(config)
 	}, {
-		setSource,
+		setSource: (source) => {
+			notify(source().fileOpenTool);
+			aiCurrent = aiValueOf(source());
+			syncRevision();
+		},
 		onChange: settingsChange
 	});
 	ctx.inject?.(["settings"], (settingsCtx) => {
 		provider = settingsCtx.get("settings");
+		aiSync();
 		syncRevision();
 	});
 	return {
@@ -341,6 +481,37 @@ function setupOpenSettings(ctx, config, onChange) {
 			const stored = (provider.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS))?.value;
 			notify(stored?.fileOpenTool ?? next);
 			syncRevision();
+		},
+		ai: () => aiCurrent,
+		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) {
+				stored.enabled = patch.enabled;
+				body.aiInline = patch.enabled;
+			}
+			if (patch.provider !== void 0) {
+				stored.provider = patch.provider;
+				body.aiProvider = patch.provider;
+			}
+			if (patch.model !== void 0) {
+				stored.model = patch.model;
+				body.aiModel = patch.model;
+			}
+			if (patch.effort !== void 0) {
+				stored.effort = patch.effort;
+				body.aiEffort = patch.effort;
+			}
+			await provider.update(FILE_OPEN_SETTINGS_NS, body, expectedRevision);
+			aiSync();
+			return aiCurrent;
 		}
 	};
 }
@@ -1246,6 +1417,22 @@ function hunkOf(record, idx) {
 function isNoopHunk(hunk) {
 	return !!hunk && hunk.oldText !== null && hunk.oldText === hunk.newText;
 }
+/**
+* 差异比较口径归一化：剥离 UTF-8 BOM、统一 CRLF 为 LF。
+* 背景：外部工具（pwsh/编辑器）可能改变 BOM/行尾，导致 after 指纹与 hunk
+* 定位在内容语义未变的情况下误报 conflict，把待确认修改从 UI 排除。
+* @author ddj 2026年09月09号
+*/
+function normalizeForCompare(text) {
+	return text.replace(/^\uFEFF/, "").replace(/\r\n/g, "\n");
+}
+/** 归一化一个 hunk 的两侧文本（与 normalizeForCompare 同口径）。 */
+function normalizeHunk(hunk) {
+	return {
+		oldText: hunk.oldText === null ? null : normalizeForCompare(hunk.oldText),
+		newText: normalizeForCompare(hunk.newText)
+	};
+}
 /** 按文件顺序为多 hunk 写入不重复的 after 坐标。 */
 function annotateHunks(hunks, before, after) {
 	if (typeof after !== "string") return hunks;
@@ -1698,7 +1885,7 @@ async function saveBucket(ctx, cwd, recsMap, session) {
 		existing.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 		await fs.writeText(target, JSON.stringify(existing), void 0, void 0, policyOf(ctx, session));
 	} catch (error) {
-		console.error("edrv saveBucket failed", error);
+		log.error("saveBucket failed: " + String(error));
 	}
 }
 /**
@@ -1763,7 +1950,12 @@ async function recordIsStale(ctx, session, cache, rec) {
 		rec.conflict = false;
 		return false;
 	}
-	if (locateHunks(state.content, pending.map((item) => item.hunk)).some((location) => location.matched)) {
+	const normalizedContent = normalizeForCompare(state.content);
+	if (rec.after != null && fingerprint(normalizeForCompare(rec.after)) === fingerprint(normalizedContent)) {
+		rec.conflict = false;
+		return false;
+	}
+	if (locateHunks(normalizedContent, pending.map((item) => normalizeHunk(item.hunk))).some((location) => location.matched)) {
 		rec.conflict = false;
 		return false;
 	}
@@ -1838,7 +2030,7 @@ async function appendArchiveEntries(ctx, cwd, entries, session) {
 		};
 		await fs.writeText(target, JSON.stringify(data), void 0, void 0, policyOf(ctx, session));
 	} catch (error) {
-		console.error("edrv appendArchiveEntries failed", error);
+		log.error("appendArchiveEntries failed: " + String(error));
 	}
 }
 /**
@@ -2432,7 +2624,7 @@ async function captureToolResult(ctx, registry, exec, result) {
 		await saveBucket(ctx, cwd, bucket, session);
 		invalidateIndex(ctx, cwd, path);
 	} catch (error) {
-		console.error("edrv capture failed", error);
+		log.error("capture failed: " + String(error));
 	}
 }
 //#endregion
@@ -5366,6 +5558,83 @@ async function revealInExplorer(ctx, absPath, isDir) {
 	}
 }
 //#endregion
+//#region src/debugLog.ts
+/**
+* dsh-vscode-mode host — 诊断文件通道（client 上报 → 缓冲批量落盘）。
+* 通道：edrv.debug RPC → 内存缓冲（满/空闲触发）→ 串行读改写
+*       `~/.dsh/dsh-vscode-mode/logs/debug.<cwdHash>.log`（512KB 上限截断保留尾部）。
+* 设计：console 不一定落盘，文件可靠；写失败静默忽略（调试日志不阻塞业务）。
+* 迁移自 src/rpc.ts（enqueueDebug/flushDebug），逻辑一字不改，仅终端回显改走统一日志器。
+* 作者 ddj 2026-09-08
+*/
+/** cwd → 内存缓冲：行数组 + 累计字节数 + 待触发 flush 定时器（攒批落盘，避免每条日志全文件读改写）。 */
+const debugBuffers = /* @__PURE__ */ new Map();
+/** cwd → Promise 链：串行化 debug 日志落盘（fs read+write 非原子，避免并发丢行）。 */
+const debugWriteQueues = /* @__PURE__ */ new Map();
+/** debug 日志单文件上限：超限截断保留尾部，防文件无限增长拖慢每次追加。 */
+const DEBUG_LOG_CAP = 524288;
+/** debug 日志批量缓冲上限：攒满即落盘（一次读改写），上限内不逐条写文件。 */
+const DEBUG_BUF_CAP = 32768;
+/** debug 日志空闲 flush 延迟：缓冲未满时，静默一段时间后落盘一次。 */
+const DEBUG_FLUSH_IDLE_MS = 1e3;
+/** cwd → 已清理旧工作区 debug 日志标记（一次性）。 */
+const debugLegacyCleaned = /* @__PURE__ */ new Set();
+/** 诊断回显日志器（终端回显统一带 `[dsh-vscode-mode:debug]` 前缀）。 */
+const debugLog = log.child("debug");
+/**
+* 批量落盘一条 debug 日志缓冲：读旧文件 → 追加 → 超上限截断保留尾部 → 一次写回。
+* 串行链保证同一 cwd 的读改写不交错丢行；写失败静默忽略（调试日志不阻塞业务）。
+* @author ddj 2026年09月08号
+* @param cwd 工作区（日志落 ~/.dsh/dsh-vscode-mode/logs/debug.<cwdHash>.log）
+* @param batch 本批日志行
+*/
+function flushDebug(cwd, batch) {
+	const task = (debugWriteQueues.get(cwd) ?? Promise.resolve()).then(async () => {
+		try {
+			await mkdir(pluginLogRoot(), { recursive: true });
+			const target = debugLogFile(cwd);
+			const appended = await readFile(target, "utf8").catch(() => "") + batch.map((l) => (/* @__PURE__ */ new Date()).toISOString() + " " + l + "\n").join("");
+			const next = appended.length > DEBUG_LOG_CAP ? appended.slice(-Math.floor(DEBUG_LOG_CAP / 2)) : appended;
+			await writeFile(target, next, "utf8");
+			if (!debugLegacyCleaned.has(cwd)) {
+				debugLegacyCleaned.add(cwd);
+				await rm(join(cwd, DEBUG_LOG), { force: true }).catch(() => {});
+			}
+		} catch (e) {}
+	});
+	debugWriteQueues.set(cwd, task);
+	return task;
+}
+/**
+* 记录一条 client 上报的诊断日志：入队缓冲批量落盘 + 终端回显（`[dsh-vscode-mode:debug]` 前缀）。
+* @author ddj 2026年09月08号
+* @param _ctx DSH 上下文（入参保留：诊断通道按 cwd 隔离，当前不需要 ctx，未来过滤用）
+* @param cwd 工作区（日志文件按 cwd hash 隔离）
+* @param text 单条日志文本（不含换行）
+*/
+function debugRecord(_ctx, cwd, text) {
+	const st = debugBuffers.get(cwd) ?? {
+		lines: [],
+		len: 0,
+		timer: null
+	};
+	st.lines.push(text);
+	st.len += text.length;
+	const flush = () => {
+		st.timer = null;
+		const batch = st.lines;
+		st.lines = [];
+		st.len = 0;
+		flushDebug(cwd, batch);
+	};
+	if (st.len >= DEBUG_BUF_CAP) {
+		if (st.timer) clearTimeout(st.timer);
+		flush();
+	} else if (!st.timer) st.timer = setTimeout(flush, DEBUG_FLUSH_IDLE_MS);
+	debugBuffers.set(cwd, st);
+	debugLog.error(text);
+}
+//#endregion
 //#region src/perf.ts
 /**
 * dsh-vscode-mode host — DSH 会话性能管理（会话卫生 + 体积 stat + 侧车摘要）。
@@ -5823,75 +6092,10 @@ function patchInsertPerfConfig(text) {
 }
 //#endregion
 //#region src/rpc.ts
-/** cwd → 内存缓冲：行数组 + 累计字节数 + 待触发 flush 定时器（攒批落盘，避免每条日志全文件读改写）。 */
-const debugBuffers = /* @__PURE__ */ new Map();
-/** cwd → Promise 链：串行化 debug 日志落盘（fs read+write 非原子，避免并发丢行）。 */
-const debugWriteQueues = /* @__PURE__ */ new Map();
-/** debug 日志单文件上限：超限截断保留尾部，防文件无限增长拖慢每次追加。 */
-const DEBUG_LOG_CAP = 524288;
-/** debug 日志批量缓冲上限：攒满即落盘（一次读改写），上限内不逐条写文件。 */
-const DEBUG_BUF_CAP = 32768;
-/** debug 日志空闲 flush 延迟：缓冲未满时，静默一段时间后落盘一次。 */
-const DEBUG_FLUSH_IDLE_MS = 1e3;
 /** cwd → 上次 stale 自动清理时间：全量轮询（EditorView/DiffBadge/Dock 各自 5s）节流，避免每轮都读文件算指纹。 */
 const staleCheckedAt = /* @__PURE__ */ new Map();
 /** stale 自动清理最小间隔。 */
 const STALE_CHECK_MIN_MS = 1e4;
-/**
-* 调试日志入队：先攒内存缓冲（行 + 字节数），满 DEBUG_BUF_CAP 立即落盘，
-* 否则空闲 DEBUG_FLUSH_IDLE_MS 后落盘；落盘 = 读旧文件 + 追加整批 + 超限截断 + 一次写入。
-* @author ddj 2026年08月26号 / 2026年09月01号
-* @param ctx DSH 上下文
-* @param cwd 工作区（日志按 cwd hash 存 ~/.dsh/dsh-vscode-mode/logs/）
-* @param line 单条日志文本（不含换行）
-*/
-function enqueueDebug(ctx, cwd, line) {
-	const st = debugBuffers.get(cwd) ?? {
-		lines: [],
-		len: 0,
-		timer: null
-	};
-	st.lines.push(line);
-	st.len += line.length;
-	const flush = () => {
-		st.timer = null;
-		const batch = st.lines;
-		st.lines = [];
-		st.len = 0;
-		flushDebug(cwd, batch);
-	};
-	if (st.len >= DEBUG_BUF_CAP) {
-		if (st.timer) clearTimeout(st.timer);
-		flush();
-	} else if (!st.timer) st.timer = setTimeout(flush, DEBUG_FLUSH_IDLE_MS);
-	debugBuffers.set(cwd, st);
-}
-/** cwd → 已清理旧工作区 debug 日志标记（一次性）。 */
-const debugLegacyCleaned = /* @__PURE__ */ new Set();
-/**
-* 批量落盘一条 debug 日志缓冲：读旧文件 → 追加 → 超上限截断保留尾部 → 一次写回。
-* 串行链保证同一 cwd 的读改写不交错丢行；写失败静默忽略（调试日志不阻塞业务）。
-* @author ddj 2026年08月26号 / 2026年09月01号
-* @param cwd 工作区（日志落 ~/.dsh/dsh-vscode-mode/logs/debug.<cwdHash>.log）
-* @param batch 本批日志行
-*/
-function flushDebug(cwd, batch) {
-	const task = (debugWriteQueues.get(cwd) ?? Promise.resolve()).then(async () => {
-		try {
-			await mkdir(pluginLogRoot(), { recursive: true });
-			const target = debugLogFile(cwd);
-			const appended = await readFile(target, "utf8").catch(() => "") + batch.map((l) => (/* @__PURE__ */ new Date()).toISOString() + " " + l + "\n").join("");
-			const next = appended.length > DEBUG_LOG_CAP ? appended.slice(-Math.floor(DEBUG_LOG_CAP / 2)) : appended;
-			await writeFile(target, next, "utf8");
-			if (!debugLegacyCleaned.has(cwd)) {
-				debugLegacyCleaned.add(cwd);
-				await rm(join(cwd, DEBUG_LOG), { force: true }).catch(() => {});
-			}
-		} catch (e) {}
-	});
-	debugWriteQueues.set(cwd, task);
-	return task;
-}
 /** 记录 → 客户端视图（不含 before 全文，仅长度）。 */
 function recView(record) {
 	return {
@@ -6023,9 +6227,10 @@ async function integrationBaseUrlOf(ctx) {
 	return (typeof value?.integrationBaseUrl === "string" ? value.integrationBaseUrl.trim() : "") || "http://127.0.0.1:3080";
 }
 /** 各方法 handler 表（类型由 shared/rpc 的 RpcHandlerMap 约束）。 */
-function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers) {
+function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers, aiHandlers) {
 	return {
 		...lspHandlers ?? {},
+		...aiHandlers ?? {},
 		"edrv.list": async (args) => {
 			const sc = await requireSession(ctx, args.sessionId);
 			if ("err" in sc) return {
@@ -6395,9 +6600,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				ok: false,
 				error: sc.err
 			};
-			const text = String(args.text ?? "");
-			enqueueDebug(ctx, sc.cwd, text);
-			console.error("[edrv-debug] " + text);
+			debugRecord(ctx, sc.cwd, String(args.text ?? ""));
 			return { ok: true };
 		},
 		"edrv.searchFiles": async (args) => {
@@ -7094,8 +7297,8 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 * 统一入口：按方法分发到 handler 表。
 * @author ddj 2026年08月20号 / 2026年08月26号
 */
-async function handleRpc(ctx, registry, method, args, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers) {
-	const handler = buildHandlers(ctx, registry, searcher, contentSearcher, lspHandlers)[method];
+async function handleRpc(ctx, registry, method, args, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers, aiHandlers) {
+	const handler = buildHandlers(ctx, registry, searcher, contentSearcher, lspHandlers, aiHandlers)[method];
 	if (!handler) return {
 		ok: false,
 		error: "未知方法: " + String(method)
@@ -7166,7 +7369,7 @@ function syncAgent(ctx, state, agent, tools) {
 	if (denied.length > 0) try {
 		state.dispose = agent.ctx.tools.restrict({ deny: denied });
 	} catch (error) {
-		ctx.logger?.warn?.("[dsh-vscode-mode] MCP agent restriction failed: " + String(error));
+		log.warn("MCP agent restriction failed: " + String(error));
 		return;
 	}
 	state.denyKey = nextKey;
@@ -10100,6 +10303,261 @@ function createLspRpc(deps) {
 		disposeSession
 	};
 }
+/** 补全请求超时（毫秒）：codebuddy CLI 网关实测 TTFT 3.5~8.4s 抖动（debug 实证），
+*  12s 内无任何 token 即放弃；token 一到仍按行数/字符早停。 */
+const AI_TIMEOUT_MS = 12e3;
+/**
+* 拼装补全 user 消息文本：语言/文件名 + 前缀 + 补全点标记 + 后缀。
+* host 侧与单测共用，保证请求形状一致。
+* @author ddj
+* @param req 补全请求（已裁剪）
+* @returns 用户消息文本
+*/
+function buildInlinePrompt(req) {
+	return [
+		"文件：" + (String(req.path || "").split(/[\\/]/).pop() || "untitled"),
+		"现有代码（光标位于 <CURSOR> 标记处）：",
+		req.prefix + "<CURSOR>" + req.suffix
+	].join("\n");
+}
+/** 补全 system 提示词：硬约束输出形态（只给插入文本）。 */
+const AI_INLINE_SYSTEM = "你是代码自动补全引擎。只输出应插入 <CURSOR> 处的代码文本：禁止任何解释、注释性语句、markdown 代码围栏或对原文的复述；最多 3 行，从光标处自然衔接前文，不要重复前缀已有内容；无法给出高置信度补全时输出空文本。";
+/**
+* 清理模型输出：剥 markdown 围栏、剥对 <CURSOR> 标记的复述、按行数截断、去首尾空行。
+* 产出空文本的判定也在这里（纯函数，单测覆盖）。
+* @author ddj
+* @param raw 模型原始输出
+* @param prefix 请求时的前缀（复述检测）
+* @returns 清理后的插入文本（可能为空串）
+*/
+function cleanInlineText(raw, prefix) {
+	let text = typeof raw === "string" ? raw : "";
+	if (!text) return "";
+	const fenced = /^```[^\n]*\n([\s\S]*?)\n?```$/.exec(text.trim());
+	if (fenced) text = fenced[1] ?? "";
+	const cursorAt = text.indexOf("<CURSOR>");
+	if (cursorAt >= 0) text = text.slice(cursorAt + 8);
+	const tailPrefix = prefix.length > 0 ? prefix.slice(-40) : "";
+	if (tailPrefix && text.startsWith(tailPrefix)) text = text.slice(tailPrefix.length);
+	const lines = text.split("\n").slice(0, 3).map((l) => l.replace(/\s+$/, ""));
+	while (lines.length > 0 && lines[0] === "") lines.shift();
+	while (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
+	return lines.join("\n");
+}
+//#endregion
+//#region src/ai/inline.ts
+/** 模型目录缓存（进程级：5 分钟 TTL，避免每次打开设置页都逐模型 resolve）。 */
+const DIR_TTL_MS = 3e5;
+let dirCache = null;
+/**
+* 取 llm 运行时（惰性；缺失/未装配返回 null 并给诊断）。
+* @author ddj
+* @param ctx DSH 上下文
+* @returns llm 运行时或 null
+*/
+function llmOf(ctx) {
+	try {
+		const llm = ctx.get("llm");
+		return llm && typeof llm.stream === "function" ? llm : null;
+	} catch {
+		return null;
+	}
+}
+/**
+* 解析请求路由：用户配置优先（provider/model 均非空），否则取目录首个 provider+model。
+* @author ddj
+* @param llm llm 运行时
+* @param cfg AI 配置
+* @returns 路由（provider/model）；不可路由返回 null
+*/
+async function routeOf(llm, cfg) {
+	if (cfg.provider && cfg.model) return {
+		provider: cfg.provider,
+		model: cfg.model
+	};
+	const providers = llm.listProviders();
+	if (!providers.length) return null;
+	const provider = cfg.provider || providers[0].id;
+	const models = await llm.listModels(provider).catch(() => []);
+	if (!models.length) return null;
+	return {
+		provider,
+		model: models[0].id
+	};
+}
+/**
+* 单次 AI 内联补全。
+* @author ddj
+* @param deps 服务依赖
+* @param req 补全请求（client 已裁剪窗口）
+* @returns 补全结果（text 空 = 无建议）
+*/
+async function aiInlineComplete(deps, req) {
+	const cfg = deps.config.get();
+	if (!cfg.enabled) return { text: "" };
+	if (!req || typeof req.prefix !== "string" || !req.prefix) return { text: "" };
+	const llm = llmOf(deps.ctx);
+	if (!llm) return {
+		text: "",
+		note: "llm 服务不可用"
+	};
+	const route = await routeOf(llm, cfg);
+	if (!route) return {
+		text: "",
+		note: "未找到可用模型（请检查 DSH 模型配置）"
+	};
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(/* @__PURE__ */ new Error("timeout")), AI_TIMEOUT_MS);
+	try {
+		const stream = llm.stream({
+			provider: route.provider,
+			model: route.model,
+			...cfg.effort ? { reasoningEffort: cfg.effort } : {},
+			messages: [{
+				role: "user",
+				content: [{
+					type: "text",
+					text: buildInlinePrompt(req)
+				}],
+				source: { kind: "user" }
+			}],
+			system: AI_INLINE_SYSTEM,
+			temperature: .2,
+			maxTokens: 120,
+			signal: controller.signal
+		});
+		let text = "";
+		let aborted = false;
+		let failNote = "";
+		let reasoningChars = 0;
+		for await (const chunk of stream) {
+			const c = chunk;
+			if (c.type === "text-delta") {
+				text += c.text;
+				if (text.split("\n").length > 3 || text.length >= 300) {
+					controller.abort(/* @__PURE__ */ new Error("early-stop"));
+					aborted = true;
+				}
+			} else if (c.type === "reasoning-delta") reasoningChars += c.text.length;
+			else if (c.type === "finish") {
+				const kind = c.reason?.kind;
+				if (kind === "error" || kind === "aborted") {
+					const failure = c.reason.failure;
+					failNote = (failure?.code ?? kind) + ": " + (failure?.message ?? "模型调用失败");
+					log.debug("[ai-inline] 流失败：" + failNote);
+				}
+				break;
+			} else if (c.type === "usage" || c.type === "block-start" || c.type === "block-end") {} else if (c.type === "tool-call-delta") {}
+			if (aborted) break;
+		}
+		if (failNote) return {
+			text: "",
+			note: "AI 补全失败：" + failNote
+		};
+		const clean = cleanInlineText(text, req.prefix);
+		if (!clean) {
+			if (text.length === 0 && reasoningChars > 0) {
+				log.debug("[ai-inline] 仅思考无正文（reasoning " + reasoningChars + " 字符）");
+				return {
+					text: "",
+					note: "该模型只返回了思考没有正文，请在设置页换非思考模型"
+				};
+			}
+			log.debug("[ai-inline] 空输出（原始 " + text.length + " 字符）");
+			return { text: "" };
+		}
+		return { text: clean };
+	} catch (error) {
+		const msg = error instanceof Error ? error.message : String(error);
+		log.debug("[ai-inline] 失败：" + msg);
+		return {
+			text: "",
+			note: "AI 补全失败：" + msg
+		};
+	} finally {
+		clearTimeout(timer);
+	}
+}
+/**
+* 模型目录视图（edrv.ai.models）：DSH 已配置 provider 全量 + 逐模型思考档位。
+* @author ddj
+* @param ctx DSH 上下文
+* @param force 跳过缓存强制刷新
+* @returns 目录视图（llm 缺失时 note 说明 + 空目录）
+*/
+async function aiModels(ctx, force = false) {
+	if (!force && dirCache && Date.now() - dirCache.at < DIR_TTL_MS) return dirCache.view;
+	const llm = llmOf(ctx);
+	if (!llm) return {
+		providers: [],
+		note: "llm 服务不可用（无法枚举模型）"
+	};
+	const out = { providers: [] };
+	for (const p of llm.listProviders()) {
+		const models = await llm.listModels(p.id).catch(() => []);
+		const entries = [];
+		for (const m of models) {
+			let efforts = [];
+			let def = "";
+			try {
+				const info = await llm.resolveModelInfo(p.id, m.id);
+				efforts = (info.reasoning?.efforts ?? []).map((e) => ({
+					id: e.id,
+					name: e.name
+				}));
+				def = info.reasoning?.defaultEffort ?? "";
+			} catch {}
+			entries.push({
+				provider: p.id,
+				model: m.id,
+				name: m.name || m.id,
+				efforts,
+				defaultEffort: def
+			});
+		}
+		out.providers.push({
+			id: p.id,
+			name: p.name || p.id,
+			models: entries
+		});
+	}
+	dirCache = {
+		view: out,
+		at: Date.now()
+	};
+	return out;
+}
+//#endregion
+//#region src/ai/rpc.ts
+/**
+* 构造 edrv.ai.* handlers（一次性创建，无跨请求状态——目录缓存在 inline.ts 模块级）。
+* @author ddj
+* @param deps 依赖（ctx/settings）
+* @returns handlers
+*/
+function createAiRpc(deps) {
+	return { handlers: {
+		"edrv.ai.inline": async (args) => ({
+			ok: true,
+			...await aiInlineComplete({
+				ctx: deps.ctx,
+				config: { get: () => deps.settings.ai() }
+			}, args)
+		}),
+		"edrv.ai.models": async (args) => ({
+			ok: true,
+			...await aiModels(deps.ctx, args?.force === true)
+		}),
+		"edrv.ai.configGet": async () => ({
+			ok: true,
+			...deps.settings.ai()
+		}),
+		"edrv.ai.configUpdate": async (args) => ({
+			ok: true,
+			...await deps.settings.aiUpdate(args)
+		})
+	} };
+}
 //#endregion
 //#region src/index.ts
 /**
@@ -10107,7 +10565,8 @@ function createLspRpc(deps) {
 * 职责：装配 capture（tools/result 捕获 edit/write 差异）、RPC 分发（edrv.* / mcp.* / vscode.* / compat）、
 *       webServer 路由（/edrv/rpc、/edrv/assets/*、/edrv/vendor/*）、工作区旁车持久化、
 *       兼容层装配（依赖守卫 + 重复装配自诊断 + 启动日志兼容性报告）。
-* 结构：shared/（双面契约） + model/store/capture/workspace/revert/registry/rpc/routes/compat（host 模块）。
+* 结构：shared/（双面契约） + model/store/capture/workspace/revert/registry/rpc/routes/compat（host 模块）
+*       + log/debugLog（统一日志：bindHostLog 绑定 ctx.logger，edrv.debug 诊断文件通道）。
 * 作者 ddj 2026-08-20
 */
 const name = "dsh-vscode-mode";
@@ -10127,18 +10586,20 @@ const inject = [
 * @param config 插件配置（可选 imageDir 覆盖图标目录）
 */
 function apply(ctx, config) {
+	bindHostLog(ctx);
 	const registry = /* @__PURE__ */ new Map();
 	const searcher = newSearcher(ctx);
 	const contentSearcher = newContentSearcher(ctx);
-	/** LSP 服务器管理器（语言智能：跳转/引用/大纲）。 */
-	const lspManager = createLspManager((line) => ctx.logger?.debug?.("[" + name + "] " + line));
+	/** LSP 服务器管理器（语言智能：跳转/引用/大纲；诊断行带模块内前缀如 [lsp-manager]）。 */
+	const lspManager = createLspManager((line) => log.debug(line));
 	/** 兼容性警告收集（route 护栏等写入，启动日志一并输出）。 */
 	const warnings = [];
-	setupOpenSettings(ctx, config, () => {});
+	/** 设置状态（fileOpenTool + AI 补全配置读写；settings 不可用时内存态降级）。 */
+	const openSettings = setupOpenSettings(ctx, config, () => {});
 	/** LSP 配置为配置值模式：插件组合配置 + 会话内运行时覆盖（原 settings section 命名空间不合法，见 lsp/config.ts）。 */
 	/** 规则注入 section（~/.dsh/rules 与 <工作区>/.dsh/rules；旧版 DSH 无 systemPrompt 时静默降级）。 */
 	const rulesInstalled = installRulesSection(ctx);
-	if (!rulesInstalled) ctx.logger?.warn?.("[" + name + "] 未检测到 systemPrompt 服务，规则仅可管理不注入");
+	if (!rulesInstalled) log.warn("未检测到 systemPrompt 服务，规则仅可管理不注入");
 	/** LSP RPC 与会话清理（一次性创建，tracker 状态跨请求保留）。 */
 	const lspRpc = createLspRpc({
 		ctx,
@@ -10146,6 +10607,10 @@ function apply(ctx, config) {
 		manager: lspManager
 	});
 	const lspHandlers = lspRpc.handlers;
+	const aiHandlers = createAiRpc({
+		ctx,
+		settings: openSettings
+	}).handlers;
 	ctx.on("tools/result", (exec, result) => {
 		captureToolResult(ctx, registry, exec, result);
 	});
@@ -10161,7 +10626,7 @@ function apply(ctx, config) {
 		const sid = session?.id;
 		if (typeof sid === "string") lspRpc.disposeSession(sid);
 	});
-	registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher, lspHandlers), (warning) => warnings.push(warning));
+	registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher, lspHandlers, aiHandlers), (warning) => warnings.push(warning));
 	installIsolation(ctx);
 	ctx.effect(() => shellMenuLifecycle(ctx));
 	sweepTreeCache();
@@ -10170,7 +10635,7 @@ function apply(ctx, config) {
 		lspManager.disposeAll().catch(() => {});
 		disposeAllServers();
 	});
-	ctx.logger?.info?.("[" + name + "] 编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用，语言服务器 LSP 已接入，规则注入" + (rulesInstalled ? "已接入" : "未接入") + "）");
+	log.info("编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用，语言服务器 LSP 已接入，规则注入" + (rulesInstalled ? "已接入" : "未接入") + "）");
 }
 /**
 * 异步输出兼容性报告摘要（含重复装配/路由冲突自诊断）。
@@ -10182,13 +10647,11 @@ async function logCompatSummary(ctx, warnings) {
 	try {
 		const report = await buildReport(ctx);
 		for (const warning of warnings) report.warnings.push(warning);
-		const logger = ctx.logger;
-		if (!logger?.info) return;
-		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 + "，无警告");
+		const head = "兼容性：" + (report.dshVersion ? "DSH " + report.dshVersion : "DSH 未探测") + " · " + report.external.length + " 项外部适配 / " + report.guards.length + " 项护栏 / " + (report.adapters?.length ?? 0) + " 项版本适配";
+		if (report.warnings.length) log.warn(head + "，警告 " + report.warnings.length + " 条：" + report.warnings.join("；"));
+		else log.info(head + "，无警告");
 	} catch (error) {
-		ctx.logger?.warn?.("[dsh-vscode-mode] 兼容性报告生成失败：" + String(error));
+		log.warn("兼容性报告生成失败：" + String(error));
 	}
 }
 //#endregion