dsh-vscode-mode 0.1.57 → 0.1.59

package/lib/client.js

@@ -107,6 +107,92 @@ window.__ModuleLoader__.load({
 			} catch (e) {}
 		}
 		//#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-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/client/log.ts
+		/**
+		* dsh-vscode-mode client — 日志单例（全 client 面唯一日志入口）。
+		* client 无 ctx.logger 服务，固定 console 出口；格式/级别语义与 host 面一致（shared/logger.ts）。
+		* 用法：`import { log } from './log.js'` → `log.debug/info/warn/error(msg)`；子域用 `log.child('scope')`。
+		* 作者 ddj 2026-09-08
+		*/
+		/** client 面插件日志单例。 */
+		const log = createLogger();
+		//#endregion
 		//#region src/client/sidebarBridge.ts
 		/**
 		* dsh-vscode-mode client — 侧边栏编辑区桥：可选探测 dsh-better-sidebar 的
@@ -224,7 +310,7 @@ window.__ModuleLoader__.load({
 			try {
 				return ensureSideEditor(path, focusDiff) === true;
 			} catch (error) {
-				console.warn("[dsh-vscode-mode] 侧栏编辑器打开失败（" + String(error) + "），已回退");
+				log.warn("侧栏编辑器打开失败（" + String(error) + "），已回退");
 				return false;
 			}
 		}
@@ -260,7 +346,7 @@ window.__ModuleLoader__.load({
 						try {
 							registerLegacyFallback();
 						} catch (error) {
-							console.warn("[dsh-vscode-mode] 回退注册失败（" + String(error) + "）");
+							log.warn("回退注册失败（" + String(error) + "）");
 						}
 					}
 					return false;
@@ -282,7 +368,7 @@ window.__ModuleLoader__.load({
 						cwd: scope?.cwd
 					});
 				} catch (error) {
-					console.warn("[dsh-vscode-mode] openTab 失败（" + String(error) + "）");
+					log.warn("openTab 失败（" + String(error) + "）");
 					return false;
 				}
 				if (sideEditorMounted) window.dispatchEvent(new CustomEvent("edrv:open-editor", { detail: {
@@ -303,13 +389,13 @@ window.__ModuleLoader__.load({
 					component: renderTab
 				});
 			} catch (error) {
-				console.warn("[dsh-vscode-mode] 侧边栏 Tab 注册失败（" + String(error) + "）");
+				log.warn("侧边栏 Tab 注册失败（" + String(error) + "）");
 				if (!fallbackInstalled) {
 					fallbackInstalled = true;
 					try {
 						registerLegacyFallback();
 					} catch (inner) {
-						console.warn("[dsh-vscode-mode] 回退注册失败（" + String(inner) + "）");
+						log.warn("回退注册失败（" + String(inner) + "）");
 					}
 				}
 				return () => {};
@@ -1763,6 +1849,22 @@ window.__ModuleLoader__.load({
 			if (idx === 0 && record.callHunk && typeof record.callHunk.newText === "string") return record.callHunk;
 			return null;
 		}
+		/**
+		* 差异比较口径归一化：剥离 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)
+			};
+		}
 		/** splitLines 的空文本语义：真实空文件没有一行变更内容。 */
 		function splitLines(text) {
 			return text.length ? text.split("\n") : [];
@@ -1893,7 +1995,7 @@ window.__ModuleLoader__.load({
 		}
 		/** 记录是否仍有待处理差异（superseded / 全部已决策 = false）。 */
 		function isRecPending(rec) {
-			if (!rec || rec.superseded === true || rec.conflict === true) return false;
+			if (!rec || rec.superseded === true) return false;
 			const perHunk = Array.isArray(rec.decisions?.perHunk) ? rec.decisions.perHunk : [];
 			if (perHunk.length) {
 				for (let i = 0; i < perHunk.length; i++) if (perHunk[i] !== "accepted" && perHunk[i] !== "rejected" && !noopHunk(rec, (rec.hunks || [])[i])) return true;
@@ -1964,11 +2066,18 @@ window.__ModuleLoader__.load({
 				shift: prefix
 			};
 		}
-		/** 计算文件内各差异区域（行范围 + old/new + 状态），用于行内绿标注与 DiffBox。 */
+		/**
+		* 计算文件内各差异区域（行范围 + old/new + 状态），用于行内绿标注与 DiffBox。
+		* 定位统一基于归一化文本（剥 BOM、CRLF→LF）：外部工具可能改变行尾/BOM，
+		* 与 edit 工具的 LF hunk 口径不一致会导致定位失败（差异被误标 stale）。
+		* 行号按 \n 计数，归一化不改变行号，展示语义不变。
+		* @author ddj 2026年09月09号
+		*/
 		function diffRegions(records, content) {
 			const regions = [];
 			if (content === null) return regions;
-			const lines = splitLines(content);
+			const normalized = normalizeForCompare(content);
+			const lines = splitLines(normalized);
 			for (const rec of records) {
 				if (rec.create) {
 					for (let i = 0; i < rec.hunks.length; i++) {
@@ -1995,10 +2104,10 @@ window.__ModuleLoader__.load({
 					const hunk = preciseHunk(rec, i);
 					if (hunk && !noopHunk(rec, hunk)) entries.push({
 						idx: i,
-						hunk
+						hunk: normalizeHunk(hunk)
 					});
 				}
-				const locations = locateHunks(content, entries.map((entry) => entry.hunk));
+				const locations = locateHunks(normalized, entries.map((entry) => entry.hunk));
 				for (let i = 0; i < entries.length; i++) {
 					const entry = entries[i];
 					const location = locations[i];
@@ -2017,7 +2126,7 @@ window.__ModuleLoader__.load({
 						});
 						continue;
 					}
-					const start = countLinesBefore(content, location.start) + 1;
+					const start = countLinesBefore(normalized, location.start) + 1;
 					const trimmed = trimCommonLines(entry.hunk.oldText === null ? [] : entry.hunk.oldText.split("\n"), entry.hunk.newText.split("\n"));
 					const regionStart = start + trimmed.shift;
 					regions.push({
@@ -3684,7 +3793,7 @@ window.__ModuleLoader__.load({
 			tokenTypes: [...LSP_SEMANTIC_TOKEN_TYPES],
 			tokenModifiers: [...LSP_SEMANTIC_TOKEN_MODIFIERS]
 		};
-		let registered = false;
+		let registered$1 = false;
 		const disposables = [];
 		/** 目标文件打开并定位（复用现有 openFileAt 的 edrv:open-editor 事件通道）。 */
 		function openAt(path, line, column) {
@@ -3701,8 +3810,8 @@ window.__ModuleLoader__.load({
 		}
 		/** 注册全部 Monaco LSP provider 与文档跟踪（幂等）。 */
 		function registerLspProviders(monaco) {
-			if (registered) return;
-			registered = true;
+			if (registered$1) return;
+			registered$1 = true;
 			const attachModel = (model) => {
 				if (!model || model.uri.scheme !== "edrv") return;
 				const path = pathOfModel(model);
@@ -3947,7 +4056,7 @@ window.__ModuleLoader__.load({
 		* 数据来源于语义 token（每 model+version 缓存 60s），不做逐词 LSP 查询。
 		* 作者 ddj 2026-09-02
 		*/
-		const CACHE_TTL_MS = 6e4;
+		const CACHE_TTL_MS$1 = 6e4;
 		/**
 		* 给一个 Monaco 编辑器绑定 Ctrl+hover 下划线提示（幂等）。
 		* @author ddj 2026年09月02号
@@ -3977,7 +4086,7 @@ window.__ModuleLoader__.load({
 			const rangesOf = async (model) => {
 				const path = pathOfModel(model);
 				const version = model.getVersionId?.() ?? 0;
-				if (cache.path === path && cache.version === version && cache.ranges && Date.now() - cache.at < CACHE_TTL_MS) return cache.ranges;
+				if (cache.path === path && cache.version === version && cache.ranges && Date.now() - cache.at < CACHE_TTL_MS$1) return cache.ranges;
 				const res = await fetchSemanticTokens(path, model.getValue()).catch(() => null);
 				const ranges = res && Array.isArray(res.data) ? decodeSemanticTokens(res.data) : [];
 				cache = {
@@ -4054,6 +4163,237 @@ window.__ModuleLoader__.load({
 			refreshStatus(true);
 		}
 		//#endregion
+		//#region src/shared/ai.ts
+		/**
+		* dsh-vscode-mode shared — AI 内联补全契约与纯函数（双面，禁 node/react）。
+		* 只放"过 RPC 的载荷形状"与无副作用变换：窗口裁剪、prompt 拼装、输出清理。
+		* host 与语言模型之间的流式交互在 host 侧 src/ai/inline.ts。
+		* 作者 ddj
+		*/
+		/** 上下文窗口：前缀字符上限（含未保存编辑的当前文档）。 */
+		const AI_PREFIX_MAX = 2e3;
+		/**
+		* 按 AI_PREFIX_MAX/AI_SUFFIX_MAX 裁剪前后缀（client 侧发请求前调用）。
+		* @author ddj
+		* @param prefix 光标前全文
+		* @param suffix 光标后全文
+		* @returns 裁剪后的窗口
+		*/
+		function trimInlineWindow(prefix, suffix) {
+			const pre = typeof prefix === "string" ? prefix : "";
+			const suf = typeof suffix === "string" ? suffix : "";
+			return {
+				prefix: pre.length > 2e3 ? pre.slice(pre.length - AI_PREFIX_MAX) : pre,
+				suffix: suf.length > 500 ? suf.slice(0, 500) : suf
+			};
+		}
+		/**
+		* 是否值得发起补全请求：前缀达标且非纯空白（空行/行首不请求）。
+		* @author ddj
+		* @param prefix 光标前文本
+		* @returns 是否可请求
+		*/
+		function inlineWorth(prefix) {
+			const pre = typeof prefix === "string" ? prefix : "";
+			if (pre.length < 4) return false;
+			return pre.trim().length > 0;
+		}
+		//#endregion
+		//#region src/client/ai/inlineProvider.ts
+		/**
+		* dsh-vscode-mode client — AI 内联补全（ghost text）provider。
+		* 速度设计：内部 150ms 去抖（Monaco 逐键调用 provider，不逐键打 LLM）、
+		* 在飞取消（新请求 abort 旧的）+ 序号守卫（过期响应丢弃）、
+		* 位置+前缀缓存（dismiss 后同位置重查不重复计费）、前后缀窗口裁剪。
+		* 状态经 edrv:ai-status 事件广播给编辑器底部状态栏；
+		* 差异审查期间静默（edrv 差异块存在时返回空，不与 Keep/Undo 浮层打架）。
+		* 作者 ddj
+		*/
+		/**
+		* 广播补全状态给编辑器底部状态栏（EditorView 监听 edrv:ai-status 渲染）。
+		* @author ddj
+		* @param state busy=请求中 ok=完成（detail.ms 耗时） error=失败（detail.note） idle=就绪 config=开关变化
+		* @param detail 附加信息
+		*/
+		function emitAiStatus(state, detail) {
+			try {
+				window.dispatchEvent(new CustomEvent("edrv:ai-status", { detail: {
+					state,
+					detail
+				} }));
+			} catch {}
+		}
+		/** 去抖等待（毫秒）：Monaco 逐键调用 provider，静默该时长才真正发 RPC；
+		*  网关 TTFT 本身 3.5s+（debug 实证），client 侧去抖压到 150ms 不再叠加明显延迟。 */
+		const DEBOUNCE_MS$1 = 150;
+		/** 缓存容量上限（LRU 超限即整体清空；键空间小，够用）。 */
+		const CACHE_MAX = 30;
+		/** 缓存 TTL（毫秒）。 */
+		const CACHE_TTL_MS = 6e4;
+		let registered = false;
+		let seq = 0;
+		let inFlight = null;
+		let debounceTimer = null;
+		const cache = /* @__PURE__ */ new Map();
+		/** 上次开关状态（configUpdate 后经事件刷新，关闭时立即静默）。 */
+		let enabled = false;
+		/** 供设置面板保存后同步开关状态（不重载页面即时生效）。 */
+		function setAiInlineEnabled(value) {
+			enabled = value === true;
+			emitAiStatus("config", { enabled });
+			if (!enabled) {
+				seq += 1;
+				cache.clear();
+			}
+		}
+		/** 当前开关（EditorView 装配时决定是否注册）。 */
+		function aiInlineEnabled() {
+			return enabled;
+		}
+		/** 初始化开关（启动时从 configGet 拉一次）。 */
+		async function initAiInlineState() {
+			try {
+				const res = await rpc("edrv.ai.configGet", {});
+				setAiInlineEnabled(res?.ok && res.enabled === true);
+			} catch {
+				setAiInlineEnabled(false);
+			}
+		}
+		/**
+		* 缓存键：路径 + 行:列 + 前缀尾 24 字符（同位置不同文本区分）。
+		* @author ddj
+		*/
+		function cacheKey(path, line, column, prefix) {
+			return path + ":" + line + ":" + column + ":" + String(prefix || "").slice(-24);
+		}
+		/**
+		* 差异审查期间静默：编辑器上存在 AI 补全应避让的 pending 差异装饰时返回 true。
+		* 通过编辑器实例上的 edrv 差异装饰类名判定，缺失视为无差异。
+		* @author ddj
+		*/
+		function diffPending(editor) {
+			try {
+				return ((editor?.getModel?.())?.getAllDecorations?.() ?? []).some((d) => String(d?.options?.className || "").includes("edrv-mn-"));
+			} catch {
+				return false;
+			}
+		}
+		/**
+		* 注册 AI 内联补全 provider（幂等；Monaco 就绪后调用一次）。
+		* @author ddj
+		* @param monaco window.monaco
+		*/
+		function registerAiInline(monaco) {
+			if (registered || !monaco?.languages?.registerInlineCompletionsProvider) return;
+			registered = true;
+			monaco.languages.registerInlineCompletionsProvider("*", {
+				async provideInlineCompletions(model, position, context, token) {
+					const t0 = Date.now();
+					if (!enabled || token?.isCancellationRequested) return { items: [] };
+					const path = decodeURIComponent(String(model?.uri?.path || "").replace(/^\//, ""));
+					if (!path || model.uri.scheme !== "edrv") return { items: [] };
+					const editor = monacoRef?.activeEditor;
+					if (editor && diffPending(editor)) return { items: [] };
+					const offset = model.getOffsetAt(position);
+					const value = model.getValue();
+					const trimmed = trimInlineWindow(value.slice(0, offset), value.slice(offset));
+					if (!inlineWorth(trimmed.prefix)) return { items: [] };
+					const key = cacheKey(path, position.lineNumber, position.column, trimmed.prefix);
+					const hit = cache.get(key);
+					if (hit && Date.now() - hit.at < CACHE_TTL_MS) return hit.items.length ? { items: hit.items } : { items: [] };
+					return new Promise((resolve) => {
+						seq += 1;
+						const mySeq = seq;
+						if (inFlight) {
+							try {
+								inFlight.abort();
+							} catch {}
+							inFlight = null;
+						}
+						if (debounceTimer) clearTimeout(debounceTimer);
+						debounceTimer = setTimeout(async () => {
+							debounceTimer = null;
+							if (mySeq !== seq || token?.isCancellationRequested) {
+								resolve({ items: [] });
+								return;
+							}
+							const controller = new AbortController();
+							inFlight = controller;
+							emitAiStatus("busy");
+							try {
+								const data = await (await fetch(RPC_PATH, {
+									method: "POST",
+									headers: { "content-type": "application/json" },
+									body: JSON.stringify({
+										method: "edrv.ai.inline",
+										args: {
+											path,
+											prefix: trimmed.prefix,
+											suffix: trimmed.suffix
+										}
+									}),
+									signal: controller.signal
+								})).json();
+								if (mySeq !== seq || !data?.ok || typeof data.text !== "string" || !data.text) {
+									cache.set(key, {
+										items: [],
+										at: Date.now()
+									});
+									if (data?.note) emitAiStatus("error", { note: String(data.note) });
+									else emitAiStatus("idle");
+									resolve({ items: [] });
+									return;
+								}
+								const items = [{
+									insertText: data.text,
+									range: void 0
+								}];
+								cacheSet(key, items);
+								emitAiStatus("ok", { ms: Date.now() - t0 });
+								resolve({ items });
+							} catch (error) {
+								emitAiStatus("error", { note: String(error && error.message || error).slice(0, 80) });
+								resolve({ items: [] });
+							} finally {
+								if (inFlight === controller) inFlight = null;
+							}
+						}, DEBOUNCE_MS$1);
+						const guard = setInterval(() => {
+							if (mySeq !== seq || token?.isCancellationRequested) {
+								clearInterval(guard);
+								if (debounceTimer) {
+									clearTimeout(debounceTimer);
+									debounceTimer = null;
+								}
+								resolve({ items: [] });
+							} else if (!debounceTimer) clearInterval(guard);
+						}, 120);
+					});
+				},
+				freeInlineCompletions() {}
+			});
+		}
+		/** 缓存写入（超限整体清空，LRU 简化）。 */
+		function cacheSet(key, items) {
+			if (cache.size >= CACHE_MAX) cache.clear();
+			cache.set(key, {
+				items,
+				at: Date.now()
+			});
+		}
+		/** EditorView ref 注入口（差异静默判定用当前编辑器）。 */
+		let monacoRef = null;
+		/** EditorView 装配后调用（注册 provider + 初始化开关）。 */
+		function setupAiInline(monaco) {
+			monacoRef = monaco && { activeEditor: null };
+			if (!registered) registerAiInline(monaco);
+			initAiInlineState();
+		}
+		/** EditorView 每次创建/切换编辑器实例时刷新引用。 */
+		function trackAiEditor(editor) {
+			if (monacoRef) monacoRef.activeEditor = editor;
+		}
+		//#endregion
 		//#region src/client/ui/EditorView.ts
 		/**
 		* dsh-vscode-mode client — EditorView：中央 VSCode 式文件编辑器（编排层）。
@@ -4093,6 +4433,12 @@ window.__ModuleLoader__.load({
 			const pdfHostRef = react.default.useRef(null);
 			const [status, setStatus] = react.default.useState("");
 			const [lspServers, setLspServers] = react.default.useState([]);
+			const [aiStatus, setAiStatus] = react.default.useState({
+				state: "idle",
+				detail: null,
+				enabled: false
+			});
+			const aiStatusTimer = react.default.useRef(null);
 			const [error, setError] = react.default.useState(null);
 			const [loadError, setLoadError] = react.default.useState(null);
 			const [loadStage, setLoadStage] = react.default.useState({
@@ -4564,6 +4910,39 @@ window.__ModuleLoader__.load({
 					clearInterval(timer);
 				};
 			}, [sessionId]);
+			react.default.useEffect(() => {
+				const apply = (state, detail) => {
+					if (aiStatusTimer.current) {
+						clearTimeout(aiStatusTimer.current);
+						aiStatusTimer.current = null;
+					}
+					setAiStatus((prev) => ({
+						state,
+						detail: detail ?? null,
+						enabled: state === "config" ? detail?.enabled === true : prev.enabled
+					}));
+					if (state === "ok") aiStatusTimer.current = setTimeout(() => setAiStatus((p) => p.state === "ok" ? {
+						...p,
+						state: "idle"
+					} : p), 3e3);
+					else if (state === "error") aiStatusTimer.current = setTimeout(() => setAiStatus((p) => p.state === "error" ? {
+						...p,
+						state: "idle"
+					} : p), 1e4);
+				};
+				const onAiStatus = (e) => {
+					if (e?.detail?.state) apply(e.detail.state, e.detail.detail);
+				};
+				const onAiConfig = (e) => apply("config", { enabled: e?.detail?.enabled === true });
+				window.addEventListener("edrv:ai-status", onAiStatus);
+				window.addEventListener("edrv:ai-config", onAiConfig);
+				apply("config", { enabled: aiInlineEnabled() });
+				return () => {
+					window.removeEventListener("edrv:ai-status", onAiStatus);
+					window.removeEventListener("edrv:ai-config", onAiConfig);
+					if (aiStatusTimer.current) clearTimeout(aiStatusTimer.current);
+				};
+			}, []);
 			react.default.useEffect(() => {
 				const onOpen = (e) => {
 					const p = e?.detail?.path;
@@ -4848,7 +5227,9 @@ window.__ModuleLoader__.load({
 					}));
 				};
 				loadMonaco(onProgress).then((m) => {
-					if (alive) setMonaco(m);
+					if (!alive) return;
+					setMonaco(m);
+					setupAiInline(m);
 				}).catch((e) => {
 					if (alive) {
 						setMonacoErr(String(e?.message ?? e));
@@ -5048,7 +5429,8 @@ window.__ModuleLoader__.load({
 					renderWhitespace: "selection",
 					smoothScrolling: true,
 					cursorBlinking: "smooth",
-					padding: { top: side ? 6 : 8 }
+					padding: { top: side ? 6 : 8 },
+					inlineSuggest: { enabled: true }
 				});
 				ed.onDidChangeModelContent(() => {
 					if (!ed.getModel() || programmaticRef.current) return;
@@ -5134,6 +5516,10 @@ window.__ModuleLoader__.load({
 				});
 				bindLspEditor(ed);
 				bindLspUnderline(ed, m);
+				trackAiEditor(ed);
+				ed.addCommand(m.KeyMod.Alt | m.KeyCode.Backslash, () => {
+					ed.trigger("edrv-ai", "editor.action.inlineSuggest.trigger", null);
+				});
 				const hideSoon = () => {
 					if (hoverEditorRef.current || hoverPanelRef.current || hideTimerRef.current) return;
 					hideTimerRef.current = setTimeout(() => {
@@ -5670,10 +6056,35 @@ window.__ModuleLoader__.load({
 				none: "未配置"
 			}[lspServer.source] ?? lspServer.source) : "LSP " + lspLanguage + " · 未启动";
 			const lspProgress = typeof lspServer?.progress === "number" ? Math.round(lspServer.progress) : null;
-			const lspFooter = lspLanguage === "lua" || lspLanguage === "csharp" ? react.default.createElement("div", {
-				className: "edrv-statusbar",
+			const lspSeg = lspLanguage === "lua" || lspLanguage === "csharp" ? react.default.createElement("span", {
+				className: "edrv-status-seg",
+				style: {
+					display: "inline-flex",
+					alignItems: "center",
+					gap: "10px",
+					minWidth: 0,
+					flex: "1 1 auto"
+				},
 				title: lspServer?.progressMessage || lspLabel
 			}, react.default.createElement("span", { className: "edrv-lsp-status-dot " + (lspServer?.phase === "ready" ? "ready" : lspServer?.phase === "indexing" || lspServer?.phase === "starting" ? "busy" : "idle") }), react.default.createElement("span", { className: "edrv-sp-lsp" }, lspLabel), lspServer?.progressMessage ? react.default.createElement("span", { className: "edrv-sp-progress-message" }, lspServer.progressMessage) : null, lspProgress !== null ? react.default.createElement("span", { className: "edrv-sp-progress" }, lspProgress + "%") : null) : null;
+			const aiEnabled = aiStatus.enabled;
+			const aiState = aiStatus.state;
+			const aiDotCls = aiState === "busy" ? "busy" : aiState === "ok" ? "ready" : aiState === "error" ? "idle" : "ready";
+			const aiMsText = aiStatus.detail && aiStatus.detail.ms != null ? (aiStatus.detail.ms / 1e3).toFixed(1) + "s" : "";
+			const aiNote = aiStatus.detail && aiStatus.detail.note ? String(aiStatus.detail.note) : "";
+			const aiLabel = !aiEnabled ? "AI 补全 · 关" : aiState === "busy" ? "AI 补全请求中…" : aiState === "ok" ? "AI 补全完成" + (aiMsText ? " · " + aiMsText : "") : aiState === "error" ? "AI 补全失败 · " + aiNote.slice(0, 48) : "AI 补全就绪";
+			const aiSeg = active && aiEnabled !== null ? react.default.createElement("span", {
+				className: "edrv-status-seg",
+				style: {
+					display: "inline-flex",
+					alignItems: "center",
+					gap: "10px",
+					minWidth: 0,
+					flex: "0 0 auto"
+				},
+				title: aiState === "error" && aiNote ? aiNote : "AI 自动补全（设置页「AI 补全」可配置）"
+			}, react.default.createElement("span", { className: "edrv-lsp-status-dot " + (!aiEnabled ? "idle" : aiDotCls) }), react.default.createElement("span", { className: "edrv-sp-lsp" }, aiLabel)) : null;
+			const statusBar = lspSeg || aiSeg ? react.default.createElement("div", { className: "edrv-statusbar" }, lspSeg, aiSeg) : null;
 			const navBackTarget = navRef.current.peekBack();
 			const navForwardTarget = navRef.current.peekForward();
 			const navNameOf = (entry) => entry && entry.path ? String(entry.path).split(/[\\/]/).pop() : "";
@@ -5952,7 +6363,7 @@ window.__ModuleLoader__.load({
 					flexDirection: "column",
 					overflow: "hidden"
 				}
-			}, pathBar, tabRow, sideHintEl, editorArea, lspFooter);
+			}, pathBar, tabRow, sideHintEl, editorArea, statusBar);
 			const editorRow = react.default.createElement("div", { className: "edrv-editor-row" }, sidebarPanels ? react.default.createElement(SidebarView, {
 				registry: sidebarPanels,
 				ctx: sidebarCtx,
@@ -6413,14 +6824,14 @@ window.__ModuleLoader__.load({
 		function registerSlotSafely(ctx, spec, render) {
 			const slots = ctx?.slots;
 			if (!slots || typeof slots.inject !== "function" || typeof slots.register !== "function") {
-				console.warn("[dsh-vscode-mode] slots 服务不可用，跳过 slot " + spec.name);
+				log.warn("slots 服务不可用，跳过 slot " + spec.name);
 				return null;
 			}
 			try {
 				const disposer = slots.inject(spec.name, () => slots.register(spec, render));
 				return typeof disposer === "function" ? disposer : null;
 			} catch (error) {
-				console.warn("[dsh-vscode-mode] slot " + spec.name + " 注册失败（" + String(error) + "），已跳过");
+				log.warn("slot " + spec.name + " 注册失败（" + String(error) + "），已跳过");
 				return null;
 			}
 		}
@@ -7861,6 +8272,111 @@ window.__ModuleLoader__.load({
 			}, busy === "add" ? "校验中…" : "添加")), react.default.createElement("small", null, "安装 = 复制到 <项目>/Packages/com.dsh.editor（内嵌包）；更新 = 整目录替换；卸载 = 删除该目录。Unity 打开时切回窗口自动刷新生效。插件卸载/重载时会自动清理并恢复右键菜单注册（「移除注册」后不再恢复）。")));
 		}
 		//#endregion
+		//#region src/client/ui/AiSettings.ts
+		/**
+		* dsh-vscode-mode client — AI 补全设置卡片。
+		* 开关 + 模型下拉（edrv.ai.models 目录，按 provider 分组，默认「自动」）+
+		* 思考强度下拉（随所选模型的 efforts 元数据动态渲染：无档位隐藏；含「跟随默认」）。
+		* 保存走 edrv.ai.configUpdate；保存后广播 edrv:ai-config 事件让 provider 即时生效。
+		* 作者 ddj
+		*/
+		/**
+		* AI 补全设置卡片（设置页「AI 补全」Tab 主体）。
+		* @author ddj
+		*/
+		function AiSettings() {
+			const [cfg, setCfg] = react.default.useState(null);
+			const [dir, setDir] = react.default.useState(null);
+			const [note, setNote] = react.default.useState("");
+			const [error, setError] = react.default.useState("");
+			const [busy, setBusy] = react.default.useState(false);
+			react.default.useEffect(() => {
+				Promise.all([rpc("edrv.ai.configGet", {}), rpc("edrv.ai.models", {})]).then(([c, d]) => {
+					if (c.ok) setCfg({
+						enabled: c.enabled,
+						provider: c.provider,
+						model: c.model,
+						effort: c.effort
+					});
+					else setError(c.error || "配置读取失败");
+					if (d.ok) setDir(d);
+					else setError(d.error || "模型目录读取失败");
+				}).catch((e) => setError(String(e)));
+			}, []);
+			/** 所选 provider 下的模型条目（自动路由时取首组供档位参考）。 */
+			const modelsOf = (provider) => {
+				if (!dir?.providers?.length) return [];
+				if (!provider) return dir.providers[0]?.models ?? [];
+				return dir.providers.find((p) => p.id === provider)?.models ?? [];
+			};
+			/** 档位可选项：模型无 reasoning 元数据 → 空数组（选择器隐藏）。 */
+			const efforts = (() => {
+				const models = modelsOf(cfg?.provider);
+				return models.find((m) => m.model === cfg?.model)?.efforts ?? models[0]?.efforts ?? [];
+			})();
+			const save = async (patch) => {
+				setBusy(true);
+				setError("");
+				try {
+					const res = await rpc("edrv.ai.configUpdate", patch);
+					if (!res.ok) throw new Error(res.error || "保存失败");
+					setCfg({
+						enabled: res.enabled,
+						provider: res.provider,
+						model: res.model,
+						effort: res.effort
+					});
+					setAiInlineEnabled(res.enabled);
+					setNote("已保存");
+					window.dispatchEvent(new CustomEvent("edrv:ai-config", { detail: { enabled: res.enabled } }));
+				} catch (e) {
+					setError(String(e));
+				} finally {
+					setBusy(false);
+				}
+			};
+			const toggle = () => save({ enabled: !cfg.enabled });
+			const pickModel = (value) => {
+				if (!value) return save({
+					provider: "",
+					model: ""
+				});
+				const idx = value.indexOf("/");
+				const provider = value.slice(0, idx);
+				const model = value.slice(idx + 1);
+				const keep = (modelsOf(provider).find((m) => m.model === model)?.efforts ?? []).some((e) => e.id === cfg.effort);
+				save(keep ? {
+					provider,
+					model
+				} : {
+					provider,
+					model,
+					effort: ""
+				});
+			};
+			if (!cfg) return react.default.createElement("div", { className: "vsm-mcp-empty" }, error || "正在读取 AI 补全配置…");
+			const modelValue = cfg.provider && cfg.model ? cfg.provider + "/" + cfg.model : "";
+			return react.default.createElement("section", { className: "vsm-lsp-card" }, react.default.createElement("h3", null, "AI 自动补全（实验）"), react.default.createElement("p", { className: "vsm-lsp-note" }, "编辑停顿后由模型生成内联建议（ghost text），Tab 接受，Alt+\\ 手动触发。每次补全是一次模型调用；建议选择非推理模型，且思考强度选「跟随默认」或最低档以获得更快响应。"), react.default.createElement("div", { className: "vsm-lsp-row" }, react.default.createElement("button", {
+				className: cfg.enabled ? "vsm-primary" : "",
+				disabled: busy,
+				onClick: toggle
+			}, cfg.enabled ? "已开启（点击关闭）" : "已关闭（点击开启）")), react.default.createElement("div", { className: "vsm-lsp-row" }, react.default.createElement("label", null, "模型", react.default.createElement("select", {
+				value: modelValue,
+				disabled: busy || !dir?.providers?.length,
+				onChange: (e) => pickModel(e.target.value)
+			}, react.default.createElement("option", { value: "" }, dir?.providers?.length ? "自动（取第一个可用模型）" : "无可用模型"), (dir?.providers ?? []).flatMap((p) => p.models.map((m) => react.default.createElement("option", {
+				key: p.id + "/" + m.model,
+				value: p.id + "/" + m.model
+			}, p.name + " · " + m.name))))), efforts.length ? react.default.createElement("label", null, "思考强度", react.default.createElement("select", {
+				value: cfg.effort,
+				disabled: busy,
+				onChange: (e) => save({ effort: e.target.value })
+			}, react.default.createElement("option", { value: "" }, "跟随默认"), efforts.map((e) => react.default.createElement("option", {
+				key: e.id,
+				value: e.id
+			}, e.name)))) : null), note && react.default.createElement("div", { className: "vsm-compat-item ok" }, react.default.createElement("span", { className: "vsm-compat-name" }, note)), error && react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, error));
+		}
+		//#endregion
 		//#region src/client/ui/McpSettings.ts
 		/**
 		* dsh-vscode-mode client — VSCodeMode 设置区：通用 / 快捷键 / MCP 管理 / 语言服务器 / 性能优化 / 兼容性。
@@ -8372,6 +8888,7 @@ window.__ModuleLoader__.load({
 			});
 			else if (tab === "compat") body = react.default.createElement(CompatSection, { getSummary: compatSummary });
 			else if (tab === "lsp") body = react.default.createElement(LspSettings, null);
+			else if (tab === "ai") body = react.default.createElement(AiSettings, null);
 			else body = react.default.createElement(PerfSettings, null);
 			return react.default.createElement("section", { className: "vsm-mcp-page" }, react.default.createElement("header", { className: "vsm-mcp-header" }, react.default.createElement("div", null, react.default.createElement("h2", null, "VSCodeMode"), react.default.createElement("p", null, "管理当前 profile 与各项目的 Model Context Protocol 服务。"))), react.default.createElement("nav", { className: "vsm-mcp-tabs" }, react.default.createElement("button", {
 				className: tab === "general" ? "active" : "",
@@ -8386,6 +8903,9 @@ window.__ModuleLoader__.load({
 				className: tab === "lsp" ? "active" : "",
 				onClick: () => setTab("lsp")
 			}, "语言服务器"), react.default.createElement("button", {
+				className: tab === "ai" ? "active" : "",
+				onClick: () => setTab("ai")
+			}, "AI 补全"), react.default.createElement("button", {
 				className: tab === "perf" ? "active" : "",
 				onClick: () => setTab("perf")
 			}, "性能优化"), react.default.createElement("button", {
@@ -8914,12 +9434,12 @@ window.__ModuleLoader__.load({
 			if (!params) return;
 			const referrer = options.referrer ?? (typeof document !== "undefined" ? document.referrer : "");
 			if (!referrerAllowed(referrer, options.origin ?? (typeof location !== "undefined" ? location.origin : ""))) {
-				console.warn("[dsh-vscode-mode] 已忽略跨源深链请求（referrer=" + referrer + "）");
+				log.warn("已忽略跨源深链请求（referrer=" + referrer + "）");
 				return;
 			}
 			stripCurrentUrl();
 			openDeepLink(ctx, params).catch((error) => {
-				console.warn("[dsh-vscode-mode] 深链打开失败：" + String(error));
+				log.warn("深链打开失败：" + String(error));
 				toastDom("深链打开失败：" + String(error?.message ?? error));
 			});
 		}
@@ -11776,8 +12296,8 @@ window.__ModuleLoader__.load({
 			let selected = autoValue("auto");
 			/** 0.1.3+ 会话文件链接路由（remote.session.openWorkspacePath）是否已安装（compatSummary 展示用）。 */
 			let remoteOpenInstalled = false;
-			/** 两条文件链接路由共用的路由日志（openPathRouter / remoteOpenRouter）。 */
-			const routeLogger = (message) => console.warn("[dsh-vscode-mode] " + message);
+			/** 两条文件链接路由共用的路由日志（openPathRouter / remoteOpenRouter；统一走插件日志器）。 */
+			const routeLogger = (message) => log.warn(message);
 			/** 两条路由共用的 FileOpenContext：当前会话 id 与工作区 cwd。 */
 			const openContext = () => {
 				const current = sessions?.list?.getSnapshot?.();
@@ -11877,7 +12397,7 @@ window.__ModuleLoader__.load({
 			let remoteRetries = 0;
 			const retryRemoteOpen = () => {
 				if (remoteOpenInstalled || remoteRetries >= 15) {
-					if (!remoteOpenInstalled) console.warn("[dsh-vscode-mode] 未探测到 remote.session.openWorkspacePath，0.1.3+ 会话文件链接路由未安装");
+					if (!remoteOpenInstalled) log.warn("未探测到 remote.session.openWorkspacePath，0.1.3+ 会话文件链接路由未安装");
 					return;
 				}
 				remoteRetries += 1;
@@ -11895,12 +12415,12 @@ window.__ModuleLoader__.load({
 						logger: routeLogger
 					});
 					if (!disposer) {
-						console.warn("[dsh-vscode-mode] remote.session 存在但 openWorkspacePath 不可补丁，会话文件链接路由未安装");
+						log.warn("remote.session 存在但 openWorkspacePath 不可补丁，会话文件链接路由未安装");
 						return;
 					}
 					remoteOpenInstalled = true;
 					ctx.effect(() => disposer, "vscode-mode: remote file link routing");
-					console.info("[dsh-vscode-mode] 已安装 0.1.3+ 会话文件链接路由（remote.session.openWorkspacePath）");
+					log.info("已安装 0.1.3+ 会话文件链接路由（remote.session.openWorkspacePath）");
 				}, 2e3);
 			};
 			retryRemoteOpen();
@@ -11971,7 +12491,7 @@ window.__ModuleLoader__.load({
 					if (sideService !== void 0) return;
 					sideService = detectSidebarService(ctx);
 					if (sideService !== void 0) {
-						console.info("[dsh-vscode-mode] 检测到 dsh-better-sidebar，切换侧边栏编辑形态");
+						log.info("检测到 dsh-better-sidebar，切换侧边栏编辑形态");
 						applySideForm();
 					} else retrySideService();
 				}, 2e3);