dsh-vscode-mode 0.1.14 → 0.1.16

package/README.md

@@ -84,25 +84,35 @@ npm pack              # 产物 tgz（含 lib/assets/src/cordis.patch.yml）
 
 ```
 src/
-├── index.ts            Host 入口：name/inject/apply（薄装配）
+├── index.ts            Host 入口：name/inject/apply（薄装配，含兼容性报告启动日志）
 ├── shared/             ★ 双面契约（禁 node/react）：types.ts（记录/归档/摘要）+ rpc.ts（11 个方法类型化）
+│                       + compat.ts（兼容性报告形状）+ mcp.ts（MCP 契约）
+├── compat.ts           ★ Host 兼容层：身份常量、外部插件探测、路由/重复装配护栏、依赖守卫、兼容性报告
 ├── model.ts            Host 纯域逻辑（可单测）：normalize/markDecision/resolved/summary/reconstruct/批次/归档
 ├── store.ts            Host 存储层：sidecar 读写合并 + 归档持久化 + stale 检测
 ├── workspace.ts        Host 工作区文件扫描（TTL 缓存）+ 快速打开搜索
 ├── revert.ts           Host 回滚/删除（fs + subprocess，fs.contains 边界校验）
 ├── registry.ts         Host 每工作区记录桶注册表
-├── rpc.ts              Host RPC 分发表（类型化 handler 表替代巨型 switch）
-├── routes.ts           Host webServer 路由（/edrv/rpc、/edrv/assets/*、/edrv/vendor/*）
+├── rpc.ts              Host RPC 分发表（类型化 handler 表替代巨型 switch，含 compat）
+├── routes.ts           Host webServer 路由（/edrv/rpc、/edrv/assets/*、/edrv/vendor/*，带冲突护栏）
 └── client/
     ├── index.ts        Client 入口：slot 注册（inject=['slots','timer']）
+    ├── compat.ts       ★ Client 兼容层：设置桥三级降级（webUiSettings→settingsScope）、slot 安全注册、openPath 链式补丁、外部插件常量
     ├── rpc.ts          Client 类型化 fetch 包装 + 诊断日志
     ├── events.ts       窗口事件助手（edrv:refresh/open-editor/show-launcher）
     ├── state/          records.ts（摘要/计数/空差异）+ regions.ts（差异区域/行裁剪）纯函数
     ├── monaco/         loader.ts（AMD 加载/语言映射）+ diffRender.ts（差异自绘渲染器）
     ├── styles/editor.css  编辑区样式（tsdown CSS-inline 注入）
     └── ui/             EditorView（编排）/ QuickOpen / DiffBox / DiffBarEmpty / DiffLauncher / DiffBadge
+                        / McpSettings（含「兼容性」子 Tab）
 ```
 
+**兼容层（`src/compat.ts` + `src/client/compat.ts`）**：集中处理与其他插件 / DSH 版本的适配——
+运行时探测 `@deepseek-ai/dsh-mcp-client`、设置桥（`webUiSettings` → `settingsScope`）等外部依赖，
+护栏检测 `/edrv` 路由前缀冲突与本插件重复装配（duplicate loader entry），
+`@deepseek-ai/dsh-settings` / `schemastery` 以动态加载引入（缺失时插件仍可加载，设置持久化降级）。
+「VSCodeMode」设置页 →「兼容性」子 Tab 或 RPC `edrv.compat` 可查看完整报告。
+
 **扩展缝（VSCode 化后续迭代）**：新能力 = `shared/rpc.ts` 加方法 + `src/rpc.ts` 加 handler +
 `client/ui/` 加组件，其余模块零改动；`monaco/*` 是可复用的编辑器服务（资源树/对比/诊断面板共用）。
 

package/lib/client.js

@@ -1347,7 +1347,7 @@ window.__ModuleLoader__.load({
 			if (!diffRendererRef.current) diffRendererRef.current = createDiffRenderer((sid, t) => dbg(sid, t));
 			const currentRecords = react.default.useMemo(() => {
 				const list = [];
-				for (const rec of Object.values(records)) if (rec.path === active) list.push(rec);
+				for (const rec of Object.values(records)) if (rec.path === active && rec.archived !== true) list.push(rec);
 				return list;
 			}, [records, active]);
 			const regions = react.default.useMemo(() => diffRegions(currentRecords, content).filter((r) => !r.superseded), [currentRecords, content]);
@@ -1386,7 +1386,10 @@ window.__ModuleLoader__.load({
 				rpc("edrv.list", { sessionId }).then((res) => {
 					if (!res || !res.ok || !Array.isArray(res.records)) return;
 					const map = {};
-					for (const r of res.records) map[r.callId] = r;
+					for (const r of res.records) {
+						if (r.archived === true) continue;
+						map[r.callId] = r;
+					}
 					setRecords(map);
 				}).catch((e) => setError("list异常:" + String(e)));
 			};
@@ -2197,7 +2200,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/DSH_VsCodeMode/DSH_VsCodeMode/src/client/styles/mcp.css.mjs
-		const css = "/* dsh-vscode-mode MCP 管理界面样式。\n   全部使用 DSH 真实主题变量（--dsw-alias-*），不再用不存在的 fg-* 变量。 */\n.vsm-mcp-page{display:flex;flex-direction:column;gap:18px;width:100%;max-width:920px;box-sizing:border-box;color:var(--dsw-alias-label-primary,#e6e6e6);padding-bottom:32px}\n\n/* 顶部：标题 + 副标题 + 添加按钮 */\n.vsm-mcp-header{display:flex;align-items:flex-start;justify-content:space-between;gap:20px}\n.vsm-mcp-header h2{margin:0 0 4px;font-size:20px;font-weight:600;line-height:1.35;color:var(--dsw-alias-label-primary,#e6e6e6)}\n.vsm-mcp-header p{margin:0;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:13px;line-height:1.5}\n.vsm-primary{border:0;border-radius:6px;padding:8px 16px;background:var(--dsw-alias-button-primary-fill,#6d55ff);color:var(--dsw-alias-button-contrast-fill,#fff);font-size:13px;font-weight:500;cursor:pointer;white-space:nowrap}\n.vsm-primary:hover{background:var(--dsw-alias-button-primary-hover,#5a46e6)}\n.vsm-primary:disabled{opacity:.55;cursor:default}\n\n/* 子 Tab：我的 MCP / MCP 市场 */\n.vsm-mcp-tabs{display:flex;gap:24px;border-bottom:1px solid var(--dsw-alias-border-l2,#3a3a3a)}\n.vsm-mcp-tabs button{border:0;background:none;color:var(--dsw-alias-label-tertiary,#9aa5b1);padding:9px 2px 11px;cursor:pointer;font-size:14px;position:relative}\n.vsm-mcp-tabs button:hover{color:var(--dsw-alias-label-secondary,#c8c8c8)}\n.vsm-mcp-tabs button.active{color:var(--dsw-alias-label-primary,#fff);font-weight:500}\n.vsm-mcp-tabs button.active::after{content:\"\";position:absolute;left:0;right:0;bottom:-1px;height:2px;background:var(--dsw-alias-brand-primary,#6d55ff);border-radius:2px}\n\n/* 服务卡片 */\n.vsm-mcp-card{border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:10px;padding:14px 16px;margin-bottom:10px;background:var(--dsw-alias-bg-layer-2,transparent);transition:border-color .15s}\n.vsm-mcp-card:hover{border-color:var(--dsw-alias-border-l3,#555)}\n.vsm-mcp-card-head{display:flex;justify-content:space-between;align-items:center;gap:12px}\n.vsm-mcp-title{display:flex;align-items:center;gap:9px;font-weight:600;font-size:14px;color:var(--dsw-alias-label-primary,#e6e6e6);min-width:0}\n.vsm-mcp-source{font-size:11px;font-weight:400;padding:2px 7px;border-radius:4px;background:var(--dsw-alias-bg-mask-2,#ffffff22);color:var(--dsw-alias-label-tertiary,#9aa5b1);flex-shrink:0}\n.vsm-mcp-dot{width:8px;height:8px;border-radius:50%;flex-shrink:0;background:var(--dsw-alias-state-error-primary,#e05252)}\n.vsm-mcp-dot.connected{background:var(--dsw-alias-state-success-primary,#38bd75)}\n.vsm-mcp-dot.connecting{background:var(--dsw-alias-state-warn-primary,#e5b93f)}\n.vsm-mcp-dot.disabled{background:var(--dsw-alias-label-tertiary,#9aa5b1)}\n.vsm-mcp-actions{display:flex;align-items:center;gap:4px;flex-shrink:0}\n.vsm-mcp-actions button{border:0;background:none;color:var(--dsw-alias-label-tertiary,#9aa5b1);cursor:pointer;font-size:15px;width:28px;height:28px;border-radius:6px;line-height:1}\n.vsm-mcp-actions button:hover{color:var(--dsw-alias-label-primary,#fff);background:var(--dsw-alias-interactive-bg-hover,#ffffff14)}\n.vsm-mcp-actions button.vsm-danger:hover{color:var(--dsw-alias-state-error-primary,#f07878);background:var(--dsw-alias-interactive-bg-hover-danger,#ff000014)}\n.vsm-switch{font-size:14px !important}\n.vsm-switch.on{color:var(--dsw-alias-state-success-primary,#38bd75)}\n.vsm-mcp-meta{font-size:12px;color:var(--dsw-alias-label-tertiary,#9aa5b1);margin:9px 0}\n.vsm-mcp-error{color:var(--dsw-alias-state-error-primary,#f07878);font-size:12px;margin:8px 0}\n.vsm-mcp-banner{padding:9px 12px;border:1px solid var(--dsw-alias-state-error-secondary,#d9534f55);border-radius:6px;background:var(--dsw-alias-state-error-secondary,#d9534f1a);margin-bottom:10px}\n\n/* 工具 chips */\n.vsm-mcp-tools{display:flex;flex-wrap:wrap;gap:6px}\n.vsm-mcp-chip{font:12px var(--ds-font-family-code,ui-monospace,monospace);padding:4px 8px;border-radius:5px;background:var(--dsw-alias-bg-mask-2,#ffffff14);color:var(--dsw-alias-label-secondary,#c8c8c8);border:1px solid var(--dsw-alias-border-l1,#333)}\n\n/* 空态 / 加载态 */\n.vsm-mcp-empty{text-align:center;padding:56px 20px;color:var(--dsw-alias-label-tertiary,#9aa5b1);border:1px dashed var(--dsw-alias-border-l2,#3a3a3a);border-radius:8px;font-size:13px}\n\n/* 项目搜索下拉框 */\n.vsm-project-picker{position:relative;width:100%;z-index:4}\n.vsm-project-picker-trigger{width:100%;display:flex;align-items:center;justify-content:space-between;gap:12px;padding:10px 12px;border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:8px;background:var(--dsw-alias-bg-layer-1,transparent);color:var(--dsw-alias-label-primary,#e6e6e6);cursor:pointer;text-align:left}\n.vsm-project-picker-trigger:hover{border-color:var(--dsw-alias-brand-primary,#6d55ff)}\n.vsm-project-picker-label{display:flex;flex-direction:column;min-width:0;font-size:13px;font-weight:500}\n.vsm-project-picker-label small{margin-top:3px;color:var(--dsw-alias-label-tertiary,#9aa5b1);font:11px var(--ds-font-family-code,ui-monospace,monospace);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n.vsm-project-picker-arrow{color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:16px}\n.vsm-project-picker-menu{position:absolute;top:calc(100% + 6px);left:0;right:0;padding:8px;border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:9px;background:var(--dsw-alias-bg-overlay,#202020);box-shadow:0 12px 36px #0008}\n.vsm-project-picker-search{width:100%;box-sizing:border-box;padding:8px 10px;border:1px solid var(--dsw-alias-border-l2,#555);border-radius:6px;background:var(--dsw-alias-bg-layer-1,#2b2b2b);color:var(--dsw-alias-label-primary,#eee);outline:none}\n.vsm-project-picker-search:focus{border-color:var(--dsw-alias-brand-primary,#6d55ff)}\n.vsm-project-picker-options{max-height:260px;overflow:auto;margin-top:6px}\n.vsm-project-option{display:flex;width:100%;flex-direction:column;gap:3px;padding:8px 9px;border:0;border-radius:6px;background:none;color:var(--dsw-alias-label-primary,#eee);cursor:pointer;text-align:left}\n.vsm-project-option:hover,.vsm-project-option.highlight{background:var(--dsw-alias-interactive-bg-hover,#ffffff14)}\n.vsm-project-option.selected{color:var(--dsw-alias-brand-primary,#6d55ff)}\n.vsm-project-option small{overflow:hidden;color:var(--dsw-alias-label-tertiary,#9aa5b1);font:11px var(--ds-font-family-code,ui-monospace,monospace);text-overflow:ellipsis;white-space:nowrap}\n.vsm-project-picker-empty{padding:18px 8px;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:12px;text-align:center}\n\n/* 项目级 MCP 分组 */\n.vsm-project{border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:12px;margin-bottom:14px;overflow:hidden;background:var(--dsw-alias-bg-layer-1,transparent)}\n.vsm-project-head{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:12px 16px;border-bottom:1px solid var(--dsw-alias-border-l1,#333);background:var(--dsw-alias-bg-mask-1,#ffffff0a)}\n.vsm-project-title{display:flex;align-items:center;gap:10px;min-width:0}\n.vsm-project-icon{color:var(--dsw-alias-brand-primary,#6d55ff);font-size:15px;flex-shrink:0}\n.vsm-project-name{font-size:14px;font-weight:600;color:var(--dsw-alias-label-primary,#e6e6e6);display:block}\n.vsm-project-path{font-size:11px;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-family:var(--ds-font-family-code,ui-monospace,monospace);display:block;margin-top:2px;word-break:break-all}\n.vsm-primary.vsm-small{padding:5px 12px;font-size:12px}\n.vsm-project-empty{text-align:center;padding:26px 16px;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:12px}\n.vsm-project .vsm-mcp-card{border:0;border-radius:0;margin:0;border-bottom:1px solid var(--dsw-alias-border-l1,#333);background:transparent}\n.vsm-project .vsm-mcp-card:last-child{border-bottom:0}\n.vsm-project .vsm-mcp-banner{border-radius:0;margin:0}\n\n/* 新增 MCP 弹窗 */\n.vsm-mcp-modal{position:fixed;inset:0;background:var(--dsw-alias-bg-mask-drop,#000000aa);display:flex;align-items:center;justify-content:center;z-index:50}\n.vsm-mcp-dialog{width:min(560px,calc(100vw - 40px));max-height:88vh;overflow:auto;padding:22px 24px;border-radius:12px;background:var(--dsw-alias-bg-overlay,#202020);border:1px solid var(--dsw-alias-border-l2,#444);box-shadow:0 16px 60px #000c;color:var(--dsw-alias-label-primary,#e6e6e6)}\n.vsm-mcp-dialog h3{margin:0 0 14px;font-size:16px;font-weight:600}\n.vsm-mcp-dialog label{display:flex;flex-direction:column;gap:6px;margin:12px 0;font-size:12px;color:var(--dsw-alias-label-secondary,#aaa)}\n.vsm-mcp-dialog input,.vsm-mcp-dialog select,.vsm-mcp-dialog textarea{font:inherit;color:var(--dsw-alias-label-primary,#eee);background:var(--dsw-alias-bg-layer-1,#2b2b2b);border:1px solid var(--dsw-alias-border-l2,#555);border-radius:6px;padding:8px 10px}\n.vsm-mcp-dialog input:focus,.vsm-mcp-dialog select:focus,.vsm-mcp-dialog textarea:focus{outline:none;border-color:var(--dsw-alias-brand-primary,#6d55ff)}\n.vsm-mcp-dialog textarea{min-height:64px;resize:vertical;font-family:var(--ds-font-family-code,ui-monospace,monospace)}\n.vsm-mcp-dialog-actions{display:flex;justify-content:flex-end;gap:10px;margin-top:20px}\n.vsm-mcp-dialog-actions button{padding:8px 14px;border:1px solid var(--dsw-alias-border-l2,#555);border-radius:6px;background:none;color:var(--dsw-alias-label-primary,#eee);cursor:pointer;font-size:13px}\n.vsm-mcp-dialog-actions button:hover{background:var(--dsw-alias-interactive-bg-hover,#ffffff14)}\n";
+		const css = "/* dsh-vscode-mode MCP 管理界面样式。\n   全部使用 DSH 真实主题变量（--dsw-alias-*），不再用不存在的 fg-* 变量。 */\n.vsm-mcp-page{display:flex;flex-direction:column;gap:18px;width:100%;max-width:920px;box-sizing:border-box;color:var(--dsw-alias-label-primary,#e6e6e6);padding-bottom:32px}\n\n/* 顶部：标题 + 副标题 + 添加按钮 */\n.vsm-mcp-header{display:flex;align-items:flex-start;justify-content:space-between;gap:20px}\n.vsm-mcp-header h2{margin:0 0 4px;font-size:20px;font-weight:600;line-height:1.35;color:var(--dsw-alias-label-primary,#e6e6e6)}\n.vsm-mcp-header p{margin:0;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:13px;line-height:1.5}\n.vsm-primary{border:0;border-radius:6px;padding:8px 16px;background:var(--dsw-alias-button-primary-fill,#6d55ff);color:var(--dsw-alias-button-contrast-fill,#fff);font-size:13px;font-weight:500;cursor:pointer;white-space:nowrap}\n.vsm-primary:hover{background:var(--dsw-alias-button-primary-hover,#5a46e6)}\n.vsm-primary:disabled{opacity:.55;cursor:default}\n\n/* 子 Tab：我的 MCP / MCP 市场 */\n.vsm-mcp-tabs{display:flex;gap:24px;border-bottom:1px solid var(--dsw-alias-border-l2,#3a3a3a)}\n.vsm-mcp-tabs button{border:0;background:none;color:var(--dsw-alias-label-tertiary,#9aa5b1);padding:9px 2px 11px;cursor:pointer;font-size:14px;position:relative}\n.vsm-mcp-tabs button:hover{color:var(--dsw-alias-label-secondary,#c8c8c8)}\n.vsm-mcp-tabs button.active{color:var(--dsw-alias-label-primary,#fff);font-weight:500}\n.vsm-mcp-tabs button.active::after{content:\"\";position:absolute;left:0;right:0;bottom:-1px;height:2px;background:var(--dsw-alias-brand-primary,#6d55ff);border-radius:2px}\n\n/* 通用设置 */\n.vsm-general-page{display:flex;flex-direction:column;gap:10px;max-width:720px}\n.vsm-general-page h2{margin:0;font-size:20px;color:var(--dsw-alias-label-primary,#e6e6e6)}\n.vsm-general-page p{margin:0 0 8px;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:13px}\n.vsm-general-row{display:flex;align-items:center;justify-content:space-between;gap:20px;padding:14px 0;border-bottom:1px solid var(--dsw-alias-border-l1,#333);color:var(--dsw-alias-label-primary,#eee);font-size:14px}\n.vsm-general-row select{min-width:220px;padding:8px 10px;border:1px solid var(--dsw-alias-border-l2,#555);border-radius:6px;background:var(--dsw-alias-bg-layer-1,#2b2b2b);color:var(--dsw-alias-label-primary,#eee);font:inherit}\n.vsm-general-row small{color:var(--dsw-alias-label-tertiary,#9aa5b1)}\n\n/* 服务卡片 */\n.vsm-mcp-card{border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:10px;padding:14px 16px;margin-bottom:10px;background:var(--dsw-alias-bg-layer-2,transparent);transition:border-color .15s}\n.vsm-mcp-card:hover{border-color:var(--dsw-alias-border-l3,#555)}\n.vsm-mcp-card-head{display:flex;justify-content:space-between;align-items:center;gap:12px}\n.vsm-mcp-title{display:flex;align-items:center;gap:9px;font-weight:600;font-size:14px;color:var(--dsw-alias-label-primary,#e6e6e6);min-width:0}\n.vsm-mcp-source{font-size:11px;font-weight:400;padding:2px 7px;border-radius:4px;background:var(--dsw-alias-bg-mask-2,#ffffff22);color:var(--dsw-alias-label-tertiary,#9aa5b1);flex-shrink:0}\n.vsm-mcp-dot{width:8px;height:8px;border-radius:50%;flex-shrink:0;background:var(--dsw-alias-state-error-primary,#e05252)}\n.vsm-mcp-dot.connected{background:var(--dsw-alias-state-success-primary,#38bd75)}\n.vsm-mcp-dot.connecting{background:var(--dsw-alias-state-warn-primary,#e5b93f)}\n.vsm-mcp-dot.disabled{background:var(--dsw-alias-label-tertiary,#9aa5b1)}\n.vsm-mcp-actions{display:flex;align-items:center;gap:4px;flex-shrink:0}\n.vsm-mcp-actions button{border:0;background:none;color:var(--dsw-alias-label-tertiary,#9aa5b1);cursor:pointer;font-size:15px;width:28px;height:28px;border-radius:6px;line-height:1}\n.vsm-mcp-actions button:hover{color:var(--dsw-alias-label-primary,#fff);background:var(--dsw-alias-interactive-bg-hover,#ffffff14)}\n.vsm-mcp-actions button.vsm-danger:hover{color:var(--dsw-alias-state-error-primary,#f07878);background:var(--dsw-alias-interactive-bg-hover-danger,#ff000014)}\n.vsm-switch{font-size:14px !important}\n.vsm-switch.on{color:var(--dsw-alias-state-success-primary,#38bd75)}\n.vsm-mcp-meta{font-size:12px;color:var(--dsw-alias-label-tertiary,#9aa5b1);margin:9px 0}\n.vsm-mcp-error{color:var(--dsw-alias-state-error-primary,#f07878);font-size:12px;margin:8px 0}\n.vsm-mcp-banner{padding:9px 12px;border:1px solid var(--dsw-alias-state-error-secondary,#d9534f55);border-radius:6px;background:var(--dsw-alias-state-error-secondary,#d9534f1a);margin-bottom:10px}\n\n/* 工具 chips */\n.vsm-mcp-tools{display:flex;flex-wrap:wrap;gap:6px}\n.vsm-mcp-chip{font:12px var(--ds-font-family-code,ui-monospace,monospace);padding:4px 8px;border-radius:5px;background:var(--dsw-alias-bg-mask-2,#ffffff14);color:var(--dsw-alias-label-secondary,#c8c8c8);border:1px solid var(--dsw-alias-border-l1,#333)}\n\n/* 空态 / 加载态 */\n.vsm-mcp-empty{text-align:center;padding:56px 20px;color:var(--dsw-alias-label-tertiary,#9aa5b1);border:1px dashed var(--dsw-alias-border-l2,#3a3a3a);border-radius:8px;font-size:13px}\n\n/* 项目搜索下拉框 */\n.vsm-project-picker{position:relative;width:100%;z-index:4}\n.vsm-project-picker-trigger{width:100%;display:flex;align-items:center;justify-content:space-between;gap:12px;padding:10px 12px;border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:8px;background:var(--dsw-alias-bg-layer-1,transparent);color:var(--dsw-alias-label-primary,#e6e6e6);cursor:pointer;text-align:left}\n.vsm-project-picker-trigger:hover{border-color:var(--dsw-alias-brand-primary,#6d55ff)}\n.vsm-project-picker-label{display:flex;flex-direction:column;min-width:0;font-size:13px;font-weight:500}\n.vsm-project-picker-label small{margin-top:3px;color:var(--dsw-alias-label-tertiary,#9aa5b1);font:11px var(--ds-font-family-code,ui-monospace,monospace);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n.vsm-project-picker-arrow{color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:16px}\n.vsm-project-picker-menu{position:absolute;top:calc(100% + 6px);left:0;right:0;padding:8px;border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:9px;background:var(--dsw-alias-bg-overlay,#202020);box-shadow:0 12px 36px #0008}\n.vsm-project-picker-search{width:100%;box-sizing:border-box;padding:8px 10px;border:1px solid var(--dsw-alias-border-l2,#555);border-radius:6px;background:var(--dsw-alias-bg-layer-1,#2b2b2b);color:var(--dsw-alias-label-primary,#eee);outline:none}\n.vsm-project-picker-search:focus{border-color:var(--dsw-alias-brand-primary,#6d55ff)}\n.vsm-project-picker-options{max-height:260px;overflow:auto;margin-top:6px}\n.vsm-project-option{display:flex;width:100%;flex-direction:column;gap:3px;padding:8px 9px;border:0;border-radius:6px;background:none;color:var(--dsw-alias-label-primary,#eee);cursor:pointer;text-align:left}\n.vsm-project-option:hover,.vsm-project-option.highlight{background:var(--dsw-alias-interactive-bg-hover,#ffffff14)}\n.vsm-project-option.selected{color:var(--dsw-alias-brand-primary,#6d55ff)}\n.vsm-project-option small{overflow:hidden;color:var(--dsw-alias-label-tertiary,#9aa5b1);font:11px var(--ds-font-family-code,ui-monospace,monospace);text-overflow:ellipsis;white-space:nowrap}\n.vsm-project-picker-empty{padding:18px 8px;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:12px;text-align:center}\n\n/* 项目级 MCP 分组 */\n.vsm-project{border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:12px;margin-bottom:14px;overflow:hidden;background:var(--dsw-alias-bg-layer-1,transparent)}\n.vsm-project-head{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:12px 16px;border-bottom:1px solid var(--dsw-alias-border-l1,#333);background:var(--dsw-alias-bg-mask-1,#ffffff0a)}\n.vsm-project-title{display:flex;align-items:center;gap:10px;min-width:0}\n.vsm-project-icon{color:var(--dsw-alias-brand-primary,#6d55ff);font-size:15px;flex-shrink:0}\n.vsm-project-name{font-size:14px;font-weight:600;color:var(--dsw-alias-label-primary,#e6e6e6);display:block}\n.vsm-project-path{font-size:11px;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-family:var(--ds-font-family-code,ui-monospace,monospace);display:block;margin-top:2px;word-break:break-all}\n.vsm-primary.vsm-small{padding:5px 12px;font-size:12px}\n.vsm-project-empty{text-align:center;padding:26px 16px;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:12px}\n.vsm-project .vsm-mcp-card{border:0;border-radius:0;margin:0;border-bottom:1px solid var(--dsw-alias-border-l1,#333);background:transparent}\n.vsm-project .vsm-mcp-card:last-child{border-bottom:0}\n.vsm-project .vsm-mcp-banner{border-radius:0;margin:0}\n\n/* 新增 MCP 弹窗 */\n.vsm-mcp-modal{position:fixed;inset:0;background:var(--dsw-alias-bg-mask-drop,#000000aa);display:flex;align-items:center;justify-content:center;z-index:50}\n.vsm-mcp-dialog{width:min(560px,calc(100vw - 40px));max-height:88vh;overflow:auto;padding:22px 24px;border-radius:12px;background:var(--dsw-alias-bg-overlay,#202020);border:1px solid var(--dsw-alias-border-l2,#444);box-shadow:0 16px 60px #000c;color:var(--dsw-alias-label-primary,#e6e6e6)}\n.vsm-mcp-dialog h3{margin:0 0 14px;font-size:16px;font-weight:600}\n.vsm-mcp-dialog label{display:flex;flex-direction:column;gap:6px;margin:12px 0;font-size:12px;color:var(--dsw-alias-label-secondary,#aaa)}\n.vsm-mcp-dialog input,.vsm-mcp-dialog select,.vsm-mcp-dialog textarea{font:inherit;color:var(--dsw-alias-label-primary,#eee);background:var(--dsw-alias-bg-layer-1,#2b2b2b);border:1px solid var(--dsw-alias-border-l2,#555);border-radius:6px;padding:8px 10px}\n.vsm-mcp-dialog input:focus,.vsm-mcp-dialog select:focus,.vsm-mcp-dialog textarea:focus{outline:none;border-color:var(--dsw-alias-brand-primary,#6d55ff)}\n.vsm-mcp-dialog textarea{min-height:64px;resize:vertical;font-family:var(--ds-font-family-code,ui-monospace,monospace)}\n.vsm-mcp-dialog-actions{display:flex;justify-content:flex-end;gap:10px;margin-top:20px}\n.vsm-mcp-dialog-actions button{padding:8px 14px;border:1px solid var(--dsw-alias-border-l2,#555);border-radius:6px;background:none;color:var(--dsw-alias-label-primary,#eee);cursor:pointer;font-size:13px}\n.vsm-mcp-dialog-actions button:hover{background:var(--dsw-alias-interactive-bg-hover,#ffffff14)}\n\n/* 兼容性小节 */\n.vsm-compat-h3{margin:16px 0 2px;font-size:14px;font-weight:600;color:var(--dsw-alias-label-secondary,#c8c8c8)}\n.vsm-compat-item{display:flex;align-items:baseline;justify-content:space-between;gap:16px;padding:10px 0;border-bottom:1px solid var(--dsw-alias-border-l1,#333);font-size:13px;color:var(--dsw-alias-label-primary,#eee)}\n.vsm-compat-item.ok .vsm-compat-name::before{content:\"● \";color:var(--dsw-alias-state-success-primary,#38bd75)}\n.vsm-compat-item.warn .vsm-compat-name::before{content:\"● \";color:var(--dsw-alias-state-warn-primary,#e5b93f)}\n.vsm-compat-name{font-weight:500;min-width:0}\n.vsm-compat-note{color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:12px;text-align:right;min-width:0}\n";
 		const tagId = "dsh-vscode-mode/mcp.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -2207,6 +2210,218 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		//#endregion
+		//#region src/client/compat.ts
+		/**
+		* dsh-vscode-mode client — 兼容层：设置桥选择 / slot 安全注册 / openPath 链式补丁 / 外部插件常量。
+		* 纯逻辑与薄 ctx 胶水，node 环境可单测（不依赖 DOM）。
+		* 作者 ddj 2026年08月24号
+		*/
+		/** 本插件包名（与 host compat.PLUGIN_NAME 对应）。 */
+		const PLUGIN_NAME = "dsh-vscode-mode";
+		/** 外部侧栏插件名（dsh-web-ui-all 家族的文件打开能力提供方）。 */
+		const SIDEBAR_PLUGIN = "dsh-better-sidebar";
+		/**
+		* 设置桥三级优先：webUiSettings（linxin666 兼容桥）→ settingsScope（官方）→ 无。
+		* 桥绑定抛错时降级到下一级，不让单个桥异常拖垮设置装配。
+		* @author ddj 2026年08月24号
+		* @param ctx 客户端服务上下文
+		* @returns 激活的桥名称与绑定 scope
+		*/
+		function pickSettingsBinder(ctx) {
+			for (const service of ["webUiSettings", "settingsScope"]) try {
+				const scope = ctx.get(service)?.bind?.({ namespace: PLUGIN_NAME });
+				if (scope) return {
+					service,
+					scope
+				};
+			} catch {}
+			return {
+				service: "none",
+				scope: void 0
+			};
+		}
+		/**
+		* 跨版本 slot 安全注册：封装 ctx.slots.inject 等待声明模式（新老 DSH 通用），
+		* 服务缺失或注册抛错时降级为警告，不让单条 slot 拖垮装配。
+		* 注意：方法必须挂在服务对象上调用（slots.register 是依赖 this.records 的类方法，
+		* 解构后 this 丢失会静默失败），故禁止解构。
+		* @author ddj 2026年08月24号
+		* @param ctx 客户端上下文（slots 服务）
+		* @param spec slot 描述
+		* @param render 渲染函数
+		*/
+		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);
+				return;
+			}
+			try {
+				slots.inject(spec.name, () => slots.register(spec, render));
+			} catch (error) {
+				console.warn("[dsh-vscode-mode] slot " + spec.name + " 注册失败（" + String(error) + "），已跳过");
+			}
+		}
+		/**
+		* 链式补丁对象方法：保存原实现、装入包装实现，dispose 恢复。
+		* 恢复带归属校验（仅当当前实现仍是本包装时还原），多插件补丁按栈序互不踩踏。
+		* @author ddj 2026年08月24号
+		* @param owner 目标对象
+		* @param key 方法名
+		* @param wrapper 包装实现（original 为补丁前的实现）
+		* @returns 恢复函数（幂等）
+		*/
+		function patchMethod(owner, key, wrapper) {
+			const original = owner[key];
+			const patched = ((...args) => wrapper(original, ...args));
+			owner[key] = patched;
+			return () => {
+				if (owner[key] === patched) owner[key] = original;
+			};
+		}
+		//#endregion
+		//#region src/client/fileOpeners.ts
+		/**
+		* dsh-vscode-mode client — 文件打开器注册表与自动选择。
+		* @author ddj 2026年08月24号
+		*/
+		const AUTO_OPEN_TOOL = "auto";
+		const VSCODE_OPEN_TOOL = "dsh-vscode-mode";
+		const SIDEBAR_OPEN_TOOL = SIDEBAR_PLUGIN;
+		/**
+		* 写入外部打开器并触发注册表通知。
+		* @author ddj 2026年08月24号
+		* @param entries 打开器存储
+		* @param notify 变更通知
+		* @param opener 打开器
+		*/
+		function registryRegister(entries, notify, opener) {
+			if (!opener.id || typeof opener.open !== "function") throw new TypeError("文件打开器必须提供 id 和 open");
+			entries.set(opener.id, opener);
+			notify();
+		}
+		/**
+		* 创建生命周期独立的文件打开器注册表。
+		* @author ddj 2026年08月24号
+		* @returns 文件打开器注册表
+		*/
+		function createFileOpenerRegistry() {
+			const entries = /* @__PURE__ */ new Map();
+			const listeners = /* @__PURE__ */ new Set();
+			const notify = () => {
+				for (const listener of listeners) listener();
+			};
+			const list = () => [...entries.values()].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+			return {
+				register(opener) {
+					registryRegister(entries, notify, opener);
+					return () => {
+						if (entries.get(opener.id) !== opener) return;
+						entries.delete(opener.id);
+						notify();
+					};
+				},
+				registerFileOpener(opener) {
+					registryRegister(entries, notify, opener);
+					return () => {
+						if (entries.get(opener.id) !== opener) return;
+						entries.delete(opener.id);
+						notify();
+					};
+				},
+				list,
+				subscribe(listener) {
+					listeners.add(listener);
+					return () => listeners.delete(listener);
+				},
+				get: (id) => entries.get(id)
+			};
+		}
+		/**
+		* 检查打开器当前是否可用。
+		* @author ddj 2026年08月24号
+		* @param opener 待检查打开器
+		* @returns 是否可用
+		*/
+		function isAvailable(opener) {
+			try {
+				return opener.isAvailable ? opener.isAvailable() : true;
+			} catch {
+				return false;
+			}
+		}
+		/**
+		* 返回当前可展示的文件打开器。
+		* @author ddj 2026年08月24号
+		* @param registry 文件打开器注册表
+		* @returns 可用打开器列表
+		*/
+		function availableOpeners(registry) {
+			return registry.list().filter(isAvailable);
+		}
+		/**
+		* 按设置选择打开器，不可用时回退自动优先级。
+		* @author ddj 2026年08月24号
+		* @param registry 文件打开器注册表
+		* @param selected 用户选择的打开器 id
+		* @returns 选中的打开器
+		*/
+		function selectOpener(registry, selected) {
+			if (selected !== "auto") {
+				const requested = registry.get(selected);
+				if (requested && isAvailable(requested)) return requested;
+			}
+			return availableOpeners(registry)[0];
+		}
+		/**
+		* 结构化探测 dsh-better-sidebar 的文件打开能力。
+		* @author ddj 2026年08月24号
+		* @param ctx 客户端服务上下文
+		* @returns 侧边栏打开器或 undefined
+		*/
+		function scanSidebar(ctx) {
+			try {
+				const service = ctx.get("betterSidebar");
+				if (!service || typeof service.openFile !== "function") return void 0;
+				if (!(service.features?.includes("openFile") ?? true)) return void 0;
+				if (!(typeof service.isTabEnabled !== "function" || service.isTabEnabled("editor"))) return void 0;
+				return {
+					id: SIDEBAR_OPEN_TOOL,
+					label: "dsh-better-sidebar",
+					description: "在 dsh-web-ui-all 侧边栏编辑器中打开",
+					priority: 80,
+					isAvailable: () => typeof service.openFile === "function" && (service.features?.includes("openFile") ?? true) && (typeof service.isTabEnabled !== "function" || service.isTabEnabled("editor")),
+					open: (path, context) => {
+						if (!context.sessionId) throw new Error("当前没有活动会话");
+						service.openFile({
+							sessionId: context.sessionId,
+							cwd: context.cwd
+						}, path, baseName(path));
+					}
+				};
+			} catch {
+				return;
+			}
+		}
+		/**
+		* 从路径提取文件名。
+		* @author ddj 2026年08月24号
+		* @param path 文件路径
+		* @returns 文件名
+		*/
+		function baseName(path) {
+			const normalized = path.replace(/\\/g, "/");
+			return normalized.slice(normalized.lastIndexOf("/") + 1) || path;
+		}
+		//#endregion
+		//#region src/client/settingsContext.ts
+		/**
+		* dsh-vscode-mode client — 设置 scope 的跨组件上下文。
+		* 绑定逻辑（webUiSettings 兼容桥 → 官方 settingsScope 降级）统一由 compat 层提供。
+		* 作者 ddj 2026年08月24号
+		*/
+		const SettingsContext = react.default.createContext(void 0);
+		//#endregion
 		//#region src/client/ui/McpSettings.ts
 		/**
 		* dsh-vscode-mode client — VSCodeMode 设置区内的 MCP 管理。
@@ -2359,14 +2574,91 @@ window.__ModuleLoader__.load({
 			}));
 			return react.default.createElement("section", { className: "vsm-project" }, head, body);
 		}
+		/** 通用设置：选择当前对话文件链接的打开器。 */
+		function GeneralSettings({ registry }) {
+			const [tool, setTool] = react.default.useState(AUTO_OPEN_TOOL);
+			const [busy, setBusy] = react.default.useState(false);
+			const [error, setError] = react.default.useState("");
+			const settings = react.default.useContext(SettingsContext);
+			const snapshot = settings?.getSnapshot?.();
+			const loading = !snapshot || snapshot.status === "loading";
+			const unavailable = snapshot?.status === "unavailable" || !settings;
+			const notReady = snapshot?.status !== "ready";
+			react.default.useEffect(() => {
+				const onChange = () => {
+					const next = settings?.getSnapshot?.().value?.fileOpenTool;
+					if (typeof next === "string") setTool(next);
+				};
+				onChange();
+				return settings?.subscribe?.(onChange);
+			}, [settings]);
+			const save = (value) => {
+				setTool(value);
+				setBusy(true);
+				setError("");
+				if (!settings?.set) {
+					setError("设置服务不可用");
+					setBusy(false);
+					return;
+				}
+				settings.set("fileOpenTool", value).catch((e) => setError(String(e))).finally(() => setBusy(false));
+			};
+			const options = [{
+				id: AUTO_OPEN_TOOL,
+				label: "自动选择",
+				description: "按当前已注册工具自动选择"
+			}, ...availableOpeners(registry).map((item) => ({
+				id: item.id,
+				label: item.label,
+				description: item.description
+			}))];
+			const currentOption = options.some((item) => item.id === tool) ? tool : AUTO_OPEN_TOOL;
+			return react.default.createElement("section", { className: "vsm-general-page" }, react.default.createElement("h2", null, "通用"), react.default.createElement("p", null, "配置 DSH 对话中文件链接的打开工具。工具由当前运行时自动扫描。"), unavailable && react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, "设置服务暂不可用，当前使用自动选择。"), error && react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, error), react.default.createElement("label", { className: "vsm-general-row" }, react.default.createElement("span", null, "文件链接使用工具"), react.default.createElement("select", {
+				value: currentOption,
+				disabled: loading || unavailable || notReady || busy || snapshot?.writable === false,
+				onChange: (event) => save(event.target.value)
+			}, options.map((item) => react.default.createElement("option", {
+				key: item.id,
+				value: item.id
+			}, item.label))), loading && react.default.createElement("small", null, "读取中…")));
+		}
+		/** 兼容性小节：host 报告（RPC compat）+ 客户端本地适配项。 */
+		function CompatSection({ getSummary }) {
+			const [report, setReport] = react.default.useState(null);
+			const [error, setError] = react.default.useState("");
+			react.default.useEffect(() => {
+				let alive = true;
+				rpc("compat", {}).then((result) => {
+					if (!alive) return;
+					if (!result.ok) setError(String(result.error));
+					else setReport(result.report);
+				}).catch((e) => {
+					if (alive) setError(String(e));
+				});
+				return () => {
+					alive = false;
+				};
+			}, []);
+			const renderItems = (list) => (list ?? []).map((item) => react.default.createElement("div", {
+				key: item.name,
+				className: "vsm-compat-item " + (item.active ? "ok" : "warn")
+			}, react.default.createElement("span", { className: "vsm-compat-name" }, item.name), react.default.createElement("span", { className: "vsm-compat-note" }, item.note ?? (item.active ? "正常" : "未生效"))));
+			const warnings = report?.warnings ?? [];
+			return react.default.createElement("section", { className: "vsm-general-page" }, react.default.createElement("h2", null, "兼容性"), react.default.createElement("p", null, "检测与其他插件 / DSH 版本的适配状态与已知问题。" + (report?.pluginVersion ? "（插件版本 " + report.pluginVersion + "）" : "")), error && react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, error), react.default.createElement("h3", { className: "vsm-compat-h3" }, "外部插件与服务"), renderItems(report?.external), react.default.createElement("h3", { className: "vsm-compat-h3" }, "客户端适配"), renderItems(getSummary?.() ?? []), react.default.createElement("h3", { className: "vsm-compat-h3" }, "护栏"), renderItems(report?.guards), react.default.createElement("h3", { className: "vsm-compat-h3" }, "警告"), warnings.length ? warnings.map((w, index) => react.default.createElement("div", {
+				key: index,
+				className: "vsm-mcp-error vsm-mcp-banner"
+			}, w)) : react.default.createElement("div", { className: "vsm-compat-item ok" }, react.default.createElement("span", { className: "vsm-compat-name" }, "未检测到兼容性问题"), react.default.createElement("span", { className: "vsm-compat-note" }, "")));
+		}
 		/** MCP 管理主面板。 */
-		function McpSettings() {
+		function McpSettings(props) {
+			const openerRegistry = props?.openerRegistry ?? { list: () => [] };
+			const compatSummary = props?.compatSummary ?? (() => []);
 			const [servers, setServers] = react.default.useState([]);
 			const [projects, setProjects] = react.default.useState([]);
 			const [loading, setLoading] = react.default.useState(true);
 			const [busy, setBusy] = react.default.useState("");
 			const [error, setError] = react.default.useState("");
-			const [tab, setTab] = react.default.useState("mine");
+			const [tab, setTab] = react.default.useState("general");
 			const [draft, setDraft] = react.default.useState(EMPTY);
 			const [showForm, setShowForm] = react.default.useState(false);
 			const [projectForm, setProjectForm] = react.default.useState(null);
@@ -2477,6 +2769,7 @@ window.__ModuleLoader__.load({
 			}) : react.default.createElement("div", { className: "vsm-mcp-empty" }, "请选择项目")) : react.default.createElement("div", { className: "vsm-mcp-empty" }, "还没有项目");
 			let body;
 			if (loading) body = react.default.createElement("div", { className: "vsm-mcp-empty" }, "正在读取 MCP 服务…");
+			else if (tab === "general") body = react.default.createElement(GeneralSettings, { registry: openerRegistry });
 			else if (tab === "mine") body = react.default.createElement("div", null, servers.length ? servers.map((s) => react.default.createElement(ServerCard, {
 				key: s.id,
 				server: s,
@@ -2485,6 +2778,7 @@ window.__ModuleLoader__.load({
 				onRemove: removeGlobal
 			})) : react.default.createElement("div", { className: "vsm-mcp-empty" }, "还没有配置全局 MCP"));
 			else if (tab === "projects") body = projectBody;
+			else if (tab === "compat") body = react.default.createElement(CompatSection, { getSummary: compatSummary });
 			else body = marketBody;
 			const form = showForm ? react.default.createElement(McpForm, {
 				title: "添加全局 MCP",
@@ -2508,6 +2802,9 @@ window.__ModuleLoader__.load({
 					setShowForm(true);
 				}
 			}, "+ 添加全局 MCP")), react.default.createElement("nav", { className: "vsm-mcp-tabs" }, react.default.createElement("button", {
+				className: tab === "general" ? "active" : "",
+				onClick: () => setTab("general")
+			}, "通用"), react.default.createElement("button", {
 				className: tab === "mine" ? "active" : "",
 				onClick: () => setTab("mine")
 			}, "我的 MCP"), react.default.createElement("button", {
@@ -2516,7 +2813,10 @@ window.__ModuleLoader__.load({
 			}, "项目 MCP"), react.default.createElement("button", {
 				className: tab === "market" ? "active" : "",
 				onClick: () => setTab("market")
-			}, "MCP 市场")), error && react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, error), body, form);
+			}, "MCP 市场"), react.default.createElement("button", {
+				className: tab === "compat" ? "active" : "",
+				onClick: () => setTab("compat")
+			}, "兼容性")), error && react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, error), body, form);
 		}
 		/** MCP 新增表单（全局/项目共用）。 */
 		function McpForm({ title, draft, busy, edit, save, close }) {
@@ -2542,6 +2842,56 @@ window.__ModuleLoader__.load({
 			}, "保存并连接"))));
 		}
 		//#endregion
+		//#region src/client/openPathRouter.ts
+		/**
+		* dsh-vscode-mode client — DSH 对话文件链接的统一打开路由。
+		* openPath 补丁经 compat.patchMethod 安装（链式恢复，多插件补丁互不踩踏）。
+		* 作者 ddj 2026年08月24号
+		*/
+		/**
+		* 安装可卸载的 workspaces.openPath 路由。
+		* @author ddj 2026年08月24号
+		* @param options 路由依赖
+		* @returns 恢复原方法的 disposer
+		*/
+		function installOpenPathRouter(options) {
+			const open = async (original, path) => {
+				const context = options.context();
+				const opener = selectOpener(options.registry, options.selected());
+				if (!opener || !isAvailable(opener)) return original.call(options.workspaces, path);
+				try {
+					await opener.open(path, context);
+				} catch (error) {
+					options.logger?.("文件打开器 " + opener.id + " 失败，回退系统打开: " + String(error));
+					if (opener.id !== "system") await original.call(options.workspaces, path);
+					else throw error;
+				}
+			};
+			return patchMethod(options.workspaces, "openPath", open);
+		}
+		/**
+		* 创建 VSCodeMode 内置文件打开器。
+		* @author ddj 2026年08月24号
+		* @returns VSCodeMode 打开器
+		*/
+		function vscodeOpener() {
+			return {
+				id: VSCODE_OPEN_TOOL,
+				label: "VSCodeMode",
+				priority: 100,
+				open: (path) => openEditorView(path)
+			};
+		}
+		/**
+		* 规范化设置中的打开器 id。
+		* @author ddj 2026年08月24号
+		* @param value 原始设置值
+		* @returns 可路由的打开器 id
+		*/
+		function autoValue(value) {
+			return typeof value === "string" && value.trim() ? value.trim() : AUTO_OPEN_TOOL;
+		}
+		//#endregion
 		//#region src/client/index.ts
 		/**
 		* dsh-vscode-mode client — 浏览器半入口：slot 注册 + 装配。
@@ -2561,7 +2911,11 @@ window.__ModuleLoader__.load({
 			"timer",
 			"locale",
 			"connection",
-			"remote"
+			"remote",
+			"workspaces",
+			"sessions",
+			"settingsScope",
+			"webUiSettings"
 		];
 		/**
 		* 装配客户端：注册中央编辑区视图与 header 差异角标。
@@ -2570,25 +2924,90 @@ window.__ModuleLoader__.load({
 		*/
 		function apply(ctx) {
 			const schedule = (fn, ms) => ctx.timeout(fn, ms);
-			ctx.slots.inject("conversation.view", () => ctx.slots.register({
+			const registry = createFileOpenerRegistry();
+			const workspaces = ctx.get("workspaces");
+			const sessions = ctx.get("sessions");
+			const originalOpenPath = workspaces?.openPath;
+			const binder = pickSettingsBinder(ctx);
+			const settings = binder.scope;
+			let selected = autoValue("auto");
+			/** 客户端侧兼容摘要（与 host 报告合并展示；惰性求值保证 HMR 后仍新鲜）。 */
+			const compatSummary = () => [
+				{
+					name: "设置桥",
+					active: settings !== void 0,
+					note: settings !== void 0 ? "使用 " + binder.service + " 桥" : "未绑定设置服务（fileOpenTool 持久化不可用）"
+				},
+				{
+					name: "文件打开路由（workspaces.openPath）",
+					active: Boolean(workspaces?.openPath),
+					note: "vscode 打开器优先，失败回退系统打开"
+				},
+				{
+					name: "侧边栏打开器（dsh-better-sidebar）",
+					active: registry.get(SIDEBAR_PLUGIN) !== void 0,
+					note: registry.get("dsh-better-sidebar") !== void 0 ? "已注册（优先级 80）" : "未检测到侧边栏打开能力"
+				}
+			];
+			ctx.provide("fileOpeners", registry);
+			ctx.effect(() => registry.register(vscodeOpener()), "vscode-mode: file opener");
+			ctx.effect(() => registry.register({
+				id: "system",
+				label: "系统默认应用",
+				priority: 0,
+				open: (path) => originalOpenPath.call(workspaces, path)
+			}), "vscode-mode: system file opener");
+			ctx.effect(() => {
+				const sidebar = scanSidebar(ctx);
+				return sidebar ? registry.register(sidebar) : void 0;
+			}, "vscode-mode: sidebar file opener");
+			ctx.effect(() => {
+				if (!settings) return void 0;
+				const sync = () => {
+					const snapshot = settings.getSnapshot();
+					if (snapshot.status === "loading") return;
+					selected = autoValue(snapshot.value?.fileOpenTool);
+					window.dispatchEvent(new CustomEvent("edrv:file-open-tool-change", { detail: { value: selected } }));
+				};
+				sync();
+				return settings.subscribe(sync);
+			}, "vscode-mode: file opener setting sync");
+			if (workspaces?.openPath) ctx.effect(() => installOpenPathRouter({
+				workspaces,
+				registry,
+				selected: () => selected,
+				context: () => {
+					const current = sessions?.list?.getSnapshot?.();
+					const sessionId = current?.current;
+					return {
+						sessionId,
+						cwd: (sessionId ? current?.byId?.[sessionId] : void 0)?.cwd
+					};
+				},
+				logger: (message) => console.warn("[dsh-vscode-mode] " + message)
+			}), "vscode-mode: file link routing");
+			registerSlotSafely(ctx, {
 				name: "conversation.view",
 				id: "edrv-editor",
 				order: 5,
 				label: "文件编辑",
 				inject: (sessionId) => ({ sessionId })
-			}, (props) => react.default.createElement(EditorView, Object.assign({}, props, { schedule }))));
-			ctx.slots.inject("conversation.session.header.utilities", () => ctx.slots.register({
+			}, (props) => react.default.createElement(EditorView, Object.assign({}, props, { schedule })));
+			registerSlotSafely(ctx, {
 				name: "conversation.session.header.utilities",
 				id: "edrv-diff-badge",
 				order: 90,
 				label: "差异"
-			}, (props) => react.default.createElement(DiffBadge, Object.assign({}, props))));
-			ctx.slots.inject("settings.section", () => ctx.slots.register({
+			}, (props) => react.default.createElement(DiffBadge, Object.assign({}, props)));
+			registerSlotSafely(ctx, {
 				name: "settings.section",
 				id: "vscode-mode",
 				order: 30,
 				label: "VSCodeMode"
-			}, () => react.default.createElement(McpSettings)));
+			}, () => react.default.createElement(SettingsContext.Provider, { value: settings }, react.default.createElement(McpSettings, {
+				openerRegistry: registry,
+				compatSummary
+			})));
 		}
 		//#endregion
 		exports.apply = apply;