dsh-vscode-mode 0.5.2 → 0.6.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/editorLimit.ts

@@ -0,0 +1,31 @@
+/**
+ * dsh-vscode-mode client — 页签数量上限共享状态。
+ * 设置来源：dsh-vscode-mode 命名空间的 maxOpenEditors 字段（通用设置页可调）；
+ * 客户端 settings 订阅经 editorLimitApply 写入，编辑器经 getMaxOpenEditors 读取，
+ * 变更时由 client/index.ts 派发 edrv:max-open-editors 窗口事件通知编辑器复算淘汰。
+ * 形态与 sidebarMin.ts 一致（同一设置同步链路，便于统一维护）。
+ * 作者 ddj 2026年09月18号
+ */
+import { EDITOR_LIMIT_DEFAULT, normalizeMaxOpenEditors } from '../shared/editorLimit.js'
+
+let currentLimit = EDITOR_LIMIT_DEFAULT
+
+/**
+ * 应用设置值（client/index.ts 设置订阅同步调用）。
+ * @author ddj 2026年09月18号
+ * @param value 设置文档中的 maxOpenEditors
+ * @returns 归一化后的生效值（0 = 不限制）
+ */
+export function editorLimitApply(value: unknown): number {
+  currentLimit = normalizeMaxOpenEditors(value)
+  return currentLimit
+}
+
+/**
+ * 读取当前生效的页签上限（编辑器初始/事件回调共用；0 = 不限制）。
+ * @author ddj 2026年09月18号
+ * @returns 当前上限
+ */
+export function getMaxOpenEditors(): number {
+  return currentLimit
+}

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'
@@ -50,11 +51,14 @@ import { keybindingsApply } from './keybindings.js'
 import { createCommandBridge } from './commandBridge.js'
 import { REGISTRY_GLOBAL } from './commandGlobals.js'
 import { sidebarMinApply } from './sidebarMin.js'
+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 提供的
@@ -193,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)
@@ -246,6 +255,7 @@ export function apply(ctx: any): void {
   }, 'vscode-mode: file opener setting sync')
   // 快捷键配置同步：设置提交后立即刷新键位匹配（编辑器/QuickOpen 按事件时读取）
   // 同一订阅里顺带同步侧边栏最小宽度（sidebarMinWidth）→ 派发 edrv:sidebar-min-width 通知编辑器重夹
+  // 以及页签上限（maxOpenEditors）→ 派发 edrv:max-open-editors 通知编辑器复算淘汰
   ctx.effect(() => {
     if (!settings) return undefined
     const sync = (): void => {
@@ -254,6 +264,8 @@ export function apply(ctx: any): void {
       keybindingsApply(snapshot.value?.keybindings)
       const minW = sidebarMinApply(snapshot.value?.sidebarMinWidth)
       window.dispatchEvent(new CustomEvent('edrv:sidebar-min-width', { detail: { value: minW } }))
+      const limit = editorLimitApply(snapshot.value?.maxOpenEditors)
+      window.dispatchEvent(new CustomEvent('edrv:max-open-editors', { detail: { value: limit } }))
     }
     sync()
     return settings.subscribe(sync)
@@ -444,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/markdownPreview.ts

@@ -0,0 +1,24 @@
+/**
+ * dsh-vscode-mode client — Markdown 文件判定（编辑区预览用）。
+ * 纯函数、无 DOM/React 依赖，便于单测。
+ * @author ddj 2026年09月18号
+ */
+
+/** 可进入预览的 Markdown 扩展名（小写、无点）。 */
+const MARKDOWN_EXT_SET: Set<string> = new Set(['md', 'markdown'])
+
+/**
+ * 判断路径是否为可预览的 Markdown 文件（取 basename 扩展名，大小写不敏感）。
+ *
+ * 为什么不含 `mdx`：官方 MarkdownText 只走 GFM+KaTeX 语法，不解析 JSX；
+ * 对 .mdx 做「预览」会把 JSX 当字面文本渲染出来，比文本编辑更容易误导，故排除。
+ * @author ddj 2026年09月18号
+ * @param path 文件路径（`/` 或 `\` 分隔均可）
+ * @returns 是否 Markdown 文件
+ */
+export function isMarkdownPath(path: string): boolean {
+  const base = String(path || '').split(/[\\/]/).pop() || ''
+  const dot = base.lastIndexOf('.')
+  if (dot <= 0) return false
+  return MARKDOWN_EXT_SET.has(base.slice(dot + 1).toLowerCase())
+}

package/src/client/md/componentType.ts

@@ -0,0 +1,28 @@
+/**
+ * dsh-vscode-mode client — React 元素类型判定（纯函数，无 React/primitives 依赖）。
+ *
+ * 用途：编辑区 Markdown 预览要判断官方 `MarkdownText` 原语是否可用（旧版 DSH 可能缺该导出）。
+ *
+ * ⚠️ 为什么不能只判 `typeof value === 'function'`：
+ * 官方 `MarkdownText` 是 `React.memo(...)` 的产物（`MemoExoticComponent`），
+ * 其 `typeof` 是 **'object'** 而非 'function'。函数判据恒为 false，会让「兼容降级」分支在
+ * **所有新版 DSH 上永久生效** —— 表现是预览只显示纯文本降级提示。
+ * 该缺陷由 GUI 端到端验证捕获：纯函数单测不覆盖该守卫，手写垫片又把它声明得很宽松，
+ * 故 tsc 与既有测试都无法发现。抽出本模块正是为了让它有单测守约。
+ *
+ * 判定口径与 React 自身一致：函数（函数组件 / 类组件），或带 `$$typeof` 标记的非 null
+ * 对象（memo / forwardRef / lazy 等「外部对象类型」）。
+ * 作者 ddj 2026年09月18号
+ */
+
+/**
+ * 判断值是否可作为 React 元素类型传给 `React.createElement`。
+ * @author ddj 2026年09月18号
+ * @param value 候选组件（undefined/null 表示该导出不存在）
+ * @returns 是否可作为元素类型使用
+ */
+export function isComponentType(value: unknown): boolean {
+  if (typeof value === 'function') return true
+  if (typeof value !== 'object' || value === null) return false
+  return (value as { $$typeof?: unknown }).$$typeof !== undefined
+}

package/src/client/md/mdPanel.ts

@@ -0,0 +1,98 @@
+/**
+ * dsh-vscode-mode client — 编辑区 Markdown 预览面板。
+ *
+ * 需求 4：.md 文件支持预览。渲染复用官方 UI 原语 MarkdownText（GFM + KaTeX，走 --dsw-*
+ * 令牌自动跟随 DSH 主题与皮肤），不引入任何第三方 Markdown 依赖。
+ *
+ * 与既有图片 / PDF 面板的形态保持一致：工具条（meta + 切换按钮 + 刷新）+ 内容区。
+ * 本面板为**只读**视图（编辑仍在 Monaco 文本态完成），故不接收编辑回调、不参与脏标记。
+ *
+ * ⚠️ 兼容降级：旧版 DSH 的 primitives 可能没有 MarkdownText。此时渲染只读 <pre> 并给出
+ * 提示，绝不抛错白屏（与 pdf.js / Monaco 加载失败的降级口径一致）。
+ * 作者 ddj 2026年09月18号
+ */
+import React from 'react'
+import type { ComponentType, ReactNode } from 'react'
+import { MarkdownDelegateProvider, MarkdownText } from '@deepseek-ai/dsh-client-ui-primitives'
+import type { MarkdownLabels } from '@deepseek-ai/dsh-client-ui-primitives'
+import { isComponentType } from './componentType.js'
+
+/**
+ * 渲染 chrome 常量。必须是模块级稳定引用：MarkdownText 的 memo 以 labels 身份
+ * 参与缓存判定，每次渲染新建对象会让渲染缓存在流式场景反复失效。
+ */
+const MD_LABELS: MarkdownLabels = {
+  code: { copyLabel: '复制', copiedLabel: '已复制' },
+  footnotes: '脚注',
+}
+
+/**
+ * 官方原语声明在 client-primitives.d.ts 的手写垫片里，组件返回值只能声明为 unknown
+ * （该虚拟模块不入本地 node_modules，无法在环境声明中引用 react 类型）。
+ * 故在此把垫片面收敛成 react 可接受的组件类型，仅本文件承担这层转换；
+ * 原语在运行时缺失时由下方 hasMarkdownPrimitive 守卫降级。
+ */
+type MdTextProps = { text: string; streaming?: boolean; labels: MarkdownLabels; variant?: 'body' | 'compact' }
+type MdProviderProps = { children?: ReactNode; openFile?: (path: string, options?: { line?: number }) => void }
+
+const MdText = MarkdownText as unknown as ComponentType<MdTextProps>
+const MdProvider = MarkdownDelegateProvider as unknown as ComponentType<MdProviderProps>
+
+/** 官方 Markdown 原语是否可用（旧版 DSH 缺该导出时为 false）。 */
+const hasMarkdownPrimitive = isComponentType(MarkdownText)
+
+/** 文本行数（meta 展示用；空文本计 0 行）。 */
+function lineCountOf(text: string): number {
+  const value = String(text ?? '')
+  return value ? value.split(/\r?\n/).length : 0
+}
+
+/** 预览面板 props（面板由 EditorView 装配，故用宽松形状避免跨文件类型耦合）。 */
+interface MarkdownPanelProps {
+  /** Markdown 原文（取自编辑器已加载内容，无需额外 RPC）。 */
+  text?: string
+  /** 切回源码编辑（工具条按钮）。 */
+  onToggleSource?: () => void
+  /** 重新读取文件（工具条刷新按钮）。 */
+  onReload?: () => void
+  /** 打开 Markdown 内的本地文件链接（可空：不给则链接保持纯文本）。 */
+  onOpenFile?: (path: string, options?: { line?: number }) => void
+}
+
+/**
+ * Markdown 预览面板。
+ * @author ddj 2026年09月18号
+ * @param props 面板输入（原文与三个动作回调）
+ * @returns 预览面板元素
+ */
+export function MarkdownPanel(props: MarkdownPanelProps) {
+  const text = String(props?.text ?? '')
+  const onToggleSource = props?.onToggleSource
+  const onReload = props?.onReload
+  const onOpenFile = props?.onOpenFile
+  const chars = text.length
+  const lines = lineCountOf(text)
+
+  const body = hasMarkdownPrimitive
+    ? React.createElement(MdProvider, {
+        openFile: typeof onOpenFile === 'function' ? onOpenFile : undefined,
+      }, React.createElement(MdText, { text, streaming: false, labels: MD_LABELS, variant: 'body' }))
+    : React.createElement('div', { className: 'edrv-mdview-fallback' },
+        React.createElement('div', null, '当前 DSH 版本不含 Markdown 渲染原语，已降级为纯文本预览。'),
+        React.createElement('pre', { className: 'edrv-mdview-pre' }, text))
+
+  return React.createElement('div', { className: 'edrv-mdview' },
+    React.createElement('div', { className: 'edrv-mdview-bar' },
+      React.createElement('span', { className: 'edrv-mdview-meta' }, lines + ' 行 · ' + chars + ' 字符'),
+      React.createElement('span', { style: { flex: 1 } }),
+      React.createElement('button', {
+        className: 'edrv-pill edrv-pill-ghost', title: '切回源码编辑',
+        onClick: () => onToggleSource?.(),
+      }, '以源码打开'),
+      React.createElement('button', {
+        className: 'edrv-pill edrv-pill-ghost', title: '重新读取文件',
+        onClick: () => onReload?.(),
+      }, '⟳ 刷新')),
+    React.createElement('div', { className: 'edrv-mdview-stage' },
+      React.createElement('div', { className: 'edrv-mdview-doc' }, body)))
+}

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/searchSeed.ts

@@ -0,0 +1,64 @@
+/**
+ * dsh-vscode-mode client — 工作区搜索的「选区种子」。
+ *
+ * 需求：Ctrl+Shift+F 时若编辑器有选中，把选中文本自动填入搜索框。
+ * 链路：EditorView 从 Monaco 取选区文本 → seedQueryOf 归一 → setSearchSeed 存入一次性槽
+ * → 派发 edrv:search-focus → SearchPanel 消费（挂载时或已挂载时），填入并立即搜索。
+ *
+ * 为什么用一次性槽而不是事件 detail：
+ * 侧边栏原本收起时搜索面板**尚未挂载**，派发瞬间没有监听者；事件 detail 会丢。
+ * 槽在 EditorView 与 SearchPanel 之间充当交接点，挂载后由消费方自行取走。
+ *
+ * 为什么取首行：搜索框是单行 input，ripgrep 按字面连续匹配。多行选区（整段/整函数）
+ * 作为单条 query 永远无匹配，故按项目既有口径取首行（与 VS Code 单行选区种子行为一致）。
+ *
+ * 纯逻辑 + 模块级槽，不依赖 React/DOM，可 node 单测。
+ * 作者 ddj 2026年09月18号
+ */
+
+/** 种子最大长度（超长选区只取前 N 字符，防一次性把巨型 query 送进搜索）。 */
+export const SEED_MAX = 200
+
+/**
+ * 由选区文本推导搜索种子。
+ * @author ddj 2026年09月18号
+ * @param text 选区原文（可能含多行、前后空白；null/undefined 视为空）
+ * @returns 归一后的搜索词；无效输入返回空串（调用方据此保持原搜索词）
+ */
+export function seedQueryOf(text: unknown): string {
+  const raw = String(text ?? '')
+  if (!raw) return ''
+  const firstLine = raw.split(/\r?\n/)[0] ?? ''
+  const trimmed = firstLine.trim()
+  if (!trimmed) return ''
+  return trimmed.length > SEED_MAX ? trimmed.slice(0, SEED_MAX) : trimmed
+}
+
+/** 一次性种子槽（字符串或 null；null 表示无待消费种子）。 */
+let pendingSeed: string | null = null
+
+/**
+ * 写入待消费种子（空词等价于清除）。
+ * @author ddj 2026年09月18号
+ * @param text 选区文本（经 seedQueryOf 归一）
+ */
+export function setSearchSeed(text: unknown): void {
+  const seed = seedQueryOf(text)
+  pendingSeed = seed ? seed : null
+}
+
+/**
+ * 取走待消费种子（取后即清空，保证挂载路径与焦点路径不会重复应用同一个种子）。
+ * @author ddj 2026年09月18号
+ * @returns 种子搜索词；无待消费种子返回空串
+ */
+export function takeSearchSeed(): string {
+  const seed = pendingSeed
+  pendingSeed = null
+  return seed ?? ''
+}
+
+/** 清空待消费种子（测试隔离用）。 */
+export function clearSearchSeed(): void {
+  pendingSeed = null
+}