dsh-keyboard-manager：DeepSeek Harness Web UI 键盘快捷键

DeepSeek Harness (DSH) Web UI 侧重于插件化架构，但在日常使用中，开发者仍需频繁通过鼠标点击来切换侧边栏或打开设置。dsh-keyboard-manager 通过监听键盘事件，将常用的 UI 操作映射为快捷键，减少鼠标交互频率。

插件概况¶

插件提供了三个默认快捷键，通过一个监听器统一处理，并根据页面状态路由到对应的 UI 元素。

Ctrl+Q 切换左侧边栏
直接调用布局服务的切换方法，控制内置左侧边栏的显示与隐藏。
Ctrl+E 切换右侧边栏
智能路由逻辑：
- 若加载了 dsh-better-sidebar 插件，点击右侧面板的切换按钮。
- 若未加载该插件，则切换原生对话详情面板。
- 需要活跃的会话才能触发。
Ctrl+S 打开/关闭设置
- 点击设置触发器按钮以打开模态框。
- 在 dsh-better-sidebar 编辑器聚焦时，该快捷键会透传给编辑器，用于保存操作。
- 关闭设置模态框需按 Escape 键。

使用官方 CLI 命令添加插件到当前 Web 配置文件中。

dsh plugin --profile web add github:Aafff623/dsh-keyboard-manager

安装完成后，建议硬刷新浏览器页面（Ctrl+Shift+R）以确保插件加载生效。

插件支持通过配置文件覆盖默认的按键代码。配置文件路径为 ~/.dsh/profiles/web/cordis.patch.yml。

# ~/.dsh/profiles/web/cordis.patch.yml
- id: dsh-keyboard-manager
  config:
    sidebar: KeyQ
    rightPanel: KeyE
    settings: KeyS

配置项验证规则仅允许 A-Z 字母数字组合，重复或无效的代码将回退到默认值。修改配置后需重启 DSH 并刷新页面。

按键规则：仅支持严格和弦，即仅使用 Ctrl 键，不混用 Cmd、Shift 或 Alt 修饰键。
事件隔离：插件不干扰页面原生事件处理。对于 IME 组合输入、按键自动重复以及已被其他监听器消费的事件，插件会保持静默，避免冲突。
依赖要求：需要 @deepseek-ai/cordis 版本 ^4.0.2 和 DSH Web UI 环境。
可选依赖：dsh-better-sidebar 是可选的。如果未安装，Ctrl+E 会自动回退到原生对话详情面板；Ctrl+S 在编辑器中的保存行为仅在该插件加载时生效。
Headless 配置：在 Headless 配置下无法获取插件配置，插件将直接使用默认按键值。

该插件遵循 DSH 的插件化理念，与 DeepSeek 官方无直接从属关系。源码与文档位于：