dsh-vscode-mode 0.16.0 → 0.17.0

package/README.md

@@ -460,25 +460,28 @@ DSH 每次启动监听随机端口，`http://127.0.0.1:<port>` 就是浏览器 o
 
 官方 `dsh plugin` 方式，三选一。下面以 `web` profile 为例；Desktop 或其他命名
 profile 请替换为实际目标，不要把示例目录当成当前运行 profile。升级前可阅读
-[0.16.0 发布说明](docs/release-0.16.0.md)；从 0.14.2 或更旧版本升级还须阅读
+[0.17.0 发布说明](docs/release-0.17.0.md)；从 0.14.2 或更旧版本升级还须阅读
 [0.14.3 数据迁移与回退说明](docs/release-0.14.3.md)。
 
 ```bash
 # ① Git 安装（clone + prepare 构建；推荐打固定 tag）
-dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.16.0
+dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.17.0
 
 # ② npm 注册表（发布到 npm 后）
-dsh plugin --profile web add dsh-vscode-mode@0.16.0
+dsh plugin --profile web add dsh-vscode-mode@0.17.0
 
 # ③ GitHub Release tgz 直装（Release asset 可用后）
-dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.16.0/dsh-vscode-mode-0.16.0.tgz
+dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.17.0/dsh-vscode-mode-0.17.0.tgz
 ```
 
-> **DSH 版本政策（0.14.10 起）**：六项 DSH peer 统一声明为 `*`，不再维护逐版
-> 白名单或版本上界。DSH 的 `includePrerelease` 检查接受 alpha、rc 与正式版；
-> npm 默认 semver 的 `*` 仍排除预发布版本，可能产生 peer 不匹配提示。
-> 运行时按实际能力检查，不再仅因版本较新告警；允许安装不代表未来版本已通过
-> 全功能验收。已发布包仍以其实际声明为准；npm 安装前应确认注册表中版本可查询。
+> **DSH 版本政策（0.17.0 起）**：六项 DSH peer 仍统一声明为 `*`，另以
+> `engines.dsh: ">=0.1.0-rc.1 <0.3.0-0"` 显式声明支持的 DSH 运行时区间——
+> `engines.dsh` 一旦声明就**单独决定**兼容性（官方实现：`An own engines.dsh range
+> decides alone and peerDependencies are ignored`），不满足时安装会被直接拒绝。
+> 该区间接受 0.1.0-rc.1 起的全部 0.1.x / 0.2.x，拒绝 0.3.0 及以后的主版本；
+> DSH 自身以 `includePrerelease` 求值，故 alpha、rc 与正式版同等对待。
+> 运行时仍按实际能力检查；允许安装不代表该版本已通过全功能验收。
+> 已发布包仍以其实际声明为准；npm 安装前应确认注册表中版本可查询。
 > 替换已有包后需重启目标 DSH Host 并强制刷新原页面；仅刷新不会更新 Host。
 > 从 0.14.2 或更旧版本升级时，首次访问工作区会执行 0.14.3 引入的 SQLite 活跃记录迁移。
 >
@@ -809,6 +812,7 @@ Keep All / Undo All 却是亮的。修复：单文件 Keep / Undo 覆盖冲突
 完整变更见 [GitHub Releases](https://github.com/Lenonss/DSH_VsCodeMode/releases)。
 近期关键版本：
 
+- **v0.17.0**：**DSH 0.2.1 吸收与运行期优化**——① 修复插件元数据一直失效：`locale/*.json` 改 `{"meta":{...}}` 结构并导出 `./locale/*.json`，插件管理器标题与描述不再回退 `package.json.name`；② 新增 `engines.dsh: ">=0.1.0-rc.1 <0.3.0-0"` 显式声明支持区间（此前仅靠官方 `includePrerelease` 宽容）；③ 跟随会话内 `cd`：13 处 `header.cwd` 直读改走 `workingDirectory` 投影，服务缺失/抛错时回落原始目录；④ 轮询收敛：差异角标 / 输入区 dock / 编辑器 / 体积角标原本各自 5s 拉一次 `edrv.list`，改为会话级共享订阅（单轮询 + 退订到 0 才释放）；⑤ 界面壳层接入 `ctx.locale` 中英双语（slot 名与官方页签标题随语言切换）；⑥ 新增插件管理器详情页「VSCodeMode」状态段。详见 [0.17.0 发布说明](docs/release-0.17.0.md)。
 - **v0.16.0**：**C# 智能体体验增强**——C# provider DotRush 优先于 ms-Roslyn（自带 sln 加载与反编译跳转；Roslyn 无 C# Dev Kit 时不加载项目）；csharp 握手后自动找工作区根 `.sln` 发 Roslyn 专有 `solution/open`，元数据符号（Unity 引擎/NuGet 程序集）可跳转与 hover；DAP 调试支持 `runtime='dotnet'` 适配器（DotRush monodbg 形态），按 dll runtimeconfig 要求的运行时大版本选择 dotnet。
 - **v0.15.9**：**插件自我更新与可用更新提醒**——设置页「文件与安装」新增更新行：显示当前版本，一键检查 npm 上的最新版本，发现新版后可确认执行自我更新（host 端先卸载再安装插件包，安装失败自动恢复 profile package.json/pnpm-lock.yaml，更新期间页面会短暂断开）。客户端启动后延迟探测新版本，发现可用更新时弹 toast 提醒（每个版本只提醒一次），devForm 开发形态不提醒。详见 [0.15.9 发布说明](docs/release-0.15.9.md)。
 - **v0.15.8**：**跨端「会话不存在」兼容**——桌面端与 Web 端各自运行独立 DSH 实例、会话列表互通但会话仅在一端激活时，另一端文件编辑器不再卡在「文件加载失败：会话不存在 0%」：中央区显示「会话在当前端不可用」终态提示（说明成因、保留重试），资源管理器红条同样替换为友好文案。host 三处会话前置错误文案收敛为 shared 常量，client 按常量识别归类。详见 [0.15.8 发布说明](docs/release-0.15.8.md)。

package/lib/client.js

@@ -3019,6 +3019,167 @@ window.__ModuleLoader__.load({
 			} catch (e) {}
 		}
 		//#endregion
+		//#region src/client/state/recordsFeed.ts
+		/** 兜底轮询周期（毫秒）：仅作事件丢失时的兜底，正常由 edrv:refresh 驱动。 */
+		const FEED_INTERVAL_MS = 5e3;
+		const feeds = /* @__PURE__ */ new Map();
+		/** 取全局 window（Node 测试环境无 window）。 */
+		function win() {
+			return typeof window === "undefined" ? void 0 : window;
+		}
+		/**
+		* 取或建会话订阅槽位。
+		* @author ddj 2026年10月19号
+		* @param sessionId 会话 id
+		* @returns 订阅槽位
+		*/
+		function entryOf(sessionId) {
+			let entry = feeds.get(sessionId);
+			if (!entry) {
+				entry = {
+					records: null,
+					listeners: /* @__PURE__ */ new Set(),
+					tickers: /* @__PURE__ */ new Set(),
+					errorListeners: /* @__PURE__ */ new Set(),
+					timer: null,
+					onRefresh: null,
+					seq: 0,
+					inflight: false
+				};
+				feeds.set(sessionId, entry);
+			}
+			return entry;
+		}
+		/**
+		* 把最新记录分发给订阅者（快照相等时也分发，交由消费方自行比对）。
+		* @author ddj 2026年10月19号
+		* @param entry 订阅槽位
+		*/
+		function notifyRecords(entry) {
+			const snapshot = entry.records;
+			if (!snapshot) return;
+			for (const listener of Array.from(entry.listeners)) try {
+				listener(snapshot);
+			} catch {}
+		}
+		/**
+		* 拉取一次该会话的差异记录。
+		* @author ddj 2026年10月19号
+		* @param sessionId 会话 id
+		* @param skipStale 是否跳过过期判定（与 edrv.list 参数同名同义）
+		* @returns 拉取完成 Promise
+		*/
+		function refreshFeed(sessionId, skipStale = false) {
+			const entry = entryOf(sessionId);
+			const current = ++entry.seq;
+			entry.inflight = true;
+			const payload = { sessionId };
+			if (skipStale) payload.skipStale = true;
+			return rpc("edrv.list", payload).then((res) => {
+				if (current !== entry.seq) return;
+				if (!res || !res.ok || !Array.isArray(res.records)) return;
+				entry.records = res.records;
+				notifyRecords(entry);
+			}).catch((e) => {
+				if (current !== entry.seq) return;
+				const message = String(e);
+				for (const listener of Array.from(entry.errorListeners)) try {
+					listener(message);
+				} catch {}
+			}).finally(() => {
+				if (current === entry.seq) entry.inflight = false;
+			});
+		}
+		/**
+		* 确保该会话的定时器与 refresh 事件监听已就绪（首个订阅者到来时启动）。
+		* @author ddj 2026年10月19号
+		* @param sessionId 会话 id
+		* @param entry 订阅槽位
+		*/
+		function ensureTimer$1(sessionId, entry) {
+			if (entry.timer === null) entry.timer = setInterval(() => {
+				const tickers = Array.from(entry.tickers);
+				for (const tick of tickers) try {
+					tick();
+				} catch {}
+				if (entry.listeners.size > 0 || entry.errorListeners.size > 0) refreshFeed(sessionId);
+			}, FEED_INTERVAL_MS);
+			if (entry.onRefresh === null) {
+				const handler = () => {
+					refreshFeed(sessionId);
+				};
+				const target = win();
+				if (target) target.addEventListener("edrv:refresh", handler);
+				entry.onRefresh = handler;
+			}
+		}
+		/**
+		* 会话无任何订阅者时释放定时器、事件监听与缓存快照。
+		* @author ddj 2026年10月19号
+		* @param sessionId 会话 id
+		* @param entry 订阅槽位
+		*/
+		function releaseIfIdle(sessionId, entry) {
+			if (entry.listeners.size || entry.tickers.size || entry.errorListeners.size) return;
+			if (entry.timer !== null) clearInterval(entry.timer);
+			if (entry.onRefresh !== null) {
+				const target = win();
+				if (target) target.removeEventListener("edrv:refresh", entry.onRefresh);
+			}
+			feeds.delete(sessionId);
+		}
+		/**
+		* 订阅会话的差异记录。
+		* 首个订阅者触发一次立即拉取；同会话多订阅者共享一次 RPC。
+		* @author ddj 2026年10月19号
+		* @param sessionId 会话 id
+		* @param listener 记录变化回调
+		* @returns 取消订阅函数
+		*/
+		function subscribeRecords(sessionId, listener) {
+			const entry = entryOf(sessionId);
+			entry.listeners.add(listener);
+			ensureTimer$1(sessionId, entry);
+			if (entry.records) listener(entry.records);
+			else if (!entry.inflight) refreshFeed(sessionId);
+			return () => {
+				entry.listeners.delete(listener);
+				releaseIfIdle(sessionId, entry);
+			};
+		}
+		/**
+		* 订阅会话的周期心跳（复用同一定时器，不额外制造定时器）。
+		* @author ddj 2026年10月19号
+		* @param sessionId 会话 id
+		* @param listener 心跳回调
+		* @returns 取消订阅函数
+		*/
+		function subscribeTick(sessionId, listener) {
+			const entry = entryOf(sessionId);
+			entry.tickers.add(listener);
+			ensureTimer$1(sessionId, entry);
+			return () => {
+				entry.tickers.delete(listener);
+				releaseIfIdle(sessionId, entry);
+			};
+		}
+		/**
+		* 订阅会话记录拉取失败（错误提示用；同样复用该会话的共享通道）。
+		* @author ddj 2026年10月19号
+		* @param sessionId 会话 id
+		* @param listener 失败回调，参数为已字符串化的错误
+		* @returns 取消订阅函数
+		*/
+		function subscribeErrors(sessionId, listener) {
+			const entry = entryOf(sessionId);
+			entry.errorListeners.add(listener);
+			ensureTimer$1(sessionId, entry);
+			return () => {
+				entry.errorListeners.delete(listener);
+				releaseIfIdle(sessionId, entry);
+			};
+		}
+		//#endregion
 		//#region src/client/monaco/theme.ts
 		/**
 		* dsh-vscode-mode client — Monaco 主题：官方令牌跟随 + 现役双套回落。
@@ -17816,6 +17977,7 @@ window.__ModuleLoader__.load({
 		*/
 		function installOfficial(options) {
 			const { tabs, service, slots, renderTab, guide } = options;
+			const titleOf = typeof options.title === "function" ? options.title : () => OFFICIAL_TAB_TITLE;
 			const open = (path, focusDiff) => {
 				try {
 					service.openTab(OFFICIAL_TAB_KIND, { params: {
@@ -17834,7 +17996,7 @@ window.__ModuleLoader__.load({
 					id: OFFICIAL_TAB_ID,
 					kind: OFFICIAL_TAB_KIND,
 					priority: "extension",
-					title: () => OFFICIAL_TAB_TITLE,
+					title: () => titleOf(),
 					guide: [{
 						order: 20,
 						title: guide.title,
@@ -20392,7 +20554,7 @@ window.__ModuleLoader__.load({
 		* @param state 任务快照
 		* @returns 可读的状态行
 		*/
-		function countText(state) {
+		function countText$1(state) {
 			if (!state) return "等待 SVN 任务…";
 			const c = state.counts;
 			return "合并 " + c.G + "  ·  新增 " + c.A + "  ·  删除 " + c.D + "  ·  更新 " + c.U + "  ·  冲突 " + c.C + (c.R || c.E ? "  ·  其他 " + (c.R + c.E) : "");
@@ -20792,7 +20954,7 @@ window.__ModuleLoader__.load({
 		*/
 		function updateFoot(props, state, closable, finished, cancel, dismiss, confirmClose, cleaned, cleanup, remaining, jump, refresh) {
 			const locked = updateLocked(state);
-			return react.default.createElement("footer", { className: "edrv-update-foot" }, react.default.createElement("span", { className: "edrv-update-counts" }, countText(state)), remaining > 0 ? react.default.createElement("button", {
+			return react.default.createElement("footer", { className: "edrv-update-foot" }, react.default.createElement("span", { className: "edrv-update-counts" }, countText$1(state)), remaining > 0 ? react.default.createElement("button", {
 				type: "button",
 				className: "edrv-svn-act edrv-update-jump",
 				onClick: jump
@@ -22875,31 +23037,36 @@ window.__ModuleLoader__.load({
 				}
 				return true;
 			};
+			/**
+			* 把共享订阅拿到的记录落进组件状态（内容一致时保持引用不变，避免整树重渲染）。
+			* @private @author ddj 2026年10月19号
+			* @param list 差异记录数组
+			*/
+			const applyRecords = (list) => {
+				const trace = isDebug();
+				const compareStart = trace ? performance.now() : 0;
+				const map = {};
+				for (const r of list) {
+					if (r.archived === true) continue;
+					map[r.callId] = r;
+				}
+				setRecords((prev) => {
+					const equal = sameRecords(prev, map);
+					if (trace) try {
+						const compareMs = performance.now() - compareStart;
+						if (compareMs > 20) dbg(sessionId, `[DEBUG diffList] count=${list.length} compareMs=${compareMs.toFixed(1)} changed=${!equal}`);
+					} catch (e) {}
+					return equal ? prev : map;
+				});
+			};
+			/**
+			* 主动刷新一次差异记录（走会话级共享通道，同会话多消费方共享一次 RPC）。
+			* @private @author ddj 2026年10月19号
+			* @param skipStale 是否跳过过期判定
+			*/
 			const refreshRecords = (skipStale) => {
 				if (!sessionId) return;
-				const trace = isDebug();
-				const start = trace ? performance.now() : 0;
-				rpc("edrv.list", {
-					sessionId,
-					...skipStale ? { skipStale: true } : {}
-				}).then((res) => {
-					const received = trace ? performance.now() : 0;
-					if (!res || !res.ok || !Array.isArray(res.records)) return;
-					const map = {};
-					for (const r of res.records) {
-						if (r.archived === true) continue;
-						map[r.callId] = r;
-					}
-					setRecords((prev) => {
-						const compareStart = trace ? performance.now() : 0;
-						const equal = sameRecords(prev, map);
-						if (trace) try {
-							const compareMs = performance.now() - compareStart;
-							if (compareMs > 20 || received - start > 100) dbg(sessionId, `[DEBUG diffList] count=${res.records.length} skipStale=${skipStale === true} rpcMs=${(received - start).toFixed(1)} compareMs=${compareMs.toFixed(1)} changed=${!equal}`);
-						} catch (e) {}
-						return equal ? prev : map;
-					});
-				}).catch((e) => setError("list异常:" + String(e)));
+				refreshFeed(sessionId, skipStale === true);
 			};
 			/**
 			* Reject callbacks for a replaced file or loader generation.
@@ -23224,14 +23391,13 @@ window.__ModuleLoader__.load({
 				});
 			};
 			react.default.useEffect(() => {
-				if (!sessionId) return;
+				if (!sessionId) return void 0;
+				const offRecords = subscribeRecords(sessionId, applyRecords);
+				const offErrors = subscribeErrors(sessionId, (message) => setError("list异常:" + message));
 				refreshRecords();
-				const t = setInterval(refreshRecords, 5e3);
-				const onRefresh = () => refreshRecords();
-				window.addEventListener("edrv:refresh", onRefresh);
 				return () => {
-					clearInterval(t);
-					window.removeEventListener("edrv:refresh", onRefresh);
+					offRecords();
+					offErrors();
 				};
 			}, [sessionId]);
 			/**
@@ -27313,34 +27479,24 @@ window.__ModuleLoader__.load({
 		//#region src/client/ui/DiffBadge.ts
 		/**
 		* dsh-vscode-mode client — DiffBadge：header 差异角标（仅工作区有差异时显示）。
-		* 迁移自原 src/client/index.ts 的 DiffBadge，语义不改。
+		* 轮询已收敛到 state/recordsFeed.ts 的会话级共享订阅，本组件不再自建定时器。
 		* 作者 ddj 2026-08-20
 		*/
 		/**
-		* 会话 header 差异角标：5s 轮询 edrv.list，有差异时显示数字徽章，点击打开编辑区并拉起 DiffLauncher。
+		* 会话 header 差异角标：订阅会话差异记录，有差异时显示数字徽章，点击打开编辑区并拉起 DiffLauncher。
 		*/
 		function DiffBadge(props) {
 			const sessionId = props?.sessionId;
 			const [summary, setSummary] = react.default.useState(null);
-			const seq = react.default.useRef(0);
-			const load = react.default.useCallback(() => {
-				if (!sessionId) return;
-				const s = ++seq.current;
-				rpc("edrv.list", { sessionId }).then((res) => {
-					if (s !== seq.current || !res || !res.ok || !Array.isArray(res.records)) return;
-					setSummary(summarize(res.records));
-				}).catch(() => {});
-			}, [sessionId]);
 			react.default.useEffect(() => {
-				load();
-				const t = setInterval(load, 5e3);
-				const onRefresh = () => load();
-				window.addEventListener("edrv:refresh", onRefresh);
-				return () => {
-					clearInterval(t);
-					window.removeEventListener("edrv:refresh", onRefresh);
-				};
-			}, [load]);
+				if (!sessionId) {
+					setSummary(null);
+					return;
+				}
+				return subscribeRecords(sessionId, (records) => {
+					setSummary(summarize(records));
+				});
+			}, [sessionId]);
 			const n = summary?.totalFiles ?? 0;
 			if (!n) return null;
 			const click = () => {
@@ -27394,7 +27550,8 @@ window.__ModuleLoader__.load({
 		//#region src/client/ui/PerfSizeBadge.ts
 		/**
 		* dsh-vscode-mode client — PerfSizeBadge：对话 header 会话体积指示器。
-		* 5s 轮询当前会话持久化体积（host 仅 stat，近零成本），≥1MB 显示、超阈值变色，
+		* 定时器复用 state/recordsFeed.ts 的会话级心跳（单会话只保留 1 个定时器），
+		* 轮询当前会话持久化体积（host 仅 stat，近零成本），≥1MB 显示、超阈值变色，
 		* 引导"一次任务一个短会话"：会话过大时建议 /compact 或新开会话。
 		* 作者 ddj 2026-09-02
 		*/
@@ -27428,12 +27585,10 @@ window.__ModuleLoader__.load({
 				}).catch(() => {});
 			}, [sessionId, sessions]);
 			react.default.useEffect(() => {
+				if (!sessionId) return void 0;
 				load();
-				const t = setInterval(load, 5e3);
-				return () => {
-					clearInterval(t);
-				};
-			}, [load]);
+				return subscribeTick(sessionId, load);
+			}, [load, sessionId]);
 			if (!size || size < SHOW_MIN) return null;
 			const label = size >= 1048576 ? (size / 1048576).toFixed(1) + "MB" : Math.round(size / 1024) + "KB";
 			const color = size >= HARD ? "#dc2626" : size >= SOFT ? "#d97706" : "var(--dsw-text-3,#6b7280)";
@@ -27460,6 +27615,7 @@ window.__ModuleLoader__.load({
 		/**
 		* dsh-vscode-mode client — 会话级差异 dock。
 		* conversation.input.dock 是唯一实例：普通对话显示摘要，文件编辑页显示完整操作条。
+		* 轮询已收敛到 state/recordsFeed.ts 的会话级共享订阅，本组件不再自建定时器。
 		* 作者 ddj 2026-08-26
 		*/
 		const nextIndexBySession = /* @__PURE__ */ new Map();
@@ -27473,25 +27629,15 @@ window.__ModuleLoader__.load({
 			const sessionId = props?.sessionId;
 			const [summary, setSummary] = react.default.useState(null);
 			const [, setStoreRevision] = react.default.useState(0);
-			const seq = react.default.useRef(0);
-			const load = react.default.useCallback(() => {
-				if (!sessionId) return;
-				const current = ++seq.current;
-				rpc("edrv.list", { sessionId }).then((res) => {
-					if (current !== seq.current || !res || !res.ok || !Array.isArray(res.records)) return;
-					setSummary(summarize(res.records));
-				}).catch(() => {});
-			}, [sessionId]);
 			react.default.useEffect(() => {
-				load();
-				const timer = setInterval(load, 5e3);
-				const onRefresh = () => load();
-				window.addEventListener("edrv:refresh", onRefresh);
-				return () => {
-					clearInterval(timer);
-					window.removeEventListener("edrv:refresh", onRefresh);
-				};
-			}, [load]);
+				if (!sessionId) {
+					setSummary(null);
+					return;
+				}
+				return subscribeRecords(sessionId, (records) => {
+					setSummary(summarize(records));
+				});
+			}, [sessionId]);
 			react.default.useEffect(() => {
 				if (!sessionId) return void 0;
 				const sync = () => setStoreRevision((value) => value + 1);
@@ -30584,6 +30730,73 @@ window.__ModuleLoader__.load({
 			}, "保存配置"))));
 		}
 		//#endregion
+		//#region src/client/ui/PluginDetailSection.ts
+		/**
+		* dsh-vscode-mode client — 官方插件管理器详情页的只读状态段。
+		* 挂在 DSH 0.2.1 新增的 `plugins.detail.section`（list / root）扩展位上，
+		* 只在「本插件自己」的详情页渲染，其余插件页返回 null。
+		* 作者 ddj 2026年10月19号
+		*/
+		/** 本插件标识（与 package.json name / bundle 行 id 一致）。 */
+		const SELF_ID = "dsh-vscode-mode";
+		/**
+		* 判断详情页 subject 是否指向本插件。
+		* 官方有两种形状：官方内置项 `{kind:'item', id}`、安装包 `{kind:'bundle', pkg:{name}}`。
+		* @author ddj 2026年10月19号
+		* @param subject 详情页主题
+		* @returns 是否为本插件
+		*/
+		function isSelfSubject(subject) {
+			if (!subject || typeof subject !== "object") return false;
+			if (subject.kind === "item") return subject.id === SELF_ID;
+			if (subject.kind === "bundle") return subject.pkg?.name === SELF_ID;
+			return false;
+		}
+		/**
+		* 把适配项列表压成「正常 / 未生效」计数文案。
+		* @author ddj 2026年10月19号
+		* @param list 适配项数组
+		* @returns 计数文案
+		*/
+		function countText(list) {
+			const items = Array.isArray(list) ? list : [];
+			return items.filter((item) => item?.active === true).length + " / " + items.length + " 项生效";
+		}
+		/**
+		* 插件详情页的只读状态段。
+		* @author ddj 2026年10月19号
+		* @param props DSH 注入的 { subject }
+		* @returns 状态段元素或 null（非本插件页）
+		*/
+		function PluginDetailSection(props) {
+			const subject = props?.subject;
+			const isSelf = isSelfSubject(subject);
+			const [report, setReport] = react.default.useState(null);
+			react.default.useEffect(() => {
+				if (!isSelf) return void 0;
+				let alive = true;
+				rpc("compat", {}).then((result) => {
+					if (!alive || !result || !result.ok) return;
+					setReport(result.report ?? null);
+				}).catch(() => {});
+				return () => {
+					alive = false;
+				};
+			}, [isSelf]);
+			if (!isSelf) return null;
+			const row = (name, note) => react.default.createElement("div", {
+				key: name,
+				className: "vsm-compat-item ok"
+			}, react.default.createElement("span", { className: "vsm-compat-name" }, name), react.default.createElement("span", { className: "vsm-compat-note" }, note));
+			const versionText = report?.dshVersion ? "DSH " + report.dshVersion : "未探测到 DSH 版本";
+			const pluginText = report?.pluginVersion ? "插件 " + report.pluginVersion : "插件版本未上报";
+			const warnCount = Array.isArray(report?.warnings) ? report.warnings.length : 0;
+			return react.default.createElement("section", {
+				className: "vsm-panel",
+				"data-edrv-plugin-status": "1"
+			}, react.default.createElement("h3", { className: "vsm-panel-title" }, "VSCodeMode 运行状态"), react.default.createElement("div", { className: "vsm-panel-body" }, row("版本", versionText + " · " + pluginText), row("版本适配", countText(report?.adapters)), row("外部插件与服务", countText(report?.external)), row("护栏", countText(report?.guards)), row("兼容性警告", warnCount ? warnCount + " 条（设置页「兼容性」可查看详情）" : "未检测到")));
+		}
+		//#endregion
 		//#region src/client/openPathRouter.ts
 		/**
 		* dsh-vscode-mode client — DSH 对话文件链接的统一打开路由。
@@ -37914,6 +38127,78 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/localeClient.ts
+		/**
+		* dsh-vscode-mode client — UI 壳层文案的 locale 接入。
+		* 此前 `locale` 写在 inject 里却零调用，界面文案全为硬编码中文；
+		* 这里只覆盖壳层（slot label、编辑 Tab 标题、侧栏引导），编辑器内部大段文案不动。
+		* 所有对外函数都对 locale 服务做可选探测：旧版 DSH 无该服务时回落中文词典。
+		* 作者 ddj 2026年10月19号
+		*/
+		/** locale 命名空间（与包名一致，避免与其他插件串词条）。 */
+		const LOCALE_NS = "dsh-vscode-mode";
+		/** 壳层文案词典（键名即 slot label / Tab 标题的稳定标识）。 */
+		const LOCALE_DICTS = {
+			zh: {
+				"slot.fileEditor": "文件编辑",
+				"slot.diff": "差异",
+				"slot.sessionSize": "会话体积",
+				"slot.settings": "VSCodeMode",
+				"guide.title": "文件编辑",
+				"guide.description": "Monaco 文件编辑器：对话与编辑同屏（差异审查/跳转/大纲）"
+			},
+			en: {
+				"slot.fileEditor": "File editor",
+				"slot.diff": "Diff",
+				"slot.sessionSize": "Session size",
+				"slot.settings": "VSCodeMode",
+				"guide.title": "File editor",
+				"guide.description": "Monaco file editor: chat and editing side by side (diff review, jump, outline)"
+			}
+		};
+		/**
+		* 取词条：先当前语言、再中文、最后键本身。
+		* @author ddj 2026年10月19号
+		* @param lang 语言 id
+		* @param key 词条键
+		* @returns 文案
+		*/
+		function lookup(lang, key) {
+			return LOCALE_DICTS[lang]?.[key] ?? LOCALE_DICTS["zh"]?.[key] ?? key;
+		}
+		/**
+		* 生成不依赖 locale 服务的直读翻译函数（服务缺失/注册失败时使用）。
+		* @author ddj 2026年10月19号
+		* @param lang 语言 id
+		* @returns 翻译函数
+		*/
+		function directTranslate(lang = "zh") {
+			return (key) => lookup(lang, key);
+		}
+		/**
+		* 注册本插件词典并返回翻译函数。
+		* 服务缺失、重复注册或 bind 抛错都不影响插件其余部分：一律回落直读词典。
+		* @author ddj 2026年10月19号
+		* @param ctx DSH 客户端上下文
+		* @returns 翻译函数（读取时才解析当前语言，可直接放进 slot label thunk）
+		*/
+		function installLocale(ctx) {
+			let service;
+			try {
+				service = ctx.get("locale");
+			} catch {}
+			try {
+				if (service && typeof service.register === "function") service.register(LOCALE_NS, LOCALE_DICTS);
+			} catch {}
+			try {
+				if (service && typeof service.bind === "function") {
+					const bound = service.bind(LOCALE_NS);
+					if (typeof bound === "function") return (key) => bound(key);
+				}
+			} catch {}
+			return directTranslate();
+		}
+		//#endregion
 		//#region src/client/planBridge.ts
 		/** Optional DSH plan integration; no provider or approval UI replacement. @author ddj 2026年10月08号 */
 		const CLAIM_ID = "dsh-vscode-mode/plan";
@@ -38155,7 +38440,7 @@ window.__ModuleLoader__.load({
 				clearPlanState();
 			};
 		}
-		createLogger();
+		createLogger().child("debug");
 		//#endregion
 		//#region src/client/updateNotice.ts
 		/**
@@ -38284,6 +38569,7 @@ window.__ModuleLoader__.load({
 		*/
 		async function apply(ctx) {
 			const schedule = (fn, ms) => ctx.timeout(fn, ms);
+			const t = installLocale(ctx);
 			/**
 			* 无门控上报界面状态镜像事件（绕过客户端 edrv.debug 开关，直接落 host 诊断日志）。
 			* 开关关闭时 dbg 直接 return，「重启后没恢复」这类问题会在客户端侧彻底无痕，故另开一条通路。
@@ -38637,7 +38923,7 @@ window.__ModuleLoader__.load({
 					name: "conversation.view",
 					id: "edrv-editor",
 					order: 5,
-					label: "文件编辑",
+					label: () => t("slot.fileEditor"),
 					inject: (sessionId) => ({ sessionId })
 				}, (props) => react.default.createElement(EditorView, Object.assign({}, props, {
 					layout: "tab",
@@ -38670,9 +38956,10 @@ window.__ModuleLoader__.load({
 					service: official.service,
 					slots: ctx.slots,
 					renderTab: officialRenderTab,
+					title: () => t("slot.fileEditor"),
 					guide: {
-						title: () => OFFICIAL_TAB_TITLE,
-						description: () => "Monaco 文件编辑器：对话与编辑同屏（差异审查/跳转/大纲）"
+						title: () => t("guide.title"),
+						description: () => t("guide.description")
 					}
 				});
 				if (outcome === null) {
@@ -38786,31 +39073,36 @@ window.__ModuleLoader__.load({
 				name: "conversation.input.dock",
 				id: "edrv-diff-dock",
 				order: 30,
-				label: "差异",
+				label: () => t("slot.diff"),
 				inject: (sessionId) => ({ sessionId })
 			}, (props) => react.default.createElement(ConversationDiffDock, Object.assign({}, props)));
 			registerSlotSafely(ctx, {
 				name: "conversation.session.header.utilities",
 				id: "edrv-diff-badge",
 				order: 90,
-				label: "差异"
+				label: () => t("slot.diff")
 			}, (props) => react.default.createElement(DiffBadge, Object.assign({}, props)));
 			registerSlotSafely(ctx, {
 				name: "conversation.session.header.utilities",
 				id: "edrv-perf-size",
 				order: 89,
-				label: "会话体积"
+				label: () => t("slot.sessionSize")
 			}, (props) => react.default.createElement(PerfSizeBadge, Object.assign({}, props, { sessions })));
 			registerSlotSafely(ctx, {
 				name: "settings.section",
 				id: "vscode-mode",
 				order: 30,
-				label: "VSCodeMode"
+				label: () => t("slot.settings")
 			}, () => react.default.createElement(SettingsContext.Provider, { value: bridge.scope() }, react.default.createElement(McpSettings, {
 				openerRegistry: registry,
 				compatSummary,
 				getShortcuts: () => detectShortcuts(ctx)
 			})));
+			registerSlotSafely(ctx, {
+				name: "plugins.detail.section",
+				id: "edrv-plugin-status",
+				order: 40
+			}, (props) => react.default.createElement(PluginDetailSection, Object.assign({}, props)));
 			ctx.effect(() => () => {
 				try {
 					disposeSnippets();