dsh-vscode-mode 0.1.63 → 0.2.0

package/src/client/keybindings.ts

@@ -2,11 +2,15 @@
  * dsh-vscode-mode client — 快捷键配置模块（解析/匹配/状态同步）。
  * 纯逻辑（parseChord/parseChords/formatChord/matchEvent/chordFromEvent/normalizeKey）不依赖 DOM，可单测；
  * 模块状态由 settings 订阅驱动（client/index.ts 调 keybindingsApply）。
- * 键位语义：Ctrl 与 Cmd 互认（延续现有 Ctrl+P/Ctrl+B 捕获行为）。
- * 作者 ddj 2026年08月26号
+ * 键位语义：Ctrl 与 Cmd 互认（延续 Ctrl+P/Ctrl+B 捕获行为）。
+ * 命令目录（COMMANDS）派生自指令目录 commandCatalog（指令 = 单一数据源，设置页自动跟随）；
+ * 另支持运行时键位表（第三方命令 register 时声明，不落设置 schema，注销即失效）。
+ * 作者 ddj 2026年08月26号 / 2026年09月10号
  */
 import React from 'react'
 import { KEYBINDING_DEFAULTS, normalizeKeybindings } from '../shared/keybindings.js'
+import { BRIDGE_COMMANDS, EDITOR_COMMANDS, showCommandsDef } from './ui/commandCatalog.js'
+import { log } from './log.js'
 
 /** 解析后的键位（修饰符 + 规范化主键）。 */
 export interface Binding {
@@ -19,24 +23,39 @@ export interface Binding {
 
 /** 命令目录（设置页展示标签；执行按目录序先匹配先执行，冲突键位确定性）。 */
 export const COMMANDS: Array<{ id: string; label: string }> = [
-  { id: 'edrv.save', label: '保存文件' },
-  { id: 'edrv.quickOpen', label: '快速打开文件' },
-  { id: 'edrv.toggleSidebar', label: '切换侧边栏' },
-  { id: 'edrv.searchInFiles', label: '在工作区中搜索' },
-  { id: 'edrv.navigateBack', label: '后退（导航历史）' },
-  { id: 'edrv.navigateForward', label: '前进（导航历史）' },
-  { id: 'edrv.nextTab', label: '下一个页签' },
-  { id: 'edrv.prevTab', label: '上一个页签' },
+  ...EDITOR_COMMANDS.map((command) => ({ id: command.id, label: command.label })),
+  { id: 'edrv.showCommands', label: '显示所有命令' },
+  ...BRIDGE_COMMANDS.map((command) => ({ id: command.id, label: command.label })),
 ]
 
+/** 命令栏命令定义（键位自检与目录展示共用；run 不参与键位逻辑）。 */
+function paletteCommand(): { id: string; label: string; keybinding?: string } {
+  return showCommandsDef(() => {})
+}
+
+/**
+ * 目录与默认键位表一致性自检（仅告警不中断）：新指令漏写共享表时第一时间可见。
+ * @author ddj 2026年09月10号
+ */
+function checkDefaultsDrift(): void {
+  for (const command of [...EDITOR_COMMANDS, paletteCommand()]) {
+    if (!command.keybinding) continue
+    if (KEYBINDING_DEFAULTS[command.id] === command.keybinding) continue
+    log.warn('指令默认键位与共享表不一致：' + command.id
+      + ' 目录=' + command.keybinding + ' 共享表=' + String(KEYBINDING_DEFAULTS[command.id]))
+  }
+}
+
 const MODIFIERS: Record<string, 'ctrl' | 'shift' | 'alt' | 'meta'> = {
   ctrl: 'ctrl', cmd: 'meta', meta: 'meta', shift: 'shift', alt: 'alt',
 }
 
 let current: Record<string, string> = { ...KEYBINDING_DEFAULTS }
-let parsed: Record<string, Binding[]> = {}
+const runtime = new Map<string, Binding[]>()
 const listeners = new Set<() => void>()
 
+checkDefaultsDrift()
+
 /**
  * 应用设置快照（与默认值合并；未知 id 丢弃；空对象 = 全部默认）。
  * 每个命令可含多候选键位（`|` 分隔），任一命中即触发。
@@ -45,8 +64,6 @@ const listeners = new Set<() => void>()
  */
 export function keybindingsApply(raw: unknown): void {
   current = { ...KEYBINDING_DEFAULTS, ...normalizeKeybindings(raw) }
-  parsed = {}
-  for (const id of Object.keys(current)) parsed[id] = parseChords(current[id])
   for (const listener of listeners) {
     try { listener() } catch { /* 监听器异常不影响其他订阅 */ }
   }
@@ -64,24 +81,61 @@ export function subscribeKeybindings(listener: () => void): () => void {
 }
 
 /**
- * 当前键位弦（未绑定/空 → null）。
- * @author ddj 2026年08月26号
+ * 注册运行时键位（第三方命令；优先于设置值，注销即失效）。
+ * @author ddj 2026年09月10号
+ * @param id 命令 id
+ * @param chord 键位弦（空/非法按未绑定处理）
+ * @returns 注销函数（幂等）
+ */
+export function addRuntimeKeybinding(id: string, chord: string): () => void {
+  runtime.set(id, parseChords(chord))
+  notifyKeybindings()
+  return () => removeRuntimeKeybinding(id)
+}
+
+/**
+ * 移除运行时键位。
+ * @author ddj 2026年09月10号
+ * @param id 命令 id
+ */
+export function removeRuntimeKeybinding(id: string): void {
+  if (!runtime.delete(id)) return
+  notifyKeybindings()
+}
+
+/** 通知键位订阅者（异常隔离）。 */
+function notifyKeybindings(): void {
+  for (const listener of listeners) {
+    try { listener() } catch { /* 监听器异常不影响其他订阅 */ }
+  }
+}
+
+/**
+ * 当前命令的键位弦（运行时键位优先；未绑定/空 → null）。
+ * @author ddj 2026年08月26号 / 2026年09月10号
  * @param id 命令 id
  * @returns 键位弦或 null
  */
 export function chordOf(id: string): string | null {
+  if (runtime.has(id)) {
+    const chords = runtime.get(id) ?? []
+    return chords.length ? chords.map(formatChord).join('|') : null
+  }
   const chord = current[id]
   return typeof chord === 'string' && chord.trim() !== '' ? chord : null
 }
 
 /**
  * 当前命令的解析键位集合（未绑定/非法 → 空数组；含多候选）。
- * @author ddj 2026年08月26号
+ * @author ddj 2026年08月26号 / 2026年09月10号
  * @param id 命令 id
  * @returns 解析键位数组（可能为空）
  */
 export function bindingsOf(id: string): Binding[] {
-  return parsed[id] ?? []
+  const override = runtime.get(id)
+  if (override) return override
+  const chord = current[id]
+  return typeof chord === 'string' ? parseChords(chord) : []
 }
 
 /**

package/src/client/styles/editor.css

@@ -369,5 +369,19 @@
 [data-edrv-view] .edrv-rules-save { height: 24px; padding: 0 14px; border: none; border-radius: 6px; background: var(--dsw-alias-brand-primary, #0f9d58); color: var(--dsw-alias-label-primary-inverted, #fff); font-size: 12px; cursor: pointer; }
 [data-edrv-view] .edrv-rules-save:disabled { opacity: .5; cursor: default; }
 
+/* 命令栏（Ctrl+Shift+P / F1）：body 级 portal 浮层，故不依赖编辑区几何 */
+[data-edrv-view] .edrv-palette-mask { position: fixed; inset: 0; z-index: 190; background: rgba(0, 0, 0, .28); }
+[data-edrv-view] .edrv-palette { position: fixed; top: 12vh; left: 50%; transform: translateX(-50%); z-index: 191; width: min(580px, calc(100vw - 32px)); max-height: 64vh; display: flex; flex-direction: column; border-radius: 10px; background: var(--dsw-alias-bg-overlay, #ffffff); border: 1px solid var(--dsw-alias-border-l2, #cbd2d9); box-shadow: 0 12px 34px rgba(31, 41, 51, .24); overflow: hidden; }
+[data-edrv-view] .edrv-palette-input { height: 38px; flex: 0 0 auto; padding: 0 12px; border: none; border-bottom: 1px solid var(--dsw-alias-border-l1, #e0e6e8); background: transparent; color: var(--dsw-alias-label-primary, #1f2933); font-size: 13px; outline: none; }
+[data-edrv-view] .edrv-palette-list { flex: 1 1 auto; min-height: 0; overflow: auto; padding: 4px; }
+[data-edrv-view] .edrv-palette-row { display: flex; align-items: center; gap: 8px; padding: 6px 10px; border-radius: 6px; font-size: 12px; color: var(--dsw-alias-label-primary, #1f2933); cursor: pointer; }
+[data-edrv-view] .edrv-palette-row.edrv-palette-sel { background: var(--dsw-alias-interactive-bg-hover, rgba(15, 157, 88, .10)); }
+[data-edrv-view] .edrv-palette-label { flex: 1 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+[data-edrv-view] .edrv-palette-cat { flex: 0 0 auto; font-size: 10px; padding: 1px 7px; border-radius: 999px; background: var(--dsw-alias-bg-layer-2, #f0f4f4); color: var(--dsw-alias-label-tertiary, #7b8794); }
+[data-edrv-view] .edrv-palette-key { flex: 0 0 auto; font-family: var(--ds-font-family-code, ui-monospace, monospace); font-size: 10px; padding: 1px 6px; border: 1px solid var(--dsw-alias-border-l1, #e0e6e8); border-radius: 5px; background: var(--dsw-alias-bg-layer-1, #f7f9fa); color: var(--dsw-alias-label-secondary, #52606d); }
+[data-edrv-view] .edrv-palette-empty { padding: 14px 10px; font-size: 12px; color: var(--dsw-alias-label-tertiary, #7b8794); text-align: center; }
+[data-edrv-view] .edrv-palette-notice { flex: 0 0 auto; padding: 6px 10px; border-top: 1px solid var(--dsw-alias-border-l1, #e0e6e8); font-size: 11px; color: var(--dsw-alias-state-warn-primary, #b7791f); }
+
+
 
 

package/src/client/ui/CommandPalette.ts

@@ -0,0 +1,158 @@
+/**
+ * dsh-vscode-mode client — 命令栏浮层（Ctrl+Shift+P / F1）。
+ * 订阅 commandPaletteStore 的开关状态；候选来自注入的指令注册表（window.dsh.edrvCommands），
+ * 过滤/排序复用 commandSearch 纯函数；↑↓ 选择、Enter 执行、Esc 或点击遮罩关闭。
+ * 浮层经 createPortal 渲染到 body，故不受编辑区三种形态（官方侧栏/better-sidebar/中央页签）影响；
+ * 宿主单实例由 store 的 claimPaletteHost 保证（另一个宿主自动返回 null）。
+ * 作者 ddj 2026年09月10号
+ */
+import React from 'react'
+import { createPortal } from 'react-dom'
+import { REGISTRY_GLOBAL } from '../commandGlobals.js'
+import { filterCommands } from '../commandSearch.js'
+import { createCommandRegistry } from '../commandRegistry.js'
+import type { CommandRegistry } from '../commandRegistry.js'
+import { chordOf } from '../keybindings.js'
+import {
+  claimPaletteHost, closeCommandPalette, isPaletteOpen, registryRef, releasePaletteHost,
+  runPaletteCommand, subscribePalette,
+} from '../commandPaletteStore.js'
+import type { CommandDef } from './commandCatalog.js'
+
+/** 空注册表（宿主未注入时的安全降级：命令栏可开但无候选）。 */
+let fallbackRegistry: CommandRegistry | null = null
+
+/**
+ * 读取指令注册表：① 装配期存入的模块引用（首选，不依赖全局）
+ * ② window[REGISTRY_GLOBAL] 镜像（第三方/调试场景）③ 空表降级（仅装配异常时）。
+ * @author ddj 2026年09月10号
+ * @returns 指令注册表
+ */
+function useRegistry(): CommandRegistry {
+  const injected = registryRef()
+  if (injected) return injected
+  const mirrored = typeof window === 'undefined'
+    ? undefined
+    : (window as unknown as Record<string, CommandRegistry | undefined>)[REGISTRY_GLOBAL]
+  if (mirrored) return mirrored
+  if (!fallbackRegistry) fallbackRegistry = createCommandRegistry()
+  return fallbackRegistry
+}
+
+/** 命令栏每一行的展示信息。 */
+interface PaletteRow {
+  command: CommandDef
+  chord: string | null
+}
+
+/**
+ * 组装候选行（先按可用性过滤，再按查询排序）。
+ * @author ddj 2026年09月10号
+ * @param registry 指令注册表
+ * @param query 用户输入
+ * @returns 候选行
+ */
+function rowsOf(registry: CommandRegistry, query: string): PaletteRow[] {
+  return filterCommands(registry.available(), query)
+    .map((command) => ({ command, chord: chordOf(command.id) }))
+}
+
+/**
+ * 命令栏浮层（未展开/非宿主时渲染 null）。
+ * @author ddj 2026年09月10号
+ * @returns 浮层 React 元素或 null
+ */
+export function CommandPalette(): React.ReactElement | null {
+  const open = React.useSyncExternalStore(subscribePalette, isPaletteOpen)
+  const registry = useRegistry()
+  const [token] = React.useState(() => (claimPaletteHost() ? {} : null))
+  const [query, setQuery] = React.useState('')
+  const [selected, setSelected] = React.useState(0)
+  const [notice, setNotice] = React.useState('')
+  const inputRef = React.useRef<HTMLInputElement | null>(null)
+  const host = token !== null
+
+  React.useEffect(() => () => releasePaletteHost(token), [token])
+  React.useEffect(() => {
+    if (!open) return undefined
+    setQuery('')
+    setSelected(0)
+    setNotice('')
+    const timer = setTimeout(() => inputRef.current?.focus(), 0)
+    return () => clearTimeout(timer)
+  }, [open])
+
+  const rows = React.useMemo(
+    () => (open && host ? rowsOf(registry, query) : []),
+    [open, host, registry, query],
+  )
+  const active = rows.length ? Math.min(selected, rows.length - 1) : 0
+
+  React.useEffect(() => {
+    if (!open) return
+    const node = document.querySelector('.edrv-palette-row.edrv-palette-sel')
+    const scroll = (node as HTMLElement | null)?.scrollIntoView
+    if (typeof scroll === 'function') scroll.call(node, { block: 'nearest' })
+  }, [open, active, rows.length])
+
+  /** 执行候选行（执行器内部会做可用性校验与异常上报）。 */
+  const execute = (row: PaletteRow | undefined): void => {
+    if (!row) return
+    closeCommandPalette()
+    if (!runPaletteCommand(row.command.id)) setNotice('命令未执行：' + row.command.label)
+  }
+
+  const onKeyDown = (event: React.KeyboardEvent<HTMLDivElement>): void => {
+    event.stopPropagation()
+    if (event.key === 'Escape') {
+      event.preventDefault()
+      closeCommandPalette()
+      return
+    }
+    if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+      event.preventDefault()
+      if (!rows.length) return
+      const step = event.key === 'ArrowDown' ? 1 : rows.length - 1
+      setSelected((value) => (Math.min(value, rows.length - 1) + step) % rows.length)
+      return
+    }
+    if (event.key === 'Enter') {
+      event.preventDefault()
+      execute(rows[active])
+    }
+  }
+
+  if (!open || !host || typeof document === 'undefined') return null
+  const list = rows.length
+    ? rows.map((row, index) => React.createElement('div', {
+        key: row.command.id,
+        className: 'edrv-palette-row' + (index === active ? ' edrv-palette-sel' : ''),
+        onMouseEnter: () => setSelected(index),
+        onClick: () => execute(row),
+      },
+        React.createElement('span', { className: 'edrv-palette-label' }, row.command.label),
+        React.createElement('span', { className: 'edrv-palette-cat' }, row.command.category),
+        row.chord ? React.createElement('kbd', { className: 'edrv-palette-key' }, row.chord) : null))
+    : React.createElement('div', { className: 'edrv-palette-empty' }, '无匹配命令')
+
+  const panel = React.createElement('div', { className: 'edrv-palette', 'data-edrv-palette': '1', onKeyDown },
+    React.createElement('input', {
+      ref: inputRef,
+      className: 'edrv-palette-input',
+      value: query,
+      placeholder: '输入命令名称…（↑↓ 选择 · Enter 执行 · Esc 关闭）',
+      spellCheck: false,
+      onChange: (event: React.ChangeEvent<HTMLInputElement>) => {
+        setQuery(event.target.value)
+        setSelected(0)
+        setNotice('')
+      },
+    }),
+    React.createElement('div', { className: 'edrv-palette-list' }, list),
+    notice ? React.createElement('div', { className: 'edrv-palette-notice' }, notice) : null)
+
+  const overlay = React.createElement('div', { 'data-edrv-view': '1' },
+    React.createElement('div', { className: 'edrv-palette-mask', onClick: () => closeCommandPalette() }),
+    panel)
+  return createPortal(overlay, document.body)
+}

package/src/client/ui/ConversationDiffDock.ts

@@ -11,6 +11,7 @@ import { summarize } from '../state/records.js'
 import { nextDiffPath } from '../diffDock.js'
 import { readDiffDock, subscribeDiffDock } from '../diffDockStore.js'
 import { DiffBox } from './DiffBox.js'
+import { CommandPalette } from './CommandPalette.js'
 
 const nextIndexBySession = new Map()
 
@@ -60,12 +61,17 @@ export function ConversationDiffDock(props) {
   }, content)
 
   const editorSnapshot = readDiffDock(sessionId)
+  // 命令栏浮层的兜底宿主：本 dock 是每会话常驻 slot（编辑区未挂载时仍能唤起命令栏）；
+  // 与 EditorView 同时挂载时由 commandPaletteStore 的单实例认领保证只渲染一份。
+  const palette = React.createElement(CommandPalette, { key: 'edrv-palette', sessionId })
   if (editorSnapshot) {
-    if (editorSnapshot.mode === 'editor-empty' && !editorSnapshot.fileTotal) return null
-    return renderDock(React.createElement(DiffBox, Object.assign({}, editorSnapshot, { dock: true })), sessionId)
+    if (editorSnapshot.mode === 'editor-empty' && !editorSnapshot.fileTotal) return palette
+    return React.createElement(React.Fragment, null,
+      renderDock(React.createElement(DiffBox, Object.assign({}, editorSnapshot, { dock: true })), sessionId),
+      palette)
   }
 
-  if (!sessionId || !summary?.pendingFiles?.length) return null
+  if (!sessionId || !summary?.pendingFiles?.length) return palette
 
   const paths = summary.pendingFiles.map((file) => file.path)
   const click = () => {
@@ -75,10 +81,12 @@ export function ConversationDiffDock(props) {
     if (next.path) openDiffView(next.path)
   }
 
-  return renderDock(React.createElement(DiffBox, {
-    mode: 'chat',
-    dock: true,
-    fileTotal: paths.length,
-    onOpenNextFile: click,
-  }), sessionId || 'chat')
+  return React.createElement(React.Fragment, null,
+    renderDock(React.createElement(DiffBox, {
+      mode: 'chat',
+      dock: true,
+      fileTotal: paths.length,
+      onOpenNextFile: click,
+    }), sessionId || 'chat'),
+    palette)
 }

package/src/client/ui/EditorView.ts

@@ -19,6 +19,7 @@ import { createDiffRenderer } from '../monaco/diffRender.js'
 import { ST, callIdAttr, noopHunk, summarize } from '../state/records.js'
 import { diffRegions } from '../state/regions.js'
 import { QuickOpen } from './QuickOpen.js'
+import { CommandPalette } from './CommandPalette.js'
 import { DiffLauncher } from './DiffLauncher.js'
 import { SidebarView } from '../sidebar/SidebarView.js'
 import { clearDiffDock, publishDiffDock } from '../diffDockStore.js'
@@ -131,6 +132,10 @@ export function EditorView(props) {
   const navBackRef = React.useRef(null) // 后退动作最新闭包（窗口级键盘监听读取）
   const navForwardRef = React.useRef(null) // 前进动作最新闭包（窗口级键盘监听读取）
   const cycleTabRef = React.useRef(null) // 页签循环动作最新闭包（Ctrl+Alt+←/→、Ctrl+PgUp/PgDn）
+  const rowNavColRef = React.useRef(null) // 整行上下移动的期望列（连续移动保持列位）
+  const rowNavMoveRef = React.useRef(false) // 本次光标变化是否由整行移动触发（否则清空期望列）
+  const activeRef = React.useRef(null) // 当前活动文件的最新值（空依赖闭包/指令回调读取）
+  activeRef.current = active
   const tabsHostRef = React.useRef(null) // 页签栏容器（切换后把当前页签滚入可见区）
   const [navTick, setNavTick] = React.useState(0) // 历史可用性版本（按钮 disabled 重渲染）
   const hoverRegionsRef = React.useRef([]) // 当前 pending 区域镜像（稳定回调读取）
@@ -799,6 +804,66 @@ export function EditorView(props) {
     return () => window.removeEventListener('keydown', onKey, true)
   }, [])
 
+  // 整行上下移动的实现见下方「指令系统接线」effect（moveRow 单点定义，命令栏与键位共用）。
+
+  /**
+   * 指令系统接线：命令栏/键位/第三方派发的 `edrv.command.*` 事件落到编辑器动作。
+   * 全部动作经最新闭包执行（与窗口级键位监听同源）；事件名逐条字面书写，
+   * 便于与指令目录（ui/commandCatalog）静态对照（tests/commands.test.ts 有断言）。
+   * @author ddj 2026年09月10号
+   */
+  React.useEffect(() => {
+    /** 整行上下移动：Monaco 内置 cursorUp/Down 会丢列位，故按期望列自行定位（连续移动保持同列）。 */
+    const moveRow = (step) => {
+      const ed = editorRef.current
+      const model = ed?.getModel?.()
+      const pos = ed?.getPosition?.()
+      if (!ed || !model || !pos) return
+      const col = rowNavColRef.current ?? pos.column
+      const line = Math.max(1, Math.min(model.getLineCount(), pos.lineNumber + step))
+      if (line === pos.lineNumber) return
+      const maxCol = model.getLineMaxColumn(line)
+      rowNavColRef.current = col
+      rowNavMoveRef.current = true
+      ed.setPosition({ lineNumber: line, column: Math.max(1, Math.min(col, maxCol)) })
+      ed.revealLineInCenterIfOutsideViewport?.(line)
+    }
+    const handlers = [
+      ['edrv.command.save', () => { if (editorRef.current?.getModel?.()) { flushSave(); doSaveRef.current?.(false) } }],
+      // 快速打开由 QuickOpen 自己接该事件（它持有搜索框 ref），此处不重复实现
+      ['edrv.command.toggleSidebar', () => setSidebarOn((v) => !v)],
+      ['edrv.command.searchInFiles', () => {
+        setSidebarOn(true)
+        setActivePanel('search')
+        setTimeout(() => window.dispatchEvent(new CustomEvent('edrv:search-focus')), 0)
+      }],
+      ['edrv.command.navigateBack', () => navBackRef.current?.()],
+      ['edrv.command.navigateForward', () => navForwardRef.current?.()],
+      ['edrv.command.nextTab', () => cycleTabRef.current?.(1)],
+      ['edrv.command.prevTab', () => cycleTabRef.current?.(-1)],
+      ['edrv.command.nextEditorRow', () => moveRow(1)],
+      ['edrv.command.prevEditorRow', () => moveRow(-1)],
+      ['edrv.command.goToDefinition', () => { const ed = editorRef.current; if (ed) void runGoToDefinition(ed) }],
+      ['edrv.command.findReferences', () => { const ed = editorRef.current; if (ed) void runFindReferences(ed) }],
+      ['edrv.command.triggerAi', () => editorRef.current?.trigger?.('edrv-ai', 'editor.action.inlineSuggest.trigger', null)],
+      ['edrv.command.openInExplorer', () => {
+        const path = activeRef.current
+        if (!path) { setStatus('无活动文件'); return }
+        menuHandlersRef.current?.openInExplorer?.(path)
+      }],
+    ]
+    const byName = new Map(handlers)
+    const onCommand = (event) => {
+      const action = byName.get(event.type)
+      if (!action) return
+      try { action() } catch (error) { dbg(sessionId, '指令 ' + event.type + ' 失败：' + String(error)) }
+    }
+    for (const [eventName] of handlers) window.addEventListener(eventName, onCommand)
+    return () => {
+      for (const [eventName] of handlers) window.removeEventListener(eventName, onCommand)
+    }
+  }, [sessionId])
+
   // 活动页签滚动可见（页签栏溢出时键盘切换/打开文件后把当前页签带回视野）：
   // 只调整页签栏自身 scrollLeft，不触发页面滚动。
   React.useEffect(() => {
@@ -1065,6 +1130,9 @@ export function EditorView(props) {
     })
     ed.onDidChangeCursorPosition((e) => {
       setCursor('Ln ' + e.position.lineNumber + ', Col ' + e.position.column)
+      // 整行移动（↓↑）刚定位时保留期望列；其余光标移动（点击/打字/方向键）清空期望列
+      if (rowNavMoveRef.current) rowNavMoveRef.current = false
+      else rowNavColRef.current = null
       // 导航历史：同文件内光标移动防抖记录（程序化恢复触发的位置与栈顶去重，无副作用）
       if (navCursorTimerRef.current) clearTimeout(navCursorTimerRef.current)
       navCursorTimerRef.current = setTimeout(() => {
@@ -1126,6 +1194,20 @@ export function EditorView(props) {
       run: (edx) => { void runFindReferences(edx) },
     })
     ed.addCommand(m.KeyCode.F12, () => { void runGoToDefinition(ed) })
+    // 整行上下移动 + 命令栏：只登记 Monaco 右键菜单入口（不绑键位）。
+    // 键位由指令桥统一 capture 派发 `edrv.command.*`，此处再绑一次会双执行。
+    ed.addAction({
+      id: 'edrv.prevEditorRow', label: '上一编辑行', contextMenuGroupId: '1_edrv',
+      run: () => window.dispatchEvent(new CustomEvent('edrv.command.prevEditorRow')),
+    })
+    ed.addAction({
+      id: 'edrv.nextEditorRow', label: '下一编辑行', contextMenuGroupId: '1_edrv',
+      run: () => window.dispatchEvent(new CustomEvent('edrv.command.nextEditorRow')),
+    })
+    ed.addAction({
+      id: 'edrv.showCommands', label: '显示所有命令', contextMenuGroupId: '1_edrv',
+      run: () => window.dispatchEvent(new CustomEvent('edrv.command.showCommands')),
+    })
     bindLspEditor(ed)
     bindLspUnderline(ed, m)
     // AI 补全：编辑器实例登记（差异静默判定用）+ Alt+\ 手动触发 ghost text
@@ -1652,7 +1734,7 @@ export function EditorView(props) {
   } else if (!active) {
     body = React.createElement('div', { className: 'edrv-empty' },
       React.createElement('div', null, '暂无打开的文件'),
-      React.createElement('div', { style: { fontSize: 12 } }, '使用右上搜索框 (' + (chordOf('edrv.quickOpen') ?? 'Ctrl+P') + ') 打开工作区文件；agent 修改文件后顶部会出现差异角标'))
+      React.createElement('div', { style: { fontSize: 12 } }, '使用右上搜索框 (' + (chordOf('edrv.quickOpen') ?? 'Ctrl+P') + ') 打开工作区文件；' + (chordOf('edrv.showCommands') ?? 'Ctrl+Shift+P') + ' 打开命令栏；agent 修改文件后顶部会出现差异角标'))
   } else if (content === null && loadError) {
     body = loadingBody('文件加载失败：' + loadError, 0, () => {
       setLoadError(null)
@@ -1831,14 +1913,19 @@ export function EditorView(props) {
     mainCol)
 
   const baseStyle = { minHeight: 0, display: 'flex', flexDirection: 'column', background: 'var(--dsw-alias-bg-base,transparent)', overflow: 'hidden' }
+  // 命令栏浮层（Ctrl+Shift+P / F1）：portal 到 body，但需挂在插件自己的 React 树里；
+  // 三种布局形态都渲染 EditorView，故这里挂载即可，多宿主由 store 单实例认领兜底。
+  const paletteEl = React.createElement(CommandPalette, { key: 'edrv-palette', sessionId })
   const rootEl = layout === 'side'
     ? React.createElement('div', { ref: viewRootRef, 'data-edrv-view': '1', 'data-edrv-layout': 'side', className: 'edrv-view-side', style: Object.assign({}, baseStyle, { height: '100%' }) },
         editorRow,
         menuBackdrop,
-        tabMenuEl)
+        tabMenuEl,
+        paletteEl)
     : React.createElement('div', { ref: viewRootRef, 'data-edrv-view': '1', style: Object.assign({}, baseStyle, { height: 'var(--edrv-editor-height, 100%)', maxHeight: 'var(--edrv-editor-height, 100%)' }) },
         editorRow,
         menuBackdrop,
-        tabMenuEl)
+        tabMenuEl,
+        paletteEl)
   return rootEl
 }

package/src/client/ui/KeybindingsPanel.ts

@@ -174,7 +174,7 @@ export function KeybindingsPanel() {
 
   return React.createElement('section', { className: 'vsm-general-page' },
     React.createElement('h2', null, '快捷键'),
-    React.createElement('p', null, '配置编辑器视图的快捷键（保存 / 快速打开 / 侧边栏 / 搜索 / 后退 / 前进）。修改即时写入配置，重新聚焦编辑器后生效。'),
+    React.createElement('p', null, '配置编辑器视图的快捷键（命令栏 / 保存 / 快速打开 / 侧边栏 / 搜索 / 后退前进 / 页签与编辑行导航）。修改即时写入配置，重新聚焦编辑器后生效；命令栏（默认 Ctrl+Shift+P 或 F1）可搜索并执行下列全部命令。'),
     unavailable && React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, '设置服务暂不可用，当前使用默认键位。'),
     error && React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, error),
     message && React.createElement('div', { className: 'vsm-kb-message' }, message),

package/src/client/ui/QuickOpen.ts

@@ -49,17 +49,25 @@ export function QuickOpen(props) {
   }
 
   React.useEffect(() => {
+    const openBox = () => {
+      inputRef.current?.focus?.()
+      setOpen(true)
+    }
     const onKey = (e) => {
       if (matchEvent(e, bindingsOf('edrv.quickOpen'))) {
         e.preventDefault(); e.stopPropagation()
-        inputRef.current?.focus?.()
-        setOpen(true)
+        openBox()
       } else if (e.key === 'Escape') {
         setOpen(false); inputRef.current?.blur?.()
       }
     }
     window.addEventListener('keydown', onKey, true)
-    return () => window.removeEventListener('keydown', onKey, true)
+    // 指令系统入口（命令栏「快速打开文件」）：与键位复用同一动作
+    window.addEventListener('edrv.command.quickOpen', openBox)
+    return () => {
+      window.removeEventListener('keydown', onKey, true)
+      window.removeEventListener('edrv.command.quickOpen', openBox)
+    }
   }, [])
 
   const dirText = (p) => {