dsh-vscode-mode 0.11.0 → 0.12.0

package/lib/client.js

@@ -1921,6 +1921,33 @@ window.__ModuleLoader__.load({
 			return MARKDOWN_EXT_SET.has(base.slice(dot + 1).toLowerCase());
 		}
 		//#endregion
+		//#region src/client/activePathStore.ts
+		/**
+		* dsh-vscode-mode client — 活动编辑器文件路径单点（模块级，不依赖 React）。
+		* 命令目录（ui/commandCatalog）是模块级常量、拿不到 EditorView 实例；其可用性判定
+		* 需要「当前活动文件是什么」（如 Markdown 预览切换仅 .md 活动文件吞键），故由
+		* EditorView 把 active 状态镜像到本 store，目录按需读取。
+		* 作者 ddj 2026年10月
+		*/
+		/** 当前活动文件路径（null = 无活动文件/编辑器未挂载）。 */
+		let activePath = null;
+		/**
+		* 镜像活动文件路径（EditorView 渲染同步点调用；卸载时回写 null）。
+		* @author ddj 2026年10月
+		* @param path 活动文件路径或 null
+		*/
+		function setActiveEditorPath(path) {
+			activePath = path;
+		}
+		/**
+		* 读取当前活动文件路径。
+		* @author ddj 2026年10月
+		* @returns 活动文件路径或 null
+		*/
+		function activeEditorPath() {
+			return activePath;
+		}
+		//#endregion
 		//#region src/client/md/componentType.ts
 		/**
 		* dsh-vscode-mode client — React 元素类型判定（纯函数，无 React/primitives 依赖）。
@@ -3976,62 +4003,6 @@ window.__ModuleLoader__.load({
 			return regions;
 		}
 		//#endregion
-		//#region src/shared/keybindings.ts
-		/**
-		* dsh-vscode-mode shared — 快捷键命令目录与默认键位（双面契约）。
-		* 纯数据模块：host（settings schema 默认值）与 client（执行匹配/设置页）共用。
-		* 键位格式：修饰符 + 主键，`+` 连接，如 `Ctrl+Shift+F`；空串 = 未绑定；
-		* `|` 连接多个候选（任一命中即触发），如 `Alt+ArrowLeft|Ctrl+Alt+-`。
-		* 约束：本模块被 host 与 client 两半共用，**禁止 import client 侧模块**（React/浏览器 API）。
-		* 与 client/ui/commandCatalog 的一致性由 tests/commands.test.ts 断言兜底。
-		* 作者 ddj 2026年08月26号 / 2026年09月10号
-		*/
-		/** 命令 id → 默认键位（可为多候选）。命令目录以此为准，新增命令只需加一项。 */
-		const KEYBINDING_DEFAULTS = {
-			"edrv.save": "Ctrl+S",
-			"edrv.quickOpen": "Ctrl+P",
-			"edrv.toggleSidebar": "Ctrl+B",
-			"edrv.searchInFiles": "Ctrl+Shift+F",
-			"edrv.toggleMarkdownPreview": "Ctrl+Shift+V",
-			"edrv.navigateBack": "Alt+ArrowLeft|Ctrl+Alt+-",
-			"edrv.navigateForward": "Alt+ArrowRight|Ctrl+Shift+-",
-			"edrv.nextTab": "Ctrl+Alt+ArrowRight|Ctrl+PageDown",
-			"edrv.prevTab": "Ctrl+Alt+ArrowLeft|Ctrl+PageUp",
-			"edrv.goToLine": "Ctrl+G",
-			"edrv.showCommands": "Ctrl+Shift+P|F1",
-			"edrv.nextEditorRow": "Ctrl+Alt+ArrowDown",
-			"edrv.prevEditorRow": "Ctrl+Alt+ArrowUp",
-			"edrv.addSelectionRef": "Ctrl+U",
-			"edrv.closeTab": "Ctrl+F4",
-			"edrv.debugToggleBreakpoint": "F9",
-			"edrv.debugStartContinue": "F5",
-			"edrv.debugStepOver": "F10",
-			"edrv.debugStepInto": "F11",
-			"edrv.debugStepOut": "Shift+F11",
-			"edrv.debugStop": "Shift+F5"
-		};
-		/**
-		* 返回默认键位的独立副本（调用方修改不污染目录）。
-		* @author ddj 2026年08月26号
-		* @returns 默认键位映射
-		*/
-		function defaultKeybindings() {
-			return { ...KEYBINDING_DEFAULTS };
-		}
-		/**
-		* 规整外部键位数据：只保留已知命令 id 且为字符串的值，未知 id 丢弃。
-		* 防止用户文档/旧版本写入的未知命令污染执行匹配。
-		* @author ddj 2026年08月26号
-		* @param raw 原始设置值
-		* @returns 规整后的键位映射（缺省项不补默认值，由调用方按需合并）
-		*/
-		function normalizeKeybindings(raw) {
-			const out = {};
-			if (!raw || typeof raw !== "object") return out;
-			for (const [id, chord] of Object.entries(raw)) if (id in KEYBINDING_DEFAULTS && typeof chord === "string") out[id] = chord;
-			return out;
-		}
-		//#endregion
 		//#region src/client/editorModelState.ts
 		/** Monaco 编辑器实例选择器（限定在插件编辑器行内，排除官方预览等其它 Monaco）。 */
 		const EDITOR_MODEL_SELECTOR = ".edrv-editor-row .monaco-editor";
@@ -6162,8 +6133,8 @@ window.__ModuleLoader__.load({
 		//#region src/client/ui/commandCatalog.ts
 		/**
 		* dsh-vscode-mode client — 编辑器指令目录（纯元数据）。
-		* 「一条命令 = 一条注册数据」：命令栏、快捷键设置页、快捷键监听与 Monaco 右键菜单
-		* 全部从本表读取；新增一条能力只需在 EDITOR_COMMANDS 追加一项（可选 keybinding）。
+		* 「一条命令 = 一条注册数据」：命令栏、快捷键设置页与 Monaco 右键菜单
+		* 全部从本表读取；新增一条能力只需在 EDITOR_COMMANDS 追加一项（默认键位见 shared/keybindings SHORTCUT_PROFILES）。
 		* run 只派发 `edrv.command.*` 窗口事件，不直接触碰 React/Monaco（`edrv.command.` 前缀
 		* 与既有 `edrv:` 刷新/主题事件分属不同命名空间，互不干扰）。
 		* 作者 ddj 2026年09月10号
@@ -6197,7 +6168,6 @@ window.__ModuleLoader__.load({
 				label: "下一编辑行（光标整行下移）",
 				category: "导航",
 				order: 50,
-				keybinding: "Ctrl+Alt+ArrowDown",
 				available: needsModel,
 				run: () => emit$1("nextEditorRow")
 			};
@@ -6213,7 +6183,6 @@ window.__ModuleLoader__.load({
 				label: "上一编辑行（光标整行上移）",
 				category: "导航",
 				order: 60,
-				keybinding: "Ctrl+Alt+ArrowUp",
 				available: needsModel,
 				run: () => emit$1("prevEditorRow")
 			};
@@ -6229,7 +6198,6 @@ window.__ModuleLoader__.load({
 				label: "转到行",
 				category: "导航",
 				order: 45,
-				keybinding: "Ctrl+G",
 				available: needsModel,
 				run: () => emit$1("goToLine")
 			};
@@ -6246,7 +6214,6 @@ window.__ModuleLoader__.load({
 				label: "添加选中内容为引用",
 				category: "编辑",
 				order: 10,
-				keybinding: "Ctrl+U",
 				available: needsModel,
 				run: () => emit$1("addSelectionRef")
 			};
@@ -6264,7 +6231,6 @@ window.__ModuleLoader__.load({
 				label: "关闭当前页签",
 				category: "文件",
 				order: 40,
-				keybinding: "Ctrl+F4",
 				available: hasOpenTabs,
 				run: () => emit$1("closeTab")
 			};
@@ -6332,9 +6298,10 @@ window.__ModuleLoader__.load({
 		}
 		/**
 		* 编辑器内置指令目录（顺序 = 快捷键设置页展示顺序）。
-		* 前置 8 条的键位由 EditorView / QuickOpen 自行 capture 监听（历史实现），
-		* 故不进 BRIDGE_COMMANDS，避免同一按键双执行。
-		* @author ddj 2026年09月10号
+		* 键位派发已归官方 shortcuts 机制：默认键位表在 shared/keybindings.ts 的 SHORTCUT_PROFILES，
+		* 由 client/index.ts 经 shortcutsOfficial.registerOfficialShortcuts 注册，本目录只管
+		* 「标签/可用性/执行」。无默认键位的命令同样注册（官方 UI/插件子页内可自定义绑定）。
+		* @author ddj 2026年09月10号 / 2026年10月
 		*/
 		const EDITOR_COMMANDS = [
 			{
@@ -6342,7 +6309,6 @@ window.__ModuleLoader__.load({
 				label: "保存文件",
 				category: "文件",
 				order: 10,
-				keybinding: "Ctrl+S",
 				available: needsModel,
 				run: () => emit$1("save")
 			},
@@ -6351,7 +6317,6 @@ window.__ModuleLoader__.load({
 				label: "快速打开文件",
 				category: "文件",
 				order: 20,
-				keybinding: "Ctrl+P",
 				available: alwaysAvailable,
 				run: () => emit$1("quickOpen")
 			},
@@ -6360,7 +6325,6 @@ window.__ModuleLoader__.load({
 				label: "切换侧边栏",
 				category: "视图",
 				order: 10,
-				keybinding: "Ctrl+B",
 				available: alwaysAvailable,
 				run: () => emit$1("toggleSidebar")
 			},
@@ -6369,7 +6333,6 @@ window.__ModuleLoader__.load({
 				label: "在工作区中搜索",
 				category: "视图",
 				order: 20,
-				keybinding: "Ctrl+Shift+F",
 				available: alwaysAvailable,
 				run: () => emit$1("searchInFiles")
 			},
@@ -6378,8 +6341,10 @@ window.__ModuleLoader__.load({
 				label: "切换 Markdown 预览",
 				category: "视图",
 				order: 25,
-				keybinding: "Ctrl+Shift+V",
-				available: alwaysAvailable,
+				available: () => {
+					const path = activeEditorPath();
+					return typeof path === "string" && isMarkdownPath(path);
+				},
 				run: () => emit$1("toggleMarkdownPreview")
 			},
 			{
@@ -6395,7 +6360,6 @@ window.__ModuleLoader__.load({
 				label: "后退（导航历史）",
 				category: "导航",
 				order: 10,
-				keybinding: "Alt+ArrowLeft|Ctrl+Alt+-",
 				available: needsModel,
 				run: () => emit$1("navigateBack")
 			},
@@ -6404,7 +6368,6 @@ window.__ModuleLoader__.load({
 				label: "前进（导航历史）",
 				category: "导航",
 				order: 20,
-				keybinding: "Alt+ArrowRight|Ctrl+Shift+-",
 				available: needsModel,
 				run: () => emit$1("navigateForward")
 			},
@@ -6413,7 +6376,6 @@ window.__ModuleLoader__.load({
 				label: "下一个页签",
 				category: "导航",
 				order: 30,
-				keybinding: "Ctrl+Alt+ArrowRight|Ctrl+PageDown",
 				available: needsModel,
 				run: () => emit$1("nextTab")
 			},
@@ -6422,7 +6384,6 @@ window.__ModuleLoader__.load({
 				label: "上一个页签",
 				category: "导航",
 				order: 40,
-				keybinding: "Ctrl+Alt+ArrowLeft|Ctrl+PageUp",
 				available: needsModel,
 				run: () => emit$1("prevTab")
 			},
@@ -6493,7 +6454,6 @@ window.__ModuleLoader__.load({
 					label: "调试：切换断点（光标行）",
 					category: "调试",
 					order: 10,
-					keybinding: "F9",
 					available: needsModel,
 					run: () => emit$1("debugToggleBreakpoint")
 				},
@@ -6502,7 +6462,6 @@ window.__ModuleLoader__.load({
 					label: "调试：启动 / 继续",
 					category: "调试",
 					order: 20,
-					keybinding: "F5",
 					available: canStart,
 					run: () => emit$1("debugStartContinue")
 				},
@@ -6511,7 +6470,6 @@ window.__ModuleLoader__.load({
 					label: "调试：单步跳过",
 					category: "调试",
 					order: 30,
-					keybinding: "F10",
 					available: paused,
 					run: () => emit$1("debugStepOver")
 				},
@@ -6520,7 +6478,6 @@ window.__ModuleLoader__.load({
 					label: "调试：单步步入",
 					category: "调试",
 					order: 40,
-					keybinding: "F11",
 					available: paused,
 					run: () => emit$1("debugStepInto")
 				},
@@ -6529,7 +6486,6 @@ window.__ModuleLoader__.load({
 					label: "调试：单步步出",
 					category: "调试",
 					order: 50,
-					keybinding: "Shift+F11",
 					available: paused,
 					run: () => emit$1("debugStepOut")
 				},
@@ -6538,16 +6494,15 @@ window.__ModuleLoader__.load({
 					label: "调试：停止",
 					category: "调试",
 					order: 60,
-					keybinding: "Shift+F5",
 					available: canStop,
 					run: () => emit$1("debugStop")
 				}
 			];
 		}
 		/**
-		* 桥接派发指令（无原生监听，键位由 commandBridge 统一 capture 处理）。
-		* 新增「只填目录、不写监听」的编辑器指令一律放这里：键位、命令栏、设置页自动可用。
-		* @author ddj 2026年09月10号
+		* 非编辑器原生路径的指令（键位统一由官方 shortcuts 机制派发；历史「桥接」分组名保留）。
+		* 新增「只填目录」的编辑器指令一律放这里：命令栏与官方快捷键目录自动可用。
+		* @author ddj 2026年09月10号 / 2026年10月
 		*/
 		const BRIDGE_COMMANDS = [
 			nextEditorRowDef(),
@@ -6569,32 +6524,22 @@ window.__ModuleLoader__.load({
 				label: "显示所有命令",
 				category: "视图",
 				order: 1,
-				keybinding: "Ctrl+Shift+P|F1",
 				available: alwaysAvailable,
 				run
 			};
 		}
-		/**
-		* 需要全局键位派发的指令（桥接类 + 命令栏自身；不含 EditorView/QuickOpen 原生监听的那些）。
-		* @author ddj 2026年09月10号
-		* @param showCommands 命令栏命令定义
-		* @returns 派发集合
-		*/
-		function dispatchedCommands(showCommands) {
-			return [...BRIDGE_COMMANDS, showCommands];
-		}
 		//#endregion
 		//#region src/client/keybindings.ts
 		/**
-		* 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月
 		*/
-		/** 命令目录（设置页展示标签；执行按目录序先匹配先执行，冲突键位确定性）。 */
+		/** 命令目录（设置页展示标签；命令栏候选与键位提示共用）。 */
 		const COMMANDS = [
 			...EDITOR_COMMANDS.map((command) => ({
 				id: command.id,
@@ -6609,21 +6554,6 @@ window.__ModuleLoader__.load({
 				label: command.label
 			}))
 		];
-		/** 命令栏命令定义（键位自检与目录展示共用；run 不参与键位逻辑）。 */
-		function paletteCommand() {
-			return showCommandsDef(() => {});
-		}
-		/**
-		* 目录与默认键位表一致性自检（仅告警不中断）：新指令漏写共享表时第一时间可见。
-		* @author ddj 2026年09月10号
-		*/
-		function checkDefaultsDrift() {
-			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 = {
 			ctrl: "ctrl",
 			cmd: "meta",
@@ -6631,24 +6561,17 @@ window.__ModuleLoader__.load({
 			shift: "shift",
 			alt: "alt"
 		};
-		let current = { ...KEYBINDING_DEFAULTS };
-		const runtime = /* @__PURE__ */ new Map();
+		/** 弦表（官方 catalog 派生：id → 显示键位弦）。官方目录就绪前为空（tooltip 走各自的兜底文案）。 */
+		let current = {};
 		const listeners$2 = /* @__PURE__ */ new Set();
-		checkDefaultsDrift();
 		/**
-		* 应用设置快照（与默认值合并；未知 id 丢弃；空对象 = 全部默认）。
-		* 每个命令可含多候选键位（`|` 分隔），任一命中即触发。
-		* @author ddj 2026年08月26号
-		* @param raw 设置 scope 的 keybindings 字段
+		* 应用官方目录弦表（id → 显示键位弦；由 shortcutsOfficial.bindCatalogChords 全量推送）。
+		* @author ddj 2026年10月
+		* @param chords 弦表（官方 catalog 派生，含用户覆盖；issue 行不收录）
 		*/
-		function keybindingsApply(raw) {
-			current = {
-				...KEYBINDING_DEFAULTS,
-				...normalizeKeybindings(raw)
-			};
-			for (const listener of listeners$2) try {
-				listener();
-			} catch {}
+		function applyOfficialChords(chords) {
+			current = { ...chords };
+			notifyKeybindings();
 		}
 		/**
 		* 订阅键位配置变化。
@@ -6660,33 +6583,23 @@ window.__ModuleLoader__.load({
 			listeners$2.add(listener);
 			return () => listeners$2.delete(listener);
 		}
+		/** 通知键位订阅者（异常隔离）。 */
+		function notifyKeybindings() {
+			for (const listener of listeners$2) try {
+				listener();
+			} catch {}
+		}
 		/**
-		* 当前命令的键位弦（运行时键位优先；未绑定/空 → null）。
-		* @author ddj 2026年08月26号 / 2026年09月10号
+		* 当前命令的键位弦（官方目录派生；未绑定/空 → null）。
+		* @author ddj 2026年08月26号 / 2026年10月
 		* @param id 命令 id
 		* @returns 键位弦或 null
 		*/
 		function chordOf(id) {
-			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号
-		* @param id 命令 id
-		* @returns 解析键位数组（可能为空）
-		*/
-		function bindingsOf(id) {
-			const override = runtime.get(id);
-			if (override) return override;
-			const chord = current[id];
-			return typeof chord === "string" ? parseChords(chord) : [];
-		}
-		/**
 		* 主键规范化：小写字母大写、空格归一为 Space，其余原样（与事件 e.key 对照）。
 		* @author ddj 2026年08月26号
 		* @param key 事件主键
@@ -6777,23 +6690,6 @@ window.__ModuleLoader__.load({
 			return false;
 		}
 		/**
-		* 从键盘事件构造键位弦（纯修饰键 → null，供设置页录制）。
-		* @author ddj 2026年08月26号
-		* @param e 键盘事件
-		* @returns 键位弦或 null
-		*/
-		function chordFromEvent(e) {
-			const key = normalizeKey(e.key ?? "");
-			if (!key || key === "Control" || key === "Shift" || key === "Alt" || key === "Meta") return null;
-			return formatChord({
-				ctrl: Boolean(e.ctrlKey),
-				shift: Boolean(e.shiftKey),
-				alt: Boolean(e.altKey),
-				meta: Boolean(e.metaKey),
-				key
-			});
-		}
-		/**
 		* 键位版本 hook：配置变化时返回新版本（tooltip/占位文案随键位刷新）。
 		* @author ddj 2026年08月26号
 		* @returns 当前版本号
@@ -6895,20 +6791,15 @@ window.__ModuleLoader__.load({
 					inputRef.current?.focus?.();
 					setOpen(true);
 				};
-				const onKey = (e) => {
-					if (matchEvent(e, bindingsOf("edrv.quickOpen"))) {
-						e.preventDefault();
-						e.stopPropagation();
-						openBox();
-					} else if (e.key === "Escape") {
-						setOpen(false);
-						inputRef.current?.blur?.();
-					}
+				const onEscape = (e) => {
+					if (e.key !== "Escape") return;
+					setOpen(false);
+					inputRef.current?.blur?.();
 				};
-				window.addEventListener("keydown", onKey, true);
+				window.addEventListener("keydown", onEscape, true);
 				window.addEventListener("edrv.command.quickOpen", openBox);
 				return () => {
-					window.removeEventListener("keydown", onKey, true);
+					window.removeEventListener("keydown", onEscape, true);
 					window.removeEventListener("edrv.command.quickOpen", openBox);
 				};
 			}, []);
@@ -18721,6 +18612,8 @@ window.__ModuleLoader__.load({
 			const rowNavMoveRef = react.default.useRef(false);
 			const activeRef = react.default.useRef(null);
 			activeRef.current = active;
+			setActiveEditorPath(active);
+			react.default.useEffect(() => () => setActiveEditorPath(null), []);
 			const tabsRef = react.default.useRef([]);
 			tabsRef.current = tabs;
 			const tabPathsRef = react.default.useRef([]);
@@ -19772,28 +19665,6 @@ window.__ModuleLoader__.load({
 				sessionId,
 				sidebarKey
 			]);
-			react.default.useEffect(() => {
-				const onKey = (e) => {
-					if (!matchEvent(e, bindingsOf("edrv.toggleSidebar"))) return;
-					e.preventDefault();
-					e.stopPropagation();
-					setSidebarOn((v) => !v);
-				};
-				window.addEventListener("keydown", onKey, true);
-				return () => window.removeEventListener("keydown", onKey, true);
-			}, []);
-			react.default.useEffect(() => {
-				const onKey = (e) => {
-					if (!matchEvent(e, bindingsOf("edrv.save"))) return;
-					if (!editorRef.current?.getModel?.()) return;
-					e.preventDefault();
-					e.stopPropagation();
-					flushSave();
-					doSaveRef.current(false);
-				};
-				window.addEventListener("keydown", onKey, true);
-				return () => window.removeEventListener("keydown", onKey, true);
-			}, []);
 			/**
 			* 打开搜索面板（Ctrl+Shift+F 与命令栏「在工作区中搜索」的唯一动作）。
 			*
@@ -19814,59 +19685,6 @@ window.__ModuleLoader__.load({
 				setActivePanel("search");
 				setTimeout(() => window.dispatchEvent(new CustomEvent("edrv:search-focus")), 0);
 			};
-			react.default.useEffect(() => {
-				const onKey = (e) => {
-					if (!matchEvent(e, bindingsOf("edrv.searchInFiles"))) return;
-					e.preventDefault();
-					e.stopPropagation();
-					openSearchPanel();
-				};
-				window.addEventListener("keydown", onKey, true);
-				return () => window.removeEventListener("keydown", onKey, true);
-			}, []);
-			react.default.useEffect(() => {
-				const onKey = (e) => {
-					if (!matchEvent(e, bindingsOf("edrv.toggleMarkdownPreview"))) return;
-					const path = activeRef.current;
-					if (!isMarkdownPath(path)) return;
-					e.preventDefault();
-					e.stopPropagation();
-					toggleMdPreviewRef.current?.(path);
-				};
-				window.addEventListener("keydown", onKey, true);
-				return () => window.removeEventListener("keydown", onKey, true);
-			}, []);
-			react.default.useEffect(() => {
-				const onKey = (e) => {
-					if (!matchEvent(e, bindingsOf("edrv.navigateBack"))) return;
-					e.preventDefault();
-					e.stopPropagation();
-					if (navBackRef.current) navBackRef.current();
-				};
-				window.addEventListener("keydown", onKey, true);
-				return () => window.removeEventListener("keydown", onKey, true);
-			}, []);
-			react.default.useEffect(() => {
-				const onKey = (e) => {
-					if (!matchEvent(e, bindingsOf("edrv.navigateForward"))) return;
-					e.preventDefault();
-					e.stopPropagation();
-					if (navForwardRef.current) navForwardRef.current();
-				};
-				window.addEventListener("keydown", onKey, true);
-				return () => window.removeEventListener("keydown", onKey, true);
-			}, []);
-			react.default.useEffect(() => {
-				const onKey = (e) => {
-					const step = matchEvent(e, bindingsOf("edrv.nextTab")) ? 1 : matchEvent(e, bindingsOf("edrv.prevTab")) ? -1 : 0;
-					if (step === 0) return;
-					e.preventDefault();
-					e.stopPropagation();
-					if (cycleTabRef.current) cycleTabRef.current(step);
-				};
-				window.addEventListener("keydown", onKey, true);
-				return () => window.removeEventListener("keydown", onKey, true);
-			}, []);
 			react.default.useEffect(() => {
 				ensureSvnStatus(sessionId, scope);
 				const onSvnStatus = (event) => {
@@ -23150,179 +22968,6 @@ window.__ModuleLoader__.load({
 		*/
 		const SettingsContext = react.default.createContext(void 0);
 		//#endregion
-		//#region src/client/ui/KeybindingsPanel.ts
-		/**
-		* dsh-vscode-mode client — VSCodeMode 设置区「快捷键」管理页。
-		* 命令目录来自 client/keybindings 的 COMMANDS；当前键位读 SettingsContext scope；
-		* 编辑：行内录制（捕获下一次组合键），Esc 取消、Backspace/Delete 清空（未绑定）；
-		* 草稿 + 显式保存（scope.set('keybindings', draft)）；行级恢复 + 页级「恢复默认」；
-		* 冲突键位（两命令同键位）标红警告；scope 外部变更且无未保存修改时回同步草稿。
-		* 作者 ddj 2026-08-26
-		*/
-		/**
-		* 草稿化：默认值 + 设置值合并，空串归一为 null（未绑定）。
-		* @param raw 设置 scope 的 keybindings 字段
-		* @returns 草稿映射（id → 键位弦或 null）
-		*/
-		function draftOf(raw) {
-			const merged = {
-				...defaultKeybindings(),
-				...normalizeKeybindings(raw)
-			};
-			const out = {};
-			for (const [id, chord] of Object.entries(merged)) out[id] = chord === "" ? null : chord;
-			return out;
-		}
-		/**
-		* 存库化：null（未绑定）转空串。
-		* @param draft 草稿映射
-		* @returns 可存储的键位映射
-		*/
-		function storeOf(draft) {
-			const out = {};
-			for (const [id, chord] of Object.entries(draft)) out[id] = chord === null ? "" : chord;
-			return out;
-		}
-		/**
-		* 冲突检测：同一键位被多个命令占用 → 返回冲突命令 id 集合。
-		* @param draft 草稿映射
-		* @returns 冲突命令 id 集合
-		*/
-		function conflictsOf(draft) {
-			const byChord = /* @__PURE__ */ new Map();
-			for (const [id, chord] of Object.entries(draft)) {
-				if (!chord) continue;
-				const list = byChord.get(chord) ?? [];
-				list.push(id);
-				byChord.set(chord, list);
-			}
-			const out = /* @__PURE__ */ new Set();
-			for (const list of byChord.values()) if (list.length > 1) for (const id of list) out.add(id);
-			return out;
-		}
-		/**
-		* 快捷键管理页主体。
-		*/
-		function KeybindingsPanel() {
-			const settings = react.default.useContext(SettingsContext);
-			const snapshot = settings?.getSnapshot?.();
-			const unavailable = !settings || snapshot?.status === "unavailable";
-			const notReady = snapshot?.status !== "ready";
-			const [draft, setDraft] = react.default.useState(() => draftOf(snapshot?.value?.keybindings));
-			const [recording, setRecording] = react.default.useState(null);
-			const [dirty, setDirty] = react.default.useState(false);
-			const [busy, setBusy] = react.default.useState(false);
-			const [error, setError] = react.default.useState("");
-			const [message, setMessage] = react.default.useState("");
-			const dirtyRef = react.default.useRef(false);
-			dirtyRef.current = dirty;
-			const lastKeyRef = react.default.useRef(JSON.stringify(draft));
-			const snapshotValue = snapshot?.value?.keybindings;
-			react.default.useEffect(() => {
-				if (dirtyRef.current) return;
-				const next = draftOf(snapshotValue);
-				const key = JSON.stringify(next);
-				if (key === lastKeyRef.current) return;
-				lastKeyRef.current = key;
-				setDraft(next);
-			}, [snapshotValue]);
-			react.default.useEffect(() => {
-				if (!recording) return;
-				const onKey = (e) => {
-					e.preventDefault();
-					e.stopPropagation();
-					if (e.key === "Escape") {
-						setRecording(null);
-						return;
-					}
-					if (e.key === "Backspace" || e.key === "Delete") {
-						setDraft((prev) => Object.assign({}, prev, { [recording]: null }));
-						setRecording(null);
-						setDirty(true);
-						return;
-					}
-					const chord = chordFromEvent(e);
-					if (!chord) return;
-					setDraft((prev) => Object.assign({}, prev, { [recording]: chord }));
-					setRecording(null);
-					setDirty(true);
-				};
-				window.addEventListener("keydown", onKey, true);
-				return () => window.removeEventListener("keydown", onKey, true);
-			}, [recording]);
-			const conflicts = conflictsOf(draft);
-			const save = () => {
-				if (!settings?.set) {
-					setError("设置服务不可用");
-					return;
-				}
-				setBusy(true);
-				setError("");
-				setMessage("");
-				settings.set("keybindings", storeOf(draft)).then(() => {
-					setDirty(false);
-					lastKeyRef.current = JSON.stringify(draft);
-					setMessage("已保存");
-				}).catch((e) => setError(String(e))).finally(() => setBusy(false));
-			};
-			/**
-			* 恢复全部默认（确认后直接保存，一步到位）。
-			*/
-			const resetAll = () => {
-				if (!settings?.set) {
-					setError("设置服务不可用");
-					return;
-				}
-				if (!window.confirm("恢复全部快捷键为默认值？")) return;
-				setBusy(true);
-				setError("");
-				setMessage("");
-				settings.set("keybindings", { ...defaultKeybindings() }).then(() => {
-					const next = draftOf({});
-					setDraft(next);
-					lastKeyRef.current = JSON.stringify(next);
-					setDirty(false);
-					setMessage("已恢复默认");
-				}).catch((e) => setError(String(e))).finally(() => setBusy(false));
-			};
-			/** 行级恢复该项默认值（进草稿，随保存提交）。 */
-			const resetRow = (id) => {
-				setDraft((prev) => Object.assign({}, prev, { [id]: KEYBINDING_DEFAULTS[id] ?? null }));
-				setDirty(true);
-			};
-			const rows = COMMANDS.map((command) => {
-				const chord = draft[command.id] ?? null;
-				const conflict = chord !== null && conflicts.has(command.id);
-				const invalid = chord !== null && parseChords(chord).length === 0;
-				const recordingRow = recording === command.id;
-				let display;
-				if (recordingRow) display = react.default.createElement("span", { className: "vsm-kb-rec" }, "按下组合键…（Esc 取消 / Backspace 清除）");
-				else display = react.default.createElement("kbd", { className: "vsm-kb-key" + (conflict ? " warn" : "") + (invalid ? " invalid" : "") }, chord ?? "未绑定");
-				return react.default.createElement("div", {
-					key: command.id,
-					className: "vsm-kb-row" + (recordingRow ? " rec" : "")
-				}, react.default.createElement("div", { className: "vsm-kb-label" }, react.default.createElement("span", null, command.label), conflict && react.default.createElement("small", { className: "vsm-kb-warn" }, "与另一命令冲突"), invalid && react.default.createElement("small", { className: "vsm-kb-warn" }, "键位格式无效")), display, react.default.createElement("div", { className: "vsm-kb-actions" }, recordingRow ? react.default.createElement("button", { onClick: () => setRecording(null) }, "取消") : react.default.createElement(react.default.Fragment, null, react.default.createElement("button", {
-					disabled: unavailable || notReady || busy || snapshot?.writable === false,
-					onClick: () => {
-						setRecording(command.id);
-						setMessage("");
-					}
-				}, "编辑"), react.default.createElement("button", {
-					disabled: busy,
-					onClick: () => resetRow(command.id)
-				}, "恢复"))));
-			});
-			return react.default.createElement("section", { className: "vsm-general-page" }, react.default.createElement("h2", null, "快捷键"), react.default.createElement("p", null, "配置编辑器视图的快捷键（命令栏 / 保存 / 快速打开 / 侧边栏 / 搜索 / 后退前进 / 页签与编辑行导航）。修改即时写入配置，重新聚焦编辑器后生效；命令栏（默认 Ctrl+Shift+P 或 F1）可搜索并执行下列全部命令。"), unavailable && react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, "设置服务暂不可用，当前使用默认键位。"), error && react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, error), message && react.default.createElement("div", { className: "vsm-kb-message" }, message), react.default.createElement("section", { className: "vsm-panel" }, react.default.createElement("h3", { className: "vsm-panel-title" }, "编辑器键位"), react.default.createElement("div", { className: "vsm-panel-body" }, react.default.createElement("div", { className: "vsm-kb-list" }, rows)), react.default.createElement("div", { className: "vsm-panel-body vsm-kb-actionsbar" }, react.default.createElement("span", { className: "vsm-kb-dirty" }, dirty ? "有未保存的修改" : ""), react.default.createElement("button", {
-				className: "vsm-primary vsm-small",
-				disabled: unavailable || notReady || busy || snapshot?.writable === false || !dirty,
-				onClick: save
-			}, busy ? "保存中…" : "保存"), react.default.createElement("button", {
-				className: "vsm-small",
-				disabled: unavailable || notReady || busy || snapshot?.writable === false,
-				onClick: resetAll
-			}, "恢复默认"))));
-		}
-		//#endregion
 		//#region src/client/ui/LspSettings.ts
 		/**
 		* dsh-vscode-mode client — 「语言服务器」设置子 Tab。
@@ -24547,9 +24192,10 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/ui/McpSettings.ts
 		/**
-		* dsh-vscode-mode client — VSCodeMode 设置区：通用 / 快捷键 / MCP 管理 / 语言服务器 / 性能优化 / 兼容性。
+		* dsh-vscode-mode client — VSCodeMode 设置区：通用 / MCP 管理 / 语言服务器 / 性能优化 / 兼容性。
+		* （快捷键管理已迁出为独立顶层设置区 ui/ShortcutSettings.ts，与 VSCodeMode 平级。）
 		* MCP 管理 Tab 下含三个子页签：我的 MCP（profile 全局）/ 项目 MCP（各项目 .mcp.json）/ MCP 市场（占位）。
-		* 作者 ddj 2026年08月22号 / 2026年08月26号 / 2026年08月27号
+		* 作者 ddj 2026年08月22号 / 2026年08月26号 / 2026年08月27号 / 2026年10月
 		*/
 		const EMPTY = {
 			serverName: "",
@@ -25210,7 +24856,6 @@ window.__ModuleLoader__.load({
 			let body;
 			if (loading) body = react.default.createElement("div", { className: "vsm-mcp-empty" }, "正在读取 MCP 服务…");
 			else if (tab === "general") body = react.default.createElement(GeneralSettings, { registry: openerRegistry });
-			else if (tab === "keys") body = react.default.createElement(KeybindingsPanel, null);
 			else if (tab === "mcp") body = react.default.createElement(McpManagePanel, {
 				servers,
 				projects,
@@ -25235,9 +24880,6 @@ window.__ModuleLoader__.load({
 				className: tab === "general" ? "active" : "",
 				onClick: () => setTab("general")
 			}, "通用"), react.default.createElement("button", {
-				className: tab === "keys" ? "active" : "",
-				onClick: () => setTab("keys")
-			}, "快捷键"), react.default.createElement("button", {
 				className: tab === "mcp" ? "active" : "",
 				onClick: () => setTab("mcp")
 			}, "MCP 管理"), react.default.createElement("button", {
@@ -27656,7 +27298,10 @@ window.__ModuleLoader__.load({
 				className: "edrv-rules-main",
 				onClick: () => props.onEdit(rule),
 				title: rule.absPath
-			}, react.default.createElement("div", { className: "edrv-rules-line1" }, react.default.createElement("span", { className: "edrv-rules-file" }, rule.file), !props.narrow ? react.default.createElement("span", { className: "edrv-rules-path" }, "[" + rule.relHint + rule.file + "]") : null, !rule.enabled ? react.default.createElement("span", { className: "edrv-rules-offtag" }, "已停用") : null), react.default.createElement("div", { className: "edrv-rules-sub" }, react.default.createElement("span", { className: "edrv-rules-sublabel" }, "类型:"), typeBadge(rule.type), desc ? react.default.createElement("span", {
+			}, react.default.createElement("div", { className: "edrv-rules-line1" }, react.default.createElement("span", { className: "edrv-rules-file" }, rule.file), !props.narrow ? react.default.createElement("span", { className: "edrv-rules-path" }, "[" + rule.relHint + rule.file + "]") : null, props.narrow && rule.scope === "user" && rule.origin === "legacy" ? react.default.createElement("span", {
+				className: "edrv-rules-path",
+				title: rule.absPath
+			}, "旧目录") : null, !rule.enabled ? react.default.createElement("span", { className: "edrv-rules-offtag" }, "已停用") : null), react.default.createElement("div", { className: "edrv-rules-sub" }, react.default.createElement("span", { className: "edrv-rules-sublabel" }, "类型:"), typeBadge(rule.type), desc ? react.default.createElement("span", {
 				className: "edrv-rules-desc",
 				title: desc
 			}, clampDesc(desc, props.descCap)) : null)), react.default.createElement("div", { className: "edrv-rules-actions" }, react.default.createElement("button", {
@@ -27801,6 +27446,7 @@ window.__ModuleLoader__.load({
 				setForm({
 					mode: "new",
 					scope,
+					origin: scope === "user" ? "current" : void 0,
 					workspacePath: scope === "project" ? cwd : void 0,
 					relHint: scope === "project" ? ".dsh/rules/" : "rules/",
 					file: "",
@@ -27819,6 +27465,7 @@ window.__ModuleLoader__.load({
 			const openEdit = (rule) => {
 				rpc("rules.read", {
 					scope: rule.scope,
+					origin: rule.origin,
 					workspacePath: rule.scope === "project" ? rule.workspacePath : void 0,
 					file: rule.file
 				}).then((res) => {
@@ -27830,6 +27477,7 @@ window.__ModuleLoader__.load({
 					setForm({
 						mode: "edit",
 						scope: rule.scope,
+						origin: rule.origin,
 						workspacePath: rule.workspacePath,
 						relHint: rule.relHint,
 						file: rule.file,
@@ -27910,6 +27558,7 @@ window.__ModuleLoader__.load({
 				setForm(next);
 				rpc("rules.save", {
 					scope: form.scope,
+					origin: form.origin,
 					workspacePath: form.workspacePath,
 					file,
 					content: form.content
@@ -27934,9 +27583,11 @@ window.__ModuleLoader__.load({
 			* @param rule 目标规则
 			*/
 			const removeRule = (rule) => {
-				if (!window.confirm("删除规则 " + rule.file + "？（不可恢复）")) return;
+				const reveal = rule.scope === "user" && rule.origin !== "legacy" ? "\n若旧目录有同名规则，删除后它将重新生效。" : "";
+				if (!window.confirm("删除规则 " + rule.absPath + "？（不可恢复）" + reveal)) return;
 				rpc("rules.remove", {
 					scope: rule.scope,
+					origin: rule.origin,
 					workspacePath: rule.workspacePath,
 					file: rule.file
 				}).then((res) => {
@@ -27954,7 +27605,7 @@ window.__ModuleLoader__.load({
 				const enabled = !rule.enabled;
 				const applyLocal = (on) => setData((prev) => prev ? {
 					...prev,
-					user: prev.user.map((r) => r.scope === "user" && r.file === rule.file ? {
+					user: prev.user.map((r) => rule.scope === "user" && r.file === rule.file && (r.origin ?? "current") === (rule.origin ?? "current") ? {
 						...r,
 						enabled: on
 					} : r),
@@ -27969,6 +27620,7 @@ window.__ModuleLoader__.load({
 				applyLocal(enabled);
 				rpc("rules.toggle", {
 					scope: rule.scope,
+					origin: rule.origin,
 					workspacePath: rule.workspacePath,
 					file: rule.file,
 					enabled
@@ -28017,7 +27669,7 @@ window.__ModuleLoader__.load({
 					if (!activeProject()) return "当前工作区未注册为 DSH workspace，暂不能管理其项目规则";
 					return "<工作区>/.dsh/rules/ 还没有规则，点击「＋ 新建规则」创建";
 				}
-				return "还没有用户规则（~/.dsh/rules/），点击「＋ 新建规则」创建";
+				return "还没有用户规则（当前 DSH_HOME/rules/ 或旧目录 ~/.dsh/rules/），点击「＋ 新建规则」创建";
 			};
 			const renderBody = () => {
 				if (form) return react.default.createElement(RuleEditor, {
@@ -28050,7 +27702,7 @@ window.__ModuleLoader__.load({
 					})
 				};
 				return react.default.createElement("div", { className: "edrv-rules-list" }, rows.map((rule) => react.default.createElement(RuleRow, {
-					key: rule.scope + ":" + rule.file,
+					key: rule.scope + ":" + (rule.origin ?? "project") + ":" + rule.file,
 					rule,
 					...common
 				})));
@@ -28058,7 +27710,7 @@ window.__ModuleLoader__.load({
 			return react.default.createElement("div", {
 				className: "edrv-rules-panel",
 				ref: panelRef
-			}, renderTabs(), renderWsLine(), react.default.createElement("div", { className: "edrv-rules-hint" }, tab === "user" ? "用户规则对所有会话生效（存放于 ~/.dsh/rules/）" : "项目规则仅对所在工作区的会话生效（存放于 <工作区>/.dsh/rules/）"), renderBody());
+			}, renderTabs(), renderWsLine(), react.default.createElement("div", { className: "edrv-rules-hint" }, tab === "user" ? "读取 DSH_HOME/rules/ 与 ~/.dsh/rules/；同名时当前目录优先，新建保存到当前目录" : "项目规则仅对所在工作区的会话生效（存放于 <工作区>/.dsh/rules/）"), renderBody());
 		}
 		//#endregion
 		//#region src/client/ui/SvnAiPlanDialog.ts
@@ -31656,26 +31308,20 @@ window.__ModuleLoader__.load({
 		//#region src/client/commandBridge.ts
 		/**
 		* 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月
 		*/
-		const bridgeLog = log.child("commands");
-		/** 解析事件目标（缺省 window；无 window 返回 null）。 */
-		function resolveTarget(options) {
-			if (options.target) return options.target;
-			if (typeof window === "undefined") return null;
-			return window;
-		}
+		const bridgeLog$1 = log.child("commands");
 		/**
-		* 创建指令执行桥：注册内置指令 + 桥接类指令的全局键位监听。
+		* 创建指令执行桥：注册内置指令 + 命令栏自身，注入命令栏执行器。
 		* @author ddj 2026年09月10号
-		* @param options 装配选项（事件目标注入）
 		* @returns 指令执行桥句柄
 		*/
-		function createCommandBridge(options = {}) {
+		function createCommandBridge() {
 			const registry = createCommandRegistry();
 			const disposers = [];
 			const palette = showCommandsDef(() => openCommandPalette("command"));
@@ -31683,21 +31329,7 @@ window.__ModuleLoader__.load({
 			disposers.push(registry.register(palette));
 			setPaletteRunner((id) => registry.run(id));
 			setRegistryRef(registry);
-			const dispatched = dispatchedCommands(palette);
-			const onKey = (event) => {
-				for (const command of dispatched) {
-					if (!matchEvent(event, bindingsOf(command.id))) continue;
-					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, true);
 			const dispose = () => {
-				if (target) target.removeEventListener("keydown", onKey, true);
 				while (disposers.length) {
 					const release = disposers.pop();
 					if (release) release();
@@ -31705,13 +31337,932 @@ window.__ModuleLoader__.load({
 				setPaletteRunner(null);
 				setRegistryRef(null);
 			};
-			bridgeLog.info("指令注册表已装配（" + registry.list().length + " 条指令，桥接键位 " + dispatched.length + " 条）");
+			bridgeLog$1.info("指令注册表已装配（" + registry.list().length + " 条指令；键位派发已归官方 shortcuts 机制）");
 			return {
 				registry,
 				dispose
 			};
 		}
 		//#endregion
+		//#region src/shared/keybindings.ts
+		/**
+		* dsh-vscode-mode shared — 快捷键命令目录与默认键位（双面契约）。
+		* 纯数据模块：host（settings schema 默认值）与 client（执行匹配/设置页）共用。
+		* 键位格式：修饰符 + 主键，`+` 连接，如 `Ctrl+Shift+F`；空串 = 未绑定；
+		* `|` 连接多个候选（任一命中即触发），如 `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号
+		*/
+		/** 命令 id → 默认键位（可为多候选）。命令目录以此为准，新增命令只需加一项。 */
+		const KEYBINDING_DEFAULTS = {
+			"edrv.save": "Ctrl+S",
+			"edrv.quickOpen": "Ctrl+P",
+			"edrv.toggleSidebar": "Ctrl+B",
+			"edrv.searchInFiles": "Ctrl+Shift+F",
+			"edrv.toggleMarkdownPreview": "Ctrl+Shift+V",
+			"edrv.navigateBack": "Alt+ArrowLeft|Ctrl+Alt+-",
+			"edrv.navigateForward": "Alt+ArrowRight|Ctrl+Shift+-",
+			"edrv.nextTab": "Ctrl+Alt+ArrowRight|Ctrl+PageDown",
+			"edrv.prevTab": "Ctrl+Alt+ArrowLeft|Ctrl+PageUp",
+			"edrv.goToLine": "Ctrl+G",
+			"edrv.showCommands": "Ctrl+Shift+P|F1",
+			"edrv.nextEditorRow": "Ctrl+Alt+ArrowDown",
+			"edrv.prevEditorRow": "Ctrl+Alt+ArrowUp",
+			"edrv.addSelectionRef": "Ctrl+U",
+			"edrv.closeTab": "Ctrl+F4",
+			"edrv.debugToggleBreakpoint": "F9",
+			"edrv.debugStartContinue": "F5",
+			"edrv.debugStepOver": "F10",
+			"edrv.debugStepInto": "F11",
+			"edrv.debugStepOut": "Shift+F11",
+			"edrv.debugStop": "Shift+F5"
+		};
+		/**
+		* 返回默认键位的独立副本（调用方修改不污染目录）。
+		* @author ddj 2026年08月26号
+		* @returns 默认键位映射
+		*/
+		function defaultKeybindings() {
+			return { ...KEYBINDING_DEFAULTS };
+		}
+		/**
+		* 规整外部键位数据：只保留已知命令 id 且为字符串的值，未知 id 丢弃。
+		* 防止用户文档/旧版本写入的未知命令污染执行匹配。
+		* @author ddj 2026年08月26号
+		* @param raw 原始设置值
+		* @returns 规整后的键位映射（缺省项不补默认值，由调用方按需合并）
+		*/
+		function normalizeKeybindings(raw) {
+			const out = {};
+			if (!raw || typeof raw !== "object") return out;
+			for (const [id, chord] of Object.entries(raw)) if (id in KEYBINDING_DEFAULTS && typeof chord === "string") out[id] = chord;
+			return out;
+		}
+		/** 显示主键 → 官方物理 code 对照（官方 code 白名单：Key[A-Z]|Digit[0-9]|F1-24|具名键）。 */
+		const DISPLAY_KEY_TO_CODE = {
+			"-": "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"
+		];
+		/** 官方 code → 显示主键（符号键反向对照）。 */
+		const CODE_TO_DISPLAY_KEY = {
+			Minus: "-",
+			Equal: "=",
+			BracketLeft: "[",
+			BracketRight: "]",
+			Semicolon: ";",
+			Quote: "'",
+			Comma: ",",
+			Period: ".",
+			Slash: "/",
+			Backslash: "\\",
+			Backquote: "`"
+		};
+		/** 显示主键 → 官方 code（PageUp/PageDown/Home/End/Insert 等官方不支持 → null）。 */
+		function keyToCode(key) {
+			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) {
+			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.includes(code)) return code;
+			return null;
+		}
+		/** 插件弦的修饰符 token → 官方修饰符（Ctrl 与 Cmd 同为 primary，与 matchEvent 的互认语义一致）。 */
+		const CHORD_MODIFIER_TOKENS = {
+			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
+		*/
+		function chordToBinding(chord) {
+			const parts = String(chord ?? "").split("+").map((part) => part.trim()).filter(Boolean);
+			if (!parts.length) return null;
+			const modifiers = /* @__PURE__ */ new Set();
+			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）
+		*/
+		function bindingToChord(binding) {
+			if (!binding || typeof binding !== "object") return null;
+			const key = codeToKey(binding.code);
+			if (key === null) return null;
+			let suffix = "";
+			if (binding.secondCode !== void 0) {
+				const secondKey = codeToKey(binding.secondCode);
+				if (secondKey === null) return null;
+				suffix = "+" + secondKey;
+			}
+			const parts = [];
+			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, modifiers) {
+			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月
+		*/
+		const SHORTCUT_PROFILES = {
+			"edrv.toggleSidebar": {},
+			"edrv.save": {
+				"desktop:macos": bind("KeyS", ["primary"]),
+				"desktop:windows": bind("KeyS", ["primary"]),
+				"desktop:linux": bind("KeyS", ["primary"])
+			},
+			"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"])
+			},
+			"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"])
+			},
+			"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"])
+			},
+			"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"])
+			},
+			"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
+		//#region src/client/shortcutsOfficial.ts
+		/**
+		* dsh-vscode-mode client — 官方 shortcuts 服务桥接层。
+		* 职责四件：① 运行时探测 ctx.shortcuts（可选服务，有界重试，不进 inject——旧版 DSH 无此服务
+		* 时不阻断装配）；② safeRegister 逐命令注册（官方 register 对重复 id/保留默认/组合重叠抛错，
+		* 冲突时去掉默认键位降级注册，绝不阻断插件加载）；③ 官方命令定义构建（commandCatalog → 官方
+		* command，resolve 统一走插件注册表 run，可用性为假返回 pass 不吞键）；④ 旧 keybindings
+		* 设置一次性迁移进官方存储。
+		* 作者 ddj 2026年10月
+		*/
+		const bridgeLog = log.child("shortcuts-official");
+		/** 迁移比对用的默认键位表副本（模块态，避免每次调用重建）。 */
+		const KEYBINDING_DEFAULTS_OF = defaultKeybindings();
+		/** 结构探测：get('shortcuts') 命中且具备核心能力才算服务就绪（设置组件运行时自愈探测复用）。 */
+		function detectShortcuts(ctx) {
+			try {
+				const service = ctx.get("shortcuts");
+				if (service && typeof service.register === "function" && typeof service.edit === "function" && service.catalog && service.config) return service;
+			} catch {}
+			return null;
+		}
+		/**
+		* 探测官方 shortcuts 服务：立即探测一次，未命中按节奏有界重试；命中或用尽均回调一次。
+		* @author ddj 2026年10月
+		* @param ctx 客户端上下文
+		* @param options schedule/重试节奏 + onReady 回调
+		* @returns 取消探测的注销函数
+		*/
+		function awaitShortcutsService(ctx, options) {
+			const maxAttempts = options.attempts ?? 15;
+			const interval = options.intervalMs ?? 2e3;
+			let attempts = 0;
+			let settled = false;
+			const tick = () => {
+				if (settled) return;
+				const service = detectShortcuts(ctx);
+				if (service !== null) {
+					settled = true;
+					options.onReady(service);
+					return;
+				}
+				if (attempts >= maxAttempts) {
+					settled = true;
+					options.onReady(null);
+					return;
+				}
+				attempts += 1;
+				options.schedule(tick, interval);
+			};
+			tick();
+			return () => {
+				settled = true;
+			};
+		}
+		/**
+		* 逐命令安全注册：官方 register 抛错（重复 id/保留默认/组合重叠）时去掉默认键位重试一次，
+		* 保证命令仍进官方目录（可被用户手动绑定），注册路径绝不抛错、绝不阻断装配。
+		* @author ddj 2026年10月
+		* @param service 官方服务
+		* @param command 官方命令定义
+		* @returns 注销函数（注册失败返回空操作）
+		*/
+		function safeRegister(service, command) {
+			try {
+				return service.register(command);
+			} catch (error) {
+				if (!command.defaults || Object.keys(command.defaults).length === 0) {
+					bridgeLog.warn("官方快捷键注册失败（" + command.id + "）：" + String(error));
+					return () => {};
+				}
+				bridgeLog.warn("官方快捷键默认键位被拒（" + command.id + "），降级为未绑定：" + String(error));
+				try {
+					return service.register({
+						...command,
+						defaults: {}
+					});
+				} catch (retryError) {
+					bridgeLog.warn("官方快捷键注册失败（" + command.id + "）：" + String(retryError));
+					return () => {};
+				}
+			}
+		}
+		/**
+		* 官方服务未就绪时复用旧版窗口键位语义；服务出现后注销，避免双执行。
+		* @author ddj 2026年09月28号
+		* @param defs 按目录序排列的插件命令
+		* @param runner 指令注册表
+		* @param chords 当前旧设置键位获取函数
+		* @param target 键盘事件目标（缺省 window，测试可注入）
+		* @returns 注销监听的函数
+		*/
+		function installLegacyKeys(defs, runner, chords, target = typeof window === "undefined" ? null : window) {
+			if (!target) return () => {};
+			const cache = /* @__PURE__ */ new Map();
+			const onKey = (event) => {
+				const key = event;
+				const current = chords();
+				for (const def of defs) {
+					const chord = current[def.id];
+					if (!chord) continue;
+					let bindings = cache.get(chord);
+					if (!bindings) {
+						bindings = parseChords(chord);
+						cache.set(chord, bindings);
+					}
+					if (!matchEvent(key, bindings) || !runner.isAvailable(def.id)) continue;
+					key.preventDefault();
+					key.stopPropagation();
+					runner.run(def.id);
+					return;
+				}
+			};
+			target.addEventListener("keydown", onKey, true);
+			return () => target.removeEventListener("keydown", onKey, true);
+		}
+		/**
+		* 插件命令定义 → 官方命令定义：默认键位取 SHORTCUT_PROFILES（缺省 = 不绑定）；
+		* resolve 可用性为假返回 pass（不吞键，与旧桥「不可用不执行也不吞键」语义一致），
+		* 执行统一走注册表 run（自带可用性复核与异常捕获）。
+		* @author ddj 2026年10月
+		* @param def 插件命令定义
+		* @param runner 插件指令注册表
+		* @returns 官方命令定义
+		*/
+		function officialCommandOf(def, runner) {
+			return {
+				id: def.id,
+				label: () => def.label,
+				aliases: [],
+				defaults: void 0,
+				regions: ["page", "editable"],
+				modals: [],
+				resolve: () => {
+					if (!runner.isAvailable(def.id)) return { status: "pass" };
+					return {
+						status: "handled",
+						run: () => {
+							runner.run(def.id);
+						}
+					};
+				}
+			};
+		}
+		/**
+		* 注册全部命令进官方服务（逐命令 safeRegister 隔离，defaults 由调用方按 id 注入 SHORTCUT_PROFILES）。
+		* @author ddj 2026年10月
+		* @param service 官方服务
+		* @param defs 插件命令定义（id/label）
+		* @param runner 插件指令注册表
+		* @param profiles id → 官方 profile 默认键位
+		* @returns 聚合注销函数
+		*/
+		function registerOfficialShortcuts(service, defs, runner, profiles) {
+			const disposers = [];
+			for (const def of defs) {
+				const command = officialCommandOf(def, runner);
+				command.defaults = profiles[def.id] ?? {};
+				disposers.push(safeRegister(service, command));
+			}
+			return () => {
+				while (disposers.length) disposers.pop()?.();
+			};
+		}
+		/**
+		* 订阅官方目录 → 重建 edrv.* 弦表（chordOf 数据源）；目录变化即通知。
+		* 只收录 issue 为空的行（conflict 行保留——用户显式改键后 tooltip 仍显示其选择，
+		* 冲突状态由设置页徽标呈现）。
+		* @author ddj 2026年10月
+		* @param service 官方服务
+		* @param onChange 弦表回调（每次全量替换）
+		* @returns 注销函数
+		*/
+		function bindCatalogChords(service, onChange) {
+			const sync = () => {
+				const chords = {};
+				try {
+					for (const row of service.catalog.getSnapshot()) {
+						if (!row.id.startsWith("edrv.") || row.binding === null) continue;
+						if (row.issue !== null) continue;
+						const chord = bindingToChord(row.binding);
+						if (chord !== null) chords[row.id] = chord;
+					}
+				} catch (error) {
+					bridgeLog.warn("官方目录弦表重建失败：" + String(error));
+				}
+				onChange(chords);
+			};
+			sync();
+			return service.catalog.subscribe(sync);
+		}
+		/**
+		* 官方 edit 单次写入；stale 表示其他窗口已更新，不自动用新 revision 重放。
+		* @author ddj 2026年09月28号
+		* @param service 官方快捷键服务
+		* @param edit 本次操作
+		* @returns 是否保存成功
+		*/
+		async function editOnce(service, edit) {
+			try {
+				const result = await service.edit(edit, service.config.getSnapshot().revision);
+				if (result.status === "saved") return true;
+				bridgeLog.warn("官方快捷键写入未成功（" + edit.type + (edit.type === "set" ? " " + edit.id : "") + "）：" + result.status);
+			} catch (error) {
+				bridgeLog.warn("官方快捷键写入异常（" + edit.type + "）：" + String(error));
+			}
+			return false;
+		}
+		/**
+		* 逐条恢复插件自定义键位；官方 reset-all 会清空所有产品命令的覆盖，不能使用。
+		* @author ddj 2026年09月28号
+		* @param service 官方快捷键服务
+		* @returns 完成数量及首个失败命令（有失败时）
+		*/
+		async function resetPluginKeys(service) {
+			const ids = service.catalog.getSnapshot().filter((row) => row.id.startsWith("edrv.") && row.modified).map((row) => row.id);
+			let reset = 0;
+			for (const id of ids) {
+				if (!await editOnce(service, {
+					type: "reset",
+					id
+				})) return {
+					reset,
+					failed: id
+				};
+				reset += 1;
+			}
+			return { reset };
+		}
+		const MIGRATION_KEY = "dsh-vscode-mode.shortcuts-migrated.v1.";
+		/**
+		* 当前快捷键运行平台的迁移标记键；不同 Web/Desktop 和操作系统分别处理。
+		* @author ddj 2026年09月28号
+		* @param service 官方快捷键服务
+		* @returns 本机迁移标记键
+		*/
+		function migrationKey(service) {
+			return MIGRATION_KEY + service.runtime + "." + service.platform;
+		}
+		/**
+		* 检查当前端是否已处理旧设置；存储不可用时继续按目录状态判定。
+		* @author ddj 2026年09月28号
+		* @param service 官方快捷键服务
+		* @returns 是否已处理
+		*/
+		function hasMigrated(service) {
+			try {
+				return typeof localStorage !== "undefined" && localStorage.getItem(migrationKey(service)) === "1";
+			} catch {
+				return false;
+			}
+		}
+		/**
+		* 标记当前端已处理；旧设置永不清空，供其他平台及人工恢复使用。
+		* @author ddj 2026年09月28号
+		* @param service 官方快捷键服务
+		*/
+		function markMigrated(service) {
+			try {
+				if (typeof localStorage !== "undefined") localStorage.setItem(migrationKey(service), "1");
+			} catch {
+				bridgeLog.warn("无法持久化旧快捷键迁移标记，本次配置仍保留");
+			}
+		}
+		/**
+		* 旧 keybindings 设置按当前 runtime/platform 一次性导入官方存储：
+		* - 仅处理与 KEYBINDING_DEFAULTS 有差异的单候选键位；多候选、空键位、冲突或
+		*   官方不可表示项不迁移，完整旧值仍保留（官方每条命令当前只允许一个绑定）；
+		* - 官方已有自定义值时不覆盖，stale 冲突也不自动重放；
+		* - 旧配置供其他平台及人工恢复使用，绝不清空；当前端成功处理后记录本地标记，
+		*   防止重启后把已由用户重置的官方键位重新导入。
+		* @author ddj 2026年10月
+		* @param service 官方服务
+		* @param scope 旧设置 scope（settings bridge 绑定产物）
+		* @returns 迁移结果
+		*/
+		async function migrateLegacyKeybindings(service, scope) {
+			const snapshot = scope.getSnapshot();
+			if (snapshot.status !== "ready") return {
+				imported: 0,
+				skipped: 0,
+				done: false
+			};
+			if (service.config.getSnapshot().status !== "ready") return {
+				imported: 0,
+				skipped: 0,
+				done: false
+			};
+			if (hasMigrated(service)) return {
+				imported: 0,
+				skipped: 0,
+				done: true
+			};
+			const stored = normalizeKeybindings(snapshot.value?.keybindings);
+			const overrides = Object.entries(stored).filter(([id, chord]) => chord !== KEYBINDING_DEFAULTS_OF[id]);
+			if (overrides.length === 0) return {
+				imported: 0,
+				skipped: 0,
+				done: true
+			};
+			let imported = 0;
+			let skipped = 0;
+			for (const [id, chord] of overrides) {
+				if (!chord.trim() || chord.includes("|")) {
+					skipped += 1;
+					bridgeLog.warn("迁移跳过（空键位或多候选，原值保留）：" + id);
+					continue;
+				}
+				const binding = chordToBinding(chord);
+				if (binding === null) {
+					skipped += 1;
+					bridgeLog.warn("迁移跳过（官方不可表示）：" + id + " = " + chord);
+					continue;
+				}
+				if (service.catalog.getSnapshot().some((row) => row.id === id && row.modified)) {
+					skipped += 1;
+					bridgeLog.warn("迁移跳过（官方存储已有自定义值）：" + id);
+					continue;
+				}
+				let probe;
+				try {
+					probe = service.describeBinding(binding);
+				} catch (error) {
+					bridgeLog.warn("迁移中止（describeBinding 异常）：" + String(error));
+					return {
+						imported,
+						skipped,
+						done: false
+					};
+				}
+				if (probe.conflicts.length > 0 || probe.issue !== null) {
+					skipped += 1;
+					bridgeLog.warn("迁移跳过（与官方键冲突/保留）：" + id + " = " + chord);
+					continue;
+				}
+				if (!await editOnce(service, {
+					type: "set",
+					id,
+					binding
+				})) return {
+					imported,
+					skipped,
+					done: false
+				};
+				imported += 1;
+			}
+			markMigrated(service);
+			bridgeLog.info("旧快捷键设置已处理（旧值保留）：导入 " + imported + " 条，跳过 " + skipped + " 条");
+			return {
+				imported,
+				skipped,
+				done: true
+			};
+		}
+		//#endregion
+		//#region src/client/ui/ShortcutSettings.ts
+		/**
+		* dsh-vscode-mode client — 独立「快捷键」设置区（与 VSCodeMode 平级，settings.section slot）。
+		* 子页一「官方快捷键」：官方 shortcuts 目录只读总览（官方 + 插件命令）+ 一键打开官方快捷键弹窗；
+		* 子页二「插件快捷键」：插件命令（edrv.*）行内录键编辑，持久化经官方 edit API
+		* （Desktop: userData/keybindings.json；Web: localStorage dsh.keybindings.v1），不再写插件设置。
+		* 录制期间调 service.recording(true)：Desktop 原生键盘桥暂停拦截，否则录不到键。
+		* 样式复用 vsm-kb-* / vsm-panel-* / vsm-mcp-subtabs（styles/mcp.css 随 client bundle 注入）。
+		* 作者 ddj 2026年10月
+		*/
+		const settingsLog = log.child("shortcut-settings");
+		const MODIFIER_ONLY = /* @__PURE__ */ new Set([
+			"Control",
+			"Shift",
+			"Alt",
+			"Meta",
+			"AltGraph"
+		]);
+		/** 录制键 → 官方绑定（物理 code + 修饰符；Ctrl/Cmd 同为 primary，与官方互认语义一致）。 */
+		function bindingFromEvent(e) {
+			const modifiers = [];
+			if (e.ctrlKey || e.metaKey) modifiers.push("primary");
+			if (e.altKey) modifiers.push("alt");
+			if (e.shiftKey) modifiers.push("shift");
+			return {
+				code: e.code,
+				modifiers
+			};
+		}
+		/** 目录行展示键位（keys 已按平台格式化；binding null = 未绑定）。 */
+		function keysText(row) {
+			if (!row || row.binding === null) return "未绑定";
+			return row.keys.join(" ");
+		}
+		/** 插件命令行 = COMMANDS 目录序 × 官方目录行（行缺失时占位「未注册」）。 */
+		function catalogRowsOf(service) {
+			const byId = new Map(service.catalog.getSnapshot().map((row) => [row.id, row]));
+			return COMMANDS.map((command) => ({
+				id: command.id,
+				label: command.label,
+				row: byId.get(command.id) ?? null
+			}));
+		}
+		/**
+		* 「快捷键」设置区主体：子页切换 + 服务就绪探测（晚到自愈，有界重试）。
+		* @author ddj 2026年10月
+		* @param props.getShortcuts 官方服务运行时探测函数（client/index.ts 注入）
+		*/
+		function ShortcutSettings(props) {
+			const getShortcuts = props?.getShortcuts;
+			const [service, setService] = react.default.useState(() => typeof getShortcuts === "function" ? getShortcuts() : null);
+			const [tab, setTab] = react.default.useState("official");
+			const [, setVersion] = react.default.useState(0);
+			react.default.useEffect(() => {
+				if (service) return void 0;
+				let attempts = 0;
+				let cancelled = false;
+				const tick = () => {
+					if (cancelled) return;
+					const found = typeof getShortcuts === "function" ? getShortcuts() : null;
+					if (found) {
+						setService(found);
+						return;
+					}
+					if (attempts >= 15) return;
+					attempts += 1;
+					setTimeout(tick, 2e3);
+				};
+				tick();
+				return () => {
+					cancelled = true;
+				};
+			}, [service]);
+			react.default.useEffect(() => {
+				if (!service) return void 0;
+				const bump = () => setVersion((v) => v + 1);
+				const offCatalog = service.catalog.subscribe(bump);
+				const offConfig = service.config.subscribe(bump);
+				return () => {
+					offCatalog();
+					offConfig();
+				};
+			}, [service]);
+			let body;
+			if (!service) body = react.default.createElement("div", { className: "vsm-mcp-empty" }, "官方快捷键服务未就绪（正在探测；若长期无响应，说明当前 DSH 版本不含官方快捷键机制）。");
+			else if (tab === "plugin") body = react.default.createElement(PluginShortcutEditor, { service });
+			else body = react.default.createElement(OfficialShortcutsPane, { service });
+			return react.default.createElement("section", { className: "vsm-general-page" }, react.default.createElement("header", { className: "vsm-mcp-header" }, react.default.createElement("div", null, react.default.createElement("h2", null, "快捷键"), react.default.createElement("p", null, "基于官方 shortcuts 机制：统一注册、冲突校验、按平台差异化默认值；Desktop 持久化到 userData/keybindings.json，Web 持久化到 localStorage（dsh.keybindings.v1）。"))), react.default.createElement("nav", { className: "vsm-mcp-subtabs" }, react.default.createElement("button", {
+				className: tab === "official" ? "active" : "",
+				onClick: () => setTab("official")
+			}, "官方快捷键"), react.default.createElement("button", {
+				className: tab === "plugin" ? "active" : "",
+				onClick: () => setTab("plugin")
+			}, "插件快捷键")), body);
+		}
+		/** 官方目录行（只读总览行）。 */
+		function OfficialRow({ row }) {
+			return react.default.createElement("div", { className: "vsm-kb-row" }, react.default.createElement("div", { className: "vsm-kb-label" }, react.default.createElement("span", null, row.label), react.default.createElement("small", null, row.id), row.modified && react.default.createElement("small", { className: "vsm-kb-warn" }, "已自定义"), row.issue && react.default.createElement("small", { className: "vsm-kb-warn" }, "键位不受当前环境支持"), row.conflicts.length > 0 && react.default.createElement("small", { className: "vsm-kb-warn" }, "与 " + row.conflicts.join("、") + " 冲突")), react.default.createElement("kbd", { className: "vsm-kb-key" + (row.conflicts.length ? " warn" : "") }, keysText(row)));
+		}
+		/** 子页一：官方快捷键（弹窗入口 + 目录总览）。 */
+		function OfficialShortcutsPane({ service }) {
+			const [error, setError] = react.default.useState("");
+			const rows = service.catalog.getSnapshot();
+			const config = service.config.getSnapshot();
+			const openOfficial = () => {
+				setError("");
+				if (!service.registry || typeof service.registry.invoke !== "function") {
+					setError("官方弹窗入口不可用；可按 Ctrl+/ 或到 设置 → 通用 → 快捷键 打开");
+					return;
+				}
+				try {
+					service.registry.invoke("shortcuts.open", {
+						region: "page",
+						modal: null,
+						target: typeof document !== "undefined" ? document.activeElement : null
+					});
+				} catch (e) {
+					settingsLog.warn("打开官方快捷键弹窗失败：" + String(e));
+					setError("打开官方弹窗失败：" + String(e) + "；可按 Ctrl+/ 或到 设置 → 通用 → 快捷键 打开");
+				}
+			};
+			return react.default.createElement(react.default.Fragment, null, react.default.createElement("section", { className: "vsm-panel" }, react.default.createElement("h3", { className: "vsm-panel-title" }, "官方快捷键配置"), react.default.createElement("div", { className: "vsm-panel-body" }, react.default.createElement("p", null, "官方快捷键弹窗（Ctrl+/ 或 设置 → 通用 → 快捷键）提供全部命令的查看、录键与恢复默认；下方为当前目录只读总览（含插件注册的命令）。"), react.default.createElement("button", {
+				className: "vsm-primary vsm-small",
+				onClick: openOfficial
+			}, "打开官方快捷键设置（Ctrl+/）"), error && react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, error), config?.status === "unreadable" && react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, "快捷键配置读取失败（内容损坏或由更新版本写入），当前使用默认键位；请备份后清理配置，或升级 DSH。"))), react.default.createElement("section", { className: "vsm-panel" }, react.default.createElement("h3", { className: "vsm-panel-title" }, "命令目录（只读总览）"), react.default.createElement("div", { className: "vsm-panel-body" }, react.default.createElement("div", { className: "vsm-kb-list" }, rows.map((row) => react.default.createElement(OfficialRow, {
+				key: row.id,
+				row
+			}))))));
+		}
+		/** 子页二：插件命令键位（行内录键 + 行级清除 + 恢复默认；写入走官方 edit API）。 */
+		function PluginShortcutEditor({ service }) {
+			const [recording, setRecording] = react.default.useState(null);
+			const [busy, setBusy] = react.default.useState(false);
+			const [message, setMessage] = react.default.useState("");
+			const [error, setError] = react.default.useState("");
+			const rows = catalogRowsOf(service);
+			const config = service.config.getSnapshot();
+			const saveBinding = async (id, binding) => {
+				setBusy(true);
+				setError("");
+				setMessage("");
+				const buildEdit = () => binding === null ? {
+					type: "reset",
+					id
+				} : {
+					type: "set",
+					id,
+					binding
+				};
+				try {
+					const result = await service.edit(buildEdit(), service.config.getSnapshot().revision);
+					if (result.status === "saved") setMessage("已保存");
+					else if (result.status === "stale") setError("快捷键配置已在其他窗口更新，请检查当前键位后重新录制");
+					else if (result.status === "conflict") {
+						if (result.issue) setError("键位被官方拒绝：" + ({
+							"unsupported-browser": "web 模式白名单外的组合（单修饰符组合在浏览器环境不可靠）",
+							"reserved": "官方保留键",
+							"unsupported-key": "官方不支持的键",
+							"modifier-required": "至少需要一个修饰键"
+						}[result.issue] ?? result.issue) + "。web 模式可用 Ctrl+Alt+X 风格组合；升级桌面外壳进入桌面模式后不受此限。");
+						else setError("键位冲突：与 " + (result.conflicts?.join("、") ?? "其他命令") + " 冲突，请换一个组合");
+					} else if (result.status === "not-ready") setError("快捷键配置尚未就绪，请稍后重试");
+					else if (result.status === "unreadable") setError("快捷键配置读取失败，编辑已禁用（见官方提示）");
+					else setError("写入失败，请重试");
+				} catch (e) {
+					settingsLog.warn("快捷键保存失败：" + String(e));
+					setError("保存失败：" + String(e));
+				} finally {
+					setBusy(false);
+				}
+			};
+			const resetAll = async () => {
+				if (!window.confirm("恢复全部插件快捷键为默认值？（只影响本插件命令的键位覆盖）")) return;
+				setBusy(true);
+				setError("");
+				setMessage("");
+				try {
+					const result = await resetPluginKeys(service);
+					if (result.failed) setError("已恢复 " + result.reset + " 条，" + result.failed + " 恢复失败；请重试");
+					else setMessage("已恢复 " + result.reset + " 条插件快捷键");
+				} catch (e) {
+					settingsLog.warn("快捷键恢复默认失败：" + String(e));
+					setError("恢复失败：" + String(e));
+				} finally {
+					setBusy(false);
+				}
+			};
+			react.default.useEffect(() => {
+				if (!recording) return void 0;
+				const onKey = (e) => {
+					e.preventDefault();
+					e.stopPropagation();
+					if (e.key === "Escape") {
+						setRecording(null);
+						return;
+					}
+					if (e.key === "Backspace" || e.key === "Delete") {
+						const id = recording;
+						setRecording(null);
+						saveBinding(id, null);
+						return;
+					}
+					if (MODIFIER_ONLY.has(e.key)) return;
+					const id = recording;
+					setRecording(null);
+					saveBinding(id, bindingFromEvent(e));
+				};
+				window.addEventListener("keydown", onKey, true);
+				return () => window.removeEventListener("keydown", onKey, true);
+			}, [recording]);
+			react.default.useEffect(() => {
+				if (!service || typeof service.recording !== "function") return void 0;
+				service.recording(Boolean(recording)).catch(() => {});
+				return () => {
+					if (recording) service.recording(false).catch(() => {});
+				};
+			}, [recording, service]);
+			const rowsView = rows.map(({ id, label, row }) => {
+				const recordingRow = recording === id;
+				const display = recordingRow ? react.default.createElement("span", { className: "vsm-kb-rec" }, "按下组合键…（Esc 取消 / Backspace 清除）") : react.default.createElement("kbd", { className: "vsm-kb-key" + (row && row.conflicts.length ? " warn" : "") }, keysText(row));
+				return react.default.createElement("div", {
+					key: id,
+					className: "vsm-kb-row" + (recordingRow ? " rec" : "")
+				}, react.default.createElement("div", { className: "vsm-kb-label" }, react.default.createElement("span", null, label), row === null && react.default.createElement("small", { className: "vsm-kb-warn" }, "未注册（官方服务未同步）"), row && row.modified && react.default.createElement("small", { className: "vsm-kb-warn" }, "已自定义"), row && row.conflicts.length > 0 && react.default.createElement("small", { className: "vsm-kb-warn" }, "与 " + row.conflicts.join("、") + " 冲突")), display, react.default.createElement("div", { className: "vsm-kb-actions" }, recordingRow ? react.default.createElement("button", { onClick: () => setRecording(null) }, "取消") : react.default.createElement(react.default.Fragment, null, react.default.createElement("button", {
+					disabled: busy || config?.status !== "ready",
+					onClick: () => {
+						setRecording(id);
+						setMessage("");
+					}
+				}, "编辑"), react.default.createElement("button", {
+					disabled: busy || config?.status !== "ready",
+					title: "清除该命令的键位（恢复默认）",
+					onClick: () => void saveBinding(id, null)
+				}, "清除"))));
+			});
+			return react.default.createElement("section", { className: "vsm-panel" }, react.default.createElement("h3", { className: "vsm-panel-title" }, "插件命令键位"), react.default.createElement("div", { className: "vsm-panel-body" }, react.default.createElement("div", { className: "vsm-kb-list" }, rowsView)), react.default.createElement("div", { className: "vsm-panel-body vsm-kb-actionsbar" }, react.default.createElement("span", { className: "vsm-kb-dirty" }, recording ? "录制中…" : ""), message && react.default.createElement("span", { className: "vsm-kb-message" }, message), error && react.default.createElement("span", { className: "vsm-kb-warn" }, error), react.default.createElement("button", {
+				className: "vsm-small",
+				disabled: busy || config?.status !== "ready",
+				onClick: () => void resetAll()
+			}, "恢复默认")));
+		}
+		//#endregion
 		//#region src/client/sessionScope.ts
 		/** 对象窄化（非对象返回 undefined，供后续安全取字段）。 */
 		function asRecord(value) {
@@ -31869,29 +32420,30 @@ window.__ModuleLoader__.load({
 			"sessions",
 			"conversation"
 		];
-		/** 指令桥装配幂等标记（同一 document 重复 apply 只装配一次，避免重复键位监听）。 */
-		let commandsMounted = false;
+		/** 指令桥单例（同一 document 重复 apply 只装配一次；HMR 重挂不重复注册）。 */
+		let commandsBridge = null;
 		/**
 		* 装配指令注册表（指令桥 + 命令栏）。
 		* 指令桥不依赖已挂载编辑器（run 只派发窗口事件），故可在启动期装配；
 		* 命令栏浮层的宿主由 CommandPalette 自己在编辑区树内认领。
-		* @author ddj 2026年09月10号
+		* @author ddj 2026年09月10号 / 2026年10月
 		* @param ctx 客户端根上下文
-		* @returns void
+		* @returns 指令桥（官方 shortcuts 注册的执行器来源）
 		*/
 		function setupCommands(ctx) {
-			if (commandsMounted) return;
-			commandsMounted = true;
+			if (commandsBridge) return commandsBridge;
 			const bridge = createCommandBridge();
+			commandsBridge = bridge;
 			ctx.provide(REGISTRY_GLOBAL, bridge.registry);
 			const host = window;
 			host[REGISTRY_GLOBAL] = bridge.registry;
 			ctx.effect(() => () => {
 				bridge.dispose();
-				commandsMounted = false;
+				commandsBridge = null;
 				if (host["__edrvCommands__"] === bridge.registry) delete host[REGISTRY_GLOBAL];
 			}, "vscode-mode: command registry");
 			log.info("指令系统已装配：" + bridge.registry.list().length + " 条指令，Ctrl+Shift+P 打开命令栏");
+			return bridge;
 		}
 		/**
 		* 装配客户端：注册中央编辑区视图与 header 差异角标。
@@ -31929,7 +32481,7 @@ window.__ModuleLoader__.load({
 					restore?.();
 				};
 			}, "vscode-mode: settings document editor route");
-			setupCommands(ctx);
+			const commands = setupCommands(ctx);
 			const registry = createFileOpenerRegistry();
 			const workspaces = ctx.get("workspaces");
 			const sessions = ctx.get("sessions");
@@ -32084,6 +32636,18 @@ window.__ModuleLoader__.load({
 					claimDisposer = null;
 				}
 			};
+			const legacyDefaults = defaultKeybindings();
+			let officialReady = false;
+			/**
+			* 获取旧版快捷键覆盖；设置桥尚未就绪时回退默认键位。
+			* @author ddj 2026年09月28号
+			* @returns 旧版键位弦表
+			*/
+			const legacyChords = () => ({
+				...legacyDefaults,
+				...normalizeKeybindings(bridge.scope()?.getSnapshot().value?.keybindings)
+			});
+			applyOfficialChords(legacyChords());
 			let settingsSyncMounted = false;
 			const mountSettingsSyncs = () => {
 				if (settingsSyncMounted) return;
@@ -32105,7 +32669,7 @@ window.__ModuleLoader__.load({
 					const sync = () => {
 						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);
@@ -32118,6 +32682,53 @@ window.__ModuleLoader__.load({
 			};
 			mountSettingsSyncs();
 			if (!settingsSyncMounted) ctx.effect(() => bridge.whenReady(mountSettingsSyncs), "vscode-mode: settings bridge wait");
+			ctx.effect(() => {
+				let cancelled = false;
+				let disposeRegistration = null;
+				let disposeCatalog = 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 = () => {
+							if (cancelled) return;
+							const scope = bridge.scope();
+							if (!scope) {
+								if (attempts < 15) {
+									attempts += 1;
+									schedule(attemptMigration, 2e3);
+								}
+								return;
+							}
+							migrateLegacyKeybindings(service, scope).then((result) => {
+								if (cancelled || result.done) return;
+								if (attempts < 15) {
+									attempts += 1;
+									schedule(attemptMigration, 2e3);
+								}
+							});
+						};
+						attemptMigration();
+					}
+				});
+				return () => {
+					cancelled = true;
+					cancelProbe();
+					disposeLegacy();
+					disposeRegistration?.();
+					disposeCatalog?.();
+				};
+			}, "vscode-mode: official shortcuts");
 			if (workspaces?.openPath) ctx.effect(() => installOpenPathRouter({
 				workspaces,
 				registry,
@@ -32332,6 +32943,12 @@ window.__ModuleLoader__.load({
 				openerRegistry: registry,
 				compatSummary
 			})));
+			registerSlotSafely(ctx, {
+				name: "settings.section",
+				id: "vscode-mode-shortcuts",
+				order: 31,
+				label: "快捷键"
+			}, () => react.default.createElement(ShortcutSettings, { getShortcuts: () => detectShortcuts(ctx) }));
 			ctx.effect(() => () => {
 				try {
 					disposeSnippets();