前言¶
在 DeepSeek Harness Desktop 里装插件、改配置之后，快捷键往往分散在宿主目录与各插件说明里，实际窗口里注册了哪些组合键，并不总有一张和当前环境一致的清单。自己维护一份按键表，还要跟版本和语言同步，成本偏高。
DSH Easy Hotkey（@metaone01/dsh-easy-hotkey）由社区维护者 metaone01 发布，归类为客户端插件。它借鉴 PowerToys「长按唤出快捷键指南」的交互思路，在已安装本插件的 DSH 应用窗口内读取宿主真实注册的快捷键，用浮层展示，并支持搜索、临时固定与亮暗主题。下文介绍其定位、能力与安装用法；事实以 GitHub 仓库 README 为准。
这是什么¶
DSH Easy Hotkey 是面向 DSH Desktop 的轻量插件：默认长按 Ctrl 约 650 ms 展开半透明快捷键浮窗，只在当前窗口生效，不注册系统全局快捷键。文案随宿主语言在中英之间切换；主题可选亮色、暗色或跟随系统。
插件通过宿主提供的快捷键、语言与界面服务挂载到 shell.overlay 槽位，展示的是当前宿主可配置与固定快捷键目录，而不是一份写死的按键表。不同 profile、插件组合与 DSH 版本下，列表内容会不同。
核心功能¶
真实目录，按需出现¶
浮窗直接反映宿主已注册的快捷键，随目录、描述和语言变化更新。唤出方式支持两种显示模式：
| 模式 | 松开唤出键后 | 关闭方式 |
|---|---|---|
| 切换（默认） | 保持展开 | 点击非交互区域、Esc，或再次完成长按 |
| 长按 | 立即关闭（临时固定时除外） | 松开唤出键、点击非交互区域，或 Esc |
右下角有键帽式提示：蓄力时边框逐渐填满；展开或临时固定时样式与文案会切换。鼠标进入提示周围约 48 px 时提示淡出，避免挡住点击。
在长按模式下，点击设置或搜索区域会立即临时固定，无需先输入文字；在设置或搜索区内操作控件时保持固定，收起设置或焦点离开相关区域后恢复长按逻辑。
三种搜索¶
底部可切换搜索模式，切换或收起设置不会清空已有条件：
| 模式 | 输入方式 | 筛选方式 |
|---|---|---|
| 搜索功能 | 输入功能名称 | 仅匹配功能描述 |
| 搜索按键 | 在按键区直接按下键或组合键 | 匹配包含该组合的快捷键 |
| 功能＋按键 | 同时填写功能名与录制按键 | 两条件共同筛选；缺一则只用另一条件 |
按键以键帽显示；新一轮按键会替换上一组录制。按键搜索期间会抑制宿主应用快捷键，避免误触发命令；Esc 仍用于关闭浮窗。
自定义设置¶
搜索栏左侧的设置按钮展开四项配置：
| 设置 | 说明 |
|---|---|
| 显示模式 | 切换 / 长按，默认切换 |
| 长按时长 | 0–5000 ms，默认 650 ms；0 表示立即唤出 |
| 唤出按键 | 单键或修饰键组合，默认 Ctrl；可录制，冲突组合会被拒绝 |
| 主题 | 亮色 / 暗色 / 跟随系统 |
设置保存在当前应用 origin 的 localStorage，刷新后保留。普通键作为唤出键时，在输入框、可编辑区域和终端中不触发，减少误唤出。
能力边界（使用前须知）¶
- 仅限 DSH 应用窗口，不为其他应用拦截按键。
- 只展示宿主已注册内容，不会发现未注册插件或系统外的快捷键。
- README 写明：目前有 Windows DSH Desktop 用户手动验收记录；macOS / Linux 键帽标签未作同等级实机验收声明。
- 插件随当前 DSH 进程与窗口权限运行；安装前可在 GitHub 查看源码与 MIT License。
安装与启用¶
这是 DSH Desktop 插件，需要带插件管理入口及快捷键、语言、界面服务的 DSH Desktop。宿主未声明经完整验证的最低版本；若提示服务缺失，请先更新 DSH。React 由宿主提供，普通用户无需克隆仓库或本地构建。
从 npm 安装¶
在 DSH 插件管理入口输入：
@metaone01/dsh-easy-hotkey@0.1.0
安装后确认插件已启用。若当前窗口未加载插件，请完整退出并重新打开 DSH Desktop，再长按 Ctrl 650 ms 验证；重启前留意正在执行的任务。
本地安装包（可选）¶
在支持本地包的插件管理入口填写 .tgz 的绝对路径，例如：
C:/Downloads/metaone01-dsh-easy-hotkey-0.1.0.tgz
包内已含构建产物，无需再执行构建脚本。
典型用法¶
- 在 DSH 窗口中按住 Ctrl，观察右下角键帽边框蓄力。
- 达到默认 650 ms 后浮窗展开（左右 Ctrl 均可）。
- 在底部按功能名搜索，或切换为按键 / 组合搜索；需要改模式、时长、唤出键或主题时，点左侧设置。
- 点击浮窗空白、说明文字或按 Esc 关闭。
打开时焦点在快捷键列表而非搜索框，因此不会一打开就进入输入或临时固定。列表支持滚轮；按住 Ctrl 时不会因页面缩放干扰浏览。
示例：想找「新会话」相关操作，在功能搜索中输入关键词；想找含 Enter 的绑定，在按键模式中直接按 Enter；要进一步缩小范围，在「功能＋按键」中同时填关键词并录制 Ctrl 等组合。
适用场景¶
适合经常在 DSH Desktop 里切换功能、但又不想背整张快捷键表的开发者与日常用户：需要查键时长按唤出，查完即关，不打断当前窗口上下文。
不适合期望系统级快捷键大全或跨应用统一的场景；其他顶层窗口或跨源 iframe 需单独安装本插件才会出现同一套浮层行为。
问题与建议可提交至 GitHub Issues。插件目录页：SkillHub — metaone01/dsh-easy-hotkey；源码与完整说明：github.com/metaone01/dsh-easy-hotkey。
