前言¶
在 DSH 裏折騰插件、改配置或裝 bundle 之後，宿主進程往往要重啓一次改動纔會生效。常見做法是找系統托盤退出，再手動雙擊打開應用，步驟分散，打斷調試節奏。下面介紹 @cxk9911/dsh-quick-restart：在側邊欄設置按鈕上方增加「重啓 DSH」，點一次、確認一次，由插件在 Windows 桌面版上關閉當前 DSH 並重新拉起同一可執行文件。
這是什麼¶
維護者爲 CXK991，npm 包名 @cxk9911/dsh-quick-restart（當前版本 1.0.1，許可證 MIT）。分類屬於 DSH 客戶端插件：在界面裏掛按鈕和確認浮層，同時在宿主側提供重啓 API。一句話定位：把「改完東西要重啓 DSH」從托盤操作收成側邊欄裏的一次確認。
GitHub 倉庫：CXK991/dsh-quick-restart。SkillHub 目錄頁：dsh-quick-restart。
核心功能¶
已覈實的能力如下。
- 側邊欄入口：左下角、設置按鈕正上方顯示「重啓 DSH」。側邊欄在 Windows 桌面版收起時，底部區域會被 shell 隱藏，按鈕需展開側邊欄纔可見；Web / macOS 收起態會顯示爲單個圖標（自動重啓仍以 Windows 桌面版爲主路徑）。
- 確認後重啓：確認框點「立即重啓」後，DSH 關閉；助手等待約 1.2 秒，按進程名結束 DSH，再啓動同一個 exe，桌面窗口自行恢復。新進程
bootId會變。 - 協議握手：前端在
POST前先GET /dsh-quick-restart/api/restart，覈對protocol（當前爲 2）；版本不一致則拒絕觸發並提示先手動重開，避免舊版插件代碼導致「關了不回來」。 - 安全與節流：接口僅對本機已登錄頁面放行（fail-closed）；20 秒冷卻，防止連點。
非 Windows 平臺會返回明確錯誤，不會靜默失敗。dsh web 命令行側留有按 node 重新拉起的兜底邏輯，README 註明該路徑未做同機實測。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議閱讀倉庫源碼與 MIT 許可證。安裝命令須使用資料中的包名，不要憑倉庫名自行拼接 github:owner/repo。
方式一：命令行（npm，推薦）
桌面版 profile 通常爲 desktop：
dsh plugin --profile desktop add @cxk9911/dsh-quick-restart
DSH Web：
dsh plugin --profile web add @cxk9911/dsh-quick-restart
也可在 設置 → 插件 → 安裝 中填寫包名 @cxk9911/dsh-quick-restart。
方式二：Discover 索引源
README 說明該插件尚未收錄進 dsh-market 社區目錄，市場搜索可能找不到。若使用 Discover，需先打開 Plugins → Experimental plugins → More 中的 Custom plugin markets，在 Discover → Add index source 粘貼任一地址：
https://cdn.jsdelivr.net/npm/@cxk9911/dsh-quick-restart/index.json
https://raw.githubusercontent.com/CXK991/dsh-quick-restart/main/index.json
方式三：本機 link 試用
dsh plugin --profile desktop add "link:/path/to/dsh-quick-restart"
裝完後需重啓一次 DSH（或由插件管理器觸發 profile 重載），側邊欄底部纔會出現按鈕。
典型用法¶
- 展開側邊欄（Windows 桌面版收起時按鈕不顯示）。
- 點 「重啓 DSH」，在確認框點 「立即重啓」。
- 等待應用關閉並自動重新打開；若插件剛更新過，先手動重開一次 DSH 再使用按鈕，以便加載新版宿主邏輯。
出問題時可在 %TEMP%\dsh-quick-restart.log 查看助手記錄的 --- / targets= / killed / launched 等步驟。
適用場景與注意¶
適合：頻繁改插件或配置、裝 bundle 後需要重啓宿主，且主要使用 Windows 桌面版 DSH 的開發者。
限制（來自 README）：
- 自動重啓僅在 Windows 桌面版 完整支持。
- 進行中的任務會被中斷；會話記錄會落盤。按進程名結束 DSH 時，非同名子進程（如 MCP server、PTY 裏的 bash）不會被殺掉，可能成爲孤兒進程，重啓後可能重複啓動。
- 桌面宿主使用
--port 0隨機端口，重啓後端口變化；若用瀏覽器標籤連舊地址，需回到桌面窗口。 - 重新拉起時不帶自定義啓動參數。
- 星標等社區數據以各站點展示爲準；SkillHub 線索爲 0 star，不影響 npm 安裝。
DSH 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-quick-restart 把重啓宿主收進側邊欄一次確認，面向 Windows 桌面版改插件、改配置後的常見流程。詳情與實現說明見 GitHub README，安裝與索引見上文命令與 SkillHub 目錄頁。
