前言¶

在使用 DeepSeek Harness (DSH) 桌面端進行開發或調試時，有時需要重啓應用以清理內存狀態或應用更新。常規的關閉方式可能導致進程殘留或端口占用問題。dsh-restart-hotkey 插件通過自定義快捷鍵，實現了應用的安全平滑重啓。

插件介紹¶

dsh-restart-hotkey 是由用戶 hfbcwhy7gh-cpu 開發的一款 DSH 桌面端插件。它旨在解決手動重啓應用帶來的操作繁瑣問題，通過一個快捷鍵即可完成徹底的進程關閉與系統句柄/端口釋放，隨後重新拉起應用。

核心功能¶

該插件主要包含以下能力：

1. 安全穩定的應用無縫平滑重啓
   插件會徹底關閉原有的 Electron 主進程及所有常駐子進程，在釋放系統句柄與端口鎖定後，通過 Windows Shell 獨立拉起新的 DeepSeek Harness.exe，避免父子進程生命週期鎖定導致的重啓失敗。

2. 應用內專屬生效
   快捷鍵僅在 DSH 窗口處於激活前臺焦點狀態時生效。這避免了與系統其他全局熱鍵或常用軟件（如 VS Code、IDEA）發生衝突。

3. 支持完全自定義快捷鍵
   默認快捷鍵爲 Ctrl+Shift+R。

   • 動態錄製：在設置頁面點擊“錄製按鍵”後，直接敲擊鍵盤組合鍵即可自動保存。
   • 預設切換：支持在常用預設（如 Alt+R、F9、Ctrl+Alt+R）中一鍵切換。

4. 防誤觸二次確認彈窗
   按下快捷鍵時，會彈出確認對話框，提供“確認重啓”和“取消”選項。彈窗底部也提供了“更改快捷鍵”的入口，方便即時調整。支持勾選“下次直接重啓，無需確認”。

5. 多處無縫設置入口
   配置項不僅嵌入在 DSH 的【設置】→【通用】頁面中，還提供了獨立的設置卡片，並與插件管理生態保持一致。

安裝與啓用¶

安裝前請確保環境滿足要求：Node.js 版本 >= 20，DSH 版本 >= 0.2.0-rc.2，且當前平臺支持 Windows。

方式一：目錄鏈接安裝（推薦開發調試）¶

1. 將項目 clone 或解壓到本地目錄。
2. 打開 DSH 桌面端，點擊左側欄的「插件」。
3. 選擇「安裝插件」，填入項目目錄的絕對路徑並重啓 DSH。

方式二：打包安裝 (npm pack)¶

1. 在項目根目錄下執行命令：

    npm pack

2. 在 DSH 桌面端「插件」→「安裝」中，填入生成的 .tgz 壓縮包路徑即可。

典型用法¶

安裝完成後，進入 DSH【設置】→【通用】或【快捷重啓】頁面。

1. 基礎重啓：在 DSH 窗口激活狀態下，按下默認快捷鍵 Ctrl+Shift+R，確認彈窗後即可重啓。
2. 錄製新快捷鍵：點擊設置頁面的“錄製按鍵”按鈕，保持焦點在 DSH 窗口內，直接敲擊鍵盤組合鍵，系統會自動識別並保存。
3. 調整配置：在彈窗底部直接點擊“更改快捷鍵”或在設置面板中調整“重啓前彈窗二次確認”選項。

適用場景與注意¶

• 適用場景：需要頻繁重啓 DSH 應用以重置狀態、清理端口占用的開發調試場景。
• 權限與安全：插件以 DSH 進程權限運行，安裝前建議查看源碼以確保安全性。項目採用 MIT 許可證開源。

總結¶

dsh-restart-hotkey 通過封裝進程管理邏輯，爲 DSH 桌面端提供了類似 IDE 熱重載的快捷操作體驗。它兼顧了靈活的按鍵自定義與操作安全性，適合追求高效開發流程的工程師使用。

插件目錄 | GitHub 倉庫