dsh-vscode-mode 0.5.3 → 0.7.0

package/src/client/dap/variableTree.ts

@@ -0,0 +1,62 @@
+/**
+ * dsh-vscode-mode client — DAP 变量树纯函数。
+ * 把 DAP variablesReference 缓存展平成可渲染 sibling rows，避免把子行嵌套进父级
+ * 横向 flex 行导致变量重叠；同时限制递归深度与总行数，保护侧栏性能。
+ * 作者 ddj 2026年09月29号
+ */
+
+/** DAP 变量最小视图。 */
+export interface VariableLike {
+  name: string
+  value: string
+  type?: string
+  ref: number
+}
+
+/** 展平后的变量行。 */
+export interface VariableRow {
+  key: string
+  variable: VariableLike
+  depth: number
+}
+
+/** 展平选项。 */
+export interface VariableTreeOptions {
+  maxRows?: number
+  maxDepth?: number
+}
+
+/**
+ * 将变量树展平为 sibling rows；循环 ref 只展开一次，避免异常适配器数据造成递归。
+ * @author ddj 2026年09月29号
+ * @param roots 根变量
+ * @param expanded 已展开的 variablesReference
+ * @param cache ref → 子变量缓存
+ * @param options 行数/深度上限
+ */
+export function flattenVariableRows(
+  roots: readonly VariableLike[],
+  expanded: ReadonlySet<number>,
+  cache: ReadonlyMap<number, readonly VariableLike[]>,
+  options: VariableTreeOptions = {},
+): VariableRow[] {
+  const rows: VariableRow[] = []
+  const maxRows = options.maxRows ?? 1000
+  const maxDepth = options.maxDepth ?? 32
+  const walk = (items: readonly VariableLike[], depth: number, ancestry: ReadonlySet<number>, prefix: string): void => {
+    if (depth > maxDepth || rows.length >= maxRows) return
+    for (let index = 0; index < items.length && rows.length < maxRows; index += 1) {
+      const variable = items[index]
+      const key = prefix + '/' + index + ':' + variable.name
+      rows.push({ key, variable, depth })
+      if (variable.ref <= 0 || !expanded.has(variable.ref) || ancestry.has(variable.ref)) continue
+      const children = cache.get(variable.ref)
+      if (!children?.length) continue
+      const nextAncestry = new Set(ancestry)
+      nextAncestry.add(variable.ref)
+      walk(children, depth + 1, nextAncestry, key)
+    }
+  }
+  walk(roots, 0, new Set(), 'root')
+  return rows
+}

package/src/client/fileClipboard.ts

@@ -0,0 +1,46 @@
+/**
+ * dsh-vscode-mode client — 文件剪贴板（剪切/复制/粘贴的应用内单槽）。
+ *
+ * 浏览器拿不到系统文件剪贴板，按 VS Code 语义做应用内文件剪贴板：
+ * 「剪切/复制」只登记源路径，「粘贴」时才走 edrv.fsMove / edrv.fsCopy 真正落盘。
+ * 模块级单槽（同 searchSeed 一次性槽模式），不依赖 React/DOM，可 node 单测。
+ * 作者 ddj 2026年09月22号
+ */
+
+/** 文件剪贴板内容。 */
+export interface FileClip {
+  /** copy = 复制；cut = 剪切（粘贴后源被移走）。 */
+  mode: 'copy' | 'cut'
+  /** 源路径（工作区相对）。 */
+  path: string
+}
+
+/** 单槽剪贴板（null = 空）。 */
+let clip: FileClip | null = null
+
+/**
+ * 写入文件剪贴板（重复以最后一次为准）。
+ * @author ddj 2026年09月22号
+ * @param mode copy = 复制；cut = 剪切
+ * @param path 源路径（工作区相对）
+ */
+export function setFileClip(mode: FileClip['mode'], path: string): void {
+  clip = { mode, path }
+}
+
+/**
+ * 读取当前剪贴板（不清空；粘贴执行与「粘贴」灰显判定共用）。
+ * @author ddj 2026年09月22号
+ * @returns 剪贴板内容；空槽返回 null
+ */
+export function fileClipOf(): FileClip | null {
+  return clip
+}
+
+/**
+ * 清空文件剪贴板（剪切粘贴成功后；测试隔离用）。
+ * @author ddj 2026年09月22号
+ */
+export function clearFileClip(): void {
+  clip = null
+}

package/src/client/index.ts

@@ -41,6 +41,7 @@ import { createFilePanel } from './sidebar/panels/index.js'
 import { createSearchPanel } from './sidebar/panels/index.js'
 import { createRulesPanel } from './sidebar/panels/index.js'
 import { createSvnPanel } from './sidebar/panels/index.js'
+import { createDebugPanel } from './sidebar/panels/index.js'
 import { createTreeMenuRegistry } from './sidebar/contextMenu.js'
 import { createDefaultFileMenuItems } from './sidebar/menuItems.js'
 import { createOutlinePanel } from './outline/index.js'
@@ -54,8 +55,10 @@ import { editorLimitApply } from './editorLimit.js'
 import { log } from './log.js'
 import { setupLsp, setSession, disposeLsp } from './monaco/lsp/index.js'
 import { disposeSnippets } from './snippets/provider.js'
+import { disposeLaunchJson } from './dap/launchSnippetProvider.js'
 import { disposeAiInline } from './ai/inlineProvider.js'
 import { readSessionScope, subscribeScope } from './sessionScope.js'
+import { dapStore } from './dap/store.js'
 import type { CompatAdapter } from '../shared/compat.js'
 
 // ⚠️ inject 只列必需服务：webUiSettings 是 @linxin666/dsh-client-ui-web-ui-settings 提供的
@@ -194,6 +197,11 @@ export function apply(ctx: any): void {
   ctx.effect(() => sidebarPanels.register(createRulesPanel()), 'vscode-mode: sidebar panel rules')
   // SVN 变更面板：活动栏「SVN 变更」页签（工作副本状态列表；visible 守卫使非 SVN 工作区不出现）
   ctx.effect(() => sidebarPanels.register(createSvnPanel()), 'vscode-mode: sidebar panel svn')
+  // 调试面板：活动栏「调试」页签（VS Code 调试视图四段布局 + REPL；DAP 桥接）
+  ctx.effect(() => sidebarPanels.register(createDebugPanel()), 'vscode-mode: sidebar panel debug')
+  // 客户端（重）装配对账：host 的 DapSession 常驻，而本模块状态随刷新/HMR 归零，
+  // 不对账则调试面板与暂停态 hover 静默失效（见 dapStore.resync）。
+  void dapStore.resync()
   // 文件右键菜单项注册表（对外 provide，供本插件/第三方注册；内置「在文件浏览器中打开」）
   const fileMenuItems = createTreeMenuRegistry()
   ctx.provide('edrvFileContextMenuItems', fileMenuItems)
@@ -216,7 +224,7 @@ export function apply(ctx: any): void {
     return sidebar ? registry.register(sidebar) : undefined
   }, 'vscode-mode: sidebar file opener')
   // 官方侧边栏正文组件装配（页类型正文；兼作 file 认领转发失败时的兜底正文）
-  const officialRenderTab = (props: Record<string, unknown>) => React.createElement(OfficialSideTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, sessions }))
+  const officialRenderTab = (props: Record<string, unknown>) => React.createElement(OfficialSideTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, fileOpeners: registry, sessions }))
   /** 官方 file 地址认领同步：自动/VSCodeMode 档认领（转发进单一编辑器页签），其余交官方查看器。 */
   const syncFileClaim = (): void => {
     const official = officialService
@@ -326,7 +334,7 @@ export function apply(ctx: any): void {
       order: 5,
       label: '文件编辑',
       inject: (sessionId: string) => ({ sessionId }),
-    }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { layout: 'tab', sideHint: SIDEBAR_INSTALL_CMD, schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, sessions })))
+    }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { layout: 'tab', sideHint: SIDEBAR_INSTALL_CMD, schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, fileOpeners: registry, sessions })))
   }
 
   // 侧边栏三形态互斥切换：官方（DSH 0.1.5+）> better-sidebar（归档，仅旧版回退）> 中央页签。
@@ -377,7 +385,7 @@ export function apply(ctx: any): void {
       if (legacyDisposer !== null) { legacyDisposer(); legacyDisposer = null }
       sideDisposer = ctx.effect(() => installSideEditor({
         service: sideService as NonNullable<typeof sideService>,
-        renderTab: (props: Record<string, unknown>) => React.createElement(SideEditorTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, sessions })),
+        renderTab: (props: Record<string, unknown>) => React.createElement(SideEditorTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, fileOpeners: registry, sessions })),
         activeSession: () => {
           const scope = readSessionScope(ctx)
           if (!scope.sessionId) return undefined
@@ -448,6 +456,7 @@ export function apply(ctx: any): void {
   // 不做会导致重载后重复注册（补全/跳转/hover 各翻倍）与陈旧开关残留。
   ctx.effect(() => () => {
     try { disposeSnippets() } catch { /* 卸载异常不得阻断其余清理 */ }
+    try { disposeLaunchJson() } catch { /* 同上 */ }
     try { disposeAiInline() } catch { /* 同上 */ }
     try { disposeLsp() } catch { /* 同上 */ }
   }, 'vscode-mode: monaco providers teardown')

package/src/client/monaco/lsp/index.ts

@@ -6,6 +6,9 @@
  * 作者 ddj 2026-08-27
  */
 import { registerLspProviders, disposeLspProviders, hideReferencesOverlay } from './providers.js'
+import { registerDapHover, disposeDapHover } from '../../dap/hover.js'
+import { installHoverTree, disposeHoverTree } from '../../dap/hoverTree.js'
+import { installHoverMode, disposeHoverMode } from '../../dap/hoverMode.js'
 import { setLspSession, refreshStatus, lspStatusFor, onLspProgress, bindLspSession } from './lspClient.js'
 
 let monacoRef = null
@@ -19,7 +22,16 @@ const LSP_SESSION_GLOBAL = '__edrvLspSessionUnbind__'
 /** Monaco 加载后装配（幂等；重复调用仅刷新会话）。 */
 export function setupLsp(monaco) {
   monacoRef = monaco
+  // 注册顺序决定同分 provider 的 ordinal：LanguageFeatureRegistry._compareByScoreAndTime 对
+  // 同分选择器按 _time 倒序（后注册者排前），hover 部件再按 ordinal 升序渲染 —— 因此 DAP
+  // 必须**最后**注册，暂停态的调试值行才会稳定渲染在 LSP 文档行之前；反序会让调试值被
+  // LSP 长文档挤到浮窗下方（超出 maxHeight 需滚动，等同看不到）。
   registerLspProviders(monaco)
+  registerDapHover(monaco)
+  // hover 变量树的 DOM 绑定（观察 hover 面板插入/重渲染；幂等）
+  installHoverTree()
+  // Alt 跟踪：暂停态默认调试值浮窗、按住 Alt 切 LSP 信息（对齐 CodeBuddy）
+  installHoverMode()
   // 会话广播订阅只装一次：跨重载时上一代已订阅（取消函数落 window，模块级状态会复位），
   // 只判 sessionBound 会重复订阅 → 同一 LSP 会话事件被处理多次。
   const host = /* @__PURE__ */ (typeof window === 'undefined' ? undefined : window)
@@ -52,6 +64,9 @@ export function disposeLspOverlay() {
  */
 export function disposeLsp() {
   disposeLspProviders()
+  disposeDapHover()
+  disposeHoverTree()
+  disposeHoverMode()
   const unbind = sessionUnbind
   if (typeof unbind === 'function') {
     try { unbind() } catch { /* 已解绑 */ }

package/src/client/monaco/lsp/providers.ts

@@ -136,6 +136,8 @@ export function registerLspProviders(monaco) {
     }),
     monaco.languages.registerHoverProvider(LSP_LANGS, {
       provideHover: async (model, position, token) => {
+        // 暂停态的 LSP 行由调试 hover 层默认隐藏、按住 Alt 时显示（见 dap/hoverTree.ts），
+        // 因此这里照常返回内容，不再按位置让位。
         const path = pathOfModel(model)
         if (!path) return null
         const hover = await fetchHover(path, model.getValue(), position)

package/src/client/monaco/theme.ts

@@ -137,6 +137,14 @@ const DARK_COLORS = {
   'scrollbarSlider.background': '#79797966',
   'scrollbarSlider.hoverBackground': '#646464b3',
   'scrollbarSlider.activeBackground': '#bfbfbf66',
+  // 差异视图色块（本仓库 vendored Monaco 无 .line-insert 静态背景规则，靠主题键保证；
+  // 色相取自研差异 UI 同源：绿 #0f9d58 / 红 #d9534f，alpha 提到肉眼可辨）
+  'diffEditor.insertedLineBackground': '#0f9d5830',
+  'diffEditor.removedLineBackground': '#d9534f2e',
+  'diffEditor.insertedTextBackground': '#0f9d5833',
+  'diffEditor.removedTextBackground': '#d9534f40',
+  'diffEditorGutter.insertedLineBackground': '#0f9d5859',
+  'diffEditorGutter.removedLineBackground': '#d9534f59',
 }
 
 const LIGHT_COLORS = {
@@ -157,6 +165,13 @@ const LIGHT_COLORS = {
   'scrollbarSlider.background': '#64646466',
   'scrollbarSlider.hoverBackground': '#646464b3',
   'scrollbarSlider.activeBackground': '#00000099',
+  // 差异视图色块（同上：主题键保证整行背景可见；色相/透明度与暗色一致）
+  'diffEditor.insertedLineBackground': '#0f9d5830',
+  'diffEditor.removedLineBackground': '#d9534f2e',
+  'diffEditor.insertedTextBackground': '#0f9d5833',
+  'diffEditor.removedTextBackground': '#d9534f40',
+  'diffEditorGutter.insertedLineBackground': '#0f9d5859',
+  'diffEditorGutter.removedLineBackground': '#d9534f59',
 }
 
 /**

package/src/client/openWithDialog.ts

@@ -0,0 +1,66 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 「打开方式…」选择弹窗（资源管理器右键、文件目标专属）。
+ * 列出 fileOpeners 注册表中当前可用的打开器（本插件/官方侧栏/系统等），
+ * 选中即调用该打开器 open()；复用 ModalShell 视觉，Esc/遮罩/取消 = 不打开。
+ * 作者 ddj 2026年09月22号
+ */
+import React from 'react'
+import { createRoot } from 'react-dom/client'
+import { availableOpeners, isAvailable } from './fileOpeners.js'
+import { ModalShell } from './ui/ModalShell.js'
+
+/** 打开器列表行样式（列表为一次性选择器，不进 editor.css 的常驻样式表）。 */
+const ITEM_STYLE = {
+  display: 'flex', flexDirection: 'column', gap: 2, width: '100%', textAlign: 'left',
+  padding: '8px 10px', marginBottom: 6, borderRadius: 6, cursor: 'pointer',
+}
+
+/** 打开器选择卡片（ModalShell 内容）。 */
+function OpenWithCard({ openers, onPick, onCancel }) {
+  return React.createElement(React.Fragment, null,
+    React.createElement('h3', null, '打开方式…'),
+    openers.map((opener) => React.createElement('button', {
+      key: opener.id,
+      style: ITEM_STYLE,
+      title: opener.description || opener.label,
+      onClick: () => onPick(opener),
+    },
+      React.createElement('span', null, opener.label),
+      opener.description ? React.createElement('span', { style: { fontSize: 12, opacity: 0.7 } }, opener.description) : null)),
+    React.createElement('div', { className: 'vsm-mcp-dialog-actions' },
+      React.createElement('button', { onClick: onCancel }, '取消')))
+}
+
+/**
+ * 弹出打开器选择弹窗；选中后立即以该打开器打开目标文件。
+ * @author ddj 2026年09月22号
+ * @param registry 文件打开器注册表
+ * @param context 打开上下文（会话/工作区）
+ * @param path 目标文件（工作区相对）
+ * @param onDone 结果回调（opened = 实际使用的打开器；null = 取消/未打开），反馈文案由调用方接线
+ */
+export function openWithDialog(registry, context, path, onDone) {
+  const openers = availableOpeners(registry)
+  if (!openers.length) {
+    onDone?.(null)
+    return
+  }
+  const host = document.createElement('div')
+  document.body.appendChild(host)
+  const root = createRoot(host)
+  const close = () => {
+    root.unmount()
+    host.remove()
+  }
+  const pick = (opener) => {
+    close()
+    if (!isAvailable(opener)) {
+      onDone?.(null)
+      return
+    }
+    Promise.resolve(opener.open(path, context)).then(() => onDone?.(opener)).catch(() => onDone?.(null))
+  }
+  root.render(React.createElement(ModalShell, { onClose: () => { close(); onDone?.(null) } },
+    React.createElement(OpenWithCard, { openers, onPick: pick, onCancel: () => { close(); onDone?.(null) } })))
+}

package/src/client/searchSeed.ts

@@ -62,3 +62,39 @@ export function takeSearchSeed(): string {
 export function clearSearchSeed(): void {
   pendingSeed = null
 }
+
+// --region 目录过滤种子（「在文件夹中查找…」：SearchPanel 消费后置 include 过滤）
+
+/** 待消费的目录过滤种子（'' = 无）。 */
+let pendingScope: string | null = null
+
+/**
+ * 写入待消费的目录过滤种子（空目录等价于清除）。
+ * @author ddj 2026年09月22号
+ * @param dir 目标目录（工作区相对；空 = 根 = 不限定目录）
+ */
+export function setSearchScope(dir: unknown): void {
+  const text = String(dir ?? '').trim().replace(/\\/g, '/').replace(/\/+$/, '')
+  pendingScope = text ? text : null
+}
+
+/**
+ * 取走待消费的目录过滤种子（取后即清空，与 query 种子同一一次性消费语义）。
+ * @author ddj 2026年09月22号
+ * @returns 目录相对路径；无待消费种子返回空串
+ */
+export function takeSearchScope(): string {
+  const scope = pendingScope
+  pendingScope = null
+  return scope ?? ''
+}
+
+/**
+ * 清空待消费的目录过滤种子（测试隔离用）。
+ * @author ddj 2026年09月22号
+ */
+export function clearSearchScope(): void {
+  pendingScope = null
+}
+
+// --endregion

package/src/client/sidebar/contextMenu.ts

@@ -18,14 +18,17 @@ export interface TreeMenuTarget {
 /** 一条右键菜单项定义。 */
 export interface TreeMenuItem {
   id: string
-  label: string
+  /** 展示文案；目标相关时可传函数（buildTreeMenu 解析为字符串）。 */
+  label: string | ((target: TreeMenuTarget, ctx: SidebarCtx) => string)
   /** 排序：数值越小越靠前（缺省 100）。 */
   order?: number
+  /** 分组：同组条目相邻成块，组切换处由 buildTreeMenu 动态置前置分隔线（缺省不参与分组）。 */
+  group?: number
   /** 红色警示样式（如删除类操作）。 */
   danger?: boolean
-  /** 置灰不可点（如无权限/目标不支持时）。 */
-  disabled?: boolean
-  /** 前置分隔线。 */
+  /** 置灰不可点（如无权限/目标不支持时）：布尔或按目标动态求值。 */
+  disabled?: boolean | ((target: TreeMenuTarget, ctx: SidebarCtx) => boolean)
+  /** 前置分隔线（不带 group 的存量/第三方条目沿用静态语义）。 */
   separator?: boolean
   /** 显隐守卫：返回 false 则不显示。 */
   visible?: (target: TreeMenuTarget, ctx: SidebarCtx) => boolean
@@ -81,19 +84,57 @@ export function createTreeMenuRegistry(): TreeMenuRegistry {
 }
 
 /**
- * 按目标构建当前可见菜单项（visible 过滤 + order 排序）。
- * @author ddj 2026年08月27号
+ * 按目标解析动态字段并计算前置分隔线（纯函数）。
+ *
+ * 分隔线口径：
+ * - 带 group 的条目：与前一条可见条目组号不同即出线（首条除外）——组首条被 visible
+ *   隐藏时下一条自动顶上分组头，不丢线也不重复出线；
+ * - 不带 group 的存量/第三方条目：沿用其静态 separator；
+ * - 统一收尾：相邻分隔线合并为一条（动态组头与静态分隔线相邻时不叠双线）。
+ * @author ddj 2026年09月22号
+ * @param items 可见条目（已按 visible 过滤、按 order 排序）
+ * @param target 右键目标（动态 label/disabled 求值用）
+ * @param ctx 面板共享上下文
+ * @returns 解析后的条目（label/disabled 已定值、separator 已定值）
+ */
+export function markMenuSeparators(
+  items: readonly TreeMenuItem[],
+  target: TreeMenuTarget,
+  ctx: SidebarCtx,
+): TreeMenuItem[] {
+  const out: TreeMenuItem[] = []
+  let prevGroup: number | null = null
+  let sepEmitted = false
+  for (const item of items) {
+    const grouped = typeof item.group === 'number'
+    let sep = grouped ? (out.length > 0 && item.group !== prevGroup) : (item.separator === true && out.length > 0)
+    if (grouped) prevGroup = item.group as number
+    if (sep && sepEmitted) sep = false
+    sepEmitted = sep
+    out.push({
+      ...item,
+      label: typeof item.label === 'function' ? item.label(target, ctx) : item.label,
+      disabled: typeof item.disabled === 'function' ? item.disabled(target, ctx) === true : item.disabled === true,
+      separator: sep,
+    })
+  }
+  return out
+}
+
+/**
+ * 按目标构建当前可见菜单项（visible 过滤 + order 排序 + 动态字段解析 + 分组分隔线）。
+ * @author ddj 2026年08月27号 / 2026年09月22号
  * @param registry 菜单项注册表
  * @param target 右键目标
  * @param ctx 面板共享上下文
- * @returns 可见菜单项（已排序）
+ * @returns 可见菜单项（已排序、已解析）
  */
 export function buildTreeMenu(registry: TreeMenuRegistry | undefined, target: TreeMenuTarget, ctx: SidebarCtx): TreeMenuItem[] {
   if (!registry) return []
-  const out: TreeMenuItem[] = []
+  const visible: TreeMenuItem[] = []
   for (const item of registry.list()) {
     if (typeof item.visible === 'function' && !item.visible(target, ctx)) continue
-    out.push(item)
+    visible.push(item)
   }
-  return out
+  return markMenuSeparators(visible, target, ctx)
 }