dsh-vscode-mode 0.1.63 → 0.3.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/monaco/loader.ts

@@ -65,6 +65,8 @@ export const LANG_BY_EXT = {
   lua51: 'lua', luac: 'lua',
   gitattributes: 'ini', editorconfig: 'ini', env: 'ini', properties: 'ini',
   json5: 'jsonc', log: 'plaintext', txt: 'plaintext',
+  // 代码片段文件按 JSON 高亮（VS Code 同款：.code-snippets 是带注释的 JSON）
+  'code-snippets': 'json',
 }
 
 /**
@@ -81,6 +83,28 @@ export function langOf(path) {
   return LANG_BY_EXT[base.slice(dot + 1).toLowerCase()] ?? 'plaintext'
 }
 
+/** 片段文件后缀（判断「文件自身是片段文件」而非普通源码）。 */
+const SNIPPET_FILE_SUFFIX = '.code-snippets'
+
+/**
+ * 片段文件 → 它绑定的语言 id（VS Code 文件名约定 `<language>.code-snippets`）。
+ *
+ * 为什么不能直接用 {@link langOf}：`.code-snippets` 本身在 LANG_BY_EXT 里映射为 json
+ * （编辑片段文件时要按 JSON 高亮），于是 langOf('lua.code-snippets') 会得到 'json' 而不是
+ * 'lua' —— 曾导致「新建」默认文件名被算成 `json.code-snippets`。故这里按片段命名约定
+ * 单独解析：去掉 `.code-snippets` 后缀取语言前缀。
+ *
+ * @author ddj 2026年09月10号
+ * @param path 片段文件路径
+ * @returns 语言 id（`global.code-snippets` / 无法识别 → 空串 = 全语言）
+ */
+export function snippetLanguageOf(path) {
+  const base = String(path || '').split(/[\\/]/).pop() || ''
+  if (!base.toLowerCase().endsWith(SNIPPET_FILE_SUFFIX)) return langOf(path)
+  const lang = base.slice(0, -SNIPPET_FILE_SUFFIX.length).toLowerCase()
+  return lang === 'global' ? '' : lang
+}
+
 /**
  * 加载 Monaco Editor（AMD 构建，随插件包离线分发）：注入 loader.js → require.config → editor.main。
  * @author ddj 2026年08月20号

package/src/client/snippets/provider.ts

@@ -0,0 +1,172 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 代码片段补全 provider（Monaco IntelliSense）。
+ * 数据源：host snippets.entries（全局 ~/.dsh/snippets + 当前工作区 <工作区>/.dsh/snippets），
+ * 条目按 model 语言过滤（language 空串 = 全语言）；条目主体交给 Monaco 片段语法解析
+ * （${1:占位} / $TM_FILENAME 等由 InsertAsSnippet 规则展开）。
+ * 性能：条目模块级缓存 + TTL，不在每次按键打 RPC（与 ai/inlineProvider 的去抖策略异曲同工，
+ * 但片段是本地小表，缓存足矣）；edrv:snippets-changed（配置文件保存后）强制失效。
+ * 作者 ddj 2026年09月10号
+ */
+import { rpc } from '../rpc.js'
+
+/** 条目缓存 TTL（毫秒）：片段文件本就只在用户编辑时变化。 */
+const CACHE_TTL_MS = 10_000
+
+/** 补全候选上限（超大片段库下防拖慢渲染）。 */
+const MAX_ITEMS = 200
+
+/** 已加载条目缓存（null = 未加载/已失效）。 */
+let cache = null
+let cacheAt = 0
+let pending = null
+let registered = false
+let disposer = null
+
+/** 当前会话 id（补全按会话工作区叠加项目片段；EditorView 装配时注入）。 */
+let sessionId = null
+
+/**
+ * 设置当前会话（会话切换时更新；缓存一并失效，使项目片段跟随工作区）。
+ * @author ddj 2026年09月10号
+ * @param id 会话 id
+ */
+export function setSnippetsSession(id) {
+  if (sessionId === id) return
+  sessionId = id
+  invalidateSnippets()
+}
+
+/**
+ * 失效条目缓存（配置文件保存/会话切换后调用）。
+ * @author ddj 2026年09月10号
+ */
+export function invalidateSnippets() {
+  cache = null
+  cacheAt = 0
+  pending = null
+}
+
+/**
+ * 读取条目（带缓存与在飞去重）；失败返回空表（补全静默降级，不打断输入）。
+ * @author ddj 2026年09月10号
+ * @returns 片段条目数组
+ */
+async function loadEntries() {
+  if (cache && Date.now() - cacheAt < CACHE_TTL_MS) return cache
+  if (pending) return pending
+  pending = rpc('snippets.entries', { sessionId })
+    .then((res) => {
+      const entries = res && res.ok && Array.isArray(res.entries) ? res.entries : []
+      cache = entries
+      cacheAt = Date.now()
+      return entries
+    })
+    .catch(() => {
+      cache = []
+      cacheAt = Date.now()
+      return cache
+    })
+    .finally(() => { pending = null })
+  return pending
+}
+
+/**
+ * 按语言过滤条目：条目语言为空（全语言）或与 model 语言一致即命中。
+ * 项目片段（scope=project）排在全局之后去重，同名同前缀时项目优先。
+ * @author ddj 2026年09月10号
+ * @param entries 全部条目
+ * @param languageId 当前模型语言
+ * @returns 生效条目（项目优先，已去重）
+ */
+export function entriesForLanguage(entries, languageId) {
+  const lang = String(languageId ?? '').toLowerCase()
+  const global = []
+  const project = []
+  for (const entry of entries) {
+    const entryLang = String(entry?.language ?? '').toLowerCase()
+    if (entryLang && entryLang !== lang) continue
+    if (entry?.scope === 'project') project.push(entry)
+    else global.push(entry)
+  }
+  // 项目条目覆盖同 key 的全局条目（工作区定制优先）
+  const projectKeys = new Set(project.map((entry) => entry.key))
+  const merged = global.filter((entry) => !projectKeys.has(entry.key)).concat(project)
+  return merged.slice(0, MAX_ITEMS)
+}
+
+/**
+ * 注册代码片段补全 provider（幂等；Monaco 就绪后调用一次）。
+ * @author ddj 2026年09月10号
+ * @param monaco window.monaco
+ */
+export function registerSnippetProvider(monaco) {
+  if (registered || !monaco?.languages?.registerCompletionItemProvider) return
+  const snippetKind = monaco.languages.CompletionItemKind?.Snippet
+  const asSnippet = monaco.languages.CompletionItemInsertTextRule?.InsertAsSnippet
+  // 缺少片段枚举（精简版 Monaco）时不注册：否则候选项会退化为纯文本插入，误导用户
+  if (typeof snippetKind !== 'number' || typeof asSnippet !== 'number') return
+  registered = true
+  disposer = monaco.languages.registerCompletionItemProvider('*', {
+    async provideCompletionItems(model, position) {
+      const entries = await loadEntries()
+      if (!entries.length) return { suggestions: [] }
+      const items = entriesForLanguage(entries, model?.getLanguageId?.())
+      if (!items.length) return { suggestions: [] }
+      const word = model.getWordUntilPosition(position)
+      const range = {
+        startLineNumber: position.lineNumber,
+        endLineNumber: position.lineNumber,
+        startColumn: word.startColumn,
+        endColumn: word.endColumn,
+      }
+      return {
+        suggestions: items.map((entry) => ({
+          label: entry.prefix || entry.key,
+          // 无前缀条目不经键入触发（靠「插入代码片段」命令使用），补全里不展示空标签
+          insertText: entry.body,
+          detail: (entry.scope === 'project' ? '项目片段 · ' : '全局片段 · ') + entry.file,
+          documentation: entry.description || entry.key,
+          kind: snippetKind,
+          insertTextRules: asSnippet,
+          filterText: entry.prefix || entry.key,
+          range,
+        })).filter((item) => Boolean(item.label)),
+      }
+    },
+  })
+}
+
+/**
+ * 装配：Monaco 就绪后注册 provider（幂等）。
+ * @author ddj 2026年09月10号
+ * @param monaco window.monaco
+ */
+export function setupSnippets(monaco) {
+  registerSnippetProvider(monaco)
+}
+
+/**
+ * 卸载：注销 provider（插件热重载/卸载时调用）。
+ * @author ddj 2026年09月10号
+ */
+export function disposeSnippets() {
+  if (typeof disposer === 'function') {
+    try { disposer.dispose?.() } catch { /* 已注销 */ }
+  }
+  disposer = null
+  registered = false
+  invalidateSnippets()
+}
+
+/**
+ * 读取可插入条目（「插入代码片段」命令用；含无前缀条目）。
+ * @author ddj 2026年09月10号
+ * @param languageId 当前模型语言（缺省返回全语言 + 该语言条目）
+ * @returns 生效条目数组
+ */
+export async function listSnippetsFor(languageId) {
+  const entries = await loadEntries()
+  if (!languageId) return entries.slice(0, MAX_ITEMS)
+  return entriesForLanguage(entries, languageId)
+}

package/src/client/styles/editor.css

@@ -369,5 +369,56 @@
 [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 浮层，故不依赖编辑区几何。
+   ⚠️ 浮层 z-index 阶梯（自下而上；改动务必保持顺序，tests/overlayZOrder.test.ts 守约）：
+     编辑器内浮层 60(.edrv-search-pop) / 71(.edrv-ctxmenu)
+     < 190 命令栏遮罩 < 200 命令栏
+     < 195 片段浮窗遮罩 < 197 片段二级弹窗遮罩
+   命令栏必须**高于**片段浮窗：曾因片段遮罩(192) 压过命令栏(191)，导致片段浮窗打开时
+   命令栏被整体盖住，按 Ctrl+Shift+P 因「已打开即早退」而毫无反应（表现为快捷键失效）。 */
+[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: 200; 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); }
+
+/* 代码片段选择器（配置 / 插入）：居中浮窗 + 新建二级弹窗。
+   卡片复用 mcp.css 的 .vsm-mcp-dialog（与「添加 MCP」「工作区选择」同一视觉语言），
+   此处只补遮罩、尺寸与列表布局。⚠️ 根节点须带 data-edrv-view，否则这些规则全部失配。 */
+[data-edrv-view] .edrv-snip-mask { position: fixed; inset: 0; z-index: 195; display: flex; align-items: center; justify-content: center; padding: 24px; box-sizing: border-box; background: var(--dsw-alias-bg-mask-drop, rgba(0, 0, 0, .55)); }
+/* 二级弹窗叠在一级浮窗之上（仍在命令栏之下，见上方阶梯说明） */
+[data-edrv-view] .edrv-snip-mask-top { z-index: 197; }
+[data-edrv-view] .edrv-snip-dialog { display: flex; flex-direction: column; overflow: hidden; width: min(620px, calc(100vw - 48px)); }
+[data-edrv-view] .edrv-snip-hint { margin: 0 0 12px; font-size: 12px; line-height: 1.6; color: var(--dsw-alias-label-tertiary, #9aa5b1); }
+[data-edrv-view] .edrv-snip-list { display: flex; flex-direction: column; gap: 1px; min-height: 0; max-height: 46vh; overflow: auto; }
+[data-edrv-view] .edrv-snip-group { padding: 12px 2px 4px; font-size: 11px; font-weight: 600; color: var(--dsw-alias-label-secondary, #aaa); }
+[data-edrv-view] .edrv-snip-row { display: flex; align-items: center; gap: 4px; width: 100%; box-sizing: border-box; padding: 2px; border: none; border-radius: 8px; background: transparent; text-align: left; color: var(--dsw-alias-label-primary, #e6e6e6); font: inherit; }
+[data-edrv-view] .edrv-snip-row:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(255, 255, 255, .06)); }
+[data-edrv-view] button.edrv-snip-row { cursor: pointer; }
+[data-edrv-view] .edrv-snip-row-main { flex: 1 1 auto; min-width: 0; display: flex; flex-direction: column; gap: 2px; padding: 8px 10px; border: none; border-radius: 6px; background: transparent; text-align: left; cursor: pointer; color: inherit; font: inherit; }
+[data-edrv-view] .edrv-snip-label { font-size: 13px; font-weight: 600; color: var(--dsw-alias-label-primary, #e6e6e6); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+[data-edrv-view] .edrv-snip-desc { font-size: 11px; color: var(--dsw-alias-label-tertiary, #9aa5b1); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+[data-edrv-view] .edrv-snip-src { flex: 0 0 auto; padding-right: 6px; font-size: 11px; color: var(--dsw-alias-label-tertiary, #9aa5b1); }
+[data-edrv-view] .edrv-snip-warn { flex: 0 0 auto; font-size: 11px; padding: 2px 7px; border-radius: 999px; background: var(--dsw-alias-state-warn-tertiary, rgba(229, 185, 63, .16)); color: var(--dsw-alias-state-warn-primary, #e5b93f); white-space: nowrap; }
+[data-edrv-view] .edrv-snip-act { flex: 0 0 auto; width: 26px; height: 26px; border: none; border-radius: 6px; background: transparent; color: var(--dsw-alias-label-tertiary, #9aa5b1); font-size: 13px; line-height: 1; cursor: pointer; }
+[data-edrv-view] .edrv-snip-act:hover { background: var(--dsw-alias-interactive-bg-hover-danger, rgba(217, 83, 79, .16)); color: var(--dsw-alias-state-error-primary, #f07878); }
+[data-edrv-view] .edrv-snip-empty { padding: 12px 4px; font-size: 12px; color: var(--dsw-alias-label-tertiary, #9aa5b1); line-height: 1.6; }
+/* 当前文件语言提示条（片段按语言绑定，明确告知生效范围） */
+[data-edrv-view] .edrv-snip-langbar { display: flex; align-items: center; gap: 4px; flex-wrap: wrap; margin: 0 0 10px; padding: 8px 10px; border-radius: 6px; background: var(--dsw-alias-bg-layer-1, #2b2b2b); font-size: 12px; color: var(--dsw-alias-label-secondary, #aaa); }
+[data-edrv-view] .edrv-snip-langbar b { color: var(--dsw-alias-label-primary, #e6e6e6); }
+/* 二级弹窗的动作按钮（原生 .vsm-mcp-dialog-actions 已提供排版与按钮样式） */
+[data-edrv-view] .edrv-snip-dialog .vsm-mcp-dialog-actions { flex-wrap: wrap; }
+/* 删除图标按钮：.vsm-danger 的规则全部限定在 .vsm-mcp-actions button 之下，裸用无样式，此处补自有类 */
+[data-edrv-view] .edrv-snip-act.edrv-snip-danger:hover { background: var(--dsw-alias-interactive-bg-hover-danger, rgba(217, 83, 79, .16)); color: var(--dsw-alias-state-error-primary, #f07878); }
+/* 浮窗内的原生空态（.vsm-mcp-empty 默认为整页尺寸）压缩为对话框尺寸 */
+[data-edrv-view] .edrv-snip-dialog .vsm-mcp-empty { padding: 26px 16px; border: 0; }
+
+
 
 

package/src/client/ui/CommandPalette.ts

@@ -0,0 +1,194 @@
+/**
+ * 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, paletteHostRev, paletteOpenSeq, 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 openSeq = React.useSyncExternalStore(subscribePalette, paletteOpenSeq)
+  // 宿主令牌版本：宿主释放时递增，驱动本实例重试认领（避免宿主更替后无人渲染浮层）
+  const hostRev = React.useSyncExternalStore(subscribePalette, paletteHostRev)
+  const registry = useRegistry()
+  const [token, setToken] = React.useState<object | null>(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 tokenRef = React.useRef<object | null>(null)
+  const host = token !== null
+
+  /**
+   * 认领宿主：放在 effect（不在 render 期做副作用 —— StrictMode 双调用会让首次认领
+   * 被判定失败而永久无人渲染）。hostRev 变化（有实例释放了宿主）时重试认领。
+   *
+   * ⚠️ 此处**不**做 cleanup 释放：releasePaletteHost 会通知订阅者（hostRev 变化），
+   * 若在依赖 hostRev 的 effect 里释放，会「释放→通知→重跑→再释放」自激循环。
+   * 释放统一交给下面的「仅卸载时」effect。
+   */
+  React.useEffect(() => {
+    if (tokenRef.current) return
+    const claimed = claimPaletteHost()
+    if (!claimed) return
+    tokenRef.current = claimed
+    setToken(claimed)
+  }, [hostRev])
+
+  /** 仅卸载时释放宿主；释放后 store 通知其余实例接管（自愈）。 */
+  React.useEffect(() => () => {
+    releasePaletteHost(tokenRef.current)
+    tokenRef.current = null
+  }, [])
+  // 新开（open false→true）时重置查询/选择/提示
+  React.useEffect(() => {
+    if (!open) return
+    setQuery('')
+    setSelected(0)
+    setNotice('')
+  }, [open])
+  // 每次唤起（含已打开时的重复唤起 openSeq 变化）重新聚焦输入框 ——
+  // 否则命令栏被其它浮层短暂遮挡后，快捷键再按会「看似没反应」。
+  React.useEffect(() => {
+    if (!open) return undefined
+    const timer = setTimeout(() => {
+      const input = inputRef.current
+      if (!input) return
+      input.focus()
+      input.select?.()
+    }, 0)
+    return () => clearTimeout(timer)
+  }, [open, openSeq])
+
+  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)
 }