前言¶
在 DeepSeek Harness 桌面版裏改插件配置、剛裝完插件,或界面卡住時,常見做法是到任務管理器裏找進程,或把整個應用關掉再開。網頁版沒有本地殼進程,重啓語義也不同;桌面版若缺少入口,每次都要繞一圈系統工具。下面介紹社區插件 dsh-desktop-restart-button:在窗口標題欄「應用 / 編輯」旁增加「⟳ 重啓」,點一下即可重啓應用並讓窗口重新打開;默認只在檢測到正在運行的會話或後臺任務時彈確認,減少誤中斷進行中的任務。
這是什麼¶
dsh-desktop-restart-button 由維護者 StuMing233 發佈,分類爲客戶端插件。它面向 DeepSeek Harness 桌面版(Electron 殼;網頁版 dsh web 運行時不顯示按鈕,重啓接口也會拒絕執行),在標題欄掛載一鍵重啓與策略設置,解決「改配置 / 裝插件 / 卡死時需要快速重啓整應用」的問題。插件以 MIT 許可證發佈,當前 package 版本爲 1.0.0,無第三方依賴。
核心功能¶
- 一鍵重啓:點擊「⟳ 重啓」立即重啓應用,窗口自動重新打開。
- 重啓策略可切換:點擊右側「▾」打開設置面板,可開關「有任務運行時先確認」。
- 開啓(默認):重啓前先查詢當前狀態;只有檢測到正在運行的會話或後臺任務時才彈確認框,否則直接重啓。
- 關閉:無論是否有任務在跑,點擊即重啓。
- 狀態可見:設置面板顯示當前正在運行的會話數與後臺任務數;確認框中會寫明「檢測到 N 個正在運行的任務(x 個會話、y 個後臺任務)」。
- 超時提示:若重啓後 120 秒內頁面仍未恢復,會顯示提示和「刷新頁面」按鈕,而不是一直轉圈。
重啓策略保存在 localStorage 的鍵 dsh-desktop-restart-button:policy(值爲 confirm 或 immediate),按窗口持久化。
Host 側註冊本機路由 GET /dsh-desktop-restart-button/state 與 POST /dsh-desktop-restart-button/restart(帶自定義請求頭校驗,拒絕跨站請求);在 Windows 上通過 PowerShell 與 WMI Win32_Process.Create 拉起不在應用作業對象內的後備啓動器,再結束殼與宿主進程並重新啓動 DeepSeek Harness.exe。界面通過 shell.overlay 槽位組件定位,樣式複用應用主題變量。
安裝與啓用¶
本插件僅在 DeepSeek Harness 桌面版生效,桌面版內部 profile 名爲 desktop。安裝命令如下(須與官方 README 一致,勿自行拼接 GitHub 路徑):
dsh plugin --profile desktop add dsh-desktop-restart-button
也可以在應用左側欄的「插件」頁面裏安裝。
裝好後需要手動重啓一次 DeepSeek Harness,標題欄纔會出現按鈕。
環境要求(來自 README):
- DeepSeek Harness 桌面版
- Windows(重啓助手使用 PowerShell + WMI;其他平臺暫未適配)
- Node.js ≥ 20(DSH 自帶運行時即可)
典型用法¶
| 操作 | 行爲 |
|---|---|
| 點「⟳ 重啓」 | 按當前策略重啓 |
| 點「▾」 | 打開設置面板(狀態、策略開關、立即重啓) |
| 有任務時確認框 | 「取消」/「仍要重啓」 |
開發調試時,可設置環境變量 DSH_RESTART_BUTTON_DEBUG=1,使用 GET /dsh-desktop-restart-button/diag?probe=wmi|job 查看進程作業與 WMI 探測結果(調試路由默認關閉)。
適用場景與注意¶
適合誰:在 Windows 上使用 DSH 桌面版、經常改插件或需要快速整應用重啓、又希望在有會話/後臺任務時多一道確認的用戶。
務必知曉:
- 插件以當前 DSH 進程權限運行;安裝前應自行查看 GitHub 源碼 與 MIT 許可證,確認可接受其行爲。
- 硬重啓:不做優雅退出,進行中的會話會被中斷——這也是默認「有任務時先確認」的原因。
- 只能重啓整個應用,不能只重啓宿主或熱重載某個插件。
- 僅適配 Windows 桌面版;網頁版裏按鈕不會出現。
DSH 生態理念是「一切皆插件」;社區目錄站點與 DeepSeek / 幻方無官方從屬關係,本文介紹的是社區插件,而非官方應用商店條目。
結尾¶
dsh-desktop-restart-button 把桌面版常見的「找進程、關應用、再開」收成標題欄一次點擊,並用默認確認策略降低誤殺正在運行任務的概率。需要安裝或 issue 時可訪問:
- 社區目錄頁:https://www.skillhub.cn/plugins/StuMing233/dsh-desktop-restart-button
- GitHub:https://github.com/StuMing233/dsh-desktop-restart-button