dsh-vscode-mode 0.1.15 → 0.1.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 中央编辑器（文件页签/QuickOpen/状态栏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚），状态持久化到工作区旁车",
   "keywords": [
     "dsh",

package/src/client/compat.ts

@@ -0,0 +1,91 @@
+/**
+ * dsh-vscode-mode client — 兼容层：设置桥选择 / slot 安全注册 / openPath 链式补丁 / 外部插件常量。
+ * 纯逻辑与薄 ctx 胶水，node 环境可单测（不依赖 DOM）。
+ * 作者 ddj 2026年08月24号
+ */
+
+/** 本插件包名（与 host compat.PLUGIN_NAME 对应）。 */
+export const PLUGIN_NAME = 'dsh-vscode-mode'
+/** 外部侧栏插件名（dsh-web-ui-all 家族的文件打开能力提供方）。 */
+export const SIDEBAR_PLUGIN = 'dsh-better-sidebar'
+
+/** 设置 scope 的跨组件上下文形状（与官方 settingsScope 绑定的最小面）。 */
+export interface SettingsScopeLike {
+  getSnapshot: () => { status?: string; value?: { fileOpenTool?: unknown }; writable?: boolean }
+  subscribe: (listener: () => void) => () => void
+  set: (field: string, value: unknown) => Promise<void>
+}
+
+/**
+ * 设置桥三级优先：webUiSettings（linxin666 兼容桥）→ settingsScope（官方）→ 无。
+ * 桥绑定抛错时降级到下一级，不让单个桥异常拖垮设置装配。
+ * @author ddj 2026年08月24号
+ * @param ctx 客户端服务上下文
+ * @returns 激活的桥名称与绑定 scope
+ */
+export function pickSettingsBinder(ctx: { get: (name: string) => unknown }): { service: string; scope: SettingsScopeLike | undefined } {
+  for (const service of ['webUiSettings', 'settingsScope']) {
+    try {
+      const binder = ctx.get(service) as { bind?: (spec: { namespace: string }) => SettingsScopeLike } | undefined
+      const scope = binder?.bind?.({ namespace: PLUGIN_NAME })
+      if (scope) return { service, scope }
+    } catch {
+      /* 桥异常时降级到下一级 */
+    }
+  }
+  return { service: 'none', scope: undefined }
+}
+
+/** slot 注册描述（对齐 ctx.slots.register 的形状）。 */
+export interface SlotSpec {
+  name: string
+  id: string
+  order?: number
+  label?: string
+  inject?: (sessionId: string) => object
+}
+
+/**
+ * 跨版本 slot 安全注册：封装 ctx.slots.inject 等待声明模式（新老 DSH 通用），
+ * 服务缺失或注册抛错时降级为警告，不让单条 slot 拖垮装配。
+ * 注意：方法必须挂在服务对象上调用（slots.register 是依赖 this.records 的类方法，
+ * 解构后 this 丢失会静默失败），故禁止解构。
+ * @author ddj 2026年08月24号
+ * @param ctx 客户端上下文（slots 服务）
+ * @param spec slot 描述
+ * @param render 渲染函数
+ */
+export function registerSlotSafely(ctx: { slots?: { inject?: (name: string, register: () => unknown) => unknown; register?: (...args: unknown[]) => unknown } }, spec: SlotSpec, render: (props: unknown) => unknown): void {
+  const slots = ctx?.slots as { inject: (name: string, register: () => unknown) => unknown; register: (...args: unknown[]) => unknown } | undefined
+  if (!slots || typeof slots.inject !== 'function' || typeof slots.register !== 'function') {
+    console.warn('[' + PLUGIN_NAME + '] slots 服务不可用，跳过 slot ' + spec.name)
+    return
+  }
+  try {
+    slots.inject(spec.name, () => slots.register(spec, render))
+  } catch (error) {
+    console.warn('[' + PLUGIN_NAME + '] slot ' + spec.name + ' 注册失败（' + String(error) + '），已跳过')
+  }
+}
+
+/**
+ * 链式补丁对象方法：保存原实现、装入包装实现，dispose 恢复。
+ * 恢复带归属校验（仅当当前实现仍是本包装时还原），多插件补丁按栈序互不踩踏。
+ * @author ddj 2026年08月24号
+ * @param owner 目标对象
+ * @param key 方法名
+ * @param wrapper 包装实现（original 为补丁前的实现）
+ * @returns 恢复函数（幂等）
+ */
+export function patchMethod<T extends object, K extends keyof T>(
+  owner: T,
+  key: K,
+  wrapper: (original: T[K], ...args: never[]) => unknown,
+): () => void {
+  const original = owner[key]
+  const patched = ((...args: never[]) => wrapper(original, ...args)) as T[K]
+  owner[key] = patched
+  return () => {
+    if (owner[key] === patched) owner[key] = original
+  }
+}

package/src/client/fileOpeners.ts

@@ -2,11 +2,12 @@
  * dsh-vscode-mode client — 文件打开器注册表与自动选择。
  * @author ddj 2026年08月24号
  */
+import { SIDEBAR_PLUGIN } from './compat.js'
 
 export const AUTO_OPEN_TOOL = 'auto'
 export const SYSTEM_OPEN_TOOL = 'system'
 export const VSCODE_OPEN_TOOL = 'dsh-vscode-mode'
-export const SIDEBAR_OPEN_TOOL = 'dsh-better-sidebar'
+export const SIDEBAR_OPEN_TOOL = SIDEBAR_PLUGIN
 
 export interface FileOpenContext {
   sessionId?: string

package/src/client/index.ts

@@ -20,7 +20,9 @@ import { rpc } from './rpc.js'
 import { createFileOpenerRegistry, scanSidebar, type FileOpenContext } from './fileOpeners.js'
 import type { FileOpenerRegistry } from './fileOpeners.js'
 import { installOpenPathRouter, vscodeOpener, autoValue } from './openPathRouter.js'
-import { SettingsContext, getSettingsScope } from './settingsContext.js'
+import { SettingsContext } from './settingsContext.js'
+import { SIDEBAR_PLUGIN, pickSettingsBinder, registerSlotSafely } from './compat.js'
+import type { CompatAdapter } from '../shared/compat.js'
 
 export const inject = ['slots', 'timer', 'locale', 'connection', 'remote', 'workspaces', 'sessions', 'settingsScope', 'webUiSettings']
 
@@ -36,9 +38,17 @@ export function apply(ctx: any): void {
   const workspaces = ctx.get('workspaces')
   const sessions = ctx.get('sessions')
   const originalOpenPath = workspaces?.openPath
-  const settings = getSettingsScope(ctx)
+  const binder = pickSettingsBinder(ctx)
+  const settings = binder.scope
   let selected = autoValue('auto')
 
+  /** 客户端侧兼容摘要（与 host 报告合并展示；惰性求值保证 HMR 后仍新鲜）。 */
+  const compatSummary = (): CompatAdapter[] => [
+    { name: '设置桥', active: settings !== undefined, note: settings !== undefined ? '使用 ' + binder.service + ' 桥' : '未绑定设置服务（fileOpenTool 持久化不可用）' },
+    { name: '文件打开路由（workspaces.openPath）', active: Boolean(workspaces?.openPath), note: 'vscode 打开器优先，失败回退系统打开' },
+    { name: '侧边栏打开器（' + SIDEBAR_PLUGIN + '）', active: registry.get(SIDEBAR_PLUGIN) !== undefined, note: registry.get(SIDEBAR_PLUGIN) !== undefined ? '已注册（优先级 80）' : '未检测到侧边栏打开能力' },
+  ]
+
   ctx.provide('fileOpeners', registry)
   ctx.effect(() => registry.register(vscodeOpener()), 'vscode-mode: file opener')
   ctx.effect(() => registry.register({
@@ -76,25 +86,23 @@ export function apply(ctx: any): void {
   }
 
   // 中央「文件编辑」页签：类 VSCode 编辑器（顶部=文件页签+搜索框，差异 UI=文件底部圆角悬浮框）
-  ctx.slots.inject('conversation.view', () => ctx.slots.register({
+  registerSlotSafely(ctx, {
     name: 'conversation.view',
     id: 'edrv-editor',
     order: 5,
     label: '文件编辑',
     inject: (sessionId: string) => ({ sessionId }),
-  }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { schedule }))))
+  }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { schedule })))
 
   // header 差异角标：仅当前工作区存在差异时渲染
-  ctx.slots.inject('conversation.session.header.utilities', () => ctx.slots.register(
-    { name: 'conversation.session.header.utilities', id: 'edrv-diff-badge', order: 90, label: '差异' },
-    (props: unknown) => React.createElement(DiffBadge, Object.assign({}, props)),
-  ))
+  registerSlotSafely(ctx, { name: 'conversation.session.header.utilities', id: 'edrv-diff-badge', order: 90, label: '差异' },
+    (props: unknown) => React.createElement(DiffBadge, Object.assign({}, props)))
 
   // 设置页中的 VSCodeMode 专属页签，MCP 管理作为该页签的内部子 Tab。
-  ctx.slots.inject('settings.section', () => ctx.slots.register({
+  registerSlotSafely(ctx, {
     name: 'settings.section',
     id: 'vscode-mode',
     order: 30,
     label: 'VSCodeMode',
-  }, () => React.createElement(SettingsContext.Provider, { value: settings }, React.createElement(McpSettings, { openerRegistry: registry }))))
+  }, () => React.createElement(SettingsContext.Provider, { value: settings }, React.createElement(McpSettings, { openerRegistry: registry, compatSummary })))
 }

package/src/client/openPathRouter.ts

@@ -1,7 +1,9 @@
 /**
  * dsh-vscode-mode client — DSH 对话文件链接的统一打开路由。
- * @author ddj 2026年08月24号
+ * openPath 补丁经 compat.patchMethod 安装（链式恢复，多插件补丁互不踩踏）。
+ * 作者 ddj 2026年08月24号
  */
+import { patchMethod } from './compat.js'
 import { openEditorView } from './events.js'
 import { AUTO_OPEN_TOOL, VSCODE_OPEN_TOOL, type FileOpenContext, type FileOpenerRegistry, isAvailable, selectOpener } from './fileOpeners.js'
 
@@ -20,8 +22,7 @@ export interface OpenPathRouterOptions {
  * @returns 恢复原方法的 disposer
  */
 export function installOpenPathRouter(options: OpenPathRouterOptions): () => void {
-  const original = options.workspaces.openPath
-  const open = async (path: string): Promise<void> => {
+  const open = async (original: (path: string) => Promise<void>, path: string): Promise<void> => {
     const context = options.context()
     const opener = selectOpener(options.registry, options.selected())
     if (!opener || !isAvailable(opener)) return original.call(options.workspaces, path)
@@ -33,8 +34,7 @@ export function installOpenPathRouter(options: OpenPathRouterOptions): () => voi
       else throw error
     }
   }
-  options.workspaces.openPath = open
-  return () => { options.workspaces.openPath = original }
+  return patchMethod(options.workspaces, 'openPath', open as never)
 }
 
 /**

package/src/client/settingsContext.ts

@@ -1,31 +1,21 @@
 /**
  * dsh-vscode-mode client — 设置 scope 的跨组件上下文。
- * @author ddj 2026年08月24号
+ * 绑定逻辑（webUiSettings 兼容桥 → 官方 settingsScope 降级）统一由 compat 层提供。
+ * 作者 ddj 2026年08月24号
  */
 import React from 'react'
+import { pickSettingsBinder, type SettingsScopeLike } from './compat.js'
 
-export interface SettingsScopeLike {
-  getSnapshot: () => { status?: string; value?: { fileOpenTool?: unknown }; writable?: boolean }
-  subscribe: (listener: () => void) => () => void
-  set: (field: string, value: unknown) => Promise<void>
-}
+export type { SettingsScopeLike }
 
 export const SettingsContext = React.createContext<SettingsScopeLike | undefined>(undefined)
 
 /**
- * 从 Cordis 服务绑定 VSCodeMode 设置 scope。
- * @author ddj 2026年08月24号
- * @param ctx 客户端上下文
- * @returns 设置 scope 或 undefined
- */
-/**
- * 绑定官方设置 scope，优先使用 web-ui 兼容桥。
+ * 从 Cordis 服务绑定 VSCodeMode 设置 scope（兼容桥优先，官方次之）。
  * @author ddj 2026年08月24号
  * @param ctx 客户端服务上下文
- * @returns 设置 scope；未安装设置服务时返回 undefined
+ * @returns 设置 scope 或 undefined
  */
 export function getSettingsScope(ctx: { get: (name: string) => unknown }): SettingsScopeLike | undefined {
-  const service = ctx.get('webUiSettings') ?? ctx.get('settingsScope')
-  const binder = service as { bind?: (spec: { namespace: string }) => SettingsScopeLike } | undefined
-  return binder?.bind?.({ namespace: 'dsh-vscode-mode' })
+  return pickSettingsBinder(ctx).scope
 }

package/src/client/styles/mcp.css

@@ -93,3 +93,20 @@
 .vsm-mcp-dialog-actions{display:flex;justify-content:flex-end;gap:10px;margin-top:20px}
 .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}
 .vsm-mcp-dialog-actions button:hover{background:var(--dsw-alias-interactive-bg-hover,#ffffff14)}
+
+/* 兼容性小节 */
+.vsm-compat-h3{margin:16px 0 2px;font-size:14px;font-weight:600;color:var(--dsw-alias-label-secondary,#c8c8c8)}
+.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)}
+.vsm-compat-item.ok .vsm-compat-name::before{content:"● ";color:var(--dsw-alias-state-success-primary,#38bd75)}
+.vsm-compat-item.warn .vsm-compat-name::before{content:"● ";color:var(--dsw-alias-state-warn-primary,#e5b93f)}
+.vsm-compat-name{font-weight:500;min-width:0}
+.vsm-compat-note{color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:12px;text-align:right;min-width:0}
+
+/* 开发形态开关 */
+.vsm-devform-note{display:block;margin-top:4px;font-size:11px;color:var(--dsw-alias-label-tertiary,#9aa5b1);word-break:break-all}
+.vsm-devform-actions{display:flex;flex-direction:column;align-items:flex-end;gap:6px;min-width:0}
+.vsm-devform-msg{color:var(--dsw-alias-state-warn-primary,#e5b93f);font-size:11px;text-align:right}
+.vsm-general-row button{border:1px solid var(--dsw-alias-border-l2,#555);border-radius:6px;padding:6px 12px;background:none;color:var(--dsw-alias-label-primary,#eee);cursor:pointer;font-size:12px;white-space:nowrap}
+.vsm-general-row button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover,#ffffff14)}
+.vsm-general-row button:disabled{opacity:.55;cursor:default}
+.vsm-general-row button.vsm-devform-close{color:var(--dsw-alias-state-error-primary,#f07878);border-color:var(--dsw-alias-state-error-secondary,#d9534f55)}

package/src/client/ui/McpSettings.ts

@@ -119,11 +119,14 @@ function ProjectGroup({ project, busy, onAdd, onRefresh, onToggle, onRemove }) {
   return React.createElement('section', { className: 'vsm-project' }, head, body)
 }
 
-/** 通用设置：选择当前对话文件链接的打开器。 */
+/** 通用设置：选择当前对话文件链接的打开器 + 开发形态开关。 */
 function GeneralSettings({ registry }) {
   const [tool, setTool] = React.useState(AUTO_OPEN_TOOL)
   const [busy, setBusy] = React.useState(false)
   const [error, setError] = React.useState('')
+  const [devForm, setDevForm] = React.useState(null)
+  const [devBusy, setDevBusy] = React.useState(false)
+  const [devMessage, setDevMessage] = React.useState('')
   const settings = React.useContext(SettingsContext)
   const snapshot = settings?.getSnapshot?.()
   const loading = !snapshot || snapshot.status === 'loading'
@@ -137,25 +140,87 @@ function GeneralSettings({ registry }) {
     onChange()
     return settings?.subscribe?.(onChange)
   }, [settings])
+  React.useEffect(() => {
+    rpc('vscode.devFormGet', {}).then((result) => {
+      if (result.ok) setDevForm(result.devForm)
+    }).catch(() => { /* 开发形态查询失败静默 */ })
+  }, [])
   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 closeDevForm = () => {
+    if (!window.confirm('关闭开发形态：插件将切换为正式版安装（版本依赖 + 删除工作区链接），pnpm 装配后需重启 DSH 生效。确认关闭？')) return
+    setDevBusy(true)
+    setDevMessage('')
+    rpc('vscode.devFormSet', { enabled: false }).then((result) => {
+      if (!result.ok) { setDevMessage('关闭失败：' + String(result.error)); return }
+      setDevForm(result.devForm)
+      setDevMessage(result.restart ? '已切换为正式版，重启 DSH 后生效。' : '已关闭开发形态。')
+    }).catch((e) => setDevMessage('关闭失败：' + String(e))).finally(() => setDevBusy(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
+  const devFormRow = devForm?.enabled ? React.createElement('div', { className: 'vsm-general-row' },
+    React.createElement('span', null, '开发形态', React.createElement('small', { className: 'vsm-devform-note' }, '工作区链接安装：' + devForm.path)),
+    React.createElement('div', { className: 'vsm-devform-actions' },
+      devMessage && React.createElement('small', { className: 'vsm-devform-msg' }, devMessage),
+      React.createElement('button', { className: 'vsm-devform-close', disabled: devBusy, onClick: closeDevForm }, devBusy ? '切换中…' : '关闭开发形态'),
+    ),
+  ) : null
   return React.createElement('section', { className: 'vsm-general-page' },
     React.createElement('h2', null, '通用'),
     React.createElement('p', null, '配置 DSH 对话中文件链接的打开工具。工具由当前运行时自动扫描。'),
     unavailable && React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, '设置服务暂不可用，当前使用自动选择。'),
     error && React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, error),
     React.createElement('label', { className: 'vsm-general-row' }, React.createElement('span', null, '文件链接使用工具'), React.createElement('select', { value: currentOption, disabled: loading || unavailable || notReady || busy || snapshot?.writable === false, onChange: (event) => save(event.target.value) }, options.map((item) => React.createElement('option', { key: item.id, value: item.id }, item.label))), loading && React.createElement('small', null, '读取中…')),
+    devFormRow,
+  )
+}
+
+/** 兼容性小节：host 报告（RPC compat）+ 客户端本地适配项。 */
+function CompatSection({ getSummary }) {
+  const [report, setReport] = React.useState(null)
+  const [error, setError] = React.useState('')
+  React.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.createElement('div', { key: item.name, className: 'vsm-compat-item ' + (item.active ? 'ok' : 'warn') },
+    React.createElement('span', { className: 'vsm-compat-name' }, item.name),
+    React.createElement('span', { className: 'vsm-compat-note' }, item.note ?? (item.active ? '正常' : '未生效')),
+  ))
+  const warnings = report?.warnings ?? []
+  const devForm = report?.devForm
+  return React.createElement('section', { className: 'vsm-general-page' },
+    React.createElement('h2', null, '兼容性'),
+    React.createElement('p', null, '检测与其他插件 / DSH 版本的适配状态与已知问题。' + (report?.pluginVersion ? '（插件版本 ' + report.pluginVersion + '）' : '')),
+    error && React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, error),
+    devForm?.enabled && React.createElement(React.Fragment, null,
+      React.createElement('h3', { className: 'vsm-compat-h3' }, '开发形态'),
+      React.createElement('div', { className: 'vsm-compat-item ok' }, React.createElement('span', { className: 'vsm-compat-name' }, '开发形态开启（工作区链接安装）'), React.createElement('span', { className: 'vsm-compat-note' }, devForm.path)),
+    ),
+    React.createElement('h3', { className: 'vsm-compat-h3' }, '外部插件与服务'),
+    renderItems(report?.external),
+    React.createElement('h3', { className: 'vsm-compat-h3' }, '客户端适配'),
+    renderItems(getSummary?.() ?? []),
+    React.createElement('h3', { className: 'vsm-compat-h3' }, '护栏'),
+    renderItems(report?.guards),
+    React.createElement('h3', { className: 'vsm-compat-h3' }, '警告'),
+    warnings.length ? warnings.map((w, index) => React.createElement('div', { key: index, className: 'vsm-mcp-error vsm-mcp-banner' }, w)) : React.createElement('div', { className: 'vsm-compat-item ok' }, React.createElement('span', { className: 'vsm-compat-name' }, '未检测到兼容性问题'), React.createElement('span', { className: 'vsm-compat-note' }, '')),
   )
 }
 
 /** MCP 管理主面板。 */
 export function McpSettings(props) {
   const openerRegistry = props?.openerRegistry ?? { list: () => [] }
+  const compatSummary = props?.compatSummary ?? (() => [])
   const [servers, setServers] = React.useState<MpcServer[]>([])
   const [projects, setProjects] = React.useState<MpcProject[]>([])
   const [loading, setLoading] = React.useState(true)
@@ -252,11 +317,12 @@ export function McpSettings(props) {
   else if (tab === 'general') body = React.createElement(GeneralSettings, { registry: openerRegistry })
   else if (tab === 'mine') body = React.createElement('div', null, servers.length ? servers.map((s) => React.createElement(ServerCard, { key: s.id, server: s, onRefresh: refreshGlobal, onToggle: toggleGlobal, onRemove: removeGlobal })) : React.createElement('div', { className: 'vsm-mcp-empty' }, '还没有配置全局 MCP'))
   else if (tab === 'projects') body = projectBody
+  else if (tab === 'compat') body = React.createElement(CompatSection, { getSummary: compatSummary })
   else body = marketBody
   const form = showForm ? React.createElement(McpForm, { title: '添加全局 MCP', draft, busy, edit, save: saveGlobal, close: () => setShowForm(false) }) : projectForm ? React.createElement(McpForm, { title: '添加项目 MCP · ' + projectForm.title, draft, busy, edit, save: saveProject, close: () => setProjectForm(null) }) : null
   return React.createElement('section', { className: 'vsm-mcp-page' },
     React.createElement('header', { className: 'vsm-mcp-header' }, React.createElement('div', null, React.createElement('h2', null, 'VSCodeMode'), React.createElement('p', null, '管理当前 profile 与各项目的 Model Context Protocol 服务。')), React.createElement('button', { className: 'vsm-primary', onClick: () => { setDraft(EMPTY); setShowForm(true) } }, '+ 添加全局 MCP')),
-    React.createElement('nav', { className: 'vsm-mcp-tabs' }, React.createElement('button', { className: tab === 'general' ? 'active' : '', onClick: () => setTab('general') }, '通用'), React.createElement('button', { className: tab === 'mine' ? 'active' : '', onClick: () => setTab('mine') }, '我的 MCP'), React.createElement('button', { className: tab === 'projects' ? 'active' : '', onClick: () => setTab('projects') }, '项目 MCP'), React.createElement('button', { className: tab === 'market' ? 'active' : '', onClick: () => setTab('market') }, 'MCP 市场')),
+    React.createElement('nav', { className: 'vsm-mcp-tabs' }, React.createElement('button', { className: tab === 'general' ? 'active' : '', onClick: () => setTab('general') }, '通用'), React.createElement('button', { className: tab === 'mine' ? 'active' : '', onClick: () => setTab('mine') }, '我的 MCP'), React.createElement('button', { className: tab === 'projects' ? 'active' : '', onClick: () => setTab('projects') }, '项目 MCP'), React.createElement('button', { className: tab === 'market' ? 'active' : '', onClick: () => setTab('market') }, 'MCP 市场'), React.createElement('button', { className: tab === 'compat' ? 'active' : '', onClick: () => setTab('compat') }, '兼容性')),
     error && React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, error),
     body,
     form,

package/src/compat.ts

@@ -0,0 +1,147 @@
+/**
+ * dsh-vscode-mode host — 兼容层：与其他插件 / DSH 版本的统一探测、适配、护栏与自诊断。
+ * 职责：身份常量（包名 / MCP 条目前缀 / 路由前缀）、外部插件探测、路由冲突与重复装配检测、
+ *       兼容性报告构建（RPC edrv.compat 与启动日志共用）。
+ * 注意：与 mcp.ts 存在模块环（compat 提供身份常量、mcp 提供 entriesOf），
+ *       双方仅在函数体内交叉使用导出，模块求值期无依赖，ESM 安全。
+ * 作者 ddj 2026-08-24
+ */
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { entriesOf } from './mcp.js'
+import { loadSettingsDeps } from './fileOpenSettings.js'
+import { readDevForm } from './devForm.js'
+import type { CompatAdapter, CompatReport } from './shared/compat.js'
+import type { Ctx } from './store.js'
+
+export const PLUGIN_NAME = 'dsh-vscode-mode'
+export const MCP_PACKAGE = '@deepseek-ai/dsh-mcp-client'
+/** 项目级 MCP 的 loader entry id 固定前缀（区分 profile 全局 MCP；loader id 不能用 ':'，故用 '.'）。 */
+export const PROJECT_ENTRY_PREFIX = 'vsm-mcp.'
+/** 旧版项目 MCP 条目前缀（升级残留识别，不显示为全局 MCP）。 */
+export const LEGACY_PROJECT_PREFIX = 'vsm-mcp:'
+/** webServer 路由前缀（RPC 精确路由 + 静态资源前缀共用）。 */
+export const ROUTE_PREFIX = '/edrv'
+
+/** 判断新旧格式项目 MCP 条目 id（旧残留不被视为全局 MCP）。 */
+export function isProjectEntryId(id: string): boolean {
+  return id.startsWith(PROJECT_ENTRY_PREFIX) || id.startsWith(LEGACY_PROJECT_PREFIX)
+}
+
+/** 从项目条目 id 解析 workspace hash（新旧格式通用）。 */
+export function entryHash(id: string): string | undefined {
+  if (id.startsWith(PROJECT_ENTRY_PREFIX)) return id.slice(PROJECT_ENTRY_PREFIX.length).split('.')[0]
+  if (id.startsWith(LEGACY_PROJECT_PREFIX)) return id.slice(LEGACY_PROJECT_PREFIX.length).split(':')[0]
+  return undefined
+}
+
+/** 读取随包 package.json 版本号（缺失/解析失败降级为空串）。 */
+export function pluginVersionOf(): string {
+  try {
+    const file = join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json')
+    const pkg = JSON.parse(readFileSync(file, 'utf8')) as { version?: unknown }
+    return typeof pkg.version === 'string' ? pkg.version : ''
+  } catch {
+    return ''
+  }
+}
+
+/** 探测外部插件/服务适配状态（depsAvailable 由调用方注入，便于测试）。 */
+export function detectExternal(ctx: Ctx, depsAvailable: boolean): CompatAdapter[] {
+  const mcpCount = entriesOf(ctx).length
+  const settings = ctx.get('settings') as { describe?: unknown; update?: unknown } | undefined
+  const hasSettings = Boolean(settings?.describe || settings?.update)
+  return [
+    { name: MCP_PACKAGE, active: mcpCount > 0, note: mcpCount > 0 ? mcpCount + ' 个 MCP 服务条目' : '未检测到 MCP 条目（MCP 管理页显示为空）' },
+    { name: '设置持久化（@deepseek-ai/dsh-settings）', active: depsAvailable, note: depsAvailable ? '设置 section 已安装' : '未安装：fileOpenTool 持久化降级为配置值' },
+    { name: 'settings 服务', active: hasSettings, note: hasSettings ? '可读写设置' : '不可用（设置读写走配置回退）' },
+  ]
+}
+
+/** 本插件已注册的路由（kind → path 集合），冲突检测时排除自身，避免自误报。 */
+const ownRoutes = { exact: new Set<string>(), prefixes: new Set<string>() }
+
+/** 清空本插件路由记录（registerRoutes 装配开始时调用，热重载不残留）。 */
+export function resetOwnRoutes(): void {
+  ownRoutes.exact.clear()
+  ownRoutes.prefixes.clear()
+}
+
+/** 记录本插件路由（routes.ts 注册成功时调用）。 */
+export function noteOwnRoute(kind: 'exact' | 'prefix', path: string): void {
+  const table = kind === 'exact' ? ownRoutes.exact : ownRoutes.prefixes
+  table.add(path)
+}
+
+/** 检测路由前缀占用与重叠（排除本插件自有路由；内部表不可读视为无冲突）。 */
+export function routeConflict(web: unknown, prefix: string): string | null {
+  try {
+    const w = web as { exact?: Map<unknown, unknown>; prefixes?: Map<unknown, unknown> } | undefined
+    const exact = w?.exact
+    const prefixes = w?.prefixes
+    if (exact instanceof Map) {
+      for (const path of exact.keys()) {
+        const other = String(path)
+        if (other.startsWith(prefix + '/') && !ownRoutes.exact.has(other)) {
+          return '精确路由 ' + other + ' 与 ' + prefix + ' 前缀重叠（可能来自热重载残留或其他插件）'
+        }
+      }
+    }
+    if (prefixes instanceof Map) {
+      for (const path of prefixes.keys()) {
+        const other = String(path)
+        if (other !== prefix && (other.startsWith(prefix + '/') || prefix.startsWith(other + '/')) && !ownRoutes.prefixes.has(other)) {
+          return '路由前缀 ' + prefix + ' 与 ' + other + ' 重叠'
+        }
+      }
+    }
+  } catch {
+    /* 内部表不可读时放弃检查 */
+  }
+  return null
+}
+
+/** 检测本插件是否被重复装配（bundle 层 + 用户层重复 insert 的自诊断）。 */
+export function duplicateEntries(ctx: Ctx): string[] {
+  const loader = ctx.get('loader') as { entries?: () => Iterable<{ id?: unknown; options?: { name?: unknown } }> } | undefined
+  if (!loader || typeof loader.entries !== 'function') return []
+  const own = [...loader.entries()].filter((entry) => String(entry.options?.name ?? entry.id ?? '') === PLUGIN_NAME)
+  if (own.length > 1) {
+    return ['检测到 ' + own.length + ' 个 ' + PLUGIN_NAME + ' loader 条目（重复装配）。请删除 profile 用户层 cordis.patch.yml 的重复 insert（或运行 dev_fix_patch 清理）']
+  }
+  return []
+}
+
+/** 护栏适配状态：路由前缀唯一性 + 插件装配唯一性。 */
+export function detectGuards(ctx: Ctx): CompatAdapter[] {
+  const web = ctx.get('webServer')
+  const conflict = web ? routeConflict(web, ROUTE_PREFIX) : null
+  const duplicates = duplicateEntries(ctx)
+  return [
+    { name: '路由前缀 ' + ROUTE_PREFIX, active: !conflict, note: conflict ?? '无冲突' },
+    { name: '插件装配唯一性', active: duplicates.length === 0, note: duplicates[0] ?? '唯一装配' },
+  ]
+}
+
+/**
+ * 构建完整兼容性报告（RPC 与启动日志共用）。
+ * @author ddj 2026年08月24号
+ * @param ctx DSH host 上下文
+ * @param options 测试注入：depsAvailable 跳过动态导入、version 固定版本号
+ * @returns 兼容性报告
+ */
+export async function buildReport(
+  ctx: Ctx,
+  options?: { depsAvailable?: boolean; version?: string },
+): Promise<CompatReport> {
+  const deps = options?.depsAvailable ?? (await loadSettingsDeps()) !== null
+  const external = detectExternal(ctx, deps)
+  const guards = detectGuards(ctx)
+  const warnings: string[] = []
+  if (!deps) warnings.push('未安装 @deepseek-ai/dsh-settings：文件打开工具设置持久化不可用（降级为配置值）')
+  for (const guard of guards) {
+    if (!guard.active && guard.note) warnings.push(guard.note)
+  }
+  return { pluginVersion: options?.version ?? pluginVersionOf(), external, guards, warnings, devForm: readDevForm() }
+}