dsh-vscode-mode 0.1.12 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.12",
+  "version": "0.1.15",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 中央编辑器（文件页签/QuickOpen/状态栏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚），状态持久化到工作区旁车",
   "keywords": [
     "dsh",
@@ -39,8 +39,14 @@
     "cordis.patch.yml"
   ],
   "license": "BSD-3-Clause",
+  "dependencies": {
+    "@vscode/ripgrep": "^1.18.0"
+  },
   "peerDependencies": {
     "@deepseek-ai/dsh-client-ui-slots": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.1 <0.2.0-0",
     "@deepseek-ai/dsh-llm": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0",
     "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0",
     "cordis": ">=4.0.0-rc <5",
@@ -48,9 +54,11 @@
     "schemastery": "^3.18.0"
   },
   "devDependencies": {
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.8",
     "@types/node": "^24.13.3",
     "@types/react": "^18.3.1",
     "react": "^18.3.1",
+    "schemastery": "3.18.0",
     "tsdown": "^0.22.14",
     "typescript": "^5.9.0",
     "vitest": "^3.2.4"

package/src/capture.ts

@@ -6,8 +6,8 @@
 import type { DiffRecord, Hunk } from './shared/types.js'
 import { annotateHunks, fingerprint } from './shared/diff.js'
 import type { Ctx, Session } from './store.js'
-import { archiveRecords, loadBucket, saveBucket } from './store.js'
-import { fileMaxBatch, prune, recordResolved } from './model.js'
+import { loadBucket, saveBucket } from './store.js'
+import { fileMaxBatch, prune } from './model.js'
 import type { Registry } from './registry.js'
 import { cwdOf } from './registry.js'
 
@@ -93,14 +93,8 @@ export async function captureToolResult(ctx: Ctx, registry: Registry, exec: any,
     if (!bucket) { bucket = await loadBucket(ctx, cwd); registry.set(cwd, bucket) }
     record.batch = fileMaxBatch(bucket, path) + 1
     bucket.set(exec.callId, record)
-    // 融合：文件被再次修改（batch 递增）时，早于最新批次的未归档差异一律归档（内容已含其效果/被取代）
-    const prior: DiffRecord[] = []
-    for (const r of bucket.values()) {
-      if (r.path === path && r.callId !== exec.callId && !r.archived && (r.batch ?? 0) < record.batch) prior.push(r)
-    }
-    if (prior.length) {
-      await archiveRecords(ctx, session, cwd, bucket, prior, prior.every(recordResolved) ? '已处理且被后续修改取代' : '被后续修改融合（内容已含其效果）')
-    }
+    // 同一文件的多次 edit/write 都保留为独立记录，便于逐条审查。
+    // 旧实现按文件 batch 自动归档 prior，会导致界面看起来每个文件只剩一条差异。
     prune(bucket)
     await saveBucket(ctx, cwd, bucket, session)
   } catch (error) {

package/src/client/fileOpeners.ts

@@ -0,0 +1,172 @@
+/**
+ * dsh-vscode-mode client — 文件打开器注册表与自动选择。
+ * @author ddj 2026年08月24号
+ */
+
+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 interface FileOpenContext {
+  sessionId?: string
+  cwd?: string
+}
+
+export interface FileOpener {
+  id: string
+  label: string
+  description?: string
+  priority?: number
+  isAvailable?: () => boolean
+  open: (path: string, context: FileOpenContext) => void | Promise<void>
+}
+
+export interface FileOpenerRegistry {
+  register(opener: FileOpener): () => void
+  registerFileOpener(opener: FileOpener): () => void
+  list(): readonly FileOpener[]
+  subscribe(listener: () => void): () => void
+  get(id: string): FileOpener | undefined
+}
+
+/**
+ * 写入外部打开器并触发注册表通知。
+ * @author ddj 2026年08月24号
+ * @param entries 打开器存储
+ * @param notify 变更通知
+ * @param opener 打开器
+ */
+function registryRegister(entries: Map<string, FileOpener>, notify: () => void, opener: FileOpener): void {
+  if (!opener.id || typeof opener.open !== 'function') throw new TypeError('文件打开器必须提供 id 和 open')
+  entries.set(opener.id, opener)
+  notify()
+}
+
+/**
+ * 创建生命周期独立的文件打开器注册表。
+ * @author ddj 2026年08月24号
+ * @returns 文件打开器注册表
+ */
+export function createFileOpenerRegistry(): FileOpenerRegistry {
+  const entries = new Map<string, FileOpener>()
+  const listeners = new Set<() => void>()
+  const notify = (): void => {
+    for (const listener of listeners) listener()
+  }
+  const list = (): readonly FileOpener[] => [...entries.values()].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0))
+  return {
+    register(opener: FileOpener): () => void {
+      registryRegister(entries, notify, opener)
+      return () => {
+        if (entries.get(opener.id) !== opener) return
+        entries.delete(opener.id)
+        notify()
+      }
+    },
+    registerFileOpener(opener: FileOpener): () => void {
+      registryRegister(entries, notify, opener)
+      return () => {
+        if (entries.get(opener.id) !== opener) return
+        entries.delete(opener.id)
+        notify()
+      }
+    },
+    list,
+    subscribe(listener: () => void): () => void {
+      listeners.add(listener)
+      return () => listeners.delete(listener)
+    },
+    get: (id: string) => entries.get(id),
+  }
+}
+
+/**
+ * 检查打开器当前是否可用。
+ * @author ddj 2026年08月24号
+ * @param opener 待检查打开器
+ * @returns 是否可用
+ */
+export function isAvailable(opener: FileOpener): boolean {
+  try {
+    return opener.isAvailable ? opener.isAvailable() : true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 返回当前可展示的文件打开器。
+ * @author ddj 2026年08月24号
+ * @param registry 文件打开器注册表
+ * @returns 可用打开器列表
+ */
+export function availableOpeners(registry: FileOpenerRegistry): FileOpener[] {
+  return registry.list().filter(isAvailable)
+}
+
+/**
+ * 按设置选择打开器，不可用时回退自动优先级。
+ * @author ddj 2026年08月24号
+ * @param registry 文件打开器注册表
+ * @param selected 用户选择的打开器 id
+ * @returns 选中的打开器
+ */
+export function selectOpener(
+  registry: FileOpenerRegistry,
+  selected: string,
+): FileOpener | undefined {
+  if (selected !== AUTO_OPEN_TOOL) {
+    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
+ */
+export function scanSidebar(ctx: { get: (name: string) => unknown }): FileOpener | undefined {
+  try {
+    const service = ctx.get('betterSidebar') as {
+      openFile?: (scope: { sessionId: string; cwd?: string }, path: string, title?: string) => void
+      isTabEnabled?: (id: string) => boolean
+      features?: readonly string[]
+      getSnapshot?: () => { state?: unknown }
+    } | undefined
+    if (!service || typeof service.openFile !== 'function') return undefined
+    const advertised = service.features?.includes('openFile') ?? true
+    if (!advertised) return undefined
+    const canOpen = typeof service.isTabEnabled !== 'function' || service.isTabEnabled('editor')
+    if (!canOpen) return undefined
+    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 undefined
+  }
+}
+
+/**
+ * 从路径提取文件名。
+ * @author ddj 2026年08月24号
+ * @param path 文件路径
+ * @returns 文件名
+ */
+export function baseName(path: string): string {
+  const normalized = path.replace(/\\/g, '/')
+  return normalized.slice(normalized.lastIndexOf('/') + 1) || path
+}

package/src/client/index.ts

@@ -16,8 +16,13 @@ import './styles/editor.css'
 import { EditorView } from './ui/EditorView.js'
 import { DiffBadge } from './ui/DiffBadge.js'
 import { McpSettings } from './ui/McpSettings.js'
+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'
 
-export const inject = ['slots', 'timer', 'locale', 'connection', 'remote']
+export const inject = ['slots', 'timer', 'locale', 'connection', 'remote', 'workspaces', 'sessions', 'settingsScope', 'webUiSettings']
 
 /**
  * 装配客户端：注册中央编辑区视图与 header 差异角标。
@@ -27,6 +32,48 @@ export const inject = ['slots', 'timer', 'locale', 'connection', 'remote']
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function apply(ctx: any): void {
   const schedule = (fn: () => void, ms: number) => ctx.timeout(fn, ms)
+  const registry: FileOpenerRegistry = createFileOpenerRegistry()
+  const workspaces = ctx.get('workspaces')
+  const sessions = ctx.get('sessions')
+  const originalOpenPath = workspaces?.openPath
+  const settings = getSettingsScope(ctx)
+  let selected = autoValue('auto')
+
+  ctx.provide('fileOpeners', registry)
+  ctx.effect(() => registry.register(vscodeOpener()), 'vscode-mode: file opener')
+  ctx.effect(() => registry.register({
+    id: 'system', label: '系统默认应用', priority: 0,
+    open: (path: string) => originalOpenPath.call(workspaces, path),
+  }), 'vscode-mode: system file opener')
+  ctx.effect(() => {
+    const sidebar = scanSidebar(ctx)
+    return sidebar ? registry.register(sidebar) : undefined
+  }, 'vscode-mode: sidebar file opener')
+  ctx.effect(() => {
+    if (!settings) return undefined
+    const sync = (): void => {
+      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
+        const summary = sessionId ? current?.byId?.[sessionId] : undefined
+        return { sessionId, cwd: summary?.cwd } as FileOpenContext
+      },
+      logger: (message: string) => console.warn('[dsh-vscode-mode] ' + message),
+    }), 'vscode-mode: file link routing')
+  }
 
   // 中央「文件编辑」页签：类 VSCode 编辑器（顶部=文件页签+搜索框，差异 UI=文件底部圆角悬浮框）
   ctx.slots.inject('conversation.view', () => ctx.slots.register({
@@ -49,5 +96,5 @@ export function apply(ctx: any): void {
     id: 'vscode-mode',
     order: 30,
     label: 'VSCodeMode',
-  }, () => React.createElement(McpSettings)))
+  }, () => React.createElement(SettingsContext.Provider, { value: settings }, React.createElement(McpSettings, { openerRegistry: registry }))))
 }

package/src/client/openPathRouter.ts

@@ -0,0 +1,57 @@
+/**
+ * dsh-vscode-mode client — DSH 对话文件链接的统一打开路由。
+ * @author ddj 2026年08月24号
+ */
+import { openEditorView } from './events.js'
+import { AUTO_OPEN_TOOL, VSCODE_OPEN_TOOL, type FileOpenContext, type FileOpenerRegistry, isAvailable, selectOpener } from './fileOpeners.js'
+
+export interface OpenPathRouterOptions {
+  workspaces: { openPath: (path: string) => Promise<void> }
+  registry: FileOpenerRegistry
+  selected: () => string
+  context: () => FileOpenContext
+  logger?: (message: string) => void
+}
+
+/**
+ * 安装可卸载的 workspaces.openPath 路由。
+ * @author ddj 2026年08月24号
+ * @param options 路由依赖
+ * @returns 恢复原方法的 disposer
+ */
+export function installOpenPathRouter(options: OpenPathRouterOptions): () => void {
+  const original = options.workspaces.openPath
+  const open = async (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)
+    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
+    }
+  }
+  options.workspaces.openPath = open
+  return () => { options.workspaces.openPath = original }
+}
+
+/**
+ * 创建 VSCodeMode 内置文件打开器。
+ * @author ddj 2026年08月24号
+ * @returns VSCodeMode 打开器
+ */
+export function vscodeOpener(): { id: string; label: string; priority: number; open: (path: string) => void } {
+  return { id: VSCODE_OPEN_TOOL, label: 'VSCodeMode', priority: 100, open: (path) => openEditorView(path) }
+}
+
+/**
+ * 规范化设置中的打开器 id。
+ * @author ddj 2026年08月24号
+ * @param value 原始设置值
+ * @returns 可路由的打开器 id
+ */
+export function autoValue(value: unknown): string {
+  return typeof value === 'string' && value.trim() ? value.trim() : AUTO_OPEN_TOOL
+}

package/src/client/settingsContext.ts

@@ -0,0 +1,31 @@
+/**
+ * dsh-vscode-mode client — 设置 scope 的跨组件上下文。
+ * @author ddj 2026年08月24号
+ */
+import React from 'react'
+
+export interface SettingsScopeLike {
+  getSnapshot: () => { status?: string; value?: { fileOpenTool?: unknown }; writable?: boolean }
+  subscribe: (listener: () => void) => () => void
+  set: (field: string, value: unknown) => Promise<void>
+}
+
+export const SettingsContext = React.createContext<SettingsScopeLike | undefined>(undefined)
+
+/**
+ * 从 Cordis 服务绑定 VSCodeMode 设置 scope。
+ * @author ddj 2026年08月24号
+ * @param ctx 客户端上下文
+ * @returns 设置 scope 或 undefined
+ */
+/**
+ * 绑定官方设置 scope，优先使用 web-ui 兼容桥。
+ * @author ddj 2026年08月24号
+ * @param ctx 客户端服务上下文
+ * @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' })
+}

package/src/client/styles/mcp.css

@@ -17,6 +17,14 @@
 .vsm-mcp-tabs button.active{color:var(--dsw-alias-label-primary,#fff);font-weight:500}
 .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}
 
+/* 通用设置 */
+.vsm-general-page{display:flex;flex-direction:column;gap:10px;max-width:720px}
+.vsm-general-page h2{margin:0;font-size:20px;color:var(--dsw-alias-label-primary,#e6e6e6)}
+.vsm-general-page p{margin:0 0 8px;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:13px}
+.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}
+.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}
+.vsm-general-row small{color:var(--dsw-alias-label-tertiary,#9aa5b1)}
+
 /* 服务卡片 */
 .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}
 .vsm-mcp-card:hover{border-color:var(--dsw-alias-border-l3,#555)}

package/src/client/ui/EditorView.ts

@@ -67,7 +67,7 @@ export function EditorView(props) {
 
   const currentRecords = React.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])
 
@@ -113,7 +113,10 @@ export function EditorView(props) {
     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)))
   }

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,49 @@ 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, '读取中…')),
+  )
+}
+
 /** MCP 管理主面板。 */
-export function McpSettings() {
+export function McpSettings(props) {
+  const openerRegistry = props?.openerRegistry ?? { list: () => [] }
   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 +249,14 @@ 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 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 市场')),
     error && React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, error),
     body,
     form,

package/src/fileOpenSettings.ts

@@ -0,0 +1,72 @@
+/**
+ * dsh-vscode-mode host — 文件链接打开工具的持久化设置。
+ * @author 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_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
+}
+
+const FILE_OPEN_SCHEMA = z.object({ fileOpenTool: z.string().default(FILE_OPEN_DEFAULT) })
+
+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)
+}
+
+/**
+ * 注册设置命名空间，并提供 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()
+
+  installSettingsSection(ctx, FILE_OPEN_SETTINGS_NS, FILE_OPEN_SCHEMA, { 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

@@ -8,9 +8,11 @@
 import { registerRoutes } from './routes.js'
 import { captureToolResult } from './capture.js'
 import { handleRpc } from './rpc.js'
+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 type { Registry } from './registry.js'
 import type { Ctx } from './store.js'
 
@@ -25,6 +27,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)
+  setupOpenSettings(ctx, config, () => {})
 
   ctx.on('tools/result', (exec: unknown, result: unknown) => {
     void captureToolResult(ctx, registry, exec, result)
@@ -35,10 +39,11 @@ export function apply(ctx: Ctx, config?: unknown): void {
     if (cwd) {
       registry.delete(cwd)
       dropFileIndex(cwd)
+      searcher.dispose(cwd)
     }
   })
 
-  registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args))
+  registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher))
   installIsolation(ctx)
 
   ctx.logger?.info?.('[' + name + '] 编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用）')