前言¶

DSH 的插件生态强调「一切皆插件」。在实际使用 DeepSeek Harness WebUI 时，新建会话、切换视图、复制上下文、调整模型与权限等操作常分散在界面菜单中。对需要频繁切换会话、模型和权限的开发者来说，这些操作如果都依赖鼠标，会打断输入节奏。

dsh-shortcuts 是为 DeepSeek Harness 的 WebUI 提供的一套可完全自定义键盘快捷键系统。它把常用功能映射到键盘，并允许用户自行绑定、清除和禁用快捷键。下面介绍它的能力、安装方式和需要注意的事项。

这是什么¶

dsh-shortcuts 由 Ricketts-Guo 维护，许可证为 MIT。它定位为 DSH 的键盘快捷键插件，主要解决 WebUI 中常用操作依赖鼠标和菜单的问题。

该插件以浏览器端为主，不发起网络请求、不触碰业务数据；权限切换通过宿主侧通道直写。它支持 WebUI 会话级动态插件与 Desktop 宿主级静态插件两种形态。

核心功能¶

已核实的功能点包括：

• 34 个预置功能，6 个分组：会话 / 视图 / 剪贴板 / 模型 / 权限 / 系统。
• 任意功能都可录制任意组合键、清除、禁用，并做冲突自动检测。
• 快捷键速查表（⌘/）可查看全部绑定，并打开内置诊断面板。
• ⇧Tab 无留痕权限切换：只读 / 工作区写入 / 完全访问。
• 支持 WebUI 会话级动态插件与 Desktop 宿主级静态插件。
• 浏览器端为主，无网络请求、不触碰业务数据；权限切换经宿主侧路由直写。

这些功能围绕 WebUI 的日常操作展开：快捷键绑定可调整，权限切换为无留痕操作，配置保存在本地浏览器环境。

安装与启用¶

先做一键安装，在终端执行：

curl -fsSL https://raw.githubusercontent.com/Ricketts-Guo/dsh-shortcuts/main/install.sh | bash

这一步完成后，需要完全退出并重新打开 DeepSeek Harness，让插件加载。

更新时重新运行同一安装命令，再重启 DSH 生效：

curl -fsSL https://raw.githubusercontent.com/Ricketts-Guo/dsh-shortcuts/main/install.sh | bash

也可以手动安装。步骤如下：

1、克隆仓库：

git clone https://github.com/Ricketts-Guo/dsh-shortcuts.git ~/dsh-shortcuts

2、编辑 ~/.dsh/profiles/web/package.json，将插件加入该 profile 的依赖配置。

3、执行安装依赖：

cd ~/.dsh/profiles/web && pnpm install

4、重启 DSH。

经过上面的步骤，插件会进入 DSH 的 Web profile 依赖中。

注意：1.1.0 起安装改为 pnpm 托管，node_modules/dsh-shortcuts 是受管副本而非符号链接，不应手动 ln -sfn 覆盖。

典型用法¶

自定义快捷键时，进入「设置 → 快捷键」。点击「录制」后按下任意组合键即绑定；Backspace 清除绑定，Esc 取消录制。

查看全部绑定和诊断面板时，按：

⌘/

进行权限切换时，按：

⇧Tab

会循环切换只读 / 工作区写入 / 完全访问。

卸载静态安装：

cd ~/.dsh/profiles/web && pnpm remove dsh-shortcuts

卸载动态插件可用：

cordis_stop
cordis_undefine

卸载后，自定义配置可能残留在浏览器 localStorage 的键 dsh.shortcuts.v1 中，可在浏览器开发者工具中删除。

开发或修改插件后，可以运行：

npm test

或：

npm run check

测试需要本机装有 DSH；npm test 通过 host node_modules 解析 react。

适用场景与注意¶

适合频繁在 DeepSeek Harness WebUI 中切换会话、视图、模型、权限，并希望减少鼠标操作的开发者。对需要在不同权限级别之间反复切换的工作流尤其有用。

使用前需要注意：插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。项目许可证为 MIT。

配置保存在浏览器 localStorage。权限切换经宿主侧通道直调 permissionPresets；静态版本地 HTTP 路由为 /dsh-shortcuts-permission，仅在部署挂载权限服务时激活，DSH Web 服务应保持 loopback 绑定。

思考强度档位取决于当前模型；权限轮换顺序取决于部署配置的预设表。

该插件的 peerDependencies 包括：

react ^18.2.0
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-client-runtime ^0.1.0-rc.6

会话级动态插件为临时加载，进程重启后失效。

结尾¶

dsh-shortcuts 提供的是可自定义、可诊断、可本地卸载的键盘快捷键层。若主要依赖 WebUI 操作，先安装并验证速查表与权限切换；若需要长期修改源码，再关注 pnpm 受管副本与测试命令。

项目仓库：

https://github.com/Ricketts-Guo/dsh-shortcuts