dsh-vscode-mode 0.2.0 → 0.3.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.2.0",
-  "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
+  "version": "0.3.0",
+  "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",
     "dsh-plugin",

package/src/client/commandBridge.ts

@@ -59,6 +59,8 @@ export function createCommandBridge(options: CommandBridgeOptions = {}): Command
   const onKey = (event: KeyboardEvent): void => {
     for (const command of dispatched) {
       if (!matchEvent(event, bindingsOf(command.id))) continue
+      // 可用性前置：命令不可用时既不执行也不吞键（否则无编辑器时 Ctrl+U 会被吃掉）
+      if (!registry.isAvailable(command.id)) continue
       event.preventDefault()
       event.stopPropagation()
       registry.run(command.id)

package/src/client/commandPaletteStore.ts

@@ -19,9 +19,15 @@ let registryTable: CommandRegistry | null = null
 /** 命令栏是否展开。 */
 let opened = false
 
+/** 唤起序号：每次 openCommandPalette 递增（含已打开时的重复唤起），驱动重新聚焦。 */
+let openSeq = 0
+
 /** 当前真正渲染浮层的宿主令牌（null = 无宿主）。 */
 let hostToken: object | null = null
 
+/** 宿主令牌版本：每次释放认领递增，驱动其余实例重试认领（宿主更替后自愈）。 */
+let hostRev = 0
+
 /** 注入的命令执行器（commandBridge 装配时写入）。 */
 let runner: ((id: string) => boolean) | null = null
 
@@ -107,18 +113,40 @@ function rememberFocus(): void {
 }
 
 /**
- * 打开命令栏（已打开时为空操作；记录当前焦点供关闭后归还）。
+ * 打开命令栏（记录当前焦点供关闭后归还）。
+ *
+ * 已打开时**不是空操作**：递增 openSeq 并通知订阅者，让命令栏重新获得焦点。
+ * 事故驱动：片段浮窗遮罩曾压在命令栏之上，此时命令栏处于「已打开但看不见」状态；
+ * 旧实现 `if (opened) return` 让快捷键毫无反应（用户报「调不出来」）。
+ * 递增 seq 使每次触发都有可观测响应（重聚焦 + 重新置顶）。
  * @author ddj 2026年09月10号
  * @param reason 唤起来源（键盘/命令/外部 API）
  */
 export function openCommandPalette(reason = 'keybinding'): void {
-  if (opened) return
+  if (opened) {
+    // 已打开：仍视为一次「唤起」，驱动订阅者重新聚焦（select 重置 / 重新置顶）
+    openSeq += 1
+    openReason = reason
+    notifyPalette()
+    return
+  }
   rememberFocus()
   openReason = reason
   opened = true
+  openSeq += 1
   notifyPalette()
 }
 
+/**
+ * 命令栏唤起序号（每次 open 调用递增，含「已打开时的重复唤起」）。
+ * useSyncExternalStore 快照用它感知「重复唤起」，从而重新聚焦输入框。
+ * @author ddj 2026年09月10号
+ * @returns 当前序号
+ */
+export function paletteOpenSeq(): number {
+  return openSeq
+}
+
 /**
  * 关闭命令栏并归还焦点。
  * @author ddj 2026年09月10号
@@ -144,22 +172,41 @@ export function paletteReason(): string {
 }
 
 /**
- * 认领命令栏宿主（返回 true 表示由本宿主渲染浮层）。
+ * 认领命令栏宿主：成功返回**令牌本身**（调用方须原样持有并在卸载时传回），
+ * 已被他人认领时返回 null。
+ *
+ * ⚠️ 必须返回 internal 存下的同一个对象：旧实现返回 boolean、由调用方自行 `{}` 造令牌，
+ * 导致 `releasePaletteHost` 的身份校验恒不通过 → hostToken 永久泄漏 → 之后**任何**实例
+ * 都认领失败、无人渲染浮层（表现为 Ctrl+Shift+P「完全没有反应」且永不恢复）。
  * @author ddj 2026年09月10号
- * @returns 是否为当前宿主
+ * @returns 认领令牌；null 表示已有宿主
  */
-export function claimPaletteHost(): boolean {
-  if (hostToken !== null) return false
-  hostToken = {}
-  return true
+export function claimPaletteHost(): object | null {
+  if (hostToken !== null) return null
+  const token = {}
+  hostToken = token
+  return token
 }
 
 /**
  * 释放宿主认领（仅持有者可释放，卸载顺序错乱不会顶掉新宿主）。
+ * 释放成功后通知订阅者，让等待中的实例**重新尝试认领**（自愈，避免宿主更替后无人渲染）。
  * @author ddj 2026年09月10号
- * @param token 认领令牌（null 表示本宿主未认领）
+ * @param token 认领令牌（null = 本实例未认领）
  */
 export function releasePaletteHost(token: object | null): void {
   if (token === null || hostToken !== token) return
   hostToken = null
+  hostRev += 1
+  notifyPalette()
+}
+
+/**
+ * 宿主令牌版本（每次释放认领递增）。非宿主实例订阅它，在宿主更替后重试认领 ——
+ * 否则先挂载的实例卸载后无人接管，快捷键会「完全没有反应」且永不恢复。
+ * @author ddj 2026年09月10号
+ * @returns 当前版本号
+ */
+export function paletteHostRev(): number {
+  return hostRev
 }

package/src/client/commandRegistry.ts

@@ -21,6 +21,8 @@ export interface CommandRegistry {
   list(): CommandDef[]
   /** 可用命令（available 缺省视为可用）。 */
   available(): CommandDef[]
+  /** 命令是否已注册且当前可用（未注册返回 false；判定异常按不可用处理）。 */
+  isAvailable(id: string): boolean
   /** 命令栏过滤（先按可用性过滤，再按相关度排序）。 */
   match(query: string): CommandDef[]
   /** 执行命令；不可用/未注册/抛异常统一返回 false（不抛出）。 */
@@ -127,6 +129,10 @@ export function createCommandRegistry(): CommandRegistry {
     get: (id) => entries.get(id),
     list,
     available,
+    isAvailable: (id) => {
+      const command = entries.get(id)
+      return command !== undefined && isAvailable(command)
+    },
     match: (query) => filterCommands(available(), query),
     run(id: string): boolean {
       const command = entries.get(id)

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,9 +369,15 @@
 [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 浮层，故不依赖编辑区几何 */
+/* 命令栏（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: 191; width: min(580px, calc(100vw - 32px)); max-height: 64vh; display: flex; flex-direction: column; border-radius: 10px; background: var(--dsw-alias-bg-overlay, #ffffff); border: 1px solid var(--dsw-alias-border-l2, #cbd2d9); box-shadow: 0 12px 34px rgba(31, 41, 51, .24); overflow: hidden; }
+[data-edrv-view] .edrv-palette { 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; }
@@ -382,6 +388,37 @@
 [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

@@ -14,8 +14,8 @@ import { createCommandRegistry } from '../commandRegistry.js'
 import type { CommandRegistry } from '../commandRegistry.js'
 import { chordOf } from '../keybindings.js'
 import {
-  claimPaletteHost, closeCommandPalette, isPaletteOpen, registryRef, releasePaletteHost,
-  runPaletteCommand, subscribePalette,
+  claimPaletteHost, closeCommandPalette, isPaletteOpen, paletteHostRev, paletteOpenSeq, registryRef,
+  releasePaletteHost, runPaletteCommand, subscribePalette,
 } from '../commandPaletteStore.js'
 import type { CommandDef } from './commandCatalog.js'
 
@@ -64,23 +64,59 @@ function rowsOf(registry: CommandRegistry, query: string): PaletteRow[] {
  */
 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] = React.useState(() => (claimPaletteHost() ? {} : null))
+  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
 
-  React.useEffect(() => () => releasePaletteHost(token), [token])
+  /**
+   * 认领宿主：放在 effect（不在 render 期做副作用 —— StrictMode 双调用会让首次认领
+   * 被判定失败而永久无人渲染）。hostRev 变化（有实例释放了宿主）时重试认领。
+   *
+   * ⚠️ 此处**不**做 cleanup 释放：releasePaletteHost 会通知订阅者（hostRev 变化），
+   * 若在依赖 hostRev 的 effect 里释放，会「释放→通知→重跑→再释放」自激循环。
+   * 释放统一交给下面的「仅卸载时」effect。
+   */
   React.useEffect(() => {
-    if (!open) return undefined
+    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('')
-    const timer = setTimeout(() => inputRef.current?.focus(), 0)
-    return () => clearTimeout(timer)
   }, [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) : []),