前言¶
在 DeepSeek Harness（DSH）里调权限模式、推理强度，或在多轮对话里来回跳输入，往往要点设置或滚界面。DSH 自带快捷键体系，但缺少一块集中查看、改绑、排查冲突的入口；部分组合在桌面端和浏览器里还受平台规则限制。下面介绍的 dsh-keyboard-shortcut（维护者 OZONGO，分类：客户端）在设置面板增加 Keyboard shortcuts 页面，并注册一组可通过 DSH 命令体系重绑的快捷键，可选调整 Composer 的 Enter 行为。
这是什么¶
dsh-keyboard-shortcut 是 DSH 的客户端插件：逻辑运行在浏览器侧，Host 侧仅为空 apply，用于让 DSH 提供浏览器 bundle。它在 Settings 中紧挨 General 之后增加 Keyboard shortcuts，列出运行中的全部绑定；对本插件拥有的命令可点击行、按键组合保存（Esc 取消）。插件申请的快捷键均为普通 DSH 命令，会出现在快捷键参考里，可重绑，冲突规则与内置命令一致。插件不申请提升权限，不访问文件系统，不发网络请求。
- 目录页：skillhub.cn/plugins/OZONGO/dsh-keyboard-shortcut
- 源码与文档：github.com/OZONGO/dsh-keyboard-shortcut
- 许可证：MIT（见仓库 LICENSE）
社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；安装前请自行查看源码与许可证。插件随当前 DSH 配置在客户端运行。
核心功能¶
设置页四个区块¶
- Plugin shortcuts：本插件注册的命令，每行可编辑绑定。
- Input navigation：PgUp / PgDn 两条翻页键；无 command id，设置页只读展示（见下文限制）。
- Input optimisation：Composer Enter 手势轮换开关，默认关闭。
- Application shortcuts：其余已注册命令只读列表，便于理解「某组合已被谁占用」。
默认快捷键（可按平台重绑）¶
| 快捷键 | 作用 | 默认绑定平台 |
|---|---|---|
| Ctrl+Q | 切换到下一权限模式 | 桌面 Windows、macOS |
| Ctrl+1 | 推理强度降一级 | 桌面 |
| Ctrl+2 | 推理强度升一级 | 桌面 |
| Alt+A | 在侧栏浏览器打开 DeepSeek 状态页 | 桌面 |
| Ctrl+L | 展开或收起任务列表 | 桌面 |
| PgUp | 上一个输入（按轮次，锚在用户首条消息） | 全平台（固定，不可在目录中注册） |
| PgDn | 下一个输入 | 全平台（固定） |
| Ctrl+/ | 打开本插件设置页 | 全平台 |
在 macOS 上 Ctrl 通常对应 Cmd。Ctrl+/（或 Cmd+/）原为内置快捷键参考的默认键；本插件通过偏好层接管该键，参考对话框会移走该绑定，仍可从 Settings → General → Edit shortcuts 打开。关闭「接管」开关可恢复内置默认。
Composer 输入优化（可选）¶
开关默认关。开启后 Enter 相关手势轮换为：
| 按键 | 默认行为 | 开启后 |
|---|---|---|
| Enter | 发送 | 换行 |
| Ctrl+Enter | 互补的 Queue/Steer | 发送 |
| Shift+Enter | 换行 | 互补的 Queue/Steer |
实现是在 DOM 层改写修饰键标志，而非重写发送逻辑（详见仓库 docs/design.md）。
本地偏好与绑定存储¶
浏览器 localStorage 键 dsh.keyboard-shortcut.v1（按设备）：
| 键 | 默认 | 含义 |
|---|---|---|
optimizeComposerKeys |
false |
是否轮换 Composer Enter |
takeOverShortcutKey |
true |
是否将 Ctrl+/ 交给本插件 |
在设置页改的绑定与 DSH 自带编辑器共用存储：Web 为 localStorage，Electron 为 userData/keybindings.json。偏好不在 Host 设置文档中，不会跨机器同步。
安装与启用¶
要求 DSH 不低于 0.2.0-rc.2（package 中标注与 0.2.0-rc.2 兼容）。从源码构建需 Node.js >=22.12.0。
在指定 profile 下执行官方安装命令：
dsh plugin --profile <profile> add dsh-keyboard-shortcut
然后重启该 profile，或在 Settings → Plugins 中关闭再打开 bundle（若 profile 支持热重载）。
典型用法¶
- 安装并启用后，打开 Settings → Keyboard shortcuts（或按
Ctrl+//Cmd+/，若未改绑）。 - 在 Plugin shortcuts 中点击某行，按下目标组合保存；若被拒绝，在 Application shortcuts 中查看已占用该组合的命令。
- 桌面端常用：用
Ctrl+Q循环权限模式；用Ctrl+1/Ctrl+2微调 reasoning effort；用Alt+A聚焦已有状态页标签（同会话内复用，不重复开 tab）；用Ctrl+L切换任务列表折叠（无任务列表时会提示而非报错）。 - 长文案编辑：在 Input optimisation 打开 Composer 键映射，用 Enter 换行、Ctrl+Enter 发送。
- 多轮对话：PgUp / PgDn 在轮次轨上跳转（「上一个输入」即上一轮）。
适用场景与注意¶
适合谁：长期在 DSH 桌面或 Web 客户端操作、希望少点鼠标、需要统一查看快捷键冲突的智能体开发者。
平台与限制（摘自 README Known limitations）：
- 权限循环、推理强度、状态页、任务列表五条快捷键在部分环境默认未绑定：非桌面 Windows/macOS 时 DSH 保留
Ctrl+Q；浏览器占用Ctrl+1…Ctrl+8切标签；Alt+A、Ctrl+L可能不在浏览器允许的单修饰键白名单内。五条命令在各平台仍存在，可手动绑定可用组合。 - PgUp/PgDn 未进入 DSH 快捷键注册白名单，插件通过
observeFixedInput监听，设置页只读，无法像普通命令一样改绑。 - 状态页快捷键优先显示当前会话已有浏览器标签；其他会话的标签不会被打断。
- 任务列表快捷键模拟点击面板标题，与 UI 内部状态一致。
- 重绑时会重新注册命令并刷新页面，可能丢失未保存的 React 局部状态。
安装插件前请阅读 GitHub 仓库 与 中文 README；扩展行为以你本机 DSH 版本与 profile 为准。
结尾¶
dsh-keyboard-shortcut 把 DSH 的快捷键从「分散在参考表和 General」收拢到独立设置页，并补上权限模式、推理强度、状态页、任务列表与轮次导航等桌面向热键；可选 Composer 键映射适合习惯 IDE 式换行发送的用户。更多信息见 SkillHub 目录页 与 GitHub：OZONGO/dsh-keyboard-shortcut。
