前言¶
在使用 DeepSeek Harness (DSH) 桌面端进行开发或调试时，有时需要重启应用以清理内存状态或应用更新。常规的关闭方式可能导致进程残留或端口占用问题。dsh-restart-hotkey 插件通过自定义快捷键，实现了应用的安全平滑重启。
插件介绍¶
dsh-restart-hotkey 是由用户 hfbcwhy7gh-cpu 开发的一款 DSH 桌面端插件。它旨在解决手动重启应用带来的操作繁琐问题，通过一个快捷键即可完成彻底的进程关闭与系统句柄/端口释放，随后重新拉起应用。
核心功能¶
该插件主要包含以下能力：
-
安全稳定的应用无缝平滑重启
插件会彻底关闭原有的 Electron 主进程及所有常驻子进程，在释放系统句柄与端口锁定后，通过 Windows Shell 独立拉起新的DeepSeek Harness.exe，避免父子进程生命周期锁定导致的重启失败。 -
应用内专属生效
快捷键仅在 DSH 窗口处于激活前台焦点状态时生效。这避免了与系统其他全局热键或常用软件（如 VS Code、IDEA）发生冲突。 -
支持完全自定义快捷键
默认快捷键为Ctrl+Shift+R。- 动态录制：在设置页面点击“录制按键”后，直接敲击键盘组合键即可自动保存。
- 预设切换：支持在常用预设（如
Alt+R、F9、Ctrl+Alt+R）中一键切换。
-
防误触二次确认弹窗
按下快捷键时，会弹出确认对话框，提供“确认重启”和“取消”选项。弹窗底部也提供了“更改快捷键”的入口，方便即时调整。支持勾选“下次直接重启，无需确认”。 -
多处无缝设置入口
配置项不仅嵌入在 DSH 的【设置】→【通用】页面中，还提供了独立的设置卡片，并与插件管理生态保持一致。
安装与启用¶
安装前请确保环境满足要求：Node.js 版本 >= 20，DSH 版本 >= 0.2.0-rc.2，且当前平台支持 Windows。
方式一：目录链接安装（推荐开发调试）¶
- 将项目 clone 或解压到本地目录。
- 打开 DSH 桌面端，点击左侧栏的「插件」。
- 选择「安装插件」，填入项目目录的绝对路径并重启 DSH。
方式二：打包安装 (npm pack)¶
- 在项目根目录下执行命令：
npm pack
- 在 DSH 桌面端「插件」→「安装」中，填入生成的
.tgz压缩包路径即可。
典型用法¶
安装完成后，进入 DSH【设置】→【通用】或【快捷重启】页面。
- 基础重启：在 DSH 窗口激活状态下，按下默认快捷键
Ctrl+Shift+R，确认弹窗后即可重启。 - 录制新快捷键：点击设置页面的“录制按键”按钮，保持焦点在 DSH 窗口内，直接敲击键盘组合键，系统会自动识别并保存。
- 调整配置：在弹窗底部直接点击“更改快捷键”或在设置面板中调整“重启前弹窗二次确认”选项。
适用场景与注意¶
- 适用场景：需要频繁重启 DSH 应用以重置状态、清理端口占用的开发调试场景。
- 权限与安全：插件以 DSH 进程权限运行，安装前建议查看源码以确保安全性。项目采用 MIT 许可证开源。
总结¶
dsh-restart-hotkey 通过封装进程管理逻辑，为 DSH 桌面端提供了类似 IDE 热重载的快捷操作体验。它兼顾了灵活的按键自定义与操作安全性，适合追求高效开发流程的工程师使用。
