前言¶
DeepSeek Harness (DSH) 在 WSL 环境中运行时，通常需要通过终端访问。dsh-wsl-tray 插件解决了这一问题，它为运行在 WSL 中的 DSH 提供了 Windows 桌面快捷方式和系统托盘启动器，使开发者可以在桌面端直接操作。
插件介绍¶
dsh-wsl-tray 是一个 DeepSeek Harness (DSH) 插件，为 WSL 部署提供桌面快捷方式和系统托盘启动器。
* 维护者：liyu34
* 许可证：MIT
* 定位：客户端插件
核心功能¶
该插件包含以下核心能力：
1. 桌面快捷方式：双击桌面上的 “DeepSeek Harness” 快捷方式，可在后台启动 DSH 或复用已有实例。
2. 系统托盘菜单：托盘图标右键提供一系列操作：打开网页、重新生成快捷方式、重启服务、暂停/恢复守护进程、退出。
3. 看门狗守护进程：自动探测 DSH 状态，检测失败时自动重启。达到最大失败次数后暂停，恢复运行或 DSH 正常后自动继续。
4. 配置卡片：在 DSH Web 的插件配置卡片中，可查看实时状态和看门狗日志，并提供重建快捷方式的按钮。
5. 无控制台窗口：通过 wscript.exe 和 VBS 启动，进程运行时无控制台窗口干扰。
安装¶
安装命令如下：
dsh plugin --profile web add dsh-wsl-tray
安装后，重启 dsh web 并在设置中找到 WSL 桌面与托盘 卡片。
使用说明¶
- 启动：双击桌面快捷方式启动 DSH。
- 打开网页：双击托盘图标或通过托盘右键菜单打开 DSH 网页。
- 重建快捷方式：如果快捷方式失效，通过插件配置卡片点击重建，无需手动操作 WSL。
工作原理¶
插件通过以下链路实现功能：
1. 启动链路：桌面快捷方式指向 wscript.exe，后者执行 VBS 脚本启动隐藏的 PowerShell 托盘进程，托盘进程通过 wsl.exe 在 WSL 中启动 start.sh。
2. 看门狗逻辑：托盘进程内部运行一个守护进程，定时探测 DSH Web URL。探测失败达到阈值（默认 3 次）后触发重启。连续重启失败达到上限（默认 3 次）后进入暂停状态，直到手动恢复或 DSH 恢复正常。
3. 日志记录：看门狗的探测结果、重启动作及状态变更均记录在 watchdog.log 中。
注意事项¶
- 环境要求：仅支持 WSL 环境，非 WSL 主机无法使用。
- 版本要求：DSH web 版本需在 0.1.0-rc.7 或更新。
- 系统依赖：系统需安装
wscript.exe、powershell.exe和wsl.exe。 - 进程关系：看门狗依附于托盘进程，退出托盘即停止看门狗和 DSH 实例。
