前言¶
DeepSeek Harness（DSH）里不少操作依赖键盘快捷键。默认组合未必符合个人习惯，而宿主本身未必提供统一的「列出全部绑定、对照默认值、一键改键」入口。若只靠改配置或猜键位，容易与已有命令冲突，或在 Web 与桌面端行为不一致。
下面介绍社区插件 dsh-shortcut-editor（维护者 sezhiyanhua）：在 Settings → 快捷键 / Keyboard shortcuts 增加一页，枚举通过宿主 shortcuts 服务注册的命令，对照默认与当前绑定，录制新组合并支持按项或全部还原。插件分类为客户端，当前 GitHub 星标为 0（以目录页为准）。
这是什么¶
dsh-shortcut-editor 是一个 DSH 客户端插件（package.json 中 dsh.client.platform 为 web，版本 1.0.0，许可证 MIT）。它在设置中挂载「快捷键」页，读写与主程序键位路由相同的 shortcuts 存储（catalog、config、edit、registry），因此修改后一般无需重启进程即可生效。
核心功能¶
README 中列出的能力如下，均已核实：
- 并列对照：每个已注册命令同时显示 default 与 current 绑定。
- 录制改键：点 修改 (Edit) 后按键录入；
Esc取消。录制期间按键不会进入宿主自身的快捷键处理逻辑。 - 状态提示：
已修改（自定义）、冲突（与其他命令冲突）、不可用（系统/浏览器保留或当前平台不支持）。 - 还原：还原 (Restore) 恢复单项默认；全部还原默认 (Restore all defaults) 清空全部自定义。
- 固定键位：只读列出不可重绑的固定序列。
- 搜索：按标签、命令 id、键帽与别名过滤。
- 中英双语：随应用语言切换。
安装与启用¶
官方 README 给出的安装方式为：
dsh plugin --profile <profile> add <this-repo-or-package>
也可在 SkillHub 插件目录 一键安装。安装后重启或刷新 Web GUI，打开 Settings → 快捷键 / Keyboard shortcuts 即可使用。
卸载：
dsh plugin --profile <profile> remove <package-name>
说明：若在卸载前未还原默认，自定义绑定可能仍留在 localStorage 中（见下文存储位置）。
典型用法¶
经过上面的安装与刷新，按下面步骤操作即可复现 README 中的流程：
- 打开 Settings → 快捷键，浏览全部已注册命令及默认/当前绑定。
- 对需要调整的项点 修改，按下目标组合；若组合不合法，页面会就地说明，不会写入。
- 用搜索框缩小列表范围（标签、id、键位等）。
- 单项 还原 或 全部还原默认 恢复出厂键位。
存储与生效（How it works）：
- Web 端绑定保存在
localStorage的dsh.keybindings.v1，按runtime:platformprofile 区分。 - 桌面客户端通过
window.dshDesktop.shortcuts持久化。 - 仅当宿主接受的组合才会保存：至少含一个修饰键、非系统/浏览器保留组合、且键码受支持。
平台差异：
- Web：插件在录制时自行监听
keydown（宿主在 Web 上不做原生按键拦截），录制结束会释放监听。 - 桌面：宿主会调用
recording(true/false)暂停自身快捷键拦截。
适用场景与注意¶
适合谁：经常在 DSH Web GUI 或桌面客户端里用快捷键、且希望可视化改键、避免盲猜配置的智能体开发者或日常用户。
限制（README）：
- 列表只包含经
shortcuts服务注册的命令；未注册命令不会出现。 - 录制与冲突检测依赖当前宿主与平台能力，部分组合会被标为不可用。
安全与许可：插件随当前 DSH 进程的客户端上下文运行；安装前建议在 GitHub 阅读源码与 MIT 许可证。DSH 生态奉行「一切皆插件」；SkillHub 为社区目录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-shortcut-editor 把快捷键管理收敛到设置页：对照默认、录制重绑、冲突与不可用提示、单项或全部还原，并与宿主键位存储一致。需要安装或 issue 时，可参考目录页与仓库：
