前言¶
在 DSH Web 中同时维护多个会话时,切换会话、聚焦搜索框、打开模型选择、归档或重命名会话,通常需要点击侧边栏。当聊天输入框里还有未发送内容时,这种操作会打断输入节奏。
dsh-session-hotkeys 针对这个场景,把常用会话操作映射到键盘快捷键上,让用户在打字状态下也能切换会话。
这是什么¶
dsh-session-hotkeys 是 YEYEYEYESHIFU 维护的 DSH Web 会话快捷键插件,用于给 DeepSeek Harness Web 提供键盘会话管理。
它解决的主要问题是:用键盘在已渲染的会话列表之间切换,并减少在聊天、搜索、模型选择和会话管理之间的鼠标操作。
它是纯浏览器插件,无网络请求、无服务端状态、不收集数据。许可证为 MIT。
核心功能¶
下面介绍已核实的几类能力。
会话切换¶
- 支持
Alt+1-9直达第 N 个会话,Alt+↑/Alt+↓循环切换;这是 Windows 默认,macOS 对应⌃⇧1-9、⌃⌥↑/⌃⌥↓。 - 聊天输入框聚焦时也能切换会话,普通打字不会触发。
- 所有键位都可以在面板中重新绑定,并提供 Windows / macOS 预设。
固定槽位¶
- 支持固定槽位(pin/jump/unpin)与跳转固定槽位。
会话管理与聚焦¶
- 支持新建会话、归档当前会话、打开归档列表、重命名当前会话。
- 支持导航模式、聚焦搜索框、聚焦模型选择、聚焦回聊天输入框,以及替代忙时发送方式。
默认键位¶
以下只列出已核实资料中明确给出的键位。
| 动作 | 键位 |
|---|---|
| 切换到第 N 个会话(Windows) | Alt+1-9 |
| 上一个 / 下一个会话(Windows) | Alt+↑ / Alt+↓ |
| 切换到第 N 个会话(macOS) | ⌃⇧1-9 |
| 上一个 / 下一个会话(macOS) | ⌃⌥↑ / ⌃⌥↓ |
| 新建会话 | Alt+N |
| 归档当前会话 | Alt+Shift+A |
| 打开已归档列表 | Alt+Shift+U |
| 打开面板 | Alt+P |
其他动作的键位均可在面板中重新绑定;Windows / macOS 预设已在资料中提及,但已核实资料未逐项列出所有默认键位。
安装与启用¶
使用 dsh plugin¶
先执行安装命令,再重启 DSH Web:
dsh plugin --profile web add "dsh-session-hotkeys"
经过上面的步骤后,重启 DSH Web 即可启用。
旧版 CLI¶
如果旧版 CLI 中没有 dsh plugin 子命令,按下面步骤处理:
1、在 profile 的 package.json 中,将 dsh-session-hotkeys 加入 dependencies 与 dsh.profile.bundles。
2、在 profile 目录中运行:
pnpm install
3、重启 DSH。
典型用法¶
安装后重启 DSH Web,即可按默认键位使用:
1、确保侧边栏已展开,因为切换依赖侧边栏展开状态,显示顺序读取已渲染的侧边栏行。
2、按 Alt+1-9 切换到第 N 个会话;按 Alt+↑ / Alt+↓ 切换到上一个 / 下一个会话。
3、macOS 上使用 ⌃⇧1-9 切换到第 N 个会话;使用 ⌃⌥↑ / ⌃⌥↓ 切换到上一个 / 下一个会话。
4、按 Alt+N 新建会话,按 Alt+Shift+A 归档当前会话,按 Alt+Shift+U 打开已归档列表。
5、按 Alt+P 打开面板,在按键页重新录制键位。
改键支持字母、反引号、F1-F12 与数字 1-9;使用小键盘数字时,需要开启 NumLock。
开发自检¶
如需运行开发自检,先克隆仓库,再运行自检命令:
git clone https://github.com/YEYEYEYESHIFU/dsh-session-hotkeys.git
cd dsh-session-hotkeys
npm run verify
适用场景与注意¶
- 适合在 DSH Web 中维护多个会话、希望减少鼠标操作的使用者。
- 插件以当前 DSH 进程权限运行;安装前应检查源码、许可证和权限声明。
package.json中声明的权限包括:ui:sidebar、ui:session、browser:keyboard、dom:read、storage:localstorage。 - 已在
@deepseek-ai/dsh@0.1.1-rc.2的 DSH Web 上测试,最后验证时间为 2026-08-23。package.json版本为1.6.0,compatibility中dshVersions为0.1.1-rc.2。 - 会话顺序、搜索框和模型选择定位依赖 DSH Web DOM 类名;DSH 升级后可能需要更新插件。
- 键位与固定关系保存在浏览器
localStorage;清除站点数据会重置。 - 归档操作有确认且从不删除;DSH
0.1.1-rc.2无公开取消归档接口,恢复需宿主端操作。 - Windows 下为避免 Chrome 吞掉
Alt+数字,输入框内小键盘 Alt 码(如Alt+0167)不可用。
结尾¶
经过上面的介绍,dsh-session-hotkeys 的价值在于:把 DSH Web 中常见的会话切换、会话管理和聚焦操作集中到键盘上,并在聊天输入框聚焦时仍然可用。如果你主要在 DSH Web 中处理多个会话,可以按上面的安装步骤启用,并根据面板重新绑定键位。
GitHub:https://github.com/YEYEYEYESHIFU/dsh-session-hotkeys
目录页:已核实资料中未提供可用 URL。