dsh-vscode-mode 0.1.20 → 0.1.22

package/src/client/outline/sources.ts

@@ -0,0 +1,134 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 大纲源注册表 + 内置数据源（monaco / fallback）。
+ * 解析规则：按优先级降序遍历源，首个非空结果生效；全空 → 空态。
+ * monaco 源吃 Monaco 原生 document symbol provider（ts/json/css/html 与未来
+ * 第三方注册的 provider）；fallback 源兜底无内置提供方的语言（parse.ts）。
+ * 注册表对外 provide 为 edrvOutlineSources，第三方语言插件可注册更高优先级源。
+ * 作者 ddj 2026-08-27
+ */
+import type { OutlineSourceRegistry, OutlineSource, OutlineSourceInput, OutlineSymbol } from './types.js'
+import { parseOutline } from './parse.js'
+
+/** Monaco 原生有 document symbol provider 的语言（无需 fallback）。 */
+export const OUTLINE_MONACO_LANGS = new Set([
+  'typescript', 'javascript', 'json', 'jsonc', 'css', 'scss', 'less', 'html',
+])
+
+/** 无内置 provider、由 parse.ts 兜底的语言。 */
+export const OUTLINE_FALLBACK_LANGS = new Set([
+  'markdown', 'mdx', 'python', 'shell', 'powershell', 'lua', 'go', 'rust',
+  'yaml', 'ini', 'c', 'cpp', 'csharp', 'java', 'php', 'ruby', 'kotlin',
+  'swift', 'dart',
+])
+
+/**
+ * 创建生命周期独立的大纲源注册表。
+ * @author ddj 2026年08月27号
+ * @returns 大纲源注册表
+ */
+export function createOutlineSourceRegistry(): OutlineSourceRegistry {
+  const entries = new Map<string, OutlineSource>()
+  const listeners = new Set<() => void>()
+  const notify = (): void => {
+    for (const listener of listeners) listener()
+  }
+  const list = (): readonly OutlineSource[] =>
+    [...entries.values()].sort((a, b) => (b.priority - a.priority) || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0))
+  return {
+    register(source: OutlineSource): () => void {
+      if (!source || !source.id || typeof source.get !== 'function') throw new TypeError('大纲源必须提供 id 与 get')
+      entries.set(source.id, source)
+      notify()
+      return () => {
+        if (entries.get(source.id) !== source) return
+        entries.delete(source.id)
+        notify()
+      }
+    },
+    list,
+    subscribe(listener: () => void): () => void {
+      listeners.add(listener)
+      return () => listeners.delete(listener)
+    },
+    get: (id: string) => entries.get(id),
+  }
+}
+
+/** 归一化 Monaco OutlineElement（getTopLevelSymbols 产物）→ OutlineSymbol。 */
+function normalizeMonaco(el): OutlineSymbol | null {
+  if (!el || typeof el.name !== 'string') return null
+  const range = el.range || {}
+  const sel = el.selectionRange || range
+  const startLine = Math.max(1, Number(sel.startLineNumber ?? range.startLineNumber ?? 1))
+  const endLine = Math.max(1, Number(range.endLineNumber ?? startLine))
+  const out: OutlineSymbol = {
+    name: el.name,
+    kind: typeof el.kind === 'number' ? el.kind : 0,
+    startLine: Math.max(1, Number(range.startLineNumber ?? startLine)),
+    endLine,
+    selectLine: startLine,
+  }
+  if (typeof el.detail === 'string' && el.detail) out.detail = el.detail
+  if (Array.isArray(el.children) && el.children.length) {
+    const kids = el.children.map(normalizeMonaco).filter(Boolean)
+    if (kids.length) out.children = kids
+  }
+  return out
+}
+
+/**
+ * 按优先级解析大纲符号：首个非空结果生效（出错源跳过，落入下一优先级）。
+ * @author ddj 2026年08月27号
+ * @param sources 大纲源注册表
+ * @param input 当前快照（languageId/model/editor/monaco）
+ * @returns 归一化符号树（无符号时为空数组）
+ */
+export async function resolveOutline(sources: OutlineSourceRegistry, input: OutlineSourceInput): Promise<OutlineSymbol[]> {
+  for (const source of sources.list()) {
+    let supports = false
+    try { supports = source.provides(input.languageId) } catch { supports = false }
+    if (!supports) continue
+    let items: OutlineSymbol[] | null = null
+    try { items = await source.get(input) } catch { items = null }
+    if (items && items.length) return items
+  }
+  return []
+}
+
+/**
+ * 注册内置大纲源（monaco=50 / fallback=30）。
+ * @author ddj 2026年08月27号
+ * @param registry 目标注册表
+ * @returns 注销函数（同时注销全部内置源）
+ */
+export function registerBuiltinOutlineSources(registry: OutlineSourceRegistry): () => void {
+  const disposers = [
+    registry.register({
+      id: 'monaco',
+      priority: 50,
+      provides: () => true,
+      async get(input: OutlineSourceInput): Promise<OutlineSymbol[]> {
+        const ed = input.editor
+        const model = input.model
+        const cmd = ed?._commandService
+        if (!cmd || typeof cmd.executeCommand !== 'function') return []
+        const uri = model?.uri
+        if (!uri) return []
+        const list = await cmd.executeCommand('_executeDocumentSymbolProvider', uri)
+        return Array.isArray(list) ? list.map(normalizeMonaco).filter(Boolean) : []
+      },
+    }),
+    registry.register({
+      id: 'fallback',
+      priority: 30,
+      provides: (languageId: string) => OUTLINE_FALLBACK_LANGS.has(languageId),
+      async get(input: OutlineSourceInput): Promise<OutlineSymbol[]> {
+        const model = input.model
+        if (!model || typeof model.getValue !== 'function') return []
+        return parseOutline(input.languageId, model.getValue())
+      },
+    }),
+  ]
+  return () => { for (const dispose of disposers) dispose() }
+}

package/src/client/outline/types.ts

@@ -0,0 +1,51 @@
+/**
+ * dsh-vscode-mode client — 大纲契约（归一化符号模型 + 数据源接口）。
+ * 面板只消费 OutlineSymbol[]，与 Monaco 解耦；未来语言插件（LSP/VSIX 风格，
+ * 如 EmmyLua/C#）注册高优先级 OutlineSource 即可接入，无需改动面板。
+ * kind 取 monaco SymbolKind 数值（0–25，与 LSP SymbolKind 一致）。
+ * 作者 ddj 2026-08-27
+ */
+
+/** 归一化大纲符号（面板唯一渲染契约）。 */
+export interface OutlineSymbol {
+  name: string
+  /** monaco SymbolKind 数值：File0/Module1/Namespace2/Package3/Class4/Method5/Property6/Field7/Constructor8/Enum9/Interface10/Function11/Variable12/Constant13/String14/Number15/Boolean16/Array17/Object18/Key19/Null20/EnumMember21/Struct22/Event23/Operator24/TypeParameter25。 */
+  kind: number
+  detail?: string
+  /** 符号整体起始行（1-based）。 */
+  startLine: number
+  /** 符号整体结束行（1-based）。 */
+  endLine: number
+  /** 跳转行（符号名所在行，1-based）。 */
+  selectLine: number
+  children?: OutlineSymbol[]
+}
+
+/** 大纲数据源输入（面板解析时注入当前快照；字段均为弱类型，源自行 duck-typing）。 */
+export interface OutlineSourceInput {
+  languageId: string
+  /** Monaco 文本模型（源可用 model.getValue() 自行解析）。 */
+  model?: unknown
+  /** 当前 Monaco 编辑器实例（供 _commandService 等内部调用）。 */
+  editor?: unknown
+  /** 全局 monaco 对象。 */
+  monaco?: unknown
+}
+
+/** 大纲数据源：按优先级降序解析，首个非空结果生效。 */
+export interface OutlineSource {
+  id: string
+  /** 数值越大越优先（内置：monaco=50、fallback=30；第三方语言插件建议 60–90）。 */
+  priority: number
+  /** 是否可为该语言提供符号。 */
+  provides(languageId: string): boolean
+  get(input: OutlineSourceInput): Promise<OutlineSymbol[]>
+}
+
+/** 大纲源注册表（ctx.provide 为 edrvOutlineSources，供第三方注册）。 */
+export interface OutlineSourceRegistry {
+  register(source: OutlineSource): () => void
+  list(): readonly OutlineSource[]
+  subscribe(listener: () => void): () => void
+  get(id: string): OutlineSource | undefined
+}

package/src/client/sidebar/contextMenu.ts

@@ -0,0 +1,99 @@
+/**
+ * dsh-vscode-mode client — 文件管理右键菜单框架（类型 + 注册表 + 纯构建函数）。
+ * 镜像 sidebar/registry.ts 的注册表模式：create + register(返回注销) + list + subscribe，
+ * 由 client/index.ts `ctx.provide('edrvFileContextMenuItems', registry)` 对外暴露（第三方可注册）。
+ * 新增菜单项只需 register 一条 TreeMenuItem，面板在右键打开时经 buildTreeMenu 过滤/排序。
+ * 本模块不触 React/浏览器，可单测。
+ * 作者 ddj 2026-08-27
+ */
+import type { TreeEntry } from '../../shared/rpc.js'
+import type { SidebarCtx } from './types.js'
+
+/** 右键目标（树行/面板空白区，path 相对工作区根，'' 表示根目录）。 */
+export interface TreeMenuTarget {
+  path: string
+  type: TreeEntry['type']
+}
+
+/** 一条右键菜单项定义。 */
+export interface TreeMenuItem {
+  id: string
+  label: string
+  /** 排序：数值越小越靠前（缺省 100）。 */
+  order?: number
+  /** 红色警示样式（如删除类操作）。 */
+  danger?: boolean
+  /** 置灰不可点（如无权限/目标不支持时）。 */
+  disabled?: boolean
+  /** 前置分隔线。 */
+  separator?: boolean
+  /** 显隐守卫：返回 false 则不显示。 */
+  visible?: (target: TreeMenuTarget, ctx: SidebarCtx) => boolean
+  run: (target: TreeMenuTarget, ctx: SidebarCtx) => void
+}
+
+/** 右键菜单项注册表（生命周期独立，可注册/注销/订阅）。 */
+export interface TreeMenuRegistry {
+  register(item: TreeMenuItem): () => void
+  list(): readonly TreeMenuItem[]
+  subscribe(listener: () => void): () => void
+  get(id: string): TreeMenuItem | undefined
+}
+
+/** 校验菜单项并写入注册表（缺 id/run/label 抛 TypeError）。 */
+function itemRegister(entries: Map<string, TreeMenuItem>, notify: () => void, item: TreeMenuItem): void {
+  if (!item.id || typeof item.run !== 'function' || !item.label) {
+    throw new TypeError('文件右键菜单项必须提供 id、label 和 run')
+  }
+  entries.set(item.id, item)
+  notify()
+}
+
+/**
+ * 创建生命周期独立的右键菜单项注册表。
+ * @author ddj 2026年08月27号
+ * @returns 菜单项注册表
+ */
+export function createTreeMenuRegistry(): TreeMenuRegistry {
+  const entries = new Map<string, TreeMenuItem>()
+  const listeners = new Set<() => void>()
+  const notify = (): void => {
+    for (const listener of listeners) listener()
+  }
+  const list = (): readonly TreeMenuItem[] =>
+    [...entries.values()].sort((a, b) => (a.order ?? 100) - (b.order ?? 100))
+  return {
+    register(item: TreeMenuItem): () => void {
+      itemRegister(entries, notify, item)
+      return () => {
+        if (entries.get(item.id) !== item) return
+        entries.delete(item.id)
+        notify()
+      }
+    },
+    list,
+    subscribe(listener: () => void): () => void {
+      listeners.add(listener)
+      return () => listeners.delete(listener)
+    },
+    get: (id: string) => entries.get(id),
+  }
+}
+
+/**
+ * 按目标构建当前可见菜单项（visible 过滤 + order 排序）。
+ * @author ddj 2026年08月27号
+ * @param registry 菜单项注册表
+ * @param target 右键目标
+ * @param ctx 面板共享上下文
+ * @returns 可见菜单项（已排序）
+ */
+export function buildTreeMenu(registry: TreeMenuRegistry | undefined, target: TreeMenuTarget, ctx: SidebarCtx): TreeMenuItem[] {
+  if (!registry) return []
+  const out: TreeMenuItem[] = []
+  for (const item of registry.list()) {
+    if (typeof item.visible === 'function' && !item.visible(target, ctx)) continue
+    out.push(item)
+  }
+  return out
+}

package/src/client/sidebar/menuItems.ts

@@ -0,0 +1,28 @@
+/**
+ * dsh-vscode-mode client — 文件管理右键菜单内置项。
+ * 首个内置项：「在文件浏览器中打开」（文件→OS Explorer 定位选中、目录→打开目录）。
+ * 反馈统一走 ctx.notify（由 EditorView 提供，落到编辑区路径栏状态）。
+ * 作者 ddj 2026-08-27
+ */
+import { revealInExplorer } from '../fileReveal.js'
+import type { TreeMenuItem } from './contextMenu.js'
+
+/**
+ * 构造内置右键菜单项列表（后续内置项直接追加）。
+ * @author ddj 2026年08月27号
+ * @returns 内置菜单项数组
+ */
+export function createDefaultFileMenuItems(): TreeMenuItem[] {
+  return [
+    {
+      id: 'reveal-in-explorer',
+      label: '在文件浏览器中打开',
+      order: 0,
+      run: (target, ctx) => {
+        void revealInExplorer(ctx.sessionId, target.path).then((outcome) => {
+          ctx.notify?.(outcome.ok ? '已在文件浏览器中打开' : '打开失败：' + (outcome.error ?? '未知错误'))
+        })
+      },
+    },
+  ]
+}

package/src/client/sidebar/panels/FileExplorer.ts

@@ -3,17 +3,21 @@
  * dsh-vscode-mode client — 侧边栏「文件管理」面板（懒加载目录树）。
  * 点目录展开/收起（首次经 edrv.listDir 拉取并缓存），点文件经 ctx.openFile 打开；
  * 差异角标取 pendingByPath，活动文件高亮；edrv:refresh 事件与手动刷新重载树。
- * 作者 ddj 2026-08-26
+ * 右键行/空白弹出菜单：项来自 ctx.fileMenuItems 注册表（可拓展），
+ * 内置「在文件浏览器中打开」经 edrv.revealInExplorer 定位/打开。
+ * 作者 ddj 2026-08-26 / 2026-08-27
  */
 import React from 'react'
 import { rpc } from '../../rpc.js'
+import { ContextMenu } from '../../ui/ContextMenu.js'
+import { buildTreeMenu } from '../contextMenu.js'
 import type { SidebarCtx } from '../types.js'
 
 const DIR_CAP = 4000
 
 /**
  * 目录树面板主体。
- * @param props.ctx 面板共享上下文（sessionId/openFile/activePath/pendingByPath）
+ * @param props.ctx 面板共享上下文（sessionId/openFile/activePath/pendingByPath/fileMenuItems/notify）
  */
 export function FileExplorer(props) {
   const ctx = props?.ctx
@@ -26,6 +30,7 @@ export function FileExplorer(props) {
   const [expanded, setExpanded] = React.useState({})
   const [loading, setLoading] = React.useState({})
   const [error, setError] = React.useState(null)
+  const [menu, setMenu] = React.useState(null) // 右键菜单 { x, y, target }
   const tokensRef = React.useRef({})
   // expanded 的 ref 镜像：edrv:refresh 监听用首次渲染闭包，但需读到最新展开态
   const expandedRef = React.useRef({})
@@ -113,6 +118,11 @@ export function FileExplorer(props) {
       title: e.path,
       style: { paddingLeft: 6 + depth * 14 },
       onClick: () => { if (isDir) toggle(e.path); else openFile(e.path) },
+      onContextMenu: (ev) => {
+        ev.preventDefault()
+        ev.stopPropagation()
+        setMenu({ x: ev.clientX, y: ev.clientY, target: { path: e.path, type: e.type } })
+      },
     },
       React.createElement('span', { className: 'edrv-tree-chev' },
         isDir ? (isOpen ? '▾' : '▸') : ''),
@@ -145,7 +155,24 @@ export function FileExplorer(props) {
     return rows
   }
 
-  return React.createElement('div', { className: 'edrv-side-panel' },
+  // 面板区右键（空白处）→ 工作区根目录菜单；行内右键已在 rowEl 阻止冒泡。
+  const onPanelContext = (ev) => {
+    ev.preventDefault()
+    setMenu({ x: ev.clientX, y: ev.clientY, target: { path: '', type: 'directory' } })
+  }
+  // 当前右键目标的可视菜单项（构建时过滤/排序，registry 变化下次打开生效）。
+  const menuEntries = menu
+    ? buildTreeMenu(ctx?.fileMenuItems, menu.target, ctx).map((item) => ({
+        id: item.id,
+        label: item.label,
+        danger: item.danger,
+        disabled: item.disabled,
+        separator: item.separator,
+        onClick: () => item.run(menu.target, ctx),
+      }))
+    : []
+
+  return React.createElement('div', { className: 'edrv-side-panel', onContextMenu: onPanelContext },
     React.createElement('div', { className: 'edrv-side-head' },
       React.createElement('span', { className: 'edrv-side-title' }, '资源管理器'),
       React.createElement('span', { className: 'edrv-side-root', title: root || '' }, rootName),
@@ -157,5 +184,8 @@ export function FileExplorer(props) {
             React.createElement('span', null, String(error)),
             React.createElement('button', { className: 'edrv-side-btn', onClick: () => refresh() }, '重试'))
         : null),
-      rowsOf('', 0)))
+      rowsOf('', 0)),
+    (menu && menuEntries.length
+      ? React.createElement(ContextMenu, { x: menu.x, y: menu.y, entries: menuEntries, onClose: () => setMenu(null) })
+      : null))
 }

package/src/client/sidebar/types.ts

@@ -3,6 +3,8 @@
  * 面板 = 活动栏一项 + 面板区一处渲染；新增面板只需注册一条 SidebarPanelDef。
  * 作者 ddj 2026-08-26
  */
+import type { OutlineSourceRegistry } from '../outline/types.js'
+import type { TreeMenuRegistry } from './contextMenu.js'
 
 /** 面板可用的共享上下文（由 SidebarView 从 EditorView 注入，面板不直碰其内部）。 */
 export interface SidebarCtx {
@@ -15,6 +17,14 @@ export interface SidebarCtx {
   sum: { totalFiles: number; files: Array<{ path: string; pending: number }> }
   /** 触发差异记录刷新（保存/决策后由 EditorView 统一 emitRefresh）。 */
   refreshRecords: () => void
+  /** 取当前 Monaco 编辑器实例（可能为 null；大纲面板读 model/跳转用）。 */
+  editor?: () => unknown | null
+  /** 大纲源注册表（公开 provide 为 edrvOutlineSources；大纲面板解析符号用）。 */
+  outlineSources?: OutlineSourceRegistry
+  /** 文件右键菜单项注册表（公开 provide 为 edrvFileContextMenuItems；文件管理面板构建菜单用）。 */
+  fileMenuItems?: TreeMenuRegistry
+  /** 面板动作反馈（如右键菜单操作结果 → 编辑区路径栏状态）。 */
+  notify?: (message: string) => void
 }
 
 /** 单个侧边栏面板定义。 */

package/src/client/styles/editor.css

@@ -69,6 +69,8 @@
 [data-edrv-view] .edrv-ctxmenu-item { display: flex; align-items: center; gap: 8px; font-size: 12px; line-height: 18px; padding: 7px 10px; border: none; border-radius: 6px; background: transparent; color: var(--dsw-alias-label-primary, #1f2933); cursor: pointer; text-align: left; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
 [data-edrv-view] .edrv-ctxmenu-item:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.08)); }
 [data-edrv-view] .edrv-ctxmenu-item.edrv-ctxmenu-danger { color: var(--dsw-alias-state-error-primary, #d9534f); }
+[data-edrv-view] .edrv-ctxmenu-item:disabled,
+[data-edrv-view] .edrv-ctxmenu-item.edrv-ctxmenu-disabled { color: var(--dsw-alias-label-disabled, #b0b7c0); cursor: default; background: transparent; }
 [data-edrv-view] .edrv-ctxmenu-sep { height: 1px; margin: 3px 4px; background: var(--dsw-alias-border-l1, #e0e6e8); }
 [data-edrv-view] .edrv-diffbar-body { max-height: 130px; max-width: min(560px, calc(100vw - 40px)); overflow: auto; padding: 4px 8px 8px; display: flex; flex-direction: column; gap: 4px; border-top: 1px solid var(--dsw-alias-border-l1, #e0e6e8); }
 [data-edrv-view] .edrv-diffrow { display: flex; align-items: center; gap: 8px; padding: 3px 6px; border: 1px solid var(--dsw-alias-border-l1, #e0e6e8); border-radius: 6px; background: var(--dsw-alias-bg-layer-2, #f0f4f4); cursor: pointer; flex-wrap: wrap; }
@@ -201,7 +203,7 @@
 [data-edrv-view] .edrv-rail-icon { font-size: 15px; line-height: 1; }
 [data-edrv-view] .edrv-rail-badge { position: absolute; top: 2px; right: 2px; min-width: 14px; height: 14px; padding: 0 3px; border-radius: 999px; background: var(--dsw-alias-brand-primary, #0f9d58); color: #fff; font-size: 9px; font-weight: 600; line-height: 14px; text-align: center; box-sizing: border-box; }
 [data-edrv-view] .edrv-side-body { flex: 1; min-width: 0; min-height: 0; display: flex; overflow: hidden; }
-[data-edrv-view] .edrv-side-panel { flex: 1; min-width: 0; min-height: 0; display: flex; flex-direction: column; }
+[data-edrv-view] .edrv-side-panel { flex: 1; min-width: 0; min-height: 0; display: flex; flex-direction: column; position: relative; }
 [data-edrv-view] .edrv-side-head { display: flex; align-items: center; gap: 8px; height: 34px; padding: 0 10px 0 12px; border-bottom: 1px solid var(--dsw-alias-border-l1, #e0e6e8); flex-shrink: 0; }
 [data-edrv-view] .edrv-side-title { font-size: 12px; font-weight: 600; color: var(--dsw-alias-label-primary, #1f2933); white-space: nowrap; }
 [data-edrv-view] .edrv-side-root { font-size: 11px; color: var(--dsw-alias-label-tertiary, #9aa5b1); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
@@ -217,6 +219,15 @@
 [data-edrv-view] .edrv-tree-badge { min-width: 14px; height: 14px; padding: 0 4px; border-radius: 999px; background: var(--dsw-alias-state-warn-primary, #d97706); color: #fff; font-size: 9px; font-weight: 600; line-height: 14px; text-align: center; box-sizing: border-box; flex-shrink: 0; }
 [data-edrv-view] .edrv-tree-loading { height: 22px; line-height: 22px; color: var(--dsw-alias-label-tertiary, #9aa5b1); font-size: 11px; }
 [data-edrv-view] .edrv-tree-error { display: flex; align-items: center; gap: 8px; margin: 4px 2px 6px; padding: 6px 8px; border: 1px solid rgba(217,83,79,.4); border-radius: 6px; background: #fdeaea; color: var(--dsw-alias-state-error-primary, #d9534f); font-size: 11px; }
+/* 大纲面板：kind 字形 / detail / 行号 */
+[data-edrv-view] .edrv-outline-kind { display: inline-flex; align-items: center; justify-content: center; width: 14px; flex-shrink: 0; font-size: 12px; font-weight: 600; text-align: center; }
+[data-edrv-view] .edrv-outline-kind.edrv-ol-func { color: var(--dsw-alias-brand-primary, #0f9d58); }
+[data-edrv-view] .edrv-outline-kind.edrv-ol-type { color: var(--dsw-alias-label-primary, #1f2933); }
+[data-edrv-view] .edrv-outline-kind.edrv-ol-data { color: var(--dsw-alias-state-warn-primary, #d97706); }
+[data-edrv-view] .edrv-outline-kind.edrv-ol-ns { color: var(--dsw-alias-label-secondary, #52606d); }
+[data-edrv-view] .edrv-outline-kind.edrv-ol-key { color: var(--dsw-alias-label-tertiary, #9aa5b1); }
+[data-edrv-view] .edrv-outline-detail { flex-shrink: 0; max-width: 40%; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; color: var(--dsw-alias-label-tertiary, #9aa5b1); font-size: 11px; }
+[data-edrv-view] .edrv-outline-ln { flex-shrink: 0; padding-right: 2px; color: var(--dsw-alias-label-tertiary, #9aa5b1); font-size: 10px; font-variant-numeric: tabular-nums; }
 [data-edrv-view] .edrv-side-resize { width: 5px; flex-shrink: 0; cursor: col-resize; background: transparent; }
 [data-edrv-view] .edrv-side-resize:hover { background: var(--dsw-alias-brand-primary, #0f9d58); opacity: .35; }
 [data-edrv-view] .edrv-chip-btn.edrv-chip-on { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.12)); color: var(--dsw-alias-label-primary, #1f2933); }

package/src/client/ui/ContextMenu.ts

@@ -0,0 +1,82 @@
+/**
+ * dsh-vscode-mode client — 通用浮动右键菜单（createElement 风格、类型化）。
+ * 全屏 backdrop（点击/右键/Esc 关闭）+ 固定定位（viewport clamp 防越界），
+ * 条目支持 danger/disabled/separator，复用既有 edrv-ctxmenu* 样式类。
+ * 作者 ddj 2026-08-27
+ */
+import React from 'react'
+
+/** 单条菜单项（展示层形状；业务侧由 buildTreeMenu 映射而来）。 */
+export interface ContextMenuEntry {
+  id: string
+  label: string
+  danger?: boolean
+  disabled?: boolean
+  /** 前置分隔线。 */
+  separator?: boolean
+  onClick?: () => void
+}
+
+export interface ContextMenuProps {
+  x: number
+  y: number
+  entries: ContextMenuEntry[]
+  onClose: () => void
+}
+
+/** 菜单估算宽高（clamp 防越出视口，与 EditorView menuPos 常量对齐）。 */
+const MENU_W = 224
+const MENU_H = 176
+
+/**
+ * 浮动右键菜单。
+ * @param props.x 视口 x 坐标
+ * @param props.y 视口 y 坐标
+ * @param props.entries 菜单项列表
+ * @param props.onClose 关闭回调（backdrop 点击/右键/Esc/点击项后触发）
+ */
+export function ContextMenu(props: ContextMenuProps): React.ReactElement {
+  const { x, y, entries, onClose } = props
+
+  React.useEffect(() => {
+    const onKey = (e: KeyboardEvent): void => {
+      if (e.key === 'Escape') onClose()
+    }
+    window.addEventListener('keydown', onKey, true)
+    return () => window.removeEventListener('keydown', onKey, true)
+  }, [onClose])
+
+  const left = Math.max(4, Math.min(x, (window.innerWidth || 800) - MENU_W))
+  const top = Math.max(4, Math.min(y, (window.innerHeight || 600) - MENU_H))
+
+  const children: React.ReactNode[] = []
+  for (const entry of entries) {
+    if (entry.separator) {
+      children.push(React.createElement('div', { key: 'sep-' + entry.id, className: 'edrv-ctxmenu-sep' }))
+      continue
+    }
+    const cls = 'edrv-ctxmenu-item'
+      + (entry.danger ? ' edrv-ctxmenu-danger' : '')
+      + (entry.disabled ? ' edrv-ctxmenu-disabled' : '')
+    children.push(React.createElement('button', {
+      key: entry.id,
+      className: cls,
+      disabled: entry.disabled,
+      onClick: () => {
+        if (!entry.disabled) {
+          entry.onClick?.()
+          onClose()
+        }
+      },
+    }, entry.label))
+  }
+
+  return React.createElement(React.Fragment, null,
+    React.createElement('div', {
+      className: 'edrv-ctxmenu-backdrop',
+      style: { position: 'fixed', inset: 0, zIndex: 70 },
+      onClick: onClose,
+      onContextMenu: (e: React.MouseEvent) => { e.preventDefault(); onClose() },
+    }),
+    React.createElement('div', { className: 'edrv-ctxmenu', style: { left, top } }, ...children))
+}

package/src/client/ui/EditorView.ts

@@ -18,6 +18,7 @@ import { SidebarView } from '../sidebar/SidebarView.js'
 import { clearDiffDock, publishDiffDock } from '../diffDockStore.js'
 import { displayDiffTotal, editorDockMode } from '../diffDock.js'
 import { editorHeight } from '../editorLayout.js'
+import { revealInExplorer as revealPathInExplorer } from '../fileReveal.js'
 
 /**
  * 中央编辑区：文件页签（脏点/关闭/打开路径）+ Ctrl+P 搜索 + Monaco 编辑器 +
@@ -491,6 +492,12 @@ export function EditorView(props) {
         if (s && p) menuHandlers()?.addRefToChat(p, { startLine: s.startLine, endLine: s.endLine })
       },
     })
+    // 在 OS 文件浏览器中打开/定位当前活动文件（与文件管理栏右键菜单同源能力）。
+    ed.addAction({
+      id: 'edrv.revealInExplorer', label: '在文件浏览器中打开', contextMenuGroupId: '1_edrv',
+      precondition: 'editorTextFocus',
+      run: (edx) => menuHandlers()?.openInExplorer(pathOf(edx)),
+    })
     // hover 差异块 → 浮出 Keep/Undo（req：鼠标移到编辑区差异块时显示）
     // 防闪烁：① 区域不变不 setState（浮窗锚定差异块起始行，不跟随鼠标）；② 延迟隐藏；
     // ③ 浮窗自身 onMouseEnter 取消隐藏计时（鼠标在浮窗与编辑器间移动不闪）。
@@ -751,8 +758,23 @@ export function EditorView(props) {
     addToConversation.appendReference(sessionId, path, range).then((o) => setStatus(statusOfAdd(o, '已添加文件引用')))
   }
 
+  /**
+   * 在 OS 文件浏览器中打开/定位路径（Monaco 右键菜单用，状态栏反馈）。
+   * @author ddj 2026年08月27号
+   * @param path 工作区相对路径（可能为 null）
+   */
+  const openInExplorer = (path) => {
+    if (!path) { setStatus('无活动文件'); return }
+    if (!sessionId) { setStatus('无活动会话'); return }
+    setStatus('正在打开文件浏览器…')
+    revealPathInExplorer(sessionId, path).then((outcome) => {
+      setStatus(outcome.ok ? '已在文件浏览器中打开' : '打开失败')
+      if (!outcome.ok && outcome.error) setError(outcome.error)
+    })
+  }
+
   // 供 Monaco 原生右键菜单 addAction 读取的最新动作闭包（空依赖回调不随渲染重建）
-  menuHandlersRef.current = { addRefToChat }
+  menuHandlersRef.current = { addRefToChat, openInExplorer }
 
   const openFile = (path, focusDiff) => {
     if (!path) return
@@ -949,6 +971,10 @@ export function EditorView(props) {
     pendingByPath,
     sum: { totalFiles: sum.totalFiles, files: sum.files },
     refreshRecords: () => refreshRecords(),
+    editor: () => editorRef.current,
+    outlineSources: props.outlineSources,
+    fileMenuItems: props.fileMenuItems,
+    notify: (message) => setStatus(message),
   }
 
   // 主编辑列（侧边栏右侧）：pathBar + tabRow + 编辑/差异区（底部整条留给 DSH 对话输入栏）

package/src/compat.ts

@@ -52,10 +52,12 @@ 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)
+  const sub = ctx.get('subprocess') as { spawn?: unknown } | undefined
   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 ? '可读写设置' : '不可用（设置读写走配置回退）' },
+    { name: '文件浏览器打开（subprocess 服务）', active: typeof sub?.spawn === 'function', note: typeof sub?.spawn === 'function' ? '可定位/打开 OS 文件浏览器' : '不可用（右键「在文件浏览器中打开」将提示失败）' },
   ]
 }