dsh-hotkeys-platform

如何配置快捷键（用户教程）

入口一：设置页（推荐）

1. 打开 DSH 设置（左下角齿轮图标）。
2. 左侧导航选择「快捷键」分区。
3. 页面按分组列出所有插件注册的动作，每个动作显示标题、描述、动作 id 与当前生效键。
4. 配置操作（可视化点选 + 键盘录制，两条路写同一份绑定）：
   • 编辑（可视化）：点动作右侧「编辑」展开组合键编辑器——
     • 修饰键：勾选 Ctrl / ⌘/Win / Alt/⌥ / Shift（多选）；
     • 主键：下拉选常用键（Enter、Space、Tab、Esc、方向键、F1-F12…），或直接输入任意键名；
     • 预览实时显示拼出的组合键，点「保存」生效，「清除」回到默认键；
     • 好处：能配「浏览器保留键」（如 Cmd+W、Ctrl+T 录不到但可手工拼）、能精确微调单个修饰键。
   • 录制（快捷）：点「录制」→ 提示「请按下新的组合键」→ 直接按键即完成。Esc 取消；15 秒无操作自动取消。
   • 禁用：点「禁用」，该动作完全关闭（连默认键也不再触发）。
   • 已改过的动作会出现「禁用」按钮；未改过的动作使用默认键。

入口二：/hotkeys 命令

1. 在消息输入框输入 /hotkeys。
2. 弹出菜单列出所有动作及当前键。
3. 选「🎙 录制「xxx」键」→ 按下组合键。

组合键语法

• 格式：修饰键 + 主键，用 + 连接，如 Control+Shift+Enter。
• 修饰键别名（任选一种写法）：

修饰键	别名
Ctrl	Ctrl / Control / ⌃
Meta	Meta / Cmd / Command / Win / ⌘
Shift	Shift / ⇧
Alt	Alt / Option / ⌥

• 单字符主键自动大写；空格键写作 Space。

键位三态

状态	含义
未改过	使用动作声明的默认键（defaultKey）
已录制	使用你设置的键
已禁用	完全不触发

冲突说明

当多个动作绑定了同一个组合键，先注册的动作优先触发；冲突的动作在设置页会红色高亮，请改绑其中一个避免歧义。

---