dsh-power-launch:桌面啓動與安全退出插件

DeepSeek Harness (DSH) 提供了 Web UI 進行智能體開發,但每次啓動都需要在終端手動輸入命令,手動關閉瀏覽器標籤頁又容易導致端口被佔用。dsh-power-launch 是一款 Windows 客戶端插件,它通過桌面快捷方式實現一鍵啓動,並在 Web UI 右下角提供帶有二次確認的安全退出功能,確保進程以退出碼 0 退出,從而釋放端口。

核心功能

該插件主要提供以下能力:

  1. 自動桌面快捷方式:插件會在桌面自動創建帶官方鯨魚圖標的快捷方式。每次 dsh web 啓動時,腳本會冪等地檢查並確保該快捷方式存在,若被刪除或修改會自動修復。
  2. Web UI 安全退出:在 Web UI 右下角顯示電源按鈕,點擊後彈出確認窗口。確認後,宿主進程會調用接口以退出碼 0 退出,並自動釋放端口,防止下次啓動時發生衝突。
  3. 聯網啓動器:點擊桌面快捷方式時,啓動器會自動檢查 @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() 完成。根據瀏覽器安全策略,僅允許關閉腳本自己打開的標籤頁,若被拒絕,頁面會靜默變爲深色空白。

相關鏈接

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜