dsh-vscode-mode 0.1.62 → 0.2.0

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

@@ -14,11 +14,12 @@ import { langOf, loadMonaco } from '../monaco/loader.js'
 import { dataUrlOf, isImagePath, isSvgPath } from '../imagePreview.js'
 import { base64ToBytes, isPdfPath } from '../pdfPreview.js'
 import { createPdfPanel } from '../pdf/pdfPanel.js'
-import { applyTheme, registerThemes, themeNameOf } from '../monaco/theme.js'
+import { applyOfficial, registerThemes, themeNameOf } from '../monaco/theme.js'
 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'
@@ -130,6 +131,12 @@ export function EditorView(props) {
   const navCursorTimerRef = React.useRef(null) // 光标位置防抖记录计时器
   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 区域镜像（稳定回调读取）
   const lineRegionMapRef = React.useRef(new Map()) // 行 → 区域 映射（hover 命中）
@@ -324,6 +331,23 @@ export function EditorView(props) {
     })
   }
 
+  /**
+   * 在已打开页签间循环切换（文件分页归编辑器自带页签栏）。
+   * @author ddj 2026年09月10号
+   * @param step 步进（+1 下一个 / -1 上一个）
+   */
+  const cycleTab = (step) => {
+    if (tabs.length < 2) return
+    const idx = tabs.findIndex((t) => t.path === active)
+    const next = tabs[(idx + step + tabs.length) % tabs.length]
+    if (!next || next.path === active) return
+    flushSave()
+    saveViewState(active)
+    recordNav()
+    setActive(next.path)
+  }
+  cycleTabRef.current = cycleTab
+
   /**
    * 轮询去重：前后记录内容一致时返回原引用，React 跳过重渲染，
    * 阻断 5s 轮询 → memo 链 → diff 重渲染/日志 的空转。
@@ -766,6 +790,93 @@ export function EditorView(props) {
     return () => window.removeEventListener('keydown', onKey, true)
   }, [])
 
+  // 页签循环切换：Ctrl+Alt+←/→（主候选，浏览器不占用）或 Ctrl+PgUp/PgDn（部分宿主可用）
+  React.useEffect(() => {
+    const onKey = (e) => {
+      const step = matchEvent(e, bindingsOf('edrv.nextTab')) ? 1
+        : matchEvent(e, bindingsOf('edrv.prevTab')) ? -1
+          : 0
+      if (step === 0) return
+      e.preventDefault(); e.stopPropagation()
+      if (cycleTabRef.current) cycleTabRef.current(step)
+    }
+    window.addEventListener('keydown', onKey, true)
+    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(() => {
+    const host = tabsHostRef.current
+    if (!host) return
+    const el = host.querySelector?.('.edrv-tab-active')
+    if (!el) return
+    const left = el.offsetLeft
+    const right = left + el.offsetWidth
+    if (left < host.scrollLeft) host.scrollLeft = left
+    else if (right > host.scrollLeft + host.clientWidth) host.scrollLeft = right - host.clientWidth
+  }, [active, tabs.length])
+
   // 鼠标侧键后退/前进：Logitech 官方默认「后退/前进」= XButton 鼠标事件（button 3/4），不产生键盘事件。
   // pointerdown 触发导航（preventDefault 后兼容 mousedown 可能不再触发，避免双触发）；
   // mousedown 兜底仅取消浏览器历史导航默认动作（MDN：preventDefault mousedown/pointerdown 可抑制）。
@@ -840,20 +951,25 @@ export function EditorView(props) {
     return () => { alive = false }
   }, [monaco, monacoErr])
 
-  // 分色主题：Monaco 就绪后注册（幂等）+ 应用；DSH 明暗切换时跟随重刷。
+  // 主题：Monaco 就绪后注册现役双套（幂等）+ 应用跟随官方的令牌主题；
+  // 官方主题事件（edrv:theme-change，经 ctx.theme/属性观察广播）与系统明暗切换时跟随重刷。
   React.useEffect(() => {
     if (!monaco) return
     registerThemes(monaco)
-    applyTheme(monaco)
-    if (typeof window.matchMedia !== 'function') return
-    const query = window.matchMedia('(prefers-color-scheme: dark)')
-    const onChange = () => applyTheme(monaco)
-    if (typeof query.addEventListener === 'function') {
-      query.addEventListener('change', onChange)
-      return () => query.removeEventListener('change', onChange)
+    const apply = () => applyOfficial(monaco)
+    apply()
+    window.addEventListener('edrv:theme-change', apply)
+    const query = typeof window.matchMedia === 'function' ? window.matchMedia('(prefers-color-scheme: dark)') : null
+    if (query) {
+      if (typeof query.addEventListener === 'function') query.addEventListener('change', apply)
+      else query.addListener(apply)
+    }
+    return () => {
+      window.removeEventListener('edrv:theme-change', apply)
+      if (!query) return
+      if (typeof query.removeEventListener === 'function') query.removeEventListener('change', apply)
+      else query.removeListener(apply)
     }
-    query.addListener(onChange)
-    return () => query.removeListener(onChange)
   }, [monaco])
 
   monacoRef.current = monaco
@@ -1014,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(() => {
@@ -1075,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
@@ -1470,7 +1603,7 @@ export function EditorView(props) {
     }).catch((e) => { setStatus('打开失败'); setError('打开异常:' + String(e)) })
   }
 
-  const tabsEl = React.createElement('div', { className: 'edrv-tabs', style: { flex: '1 1 auto', minWidth: 0 } },
+  const tabsEl = React.createElement('div', { className: 'edrv-tabs', ref: tabsHostRef, style: { flex: '1 1 auto', minWidth: 0 } },
     tabs.map((t) => React.createElement('div', {
       key: t.path,
       className: 'edrv-tab' + (t.path === active ? ' edrv-tab-active' : ''),
@@ -1601,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)
@@ -1780,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/OfficialSideTab.ts

@@ -1,17 +1,16 @@
 // @ts-nocheck
 /**
- * dsh-vscode-mode client — OfficialSideTab：DSH 官方右侧 Sidebar「文件编辑」Tab 正文包装。
- * 双用途：页类型 Tab（edrvEditor）经 navigation.params（openPath/focusDiff）打开；
- * file 资源类型 Tab（edrvEditorFile，认领 dsh-resource://file/**）经 navigation.address
- * 解码出真实路径并透传 params.line 行号定位。派发既有 edrv:open-editor 事件复用
- * EditorView 打开流；按会话 key 保证切会话干净重建。
+ * dsh-vscode-mode client — OfficialSideTab：DSH 官方右侧 Sidebar「文件编辑」页签正文包装。
+ * 用途：页类型 Tab（edrvEditor）经 navigation.params（openPath/focusDiff/line）打开；
+ * 兼作 file 认领转发（ClaimRouter）失败时的兜底正文（就地挂编辑器，旧行为）。
+ * 派发既有 edrv:open-editor 事件复用 EditorView 打开流；按会话 key 保证切会话干净重建。
  * Tab 正文切换后重挂载时按最新导航恢复打开（对齐 better-sidebar 形态的种子行为）。
- * 作者 ddj 2026年09月09号
+ * 作者 ddj 2026年09月09号 / 2026年09月10号
  */
 import React from 'react'
 import { EditorView } from './EditorView.js'
 import { setSideEditorMounted } from '../sidebarBridge.js'
-import { editorMountEpoch, markEditorMounted, parseOfficialFileAddress, resolveNavOpen } from '../officialSidebar.js'
+import { editorMountEpoch, markEditorMounted, parseOfficialFileAddress, resolveNavLine, resolveNavOpen } from '../officialSidebar.js'
 
 /**
  * 官方侧边栏 Tab 正文组件（keyed slot sidebar.right.pane.tab 装配）。
@@ -71,10 +70,10 @@ export function OfficialSideTab(props) {
       }))
       return
     }
-    // 页类型 Tab：params 携带打开请求
+    // 页类型 Tab：params 携带打开请求（line = 行引用/工具行跳转的行号定位）
     const request = resolveNavOpen(navigation?.params)
     window.dispatchEvent(new CustomEvent('edrv:open-editor', {
-      detail: { path: request.path, focusDiff: request.focusDiff },
+      detail: { path: request.path, focusDiff: request.focusDiff, line: resolveNavLine(navigation?.params) },
     }))
   })
 

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) => {

package/src/client/ui/commandCatalog.ts

@@ -0,0 +1,179 @@
+/**
+ * dsh-vscode-mode client — 编辑器指令目录（纯元数据）。
+ * 「一条命令 = 一条注册数据」：命令栏、快捷键设置页、快捷键监听与 Monaco 右键菜单
+ * 全部从本表读取；新增一条能力只需在 EDITOR_COMMANDS 追加一项（可选 keybinding）。
+ * run 只派发 `edrv.command.*` 窗口事件，不直接触碰 React/Monaco（`edrv.command.` 前缀
+ * 与既有 `edrv:` 刷新/主题事件分属不同命名空间，互不干扰）。
+ * 作者 ddj 2026年09月10号
+ */
+import { hasEditorModel } from '../editorModelState.js'
+
+/** 一条编辑器指令（展示 + 执行 + 可用性）。 */
+export interface CommandDef {
+  /** 稳定命令 id（`edrv.` 前缀；第三方注册请避让该前缀）。 */
+  id: string
+  /** 命令栏与设置页展示名。 */
+  label: string
+  /** 命令栏分组名。 */
+  category: string
+  /** 组内排序（小者优先）。 */
+  order?: number
+  /** 默认键位弦（可选；可含 `|` 多候选）。声明后由快捷键设置页展示与录制。 */
+  keybinding?: string
+  /** 运行体：派发窗口事件或直接执行。 */
+  run: () => void
+  /** 可用性判定（缺省视为始终可用；返回 false 时命令栏隐藏且 run 被拒）。 */
+  available?: () => boolean
+}
+
+/**
+ * 派发编辑器命令事件（`edrv.command.<action>`）。
+ * 无 window 的运行环境（纯 Node 单测）静默跳过，命令本身不因此失败。
+ * @author ddj 2026年09月10号
+ * @param action 动作名（不含前缀）
+ */
+function emit(action: string): void {
+  if (typeof window === 'undefined') return
+  window.dispatchEvent(new CustomEvent('edrv.command.' + action))
+}
+
+/** 编辑器命令事件名前缀（EditorView / QuickOpen / 第三方据此监听）。 */
+export const COMMAND_EVENT_PREFIX = 'edrv.command.'
+
+/** 需要活动编辑器模型才可用的命令（命令栏隐藏并拒绝执行）。 */
+function needsModel(): boolean {
+  return hasEditorModel()
+}
+
+/** 面板区显隐切换始终可用（未挂载编辑器时 run 为空操作）。 */
+function alwaysAvailable(): boolean {
+  return true
+}
+
+/**
+ * 光标整行下移（编辑行导航）。
+ * @author ddj 2026年09月10号
+ * @returns 命令定义
+ */
+function nextEditorRowDef(): CommandDef {
+  return {
+    id: 'edrv.nextEditorRow', label: '下一编辑行（光标整行下移）', category: '导航', order: 50,
+    keybinding: 'Ctrl+Alt+ArrowDown', available: needsModel,
+    run: () => emit('nextEditorRow'),
+  }
+}
+
+/**
+ * 光标整行上移（编辑行导航）。
+ * @author ddj 2026年09月10号
+ * @returns 命令定义
+ */
+function prevEditorRowDef(): CommandDef {
+  return {
+    id: 'edrv.prevEditorRow', label: '上一编辑行（光标整行上移）', category: '导航', order: 60,
+    keybinding: 'Ctrl+Alt+ArrowUp', available: needsModel,
+    run: () => emit('prevEditorRow'),
+  }
+}
+
+/**
+ * 编辑器内置指令目录（顺序 = 快捷键设置页展示顺序）。
+ * 前置 8 条的键位由 EditorView / QuickOpen 自行 capture 监听（历史实现），
+ * 故不进 BRIDGE_COMMANDS，避免同一按键双执行。
+ * @author ddj 2026年09月10号
+ */
+export const EDITOR_COMMANDS: readonly CommandDef[] = [
+  {
+    id: 'edrv.save', label: '保存文件', category: '文件', order: 10,
+    keybinding: 'Ctrl+S', available: needsModel,
+    run: () => emit('save'),
+  },
+  {
+    id: 'edrv.quickOpen', label: '快速打开文件', category: '文件', order: 20,
+    keybinding: 'Ctrl+P', available: alwaysAvailable,
+    run: () => emit('quickOpen'),
+  },
+  {
+    id: 'edrv.toggleSidebar', label: '切换侧边栏', category: '视图', order: 10,
+    keybinding: 'Ctrl+B', available: alwaysAvailable,
+    run: () => emit('toggleSidebar'),
+  },
+  {
+    id: 'edrv.searchInFiles', label: '在工作区中搜索', category: '视图', order: 20,
+    keybinding: 'Ctrl+Shift+F', available: alwaysAvailable,
+    run: () => emit('searchInFiles'),
+  },
+  {
+    id: 'edrv.navigateBack', label: '后退（导航历史）', category: '导航', order: 10,
+    keybinding: 'Alt+ArrowLeft|Ctrl+Alt+-', available: needsModel,
+    run: () => emit('navigateBack'),
+  },
+  {
+    id: 'edrv.navigateForward', label: '前进（导航历史）', category: '导航', order: 20,
+    keybinding: 'Alt+ArrowRight|Ctrl+Shift+-', available: needsModel,
+    run: () => emit('navigateForward'),
+  },
+  {
+    id: 'edrv.nextTab', label: '下一个页签', category: '导航', order: 30,
+    keybinding: 'Ctrl+Alt+ArrowRight|Ctrl+PageDown', available: needsModel,
+    run: () => emit('nextTab'),
+  },
+  {
+    id: 'edrv.prevTab', label: '上一个页签', category: '导航', order: 40,
+    keybinding: 'Ctrl+Alt+ArrowLeft|Ctrl+PageUp', available: needsModel,
+    run: () => emit('prevTab'),
+  },
+  {
+    id: 'edrv.goToDefinition', label: '转到定义', category: '语言智能', order: 10,
+    available: needsModel,
+    run: () => emit('goToDefinition'),
+  },
+  {
+    id: 'edrv.findReferences', label: '查找所有引用', category: '语言智能', order: 20,
+    available: needsModel,
+    run: () => emit('findReferences'),
+  },
+  {
+    id: 'edrv.triggerAi', label: '触发 AI 内联补全', category: '语言智能', order: 30,
+    available: needsModel,
+    run: () => emit('triggerAi'),
+  },
+  {
+    id: 'edrv.openInExplorer', label: '在文件浏览器中打开', category: '文件', order: 30,
+    available: needsModel,
+    run: () => emit('openInExplorer'),
+  },
+]
+
+/**
+ * 桥接派发指令（无原生监听，键位由 commandBridge 统一 capture 处理）。
+ * 新增「只填目录、不写监听」的编辑器指令一律放这里：键位、命令栏、设置页自动可用。
+ * @author ddj 2026年09月10号
+ */
+export const BRIDGE_COMMANDS: readonly CommandDef[] = [
+  nextEditorRowDef(),
+  prevEditorRowDef(),
+]
+
+/**
+ * 命令栏自身的命令（避免循环依赖，由 commandBridge 注入 run 后注册）。
+ * @author ddj 2026年09月10号
+ * @param run 打开命令栏
+ * @returns 命令定义
+ */
+export function showCommandsDef(run: () => void): CommandDef {
+  return {
+    id: 'edrv.showCommands', label: '显示所有命令', category: '视图', order: 1,
+    keybinding: 'Ctrl+Shift+P|F1', available: alwaysAvailable, run,
+  }
+}
+
+/**
+ * 需要全局键位派发的指令（桥接类 + 命令栏自身；不含 EditorView/QuickOpen 原生监听的那些）。
+ * @author ddj 2026年09月10号
+ * @param showCommands 命令栏命令定义
+ * @returns 派发集合
+ */
+export function dispatchedCommands(showCommands: CommandDef): readonly CommandDef[] {
+  return [...BRIDGE_COMMANDS, showCommands]
+}

package/src/client-primitives.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 官方 UI 原语虚拟模块的最小类型垫片（@deepseek-ai/dsh-client-ui-primitives）。
+ *
+ * 该模块由 DSH web 前端的 loader 在运行时提供（磁盘上没有对应包目录，官方 40+ 个
+ * 客户端包同样以 require 方式消费），本垫片只声明本插件用到的成员，供 tsc 类型检查；
+ * 运行时取值为 loader 注入实例。完整成员清单见官方前端产物导出表。
+ * 作者 ddj 2026-09-10
+ */
+declare module '@deepseek-ai/dsh-client-ui-primitives' {
+  /** 图标组件通用 props（官方 Icon* 组件与 FileTypeIcon 共用形状）。 */
+  export interface EdrvIconProps {
+    /** 图标边长（px）；省略时用图标自带尺寸。 */
+    size?: number
+    className?: string
+  }
+
+  /** 按文件名（或扩展名）分类的官方文件类型判别符（未知类型返回 'other'）。 */
+  export function classifyFileType(name: string): string
+
+  /** 官方文件类型图标：按 classifyFileType 的 kind 渲染（跟随官方主题配色）。 */
+  export const FileTypeIcon: (props: EdrvIconProps & { kind: string }) => unknown
+
+  /** 目录闭合图标（官方文件树同款）。 */
+  export const IconFolderClose16: (props: EdrvIconProps) => unknown
+  /** 目录展开图标（官方文件树同款）。 */
+  export const IconFolderOpen16: (props: EdrvIconProps) => unknown
+  /** 目录轮廓图标（活动栏「文件管理」）。 */
+  export const IconFolderOpenOutline16: (props: EdrvIconProps) => unknown
+  /** 刷新图标（面板工具条）。 */
+  export const IconRefreshOutline16: (props: EdrvIconProps) => unknown
+  /** 搜索图标（活动栏「搜索」）。 */
+  export const IconSearchOutline16: (props: EdrvIconProps) => unknown
+  /** 列表+笔图标（活动栏「规则」）。 */
+  export const IconListPenOutline16: (props: EdrvIconProps) => unknown
+  /** 代码图标（活动栏「大纲」）。 */
+  export const IconCodeOutline16: (props: EdrvIconProps) => unknown
+}

package/src/shared/keybindings.ts

@@ -3,7 +3,9 @@
  * 纯数据模块：host（settings schema 默认值）与 client（执行匹配/设置页）共用。
  * 键位格式：修饰符 + 主键，`+` 连接，如 `Ctrl+Shift+F`；空串 = 未绑定；
  * `|` 连接多个候选（任一命中即触发），如 `Alt+ArrowLeft|Ctrl+Alt+-`。
- * 作者 ddj 2026年08月26号
+ * 约束：本模块被 host 与 client 两半共用，**禁止 import client 侧模块**（React/浏览器 API）。
+ * 与 client/ui/commandCatalog 的一致性由 tests/commands.test.ts 断言兜底。
+ * 作者 ddj 2026年08月26号 / 2026年09月10号
  */
 
 /** 命令 id → 默认键位（可为多候选）。命令目录以此为准，新增命令只需加一项。 */
@@ -14,6 +16,13 @@ export const KEYBINDING_DEFAULTS: Record<string, string> = {
   'edrv.searchInFiles': 'Ctrl+Shift+F',
   'edrv.navigateBack': 'Alt+ArrowLeft|Ctrl+Alt+-',
   'edrv.navigateForward': 'Alt+ArrowRight|Ctrl+Shift+-',
+  // 页签循环：主候选避开浏览器保留键（Ctrl+Tab / Ctrl+PgUp/PgDn 会被浏览器截获）
+  'edrv.nextTab': 'Ctrl+Alt+ArrowRight|Ctrl+PageDown',
+  'edrv.prevTab': 'Ctrl+Alt+ArrowLeft|Ctrl+PageUp',
+  // 命令栏（Ctrl+Shift+P 主候选；F1 为 VS Code 同款第二候选）与编辑行导航
+  'edrv.showCommands': 'Ctrl+Shift+P|F1',
+  'edrv.nextEditorRow': 'Ctrl+Alt+ArrowDown',
+  'edrv.prevEditorRow': 'Ctrl+Alt+ArrowUp',
 }
 
 /**