DeepSeek Harness (DSH) 提供了 Web UI 進行智能體開發,但每次啓動都需要在終端手動輸入命令,手動關閉瀏覽器標籤頁又容易導致端口被佔用。dsh-power-launch 是一款 Windows 客戶端插件,它通過桌面快捷方式實現一鍵啓動,並在 Web UI 右下角提供帶有二次確認的安全退出功能,確保進程以退出碼 0 退出,從而釋放端口。
核心功能¶
該插件主要提供以下能力:
- 自動桌面快捷方式:插件會在桌面自動創建帶官方鯨魚圖標的快捷方式。每次
dsh web啓動時,腳本會冪等地檢查並確保該快捷方式存在,若被刪除或修改會自動修復。 - Web UI 安全退出:在 Web UI 右下角顯示電源按鈕,點擊後彈出確認窗口。確認後,宿主進程會調用接口以退出碼 0 退出,並自動釋放端口,防止下次啓動時發生衝突。
- 聯網啓動器:點擊桌面快捷方式時,啓動器會自動檢查
@deepseek-ai/dsh的新版本(使用國內鏡像),啓動過程會隱藏後臺進程,啓動完成後自動打開瀏覽器。
安裝¶
通過官方插件命令安裝:
dsh plugin --profile web add dsh-power-launch
安裝後重啓 dsh web 即可生效。
典型用法¶
啓動服務
日常使用時,只需雙擊桌面上的 DeepSeek Harness Web 快捷方式即可啓動 Web UI。
修改端口
如果默認端口被佔用,可以在快捷方式的目標路徑末尾添加參數更改端口。例如,將快捷方式目標修改爲:
dsh-launch.bat -Port 3081
禁用快捷方式
如果不需要自動創建桌面快捷方式,可以在系統環境變量中設置:
DSH_POWER_LAUNCH_SHORTCUT=0
配置鏡像源
若需要使用特定的 NPM 鏡像,需編輯包內的 launcher/dsh-launch.ps1 文件,在頂部修改相關參數。
注意事項¶
- 平臺限制:該插件目前僅支持 Windows 平臺。
- 文件編碼要求:
.bat文件必須保持 CRLF 行尾和純 ASCII 編碼;.ps1文件必須保持 UTF-8 BOM 編碼,否則腳本可能無法正常解析。 - 瀏覽器行爲:關閉標籤頁由腳本調用
window.close()完成。根據瀏覽器安全策略,僅允許關閉腳本自己打開的標籤頁,若被拒絕,頁面會靜默變爲深色空白。