dsh-vscode-mode 0.1.21 → 0.1.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 中央编辑器（文件页签/QuickOpen/状态栏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚），状态持久化到工作区旁车",
   "keywords": [
     "dsh",

package/src/client/fileReveal.ts

@@ -0,0 +1,28 @@
+/**
+ * dsh-vscode-mode client — 「在文件浏览器中打开」RPC 包装（树菜单与 Monaco 右键共用）。
+ * 归一化为 { ok, error? }，不抛异常；无会话/异常降级返回错误文案。
+ * 作者 ddj 2026-08-27
+ */
+import { rpc } from './rpc.js'
+
+export interface RevealOutcome {
+  ok: boolean
+  error?: string
+}
+
+/**
+ * 请求 host 在 OS 文件浏览器中打开/定位路径。
+ * @author ddj 2026年08月27号
+ * @param sessionId 会话 id（可空）
+ * @param path 工作区相对路径（'' = 根目录）
+ * @returns 成功或失败原因
+ */
+export async function revealInExplorer(sessionId: string | undefined, path: string): Promise<RevealOutcome> {
+  if (!sessionId) return { ok: false, error: '无活动会话' }
+  try {
+    const res = await rpc('edrv.revealInExplorer', { sessionId, path })
+    return res.ok ? { ok: true } : { ok: false, error: res.error }
+  } catch (error) {
+    return { ok: false, error: '打开异常:' + String(error) }
+  }
+}

package/src/client/index.ts

@@ -28,6 +28,8 @@ import { SIDEBAR_PLUGIN, pickSettingsBinder, registerSlotSafely } from './compat
 import { createAddToConversation } from './addToConversation.js'
 import { createSidebarPanelRegistry } from './sidebar/registry.js'
 import { createFilePanel } from './sidebar/panels/index.js'
+import { createTreeMenuRegistry } from './sidebar/contextMenu.js'
+import { createDefaultFileMenuItems } from './sidebar/menuItems.js'
 import { createOutlinePanel } from './outline/index.js'
 import { createOutlineSourceRegistry, registerBuiltinOutlineSources } from './outline/sources.js'
 import type { CompatAdapter } from '../shared/compat.js'
@@ -87,6 +89,12 @@ export function apply(ctx: any): void {
   const sidebarPanels = createSidebarPanelRegistry()
   ctx.provide('edrvSidebarPanels', sidebarPanels)
   ctx.effect(() => sidebarPanels.register(createFilePanel()), 'vscode-mode: sidebar panel')
+  // 文件右键菜单项注册表（对外 provide，供本插件/第三方注册；内置「在文件浏览器中打开」）
+  const fileMenuItems = createTreeMenuRegistry()
+  ctx.provide('edrvFileContextMenuItems', fileMenuItems)
+  for (const item of createDefaultFileMenuItems()) {
+    ctx.effect(() => fileMenuItems.register(item), 'vscode-mode: file context menu item ' + item.id)
+  }
   // 大纲源注册表（公开预留口）：第三方语言插件（LSP/VSIX 等）注册更高优先级源即可覆盖兜底
   const outlineSources = createOutlineSourceRegistry()
   ctx.provide('edrvOutlineSources', outlineSources)
@@ -133,7 +141,7 @@ export function apply(ctx: any): void {
     order: 5,
     label: '文件编辑',
     inject: (sessionId: string) => ({ sessionId }),
-  }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources })))
+  }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems })))
 
   // 对话输入框上方差异 dock：普通对话显示单文案按钮，文件编辑页由 EditorView 隐藏
   registerSlotSafely(ctx, {

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

@@ -4,6 +4,7 @@
  * 作者 ddj 2026-08-26
  */
 import type { OutlineSourceRegistry } from '../outline/types.js'
+import type { TreeMenuRegistry } from './contextMenu.js'
 
 /** 面板可用的共享上下文（由 SidebarView 从 EditorView 注入，面板不直碰其内部）。 */
 export interface SidebarCtx {
@@ -20,6 +21,10 @@ export interface SidebarCtx {
   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; }

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
@@ -951,6 +973,8 @@ export function EditorView(props) {
     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 文件浏览器' : '不可用（右键「在文件浏览器中打开」将提示失败）' },
   ]
 }
 

package/src/reveal.ts

@@ -0,0 +1,64 @@
+/**
+ * dsh-vscode-mode host — 在 OS 文件浏览器中打开/定位路径（reveal 能力）。
+ * 纯函数 revealCommand 平台分发 + revealInExplorer 经 ctx.subprocess.spawn 发射
+ * （argv 数组、无 shell 插值，沿 workspace/revert 的 subprocess 契约）。
+ * 文件 → 资源管理器选中定位；目录 → 打开目录；Linux 无通用定位协议 → 打开所在目录。
+ * 作者 ddj 2026-08-27
+ */
+import { dirname } from 'node:path'
+import type { Ctx } from './store.js'
+
+/** reveal 结果（沿 revert.ts 的 Result 风格）。 */
+export type RevealResult = { ok: true } | { ok: false; error: string }
+
+/**
+ * 构造平台 opener 的 argv（纯函数，platform 可注入便于单测）。
+ * @author ddj 2026年08月27号
+ * @param absPath 绝对路径
+ * @param isDir 是否为目录
+ * @param platform 目标平台（缺省当前进程平台）
+ * @returns opener argv（无 shell 插值）
+ */
+export function revealCommand(absPath: string, isDir: boolean, platform: NodeJS.Platform = process.platform): { argv: string[] } {
+  switch (platform) {
+    case 'darwin':
+      return { argv: ['open', '-R', absPath] }
+    case 'win32':
+      // 文件 → 定位并选中；目录 → 直接打开该目录
+      return isDir
+        ? { argv: ['explorer.exe', absPath] }
+        : { argv: ['explorer.exe', '/select,', absPath] }
+    default:
+      // Linux 无通用 select 协议：文件打开所在目录、目录打开自身（KISS，对齐 better-sidebar）
+      return { argv: ['xdg-open', isDir ? absPath : dirname(absPath)] }
+  }
+}
+
+/**
+ * 经 host subprocess 服务发射 opener（fire-and-forget 语义）。
+ * Explorer 为 GUI 分离进程，非零退出码不视为失败；仅 spawn 级错误回失败。
+ * @author ddj 2026年08月27号
+ * @param ctx DSH host 上下文
+ * @param absPath 绝对路径
+ * @param isDir 是否为目录
+ * @returns 成功或失败原因
+ */
+export async function revealInExplorer(ctx: Ctx, absPath: string, isDir: boolean): Promise<RevealResult> {
+  const sub = ctx.get('subprocess')
+  if (!sub || typeof sub.spawn !== 'function') {
+    return { ok: false, error: '打开文件浏览器不可用：缺少 subprocess 服务' }
+  }
+  const { argv } = revealCommand(absPath, isDir)
+  try {
+    const handle = sub.spawn({
+      argv,
+      cwd: dirname(absPath),
+      stdio: { stdout: { maxBytes: 1 << 16 }, stderr: { maxBytes: 1 << 16 }, stdin: 'ignore' },
+      graceMs: 10000,
+    })
+    await handle.done
+    return { ok: true }
+  } catch (error) {
+    return { ok: false, error: '打开失败：' + String(error) }
+  }
+}

package/src/rpc.ts

@@ -30,6 +30,7 @@ import { normalizeFileOpenTool, FILE_OPEN_DEFAULT, FILE_OPEN_SETTINGS_NS } from
 import { buildReport } from './compat.js'
 import { readDevForm, setDevForm } from './devForm.js'
 import { normalizeRel, toTreeEntries } from './tree.js'
+import { revealInExplorer } from './reveal.js'
 
 /** cwd → Promise 链：串行化 debug 日志追加（fs read+write 非原子，避免并发丢行）。 */
 const debugWriteQueues = new Map<string, Promise<void>>()
@@ -336,6 +337,26 @@ export function buildHandlers(ctx: Ctx, registry: Registry, searcher = newSearch
         return { ok: false, error: '读取目录失败：' + String(error) }
       }
     },
+    'edrv.revealInExplorer': async (args) => {
+      // 在 OS 文件浏览器中打开/定位路径（树行/编辑器右键菜单用），相对工作区解析。
+      const sc = await requireSession(ctx, args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      const fs = ctx.get('fs')
+      if (!fs) return { ok: false, error: '缺少 fs' }
+      try {
+        const rel = normalizeRel(args.path)
+        if (rel === null) return { ok: false, error: '路径不合法' }
+        const target = await fs.resolve(rel || '.', { cwd: sc.cwd })
+        const info = await fs.stat(target)
+        if (!info) return { ok: false, error: '路径不存在' }
+        const abs = fs.processPath(target)
+        const outcome = await revealInExplorer(ctx, abs, info.type === 'directory')
+        if (!outcome.ok) return { ok: false, error: outcome.error }
+        return { ok: true, revealed: abs }
+      } catch (error) {
+        return { ok: false, error: '打开失败：' + String(error) }
+      }
+    },
     'mcp.list': async () => ({ ok: true, ...listMcp(ctx) }),
     'mcp.save': async (args) => {
       try { return { ok: true, server: await saveMcp(ctx, args.config) } }

package/src/shared/rpc.ts

@@ -60,6 +60,7 @@ export interface RpcRequestMap {
   'edrv.debug': { sessionId?: string; text: string }
   'edrv.searchFiles': { sessionId?: string; query: string }
   'edrv.listDir': { sessionId?: string; path: string }
+  'edrv.revealInExplorer': { sessionId?: string; path: string }
   'mcp.list': {}
   'mcp.save': { config: MpcConfig }
   'mcp.remove': { id: string }
@@ -94,6 +95,7 @@ export interface RpcOkMap {
   'edrv.debug': object
   'edrv.searchFiles': { files: string[]; truncated: boolean }
   'edrv.listDir': { root: string; path: string; entries: TreeEntry[] }
+  'edrv.revealInExplorer': { revealed: string }
   'mcp.list': { servers: MpcServer[] }
   'mcp.save': { server: MpcServer }
   'mcp.remove': object