dsh-restart-button：DeepSeek Harness 一鍵重啓插件

前言¶

DeepSeek Harness 採用插件化架構，在開發或長時間運行過程中，客戶端可能需要重啓以加載新代碼、釋放內存或應用配置變更。手動重啓操作較爲繁瑣，且容易中斷當前任務。

dsh-restart-button 是爲此場景設計的插件，它通過在界面中增加一個直觀的重啓入口，實現了一鍵安全重啓整個客戶端的功能，並支持會話狀態的恢復。

該插件由開發者 PPsz-qqq 維護，開源協議爲 MIT。

核心功能是在 DeepSeek Harness 會話標題欄的右上角添加一個重啓按鈕（↻）。點擊該按鈕後，客戶端會按照既定策略安全地重啓，支持 Windows 桌面版和 Web 模式。

界面集成：在會話標題欄右側工具區最右端（conversation.session.header.utilities，order 1000）添加按鈕。
一鍵重啓：無任務運行時，點擊按鈕即可重啓客戶端。
跑完自動重啓：當有會話或後臺作業正在運行時，重啓確認框中會出現“跑完後重啓”選項。選擇後按鈕變藍並閃爍，所有任務結束後自動重啓。
狀態恢復：重啓前會記錄當前打開的會話和中斷的會話。重啓完成後自動恢復會話狀態，並彈出提示卡片。點擊“全部繼續”可向所有會話發送“繼續”指令。
插件更新提醒：當插件原地更新（升級或重裝）且需要重啓才能生效時，按鈕上會出現橙色小點，提示“插件更新待生效”。
狀態查看：鼠標懸停在按鈕上，可查看 Host 運行時長、內存佔用、正在運行的會話數、已安排的重啓狀態及待生效的插件更新。
跨平臺支持：
- 桌面版（Windows）：重啓 Electron 外殼和後臺 Host，參數保持一致。
- Web 模式：重啓服務進程，頁面自動刷新，服務在後臺運行且不佔用原終端。

在 DeepSeek Harness 的「插件」頁面點擊「安裝」，在搜索框中輸入 dsh-restart-button，選擇作者 PPsz-qqq 進行一鍵安裝。

安裝完成後，可以在 profile 目錄下的 cordis.patch.yml 文件中調整確認策略：

- id: restart-button
  config:
    confirm: when-busy   # 默認策略：有任務運行時確認 | always：總是確認 | never：從不確認

點擊重啓：在會話標題欄右上角找到重啓按鈕，點擊即可觸發重啓流程。
配置策略：根據實際需求，在 cordis.patch.yml 中修改 confirm 參數，決定是否需要確認或自動處理。
API 調用：支持通過接口控制，例如調用 POST api/restart-button.restart 接口。請求體可包含 { when: 'now' | 'idle', activeSessionId?: string }。

桌面版限制：桌面版的一鍵重啓功能目前僅支持 Windows，macOS / Linux 桌面版上按鈕會自動隱藏。
會話可見性：未打開任何會話（新建會話頁）時，按鈕不顯示。
恢復時效：重啓後的會話恢復信息僅 10 分鐘內有效。
Web 模式行爲：Web 模式下重啓服務不佔用原終端窗口，日誌寫入 ~/.dsh/logs/restart-button-web-server.log。
更新生效：插件升級後需要重啓一次才能加載新代碼，界面會先更新，Host 部分需重啓。

dsh-restart-button 爲 DeepSeek Harness 用戶提供了便捷的客戶端重啓能力，結合會話恢復機制，有效降低了維護成本。安裝後即可在右上角使用，無需額外配置。