dsh-vscode-mode 0.1.15 → 0.1.16

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

@@ -27,6 +27,7 @@ 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>>()
@@ -322,6 +323,7 @@ export function buildHandlers(ctx: Ctx, registry: Registry, searcher = newSearch
       } catch (error) { return { ok: false, error: String(error) }
       }
     },
+    'compat': async () => ({ ok: true, report: await buildReport(ctx) }),
   }
 }
 

package/src/shared/compat.ts

@@ -0,0 +1,20 @@
+/**
+ * dsh-vscode-mode 兼容层双面契约 — 与其他插件 / DSH 版本的探测与自诊断报告。
+ * Purity rule: no node/react imports (same as types.ts / rpc.ts)。
+ * 作者 ddj 2026-08-24
+ */
+
+/** 单项适配状态：外部插件/服务或护栏项，active 表示健康/生效。 */
+export interface CompatAdapter {
+  name: string
+  active: boolean
+  note?: string
+}
+
+/** 兼容性报告：host 侧构建（RPC edrv.compat 返回），client 侧补充本地适配项后展示。 */
+export interface CompatReport {
+  pluginVersion: string
+  external: CompatAdapter[]
+  guards: CompatAdapter[]
+  warnings: string[]
+}

package/src/shared/rpc.ts

@@ -13,6 +13,7 @@ import type {
   StaleHunk,
 } from './types.js'
 import type { MpcConfig, MpcProject, MpcProjectSaveInput, MpcServer } from './mcp.js'
+import type { CompatReport } from './compat.js'
 
 /** webServer 精确路由。 */
 export const RPC_PATH = '/edrv/rpc'
@@ -45,6 +46,7 @@ export interface RpcRequestMap {
   'mcp.projectRefresh': { workspacePath: string; serverName: string }
   'vscode.fileOpenSettingsGet': {}
   'vscode.fileOpenSettingsUpdate': { fileOpenTool: string; expectedRevision?: number }
+  'compat': {}
 }
 
 export type RpcMethod = keyof RpcRequestMap
@@ -74,6 +76,7 @@ export interface RpcOkMap {
   'mcp.projectRefresh': { project: MpcProject }
   'vscode.fileOpenSettingsGet': { fileOpenTool: string; revision?: number }
   'vscode.fileOpenSettingsUpdate': { fileOpenTool: string; revision?: number }
+  'compat': { report: CompatReport }
 }
 
 /** 统一响应：{ok:true, ...payload} 或 {ok:false, error}。 */