dsh-vscode-mode 0.11.0 → 0.12.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'
@@ -581,7 +581,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 +590,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/QuickOpen.ts

@@ -9,7 +9,7 @@
  */
 import React from 'react'
 import { rpc } from '../rpc.js'
-import { bindingsOf, chordOf, matchEvent, useKeybindingsVersion } from '../keybindings.js'
+import { chordOf, useKeybindingsVersion } from '../keybindings.js'
 import { stepIndex } from './searchNav.js'
 
 /**
@@ -64,19 +64,18 @@ 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.key !== 'Escape') return
+      setOpen(false)
+      inputRef.current?.blur?.()
     }
-    window.addEventListener('keydown', onKey, true)
-    // 指令系统入口（命令栏「快速打开文件」）：与键位复用同一动作
+    // 快速打开键位（Ctrl+P）已归官方 shortcuts 机制派发：官方 resolve → 注册表 run →
+    // 派发 `edrv.command.quickOpen` 事件到此处（历史窗口 capture 键位自检移除，防双开）。
+    window.addEventListener('keydown', onEscape, true)
     window.addEventListener('edrv.command.quickOpen', openBox)
     return () => {
-      window.removeEventListener('keydown', onKey, true)
+      window.removeEventListener('keydown', onEscape, true)
       window.removeEventListener('edrv.command.quickOpen', openBox)
     }
   }, [])

package/src/client/ui/ShortcutSettings.ts

@@ -0,0 +1,294 @@
+// @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 { resetPluginKeys } from '../shortcutsOfficial.js'
+import type { ShortcutsServiceLike, ShortcutCatalogRow } from '../shortcutsOfficial.js'
+
+const settingsLog = log.child('shortcut-settings')
+
+const MODIFIER_ONLY = new Set(['Control', 'Shift', 'Alt', 'Meta', 'AltGraph'])
+
+/** 录制键 → 官方绑定（物理 code + 修饰符；Ctrl/Cmd 同为 primary，与官方互认语义一致）。 */
+function bindingFromEvent(e) {
+  const modifiers = []
+  if (e.ctrlKey || e.metaKey) modifiers.push('primary')
+  if (e.altKey) modifiers.push('alt')
+  if (e.shiftKey) modifiers.push('shift')
+  return { code: e.code, modifiers }
+}
+
+/** 目录行展示键位（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', { className: 'vsm-kb-key' + (row.conflicts.length ? ' warn' : '') }, keysText(row)),
+  )
+}
+
+/** 子页一：官方快捷键（弹窗入口 + 目录总览）。 */
+function OfficialShortcutsPane({ service }) {
+  const [error, setError] = React.useState('')
+  const rows = service.catalog.getSnapshot()
+  const config = service.config.getSnapshot()
+  const openOfficial = () => {
+    setError('')
+    if (!service.registry || typeof service.registry.invoke !== 'function') {
+      setError('官方弹窗入口不可用；可按 Ctrl+/ 或到 设置 → 通用 → 快捷键 打开')
+      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) + '；可按 Ctrl+/ 或到 设置 → 通用 → 快捷键 打开')
+    }
+  }
+  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, '官方快捷键弹窗（Ctrl+/ 或 设置 → 通用 → 快捷键）提供全部命令的查看、录键与恢复默认；下方为当前目录只读总览（含插件注册的命令）。'),
+        React.createElement('button', { className: 'vsm-primary vsm-small', onClick: openOfficial }, '打开官方快捷键设置（Ctrl+/）'),
+        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 [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)
+    }
+  }
+
+  // 录制态：窗口捕获下一次组合键（Desktop 原生桥已经 recording(true) 暂停拦截）。
+  // capture 阶段 preventDefault → 官方 DOM 派发因 defaultPrevented 放行，不会误触发命令。
+  React.useEffect(() => {
+    if (!recording) return undefined
+    const onKey = (e) => {
+      e.preventDefault()
+      e.stopPropagation()
+      if (e.key === 'Escape') {
+        setRecording(null)
+        return
+      }
+      if (e.key === 'Backspace' || e.key === 'Delete') {
+        const id = recording
+        setRecording(null)
+        void saveBinding(id, null)
+        return
+      }
+      if (MODIFIER_ONLY.has(e.key)) return
+      const id = recording
+      setRecording(null)
+      void saveBinding(id, bindingFromEvent(e))
+    }
+    window.addEventListener('keydown', onKey, true)
+    return () => window.removeEventListener('keydown', onKey, true)
+  }, [recording])
+
+  // 录制期间通知 Desktop 原生桥暂停拦截（Web 适配器为空实现）
+  React.useEffect(() => {
+    if (!service || typeof service.recording !== 'function') return undefined
+    void service.recording(Boolean(recording)).catch(() => {})
+    return () => {
+      if (recording) void service.recording(false).catch(() => {})
+    }
+  }, [recording, service])
+
+  const rowsView = rows.map(({ id, label, row }) => {
+    const recordingRow = recording === id
+    const display = recordingRow
+      ? React.createElement('span', { className: 'vsm-kb-rec' }, '按下组合键…（Esc 取消 / Backspace 清除）')
+      : React.createElement('kbd', { 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 || config?.status !== 'ready', onClick: () => { setRecording(id); setMessage('') } }, '编辑'),
+              React.createElement('button', { disabled: busy || 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 || config?.status !== 'ready', onClick: () => void resetAll() }, '恢复默认')),
+  )
+}

package/src/client/ui/commandCatalog.ts

@@ -1,12 +1,14 @@
 /**
  * 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 { 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 +24,6 @@ export interface CommandDef {
   category: string
   /** 组内排序（小者优先）。 */
   order?: number
-  /** 默认键位弦（可选；可含 `|` 多候选）。声明后由快捷键设置页展示与录制。 */
-  keybinding?: string
   /** 运行体：派发窗口事件或直接执行。 */
   run: () => void
   /** 可用性判定（缺省视为始终可用；返回 false 时命令栏隐藏且 run 被拒）。 */
@@ -62,7 +62,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 +75,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 +88,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 +102,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 +117,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 +188,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,
+    available: alwaysAvailable,
     run: () => emit('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,
+    available: alwaysAvailable,
     run: () => emit('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 +230,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 +296,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 +350,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]
-}

package/src/fileOpenSettings.ts

@@ -407,6 +407,9 @@ export async function updateSection(provider: SettingsProvider | undefined, ns:
  * 构建设置 section schema（install 路径与插件 Config 声明共用，保证两代形状同源）。
  * 字段集 = fileOpenTool/keybindings/sidebarMinWidth/maxOpenEditors/integrationBaseUrl/
  * aiInline/aiProvider/aiModel/aiEffort/svnPath/tortoisePath/nativeOpenExts，全部带默认值
+ * （keybindings 自 2026-10 起废弃停写：键位持久化归官方 shortcuts 存储
+ *   userData/keybindings.json / dsh.keybindings.v1；字段保留仅为旧档迁移读取与降级回滚，
+ *   见 client/shortcutsOfficial.ts 的 migrateLegacyKeybindings。）
  * （Config 启动校验在 undefined/空配置下自动填充，rc/alpha 两代 cordis 均通过）。
  * options.volatile：DSH 0.1.7 线的 Config 导出专用——SettingsForms.describe 只下发
  * 含 volatile 字段的 entry（volatileForm 门槛），不标记则 ns 永不出现在 describe、