前言¶
DeepSeek Harness (DSH) 提供了基於 Web 的智能體開發環境。在使用過程中，開發者通常需要保持 Web UI 的長期運行。傳統的直接打開瀏覽器的方式存在窗口關閉即中斷服務、無法區分多實例、以及缺乏系統托盤管理等問題。dsh-web-manager 通過提供 Windows 托盤程序、WSL 伴生腳本和運行時橋接，解決了這些問題。
它是什麼¶
dsh-web-manager 是一個 DeepSeek Harness WebUI 管理工具，包含 Windows 系統托盤管理、WSL 伴生腳本以及 DSH 內部運行時橋接。它作爲一個 dsh 插件包進行分發，可以方便地集成到 DSH Profile 中。
- 維護者：FYHC1
- 類別：客戶端
- 許可證：MIT
核心功能¶
- Windows 系統托盤常駐管理
- WSL 伴生腳本與後端託管
- DSH 運行時橋接（v3.0）
- Edge / Chrome / Chromium 應用窗口管理
- 桌面快捷方式自動創建與維護
- 自動更新機制
- 多實例支持
安裝與啓用¶
該插件以插件包形式存在，安裝後隨 DSH 啓動自動部署托盤程序和快捷方式。
- 使用以下命令將插件添加到 DSH Profile：
dsh plugin --profile web add github:FYHC1/dsh-web-manager
- 安裝完成後，重啓 DSH 進程以使托盤程序和快捷方式生效。
典型用法¶
安裝完成後，可以通過以下方式使用：
- 命令行啓動：
dsh-web-manager.exe open windows
dsh-web-manager.exe open wsl
dsh-web-manager.exe "backend wsl"
- WSL 命令行：
wslmode systemd
- 快捷方式：
安裝後會自動生成桌面快捷方式DeepSeek Harness WebUI (win).lnk或(wsl).lnk，雙擊即可打開。
注意事項¶
- 後臺守護：關閉瀏覽器窗口不會結束 dsh web 後臺服務，托盤程序會繼續在後臺運行。
- 窗口尺寸：窗口尺寸通過 WinEventHook 在窗口顯示前設置，以確保尺寸記憶的準確性。
- 瀏覽器選擇：默認使用 Edge，若未安裝則自動回退到 Chrome 或 Chromium。
- WSL Systemd：使用 WSL 的 systemd 託管模式需要 WSL 配置文件
/etc/wsl.conf中開啓[boot] systemd=true。 - Runtime Bridge 端口：Runtime Bridge 監聽
127.0.0.1:<webPort+100>。
結語¶
dsh-web-manager 通過將瀏覽器窗口轉化爲原生應用體驗（通過 Edge/Chrome 的 --app 模式），並配合托盤管理，解決了 DSH WebUI 長期運行和窗口管理的痛點。它支持多實例、多後端，並能自動維護快捷方式，適合需要長期駐留 Web UI 進行智能體開發的場景。
