dsh-vscode-mode 0.1.15 → 0.1.17

package/src/devForm.ts

@@ -0,0 +1,133 @@
+/**
+ * dsh-vscode-mode host — 开发形态管理（安装形态切换）。
+ * 开发形态 = profile 中以 link: 依赖 + junction 指向工作区的安装（用于插件开发）；
+ * 关闭 = 改回版本依赖 + 删 junction + pnpm install 装配正式版。
+ * 切换后需重启 DSH 生效（运行中的代码仍是旧形态）。
+ * 与 compat.ts 存在模块环（devForm 用 pluginVersionOf、compat 用 readDevForm），
+ * 双方仅在函数体内交叉使用，模块求值期无依赖，ESM 安全。
+ * 作者 ddj 2026-08-24
+ */
+import { existsSync, readFileSync, readdirSync, rmSync, symlinkSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { homedir } from 'node:os'
+import { PLUGIN_NAME, pluginVersionOf } from './compat.js'
+import type { DevFormInfo } from './shared/compat.js'
+import type { Ctx } from './store.js'
+
+/** 扫描 $DSH_HOME/profiles 找到依赖本插件的 profile 目录（无 env 依赖，多 profile 安全）。 */
+export function findProfileDir(): string | undefined {
+  const home = process.env.DSH_HOME ?? join(homedir(), '.dsh')
+  try {
+    for (const name of readdirSync(join(home, 'profiles'))) {
+      const pkgFile = join(home, 'profiles', name, 'package.json')
+      if (!existsSync(pkgFile)) continue
+      try {
+        const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as { dependencies?: Record<string, unknown> } | undefined
+        if (pkg?.dependencies?.[PLUGIN_NAME]) return dirname(pkgFile)
+      } catch {
+        /* 坏 manifest 跳过该 profile */
+      }
+    }
+  } catch {
+    /* profiles 目录不存在时放弃 */
+  }
+  return undefined
+}
+
+/**
+ * 读取当前开发形态（manifest link: 判定）。
+ * @author ddj 2026年08月24号
+ * @returns 开发形态状态
+ */
+export function readDevForm(): DevFormInfo {
+  const profileDir = findProfileDir()
+  if (!profileDir) return { enabled: false }
+  try {
+    const text = readFileSync(join(profileDir, 'package.json'), 'utf8').replace(/^\uFEFF/, '')
+    const pkg = JSON.parse(text) as { dependencies?: Record<string, unknown> } | undefined
+    const spec = pkg?.dependencies?.[PLUGIN_NAME]
+    if (typeof spec === 'string' && spec.startsWith('link:')) {
+      return { enabled: true, path: spec.slice('link:'.length) }
+    }
+  } catch {
+    /* manifest 不可读视为非开发形态 */
+  }
+  return { enabled: false }
+}
+
+/**
+ * 规划切换后的 manifest 文本（纯函数，可单测；非法 JSON 抛错）。
+ * @author ddj 2026年08月24号
+ * @param text 原 manifest 文本
+ * @param enabled 目标形态（true=link:，false=版本）
+ * @param path 工作区路径（开启时必填）
+ * @param version 版本号（关闭时使用，写入 ^<version>）
+ * @returns 新 manifest 文本（无 BOM，2 空格缩进）
+ */
+export function planManifest(text: string, enabled: boolean, path: string, version: string): string {
+  const data = JSON.parse(text.replace(/^\uFEFF/, '')) as { dependencies?: Record<string, unknown> }
+  if (!data.dependencies || typeof data.dependencies !== 'object') {
+    throw new Error('profile package.json 缺少 dependencies 字段')
+  }
+  data.dependencies[PLUGIN_NAME] = enabled ? 'link:' + path.replace(/\\/g, '/') : '^' + version
+  return JSON.stringify(data, null, 2) + '\n'
+}
+
+/** 建立或移除 node_modules 下的开发 junction（目标不存在时开启失败）。 */
+function applyJunction(profileDir: string, enabled: boolean, target: string): void {
+  const linkDir = join(profileDir, 'node_modules', PLUGIN_NAME)
+  if (existsSync(linkDir)) rmSync(linkDir, { recursive: true, force: true })
+  if (!enabled) return
+  if (!existsSync(target)) throw new Error('工作区路径不存在：' + target)
+  symlinkSync(target, linkDir, 'junction')
+}
+
+/**
+ * 切换开发形态：改 manifest → 建/删 junction → pnpm install（subprocess）。
+ * @author ddj 2026年08月24号
+ * @param ctx DSH host 上下文（subprocess 服务）
+ * @param enabled 目标形态
+ * @param path 工作区绝对路径（开启时必填）
+ * @returns 切换结果（restart=true 表示需重启 DSH 生效）
+ */
+export async function setDevForm(ctx: Ctx, enabled: boolean, path?: string): Promise<{ ok: boolean; error?: string; restart: boolean }> {
+  const profileDir = findProfileDir()
+  if (!profileDir) return { ok: false, error: '未找到依赖本插件的 profile（检查 DSH_HOME/profiles）', restart: false }
+  const current = readDevForm()
+  const target = (path ?? current.path ?? '').replace(/\\/g, '/')
+  if (enabled && !target) return { ok: false, error: '开启开发形态需要提供工作区路径（path 参数）', restart: false }
+  if (enabled === current.enabled && (!enabled || target === current.path)) {
+    return { ok: true, restart: false }
+  }
+  try {
+    const pkgFile = join(profileDir, 'package.json')
+    const version = pluginVersionOf()
+    if (!version) return { ok: false, error: '读取插件版本失败，无法写入版本依赖', restart: false }
+    const next = planManifest(readFileSync(pkgFile, 'utf8').replace(/^\uFEFF/, ''), enabled, target, version)
+    writeFileSync(pkgFile, next, 'utf8')
+    applyJunction(profileDir, enabled, target)
+    const installError = await runPnpmInstall(ctx, profileDir)
+    return { ok: !installError, error: installError, restart: true }
+  } catch (error) {
+    return { ok: false, error: String(error), restart: false }
+  }
+}
+
+/** 在 profile 目录执行 pnpm install（subprocess 契约：spawn({argv,cwd,stdio,graceMs})）。 */
+async function runPnpmInstall(ctx: Ctx, profileDir: string): Promise<string | undefined> {
+  const sub = ctx.get('subprocess')
+  if (!sub || typeof sub.spawn !== 'function') return 'manifest/junction 已更新，但缺少 subprocess：请手动在 profile 目录运行 pnpm install'
+  const handle = sub.spawn({
+    argv: ['pnpm', 'install'],
+    cwd: profileDir,
+    stdio: { stdout: { maxBytes: 1 << 16 }, stderr: { maxBytes: 1 << 16 }, stdin: 'ignore' },
+    graceMs: 120000,
+  })
+  const outcome = await handle.done
+  const code = outcome?.exitCode ?? outcome?.code
+  if (code !== 0) {
+    const stderr = handle.collected?.stderr?.readFrom(0).text ?? ''
+    return 'pnpm install 失败（exit ' + code + '）：' + stderr.slice(0, 500)
+  }
+  return undefined
+}

package/src/fileOpenSettings.ts

@@ -1,12 +1,12 @@
 /**
  * dsh-vscode-mode host — 文件链接打开工具的持久化设置。
- * @author ddj 2026年08月24号
+ * 依赖守卫：@deepseek-ai/dsh-settings / schemastery 以动态加载引入，
+ * 缺失时插件仍可加载（fileOpenTool 降级为配置值，compat 报告可见）。
+ * 作者 ddj 2026年08月24号
  */
-import { installSettingsSection, settingsNamespace } from '@deepseek-ai/dsh-settings'
-import z from 'schemastery'
 import type { Ctx } from './store.js'
 
-export const FILE_OPEN_SETTINGS_NS = settingsNamespace('dsh-vscode-mode')
+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> }
@@ -17,7 +17,35 @@ type SettingsProvider = {
   get?: (ns: string) => unknown
 }
 
-const FILE_OPEN_SCHEMA = z.object({ fileOpenTool: z.string().default(FILE_OPEN_DEFAULT) })
+/** 动态依赖的装载结果（宽松类型：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
@@ -28,6 +56,30 @@ 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号
@@ -48,7 +100,7 @@ export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: s
   const setSource = (source: () => FileOpenSettings): void => notify(source().fileOpenTool)
   const settingsChange = (): void => syncRevision()
 
-  installSettingsSection(ctx, FILE_OPEN_SETTINGS_NS, FILE_OPEN_SCHEMA, { fileOpenTool: current }, { setSource, onChange: settingsChange })
+  void installOpenSettingsSection(ctx, FILE_OPEN_SETTINGS_NS, { fileOpenTool: current }, { setSource, onChange: settingsChange })
   ctx.inject?.(['settings'], (settingsCtx: Ctx) => {
     provider = settingsCtx.get('settings')
     syncRevision()

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'
@@ -13,6 +14,7 @@ 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'
 
@@ -20,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 覆盖图标目录）
@@ -28,6 +30,8 @@ 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) => {
@@ -43,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

@@ -27,6 +27,8 @@ 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'
+import { readDevForm, setDevForm } from './devForm.js'
 
 /** cwd → Promise 链：串行化 debug 日志追加（fs read+write 非原子，避免并发丢行）。 */
 const debugWriteQueues = new Map<string, Promise<void>>()
@@ -322,6 +324,17 @@ 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) }),
+    'vscode.devFormGet': async () => ({ ok: true, devForm: readDevForm() }),
+    'vscode.devFormSet': async (args) => {
+      try {
+        const result = await setDevForm(ctx, args.enabled === true, args.path)
+        if (!result.ok) return { ok: false, error: result.error ?? '切换开发形态失败' }
+        return { ok: true, devForm: readDevForm(), restart: result.restart }
+      } catch (error) {
+        return { ok: false, error: String(error) }
+      }
+    },
   }
 }
 

package/src/shared/compat.ts

@@ -0,0 +1,27 @@
+/**
+ * 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
+}
+
+/** 开发形态信息：profile 中以 link: 依赖 + junction 指向工作区的安装形态。 */
+export interface DevFormInfo {
+  enabled: boolean
+  path?: string
+}
+
+/** 兼容性报告：host 侧构建（RPC edrv.compat 返回），client 侧补充本地适配项后展示。 */
+export interface CompatReport {
+  pluginVersion: string
+  external: CompatAdapter[]
+  guards: CompatAdapter[]
+  warnings: string[]
+  devForm?: DevFormInfo
+}

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, DevFormInfo } from './compat.js'
 
 /** webServer 精确路由。 */
 export const RPC_PATH = '/edrv/rpc'
@@ -45,6 +46,9 @@ export interface RpcRequestMap {
   'mcp.projectRefresh': { workspacePath: string; serverName: string }
   'vscode.fileOpenSettingsGet': {}
   'vscode.fileOpenSettingsUpdate': { fileOpenTool: string; expectedRevision?: number }
+  'vscode.devFormGet': {}
+  'vscode.devFormSet': { enabled: boolean; path?: string }
+  'compat': {}
 }
 
 export type RpcMethod = keyof RpcRequestMap
@@ -74,6 +78,9 @@ export interface RpcOkMap {
   'mcp.projectRefresh': { project: MpcProject }
   'vscode.fileOpenSettingsGet': { fileOpenTool: string; revision?: number }
   'vscode.fileOpenSettingsUpdate': { fileOpenTool: string; revision?: number }
+  'vscode.devFormGet': { devForm: DevFormInfo }
+  'vscode.devFormSet': { devForm: DevFormInfo; restart: boolean }
+  'compat': { report: CompatReport }
 }
 
 /** 统一响应：{ok:true, ...payload} 或 {ok:false, error}。 */