dsh-vscode-mode 0.1.58 → 0.1.60

package/lib/client.js

@@ -1849,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") : [];
@@ -1979,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;
@@ -2050,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++) {
@@ -2081,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];
@@ -2103,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({
@@ -3770,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) {
@@ -3787,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);
@@ -4033,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号
@@ -4063,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 = {
@@ -4140,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 式文件编辑器（编排层）。
@@ -4179,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({
@@ -4650,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;
@@ -4934,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));
@@ -5134,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;
@@ -5220,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(() => {
@@ -5756,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() : "";
@@ -6018,7 +6343,7 @@ window.__ModuleLoader__.load({
 			const copyInstallCmd = () => {
 				if (navigator.clipboard?.writeText) navigator.clipboard.writeText(SIDEBAR_INSTALL_CMD).catch(() => {});
 			};
-			const sideHintEl = layout === "tab" && sideHint && !hintDismissed ? react.default.createElement("div", { className: "edrv-side-hint" }, react.default.createElement("span", { className: "edrv-side-hint-text" }, "安装 dsh-better-sidebar 后可启用侧边栏编辑（对话+编辑同屏）："), react.default.createElement("code", { className: "edrv-side-hint-cmd" }, SIDEBAR_INSTALL_CMD), react.default.createElement("button", {
+			const sideHintEl = layout === "tab" && sideHint && !hintDismissed ? react.default.createElement("div", { className: "edrv-side-hint" }, react.default.createElement("span", { className: "edrv-side-hint-text" }, "DSH 0.1.5+ 自带官方右侧侧边栏（升级即用）；旧版可安装 dsh-better-sidebar 启用侧边栏编辑（对话+编辑同屏）："), react.default.createElement("code", { className: "edrv-side-hint-cmd" }, SIDEBAR_INSTALL_CMD), react.default.createElement("button", {
 				className: "edrv-pill edrv-pill-ghost",
 				title: "复制安装命令",
 				onClick: copyInstallCmd
@@ -6038,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,
@@ -6558,14 +6883,254 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/officialSidebar.ts
+		/**
+		* dsh-vscode-mode client — 官方右侧 Sidebar 桥：探测 DSH 0.1.5-alpha.1+ 的
+		* ctx.sidebarRightTabs / ctx.sidebarRight 服务，两段式注册「文件编辑」Tab
+		* （类型定义进注册表，正文进 keyed slot sidebar.right.pane.tab）。
+		* 可选依赖模式：服务缺失时调用方回退 better-sidebar / 中央页签；本模块不注册任何东西。
+		* 维护约定：官方侧边栏（DSH 0.1.5+）是侧边栏编辑形态的唯一维护面；
+		* dsh-better-sidebar 桥（sidebarBridge.ts）已归档，仅作旧版 DSH 回退，不再新增能力。
+		* 纯逻辑（探测/导航参数解析）可单测，注册装配仅存在于 install 路径。
+		* 作者 ddj 2026年09月09号
+		*/
+		/** 官方 Tab 类型注册表服务名（ctx.get 用；不进 inject——旧版 DSH 无此包，inject 会停等）。 */
+		const OFFICIAL_TABS_SERVICE = "sidebarRightTabs";
+		/** 官方导航控制器服务名（ctx.get 用）。 */
+		const OFFICIAL_SERVICE = "sidebarRight";
+		/** 官方 keyed slot 名（Tab 正文挂点，由官方侧边栏的 rightbar seat 声明）。 */
+		const OFFICIAL_SLOT_NAME = "sidebar.right.pane.tab";
+		/** 本插件 Tab 类型定义 id（官方约定用包名；正文 slot 的 key 与之相同）。 */
+		const OFFICIAL_TAB_ID = "dsh-vscode-mode";
+		/** 本插件 Tab 的类型判别符（ctx.sidebarRight.openTab 的 kind）。 */
+		const OFFICIAL_TAB_KIND = "edrvEditor";
+		/** Tab 标题（与 better-sidebar 形态一致）。 */
+		const OFFICIAL_TAB_TITLE = "文件编辑";
+		/** file 地址认领的 patterns（extension 档接管官方 textpreview 的 fallback 认领，注销自动回落）。 */
+		const OFFICIAL_FILE_PATTERN = "dsh-resource://file/**";
+		/** file 资源类型的定义 id（正文 slot 的 key）。 */
+		const OFFICIAL_FILE_TAB_ID = "dsh-vscode-mode/file";
+		/** file 资源类型的 kind（与页类型 edrvEditor 区分：同 kind 只允许一份 extension）。 */
+		const OFFICIAL_FILE_KIND = "edrvEditorFile";
+		/**
+		* 结构化探测官方右侧 Sidebar 服务（可选依赖：缺失/降级返回 undefined）。
+		* 服务仅存在于 DSH 0.1.5-alpha.1+，探测命中 ≡ 版本判定成立。
+		* @author ddj 2026年09月09号
+		* @param ctx 客户端服务上下文
+		* @returns 注册表与控制器对，或 undefined
+		*/
+		function detectOfficial(ctx) {
+			try {
+				const tabs = ctx.get(OFFICIAL_TABS_SERVICE);
+				const service = ctx.get(OFFICIAL_SERVICE);
+				if (!tabs || typeof tabs.register !== "function") return void 0;
+				if (!service || typeof service.openTab !== "function") return void 0;
+				return {
+					tabs,
+					service
+				};
+			} catch {
+				return;
+			}
+		}
+		/**
+		* 从官方导航参数安全解析打开请求（缺字段/坏类型一律降级为空请求，不抛错）。
+		* @author ddj 2026年09月09号
+		* @param params openTab 传入的 params（正文经 navigation.params 读回）
+		* @returns 待打开路径与是否聚焦首个差异
+		*/
+		function resolveNavOpen(params) {
+			const value = params ?? {};
+			return {
+				path: typeof value?.openPath === "string" && value.openPath ? value.openPath : null,
+				focusDiff: value?.focusDiff === true
+			};
+		}
+		/** 逐段 component 解码（失败返回 null，对齐官方 parseFileAddress 的容错语义）。 */
+		function decodeSegment(raw) {
+			if (raw === void 0) return null;
+			try {
+				return decodeURIComponent(raw);
+			} catch {
+				return null;
+			}
+		}
+		/**
+		* 解析官方 file 资源地址（镜像 dsh-util-workspace-path 的 parseFileAddress 语法，不 import 官方包）。
+		* session 域：`dsh-resource://file/session/<sessionId>/<逐段编码的相对路径>`；
+		* absolute 域：`dsh-resource://file/absolute/<去前导 / 的绝对路径>`（POSIX 补回前导 /，
+		* Windows 盘符 `C:/` 原样，UNC 保留空首段 `//server/share`）。
+		* @author ddj 2026年09月09号
+		* @param address 候选地址
+		* @returns 文件路径（session 域附带 sessionId）；非 file 地址/畸形/解码失败返回 null
+		*/
+		function parseOfficialFileAddress(address) {
+			if (typeof address !== "string" || !address.startsWith("dsh-resource://file/")) return null;
+			const [scope, ...tail] = address.slice(20).split("/");
+			const kind = decodeSegment(scope);
+			if (kind === "session") {
+				const sessionId = decodeSegment(tail[0]);
+				const segments = tail.slice(1).map(decodeSegment);
+				if (!sessionId || segments.length === 0 || segments.some((s) => s === null)) return null;
+				const path = segments.join("/");
+				return path ? {
+					path,
+					sessionId
+				} : null;
+			}
+			if (kind === "absolute") {
+				const unc = tail[0] === "" && tail.length > 1;
+				const segments = (unc ? tail.slice(1) : tail).map(decodeSegment);
+				if (segments.length === 0 || segments[0] === "" || segments.some((s) => s === null)) return null;
+				const list = segments;
+				if (unc) return { path: "//" + list.join("/") };
+				if (/^[A-Za-z]:$/.test(list[0])) return { path: list.join("/") };
+				return { path: "/" + list.join("/") };
+			}
+			return null;
+		}
+		/**
+		* file 地址的 Tab chip 标题：解码后的 basename（解码失败回退原始串切片）。
+		* @author ddj 2026年09月09号
+		* @param address file 资源地址
+		* @returns 标题文本
+		*/
+		function officialFileTitle(address) {
+			const source = parseOfficialFileAddress(address)?.path ?? (typeof address === "string" ? address : "");
+			const normalized = source.replace(/\\/g, "/");
+			return normalized.slice(normalized.lastIndexOf("/") + 1) || source;
+		}
+		/** component 编码一段（对齐官方 encodeSegment：盘符冒号保持字面）。 */
+		function encodeSegment(segment) {
+			return encodeURIComponent(segment).replace(/%3A/gi, ":");
+		}
+		/**
+		* 构造官方 file 资源地址（镜像 fileAddressFor 的分派：绝对路径→absolute 域，相对→session 域）。
+		* @author ddj 2026年09月09号
+		* @param path 绝对或工作区相对路径（两种分隔符均可）
+		* @param sessionId 会话 id（相对路径必需；绝对路径可省）
+		* @returns `dsh-resource://file/…` 地址
+		* @throws 路径为空，或相对路径缺 sessionId
+		*/
+		function buildFileAddress(path, sessionId) {
+			const posix = (typeof path === "string" ? path : "").replace(/\\/g, "/");
+			if (!posix.trim()) throw new Error("buildFileAddress：路径为空");
+			if (posix.startsWith("/") || posix.startsWith("//") || /^[A-Za-z]:[/\\]/.test(posix)) {
+				const unc = posix.startsWith("//");
+				const body = posix.replace(/^\/+/, "");
+				return "dsh-resource://file/absolute/" + (unc ? "/" : "") + body.split("/").map(encodeSegment).join("/");
+			}
+			if (!sessionId) throw new Error("buildFileAddress：相对路径需要会话 id");
+			const relative = posix.replace(/^(?:\.\/)+/, "").replace(/^\/+/, "");
+			return "dsh-resource://file/session/" + encodeSegment(sessionId) + "/" + relative.split("/").map(encodeSegment).join("/");
+		}
+		/**
+		* 注册官方 Tab 正文（keyed slot，key=定义 id；slots.inject 等待 rightbar seat 声明）。
+		* @author ddj 2026年09月09号
+		* @param slots slots 服务
+		* @param key 正文注册键（= 类型定义 id）
+		* @param renderTab 正文组件（包装后的 OfficialSideTab）
+		* @returns 注销函数；注册抛错返回 null
+		*/
+		function registerBodySlot(slots, key, renderTab) {
+			try {
+				const disposer = slots.inject(OFFICIAL_SLOT_NAME, () => slots.register({
+					name: OFFICIAL_SLOT_NAME,
+					key
+				}, renderTab));
+				return typeof disposer === "function" ? disposer : null;
+			} catch (error) {
+				log.warn("官方侧边栏正文 slot 注册失败（" + String(error) + "）");
+				return null;
+			}
+		}
+		/**
+		* 注册官方右侧 Sidebar「文件编辑」Tab 并接管打开路由（两段式 + 路由）。
+		* 调用方须把返回值挂进 ctx.effect；类型注册抛错时返回 null，由调用方回退旧形态。
+		* @author ddj 2026年09月09号
+		* @param options 装配参数（探测命中的一对服务 + slots + 正文组件 + guide 文案）
+		* @returns 卸载器（反注册类型与正文 + 撤销路由）；类型注册失败返回 null
+		*/
+		function installOfficial(options) {
+			const { tabs, service, slots, renderTab, guide } = options;
+			const open = (path, focusDiff) => {
+				try {
+					service.openTab(OFFICIAL_TAB_KIND, { params: {
+						openPath: path || void 0,
+						focusDiff
+					} });
+				} catch (error) {
+					log.warn("官方侧边栏打开失败（" + String(error) + "）");
+					return false;
+				}
+				return true;
+			};
+			let typeDisposer = null;
+			try {
+				typeDisposer = tabs.register({
+					id: OFFICIAL_TAB_ID,
+					kind: OFFICIAL_TAB_KIND,
+					priority: "extension",
+					title: () => OFFICIAL_TAB_TITLE,
+					guide: [{
+						order: 20,
+						title: guide.title,
+						description: guide.description
+					}]
+				});
+			} catch (error) {
+				log.warn("官方侧边栏 Tab 类型注册失败（" + String(error) + "），回退旧形态");
+				return null;
+			}
+			setEnsureSideEditor(open);
+			const bodyDisposer = registerBodySlot(slots, OFFICIAL_TAB_ID, renderTab);
+			return () => {
+				if (typeof typeDisposer === "function") typeDisposer();
+				if (typeof bodyDisposer === "function") bodyDisposer();
+				setEnsureSideEditor(null);
+			};
+		}
+		/**
+		* 注册官方 file 资源地址认领（extension 档接管 `dsh-resource://file/**`，
+		* 聊天文件链接/文件树打开改落本插件编辑器；注销后官方 textpreview 自动恢复）。
+		* 认领与否由「文件链接使用工具」设置驱动（见 fileOpeners.shouldClaimFiles）。
+		* @author ddj 2026年09月09号
+		* @param options 装配参数（探测命中的注册表 + slots + 正文组件）
+		* @returns 卸载器（反注册类型与正文）；类型注册抛错返回 null（回落官方查看器）
+		*/
+		function registerOfficialFileClaim(options) {
+			const { tabs, slots, renderTab } = options;
+			let typeDisposer = null;
+			try {
+				typeDisposer = tabs.register({
+					id: OFFICIAL_FILE_TAB_ID,
+					kind: OFFICIAL_FILE_KIND,
+					patterns: [OFFICIAL_FILE_PATTERN],
+					priority: "extension",
+					canOpen: (address) => parseOfficialFileAddress(address) !== null,
+					title: (address) => officialFileTitle(address)
+				});
+			} catch (error) {
+				log.warn("官方 file 地址认领注册失败（" + String(error) + "），链接走官方查看器");
+				return null;
+			}
+			const bodyDisposer = registerBodySlot(slots, OFFICIAL_FILE_TAB_ID, renderTab);
+			return () => {
+				if (typeof typeDisposer === "function") typeDisposer();
+				if (typeof bodyDisposer === "function") bodyDisposer();
+			};
+		}
+		//#endregion
 		//#region src/client/fileOpeners.ts
 		/**
 		* dsh-vscode-mode client — 文件打开器注册表与自动选择。
-		* @author ddj 2026年08月24号
+		* @author ddj 2026年08月24号 / 2026年09月09号
 		*/
 		const AUTO_OPEN_TOOL = "auto";
 		const VSCODE_OPEN_TOOL = "dsh-vscode-mode";
 		const SIDEBAR_OPEN_TOOL = SIDEBAR_PLUGIN;
+		/** 官方右侧侧边栏打开器 id（「文件链接使用工具」下拉的官方选项；DSH 0.1.5+）。 */
+		const OFFICIAL_OPEN_TOOL = "dsh-official-sidebar";
 		/**
 		* 写入外部打开器并触发注册表通知。
 		* @author ddj 2026年08月24号
@@ -6691,6 +7256,36 @@ window.__ModuleLoader__.load({
 			const normalized = path.replace(/\\/g, "/");
 			return normalized.slice(normalized.lastIndexOf("/") + 1) || path;
 		}
+		/**
+		* 文件链接是否由本插件认领官方 file 地址：自动/VSCodeMode 档接管（链接进本插件编辑器），
+		* 官方侧边栏/system/better-sidebar 档不认领（官方查看器或旧版路由生效）。
+		* @author ddj 2026年09月09号
+		* @param selected 「文件链接使用工具」当前值
+		* @returns 是否认领
+		*/
+		function shouldClaimFiles(selected) {
+			return selected === "auto" || selected === "dsh-vscode-mode";
+		}
+		/**
+		* 创建「官方侧边栏」文件打开器（DSH 0.1.5+，经 ctx.sidebarRight.openResource 打开官方查看器）。
+		* 仅官方服务探测命中时注册；下拉选项随注册动态出现（McpSettings 动态渲染）。
+		* @author ddj 2026年09月09号
+		* @param service 官方导航控制器
+		* @returns 文件打开器
+		*/
+		function officialSidebarOpener(service) {
+			return {
+				id: OFFICIAL_OPEN_TOOL,
+				label: "官方侧边栏",
+				description: "在 DSH 官方右侧侧边栏查看器中打开（0.1.5+）",
+				priority: 90,
+				isAvailable: () => typeof service.openResource === "function",
+				open: (path, context) => {
+					if (typeof service.openResource !== "function") throw new Error("官方侧边栏 openResource 能力不可用");
+					service.openResource(buildFileAddress(path, context.sessionId));
+				}
+			};
+		}
 		//#endregion
 		//#region src/client/settingsContext.ts
 		/**
@@ -7947,6 +8542,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 管理 / 语言服务器 / 性能优化 / 兼容性。
@@ -8458,6 +9158,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" : "",
@@ -8472,6 +9173,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", {
@@ -9144,6 +9848,68 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region src/client/ui/OfficialSideTab.ts
+		/**
+		* dsh-vscode-mode client — OfficialSideTab：DSH 官方右侧 Sidebar「文件编辑」Tab 正文包装。
+		* 双用途：页类型 Tab（edrvEditor）经 navigation.params（openPath/focusDiff）打开；
+		* file 资源类型 Tab（edrvEditorFile，认领 dsh-resource://file/**）经 navigation.address
+		* 解码出真实路径并透传 params.line 行号定位。派发既有 edrv:open-editor 事件复用
+		* EditorView 打开流；按会话 key 保证切会话干净重建。
+		* Tab 正文切换后重挂载时按最新导航恢复打开（对齐 better-sidebar 形态的种子行为）。
+		* 作者 ddj 2026年09月09号
+		*/
+		/**
+		* 官方侧边栏 Tab 正文组件（keyed slot sidebar.right.pane.tab 装配）。
+		* @param props slot 框架注入（useTabInfo/sessionId）+ 装配依赖（schedule 等）
+		* @returns EditorView 侧栏形态
+		*/
+		function OfficialSideTab(props) {
+			const sessionId = props?.sessionId;
+			const useTabInfo = props?.useTabInfo;
+			let navigation;
+			if (typeof useTabInfo === "function") try {
+				navigation = useTabInfo()?.tab?.navigation;
+			} catch {
+				navigation = void 0;
+			}
+			const revision = typeof navigation?.revision === "number" ? navigation.revision : -1;
+			const revisionRef = react.default.useRef(-1);
+			react.default.useEffect(() => {
+				setSideEditorMounted(true);
+				return () => setSideEditorMounted(false);
+			}, []);
+			react.default.useEffect(() => {
+				if (revision === revisionRef.current) return;
+				revisionRef.current = revision;
+				if (revision <= 0) return;
+				const fileHit = parseOfficialFileAddress(navigation?.address);
+				if (fileHit) {
+					const line = navigation?.params?.line;
+					window.dispatchEvent(new CustomEvent("edrv:open-editor", { detail: {
+						path: fileHit.path,
+						line: typeof line === "number" ? line : void 0
+					} }));
+					return;
+				}
+				const request = resolveNavOpen(navigation?.params);
+				window.dispatchEvent(new CustomEvent("edrv:open-editor", { detail: {
+					path: request.path,
+					focusDiff: request.focusDiff
+				} }));
+			});
+			return react.default.createElement(EditorView, {
+				key: sessionId,
+				sessionId,
+				layout: "side",
+				schedule: props?.schedule,
+				addToConversation: props?.addToConversation,
+				sidebarPanels: props?.sidebarPanels,
+				outlineSources: props?.outlineSources,
+				fileMenuItems: props?.fileMenuItems,
+				sessions: props?.sessions
+			});
+		}
+		//#endregion
 		//#region src/client/sidebar/registry.ts
 		/** 校验面板定义并写入注册表（缺 id/render 抛 TypeError）。 */
 		function panelRegister(entries, notify, panel) {
@@ -11798,8 +12564,8 @@ window.__ModuleLoader__.load({
 		//#region src/client/index.ts
 		/**
 		* dsh-vscode-mode client — 浏览器半入口：slot 注册 + 装配。
-		* 挂点：betterSidebar「文件编辑」Tab（侧边栏形态，对话+编辑同屏；未装 dsh-better-sidebar 时
-		* 回退 conversation.view 中央页签）+ conversation.input.dock 差异条 + header 差异角标。
+		* 挂点：官方右侧 Sidebar「文件编辑」Tab（DSH 0.1.5+，对话+编辑同屏）> betterSidebar Tab
+		* （归档，仅旧版 DSH 回退）> conversation.view 中央页签 + conversation.input.dock 差异条 + header 差异角标。
 		* 与 Host 通信：同源 fetch('/edrv/rpc')（shared/rpc 契约）。
 		*
 		* ⚠️ 跨版本 slot 装配（2026-08-21）：新版 DSH 的 slots 系统要求 slot 必须由父 entry
@@ -11875,6 +12641,10 @@ window.__ModuleLoader__.load({
 			};
 			/** 可选探测 betterSidebar 服务（不进 inject：缺失会让插件停靠等待，杀死回退路径）。 */
 			let sideService = detectSidebarService(ctx);
+			/** 可选探测官方右侧 Sidebar（DSH 0.1.5-alpha.1+；探测命中 ≡ 版本判定，不进 inject 同上）。 */
+			let officialService = detectOfficial(ctx);
+			/** 官方 file 地址认领的当前注销器（null=未认领；由 syncFileClaim 依设置值切换）。 */
+			let claimDisposer = null;
 			/** 「添加到对话」动作集：编辑区/Tab 右键菜单注入文件引用与代码块（conversation 服务缺失时各动作安全降级）。 */
 			const addToConversation = createAddToConversation(ctx);
 			/** 客户端侧兼容摘要（与 host 报告合并展示；惰性求值保证 HMR 后仍新鲜）。 */
@@ -11900,9 +12670,19 @@ window.__ModuleLoader__.load({
 					note: registry.get("dsh-better-sidebar") !== void 0 ? "已注册（优先级 80）" : "未检测到侧边栏打开能力"
 				},
 				{
-					name: "侧边栏编辑区（dsh-better-sidebar）",
+					name: "侧边栏编辑区（官方 Sidebar）",
+					active: officialService !== void 0,
+					note: officialService !== void 0 ? "编辑区=官方右侧 Sidebar Tab（对话+编辑同屏，DSH 0.1.5+）" : "官方侧边栏服务未探测到（DSH < 0.1.5-alpha.1 时属预期）"
+				},
+				{
+					name: "侧边栏编辑区（dsh-better-sidebar，归档）",
 					active: sideService !== void 0,
-					note: sideService !== void 0 ? "编辑区=侧边栏 Tab（对话+编辑同屏）" : "未检测到；安装 dsh-better-sidebar 后刷新启用侧边栏形态（" + SIDEBAR_INSTALL_CMD + "）"
+					note: sideService !== void 0 ? "编辑区=侧边栏 Tab（旧版 DSH 回退形态）" : "未检测到；DSH ≥ 0.1.5 优先官方侧边栏，旧版可安装（" + SIDEBAR_INSTALL_CMD + "）"
+				},
+				{
+					name: "文件链接官方认领（dsh-resource://file）",
+					active: claimDisposer !== null,
+					note: claimDisposer !== null ? "聊天文件链接由本插件编辑器接管（官方侧边栏内打开）" : "链接走官方查看器或旧版路由（未认领）"
 				}
 			];
 			ctx.provide("fileOpeners", registry);
@@ -11930,12 +12710,39 @@ window.__ModuleLoader__.load({
 				const sidebar = scanSidebar(ctx);
 				return sidebar ? registry.register(sidebar) : void 0;
 			}, "vscode-mode: sidebar file opener");
+			const officialRenderTab = (props) => react.default.createElement(OfficialSideTab, Object.assign({}, props, {
+				schedule,
+				addToConversation,
+				sidebarPanels,
+				outlineSources,
+				fileMenuItems,
+				sessions
+			}));
+			/** 官方 file 地址认领同步：自动/VSCodeMode 档认领（链接进本插件编辑器），其余交官方查看器。 */
+			const syncFileClaim = () => {
+				const official = officialService;
+				const want = official !== void 0 && shouldClaimFiles(selected);
+				if (want && claimDisposer === null && official) {
+					const disposer = registerOfficialFileClaim({
+						tabs: official.tabs,
+						slots: ctx.slots,
+						renderTab: officialRenderTab
+					});
+					if (disposer !== null) claimDisposer = ctx.effect(() => disposer, "vscode-mode: official file claim");
+					return;
+				}
+				if (!want && claimDisposer !== null) {
+					claimDisposer();
+					claimDisposer = null;
+				}
+			};
 			ctx.effect(() => {
 				if (!settings) return void 0;
 				const sync = () => {
 					const snapshot = settings.getSnapshot();
 					if (snapshot.status === "loading") return;
 					selected = autoValue(snapshot.value?.fileOpenTool);
+					syncFileClaim();
 					window.dispatchEvent(new CustomEvent("edrv:file-open-tool-change", { detail: { value: selected } }));
 				};
 				sync();
@@ -12008,11 +12815,50 @@ window.__ModuleLoader__.load({
 					sessions
 				})));
 			};
+			let officialDisposer = null;
 			let sideDisposer = null;
 			let legacyDisposer = null;
+			const installOfficialForm = () => {
+				const official = officialService;
+				if (officialDisposer !== null || !official) return;
+				if (sideDisposer !== null) {
+					sideDisposer();
+					sideDisposer = null;
+				}
+				if (legacyDisposer !== null) {
+					legacyDisposer();
+					legacyDisposer = null;
+				}
+				const outcome = installOfficial({
+					tabs: official.tabs,
+					service: official.service,
+					slots: ctx.slots,
+					renderTab: officialRenderTab,
+					guide: {
+						title: () => OFFICIAL_TAB_TITLE,
+						description: () => "Monaco 文件编辑器：对话与编辑同屏（差异审查/跳转/大纲）"
+					}
+				});
+				if (outcome === null) {
+					officialService = void 0;
+					applySideForm();
+					return;
+				}
+				officialDisposer = ctx.effect(() => outcome, "vscode-mode: official sidebar editor tab");
+				if (typeof official.service.openResource === "function") ctx.effect(() => registry.register(officialSidebarOpener(official.service)), "vscode-mode: official sidebar opener");
+				syncFileClaim();
+			};
 			const applySideForm = () => {
+				if (officialService) {
+					installOfficialForm();
+					return;
+				}
 				if (sideService) {
 					if (sideDisposer !== null) return;
+					if (officialDisposer !== null) {
+						officialDisposer();
+						officialDisposer = null;
+					}
 					if (legacyDisposer !== null) {
 						legacyDisposer();
 						legacyDisposer = null;
@@ -12038,28 +12884,41 @@ window.__ModuleLoader__.load({
 						},
 						registerLegacyFallback: registerLegacyTab
 					}), "vscode-mode: sidebar editor tab");
-				} else {
-					if (legacyDisposer !== null) return;
-					if (sideDisposer !== null) {
-						sideDisposer();
-						sideDisposer = null;
-					}
-					setEnsureSideEditor(null);
-					legacyDisposer = registerLegacyTab();
+					return;
+				}
+				if (legacyDisposer !== null) return;
+				if (officialDisposer !== null) {
+					officialDisposer();
+					officialDisposer = null;
 				}
+				if (sideDisposer !== null) {
+					sideDisposer();
+					sideDisposer = null;
+				}
+				setEnsureSideEditor(null);
+				legacyDisposer = registerLegacyTab();
 			};
 			applySideForm();
 			let sideRetries = 0;
 			const retrySideService = () => {
-				if (sideService !== void 0 || sideRetries >= 15) return;
+				if (officialService !== void 0 || sideRetries >= 15) return;
 				sideRetries += 1;
 				schedule(() => {
-					if (sideService !== void 0) return;
-					sideService = detectSidebarService(ctx);
-					if (sideService !== void 0) {
-						log.info("检测到 dsh-better-sidebar，切换侧边栏编辑形态");
+					if (officialService !== void 0) return;
+					officialService = detectOfficial(ctx);
+					if (officialService !== void 0) {
+						log.info("检测到官方右侧 Sidebar（DSH 0.1.5+），切换官方侧边栏编辑形态");
 						applySideForm();
-					} else retrySideService();
+						return;
+					}
+					if (sideService === void 0) {
+						sideService = detectSidebarService(ctx);
+						if (sideService !== void 0) {
+							log.info("检测到 dsh-better-sidebar，切换侧边栏编辑形态（官方未探测到，后续仍优先官方）");
+							applySideForm();
+						}
+					}
+					retrySideService();
 				}, 2e3);
 			};
 			retrySideService();