前言¶
在 DeepSeek Harness（DSH）的桌面應用中，刷新界面比較方便，但要重啓或關閉整個桌面應用，通常需要離開當前窗口，去任務欄或托盤找圖標。這多了一步操作，也容易打斷連續工作流。
w17her/dsh-power-control 是一個分類爲「客戶端」的 DSH 插件，它的核心價值是在 DSH 界面裏直接提供「刷新界面 / 重啓應用 / 關閉應用」的能力，無需切換到任務欄或托盤，適合習慣在單一窗口內完成所有操作的智能體開發者。
插件定位¶
- 插件名稱：w17her/dsh-power-control
- 維護者：w17her
- 分類：客戶端
- 核心問題：在 DSH 界面裏直接控制桌面應用的生命週期，減少窗口切換和尋找托盤圖標的成本
核心功能¶
該插件提供三種操作，均通過側邊欄底部的電源按鈕進入菜單：
- 刷新界面：在當前 DSH 界面執行
window.location.reload()，從運行中的 Host 重建 Web UI。該操作在任何 DSH 環境中均可用。 - 重啓應用：先刷新會話到磁盤，再重啓整個桌面應用（同一個可執行文件、同一個配置文件、同一個工作區）。僅支持 Windows 桌面版，因爲應用進程樹位於桌面端。
- 關閉應用：先刷新會話到磁盤，再退出整個桌面應用。僅支持 Windows 桌面版。
操作細節：
- 菜單向上展開爲全屏 Popover，不會受側邊欄滾動容器的裁剪。
- 關閉類操作會彈出確認對話框，明確說明將中斷的內容。
- 執行期間用狀態遮罩覆蓋窗口，若 9 秒後進程仍存活，顯示「重載此窗口」的回退鏈接。
- 顏色和 UI 支持淺色/深色主題，全部使用 DSH 的主題 token（--dsw-alias-*）。
- 界面語言跟隨 DSH 當前 locale，支持中文和英文。
安裝與啓用¶
該插件爲本地 DSH Bundle，不是 npm 包，支持兩種安裝方式。
方式一：使用發佈包
1. 下載 dsh-power-control-1.0.0.zip：Releases 下載鏈接
2. 解壓後，將包含 package.json 的文件夾安裝到 DSH 插件管理器：
plugin_manager install_bundle target = <路徑到解壓後的 dsh-power-control 文件夾>
- 安裝後 DSH 會將目錄鏈接到當前配置文件並重新加載 Host，側邊欄底部會出現電源按鈕。
方式二：克隆倉庫
1. 克隆倉庫到穩定位置：
git clone https://github.com/w17her/dsh-power-control.git "$env:USERPROFILE\dsh-power-control"
- 使用 DSH 插件管理器安裝該文件夾：
plugin_manager install_bundle target = <路徑到 dsh-power-control 文件夾>
- 安裝完成後，在 DSH 的「設置 → 插件」中可以看到該條目，點擊啓用即可。
更新克隆版本時，只需執行 git pull。客戶端代碼會熱重載，Host 相關更改需要關閉再重新啓用插件或重啓應用。
典型用法¶
在 DSH 桌面應用的任意界面中：
1. 找到側邊欄底部的電源按鈕（與「設置」相鄰）。
2. 點擊打開菜單，選擇「刷新界面」「重啓應用」或「關閉應用」。
3. 對重啓與關閉操作，確認彈窗內容無誤後點擊確認。
適用場景與注意¶
- 適合習慣在單一 DSH 窗口內完成開發與調試，頻繁需要重啓或關閉桌面應用的場景。
- 插件以當前 dsh 進程的權限運行，執行重啓和關閉操作會中斷正在運行的任務，確認對話框會明確提示。
- 安裝前建議檢查源碼與許可證（MIT），確保與本地使用策略一致。
- 該插件不依賴外部網絡，沒有自己的網絡客戶端，不向任何地方發送數據。
總結¶
w17her/dsh-power-control 用一個電源按鈕和菜單，把「刷新界面 / 重啓應用 / 關閉應用」三種操作統一到 DSH 界面中，減少了在任務欄和托盤之間切換的成本，適合需要高頻重啓或關閉桌面應用的開發者。更多細節可訪問插件目錄頁或 GitHub 倉庫。
