前言¶
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 进行智能体开发的场景。
