dsh-vscode-mode 0.11.0 → 0.12.0

package/src/rules.ts

@@ -1,6 +1,6 @@
 /**
  * dsh-vscode-mode host — 规则管理（Codebuddy/Cursor 式 .mdc 规则）。
- * - 存储：用户规则 ~/.dsh/rules/*.mdc；项目规则 <工作区>/.dsh/rules/*.mdc（随仓库共享）。
+ * - 存储：用户规则 DSH_HOME/rules + ~/.dsh/rules（当前目录优先）；项目规则 <工作区>/.dsh/rules。
  * - 格式：frontmatter（description / alwaysApply / globs / enabled）+ markdown 正文；
  *   类型映射 总是=always / 自动=auto(globs) / 手动=manual(仅索引)；enabled 为本插件扩展字段，缺省 true。
  * - 生效：host 注册 systemPrompt.section（order 400），每次装配同步读取（mtime 缓存），
@@ -11,9 +11,10 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync } from 'node:fs'
 import { mkdir, readFile, readdir, rm, stat, writeFile } from 'node:fs/promises'
 import { Buffer } from 'node:buffer'
-import { join } from 'node:path'
+import { homedir } from 'node:os'
+import { join, resolve } from 'node:path'
 import { dshHome } from './paths.js'
-import type { RuleInfo, RuleProject, RuleRefInput, RuleScope, RuleSaveInput } from './shared/rules.js'
+import type { RuleInfo, RuleProject, RuleRefInput, RuleScope, RuleSaveInput, UserRuleOrigin } from './shared/rules.js'
 import type { Ctx } from './store.js'
 
 // --region 常量与目录定位
@@ -33,7 +34,7 @@ const SECTION_NAME = 'dsh-vscode-mode:rules'
 const SECTION_ORDER = 400
 
 /**
- * 用户规则目录（~/.dsh/rules）。
+ * 当前用户规则目录（DSH_HOME/rules）。
  * @author ddj 2026年09月03号
  * @param home DSH home（缺省自动解析）
  * @returns 绝对路径
@@ -42,6 +43,32 @@ export function userRulesDir(home = dshHome()): string {
   return join(home, 'rules')
 }
 
+export interface UserRulesDirs {
+  current: string
+  legacy?: string
+}
+
+/** DSH_HOME 改变时仍读取系统用户目录的旧规则；相同路径不重复加载。 */
+export function userRuleDirs(activeHome = dshHome(), systemHome = homedir()): UserRulesDirs {
+  const current = resolve(userRulesDir(activeHome))
+  const legacy = resolve(userRulesDir(join(systemHome, '.dsh')))
+  const key = (path: string) => process.platform === 'win32' ? path.toLowerCase() : path
+  return key(current) === key(legacy) ? { current } : { current, legacy }
+}
+
+function userDirOf(origin: UserRuleOrigin | undefined, dirs: UserRulesDirs): string {
+  if (origin === undefined || origin === 'current') return dirs.current
+  if (origin === 'legacy' && dirs.legacy) return dirs.legacy
+  throw new Error('无效的用户规则来源')
+}
+
+/** 同名时当前目录优先；禁用的当前规则也应遮蔽旧目录规则。 */
+function mergeUserRules<T>(current: T[], legacy: T[], fileOf: (rule: T) => string): T[] {
+  const key = (rule: T) => process.platform === 'win32' ? fileOf(rule).toLowerCase() : fileOf(rule)
+  const seen = new Set(current.map(key))
+  return [...current, ...legacy.filter((rule) => !seen.has(key(rule)))].sort((a, b) => fileOf(a).localeCompare(fileOf(b)))
+}
+
 /**
  * 项目规则目录（<工作区>/.dsh/rules）。
  * @author ddj 2026年09月03号
@@ -261,20 +288,33 @@ export function renderRulesSection(user: LoadedRule[], project: LoadedRule[], wo
 
 // --region IO（列表 / 读 / 存 / 删 / 开关）
 /** 单目录规则元信息列表（仅 *.mdc，最多 RULE_DIR_CAP 个；目录缺失返回空）。 */
-async function listRulesDir(dir: string, scope: RuleScope): Promise<RuleInfo[]> {
-  const names = await readdir(dir).catch(() => [] as string[])
+async function listRulesDir(dir: string, scope: RuleScope, origin?: UserRuleOrigin): Promise<RuleInfo[]> {
+  const names = await readdir(dir).catch((error: NodeJS.ErrnoException) => {
+    if (error.code === 'ENOENT') return [] as string[]
+    throw error
+  })
   const mdcs = names.filter((name) => name.endsWith('.mdc')).sort().slice(0, RULE_DIR_CAP)
   const out: RuleInfo[] = []
   for (const file of mdcs) {
     const absPath = join(dir, file)
-    const info = await stat(absPath).catch(() => null)
+    const info = await stat(absPath).catch((error: NodeJS.ErrnoException) => {
+      if (error.code === 'ENOENT') return null
+      throw error
+    })
     if (!info || !info.isFile()) continue
-    const parsed = parseRuleMdc(await readFile(absPath, 'utf8').catch(() => ''))
-    out.push(toRuleInfo(scope, file, absPath, parsed, info.size, info.mtimeMs))
+    const parsed = parseRuleMdc(await readFile(absPath, 'utf8'))
+    out.push(toRuleInfo(scope, file, absPath, parsed, info.size, info.mtimeMs, origin))
   }
   return out
 }
 
+/** 列表与注入共用当前目录优先的合并约定。 */
+export async function listUserRules(dirs = userRuleDirs()): Promise<RuleInfo[]> {
+  const current = await listRulesDir(dirs.current, 'user', 'current')
+  const legacy = dirs.legacy ? await listRulesDir(dirs.legacy, 'user', 'legacy') : []
+  return mergeUserRules(current, legacy, (rule) => rule.file)
+}
+
 /** 已注册 workspace 列表（项目 Tab 与写入校验共用）。 */
 function workspaceList(ctx: Ctx): Array<{ path: string; title?: string }> {
   const list = ctx.get('workspaceRegistry')?.list?.() ?? []
@@ -297,10 +337,16 @@ function requireWorkspace(ctx: Ctx, workspacePath: string | undefined): { path:
   return workspace as { path: string; title?: string }
 }
 
-/** 按作用域解析规则目录（project 先过 requireWorkspace）。 */
-function dirOf(ctx: Ctx, scope: RuleScope, workspacePath?: string): string {
-  if (scope === 'project') return projectRulesDir(requireWorkspace(ctx, workspacePath).path)
-  return userRulesDir()
+/** 按作用域解析规则目录；客户端路径和未识别的来源均不作为目标使用。 */
+function dirOf(ctx: Ctx, ref: RuleRefInput, dirs: UserRulesDirs): string {
+  const invalid = validateRuleFile(ref.file)
+  if (invalid) throw new Error(invalid)
+  if (ref.scope === 'project') {
+    if (ref.origin !== undefined) throw new Error('项目规则不能指定用户规则来源')
+    return projectRulesDir(requireWorkspace(ctx, ref.workspacePath).path)
+  }
+  if (ref.scope !== 'user') throw new Error('无效的规则作用域')
+  return userDirOf(ref.origin, dirs)
 }
 
 /**
@@ -309,8 +355,8 @@ function dirOf(ctx: Ctx, scope: RuleScope, workspacePath?: string): string {
  * @param ctx DSH 上下文
  * @returns rules.list 载荷
  */
-export async function rulesList(ctx: Ctx): Promise<{ user: RuleInfo[]; projects: RuleProject[] }> {
-  const user = await listRulesDir(userRulesDir(), 'user')
+export async function rulesList(ctx: Ctx, dirs = userRuleDirs()): Promise<{ user: RuleInfo[]; projects: RuleProject[] }> {
+  const user = await listUserRules(dirs)
   const projects: RuleProject[] = []
   for (const workspace of workspaceList(ctx)) {
     const dir = projectRulesDir(workspace.path)
@@ -328,8 +374,8 @@ export async function rulesList(ctx: Ctx): Promise<{ user: RuleInfo[]; projects:
  * @param ref 作用域 + 文件名（+ 项目工作区）
  * @returns 文件全文
  */
-export async function rulesRead(ctx: Ctx, ref: RuleRefInput): Promise<string> {
-  const dir = dirOf(ctx, ref.scope, ref.workspacePath)
+export async function rulesRead(ctx: Ctx, ref: RuleRefInput, dirs = userRuleDirs()): Promise<string> {
+  const dir = dirOf(ctx, ref, dirs)
   return readFile(join(dir, ref.file), 'utf8')
 }
 
@@ -344,10 +390,10 @@ export async function rulesRead(ctx: Ctx, ref: RuleRefInput): Promise<string> {
  * @param mtime 修改时间毫秒
  * @returns 规则元信息
  */
-function toRuleInfo(scope: RuleScope, file: string, absPath: string, parsed: ParsedRule, size: number, mtime: number): RuleInfo {
+function toRuleInfo(scope: RuleScope, file: string, absPath: string, parsed: ParsedRule, size: number, mtime: number, origin?: UserRuleOrigin): RuleInfo {
   return {
-    scope, file, absPath,
-    relHint: scope === 'project' ? '.dsh/rules/' : 'rules/',
+    scope, file, absPath, ...(scope === 'user' ? { origin: origin ?? 'current' } : {}),
+    relHint: scope === 'project' ? '.dsh/rules/' : origin === 'legacy' ? '~/.dsh/rules/' : 'rules/',
     description: parsed.description, type: ruleTypeOf(parsed), globs: parsed.globs, enabled: parsed.enabled,
     size, mtime, error: parsed.error,
   }
@@ -360,10 +406,8 @@ function toRuleInfo(scope: RuleScope, file: string, absPath: string, parsed: Par
  * @param input 保存入参
  * @returns 保存后的规则元信息
  */
-export async function rulesSave(ctx: Ctx, input: RuleSaveInput): Promise<RuleInfo> {
-  const invalid = validateRuleFile(input.file)
-  if (invalid) throw new Error(invalid)
-  const dir = dirOf(ctx, input.scope, input.workspacePath)
+export async function rulesSave(ctx: Ctx, input: RuleSaveInput, dirs = userRuleDirs()): Promise<RuleInfo> {
+  const dir = dirOf(ctx, input, dirs)
   await mkdir(dir, { recursive: true })
   const absPath = join(dir, input.file)
   const content = String(input.content ?? '')
@@ -376,7 +420,7 @@ export async function rulesSave(ctx: Ctx, input: RuleSaveInput): Promise<RuleInf
     await writeFile(absPath, content, 'utf8')
   }
   const info = await stat(absPath).catch(() => null)
-  return toRuleInfo(input.scope, input.file, absPath, parseRuleMdc(content), info?.size ?? Buffer.byteLength(content), info?.mtimeMs ?? Date.now())
+  return toRuleInfo(input.scope, input.file, absPath, parseRuleMdc(content), info?.size ?? Buffer.byteLength(content), info?.mtimeMs ?? Date.now(), input.origin)
 }
 
 /**
@@ -384,8 +428,8 @@ export async function rulesSave(ctx: Ctx, input: RuleSaveInput): Promise<RuleInf
  * @author ddj 2026年09月03号
  * @param ref 作用域 + 文件名（+ 项目工作区）
  */
-export async function rulesRemove(ctx: Ctx, ref: RuleRefInput): Promise<void> {
-  const dir = dirOf(ctx, ref.scope, ref.workspacePath)
+export async function rulesRemove(ctx: Ctx, ref: RuleRefInput, dirs = userRuleDirs()): Promise<void> {
+  const dir = dirOf(ctx, ref, dirs)
   await rm(join(dir, ref.file), { force: true })
 }
 
@@ -396,8 +440,8 @@ export async function rulesRemove(ctx: Ctx, ref: RuleRefInput): Promise<void> {
  * @param enabled 目标状态
  * @returns 更新后的规则元信息
  */
-export async function rulesToggle(ctx: Ctx, ref: RuleRefInput, enabled: boolean): Promise<RuleInfo> {
-  const dir = dirOf(ctx, ref.scope, ref.workspacePath)
+export async function rulesToggle(ctx: Ctx, ref: RuleRefInput, enabled: boolean, dirs = userRuleDirs()): Promise<RuleInfo> {
+  const dir = dirOf(ctx, ref, dirs)
   const absPath = join(dir, ref.file)
   const text = await readRuleText(ctx, ref, absPath)
   if (text === null) throw new Error('规则文件不存在：' + ref.file)
@@ -409,7 +453,10 @@ export async function rulesToggle(ctx: Ctx, ref: RuleRefInput, enabled: boolean)
 
 /** 按作用域读规则全文：project 与写盘同通道走 ctx fs，user 走 node fs；缺失返回 null。 */
 async function readRuleText(ctx: Ctx, ref: RuleRefInput, absPath: string): Promise<string | null> {
-  if (ref.scope !== 'project') return readFile(absPath, 'utf8').catch(() => null)
+  if (ref.scope !== 'project') return readFile(absPath, 'utf8').catch((error: NodeJS.ErrnoException) => {
+    if (error.code === 'ENOENT') return null
+    throw error
+  })
   const fs = ctx.get('fs')
   if (!fs) throw new Error('缺少 fs 服务')
   const target = await fs.resolve('.dsh/rules/' + ref.file, { cwd: requireWorkspace(ctx, ref.workspacePath).path })
@@ -435,7 +482,7 @@ async function rulesSaveContent(ctx: Ctx, ref: RuleRefInput, absPath: string, co
 /** 重建单条规则元信息（toggle 后回传 UI；stat 失败时用内容长度 + 当前时间兜底）。 */
 async function ruleInfoOf(ref: RuleRefInput, absPath: string, content: string): Promise<RuleInfo> {
   const info = await stat(absPath).catch(() => null)
-  return toRuleInfo(ref.scope, ref.file, absPath, parseRuleMdc(content), info?.size ?? Buffer.byteLength(content), info?.mtimeMs ?? Date.now())
+  return toRuleInfo(ref.scope, ref.file, absPath, parseRuleMdc(content), info?.size ?? Buffer.byteLength(content), info?.mtimeMs ?? Date.now(), ref.origin)
 }
 // --endregion
 
@@ -449,20 +496,20 @@ interface InjCacheEntry {
 const injCache = new Map<string, InjCacheEntry>()
 
 /**
- * 同步读取一个规则目录（装配 provider 内专用）：仅 *.mdc，mtime 缓存，异常静默为空。
+ * 同步读取一个规则目录（装配 provider 内专用）：仅 *.mdc，mtime 缓存；缺失视为空。
  * @author ddj 2026年09月03号
  * @param dir 规则目录
  * @param scope 作用域
- * @param relHint 相对提示
+ * @param origin 用户规则来源
  * @returns 已加载规则列表
  */
-function readRulesSync(dir: string, scope: RuleScope): LoadedRule[] {
-  if (!existsSync(dir)) return []
+function readRulesSync(dir: string, scope: RuleScope, origin?: UserRuleOrigin): LoadedRule[] {
   let names: string[]
   try {
     names = readdirSync(dir)
-  } catch {
-    return []
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return []
+    throw error
   }
   const out: LoadedRule[] = []
   for (const file of names.filter((name) => name.endsWith('.mdc')).sort().slice(0, RULE_DIR_CAP)) {
@@ -470,8 +517,9 @@ function readRulesSync(dir: string, scope: RuleScope): LoadedRule[] {
     let info: { mtimeMs: number; size: number; isFile(): boolean }
     try {
       info = statSync(absPath)
-    } catch {
-      continue
+    } catch (error) {
+      if ((error as NodeJS.ErrnoException).code === 'ENOENT') continue
+      throw error
     }
     if (!info.isFile()) continue
     const cached = injCache.get(absPath)
@@ -481,19 +529,27 @@ function readRulesSync(dir: string, scope: RuleScope): LoadedRule[] {
     } else {
       try {
         parsed = parseRuleMdc(readFileSync(absPath, 'utf8'))
-      } catch {
-        continue
+      } catch (error) {
+        if ((error as NodeJS.ErrnoException).code === 'ENOENT') continue
+        throw error
       }
       injCache.set(absPath, { mtimeMs: info.mtimeMs, size: info.size, parsed })
     }
     out.push({
-      info: toRuleInfo(scope, file, absPath, parsed, info.size, info.mtimeMs),
+      info: toRuleInfo(scope, file, absPath, parsed, info.size, info.mtimeMs, origin),
       body: parsed.body,
     })
   }
   return out
 }
 
+/** 同步装配与列表同名遮蔽策略一致。 */
+export function readUserRulesSync(dirs = userRuleDirs()): LoadedRule[] {
+  const current = readRulesSync(dirs.current, 'user', 'current')
+  const legacy = dirs.legacy ? readRulesSync(dirs.legacy, 'user', 'legacy') : []
+  return mergeUserRules(current, legacy, (rule) => rule.info.file)
+}
+
 /** 从装配上下文解析会话工作区 cwd（agent.id → sessions → header.cwd；缺链返回 null）。 */
 function cwdFromAssemble(ctx: Ctx, asm: { agent?: { id?: unknown } } | undefined): string | null {
   const id = asm?.agent?.id
@@ -509,12 +565,12 @@ function cwdFromAssemble(ctx: Ctx, asm: { agent?: { id?: unknown } } | undefined
  * @param ctx DSH host 上下文
  * @returns 是否成功注册
  */
-export function installRulesSection(ctx: Ctx): boolean {
+export function installRulesSection(ctx: Ctx, dirs = userRuleDirs()): boolean {
   const sp = ctx.get('systemPrompt')
   if (!sp || typeof sp.section !== 'function') return false
   const provider = (asm: { agent?: { id?: unknown } }): string => {
     try {
-      const user = readRulesSync(userRulesDir(), 'user')
+      const user = readUserRulesSync(dirs)
       const cwd = cwdFromAssemble(ctx, asm)
       const project = cwd ? readRulesSync(projectRulesDir(cwd), 'project') : []
       return renderRulesSection(user, project, cwd ?? undefined)

package/src/shared/keybindings.ts

@@ -5,6 +5,8 @@
  * `|` 连接多个候选（任一命中即触发），如 `Alt+ArrowLeft|Ctrl+Alt+-`。
  * 约束：本模块被 host 与 client 两半共用，**禁止 import client 侧模块**（React/浏览器 API）。
  * 与 client/ui/commandCatalog 的一致性由 tests/commands.test.ts 断言兜底。
+ * 官方机制（2026-10）：SHORTCUT_PROFILES 描述各命令在官方 ctx.shortcuts 的 profile 默认键位
+ * （由 client 注册官方服务时使用）；chordToBinding/bindingToChord 负责插件弦与官方绑定互转。
  * 作者 ddj 2026年08月26号 / 2026年09月10号
  */
 
@@ -66,3 +68,254 @@ export function normalizeKeybindings(raw: unknown): Record<string, string> {
   }
   return out
 }
+
+//#region 官方 shortcuts 机制映射层（纯数据/纯函数，禁 import client 侧与官方包）
+
+/** 官方 shortcuts 服务的修饰符标记（'primary' = 桌面端按平台展开为 Ctrl/Cmd，web 同语义）。 */
+export type OfficialModifier = 'primary' | 'control' | 'alt' | 'shift' | 'meta'
+
+/** 官方绑定形状（物理 code + 修饰符；与 @deepseek-ai/dsh-client-shortcuts 绑定契约同构，鸭子类型）。 */
+export interface OfficialBinding {
+  code: string
+  modifiers: OfficialModifier[]
+  secondCode?: string
+}
+
+/** 官方 profile 键（desktop|web × macos|windows|linux）。 */
+export type ShortcutProfileKey =
+  | 'desktop:macos' | 'desktop:windows' | 'desktop:linux'
+  | 'web:macos' | 'web:windows' | 'web:linux'
+
+/** 命令 id → 各 profile 官方默认键位（缺 profile = 该端不绑定）。 */
+export type ShortcutProfiles = Partial<Record<ShortcutProfileKey, OfficialBinding>>
+
+/** 显示主键 → 官方物理 code 对照（官方 code 白名单：Key[A-Z]|Digit[0-9]|F1-24|具名键）。 */
+const DISPLAY_KEY_TO_CODE: Record<string, string> = {
+  '-': 'Minus', '=': 'Equal', '[': 'BracketLeft', ']': 'BracketRight',
+  ';': 'Semicolon', "'": 'Quote', ',': 'Comma', '.': 'Period',
+  '/': 'Slash', '\\': 'Backslash', '`': 'Backquote',
+  Enter: 'Enter', Tab: 'Tab', Backspace: 'Backspace', Delete: 'Delete',
+  Escape: 'Escape', Space: 'Space',
+  ArrowUp: 'ArrowUp', ArrowDown: 'ArrowDown', ArrowLeft: 'ArrowLeft', ArrowRight: 'ArrowRight',
+}
+
+/** 官方具名 code（非 Key/Digit/F 前缀且可回显的部分）。 */
+const NAMED_CODES = ['Enter', 'Tab', 'Backspace', 'Delete', 'Escape', 'Space',
+  'ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight'] as const
+
+/** 官方 code → 显示主键（符号键反向对照）。 */
+const CODE_TO_DISPLAY_KEY: Record<string, string> = {
+  Minus: '-', Equal: '=', BracketLeft: '[', BracketRight: ']',
+  Semicolon: ';', Quote: "'", Comma: ',', Period: '.',
+  Slash: '/', Backslash: '\\', Backquote: '`',
+}
+
+/** 显示主键 → 官方 code（PageUp/PageDown/Home/End/Insert 等官方不支持 → null）。 */
+function keyToCode(key: string): string | null {
+  if (Object.hasOwn(DISPLAY_KEY_TO_CODE, key)) return DISPLAY_KEY_TO_CODE[key]
+  if (key.length === 1 && key >= 'a' && key <= 'z') return 'Key' + key.toUpperCase()
+  if (key.length === 1 && key >= 'A' && key <= 'Z') return 'Key' + key
+  if (key.length === 1 && key >= '0' && key <= '9') return 'Digit' + key
+  if (/^F([1-9]|1[0-9]|2[0-4])$/u.test(key)) return key
+  return null
+}
+
+/** 官方 code → 显示主键（不可回显 → null）。 */
+function codeToKey(code: string): string | null {
+  if (Object.hasOwn(CODE_TO_DISPLAY_KEY, code)) return CODE_TO_DISPLAY_KEY[code]
+  if (/^Key[A-Z]$/u.test(code)) return code.slice(3)
+  if (/^Digit[0-9]$/u.test(code)) return code.slice(5)
+  if (/^F([1-9]|1[0-9]|2[0-4])$/u.test(code)) return code
+  if ((NAMED_CODES as readonly string[]).includes(code)) return code
+  return null
+}
+
+/** 插件弦的修饰符 token → 官方修饰符（Ctrl 与 Cmd 同为 primary，与 matchEvent 的互认语义一致）。 */
+const CHORD_MODIFIER_TOKENS: Record<string, OfficialModifier> = {
+  ctrl: 'primary', control: 'primary', cmd: 'primary', meta: 'primary',
+  shift: 'shift', alt: 'alt',
+}
+
+/**
+ * 插件键位弦（单候选）→ 官方绑定。
+ * 不可表示的主键（PageUp/PageDown/Home/End/Insert 等）返回 null，调用方跳过。
+ * @author ddj 2026年10月
+ * @param chord 键位弦（如 `Ctrl+Alt+-` / `F9` / `Alt+ArrowLeft`）
+ * @returns 官方绑定或 null
+ */
+export function chordToBinding(chord: string): OfficialBinding | null {
+  const parts = String(chord ?? '').split('+').map((part) => part.trim()).filter(Boolean)
+  if (!parts.length) return null
+  const modifiers = new Set<OfficialModifier>()
+  let key = ''
+  for (const part of parts) {
+    const modifier = CHORD_MODIFIER_TOKENS[part.toLowerCase()]
+    if (modifier) {
+      modifiers.add(modifier)
+      continue
+    }
+    if (key) return null
+    key = part
+  }
+  if (!key) return null
+  if (key === ' ') key = 'Space'
+  else if (key.length === 1 && key >= 'a' && key <= 'z') key = key.toUpperCase()
+  const code = keyToCode(key)
+  return code === null ? null : { code, modifiers: [...modifiers] }
+}
+
+/**
+ * 官方绑定 → 插件显示键位弦（primary 显示为 Ctrl，与历史 tooltip 文案保持一致）。
+ * @author ddj 2026年10月
+ * @param binding 官方绑定
+ * @returns 插件弦（不可表示 → null）
+ */
+export function bindingToChord(binding: OfficialBinding): string | null {
+  if (!binding || typeof binding !== 'object') return null
+  const key = codeToKey(binding.code)
+  if (key === null) return null
+  let suffix = ''
+  if (binding.secondCode !== undefined) {
+    const secondKey = codeToKey(binding.secondCode)
+    if (secondKey === null) return null
+    suffix = '+' + secondKey
+  }
+  const parts: string[] = []
+  if (binding.modifiers.includes('primary')) parts.push('Ctrl')
+  if (binding.modifiers.includes('shift')) parts.push('Shift')
+  if (binding.modifiers.includes('alt')) parts.push('Alt')
+  return [...parts, key + suffix].join('+')
+}
+
+/** 官方绑定字面量构造（表格可读性辅助）。 */
+function bind(code: string, modifiers: OfficialModifier[]): OfficialBinding {
+  return { code, modifiers }
+}
+
+/**
+ * 命令 id → 官方 profile 默认键位（与 KEYBINDING_DEFAULTS 一一对应；client 注册官方服务的数据源）。
+ * 取值约束（对齐官方 bindingIssue/isWebBindingAllowed 校验，错报会在注册时抛错）：
+ * - desktop:macos/windows：官方不做保留校验，用 VS Code 同款 chord；
+ * - desktop:linux / web:linux：Arrow*、裸 F 键、全 Shift、Ctrl+V/C/X/Z/Y/Q/H/A、Meta 均为保留键 → 不声明；
+ * - web:macos/windows：单修饰符组合不在白名单 → 用 primary+alt / primary+shift 变体（官方 ui-layout 同款）；
+ * - Ctrl+PageDown/PageUp 候选废弃（官方 code 白名单无 PageUp/PageDown）；
+ * - edrv.toggleSidebar 留空：Ctrl+B 与官方 sidebar.left.toggle（Mod+B）冲突，注册会抛错且冲突键互相阻断。
+ * @author ddj 2026年10月
+ */
+export const SHORTCUT_PROFILES: Record<string, ShortcutProfiles> = {
+  'edrv.toggleSidebar': {},
+  'edrv.save': {
+    'desktop:macos': bind('KeyS', ['primary']),
+    'desktop:windows': bind('KeyS', ['primary']),
+    'desktop:linux': bind('KeyS', ['primary']),
+  },
+  // 官方 workspace.files 已占用桌面 primary+P 和 Web primary+alt+P；插件 QuickOpen 使用非冲突组合。
+  'edrv.quickOpen': {
+    'desktop:macos': bind('KeyP', ['primary', 'alt']),
+    'desktop:windows': bind('KeyP', ['primary', 'alt']),
+    'desktop:linux': bind('KeyP', ['primary', 'alt']),
+    'web:macos': bind('KeyP', ['primary', 'alt', 'shift']),
+    'web:windows': bind('KeyP', ['primary', 'alt', 'shift']),
+  },
+  'edrv.searchInFiles': {
+    'desktop:macos': bind('KeyF', ['primary', 'shift']),
+    'desktop:windows': bind('KeyF', ['primary', 'shift']),
+    'desktop:linux': bind('KeyF', ['primary', 'shift']),
+    'web:macos': bind('KeyF', ['primary', 'shift']),
+    'web:windows': bind('KeyF', ['primary', 'shift']),
+  },
+  // Ctrl+Shift+V（primary+KeyV）在 linux 为保留键（官方 bindingIssue 不豁免 shift），desktop:linux 不声明
+  'edrv.toggleMarkdownPreview': {
+    'desktop:macos': bind('KeyV', ['primary', 'shift']),
+    'desktop:windows': bind('KeyV', ['primary', 'shift']),
+    'web:macos': bind('KeyV', ['primary', 'shift']),
+    'web:windows': bind('KeyV', ['primary', 'shift']),
+  },
+  // 导航历史：主候选 Alt+Arrow 在 linux/web 为保留或白名单外；web 取第二候选（Ctrl+Alt+- / Ctrl+Shift+-）
+  'edrv.navigateBack': {
+    'desktop:macos': bind('ArrowLeft', ['alt']),
+    'desktop:windows': bind('ArrowLeft', ['alt']),
+    'web:macos': bind('Minus', ['primary', 'alt']),
+    'web:windows': bind('Minus', ['primary', 'alt']),
+  },
+  'edrv.navigateForward': {
+    'desktop:macos': bind('ArrowRight', ['alt']),
+    'desktop:windows': bind('ArrowRight', ['alt']),
+    'web:macos': bind('Minus', ['primary', 'shift']),
+    'web:windows': bind('Minus', ['primary', 'shift']),
+  },
+  // 页签循环：Ctrl+PageDown/PageUp 候选官方不可表示，仅保留 Ctrl+Alt+Arrow 主候选
+  'edrv.nextTab': {
+    'desktop:macos': bind('ArrowRight', ['primary', 'alt']),
+    'desktop:windows': bind('ArrowRight', ['primary', 'alt']),
+    'web:macos': bind('ArrowRight', ['primary', 'alt']),
+    'web:windows': bind('ArrowRight', ['primary', 'alt']),
+  },
+  'edrv.prevTab': {
+    'desktop:macos': bind('ArrowLeft', ['primary', 'alt']),
+    'desktop:windows': bind('ArrowLeft', ['primary', 'alt']),
+    'web:macos': bind('ArrowLeft', ['primary', 'alt']),
+    'web:windows': bind('ArrowLeft', ['primary', 'alt']),
+  },
+  'edrv.goToLine': {
+    'desktop:macos': bind('KeyG', ['primary']),
+    'desktop:windows': bind('KeyG', ['primary']),
+    'desktop:linux': bind('KeyG', ['primary']),
+  },
+  'edrv.showCommands': {
+    'desktop:macos': bind('KeyP', ['primary', 'shift']),
+    'desktop:windows': bind('KeyP', ['primary', 'shift']),
+    'desktop:linux': bind('KeyP', ['primary', 'shift']),
+    'web:macos': bind('KeyP', ['primary', 'shift']),
+    'web:windows': bind('KeyP', ['primary', 'shift']),
+  },
+  'edrv.nextEditorRow': {
+    'desktop:macos': bind('ArrowDown', ['primary', 'alt']),
+    'desktop:windows': bind('ArrowDown', ['primary', 'alt']),
+    'web:macos': bind('ArrowDown', ['primary', 'alt']),
+    'web:windows': bind('ArrowDown', ['primary', 'alt']),
+  },
+  'edrv.prevEditorRow': {
+    'desktop:macos': bind('ArrowUp', ['primary', 'alt']),
+    'desktop:windows': bind('ArrowUp', ['primary', 'alt']),
+    'web:macos': bind('ArrowUp', ['primary', 'alt']),
+    'web:windows': bind('ArrowUp', ['primary', 'alt']),
+  },
+  'edrv.addSelectionRef': {
+    'desktop:macos': bind('KeyU', ['primary']),
+    'desktop:windows': bind('KeyU', ['primary']),
+    'desktop:linux': bind('KeyU', ['primary']),
+  },
+  'edrv.closeTab': {
+    'desktop:macos': bind('F4', ['primary']),
+    'desktop:windows': bind('F4', ['primary']),
+    'desktop:linux': bind('F4', ['primary']),
+  },
+  // 调试 F 键：linux 判 modifier-required（裸 F/全 Shift），仅 desktop:macos/windows
+  'edrv.debugToggleBreakpoint': {
+    'desktop:macos': bind('F9', []),
+    'desktop:windows': bind('F9', []),
+  },
+  'edrv.debugStartContinue': {
+    'desktop:macos': bind('F5', []),
+    'desktop:windows': bind('F5', []),
+  },
+  'edrv.debugStepOver': {
+    'desktop:macos': bind('F10', []),
+    'desktop:windows': bind('F10', []),
+  },
+  'edrv.debugStepInto': {
+    'desktop:macos': bind('F11', []),
+    'desktop:windows': bind('F11', []),
+  },
+  'edrv.debugStepOut': {
+    'desktop:macos': bind('F11', ['shift']),
+    'desktop:windows': bind('F11', ['shift']),
+  },
+  'edrv.debugStop': {
+    'desktop:macos': bind('F5', ['shift']),
+    'desktop:windows': bind('F5', ['shift']),
+  },
+}
+
+//#endregion

package/src/shared/rules.ts

@@ -4,7 +4,10 @@
  * 作者 ddj 2026年09月03号
  */
 
-/** 规则作用域：用户规则（~/.dsh/rules）或项目规则（<工作区>/.dsh/rules）。 */
+/** 用户规则来源：当前 DSH_HOME 或系统用户目录的旧版 .dsh。 */
+export type UserRuleOrigin = 'current' | 'legacy'
+
+/** 规则作用域：用户规则（DSH_HOME/rules + ~/.dsh/rules）或项目规则（<工作区>/.dsh/rules）。 */
 export type RuleScope = 'user' | 'project'
 
 /** 规则生效类型（由 frontmatter 推导）：总是 / 自动（globs 命中时）/ 手动（仅索引）。 */
@@ -13,6 +16,8 @@ export type RuleType = 'always' | 'auto' | 'manual'
 /** 一条 .mdc 规则的元信息（列表行展示 + 注入语义所需的最小集）。 */
 export interface RuleInfo {
   scope: RuleScope
+  /** 用户规则的实际来源；项目规则不设置。 */
+  origin?: UserRuleOrigin
   /** 文件名（含 .mdc 后缀，不含路径）。 */
   file: string
   /** 绝对路径（host 解析，供展示与按需读取）。 */
@@ -48,6 +53,8 @@ export interface RuleSaveInput {
   scope: RuleScope
   /** project 必填：目标工作区绝对路径（须为 DSH 已注册 workspace）。 */
   workspacePath?: string
+  /** 缺省 current；仅用户规则可指定 legacy。 */
+  origin?: UserRuleOrigin
   file: string
   content: string
 }
@@ -56,5 +63,6 @@ export interface RuleSaveInput {
 export interface RuleRefInput {
   scope: RuleScope
   workspacePath?: string
+  origin?: UserRuleOrigin
   file: string
 }