blue-a11y/dsh-client-shortcuts ↗★ 1
@blue-a11y/dsh-client-shortcuts
Global keyboard shortcuts plugin for the DeepSeek Harness web GUI: ctx.shortcuts registry service, rebindable settings page, and default mod+l/mod+k/mod+shift+c bindings 适合习惯键盘流操作,需要快速切换会话、聚焦输入框的效率用户。
설치
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:blue-a11y/dsh-client-shortcuts安装(给使用本插件的用户)
前置
- 已安装
dshCLI(npm i -g @deepseek-ai/dsh) - Node ≥ 22.19 与 pnpm 就绪
安装
本包是一个组合包(声明了 dsh.bundle),安装即自动激活其配置层。推荐从 npm 安装(预构建产物,零安装授权):
dsh plugin --profile web add @blue-a11y/dsh-client-shortcuts
其他方式:
## 使用
### 可绑定动作
| 动作 | 默认键位 | 输入框内可用 |
| --- | --- | --- |
| 聚焦输入框 | `cmd+l` | — |
| 新建会话 | `cmd+shift+k` | ✅ |
| 切换侧栏 | `cmd+b` | ✅ |
| 切换详情面板 | `cmd+shift+e` | ✅ |
| 上一个会话 | `cmd+[` | ✅ |
| 下一个会话 | `cmd+]` | ✅ |
| 切换浅色/深色主题 | 未绑定 | — |
| 滚动到对话顶部 | 未绑定 | — |
| 滚动到对话底部 | 未绑定 | — |
| 分叉当前会话 | 未绑定 | — |
会话切换镜像侧栏的完整显示顺序(工作区按注册表顺序、组内按最近活动排序、未分组桶垫底),跳过「新建任务」空白条目与归档会话,并在两端**循环**(到底再切回第一个)。
### 改键与键位约束
无安全默认值的动作默认不绑定;在设置页录制组合键即可启用,重置则清回未绑定。
设置页会拒绝两类**永远无法触发**的组合键:
- **浏览器保留组合键**(`cmd+n/t/w`、`cmd+shift+n/t/w/i/j/c`、`cmd+alt+i/j/u`):它们在页面监听器 `preventDefault` 之前就被浏览器消费,web 插件绑不住(Codex 这类桌面应用可以,所以它的键位不能照搬)。
- **macOS 的 Option/Alt 改写组合**:Option 会改写产出字符(`cmd+alt+c` 实际是 `ç`),导致 `event.key` 与注册键不再匹配。
### 设置页
打开 设置 → 快捷键。每行展示动作、当前组合键与触发计数。录制控件会暂停注册中心分发(按下的组合键被捕获而不是触发),校验与现有绑定的冲突并拒绝非法组合键。改键仅在插件 fiber 生命周期内有效——刷新页面恢复默认(持久化存储属于后续阶段)。

---