dsh-vscode-mode 0.10.0 → 0.12.0

package/package.json

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

package/src/client/activePathStore.ts

@@ -0,0 +1,28 @@
+/**
+ * dsh-vscode-mode client — 活动编辑器文件路径单点（模块级，不依赖 React）。
+ * 命令目录（ui/commandCatalog）是模块级常量、拿不到 EditorView 实例；其可用性判定
+ * 需要「当前活动文件是什么」（如 Markdown 预览切换仅 .md 活动文件吞键），故由
+ * EditorView 把 active 状态镜像到本 store，目录按需读取。
+ * 作者 ddj 2026年10月
+ */
+
+/** 当前活动文件路径（null = 无活动文件/编辑器未挂载）。 */
+let activePath: string | null = null
+
+/**
+ * 镜像活动文件路径（EditorView 渲染同步点调用；卸载时回写 null）。
+ * @author ddj 2026年10月
+ * @param path 活动文件路径或 null
+ */
+export function setActiveEditorPath(path: string | null): void {
+  activePath = path
+}
+
+/**
+ * 读取当前活动文件路径。
+ * @author ddj 2026年10月
+ * @returns 活动文件路径或 null
+ */
+export function activeEditorPath(): string | null {
+  return activePath
+}

package/src/client/commandBridge.ts

@@ -1,48 +1,34 @@
 /**
  * dsh-vscode-mode client — 指令执行桥（装配层）。
- * 职责三件：① 把内置指令目录注册进注册表；② 为「桥接派发」类指令挂窗口 capture 键位监听
- * （EditorView 原生监听的 8 条不进这里，避免双执行）；③ 注入命令栏执行器。
+ * 职责两件：① 把内置指令目录注册进注册表（命令栏候选源）；② 注入命令栏执行器。
+ * 键位派发全部归官方 shortcuts 机制（shortcutsOfficial.registerOfficialShortcuts 注册官方命令，
+ * resolve 走注册表 run）——本桥不再挂窗口键位监听，避免与官方派发双执行。
  * 编辑器动作本身由 EditorView / QuickOpen 监听 `edrv.command.<action>` 窗口事件完成——桥不持有
  * React 状态，因此指令系统可在编辑器挂载前装配、卸载后仍安全。
- * 作者 ddj 2026年09月10号
+ * 作者 ddj 2026年09月10号 / 2026年10月
  */
-import { BRIDGE_COMMANDS, EDITOR_COMMANDS, dispatchedCommands, showCommandsDef } from './ui/commandCatalog.js'
+import { BRIDGE_COMMANDS, EDITOR_COMMANDS, 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 {
+export function createCommandBridge(): CommandBridge {
   const registry = createCommandRegistry()
   const disposers: Array<() => void> = []
   const palette = showCommandsDef(() => openCommandPalette('command'))
@@ -54,24 +40,7 @@ export function createCommandBridge(options: CommandBridgeOptions = {}): Command
   // 命令栏候选来源：模块引用直传（旧实现依赖 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
-      // 可用性前置：命令不可用时既不执行也不吞键（否则无编辑器时 Ctrl+U 会被吃掉）
-      if (!registry.isAvailable(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()
@@ -79,7 +48,6 @@ export function createCommandBridge(options: CommandBridgeOptions = {}): Command
     setPaletteRunner(null)
     setRegistryRef(null)
   }
-  bridgeLog.info('指令注册表已装配（' + registry.list().length + ' 条指令，桥接键位 '
-    + dispatched.length + ' 条）')
+  bridgeLog.info('指令注册表已装配（' + registry.list().length + ' 条指令；键位派发已归官方 shortcuts 机制）')
   return { registry, dispose }
 }

package/src/client/dap/hover.ts

@@ -7,6 +7,7 @@
  */
 import { dapStore } from './store.js'
 import { pathOfModel } from '../monaco/lsp/lspClient.js'
+import { LUA_RESERVED_WORD_SET } from '../luaReservedWords.js'
 import { BLOCK_ATTR, EQ_ATTR, EXPR_ATTR, HEAD_ATTR, TYPE_ATTR, VAL_ATTR, createTreeState, escapeHtml, initialHtml } from './hoverTree.js'
 
 const GLOBAL_KEY = '__edrvDapHoverProvider__'
@@ -35,12 +36,6 @@ function treeKeyOf(target: { expression: string; lineNumber: number; startColumn
   return target.expression + '@' + path + ':' + target.lineNumber + ':' + target.startColumn + '-' + target.endColumn
 }
 
-/** Lua 保留字集合（保留字不是可求值表达式，避免 adapter 返回 syntax err 噪声）。 */
-const LUA_KEYWORDS = new Set([
-  'and', 'break', 'do', 'else', 'elseif', 'end', 'false', 'for', 'function', 'goto',
-  'if', 'in', 'local', 'nil', 'not', 'or', 'repeat', 'return', 'then', 'true', 'until', 'while',
-])
-
 /** 可求值路径表达式：标识符链，成员用 . 或 : 连接（注释里的中文文本等一律不匹配）。 */
 const EVAL_EXPR = /^[A-Za-z_][A-Za-z0-9_]*(?:[.:][A-Za-z_][A-Za-z0-9_]*)*$/
 
@@ -51,7 +46,7 @@ const EVAL_EXPR = /^[A-Za-z_][A-Za-z0-9_]*(?:[.:][A-Za-z_][A-Za-z0-9_]*)*$/
  * @returns 是否可求值
  */
 function isEvalExpr(text: string): boolean {
-  return EVAL_EXPR.test(text) && !LUA_KEYWORDS.has(text)
+  return EVAL_EXPR.test(text) && !LUA_RESERVED_WORD_SET.has(text)
 }
 
 /**

package/src/client/index.ts

@@ -27,6 +27,8 @@ import { createFileOpenerRegistry, scanSidebar, officialSidebarOpener, shouldCla
 import type { FileOpenerRegistry } from './fileOpeners.js'
 import { installOpenPathRouter, vscodeOpener, autoValue } from './openPathRouter.js'
 import { patchRemoteOpen, probeRemoteOpen } from './remoteOpenRouter.js'
+import { patchSettingsDoc, probeSettingsDoc } from './settingsDocRouter.js'
+import { openEditorView } from './events.js'
 import { setupExtOpen } from './externalOpen.js'
 import { SettingsContext } from './settingsContext.js'
 import { SIDEBAR_PLUGIN, registerSlotSafely, settingsBridge } from './compat.js'
@@ -48,9 +50,13 @@ import { createDefaultFileMenuItems } from './sidebar/menuItems.js'
 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 { applyOfficialChords } from './keybindings.js'
 import { createCommandBridge } from './commandBridge.js'
+import type { CommandBridge } from './commandBridge.js'
 import { REGISTRY_GLOBAL } from './commandGlobals.js'
+import { awaitShortcutsService, bindCatalogChords, detectShortcuts, installLegacyKeys, migrateLegacyKeybindings, registerOfficialShortcuts } from './shortcutsOfficial.js'
+import { SHORTCUT_PROFILES, defaultKeybindings, normalizeKeybindings } from '../shared/keybindings.js'
+import { ShortcutSettings } from './ui/ShortcutSettings.js'
 import { sidebarMinApply } from './sidebarMin.js'
 import { editorLimitApply } from './editorLimit.js'
 import { log } from './log.js'
@@ -69,31 +75,32 @@ import type { CompatAdapter } from '../shared/compat.js'
 // 写死任一桥名都会在另一版本停等）——设置桥由 compat.pickSettingsBinder 运行时探测三级降级。
 export const inject = ['slots', 'timer', 'locale', 'connection', 'remote', 'workspaces', 'sessions', 'conversation']
 
-/** 指令桥装配幂等标记（同一 document 重复 apply 只装配一次，避免重复键位监听）。 */
-let commandsMounted = false
+/** 指令桥单例（同一 document 重复 apply 只装配一次；HMR 重挂不重复注册）。 */
+let commandsBridge: CommandBridge | null = null
 
 /**
  * 装配指令注册表（指令桥 + 命令栏）。
  * 指令桥不依赖已挂载编辑器（run 只派发窗口事件），故可在启动期装配；
  * 命令栏浮层的宿主由 CommandPalette 自己在编辑区树内认领。
- * @author ddj 2026年09月10号
+ * @author ddj 2026年09月10号 / 2026年10月
  * @param ctx 客户端根上下文
- * @returns void
+ * @returns 指令桥（官方 shortcuts 注册的执行器来源）
  */
-function setupCommands(ctx: any): void {
-  if (commandsMounted) return
-  commandsMounted = true
+function setupCommands(ctx: any): CommandBridge {
+  if (commandsBridge) return commandsBridge
   const bridge = createCommandBridge()
+  commandsBridge = bridge
   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
+    commandsBridge = null
     if (host[REGISTRY_GLOBAL] === bridge.registry) delete host[REGISTRY_GLOBAL]
   }, 'vscode-mode: command registry')
   log.info('指令系统已装配：' + bridge.registry.list().length + ' 条指令，Ctrl+Shift+P 打开命令栏')
+  return bridge
 }
 
 /**
@@ -104,9 +111,32 @@ function setupCommands(ctx: any): void {
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function apply(ctx: any): void {
   const schedule = (fn: () => void, ms: number) => ctx.timeout(fn, ms)
+  ctx.effect(() => {
+    let disposed = false
+    let attempts = 0
+    let restore: (() => void) | null = null
+    const install = (): void => {
+      if (disposed || restore || attempts >= 15) return
+      attempts += 1
+      const service = probeSettingsDoc(ctx)
+      if (service) {
+        restore = patchSettingsDoc(service, async () => {
+          const result = await rpc('vscode.settingsDocumentPath', {})
+          return result.ok ? { ok: true, path: result.path } : { ok: false, error: result.error }
+        }, openEditorView, (message) => log.warn(message))
+        if (restore) return
+      }
+      if (attempts < 15) schedule(install, 2000)
+    }
+    install()
+    return () => {
+      disposed = true
+      restore?.()
+    }
+  }, 'vscode-mode: settings document editor route')
 
   // 指令系统（命令栏 + 指令注册表）先装配：命令栏在被任何 React slot 渲染前即可唤起
-  setupCommands(ctx)
+  const commands = setupCommands(ctx)
 
   const registry: FileOpenerRegistry = createFileOpenerRegistry()
   const workspaces = ctx.get('workspaces')
@@ -245,6 +275,17 @@ export function apply(ctx: any): void {
       claimDisposer = null
     }
   }
+  const legacyDefaults = defaultKeybindings()
+  let officialReady = false
+  /**
+   * 获取旧版快捷键覆盖；设置桥尚未就绪时回退默认键位。
+   * @author ddj 2026年09月28号
+   * @returns 旧版键位弦表
+   */
+  const legacyChords = (): Record<string, string> => ({
+    ...legacyDefaults, ...normalizeKeybindings(bridge.scope()?.getSnapshot().value?.keybindings),
+  })
+  applyOfficialChords(legacyChords())
   // 设置同步（fileOpenTool / 快捷键 / 侧宽 / 页签上限）：桥可能晚于本插件 apply 就绪
   // （设置桥服务不进 inject），首次命中即挂两条 effect；晚到经 bridge.whenReady 重挂一次
   // （settingsBridge 15×2s 有界重试内命中才会触发，用尽后保持旧行为不轮询）。
@@ -265,14 +306,14 @@ export function apply(ctx: any): void {
       sync()
       return scope.subscribe(sync)
     }, 'vscode-mode: file opener setting sync')
-    // 快捷键配置同步：设置提交后立即刷新键位匹配（编辑器/QuickOpen 按事件时读取）
-    // 同一订阅里顺带同步侧边栏最小宽度（sidebarMinWidth）→ 派发 edrv:sidebar-min-width 通知编辑器重夹
-    // 以及页签上限（maxOpenEditors）→ 派发 edrv:max-open-editors 通知编辑器复算淘汰
+    // 界面偏好同步：侧边栏最小宽度（sidebarMinWidth）→ 派发 edrv:sidebar-min-width 通知编辑器重夹
+    // 页签上限（maxOpenEditors）→ 派发 edrv:max-open-editors 通知编辑器复算淘汰
+    // （快捷键配置已归官方 shortcuts 机制，目录弦表同步见 'vscode-mode: official shortcuts' effect）
     ctx.effect(() => {
       const sync = (): void => {
         const snapshot = scope.getSnapshot()
         if (snapshot.status === 'loading') return
-        keybindingsApply(snapshot.value?.keybindings)
+        if (!officialReady) applyOfficialChords(legacyChords())
         const minW = sidebarMinApply(snapshot.value?.sidebarMinWidth)
         window.dispatchEvent(new CustomEvent('edrv:sidebar-min-width', { detail: { value: minW } }))
         const limit = editorLimitApply(snapshot.value?.maxOpenEditors)
@@ -286,6 +327,58 @@ export function apply(ctx: any): void {
   }
   mountSettingsSyncs()
   if (!settingsSyncMounted) ctx.effect(() => bridge.whenReady(mountSettingsSyncs), 'vscode-mode: settings bridge wait')
+
+  // 官方 shortcuts 机制装配（可选服务，有界重试；服务缺失仅降级告警，不阻断装配）：
+  // ① 全部指令注册进官方目录（含无默认键位命令，官方 UI 可自定义绑定；冲突默认自动降级未绑定）；
+  // ② 订阅官方目录 → 弦表同步（chordOf/bindingsOf 数据源，tooltip/命令栏提示跟随）；
+  // ③ 旧 keybindings 设置一次性迁移进官方存储（幂等，与设置桥双就绪后有界重试）。
+  ctx.effect(() => {
+    let cancelled = false
+    let disposeRegistration: (() => void) | null = null
+    let disposeCatalog: (() => void) | null = null
+    const disposeLegacy = installLegacyKeys(commands.registry.list(), commands.registry, legacyChords)
+    const cancelProbe = awaitShortcutsService(ctx, {
+      schedule,
+      onReady: (service) => {
+        if (cancelled) return
+        if (service === null) {
+          log.warn('官方 shortcuts 服务不可用（DSH 版本过旧？），继续使用旧版快捷键派发')
+          return
+        }
+        disposeLegacy()
+        officialReady = true
+        disposeRegistration = registerOfficialShortcuts(service, commands.registry.list(), commands.registry, SHORTCUT_PROFILES)
+        disposeCatalog = bindCatalogChords(service, applyOfficialChords)
+        let attempts = 0
+        const attemptMigration = (): void => {
+          if (cancelled) return
+          const scope = bridge.scope()
+          if (!scope) {
+            if (attempts < 15) {
+              attempts += 1
+              schedule(attemptMigration, 2000)
+            }
+            return
+          }
+          void migrateLegacyKeybindings(service, scope).then((result) => {
+            if (cancelled || result.done) return
+            if (attempts < 15) {
+              attempts += 1
+              schedule(attemptMigration, 2000)
+            }
+          })
+        }
+        attemptMigration()
+      },
+    })
+    return () => {
+      cancelled = true
+      cancelProbe()
+      disposeLegacy()
+      disposeRegistration?.()
+      disposeCatalog?.()
+    }
+  }, 'vscode-mode: official shortcuts')
   if (workspaces?.openPath) {
     ctx.effect(() => installOpenPathRouter({
       workspaces,
@@ -478,6 +571,15 @@ export function apply(ctx: any): void {
     label: 'VSCodeMode',
   }, () => React.createElement(SettingsContext.Provider, { value: bridge.scope() }, React.createElement(McpSettings, { openerRegistry: registry, compatSummary })))
 
+  // 独立「快捷键」设置区（与 VSCodeMode 平级）：官方快捷键子页 + 插件快捷键子页。
+  // 服务经 getShortcuts 运行时探测（自愈），组件内部自带就绪重试。
+  registerSlotSafely(ctx, {
+    name: 'settings.section',
+    id: 'vscode-mode-shortcuts',
+    order: 31,
+    label: '快捷键',
+  }, () => React.createElement(ShortcutSettings, { getShortcuts: () => detectShortcuts(ctx) }))
+
   // 卸载收尾（G4，DSH 0.1.6-alpha.2 起支持运行时卸载/重载）：
   // 注销挂在存活的 window.monaco 上的全部 Monaco provider 并复位模块状态。
   // 不做会导致重载后重复注册（补全/跳转/hover 各翻倍）与陈旧开关残留。

package/src/client/keybindings.ts

@@ -1,16 +1,14 @@
 /**
- * dsh-vscode-mode client — 快捷键配置模块（解析/匹配/状态同步）。
+ * dsh-vscode-mode client — 快捷键配置模块（解析/匹配/官方目录同步）。
  * 纯逻辑（parseChord/parseChords/formatChord/matchEvent/chordFromEvent/normalizeKey）不依赖 DOM，可单测；
- * 模块状态由 settings 订阅驱动（client/index.ts 调 keybindingsApply）。
- * 键位语义：Ctrl 与 Cmd 互认（延续 Ctrl+P/Ctrl+B 捕获行为）。
- * 命令目录（COMMANDS）派生自指令目录 commandCatalog（指令 = 单一数据源，设置页自动跟随）；
- * 另支持运行时键位表（第三方命令 register 时声明，不落设置 schema，注销即失效）。
- * 作者 ddj 2026年08月26号 / 2026年09月10号
+ * 弦表（current）由官方 shortcuts 目录驱动：client/index.ts 经 shortcutsOfficial.bindCatalogChords
+ * 订阅官方 catalog 后调 applyOfficialChords（键位持久化/冲突校验/派发全部归官方机制，本模块不再自派发）。
+ * 键位语义：Ctrl 与 Cmd 互认（延续历史捕获行为）。
+ * 命令目录（COMMANDS）派生自指令目录 commandCatalog（指令 = 单一数据源）。
+ * 作者 ddj 2026年08月26号 / 2026年09月10号 / 2026年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'
+import { BRIDGE_COMMANDS, EDITOR_COMMANDS } from './ui/commandCatalog.js'
 
 /** 解析后的键位（修饰符 + 规范化主键）。 */
 export interface Binding {
@@ -21,52 +19,29 @@ export interface Binding {
   key: string
 }
 
-/** 命令目录（设置页展示标签；执行按目录序先匹配先执行，冲突键位确定性）。 */
+/** 命令目录（设置页展示标签；命令栏候选与键位提示共用）。 */
 export const COMMANDS: Array<{ id: string; label: string }> = [
   ...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 }
-const runtime = new Map<string, Binding[]>()
+/** 弦表（官方 catalog 派生：id → 显示键位弦）。官方目录就绪前为空（tooltip 走各自的兜底文案）。 */
+let current: Record<string, string> = {}
 const listeners = new Set<() => void>()
 
-checkDefaultsDrift()
-
 /**
- * 应用设置快照（与默认值合并；未知 id 丢弃；空对象 = 全部默认）。
- * 每个命令可含多候选键位（`|` 分隔），任一命中即触发。
- * @author ddj 2026年08月26号
- * @param raw 设置 scope 的 keybindings 字段
+ * 应用官方目录弦表（id → 显示键位弦；由 shortcutsOfficial.bindCatalogChords 全量推送）。
+ * @author ddj 2026年10月
+ * @param chords 弦表（官方 catalog 派生，含用户覆盖；issue 行不收录）
  */
-export function keybindingsApply(raw: unknown): void {
-  current = { ...KEYBINDING_DEFAULTS, ...normalizeKeybindings(raw) }
-  for (const listener of listeners) {
-    try { listener() } catch { /* 监听器异常不影响其他订阅 */ }
-  }
+export function applyOfficialChords(chords: Readonly<Record<string, string>>): void {
+  current = { ...chords }
+  notifyKeybindings()
 }
 
 /**
@@ -80,29 +55,6 @@ export function subscribeKeybindings(listener: () => void): () => void {
   return () => listeners.delete(listener)
 }
 
-/**
- * 注册运行时键位（第三方命令；优先于设置值，注销即失效）。
- * @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) {
@@ -111,29 +63,23 @@ function notifyKeybindings(): void {
 }
 
 /**
- * 当前命令的键位弦（运行时键位优先；未绑定/空 → null）。
- * @author ddj 2026年08月26号 / 2026年09月10号
+ * 当前命令的键位弦（官方目录派生；未绑定/空 → null）。
+ * @author ddj 2026年08月26号 / 2026年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号 / 2026年09月10号
+ * @author ddj 2026年08月26号 / 2026年10月
  * @param id 命令 id
  * @returns 解析键位数组（可能为空）
  */
 export function bindingsOf(id: string): Binding[] {
-  const override = runtime.get(id)
-  if (override) return override
   const chord = current[id]
   return typeof chord === 'string' ? parseChords(chord) : []
 }

package/src/client/luaReservedWords.ts

@@ -0,0 +1,10 @@
+/**
+ * Lua 5.3 保留字，供编辑器补全与调试悬停共同使用。
+ * 作者 ddj 2026年09月24号
+ */
+export const LUA_RESERVED_WORDS = [
+  'and', 'break', 'do', 'else', 'elseif', 'end', 'false', 'for', 'function', 'goto',
+  'if', 'in', 'local', 'nil', 'not', 'or', 'repeat', 'return', 'then', 'true', 'until', 'while',
+] as const
+
+export const LUA_RESERVED_WORD_SET: ReadonlySet<string> = new Set(LUA_RESERVED_WORDS)

package/src/client/monaco/lsp/keywords.ts

@@ -0,0 +1,121 @@
+/**
+ * 为 Lua 的 LSP 补全补充服务器缺失的保留字与注解基础类型候选。
+ * 作者 ddj 2026年09月24号
+ */
+import { LUA_RESERVED_WORDS } from '../../luaReservedWords.js'
+
+const LUA_BASE_TYPES = [
+  'any', 'boolean', 'integer', 'nil', 'number', 'string', 'table', 'thread', 'userdata',
+] as const
+const TYPE_START = /^\s*---@(?:(?:type|return)\s+|param\s+\S+\s+|field\s+(?:(?:public|private|protected|package)\s+)?\S+\s+)(.*)$/
+
+interface KeywordRange {
+  startLineNumber: number
+  endLineNumber: number
+  startColumn: number
+  endColumn: number
+}
+
+interface KeywordItem {
+  label: string
+  kind: number
+  insertText: string
+  range: KeywordRange
+  detail: string
+}
+
+/**
+ * 构造轻量本地候选，保留服务器同名项的优先权交给 mergeKeywords。
+ * @author ddj 2026年09月24号
+ * @param words 候选文本
+ * @param kind Monaco 候选类型
+ * @param range 当前单词范围
+ * @param detail 候选说明
+ * @returns 可直接交给 Monaco 的候选
+ */
+function keywordItems(words: readonly string[], kind: number, range: KeywordRange, detail: string): KeywordItem[] {
+  return words.map((label) => ({ label, kind, insertText: label, range, detail }))
+}
+
+/**
+ * 判断光标是否在 EmmyLua 注解的类型槽；普通注释和描述文字均不匹配。
+ * @author ddj 2026年09月24号
+ * @param model 当前文档
+ * @param position 光标所在行
+ * @param range 当前词范围
+ * @returns 是否应提示基础类型
+ */
+export function isLuaTypeSlot(
+  model: { getLineContent(lineNumber: number): string },
+  position: { lineNumber: number },
+  range: Pick<KeywordRange, 'startColumn'>,
+): boolean {
+  const beforeWord = model.getLineContent(position.lineNumber).slice(0, range.startColumn - 1)
+  const match = TYPE_START.exec(beforeWord)
+  if (!match) return false
+  const context = match[1] ?? ''
+  const typePrefix = context.trimEnd()
+  if (/[.:]$/.test(typePrefix)) return false
+  return !(/\s$/.test(context) && typePrefix && !/[|&,<]$/.test(typePrefix))
+}
+
+/**
+ * 在普通代码位置生成关键字；成员名和类型注解位置只交给对应候选。
+ * @author ddj 2026年09月24号
+ * @param monaco Monaco 语言枚举
+ * @param model 当前文档
+ * @param position 光标所在行
+ * @param range 当前单词的替换范围
+ * @returns 当前上下文可用的 Lua 关键字候选
+ */
+export function luaKeywordsAt(
+  monaco: { languages: { CompletionItemKind: { Keyword: number } } },
+  model: { getLineContent(lineNumber: number): string },
+  position: { lineNumber: number },
+  range: KeywordRange,
+): KeywordItem[] {
+  const line = model.getLineContent(position.lineNumber)
+  const beforeWord = line.charAt(range.startColumn - 2)
+  if (beforeWord === '.' || beforeWord === ':' || /^\s*---@/.test(line)) return []
+  return keywordItems(LUA_RESERVED_WORDS, monaco.languages.CompletionItemKind.Keyword, range, 'Lua 关键字')
+}
+
+/**
+ * 仅在注解类型槽补最基本类型，项目类型和服务器自带类型仍由 LSP 提供。
+ * @author ddj 2026年09月24号
+ * @param monaco Monaco 语言枚举
+ * @param model 当前文档
+ * @param position 光标所在行
+ * @param range 当前单词的替换范围
+ * @returns 类型候选；非注解返回空数组
+ */
+export function luaTypesAt(
+  monaco: { languages: { CompletionItemKind: { Keyword: number } } },
+  model: { getLineContent(lineNumber: number): string },
+  position: { lineNumber: number },
+  range: KeywordRange,
+): KeywordItem[] {
+  if (!isLuaTypeSlot(model, position, range)) return []
+  return keywordItems(LUA_BASE_TYPES, monaco.languages.CompletionItemKind.Keyword, range, 'Lua 基础类型')
+}
+
+/**
+ * 合并 LSP 与本地关键字，服务器同名项优先并保持原顺序。
+ * @author ddj 2026年09月24号
+ * @param server 服务器候选
+ * @param keywords 本地关键字候选
+ * @returns 去重后的补全列表
+ */
+export function mergeKeywords<T extends { label: string }, U extends { label: string }>(
+  server: T[],
+  keywords: U[],
+): Array<T | U> {
+  if (keywords.length === 0) return server
+  const labels = new Set(server.map((item) => item.label))
+  const merged: Array<T | U> = [...server]
+  for (const keyword of keywords) {
+    if (labels.has(keyword.label)) continue
+    merged.push(keyword)
+  }
+  return merged
+}