blue-a11y/dsh-client-shortcuts ↗★ 1

@blue-a11y/dsh-client-shortcuts

为网页端提供全局快捷键注册与改键设置页 适合习惯键盘流操作,需要快速切换会话、聚焦输入框的效率用户。

包名
@blue-a11y/dsh-client-shortcuts
兼容性
待验证
Harness 依赖范围
^0.1.0-rc.6
Cordis 依赖范围
^4.0.1
版本
0.1.0
许可证
MIT
最近更新
2026年8月14日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:blue-a11y/dsh-client-shortcuts

安装(给使用本插件的用户)

前置

  • 已安装 dsh CLI(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 生命周期内有效——刷新页面恢复默认(持久化存储属于后续阶段)。

![快捷键设置页](https://raw.githubusercontent.com/blue-a11y/dsh-client-shortcuts/1720db39a0db41a1a8bc92705792b051c03b1273/docs/images/settings-page.png)

---