dsh-vscode-mode 0.11.0 → 0.13.0

package/src/client/ui/McpSettings.ts

@@ -1,8 +1,9 @@
 // @ts-nocheck
 /**
- * dsh-vscode-mode client — VSCodeMode 设置区：通用 / 快捷键 / MCP 管理 / 语言服务器 / 性能优化 / 兼容性。
+ * dsh-vscode-mode client — VSCodeMode 设置区：通用 / MCP 管理 / 语言服务器 / 性能优化 / 兼容性。
+ * （快捷键管理已迁出为独立顶层设置区 ui/ShortcutSettings.ts，与 VSCodeMode 平级。）
  * MCP 管理 Tab 下含三个子页签：我的 MCP（profile 全局）/ 项目 MCP（各项目 .mcp.json）/ MCP 市场（占位）。
- * 作者 ddj 2026年08月22号 / 2026年08月26号 / 2026年08月27号
+ * 作者 ddj 2026年08月22号 / 2026年08月26号 / 2026年08月27号 / 2026年10月
  */
 import React from 'react'
 import { rpc } from '../rpc.js'
@@ -14,7 +15,6 @@ import { normalizeSidebarMinWidth, SIDEBAR_MIN_DEFAULT } from '../sidebarMin.js'
 import { EDITOR_LIMIT_CEIL, EDITOR_LIMIT_DEFAULT, normalizeMaxOpenEditors } from '../../shared/editorLimit.js'
 import { TORTOISE_DIR_DEFAULT } from '../../shared/svn.js'
 import { DEFAULT_NATIVE_CSV } from '../../shared/nativeOpen.js'
-import { KeybindingsPanel } from './KeybindingsPanel.js'
 import { LspSettings } from './LspSettings.js'
 import { PerfSettings } from './PerfSettings.js'
 import { IntegrationSettings } from './IntegrationSettings.js'
@@ -44,9 +44,11 @@ function parsePairs(text) {
   }))
 }
 
-/** 服务状态文案。 */
+/** @author ddj 2026年09月28号 @param server Server lifecycle snapshot. @returns User-facing status. */
 function statusOf(server) {
-  return server.status === 'connected' ? '在线' : server.status === 'connecting' ? '连接中' : server.status === 'disabled' ? '已禁用' : '错误'
+  if (!server.enabled || server.status === 'disabled') return '已禁用'
+  const labels = { connected: '在线', connecting: '装配中', configured: '已配置，等待会话', unverified: '已加载，连接未确认', error: '错误' }
+  return labels[server.status] ?? '状态未知'
 }
 
 /** MCP 服务卡片（全局与项目共用）。 */
@@ -60,7 +62,8 @@ function ServerCard({ server, onRefresh, onToggle, onRemove }) {
         React.createElement('button', { className: 'vsm-switch ' + (server.enabled ? 'on' : ''), onClick: () => onToggle(server), 'aria-label': server.enabled ? '禁用' : '启用' }, server.enabled ? '●' : '○'),
       ),
     ),
-    React.createElement('div', { className: 'vsm-mcp-meta' }, statusOf(server), ' · ', server.toolCount, ' 个工具 · ', server.transport),
+    React.createElement('div', { className: 'vsm-mcp-meta' }, statusOf(server), ' · ', server.toolCount, ' 个工具 · ', server.transport,
+      server.instanceCount !== undefined ? ' · ' + server.instanceCount + ' 个会话实例（各自连接）' : ''),
     server.error && React.createElement('div', { className: 'vsm-mcp-error' }, server.error),
     React.createElement('div', { className: 'vsm-mcp-tools' }, server.tools.map((tool) => React.createElement('span', { key: tool.name, className: 'vsm-mcp-chip', title: tool.description || tool.name }, tool.name))),
   )
@@ -581,7 +584,6 @@ export function McpSettings(props) {
   let body
   if (loading) body = React.createElement('div', { className: 'vsm-mcp-empty' }, '正在读取 MCP 服务…')
   else if (tab === 'general') body = React.createElement(GeneralSettings, { registry: openerRegistry })
-  else if (tab === 'keys') body = React.createElement(KeybindingsPanel, null)
   else if (tab === 'mcp') body = React.createElement(McpManagePanel, { servers, projects, busy, draft, edit, resetDraft,
     saveGlobal: (close) => saveGlobal(close), saveProject: (workspacePath, close) => saveProject(workspacePath, close),
     refreshGlobal, toggleGlobal, removeGlobal, refreshProject, toggleProject, removeProject })
@@ -591,7 +593,7 @@ export function McpSettings(props) {
   else body = React.createElement(PerfSettings, null)
   return React.createElement('section', { className: 'vsm-mcp-page' },
     React.createElement('header', { className: 'vsm-mcp-header' }, React.createElement('div', null, React.createElement('h2', null, 'VSCodeMode'), React.createElement('p', null, '管理当前 profile 与各项目的 Model Context Protocol 服务。'))),
-    React.createElement('nav', { className: 'vsm-mcp-tabs' }, React.createElement('button', { className: tab === 'general' ? 'active' : '', onClick: () => setTab('general') }, '通用'), React.createElement('button', { className: tab === 'keys' ? 'active' : '', onClick: () => setTab('keys') }, '快捷键'), React.createElement('button', { className: tab === 'mcp' ? 'active' : '', onClick: () => setTab('mcp') }, 'MCP 管理'), React.createElement('button', { className: tab === 'lsp' ? 'active' : '', onClick: () => setTab('lsp') }, '语言服务器'), React.createElement('button', { className: tab === 'ai' ? 'active' : '', onClick: () => setTab('ai') }, 'AI 补全'), React.createElement('button', { className: tab === 'perf' ? 'active' : '', onClick: () => setTab('perf') }, '性能优化'), React.createElement('button', { className: tab === 'compat' ? 'active' : '', onClick: () => setTab('compat') }, '兼容性')),
+    React.createElement('nav', { className: 'vsm-mcp-tabs' }, React.createElement('button', { className: tab === 'general' ? 'active' : '', onClick: () => setTab('general') }, '通用'), React.createElement('button', { className: tab === 'mcp' ? 'active' : '', onClick: () => setTab('mcp') }, 'MCP 管理'), React.createElement('button', { className: tab === 'lsp' ? 'active' : '', onClick: () => setTab('lsp') }, '语言服务器'), React.createElement('button', { className: tab === 'ai' ? 'active' : '', onClick: () => setTab('ai') }, 'AI 补全'), React.createElement('button', { className: tab === 'perf' ? 'active' : '', onClick: () => setTab('perf') }, '性能优化'), React.createElement('button', { className: tab === 'compat' ? 'active' : '', onClick: () => setTab('compat') }, '兼容性')),
     error && React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, error),
     body,
   )

package/src/client/ui/OfficialSideTab.ts

@@ -8,6 +8,7 @@
  * 作者 ddj 2026年09月09号 / 2026年09月10号
  */
 import React from 'react'
+import { pickSessionScope } from '../sessionScope.js'
 import { EditorView } from './EditorView.js'
 import { setSideEditorMounted } from '../sidebarBridge.js'
 import { editorMountEpoch, markEditorActive, markEditorMounted, parseOfficialFileAddress, resolveNavLine, resolveNavOpen } from '../officialSidebar.js'
@@ -48,8 +49,10 @@ export function OfficialSideTab(props) {
       const schedule = props?.schedule
       const decide = () => {
         if (editorMountEpoch() !== epoch) return
-        const current = props?.sessions?.list?.getSnapshot?.()?.current
-        markEditorActive(current === self)
+        const current = typeof props?.readSessionScope === 'function'
+          ? props.readSessionScope().sessionId
+          : pickSessionScope({ list: props?.sessions?.list?.getSnapshot?.() }).sessionId
+        markEditorActive(Boolean(current && current !== self))
       }
       if (typeof schedule === 'function') schedule(decide, 0)
       else decide()

package/src/client/ui/QuickOpen.ts

@@ -9,7 +9,8 @@
  */
 import React from 'react'
 import { rpc } from '../rpc.js'
-import { bindingsOf, chordOf, matchEvent, useKeybindingsVersion } from '../keybindings.js'
+import { bindPanelCommand } from '../panelCommands.js'
+import { ariaOf, chordOf, useKeybindingsVersion } from '../keybindings.js'
 import { stepIndex } from './searchNav.js'
 
 /**
@@ -64,22 +65,20 @@ export function QuickOpen(props) {
       inputRef.current?.focus?.()
       setOpen(true)
     }
-    const onKey = (e) => {
-      if (matchEvent(e, bindingsOf('edrv.quickOpen'))) {
-        e.preventDefault(); e.stopPropagation()
-        openBox()
-      } else if (e.key === 'Escape') {
-        setOpen(false); inputRef.current?.blur?.()
-      }
+    // Esc 关闭（仅收起浮窗；历史 capture 行为保留，不参与命令派发、不吞键）
+    const onEscape = (e) => {
+      if (e.isComposing || e.keyCode === 229 || e.getModifierState?.('AltGraph') || e.key !== 'Escape') return
+      setOpen(false)
+      inputRef.current?.blur?.()
     }
-    window.addEventListener('keydown', onKey, true)
-    // 指令系统入口（命令栏「快速打开文件」）：与键位复用同一动作
-    window.addEventListener('edrv.command.quickOpen', openBox)
+    // 官方与旧版键位统一走会话级命令接收器；挂载时只消费本会话的待打开请求。
+    window.addEventListener('keydown', onEscape, true)
+    const offCommand = bindPanelCommand('quickOpen', { sessionId }, openBox)
     return () => {
-      window.removeEventListener('keydown', onKey, true)
-      window.removeEventListener('edrv.command.quickOpen', openBox)
+      window.removeEventListener('keydown', onEscape, true)
+      offCommand()
     }
-  }, [])
+  }, [sessionId])
 
   // 高亮项滚入浮窗可视区（候选集或高亮变化时；nearest 避免整页跳动）
   React.useEffect(() => {
@@ -100,7 +99,7 @@ export function QuickOpen(props) {
    * @param e 输入框键盘事件
    */
   const onInputKey = (e) => {
-    if (e.nativeEvent?.isComposing) return
+    if (e.nativeEvent?.isComposing || e.nativeEvent?.keyCode === 229 || e.getModifierState?.('AltGraph')) return
     if (e.key === 'Escape') { setOpen(false); return }
     if (!showPop || !list.length) return
     if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {
@@ -136,7 +135,8 @@ export function QuickOpen(props) {
 
   return React.createElement('div', { className: 'edrv-search-wrap' },
     React.createElement('input', {
-      ref: inputRef, className: 'edrv-search', placeholder: '搜索文件 (' + (chordOf('edrv.quickOpen') ?? 'Ctrl+P') + ')',
+      ref: inputRef, className: 'edrv-search', placeholder: '搜索文件' + (chordOf('edrv.quickOpen') ? ' (' + chordOf('edrv.quickOpen') + ')' : ''),
+      'aria-keyshortcuts': ariaOf('edrv.quickOpen'),
       value: q,
       role: 'combobox',
       'aria-expanded': showPop && list.length > 0,

package/src/client/ui/ShortcutSettings.ts

@@ -0,0 +1,274 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 独立「快捷键」设置区（与 VSCodeMode 平级，settings.section slot）。
+ * 子页一「官方快捷键」：官方 shortcuts 目录只读总览（官方 + 插件命令）+ 一键打开官方快捷键弹窗；
+ * 子页二「插件快捷键」：插件命令（edrv.*）行内录键编辑，持久化经官方 edit API
+ * （Desktop: userData/keybindings.json；Web: localStorage dsh.keybindings.v1），不再写插件设置。
+ * 录制期间调 service.recording(true)：Desktop 原生键盘桥暂停拦截，否则录不到键。
+ * 样式复用 vsm-kb-* / vsm-panel-* / vsm-mcp-subtabs（styles/mcp.css 随 client bundle 注入）。
+ * 作者 ddj 2026年10月
+ */
+import React from 'react'
+import { COMMANDS } from '../keybindings.js'
+import { log } from '../log.js'
+import { startRecording } from '../shortcutRecorder.js'
+import { resetPluginKeys } from '../shortcutsOfficial.js'
+import type { ShortcutsServiceLike, ShortcutCatalogRow } from '../shortcutsOfficial.js'
+
+const settingsLog = log.child('shortcut-settings')
+
+/** 目录行展示键位（keys 已按平台格式化；binding null = 未绑定）。 */
+function keysText(row) {
+  if (!row || row.binding === null) return '未绑定'
+  return row.keys.join(' ')
+}
+
+/** 插件命令行 = COMMANDS 目录序 × 官方目录行（行缺失时占位「未注册」）。 */
+function catalogRowsOf(service) {
+  const byId = new Map(service.catalog.getSnapshot().map((row) => [row.id, row]))
+  return COMMANDS.map((command) => ({ id: command.id, label: command.label, row: byId.get(command.id) ?? null }))
+}
+
+/**
+ * 「快捷键」设置区主体：子页切换 + 服务就绪探测（晚到自愈，有界重试）。
+ * @author ddj 2026年10月
+ * @param props.getShortcuts 官方服务运行时探测函数（client/index.ts 注入）
+ */
+export function ShortcutSettings(props) {
+  const getShortcuts = props?.getShortcuts
+  const [service, setService] = React.useState(() => (typeof getShortcuts === 'function' ? getShortcuts() : null))
+  const [tab, setTab] = React.useState('official')
+  const [, setVersion] = React.useState(0)
+
+  // 服务就绪有界重试（服务晚到自愈；用尽保持提示文案）
+  React.useEffect(() => {
+    if (service) return undefined
+    let attempts = 0
+    let cancelled = false
+    const tick = () => {
+      if (cancelled) return
+      const found = typeof getShortcuts === 'function' ? getShortcuts() : null
+      if (found) {
+        setService(found)
+        return
+      }
+      if (attempts >= 15) return
+      attempts += 1
+      setTimeout(tick, 2000)
+    }
+    tick()
+    return () => {
+      cancelled = true
+    }
+  }, [service])
+
+  // 目录/配置变化即重渲染（官方 catalog/config 快照存储订阅）
+  React.useEffect(() => {
+    if (!service) return undefined
+    const bump = () => setVersion((v) => v + 1)
+    const offCatalog = service.catalog.subscribe(bump)
+    const offConfig = service.config.subscribe(bump)
+    return () => {
+      offCatalog()
+      offConfig()
+    }
+  }, [service])
+
+  let body
+  if (!service) {
+    body = React.createElement('div', { className: 'vsm-mcp-empty' },
+      '官方快捷键服务未就绪（正在探测；若长期无响应，说明当前 DSH 版本不含官方快捷键机制）。')
+  } else if (tab === 'plugin') {
+    body = React.createElement(PluginShortcutEditor, { service })
+  } else {
+    body = React.createElement(OfficialShortcutsPane, { service })
+  }
+
+  return React.createElement('section', { className: 'vsm-general-page' },
+    React.createElement('header', { className: 'vsm-mcp-header' }, React.createElement('div', null,
+      React.createElement('h2', null, '快捷键'),
+      React.createElement('p', null, '基于官方 shortcuts 机制：统一注册、冲突校验、按平台差异化默认值；Desktop 持久化到 userData/keybindings.json，Web 持久化到 localStorage（dsh.keybindings.v1）。'))),
+    React.createElement('nav', { className: 'vsm-mcp-subtabs' },
+      React.createElement('button', { className: tab === 'official' ? 'active' : '', onClick: () => setTab('official') }, '官方快捷键'),
+      React.createElement('button', { className: tab === 'plugin' ? 'active' : '', onClick: () => setTab('plugin') }, '插件快捷键')),
+    body,
+  )
+}
+
+/** 官方目录行（只读总览行）。 */
+function OfficialRow({ row }) {
+  return React.createElement('div', { className: 'vsm-kb-row' },
+    React.createElement('div', { className: 'vsm-kb-label' },
+      React.createElement('span', null, row.label),
+      React.createElement('small', null, row.id),
+      row.modified && React.createElement('small', { className: 'vsm-kb-warn' }, '已自定义'),
+      row.issue && React.createElement('small', { className: 'vsm-kb-warn' }, '键位不受当前环境支持'),
+      row.conflicts.length > 0 && React.createElement('small', { className: 'vsm-kb-warn' }, '与 ' + row.conflicts.join('、') + ' 冲突')),
+    React.createElement('kbd', { 'aria-label': row?.aria, className: 'vsm-kb-key' + (row.conflicts.length ? ' warn' : '') }, keysText(row)),
+  )
+}
+
+/** 子页一：官方快捷键（弹窗入口 + 目录总览）。 */
+function OfficialShortcutsPane({ service }) {
+  const [error, setError] = React.useState('')
+  const rows = service.catalog.getSnapshot()
+  const shortcut = rows.find((row) => row.id === 'shortcuts.open')
+  const hint = shortcut?.keys?.length ? '（' + shortcut.keys.join(' ') + '）' : ''
+  const config = service.config.getSnapshot()
+  const openOfficial = () => {
+    setError('')
+    if (!service.registry || typeof service.registry.invoke !== 'function') {
+      setError('官方弹窗入口不可用；可到 设置 → 通用 → 快捷键 打开')
+      return
+    }
+    try {
+      service.registry.invoke('shortcuts.open', {
+        region: 'page',
+        modal: null,
+        target: typeof document !== 'undefined' ? document.activeElement : null,
+      })
+    } catch (e) {
+      settingsLog.warn('打开官方快捷键弹窗失败：' + String(e))
+      setError('打开官方弹窗失败：' + String(e) + '；可到 设置 → 通用 → 快捷键 打开')
+    }
+  }
+  return React.createElement(React.Fragment, null,
+    React.createElement('section', { className: 'vsm-panel' },
+      React.createElement('h3', { className: 'vsm-panel-title' }, '官方快捷键配置'),
+      React.createElement('div', { className: 'vsm-panel-body' },
+        React.createElement('p', null, '官方快捷键弹窗提供全部命令的查看、录键与恢复默认；也可从 设置 → 通用 → 快捷键 打开。下方为当前目录只读总览（含插件注册的命令）。'),
+        React.createElement('button', { className: 'vsm-primary vsm-small', onClick: openOfficial, 'aria-keyshortcuts': shortcut?.aria }, '打开官方快捷键设置' + hint),
+        error && React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, error),
+        config?.status === 'unreadable' && React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' },
+          '快捷键配置读取失败（内容损坏或由更新版本写入），当前使用默认键位；请备份后清理配置，或升级 DSH。')),
+    ),
+    React.createElement('section', { className: 'vsm-panel' },
+      React.createElement('h3', { className: 'vsm-panel-title' }, '命令目录（只读总览）'),
+      React.createElement('div', { className: 'vsm-panel-body' },
+        React.createElement('div', { className: 'vsm-kb-list' }, rows.map((row) => React.createElement(OfficialRow, { key: row.id, row }))),
+      ),
+    ),
+  )
+}
+
+/** 子页二：插件命令键位（行内录键 + 行级清除 + 恢复默认；写入走官方 edit API）。 */
+function PluginShortcutEditor({ service }) {
+  const [nativeReady, setNativeReady] = React.useState(false)
+  const [recording, setRecording] = React.useState(null) // 正在录制的命令 id
+  const [busy, setBusy] = React.useState(false)
+  const [message, setMessage] = React.useState('')
+  const [error, setError] = React.useState('')
+  const rows = catalogRowsOf(service)
+  const config = service.config.getSnapshot()
+
+  const saveBinding = async (id, binding) => {
+    setBusy(true)
+    setError('')
+    setMessage('')
+    const buildEdit = () => (binding === null ? { type: 'reset', id } : { type: 'set', id, binding })
+    try {
+      const result = await service.edit(buildEdit(), service.config.getSnapshot().revision)
+      if (result.status === 'saved') {
+        setMessage('已保存')
+      } else if (result.status === 'stale') {
+        setError('快捷键配置已在其他窗口更新，请检查当前键位后重新录制')
+      } else if (result.status === 'conflict') {
+        // 官方按原因分类拒绝：issue = 键位本身不合法（如 web 白名单外），conflicts = 与其他命令撞键
+        if (result.issue) {
+          const reasons = {
+            'unsupported-browser': 'web 模式白名单外的组合（单修饰符组合在浏览器环境不可靠）',
+            'reserved': '官方保留键',
+            'unsupported-key': '官方不支持的键',
+            'modifier-required': '至少需要一个修饰键',
+          }
+          setError('键位被官方拒绝：' + (reasons[result.issue] ?? result.issue)
+            + '。web 模式可用 Ctrl+Alt+X 风格组合；升级桌面外壳进入桌面模式后不受此限。')
+        } else {
+          setError('键位冲突：与 ' + (result.conflicts?.join('、') ?? '其他命令') + ' 冲突，请换一个组合')
+        }
+      } else if (result.status === 'not-ready') {
+        setError('快捷键配置尚未就绪，请稍后重试')
+      } else if (result.status === 'unreadable') {
+        setError('快捷键配置读取失败，编辑已禁用（见官方提示）')
+      } else {
+        setError('写入失败，请重试')
+      }
+    } catch (e) {
+      settingsLog.warn('快捷键保存失败：' + String(e))
+      setError('保存失败：' + String(e))
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  const resetAll = async () => {
+    if (!window.confirm('恢复全部插件快捷键为默认值？（只影响本插件命令的键位覆盖）')) return
+    setBusy(true)
+    setError('')
+    setMessage('')
+    try {
+      const result = await resetPluginKeys(service)
+      if (result.failed) setError('已恢复 ' + result.reset + ' 条，' + result.failed + ' 恢复失败；请重试')
+      else setMessage('已恢复 ' + result.reset + ' 条插件快捷键')
+    } catch (e) {
+      settingsLog.warn('快捷键恢复默认失败：' + String(e))
+      setError('恢复失败：' + String(e))
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  /**
+   * Own capture and native suspension for the selected command's entire lifetime.
+   * @author ddj 2026年09月28号
+   * @returns Cleanup on cancel, save, failure, service change and unmount.
+   */
+  const recordEffect = () => {
+    if (!recording) return undefined
+    let mounted = true
+    setNativeReady(false)
+    /** @author ddj 2026年09月28号 Mark the native bridge ready to collect physical keys. */
+    const ready = () => { if (mounted) setNativeReady(true) }
+    /** @author ddj 2026年09月28号 Cancel capture without modifying preferences. */
+    const cancel = () => { if (mounted) setRecording(null) }
+    /** @author ddj 2026年09月28号 @param binding Accepted physical binding or reset. */
+    const save = (binding) => { if (mounted) { setRecording(null); void saveBinding(recording, binding) } }
+    /** @author ddj 2026年09月28号 @param reason Recorder failure to show while mounted. */
+    const fail = (reason) => { if (mounted) { setRecording(null); setError('录制失败：' + String(reason)) } }
+    const dispose = startRecording(service, window, { ready, cancel, save, error: fail })
+    return () => { mounted = false; dispose() }
+  }
+  React.useEffect(recordEffect, [recording, service])
+
+  const rowsView = rows.map(({ id, label, row }) => {
+    const recordingRow = recording === id
+    const display = recordingRow
+      ? React.createElement('span', { className: 'vsm-kb-rec' }, nativeReady ? '按下组合键…（Esc 取消 / Backspace 恢复默认）' : '正在准备录制…')
+      : React.createElement('kbd', { 'aria-label': row?.aria, className: 'vsm-kb-key' + (row && row.conflicts.length ? ' warn' : '') }, keysText(row))
+    return React.createElement('div', { key: id, className: 'vsm-kb-row' + (recordingRow ? ' rec' : '') },
+      React.createElement('div', { className: 'vsm-kb-label' },
+        React.createElement('span', null, label),
+        row === null && React.createElement('small', { className: 'vsm-kb-warn' }, '未注册（官方服务未同步）'),
+        row && row.modified && React.createElement('small', { className: 'vsm-kb-warn' }, '已自定义'),
+        row && row.conflicts.length > 0 && React.createElement('small', { className: 'vsm-kb-warn' }, '与 ' + row.conflicts.join('、') + ' 冲突')),
+      display,
+      React.createElement('div', { className: 'vsm-kb-actions' },
+        recordingRow
+          ? React.createElement('button', { onClick: () => setRecording(null) }, '取消')
+          : React.createElement(React.Fragment, null,
+              React.createElement('button', { disabled: busy || Boolean(recording) || config?.status !== 'ready', onClick: () => { setRecording(id); setMessage('') } }, '编辑'),
+              React.createElement('button', { disabled: busy || Boolean(recording) || config?.status !== 'ready', title: '清除该命令的键位（恢复默认）', onClick: () => void saveBinding(id, null) }, '清除'))),
+    )
+  })
+
+  return React.createElement('section', { className: 'vsm-panel' },
+    React.createElement('h3', { className: 'vsm-panel-title' }, '插件命令键位'),
+    React.createElement('div', { className: 'vsm-panel-body' },
+      React.createElement('div', { className: 'vsm-kb-list' }, rowsView)),
+    React.createElement('div', { className: 'vsm-panel-body vsm-kb-actionsbar' },
+      React.createElement('span', { className: 'vsm-kb-dirty' }, recording ? '录制中…' : ''),
+      message && React.createElement('span', { className: 'vsm-kb-message' }, message),
+      error && React.createElement('span', { className: 'vsm-kb-warn' }, error),
+      React.createElement('button', { className: 'vsm-small', disabled: busy || Boolean(recording) || config?.status !== 'ready', onClick: () => void resetAll() }, '恢复默认')),
+  )
+}

package/src/client/ui/commandCatalog.ts

@@ -1,12 +1,15 @@
 /**
  * dsh-vscode-mode client — 编辑器指令目录（纯元数据）。
- * 「一条命令 = 一条注册数据」：命令栏、快捷键设置页、快捷键监听与 Monaco 右键菜单
- * 全部从本表读取；新增一条能力只需在 EDITOR_COMMANDS 追加一项（可选 keybinding）。
+ * 「一条命令 = 一条注册数据」：命令栏、快捷键设置页与 Monaco 右键菜单
+ * 全部从本表读取；新增一条能力只需在 EDITOR_COMMANDS 追加一项（默认键位见 shared/keybindings SHORTCUT_PROFILES）。
  * run 只派发 `edrv.command.*` 窗口事件，不直接触碰 React/Monaco（`edrv.command.` 前缀
  * 与既有 `edrv:` 刷新/主题事件分属不同命名空间，互不干扰）。
  * 作者 ddj 2026年09月10号
  */
+import { panelAvailable, runPanelCommand } from '../panelCommands.js'
 import { hasEditorModel, hasOpenTabs } from '../editorModelState.js'
+import { activeEditorPath } from '../activePathStore.js'
+import { isMarkdownPath } from '../markdownPreview.js'
 import { svnCurrentStatus } from '../svnStatus.js'
 import { dapStore } from '../dap/store.js'
 import { svnActionOn, svnActionsFor } from '../../shared/svnActions.js'
@@ -22,8 +25,6 @@ export interface CommandDef {
   category: string
   /** 组内排序（小者优先）。 */
   order?: number
-  /** 默认键位弦（可选；可含 `|` 多候选）。声明后由快捷键设置页展示与录制。 */
-  keybinding?: string
   /** 运行体：派发窗口事件或直接执行。 */
   run: () => void
   /** 可用性判定（缺省视为始终可用；返回 false 时命令栏隐藏且 run 被拒）。 */
@@ -62,7 +63,7 @@ function alwaysAvailable(): boolean {
 function nextEditorRowDef(): CommandDef {
   return {
     id: 'edrv.nextEditorRow', label: '下一编辑行（光标整行下移）', category: '导航', order: 50,
-    keybinding: 'Ctrl+Alt+ArrowDown', available: needsModel,
+    available: needsModel,
     run: () => emit('nextEditorRow'),
   }
 }
@@ -75,7 +76,7 @@ function nextEditorRowDef(): CommandDef {
 function prevEditorRowDef(): CommandDef {
   return {
     id: 'edrv.prevEditorRow', label: '上一编辑行（光标整行上移）', category: '导航', order: 60,
-    keybinding: 'Ctrl+Alt+ArrowUp', available: needsModel,
+    available: needsModel,
     run: () => emit('prevEditorRow'),
   }
 }
@@ -88,7 +89,7 @@ function prevEditorRowDef(): CommandDef {
 function gotoLineDef(): CommandDef {
   return {
     id: 'edrv.goToLine', label: '转到行', category: '导航', order: 45,
-    keybinding: 'Ctrl+G', available: needsModel,
+    available: needsModel,
     run: () => emit('goToLine'),
   }
 }
@@ -102,7 +103,7 @@ function gotoLineDef(): CommandDef {
 function addSelectionRefDef(): CommandDef {
   return {
     id: 'edrv.addSelectionRef', label: '添加选中内容为引用', category: '编辑', order: 10,
-    keybinding: 'Ctrl+U', available: needsModel,
+    available: needsModel,
     run: () => emit('addSelectionRef'),
   }
 }
@@ -117,7 +118,7 @@ function addSelectionRefDef(): CommandDef {
 function closeTabDef(): CommandDef {
   return {
     id: 'edrv.closeTab', label: '关闭当前页签', category: '文件', order: 40,
-    keybinding: 'Ctrl+F4', available: hasOpenTabs,
+    available: hasOpenTabs,
     run: () => emit('closeTab'),
   }
 }
@@ -188,34 +189,39 @@ function svnEventOf(action: SvnActionDef): string {
 
 /**
  * 编辑器内置指令目录（顺序 = 快捷键设置页展示顺序）。
- * 前置 8 条的键位由 EditorView / QuickOpen 自行 capture 监听（历史实现），
- * 故不进 BRIDGE_COMMANDS，避免同一按键双执行。
- * @author ddj 2026年09月10号
+ * 键位派发已归官方 shortcuts 机制：默认键位表在 shared/keybindings.ts 的 SHORTCUT_PROFILES，
+ * 由 client/index.ts 经 shortcutsOfficial.registerOfficialShortcuts 注册，本目录只管
+ * 「标签/可用性/执行」。无默认键位的命令同样注册（官方 UI/插件子页内可自定义绑定）。
+ * @author ddj 2026年09月10号 / 2026年10月
  */
 export const EDITOR_COMMANDS: readonly CommandDef[] = [
   {
     id: 'edrv.save', label: '保存文件', category: '文件', order: 10,
-    keybinding: 'Ctrl+S', available: needsModel,
+    available: needsModel,
     run: () => emit('save'),
   },
   {
     id: 'edrv.quickOpen', label: '快速打开文件', category: '文件', order: 20,
-    keybinding: 'Ctrl+P', available: alwaysAvailable,
-    run: () => emit('quickOpen'),
+    available: () => panelAvailable('quickOpen'),
+    run: () => { runPanelCommand('quickOpen') },
   },
   {
     id: 'edrv.toggleSidebar', label: '切换侧边栏', category: '视图', order: 10,
-    keybinding: 'Ctrl+B', available: alwaysAvailable,
+    available: alwaysAvailable,
     run: () => emit('toggleSidebar'),
   },
   {
     id: 'edrv.searchInFiles', label: '在工作区中搜索', category: '视图', order: 20,
-    keybinding: 'Ctrl+Shift+F', available: alwaysAvailable,
-    run: () => emit('searchInFiles'),
+    available: () => panelAvailable('searchInFiles'),
+    run: () => { runPanelCommand('searchInFiles') },
   },
   {
     id: 'edrv.toggleMarkdownPreview', label: '切换 Markdown 预览', category: '视图', order: 25,
-    keybinding: 'Ctrl+Shift+V', available: alwaysAvailable,
+    // 仅活动文件是 .md 时可用（不可用时官方派发返回 pass 不吞键，保留浏览器「无格式粘贴」语义）
+    available: () => {
+      const path = activeEditorPath()
+      return typeof path === 'string' && isMarkdownPath(path)
+    },
     run: () => emit('toggleMarkdownPreview'),
   },
   {
@@ -225,22 +231,22 @@ export const EDITOR_COMMANDS: readonly CommandDef[] = [
   },
   {
     id: 'edrv.navigateBack', label: '后退（导航历史）', category: '导航', order: 10,
-    keybinding: 'Alt+ArrowLeft|Ctrl+Alt+-', available: needsModel,
+    available: needsModel,
     run: () => emit('navigateBack'),
   },
   {
     id: 'edrv.navigateForward', label: '前进（导航历史）', category: '导航', order: 20,
-    keybinding: 'Alt+ArrowRight|Ctrl+Shift+-', available: needsModel,
+    available: needsModel,
     run: () => emit('navigateForward'),
   },
   {
     id: 'edrv.nextTab', label: '下一个页签', category: '导航', order: 30,
-    keybinding: 'Ctrl+Alt+ArrowRight|Ctrl+PageDown', available: needsModel,
+    available: needsModel,
     run: () => emit('nextTab'),
   },
   {
     id: 'edrv.prevTab', label: '上一个页签', category: '导航', order: 40,
-    keybinding: 'Ctrl+Alt+ArrowLeft|Ctrl+PageUp', available: needsModel,
+    available: needsModel,
     run: () => emit('prevTab'),
   },
   {
@@ -291,41 +297,41 @@ function debugPaletteDefs(): CommandDef[] {
   return [
     {
       id: 'edrv.debugToggleBreakpoint', label: '调试：切换断点（光标行）', category: '调试', order: 10,
-      keybinding: 'F9', available: needsModel,
+      available: needsModel,
       run: () => emit('debugToggleBreakpoint'),
     },
     {
       id: 'edrv.debugStartContinue', label: '调试：启动 / 继续', category: '调试', order: 20,
-      keybinding: 'F5', available: canStart,
+      available: canStart,
       run: () => emit('debugStartContinue'),
     },
     {
       id: 'edrv.debugStepOver', label: '调试：单步跳过', category: '调试', order: 30,
-      keybinding: 'F10', available: paused,
+      available: paused,
       run: () => emit('debugStepOver'),
     },
     {
       id: 'edrv.debugStepInto', label: '调试：单步步入', category: '调试', order: 40,
-      keybinding: 'F11', available: paused,
+      available: paused,
       run: () => emit('debugStepInto'),
     },
     {
       id: 'edrv.debugStepOut', label: '调试：单步步出', category: '调试', order: 50,
-      keybinding: 'Shift+F11', available: paused,
+      available: paused,
       run: () => emit('debugStepOut'),
     },
     {
       id: 'edrv.debugStop', label: '调试：停止', category: '调试', order: 60,
-      keybinding: 'Shift+F5', available: canStop,
+      available: canStop,
       run: () => emit('debugStop'),
     },
   ]
 }
 
 /**
- * 桥接派发指令（无原生监听，键位由 commandBridge 统一 capture 处理）。
- * 新增「只填目录、不写监听」的编辑器指令一律放这里：键位、命令栏、设置页自动可用。
- * @author ddj 2026年09月10号
+ * 非编辑器原生路径的指令（键位统一由官方 shortcuts 机制派发；历史「桥接」分组名保留）。
+ * 新增「只填目录」的编辑器指令一律放这里：命令栏与官方快捷键目录自动可用。
+ * @author ddj 2026年09月10号 / 2026年10月
  */
 export const BRIDGE_COMMANDS: readonly CommandDef[] = [
   nextEditorRowDef(),
@@ -345,16 +351,6 @@ export const BRIDGE_COMMANDS: readonly CommandDef[] = [
 export function showCommandsDef(run: () => void): CommandDef {
   return {
     id: 'edrv.showCommands', label: '显示所有命令', category: '视图', order: 1,
-    keybinding: 'Ctrl+Shift+P|F1', available: alwaysAvailable, run,
+    available: alwaysAvailable, run,
   }
 }
-
-/**
- * 需要全局键位派发的指令（桥接类 + 命令栏自身；不含 EditorView/QuickOpen 原生监听的那些）。
- * @author ddj 2026年09月10号
- * @param showCommands 命令栏命令定义
- * @returns 派发集合
- */
-export function dispatchedCommands(showCommands: CommandDef): readonly CommandDef[] {
-  return [...BRIDGE_COMMANDS, showCommands]
-}