dsh-restart-hotkey

DSH (DeepSeek Harness) 桌面端快捷键重启插件
一键自定义快捷键极速重启 DSH 桌面端，支持防误触二次确认弹窗、动态按键录制、通用设置面板集成与进程安全拉起机制。

---

✨ 功能特性

1. 安全稳定的应用无缝平滑重启：
   • 彻底关闭原有 Electron 主进程及所有常驻子进程，并在释放系统句柄与端口锁定后通过 Windows Shell 独立拉起全新的 DeepSeek Harness.exe，避免父子进程生命周期锁定问题。
2. 应用内专属生效：
   • 仅在 DSH 窗口处于激活前台焦点状态时捕获按键，绝不与系统其他全局热键或常用软件冲突。
3. 支持完全自定义快捷键（默认 Ctrl+Shift+R）：
   • 支持在设置页面中自由录制，支持鼠标点击后直接敲击键盘组合键自动录制，无需手动输入繁琐的键名。
   • 提供常用预设一键切换（Ctrl+Shift+R、Alt+R、F9、Ctrl+Alt+R）。
4. 防误触二次确认弹窗：
   • 按下快捷键时弹出优雅的确认对话框，提供“确认重启 (Enter)”与“取消 (Esc)”。
   • 支持直接勾选“下次直接重启，无需确认”，亦可在弹窗底部直接点击“更改快捷键”完成按键重绑。
5. 多处无缝设置入口：
   • 【设置】→【通用】页面：在 DSH 默认的通用偏好列表中直接嵌入配置行，开箱即可调配。
   • 【设置】左侧导航独立页面：提供专属的独立卡片设置界面。
   • 【插件】→【配置】：与 DSH 插件管理生态全面对齐。

---

🛠️ 安装方法

方式一：目录链接安装（推荐开发调试）

1. 将本项目 clone 或解压到本地目录（如 C:\Users\<YourUser>\Documents\DSH\dsh-plugin\dsh-restart-hotkey）。
2. 打开 DSH 桌面端 → 左侧栏「插件」→「安装插件」。
3. 填入插件项目目录的绝对路径，点击安装。
4. 安装完成后重启 DSH 即可生效。

方式二：打包安装 (npm pack)

在项目根目录下打包：

npm pack

在 DSH 桌面端 →「插件」→「安装」 中填入生成的 .tgz 压缩包路径即可。

---

⚙️ 快捷键与配置项

进入 DSH【设置】→【通用】 或 【快捷重启】：

配置项	默认值	说明
重启快捷键 (hotkey)	Ctrl+Shift+R	点击“录制按键”后直接敲击键盘组合键自动保存，亦可使用内置预设
重启前弹窗二次确认 (confirmBeforeRestart)	true	开启后按下快捷键先弹出确认模态框；关闭后按下快捷键将立即直接重启
测试重启应用	-	点击可立即模拟执行一次平滑重启过程，用于验证运行状态

---

🧪 自动化测试验证

本项目自带完备的单元测试，涵盖快捷键解析、规范化比对、按键匹配算法、进程路径识别与 Cordis 契约验证：

node test/hotkey.test.mjs
node test/restart.test.mjs
node test/plugin-wiring.test.mjs

---

📄 开源协议

本项目采用 MIT 协议开源。