dsh-vscode-mode 0.1.14 → 0.1.16

package/src/client/ui/McpSettings.ts

@@ -8,6 +8,8 @@ import React from 'react'
 import { rpc } from '../rpc.js'
 import type { MpcProject, MpcServer } from '../../shared/mcp.js'
 import '../styles/mcp.css'
+import { availableOpeners, AUTO_OPEN_TOOL } from '../fileOpeners.js'
+import { SettingsContext } from '../settingsContext.js'
 
 const EMPTY = { serverName: '', transport: 'stdio', command: '', args: '', cwd: '', url: '', headers: '' }
 
@@ -117,14 +119,83 @@ 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 settings = React.useContext(SettingsContext)
+  const snapshot = settings?.getSnapshot?.()
+  const loading = !snapshot || snapshot.status === 'loading'
+  const unavailable = snapshot?.status === 'unavailable' || !settings
+  const notReady = snapshot?.status !== 'ready'
+  React.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.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, '读取中…')),
+  )
+}
+
+/** 兼容性小节：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 ?? []
+  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),
+    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() {
+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)
   const [busy, setBusy] = React.useState('')
   const [error, setError] = React.useState('')
-  const [tab, setTab] = React.useState('mine')
+  const [tab, setTab] = React.useState('general')
   const [draft, setDraft] = React.useState(EMPTY)
   const [showForm, setShowForm] = React.useState(false)
   const [projectForm, setProjectForm] = React.useState(null)
@@ -212,13 +283,15 @@ export function McpSettings() {
   ) : React.createElement('div', { className: 'vsm-mcp-empty' }, '还没有项目')
   let body
   if (loading) body = React.createElement('div', { className: 'vsm-mcp-empty' }, '正在读取 MCP 服务…')
+  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 === '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,146 @@
+/**
+ * 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 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 版本号（缺失/解析失败降级为空串）。 */
+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 }
+}

package/src/fileOpenSettings.ts

@@ -0,0 +1,124 @@
+/**
+ * dsh-vscode-mode host — 文件链接打开工具的持久化设置。
+ * 依赖守卫：@deepseek-ai/dsh-settings / schemastery 以动态加载引入，
+ * 缺失时插件仍可加载（fileOpenTool 降级为配置值，compat 报告可见）。
+ * 作者 ddj 2026年08月24号
+ */
+import type { Ctx } from './store.js'
+
+export const FILE_OPEN_SETTINGS_NS = 'dsh-vscode-mode'
+export const FILE_OPEN_DEFAULT = 'auto'
+export interface FileOpenSettings { fileOpenTool: string }
+export interface FileOpenSettingsState { value: string; revision?: number; update: (value: string, expectedRevision?: number) => Promise<void> }
+
+type SettingsProvider = {
+  update?: (ns: string, patch: object, expectedRevision?: number) => Promise<void>
+  describe?: (options?: unknown) => Array<{ ns?: string; value?: unknown; revision?: number }>
+  get?: (ns: string) => unknown
+}
+
+/** 动态依赖的装载结果（宽松类型：dsh-settings 无本地类型声明）。 */
+export interface SettingsDeps {
+  installSettingsSection: (ctx: Ctx, ns: string, schema: unknown, entry: object, hooks: object) => void
+  z: {
+    object: (shape: Record<string, unknown>) => unknown
+    string: () => { default: (value: string) => unknown }
+  }
+}
+
+export type SettingsDepsLoader = () => Promise<SettingsDeps | null>
+
+let depsPromise: Promise<SettingsDeps | null> | undefined
+
+/**
+ * 动态加载设置依赖（模块级缓存；任一缺失返回 null 而非抛错）。
+ * @author ddj 2026年08月24号
+ * @returns 设置依赖或 null
+ */
+export function loadSettingsDeps(): Promise<SettingsDeps | null> {
+  if (!depsPromise) {
+    depsPromise = Promise.all([import('@deepseek-ai/dsh-settings'), import('schemastery')])
+      .then(([dshSettings, schemastery]) => ({
+        installSettingsSection: (dshSettings as { installSettingsSection: SettingsDeps['installSettingsSection'] }).installSettingsSection,
+        z: (schemastery as { default: SettingsDeps['z'] }).default,
+      }))
+      .catch(() => null)
+  }
+  return depsPromise
+}
+
+function normalizeValue(value: unknown): string {
+  if (typeof value !== 'string' || value.trim() === '') return FILE_OPEN_DEFAULT
+  return value.trim()
+}
+
+function configValue(config: unknown): string {
+  return normalizeValue((config as { fileOpenTool?: unknown } | undefined)?.fileOpenTool)
+}
+
+/**
+ * 安装设置 section（动态依赖；缺失返回 false 不抛错）。
+ * @author ddj 2026年08月24号
+ * @param ctx DSH host 上下文
+ * @param ns 设置命名空间
+ * @param entry 初始设置值
+ * @param hooks 设置源绑定与变更回调
+ * @param loader 依赖装载器（测试注入）
+ * @returns 是否成功安装
+ */
+export async function installOpenSettingsSection(
+  ctx: Ctx,
+  ns: string,
+  entry: FileOpenSettings,
+  hooks: { setSource: (source: () => FileOpenSettings) => void; onChange: () => void },
+  loader: SettingsDepsLoader = loadSettingsDeps,
+): Promise<boolean> {
+  const deps = await loader()
+  if (!deps) return false
+  const schema = deps.z.object({ fileOpenTool: deps.z.string().default(FILE_OPEN_DEFAULT) })
+  deps.installSettingsSection(ctx, ns, schema, entry, hooks)
+  return true
+}
+
+/**
+ * 注册设置命名空间，并提供 host 侧的读取与更新状态。
+ * @author ddj 2026年08月24号
+ * @param ctx DSH host 上下文
+ * @param config 插件组合配置
+ * @param onChange 设置变化回调
+ * @returns 设置状态
+ */
+export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: string) => void): FileOpenSettingsState {
+  let current = configValue(config)
+  let revision: number | undefined
+  let provider: SettingsProvider | undefined
+  const notify = (value: unknown): void => { current = normalizeValue(value); onChange(current) }
+  const syncRevision = (): void => {
+    const descriptor = provider?.describe?.({ redactSecrets: true })?.find((item: { ns?: string }) => item.ns === FILE_OPEN_SETTINGS_NS)
+    revision = descriptor?.revision
+  }
+  const setSource = (source: () => FileOpenSettings): void => notify(source().fileOpenTool)
+  const settingsChange = (): void => syncRevision()
+
+  void installOpenSettingsSection(ctx, FILE_OPEN_SETTINGS_NS, { fileOpenTool: current }, { setSource, onChange: settingsChange })
+  ctx.inject?.(['settings'], (settingsCtx: Ctx) => {
+    provider = settingsCtx.get('settings')
+    syncRevision()
+  })
+
+  return {
+    get value() { return current },
+    get revision() { return revision },
+    update: async (value: string, expectedRevision?: number): Promise<void> => {
+      const next = normalizeValue(value)
+      if (!provider?.update) { notify(next); return }
+      await provider.update(FILE_OPEN_SETTINGS_NS, { fileOpenTool: next }, expectedRevision)
+      const descriptor = provider.describe?.({ redactSecrets: true })?.find((item: { ns?: string; value?: unknown }) => item.ns === FILE_OPEN_SETTINGS_NS)
+      const stored = descriptor?.value as { fileOpenTool?: unknown } | undefined
+      notify(stored?.fileOpenTool ?? next)
+      syncRevision()
+    },
+  }
+}
+
+export function normalizeFileOpenTool(value: unknown): string { return normalizeValue(value) }

package/src/host-deps.d.ts

@@ -0,0 +1,14 @@
+declare module 'schemastery' {
+  const schema: any
+  export default schema
+}
+
+declare module '@deepseek-ai/dsh-settings' {
+  export function installSettingsSection(...args: any[]): void
+  export function settingsNamespace(value: string): string
+}
+
+declare module '@deepseek-ai/schemastery' {
+  const schema: any
+  export default schema
+}

package/src/index.ts

@@ -1,8 +1,9 @@
 /**
  * @dsh-external 生态 → dsh-vscode-mode：DSH 上的类 VSCode 编码体验（Host 半入口）。
- * 职责：装配 capture（tools/result 捕获 edit/write 差异）、RPC 分发（11 个 edrv.* 方法）、
- *       webServer 路由（/edrv/rpc、/edrv/assets/*、/edrv/vendor/*）、工作区旁车持久化。
- * 结构：shared/（双面契约） + model/store/capture/workspace/revert/registry/rpc/routes（host 模块）。
+ * 职责：装配 capture（tools/result 捕获 edit/write 差异）、RPC 分发（edrv.* / mcp.* / vscode.* / compat）、
+ *       webServer 路由（/edrv/rpc、/edrv/assets/*、/edrv/vendor/*）、工作区旁车持久化、
+ *       兼容层装配（依赖守卫 + 重复装配自诊断 + 启动日志兼容性报告）。
+ * 结构：shared/（双面契约） + model/store/capture/workspace/revert/registry/rpc/routes/compat（host 模块）。
  * 作者 ddj 2026-08-20
  */
 import { registerRoutes } from './routes.js'
@@ -12,6 +13,8 @@ import { newSearcher } from './search/orchestrator.js'
 import { installIsolation } from './mcpIsolation.js'
 import { dropFileIndex } from './workspace.js'
 import { cwdOf } from './registry.js'
+import { setupOpenSettings } from './fileOpenSettings.js'
+import { PLUGIN_NAME, buildReport } from './compat.js'
 import type { Registry } from './registry.js'
 import type { Ctx } from './store.js'
 
@@ -19,7 +22,7 @@ export const name = "dsh-vscode-mode"
 export const inject = ['sessions', 'fs', 'webServer', 'loader', 'tools', 'workspaceRegistry', 'agents']
 
 /**
- * 装配插件：挂事件监听、注册路由。
+ * 装配插件：挂事件监听、注册路由、安装兼容层。
  * @author ddj 2026年08月20号
  * @param ctx DSH 上下文（sessions/fs/webServer 由 inject 提供；sandboxPolicy/subprocess 惰性获取）
  * @param config 插件配置（可选 imageDir 覆盖图标目录）
@@ -27,6 +30,9 @@ export const inject = ['sessions', 'fs', 'webServer', 'loader', 'tools', 'worksp
 export function apply(ctx: Ctx, config?: unknown): void {
   const registry: Registry = new Map()
   const searcher = newSearcher(ctx)
+  /** 兼容性警告收集（route 护栏等写入，启动日志一并输出）。 */
+  const warnings: string[] = []
+  setupOpenSettings(ctx, config, () => {})
 
   ctx.on('tools/result', (exec: unknown, result: unknown) => {
     void captureToolResult(ctx, registry, exec, result)
@@ -41,8 +47,32 @@ export function apply(ctx: Ctx, config?: unknown): void {
     }
   })
 
-  registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher))
+  registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher), (warning) => warnings.push(warning))
   installIsolation(ctx)
+  void logCompatSummary(ctx, warnings)
 
   ctx.logger?.info?.('[' + name + '] 编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用）')
 }
+
+/**
+ * 异步输出兼容性报告摘要（含重复装配/路由冲突自诊断）。
+ * @author ddj 2026年08月24号
+ * @param ctx DSH host 上下文
+ * @param warnings 装配期收集的兼容性警告
+ */
+async function logCompatSummary(ctx: Ctx, warnings: string[]): Promise<void> {
+  try {
+    const report = await buildReport(ctx)
+    for (const warning of warnings) report.warnings.push(warning)
+    const logger = ctx.logger
+    if (!logger?.info) return
+    const head = '[' + PLUGIN_NAME + '] 兼容性：' + report.external.length + ' 项外部适配 / ' + report.guards.length + ' 项护栏'
+    if (report.warnings.length) {
+      logger.warn?.(head + '，警告 ' + report.warnings.length + ' 条：' + report.warnings.join('；'))
+    } else {
+      logger.info?.(head + '，无警告')
+    }
+  } catch (error) {
+    ctx.logger?.warn?.('[' + PLUGIN_NAME + '] 兼容性报告生成失败：' + String(error))
+  }
+}

package/src/mcp.ts

@@ -1,20 +1,19 @@
 /**
  * dsh-vscode-mode host — MCP 运行时管理适配层。
  * 只操作已装配的 @deepseek-ai/dsh-mcp-client loader entry，不在浏览器侧连接 MCP。
+ * 身份常量（包名/条目前缀/新旧格式判定）统一由 compat 层持有，本模块再导出保持既有 import 面。
  * 作者 ddj 2026年08月22号
  */
+import {
+  LEGACY_PROJECT_PREFIX,
+  MCP_PACKAGE,
+  PROJECT_ENTRY_PREFIX,
+  isProjectEntryId,
+} from './compat.js'
 import type { MpcConfig, MpcServer, MpcTool } from './shared/mcp.js'
 import type { Ctx } from './store.js'
 
-const MCP_PACKAGE = '@deepseek-ai/dsh-mcp-client'
-/** 项目级 MCP 的 loader entry id 固定前缀（区分 profile 全局 MCP；注意 loader id 不能用 ':' 分隔，故用 '.'）。 */
-export const PROJECT_ENTRY_PREFIX = 'vsm-mcp.'
-const LEGACY_PROJECT_PREFIX = 'vsm-mcp:'
-
-/** 判断新旧格式项目 entry id，避免旧残留被显示为全局 MCP。 */
-export function isProjectEntryId(id: string): boolean {
-  return id.startsWith(PROJECT_ENTRY_PREFIX) || id.startsWith(LEGACY_PROJECT_PREFIX)
-}
+export { LEGACY_PROJECT_PREFIX, MCP_PACKAGE, PROJECT_ENTRY_PREFIX, isProjectEntryId }
 
 /** 列出当前 loader 中的 MCP entry。 */
 function entriesOf(ctx: Ctx): any[] {

package/src/mcpIsolation.ts

@@ -4,11 +4,11 @@
  * tools.restrict() 负责模型可见性，tools.guard() 负责执行层兜底拒绝。
  * 作者 ddj 2026年08月22号
  */
-import { PROJECT_ENTRY_PREFIX, entriesOf } from './mcp.js'
+import { LEGACY_PROJECT_PREFIX, entryHash, isProjectEntryId } from './compat.js'
+import { entriesOf } from './mcp.js'
 import { hashWorkspace } from './mcpProject.js'
 import type { Ctx } from './store.js'
 
-const LEGACY_PREFIX = 'vsm-mcp:'
 const UNKNOWN_PROJECT = '__unknown_project__'
 
 type ToolProjects = Map<string, string>
@@ -32,17 +32,11 @@ export function matchWorkspace(cwd: string | undefined, paths: string[]): string
   return matches[0]
 }
 
-/** 根据 entry id 判断是否为新旧格式项目 MCP。 */
-export function isProjectEntry(id: string): boolean {
-  return id.startsWith(PROJECT_ENTRY_PREFIX) || id.startsWith(LEGACY_PREFIX)
-}
+/** 根据 entry id 判断是否为新旧格式项目 MCP（兼容层统一判定）。 */
+export const isProjectEntry = isProjectEntryId
 
-/** 从项目 entry id 解析 workspace hash。 */
-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_PREFIX)) return id.slice(LEGACY_PREFIX.length).split(':')[0]
-  return undefined
-}
+/** 兼容：旧版前缀常量名（mcpIsolation 历史导出，语义不变）。 */
+export const LEGACY_PREFIX = LEGACY_PROJECT_PREFIX
 
 /** 返回一个 agent 不应继承的项目工具名。 */
 export function denyTools(toolProjects: ToolProjects, currentPath: string | undefined): string[] {

package/src/routes.ts

@@ -6,6 +6,7 @@
 import { readFile } from 'node:fs/promises'
 import { dirname, extname, join, normalize, resolve, sep } from 'node:path'
 import { fileURLToPath } from 'node:url'
+import { ROUTE_PREFIX, noteOwnRoute, resetOwnRoutes, routeConflict } from './compat.js'
 import { RPC_PATH } from './shared/rpc.js'
 import type { RpcMethod, RpcRequestMap } from './shared/rpc.js'
 import type { Ctx } from './store.js'
@@ -45,22 +46,40 @@ function imageDirOf(config: unknown): string {
 const vendorDir = join(dirname(fileURLToPath(import.meta.url)), '..', 'assets', 'vendor')
 
 /**
- * 注册全部 webServer 路由。
+ * 注册全部 webServer 路由（带兼容护栏：前缀冲突预警 + 注册失败降级跳过）。
  * @author ddj 2026年08月20号
  * @param ctx DSH 上下文
  * @param config 插件配置（可选 imageDir 等）
  * @param handleRpc RPC 分发入口（method,args → RpcResult）
+ * @param onWarning 兼容性警告收集（可选）
  */
 export function registerRoutes(
   ctx: Ctx,
   config: unknown,
   handleRpc: <M extends RpcMethod>(method: M, args: RpcRequestMap[M]) => Promise<unknown>,
+  onWarning?: (warning: string) => void,
 ): void {
   const imgDir = imageDirOf(config)
   const web = ctx.get('webServer')
   if (!web) return
 
-  ctx.effect(() => web.register({
+  resetOwnRoutes()
+  const conflict = routeConflict(web, ROUTE_PREFIX)
+  if (conflict) onWarning?.('兼容性：' + conflict)
+
+  /** 护栏注册：重复路由抛错时降级为警告并跳过，不让单条路由拖垮装配。 */
+  const guarded = (route: { kind: 'exact' | 'prefix'; path: string; handler?: unknown }, label: string): (() => void) | undefined => {
+    try {
+      const dispose = web.register(route)
+      noteOwnRoute(route.kind, route.path)
+      return dispose
+    } catch (error) {
+      onWarning?.('兼容性：' + label + ' 注册失败（' + String(error) + '）')
+      return undefined
+    }
+  }
+
+  ctx.effect(() => guarded({
     kind: 'exact',
     path: RPC_PATH,
     handler: async (req: unknown, res: { statusCode?: number; setHeader: (k: string, v: string) => void; end: (b?: string) => void }) => {
@@ -83,10 +102,10 @@ export function registerRoutes(
         res.end(JSON.stringify({ ok: false, error: String(error) }))
       }
     },
-  }), 'edrv: /edrv/rpc route')
+  }, '/edrv/rpc 精确路由'), 'edrv: routes')
 
   for (const r of IMG_ROUTES) {
-    ctx.effect(() => web.register({
+    ctx.effect(() => guarded({
       kind: 'exact',
       path: r.url,
       handler: async (req: unknown, res: { statusCode?: number; setHeader: (k: string, v: string) => void; end: (b?: string | Uint8Array) => void }) => {
@@ -101,11 +120,11 @@ export function registerRoutes(
           res.end()
         }
       },
-    }), 'edrv: static ' + r.file)
+    }, '静态资源 ' + r.file), 'edrv: routes')
   }
 
   // Monaco Editor AMD 构建：/edrv/vendor/* → assets/vendor/*（路径穿越防护 + 按扩展名 MIME）
-  ctx.effect(() => web.register({
+  ctx.effect(() => guarded({
     kind: 'prefix',
     path: VENDOR_PREFIX,
     handler: async (req: { method?: string; url?: string }, res: { statusCode?: number; setHeader: (k: string, v: string) => void; end: (b?: string | Uint8Array) => void }) => {
@@ -134,5 +153,5 @@ export function registerRoutes(
         res.end()
       }
     },
-  }), 'edrv: /edrv/vendor prefix')
+  }, '/edrv/vendor 前缀路由'), 'edrv: routes')
 }

package/src/rpc.ts

@@ -26,6 +26,8 @@ import { newSearcher } from './search/orchestrator.js'
 import { restoreFile, revertCall, revertHunk } from './revert.js'
 import { listMcp, refreshMcp, removeMcp, saveMcp, toggleMcp } from './mcp.js'
 import { listProjects, projectRefresh, projectRemove, projectSave, projectToggle } from './mcpProject.js'
+import { normalizeFileOpenTool, FILE_OPEN_DEFAULT, FILE_OPEN_SETTINGS_NS } from './fileOpenSettings.js'
+import { buildReport } from './compat.js'
 
 /** cwd → Promise 链：串行化 debug 日志追加（fs read+write 非原子，避免并发丢行）。 */
 const debugWriteQueues = new Map<string, Promise<void>>()
@@ -304,6 +306,24 @@ export function buildHandlers(ctx: Ctx, registry: Registry, searcher = newSearch
       try { return { ok: true, project: await projectRefresh(ctx, args.workspacePath, args.serverName) } }
       catch (error) { return { ok: false, error: String(error) } }
     },
+    'vscode.fileOpenSettingsGet': async () => {
+      const settings = ctx.get('settings')
+      const descriptor = settings?.describe?.({ redactSecrets: true })?.find((item: { ns?: string }) => item.ns === FILE_OPEN_SETTINGS_NS)
+      const value = descriptor?.value as { fileOpenTool?: unknown } | undefined
+      return { ok: true, fileOpenTool: normalizeFileOpenTool(value?.fileOpenTool ?? FILE_OPEN_DEFAULT), revision: descriptor?.revision }
+    },
+    'vscode.fileOpenSettingsUpdate': async (args) => {
+      const settings = ctx.get('settings')
+      if (!settings?.update) return { ok: false, error: '设置服务不可用' }
+      try {
+        await settings.update(FILE_OPEN_SETTINGS_NS, { fileOpenTool: normalizeFileOpenTool(args.fileOpenTool) }, args.expectedRevision)
+        const descriptor = settings.describe?.({ redactSecrets: true })?.find((item: { ns?: string }) => item.ns === FILE_OPEN_SETTINGS_NS)
+        const value = descriptor?.value as { fileOpenTool?: unknown } | undefined
+        return { ok: true, fileOpenTool: normalizeFileOpenTool(value?.fileOpenTool), revision: descriptor?.revision }
+      } catch (error) { return { ok: false, error: String(error) }
+      }
+    },
+    'compat': async () => ({ ok: true, report: await buildReport(ctx) }),
   }
 }