dsh-vscode-mode 0.1.62 → 0.2.0

package/package.json

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

package/src/client/commandBridge.ts

@@ -0,0 +1,83 @@
+/**
+ * dsh-vscode-mode client — 指令执行桥（装配层）。
+ * 职责三件：① 把内置指令目录注册进注册表；② 为「桥接派发」类指令挂窗口 capture 键位监听
+ * （EditorView 原生监听的 8 条不进这里，避免双执行）；③ 注入命令栏执行器。
+ * 编辑器动作本身由 EditorView / QuickOpen 监听 `edrv.command.<action>` 窗口事件完成——桥不持有
+ * React 状态，因此指令系统可在编辑器挂载前装配、卸载后仍安全。
+ * 作者 ddj 2026年09月10号
+ */
+import { BRIDGE_COMMANDS, EDITOR_COMMANDS, dispatchedCommands, showCommandsDef } from './ui/commandCatalog.js'
+import { createCommandRegistry } from './commandRegistry.js'
+import type { CommandRegistry } from './commandRegistry.js'
+import { bindingsOf, matchEvent } from './keybindings.js'
+import { log } from './log.js'
+import { openCommandPalette, setPaletteRunner, setRegistryRef } from './commandPaletteStore.js'
+
+const bridgeLog = log.child('commands')
+
+/** 桥接装配选项（事件目标可注入，便于单测）。 */
+export interface CommandBridgeOptions {
+  /** 键盘事件目标（缺省 window；无 window 的纯 Node 环境自动跳过监听）。 */
+  target?: Pick<EventTarget, 'addEventListener' | 'removeEventListener'>
+}
+
+/** 指令执行桥句柄。 */
+export interface CommandBridge {
+  /** 指令注册表（第三方可继续 register）。 */
+  registry: CommandRegistry
+  /** 卸载全部内置指令并解除键位监听（幂等）。 */
+  dispose(): void
+}
+
+/** 解析事件目标（缺省 window；无 window 返回 null）。 */
+function resolveTarget(options: CommandBridgeOptions): CommandBridgeOptions['target'] | null {
+  if (options.target) return options.target
+  if (typeof window === 'undefined') return null
+  return window
+}
+
+/**
+ * 创建指令执行桥：注册内置指令 + 桥接类指令的全局键位监听。
+ * @author ddj 2026年09月10号
+ * @param options 装配选项（事件目标注入）
+ * @returns 指令执行桥句柄
+ */
+export function createCommandBridge(options: CommandBridgeOptions = {}): CommandBridge {
+  const registry = createCommandRegistry()
+  const disposers: Array<() => void> = []
+  const palette = showCommandsDef(() => openCommandPalette('command'))
+  for (const command of [...EDITOR_COMMANDS, ...BRIDGE_COMMANDS]) {
+    disposers.push(registry.register(command))
+  }
+  disposers.push(registry.register(palette))
+  setPaletteRunner((id) => registry.run(id))
+  // 命令栏候选来源：模块引用直传（旧实现依赖 window.dsh，DSH 无该命名空间 → 恒空表）
+  setRegistryRef(registry)
+
+  // 全局键位派发集合：桥接类指令 + 命令栏自身（EditorView/QuickOpen 原生监听的 8 条不在内，避免双执行）
+  const dispatched = dispatchedCommands(palette)
+  const onKey = (event: KeyboardEvent): void => {
+    for (const command of dispatched) {
+      if (!matchEvent(event, bindingsOf(command.id))) continue
+      event.preventDefault()
+      event.stopPropagation()
+      registry.run(command.id)
+      return
+    }
+  }
+  const target = resolveTarget(options)
+  if (target) target.addEventListener('keydown', onKey as EventListener, true)
+
+  const dispose = (): void => {
+    if (target) target.removeEventListener('keydown', onKey as EventListener, true)
+    while (disposers.length) {
+      const release = disposers.pop()
+      if (release) release()
+    }
+    setPaletteRunner(null)
+    setRegistryRef(null)
+  }
+  bridgeLog.info('指令注册表已装配（' + registry.list().length + ' 条指令，桥接键位 '
+    + dispatched.length + ' 条）')
+  return { registry, dispose }
+}

package/src/client/commandGlobals.ts

@@ -0,0 +1,13 @@
+/**
+ * dsh-vscode-mode client — 指令系统的全局挂点名约定。
+ * 单独成模块：装配层（client/index.ts）与读取方（命令栏/第三方）都要用，
+ * 放这里可避免 CommandPalette ↔ index 的循环依赖。
+ *
+ * ⚠️ 必须挂在 window 自身（双下划线 + edrv 前缀，与既有 __edrvExtPoll 同风格）。
+ * 旧实现写 window.dsh.edrvCommands——DSH 从不创建 window.dsh 命名空间（全仓库无赋值），
+ * 该路径恒为死代码并导致命令栏读到空表；不要再改回气泡式挂点。
+ * 作者 ddj 2026年09月10号
+ */
+
+/** 指令注册表的全局挂点名：window[REGISTRY_GLOBAL]（第三方注册与调试读取；命令栏首选模块引用）。 */
+export const REGISTRY_GLOBAL = '__edrvCommands__'

package/src/client/commandPaletteStore.ts

@@ -0,0 +1,165 @@
+/**
+ * dsh-vscode-mode client — 命令栏开关状态与单实例宿主认领。
+ * 命令栏浮层走 createPortal 渲染到 body，但组件必须挂在插件自己的 React 树里：
+ * 编辑区有三种形态（官方右侧 Sidebar / better-sidebar / 中央页签），会话切换时旧树先卸载、
+ * 新树后挂载，可能出现两个宿主——claimPaletteHost 保证任一时刻只有一个宿主真正渲染浮层。
+ * 运行体由 commandBridge 经 setPaletteRunner 注入（避免 store ↔ 注册表循环依赖）；
+ * 注册表本体经 setRegistryRef 存入模块引用，命令栏据此读取候选——不依赖任何 window 全局
+ * （旧实现写 window.dsh.edrvCommands，而 DSH 从不创建 window.dsh，导致命令栏恒为空表）。
+ * 作者 ddj 2026年09月10号
+ */
+import type { CommandRegistry } from './commandRegistry.js'
+
+/** 命令栏上次的唤起来源（诊断用）。 */
+let openReason = ''
+
+/** 装配期存入的指令注册表（命令栏读取候选的唯一真源）。 */
+let registryTable: CommandRegistry | null = null
+
+/** 命令栏是否展开。 */
+let opened = false
+
+/** 当前真正渲染浮层的宿主令牌（null = 无宿主）。 */
+let hostToken: object | null = null
+
+/** 注入的命令执行器（commandBridge 装配时写入）。 */
+let runner: ((id: string) => boolean) | null = null
+
+/** 打开命令栏前的焦点元素（关闭后归还焦点，键盘操作不中断）。 */
+let focusBack: HTMLElement | null = null
+
+const listeners = new Set<() => void>()
+
+/** 通知全部订阅者（回调异常不影响其他订阅）。 */
+function notifyPalette(): void {
+  for (const listener of listeners) {
+    try {
+      listener()
+    } catch {
+      /* 订阅回调异常忽略 */
+    }
+  }
+}
+
+/**
+ * 注入命令执行器（命令栏执行选中命令时调用）。
+ * @author ddj 2026年09月10号
+ * @param next 执行器（返回是否执行成功）
+ */
+export function setPaletteRunner(next: ((id: string) => boolean) | null): void {
+  runner = next
+}
+
+/**
+ * 执行命令栏选中的命令。
+ * @author ddj 2026年09月10号
+ * @param id 命令 id
+ * @returns 是否执行成功（执行器未注入/命令不可用/抛异常均为 false）
+ */
+export function runPaletteCommand(id: string): boolean {
+  if (!runner) return false
+  return runner(id) === true
+}
+
+/**
+ * 存入指令注册表（commandBridge 装配期调用；命令栏据此读取候选）。
+ * @author ddj 2026年09月10号
+ * @param next 指令注册表（null = 卸载）
+ */
+export function setRegistryRef(next: CommandRegistry | null): void {
+  registryTable = next
+}
+
+/**
+ * 读取指令注册表（未装配返回 null；浮层据此回退全局/空表）。
+ * @author ddj 2026年09月10号
+ * @returns 指令注册表或 null
+ */
+export function registryRef(): CommandRegistry | null {
+  return registryTable
+}
+
+/**
+ * 订阅命令栏开关变化。
+ * @author ddj 2026年09月10号
+ * @param listener 变化回调
+ * @returns 取消订阅函数
+ */
+export function subscribePalette(listener: () => void): () => void {
+  listeners.add(listener)
+  return () => listeners.delete(listener)
+}
+
+/**
+ * 命令栏是否展开（useSyncExternalStore 快照）。
+ * @author ddj 2026年09月10号
+ * @returns 是否展开
+ */
+export function isPaletteOpen(): boolean {
+  return opened
+}
+
+/** 记录打开前的焦点元素（只在真正需要归还时记录）。 */
+function rememberFocus(): void {
+  if (typeof document === 'undefined') return
+  const active = document.activeElement
+  focusBack = active instanceof HTMLElement ? active : null
+}
+
+/**
+ * 打开命令栏（已打开时为空操作；记录当前焦点供关闭后归还）。
+ * @author ddj 2026年09月10号
+ * @param reason 唤起来源（键盘/命令/外部 API）
+ */
+export function openCommandPalette(reason = 'keybinding'): void {
+  if (opened) return
+  rememberFocus()
+  openReason = reason
+  opened = true
+  notifyPalette()
+}
+
+/**
+ * 关闭命令栏并归还焦点。
+ * @author ddj 2026年09月10号
+ */
+export function closeCommandPalette(): void {
+  if (!opened) return
+  opened = false
+  openReason = ''
+  notifyPalette()
+  const target = focusBack
+  focusBack = null
+  if (!target || typeof target.focus !== 'function') return
+  try {
+    target.focus()
+  } catch {
+    /* 目标已卸载时忽略 */
+  }
+}
+
+/** 上次唤起来源（诊断/测试读取）。 */
+export function paletteReason(): string {
+  return openReason
+}
+
+/**
+ * 认领命令栏宿主（返回 true 表示由本宿主渲染浮层）。
+ * @author ddj 2026年09月10号
+ * @returns 是否为当前宿主
+ */
+export function claimPaletteHost(): boolean {
+  if (hostToken !== null) return false
+  hostToken = {}
+  return true
+}
+
+/**
+ * 释放宿主认领（仅持有者可释放，卸载顺序错乱不会顶掉新宿主）。
+ * @author ddj 2026年09月10号
+ * @param token 认领令牌（null 表示本宿主未认领）
+ */
+export function releasePaletteHost(token: object | null): void {
+  if (token === null || hostToken !== token) return
+  hostToken = null
+}

package/src/client/commandRegistry.ts

@@ -0,0 +1,144 @@
+/**
+ * dsh-vscode-mode client — 指令注册表（命令栏与快捷键系统的唯一数据源）。
+ * 镜像 sidebar/registry.ts 的注册表模式：register 返回注销器、list/subscribe 可订阅；
+ * 额外提供 run(id)：先做可用性判定再执行，运行体异常一律捕获上报，绝不让命令抛出到事件循环。
+ * 重复 id 按「后注册者生效」覆盖，旧注销器带身份校验（不会误删新实例，见 releaseRegistry）。
+ * 作者 ddj 2026年09月10号
+ */
+import { filterCommands } from './commandSearch.js'
+import { log } from './log.js'
+import type { CommandDef } from './ui/commandCatalog.js'
+
+/** 指令注册表（对插件内与第三方一致）。 */
+export interface CommandRegistry {
+  /** 注册命令；返回注销函数（幂等，重复调用无效）。 */
+  register(command: CommandDef): () => void
+  /** 命令是否存在。 */
+  has(id: string): boolean
+  /** 读取命令定义。 */
+  get(id: string): CommandDef | undefined
+  /** 全部命令（按目录序稳定排序）。 */
+  list(): CommandDef[]
+  /** 可用命令（available 缺省视为可用）。 */
+  available(): CommandDef[]
+  /** 命令栏过滤（先按可用性过滤，再按相关度排序）。 */
+  match(query: string): CommandDef[]
+  /** 执行命令；不可用/未注册/抛异常统一返回 false（不抛出）。 */
+  run(id: string): boolean
+  /** 订阅注册表变化。 */
+  subscribe(listener: () => void): () => void
+}
+
+const registryLog = log.child('commands')
+
+/** 校验命令定义（缺 id/label/run 抛 TypeError，早失败优于静默无效）。 */
+function assertCommand(command: CommandDef): void {
+  if (!command || typeof command.id !== 'string' || !command.id) throw new TypeError('命令必须提供 id')
+  if (typeof command.label !== 'string' || !command.label) throw new TypeError('命令必须提供 label：' + command.id)
+  if (typeof command.run !== 'function') throw new TypeError('命令必须提供 run：' + command.id)
+}
+
+/** 目录序（order 缺省 100；非有限值同样按 100）。 */
+function orderOf(command: CommandDef): number {
+  return typeof command.order === 'number' && Number.isFinite(command.order) ? command.order : 100
+}
+
+/** 命令是否可用（available 缺省视为可用；判定异常按不可用处理）。 */
+function isAvailable(command: CommandDef): boolean {
+  if (typeof command.available !== 'function') return true
+  try {
+    return command.available() === true
+  } catch (error) {
+    registryLog.warn('可用性判定异常（按不可用处理）：' + command.id + ' · ' + String(error))
+    return false
+  }
+}
+
+/**
+ * 注销命令（仅当表中仍是本次注册的定义时移除，避免旧实例误删新实例）。
+ * @author ddj 2026年09月10号
+ * @param entries 命令表
+ * @param notify 变化通知
+ * @param command 注册时的定义
+ * @returns 注销函数
+ */
+function releaseRegistry(entries: Map<string, CommandDef>, notify: () => void, command: CommandDef): () => void {
+  let released = false
+  return () => {
+    if (released) return
+    released = true
+    if (entries.get(command.id) !== command) return
+    entries.delete(command.id)
+    notify()
+  }
+}
+
+/**
+ * 执行已注册命令（可用性判定 → 运行体 → 异常上报）。
+ * @author ddj 2026年09月10号
+ * @param command 命令定义
+ * @returns 是否真正执行
+ */
+function runCommand(command: CommandDef): boolean {
+  if (!isAvailable(command)) {
+    registryLog.debug('命令不可用，已跳过：' + command.id)
+    return false
+  }
+  try {
+    command.run()
+    registryLog.debug('命令已执行：' + command.id)
+    return true
+  } catch (error) {
+    registryLog.error('命令执行失败：' + command.id + ' · ' + String(error))
+    return false
+  }
+}
+
+/**
+ * 创建指令注册表。
+ * @author ddj 2026年09月10号
+ * @returns 指令注册表
+ */
+export function createCommandRegistry(): CommandRegistry {
+  const entries = new Map<string, CommandDef>()
+  const listeners = new Set<() => void>()
+  const notify = (): void => {
+    for (const listener of listeners) {
+      try {
+        listener()
+      } catch (error) {
+        registryLog.warn('注册表订阅回调异常：' + String(error))
+      }
+    }
+  }
+  const list = (): CommandDef[] =>
+    [...entries.values()].sort((a, b) => orderOf(a) - orderOf(b))
+  const available = (): CommandDef[] => list().filter(isAvailable)
+  return {
+    register(command: CommandDef): () => void {
+      assertCommand(command)
+      const replaced = entries.get(command.id)
+      if (replaced !== undefined) registryLog.warn('命令 id 重复注册（后者生效）：' + command.id)
+      entries.set(command.id, command)
+      notify()
+      return releaseRegistry(entries, notify, command)
+    },
+    has: (id) => entries.has(id),
+    get: (id) => entries.get(id),
+    list,
+    available,
+    match: (query) => filterCommands(available(), query),
+    run(id: string): boolean {
+      const command = entries.get(id)
+      if (!command) {
+        registryLog.warn('命令未注册：' + id)
+        return false
+      }
+      return runCommand(command)
+    },
+    subscribe(listener: () => void): () => void {
+      listeners.add(listener)
+      return () => listeners.delete(listener)
+    },
+  }
+}

package/src/client/commandSearch.ts

@@ -0,0 +1,89 @@
+/**
+ * dsh-vscode-mode client — 命令栏筛选与排序（纯函数，可单测）。
+ * 匹配语义：查询与索引文本统一小写，空格分词，全部 token 需在 label/id/category
+ * 任一字段中以子串出现（中文子串匹配天然成立）。
+ * 排序语义：命中字段权重（label 0 < id 1 < category 2）+ 目录序（order 缺省 100）+ 注册序，
+ * 保证同一查询下结果稳定、越相关的越靠前。
+ * 作者 ddj 2026年09月10号
+ */
+import type { CommandDef } from './ui/commandCatalog.js'
+
+/** 排序用基础序（未声明 order 的命令排在已声明之后）。 */
+const DEFAULT_ORDER = 100
+
+/** 命中字段权重（数值越小越优先）。 */
+const FIELD_WEIGHT: Record<string, number> = { label: 0, id: 1, category: 2 }
+
+/** 命令栏候选行（命令定义 + 匹配权重）。 */
+export interface CommandHit {
+  command: CommandDef
+  weight: number
+}
+
+/** 命中字段索引文本（小写）。 */
+interface IndexedFields {
+  label: string
+  id: string
+  category: string
+}
+
+/** 小写化（非字符串按空串处理，容错外部脏数据）。 */
+function lower(text: unknown): string {
+  return typeof text === 'string' ? text.toLocaleLowerCase('en-US') : ''
+}
+
+/** 建立一条命令的索引文本。 */
+function indexOf(command: CommandDef): IndexedFields {
+  return { label: lower(command.label), id: lower(command.id), category: lower(command.category) }
+}
+
+/**
+ * 命令是否命中全部 token；命中时返回最优（最小）字段权重。
+ * @author ddj 2026年09月10号
+ * @param fields 命令索引文本
+ * @param tokens 小写查询 token
+ * @returns 字段权重；未命中返回 null
+ */
+function hitWeight(fields: IndexedFields, tokens: readonly string[]): number | null {
+  let best: number | null = null
+  for (const token of tokens) {
+    let tokenWeight: number | null = null
+    for (const field of ['label', 'id', 'category'] as const) {
+      if (!fields[field].includes(token)) continue
+      const weight = FIELD_WEIGHT[field]
+      if (tokenWeight === null || weight < tokenWeight) tokenWeight = weight
+      if (weight === 0) break
+    }
+    if (tokenWeight === null) return null
+    if (best === null || tokenWeight < best) best = tokenWeight
+  }
+  return best
+}
+
+/** 目录序（order 缺省 100；非有限值同样按 100）。 */
+function orderOf(command: CommandDef): number {
+  const order = command.order
+  return typeof order === 'number' && Number.isFinite(order) ? order : DEFAULT_ORDER
+}
+
+/**
+ * 过滤并按相关度排序命令（空查询返回全部，仅按目录序排序）。
+ * @author ddj 2026年09月10号
+ * @param commands 候选命令（调用方通常已按可用性过滤）
+ * @param query 用户输入
+ * @returns 命中命令数组
+ */
+export function filterCommands(commands: readonly CommandDef[], query: string): CommandDef[] {
+  const tokens = lower(query).split(/\s+/).filter(Boolean)
+  const hits: CommandHit[] = []
+  for (const command of commands) {
+    const weight = tokens.length ? hitWeight(indexOf(command), tokens) : 0
+    if (weight !== null) hits.push({ command, weight })
+  }
+  return hits
+    .map((hit, index) => ({ hit, index }))
+    .sort((a, b) => a.hit.weight - b.hit.weight
+      || orderOf(a.hit.command) - orderOf(b.hit.command)
+      || a.index - b.index)
+    .map((entry) => entry.hit.command)
+}

package/src/client/editorModelState.ts

@@ -0,0 +1,30 @@
+/**
+ * dsh-vscode-mode client — 编辑器模型可用性探测（模块级，不依赖 React）。
+ * 命令可用性判定（快捷键过滤 / 命令栏隐藏 / 执行前置检查）需要「当前是否有活动编辑器」，
+ * 而命令目录是模块级常量、拿不到 EditorView 实例，故统一读 DOM 标记：
+ * `[data-edrv-view]` 只在 EditorView 挂载期存在于文档中（浮层 portal 走同一根节点）。
+ * 作者 ddj 2026年09月10号
+ */
+
+/** 编辑器根节点选择器（EditorView 三种形态共用）。 */
+export const EDITOR_ROOT_SELECTOR = '[data-edrv-view]'
+
+/**
+ * 当前文档是否挂载了编辑器视图（无 document 的运行环境返回 false）。
+ * @author ddj 2026年09月10号
+ * @returns 是否存在编辑器根节点
+ */
+export function hasEditorView(): boolean {
+  if (typeof document === 'undefined') return false
+  return document.querySelector(EDITOR_ROOT_SELECTOR) !== null
+}
+
+/**
+ * 当前文档是否已有 Monaco 活动模型（编辑器打开着文件而非空态）。
+ * @author ddj 2026年09月10号
+ * @returns 是否存在活动模型
+ */
+export function hasEditorModel(): boolean {
+  if (typeof document === 'undefined') return false
+  return document.querySelector('.monaco-editor textarea.inputarea') !== null
+}

package/src/client/index.ts

@@ -22,6 +22,7 @@ import { ConversationDiffDock } from './ui/ConversationDiffDock.js'
 import { McpSettings } from './ui/McpSettings.js'
 import { rpc } from './rpc.js'
 import { loadMonaco } from './monaco/loader.js'
+import { observeScheme, schemeOfSnapshot } from './monaco/theme.js'
 import { createFileOpenerRegistry, scanSidebar, officialSidebarOpener, shouldClaimFiles, type FileOpenContext } from './fileOpeners.js'
 import type { FileOpenerRegistry } from './fileOpeners.js'
 import { installOpenPathRouter, vscodeOpener, autoValue } from './openPathRouter.js'
@@ -33,6 +34,7 @@ import { detectSidebarService, installSideEditor, setEnsureSideEditor, SIDEBAR_I
 import { detectOfficial, installOfficial, registerOfficialFileClaim, OFFICIAL_TAB_KIND, OFFICIAL_TAB_TITLE, isEditorTabActive, restoreEditorTab } from './officialSidebar.js'
 import { SideEditorTab } from './ui/SideEditorTab.js'
 import { OfficialSideTab } from './ui/OfficialSideTab.js'
+import { createClaimRouter } from './ui/ClaimRouter.js'
 import { createAddToConversation } from './addToConversation.js'
 import { createSidebarPanelRegistry } from './sidebar/registry.js'
 import { createFilePanel } from './sidebar/panels/index.js'
@@ -44,6 +46,8 @@ import { createOutlinePanel } from './outline/index.js'
 import { createOutlineSourceRegistry, registerBuiltinOutlineSources } from './outline/sources.js'
 import { createLspOutlineSource } from './outline/lspSource.js'
 import { keybindingsApply } from './keybindings.js'
+import { createCommandBridge } from './commandBridge.js'
+import { REGISTRY_GLOBAL } from './commandGlobals.js'
 import { sidebarMinApply } from './sidebarMin.js'
 import { log } from './log.js'
 import { setupLsp, setSession } from './monaco/lsp/index.js'
@@ -54,6 +58,33 @@ import type { CompatAdapter } from '../shared/compat.js'
 // web boot 直接失败（'1 entry did not activate'）。兼容层用 ctx.get 运行时探测 + 降级，不靠 inject。
 export const inject = ['slots', 'timer', 'locale', 'connection', 'remote', 'workspaces', 'sessions', 'conversation', 'settingsScope']
 
+/** 指令桥装配幂等标记（同一 document 重复 apply 只装配一次，避免重复键位监听）。 */
+let commandsMounted = false
+
+/**
+ * 装配指令注册表（指令桥 + 命令栏）。
+ * 指令桥不依赖已挂载编辑器（run 只派发窗口事件），故可在启动期装配；
+ * 命令栏浮层的宿主由 CommandPalette 自己在编辑区树内认领。
+ * @author ddj 2026年09月10号
+ * @param ctx 客户端根上下文
+ * @returns void
+ */
+function setupCommands(ctx: any): void {
+  if (commandsMounted) return
+  commandsMounted = true
+  const bridge = createCommandBridge()
+  ctx.provide(REGISTRY_GLOBAL, bridge.registry)
+  // 无条件镜像到 window（DSH 不创建 window.dsh，旧条件式赋值是死代码 → 命令栏空表）
+  const host = window as unknown as Record<string, unknown>
+  host[REGISTRY_GLOBAL] = bridge.registry
+  ctx.effect(() => () => {
+    bridge.dispose()
+    commandsMounted = false
+    if (host[REGISTRY_GLOBAL] === bridge.registry) delete host[REGISTRY_GLOBAL]
+  }, 'vscode-mode: command registry')
+  log.info('指令系统已装配：' + bridge.registry.list().length + ' 条指令，Ctrl+Shift+P 打开命令栏')
+}
+
 /**
  * 装配客户端：注册中央编辑区视图与 header 差异角标。
  * @author ddj 2026年08月20号
@@ -63,6 +94,9 @@ export const inject = ['slots', 'timer', 'locale', 'connection', 'remote', 'work
 export function apply(ctx: any): void {
   const schedule = (fn: () => void, ms: number) => ctx.timeout(fn, ms)
 
+  // 指令系统（命令栏 + 指令注册表）先装配：命令栏在被任何 React slot 渲染前即可唤起
+  setupCommands(ctx)
+
   const registry: FileOpenerRegistry = createFileOpenerRegistry()
   const workspaces = ctx.get('workspaces')
   const sessions = ctx.get('sessions')
@@ -148,7 +182,7 @@ export function apply(ctx: any): void {
     { name: '侧边栏打开器（' + SIDEBAR_PLUGIN + '）', active: registry.get(SIDEBAR_PLUGIN) !== undefined, note: registry.get(SIDEBAR_PLUGIN) !== undefined ? '已注册（优先级 80）' : '未检测到侧边栏打开能力' },
     { name: '侧边栏编辑区（官方 Sidebar）', active: officialService !== undefined, note: officialService !== undefined ? '编辑区=官方右侧 Sidebar Tab（对话+编辑同屏，DSH 0.1.5+）' : '官方侧边栏服务未探测到（DSH < 0.1.5-alpha.1 时属预期）' },
     { name: '侧边栏编辑区（' + SIDEBAR_PLUGIN + '，归档）', active: sideService !== undefined, note: sideService !== undefined ? '编辑区=侧边栏 Tab（旧版 DSH 回退形态）' : '未检测到；DSH ≥ 0.1.5 优先官方侧边栏，旧版可安装（' + SIDEBAR_INSTALL_CMD + '）' },
-    { name: '文件链接官方认领（dsh-resource://file）', active: claimDisposer !== null, note: claimDisposer !== null ? '聊天文件链接由本插件编辑器接管（官方侧边栏内打开）' : '链接走官方查看器或旧版路由（未认领）' },
+    { name: '文件链接官方认领（dsh-resource://file）', active: claimDisposer !== null, note: claimDisposer !== null ? '聊天文件链接转发进单一编辑器页签（文件分页归编辑器自带页签栏）' : '链接走官方查看器或旧版路由（未认领）' },
   ]
 
   ctx.provide('fileOpeners', registry)
@@ -183,14 +217,16 @@ export function apply(ctx: any): void {
     const sidebar = scanSidebar(ctx)
     return sidebar ? registry.register(sidebar) : undefined
   }, 'vscode-mode: sidebar file opener')
-  // 官方侧边栏正文组件装配（页类型与 file 认领两类 Tab 共用同一 EditorView 形态）
+  // 官方侧边栏正文组件装配（页类型正文；兼作 file 认领转发失败时的兜底正文）
   const officialRenderTab = (props: Record<string, unknown>) => React.createElement(OfficialSideTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, sessions }))
-  /** 官方 file 地址认领同步：自动/VSCodeMode 档认领（链接进本插件编辑器），其余交官方查看器。 */
+  /** 官方 file 地址认领同步：自动/VSCodeMode 档认领（转发进单一编辑器页签），其余交官方查看器。 */
   const syncFileClaim = (): void => {
     const official = officialService
     const want = official !== undefined && shouldClaimFiles(selected)
     if (want && claimDisposer === null && official) {
-      const disposer = registerOfficialFileClaim({ tabs: official.tabs, slots: ctx.slots, renderTab: officialRenderTab })
+      // 认领正文只做转发：文件分页收归编辑器自带页签栏，官方侧栏不再按文件分裂编辑器实例
+      const renderTab = createClaimRouter({ service: official.service, schedule, fallback: officialRenderTab })
+      const disposer = registerOfficialFileClaim({ tabs: official.tabs, slots: ctx.slots, renderTab })
       if (disposer !== null) claimDisposer = ctx.effect(() => disposer, 'vscode-mode: official file claim')
       return
     }
@@ -265,6 +301,21 @@ export function apply(ctx: any): void {
   }
   retryRemoteOpen()
 
+  // 官方主题跟随（DSH 0.1.5+）：ctx.theme 快照事件优先，其次明暗标记观察（observeScheme），
+  // 都不可用时 theme.ts 的 detectColorScheme 兜底；统一广播 edrv:theme-change 触发 Monaco 主题重刷。
+  const themeService = ctx.get('theme') as { getTheme?: () => unknown } | undefined
+  const emitTheme = (): void => {
+    const snapshot = typeof themeService?.getTheme === 'function' ? themeService.getTheme() : undefined
+    window.dispatchEvent(new CustomEvent('edrv:theme-change', { detail: { scheme: schemeOfSnapshot(snapshot) } }))
+  }
+  ctx.effect(() => {
+    if (!themeService || typeof ctx.on !== 'function') return undefined
+    const disposer = ctx.on('theme/change', emitTheme)
+    return typeof disposer === 'function' ? disposer : undefined
+  }, 'vscode-mode: official theme event')
+  ctx.effect(() => observeScheme(emitTheme), 'vscode-mode: theme attribute watch')
+  emitTheme()
+
   // 中央「文件编辑」页签（旧形态回退）：类 VSCode 编辑器；侧边栏形态（官方/better-sidebar）可用时
   // 编辑器住侧边栏 Tab，本页签不注册（避免双实例：Monaco×2 + diff dock 每会话单源抢占）。
   const registerLegacyTab = (): (() => void) | null => {