dsh-vscode-mode 0.1.44 → 0.1.46

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.44",
+  "version": "0.1.46",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 dsh-better-sidebar 侧边栏与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",

package/src/client/keybindings.ts

@@ -1,6 +1,6 @@
 /**
  * dsh-vscode-mode client — 快捷键配置模块（解析/匹配/状态同步）。
- * 纯逻辑（parseChord/formatChord/matchEvent/chordFromEvent/normalizeKey）不依赖 DOM，可单测；
+ * 纯逻辑（parseChord/parseChords/formatChord/matchEvent/chordFromEvent/normalizeKey）不依赖 DOM，可单测；
  * 模块状态由 settings 订阅驱动（client/index.ts 调 keybindingsApply）。
  * 键位语义：Ctrl 与 Cmd 互认（延续现有 Ctrl+P/Ctrl+B 捕获行为）。
  * 作者 ddj 2026年08月26号
@@ -23,6 +23,8 @@ export const COMMANDS: Array<{ id: string; label: string }> = [
   { id: 'edrv.quickOpen', label: '快速打开文件' },
   { id: 'edrv.toggleSidebar', label: '切换侧边栏' },
   { id: 'edrv.searchInFiles', label: '在工作区中搜索' },
+  { id: 'edrv.navigateBack', label: '后退（导航历史）' },
+  { id: 'edrv.navigateForward', label: '前进（导航历史）' },
 ]
 
 const MODIFIERS: Record<string, 'ctrl' | 'shift' | 'alt' | 'meta'> = {
@@ -30,18 +32,19 @@ const MODIFIERS: Record<string, 'ctrl' | 'shift' | 'alt' | 'meta'> = {
 }
 
 let current: Record<string, string> = { ...KEYBINDING_DEFAULTS }
-let parsed: Record<string, Binding | null> = {}
+let parsed: Record<string, Binding[]> = {}
 const listeners = new Set<() => void>()
 
 /**
  * 应用设置快照（与默认值合并；未知 id 丢弃；空对象 = 全部默认）。
+ * 每个命令可含多候选键位（`|` 分隔），任一命中即触发。
  * @author ddj 2026年08月26号
  * @param raw 设置 scope 的 keybindings 字段
  */
 export function keybindingsApply(raw: unknown): void {
   current = { ...KEYBINDING_DEFAULTS, ...normalizeKeybindings(raw) }
   parsed = {}
-  for (const id of Object.keys(current)) parsed[id] = parseChord(current[id])
+  for (const id of Object.keys(current)) parsed[id] = parseChords(current[id])
   for (const listener of listeners) {
     try { listener() } catch { /* 监听器异常不影响其他订阅 */ }
   }
@@ -70,13 +73,13 @@ export function chordOf(id: string): string | null {
 }
 
 /**
- * 当前命令的解析键位（未绑定/非法 → null）。
+ * 当前命令的解析键位集合（未绑定/非法 → 空数组；含多候选）。
  * @author ddj 2026年08月26号
  * @param id 命令 id
- * @returns 解析键位或 null
+ * @returns 解析键位数组（可能为空）
  */
-export function bindingOf(id: string): Binding | null {
-  return parsed[id] ?? null
+export function bindingsOf(id: string): Binding[] {
+  return parsed[id] ?? []
 }
 
 /**
@@ -114,6 +117,26 @@ export function parseChord(chord: string): Binding | null {
   return binding.key ? binding : null
 }
 
+/**
+ * 解析多候选键位弦（`|` 分隔）：逐段解析，丢弃非法段，去重。
+ * @author ddj 2026年08月26号
+ * @param chord 键位弦（如 `Alt+ArrowLeft|Ctrl+Alt+-`）
+ * @returns 解析键位数组（纯 `|`/空/非法 → 空数组）
+ */
+export function parseChords(chord: string): Binding[] {
+  const out: Binding[] = []
+  const seen = new Set<string>()
+  for (const part of String(chord ?? '').split('|')) {
+    const binding = parseChord(part)
+    if (!binding) continue
+    const key = formatChord(binding)
+    if (seen.has(key)) continue
+    seen.add(key)
+    out.push(binding)
+  }
+  return out
+}
+
 /**
  * 格式化键位（Ctrl/Cmd/Shift/Alt + 主键；meta 显示 Cmd）。
  * @author ddj 2026年08月26号
@@ -131,18 +154,21 @@ export function formatChord(binding: Binding): string {
 }
 
 /**
- * 事件是否命中键位（Ctrl 与 Cmd 互认）。
+ * 事件是否命中键位（Ctrl 与 Cmd 互认；多候选任一命中即 true）。
  * @author ddj 2026年08月26号
  * @param e 键盘事件（鸭子类型，便于单测）
- * @param binding 解析键位（null = 未绑定，永不命中）
+ * @param bindings 解析键位或键位数组（null/空 = 未绑定，永不命中）
  * @returns 是否命中
  */
-export function matchEvent(e: { ctrlKey?: boolean; metaKey?: boolean; shiftKey?: boolean; altKey?: boolean; key?: string }, binding: Binding | null): boolean {
-  if (!binding) return false
-  if ((e.ctrlKey || e.metaKey) !== (binding.ctrl || binding.meta)) return false
-  if (Boolean(e.shiftKey) !== binding.shift) return false
-  if (Boolean(e.altKey) !== binding.alt) return false
-  return normalizeKey(e.key ?? '') === binding.key
+export function matchEvent(e: { ctrlKey?: boolean; metaKey?: boolean; shiftKey?: boolean; altKey?: boolean; key?: string }, bindings: Binding | Binding[] | null): boolean {
+  const list = Array.isArray(bindings) ? bindings : bindings ? [bindings] : []
+  for (const binding of list) {
+    if (Boolean(e.ctrlKey || e.metaKey) !== (binding.ctrl || binding.meta)) continue
+    if (Boolean(e.shiftKey) !== binding.shift) continue
+    if (Boolean(e.altKey) !== binding.alt) continue
+    if (normalizeKey(e.key ?? '') === binding.key) return true
+  }
+  return false
 }
 
 /**

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

@@ -197,7 +197,16 @@ export async function gotoRefsAt(ed, position) {
   if (!path || !position) return
   const all = await findReferences(path, model.getValue(), position, false)
   const others = filterOtherRefs(all, path, position)
-  if (!others.length) return
+  if (!others.length) {
+    // 0 条「其它」引用：降级查定义（参数/局部变量只被声明时引用为空，定义可经 host 降级链推导）
+    const defs = await findDefinition(path, model.getValue(), position)
+    const first = defs[0]
+    if (!first) return
+    const lspPos = monoToLsp(position.lineNumber, position.column)
+    if (sameFile(targetOpenPath(first), path) && posInRange(lspPos, first.lspRange)) return // 定义即自身：无其它可跳，保持静默
+    jumpToLocation(first)
+    return
+  }
   if (others.length === 1) {
     jumpToLocation(others[0])
     return

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

@@ -0,0 +1,101 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — Ctrl+hover 可导航标识符下划线提示。
+ * 背景：内嵌 Monaco 构建（0.42.0-dev）无 linkDetection contrib，原生不产生 ctrl+hover 下划线，
+ * 插件自绘：Ctrl/Meta 按住悬停在"语义 token 标识符"上时给词加下划线装饰，移出/松开即清除。
+ * 数据来源于语义 token（每 model+version 缓存 60s），不做逐词 LSP 查询。
+ * 作者 ddj 2026-09-02
+ */
+import { pathOfModel, fetchSemanticTokens } from './lspClient.js'
+import { decodeSemanticTokens, isNavigableTokenType } from '../../../shared/lsp.js'
+
+const CACHE_TTL_MS = 60_000
+
+/**
+ * 给一个 Monaco 编辑器绑定 Ctrl+hover 下划线提示（幂等）。
+ * @author ddj 2026年09月02号
+ * @param ed Monaco 编辑器
+ * @param monaco Monaco 实例
+ */
+export function bindLspUnderline(ed, monaco) {
+  if (!ed || !monaco || ed.__edrvUnderline) return
+  ed.__edrvUnderline = true
+  let decoIds = []
+  let lastKey = null
+  let hoverSeq = 0
+  let cache = { path: null, version: -1, ranges: null, at: 0 }
+
+  const clear = () => {
+    if (decoIds.length) {
+      ed.deltaDecorations(decoIds, [])
+      decoIds = []
+    }
+    lastKey = null
+  }
+
+  /** 取当前文档语义 token 范围（模型版本 + TTL 缓存）。 */
+  const rangesOf = async (model) => {
+    const path = pathOfModel(model)
+    const version = model.getVersionId?.() ?? 0
+    if (cache.path === path && cache.version === version && cache.ranges && Date.now() - cache.at < CACHE_TTL_MS) {
+      return cache.ranges
+    }
+    const res = await fetchSemanticTokens(path, model.getValue()).catch(() => null)
+    const ranges = res && Array.isArray(res.data) ? decodeSemanticTokens(res.data) : []
+    cache = { path, version, ranges, at: Date.now() }
+    return ranges
+  }
+
+  ed.onMouseMove((event) => {
+    const native = event?.event
+    const ctrl = native?.ctrlKey ?? false
+    const meta = native?.metaKey ?? false
+    if (!ctrl && !meta) {
+      clear()
+      hoverSeq++
+      return
+    }
+    const pos = event?.target?.position
+    const model = ed.getModel()
+    if (!pos || !model) {
+      clear()
+      hoverSeq++
+      return
+    }
+    const word = model.getWordAtPosition(pos)
+    if (!word) {
+      clear()
+      hoverSeq++
+      return
+    }
+    const seq = ++hoverSeq
+    const path = pathOfModel(model)
+    void rangesOf(model).then((ranges) => {
+      if (seq !== hoverSeq) return // 鼠标已移走，忽略过期结果
+      const lineIndex = Math.max(0, word.startLineNumber - 1)
+      const startCol = Math.max(0, word.startColumn - 1)
+      const endCol = Math.max(startCol, word.endColumn - 1)
+      const hit = ranges.some((r) => {
+        if (r.start.line !== lineIndex) return false
+        return isNavigableTokenType(r.type) && r.start.character <= startCol && r.end.character >= endCol
+      })
+      if (!hit) {
+        if (lastKey !== null) clear()
+        return
+      }
+      const key = String(path) + ':' + word.startColumn + ':' + word.endColumn
+      if (key === lastKey) return
+      lastKey = key
+      decoIds = ed.deltaDecorations(decoIds, [{
+        range: new monaco.Range(word.startLineNumber, word.startColumn, word.endLineNumber, word.endColumn),
+        options: { inlineClassName: 'edrv-nav-underline' },
+      }])
+    })
+  })
+
+  ed.onMouseLeave(() => clear())
+  ed.onDidBlurEditorText?.(() => clear())
+}
+
+/** 兼容占位（与 providers 的 hideReferencesOverlay 对称，无需真正释放）。 */
+export function disposeLspUnderline() {}

package/src/client/navHistory.ts

@@ -0,0 +1,104 @@
+/**
+ * dsh-vscode-mode client — 编辑器导航历史（后退/前进）纯逻辑。
+ * 对齐 VSCode Go Back / Go Forward（navigation history）：记录「文件 + 焦点位置」访问轨迹，
+ * 后退回到上一处焦点，前进回到下一处，跨文件生效。
+ * 数据模型：past（末位 = 当前）+ future 两个栈；record 压栈并清空 future；
+ * 与栈顶同 path+line+column 视为同一位置：仅刷新 viewState 快照，不压栈、不清 future。
+ * 纯逻辑无 DOM 依赖，可单测。
+ * 作者 ddj 2026年09月04号
+ */
+
+/** 导航历史单条记录：文件 + 焦点位置（+ 可选的 viewState 快照用于恢复滚动/折叠）。 */
+export interface NavEntry {
+  /** 工作区相对路径 */
+  path: string
+  /** 焦点行（1-based） */
+  line?: number
+  /** 焦点列（1-based） */
+  column?: number
+  /** 该位置保存的 Monaco viewState（恢复滚动/折叠） */
+  viewState?: unknown
+}
+
+/** 导航历史接口。 */
+export interface NavHistory {
+  /** 记录当前位置（压栈 + 清空 future；与栈顶同位置时仅更新 viewState）。 */
+  record(entry: NavEntry): void
+  /** 后退：返回将要恢复的前一条目；历史不足 2 条 → null。 */
+  back(): NavEntry | null
+  /** 前进：返回将要恢复的条目；future 空 → null。 */
+  forward(): NavEntry | null
+  /** 是否可后退。 */
+  canBack(): boolean
+  /** 是否可前进。 */
+  canForward(): boolean
+  /** 后退目标条目（不改变状态；不可退 → null）。 */
+  peekBack(): NavEntry | null
+  /** 前进目标条目（不改变状态；不可进 → null）。 */
+  peekForward(): NavEntry | null
+}
+
+/** 后退栈默认容量上限（超出逐出最旧）。 */
+export const NAV_HISTORY_CAP = 200
+
+/** 路径一致（容忍相对路径大小写差异，对齐既有 sameFile 语义常用写法）。 */
+function samePath(a: string, b: string): boolean {
+  if (a === b) return true
+  return String(a).replace(/\\/g, '/').toLowerCase() === String(b).replace(/\\/g, '/').toLowerCase()
+}
+
+/** 位置一致（无焦点时按 null 归一，`undefined`/`null` 视为相等）。 */
+function samePos(a: NavEntry, b: NavEntry): boolean {
+  if (!samePath(a.path, b.path)) return false
+  return (a.line ?? null) === (b.line ?? null) && (a.column ?? null) === (b.column ?? null)
+}
+
+/**
+ * 创建导航历史实例（容量裁剪到 cap）。
+ * @author ddj 2026年09月04号
+ * @param cap 后退栈容量上限（默认 NAV_HISTORY_CAP）
+ * @returns 导航历史实例
+ */
+export function createNavHistory(cap = NAV_HISTORY_CAP): NavHistory {
+  const past: NavEntry[] = []
+  const future: NavEntry[] = []
+  return {
+    record(entry: NavEntry): void {
+      if (!entry || !entry.path) return
+      const top = past[past.length - 1]
+      if (top && samePos(top, entry)) {
+        // 同一位置：只更新 viewState 快照（滚动/折叠可能变化），栈与 future 不动
+        if (top.viewState !== undefined || entry.viewState !== undefined) top.viewState = entry.viewState
+        return
+      }
+      past.push({ path: entry.path, line: entry.line, column: entry.column, viewState: entry.viewState })
+      if (past.length > cap) past.splice(0, past.length - cap)
+      future.length = 0
+    },
+    back(): NavEntry | null {
+      if (past.length < 2) return null
+      const current = past.pop()
+      if (!current) return null
+      future.push(current)
+      return past[past.length - 1]
+    },
+    forward(): NavEntry | null {
+      const entry = future.pop()
+      if (!entry) return null
+      past.push(entry)
+      return entry
+    },
+    canBack(): boolean {
+      return past.length >= 2
+    },
+    canForward(): boolean {
+      return future.length > 0
+    },
+    peekBack(): NavEntry | null {
+      return past.length >= 2 ? past[past.length - 2] : null
+    },
+    peekForward(): NavEntry | null {
+      return future.length ? future[future.length - 1] : null
+    },
+  }
+}

package/src/client/styles/editor.css

@@ -40,9 +40,13 @@
 [data-edrv-view] .edrv-lsp-status-dot.ready { background: var(--dsw-alias-state-success-primary, #0f9d58); }
 [data-edrv-view] .edrv-lsp-status-dot.busy { background: var(--dsw-alias-state-warn-primary, #d97706); animation: edrv-lsp-pulse 1.2s ease-in-out infinite; }
 @keyframes edrv-lsp-pulse { 50% { opacity: .45; } }
+/* Ctrl+hover 可导航标识符下划线提示（绑定 Monaco inlineClassName 装饰） */
+[data-edrv-view] .edrv-nav-underline { text-decoration: underline; text-decoration-color: var(--dsw-alias-interactive-primary, #4fc1ff); text-underline-offset: 1px; cursor: pointer; }
 [data-edrv-view] .edrv-diffchip { font-size: 11px; padding: 2px 10px; border: 1px solid var(--dsw-alias-border-l1, #333); border-radius: 999px; background: var(--dsw-alias-bg-layer-2, transparent); color: var(--dsw-alias-state-warn-primary, #b7791f); cursor: pointer; white-space: nowrap; flex-shrink: 0; }
 [data-edrv-view] .edrv-chip-btn { font-size: 12px; padding: 2px 6px; border: none; background: transparent; color: var(--dsw-alias-label-secondary, #aaa); cursor: pointer; border-radius: 4px; flex-shrink: 0; }
 [data-edrv-view] .edrv-chip-btn:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(255,255,255,.06)); }
+[data-edrv-view] .edrv-chip-btn:disabled { opacity: .35; cursor: default; }
+[data-edrv-view] .edrv-chip-btn:disabled:hover { background: transparent; }
 [data-edrv-view] .edrv-mn-add-line { background: rgba(15,157,88,.10); }
 [data-edrv-view] .edrv-mn-gutter-add { color: #0f9d58 !important; font-weight: 700; display: flex !important; align-items: center; justify-content: center; }
 [data-edrv-view] .edrv-mn-gutter-add::before { content: "+"; }