dsh-wsl-launcher：在 WSL 中启动 DeepSeek Harness Web 的 Windows 桌面快捷方式

前言¶

DeepSeek Harness (DSH) 采用插件化架构，支持在本地环境运行。当 dsh web 实例运行在 WSL（Windows Subsystem for Linux）中时，通过 Windows 桌面访问该 UI 会涉及繁琐的终端操作：打开终端、切换到 WSL、运行 dsh web、等待启动、切换浏览器并输入 URL。这种工作流在频繁调试时效率较低。

dsh-wsl-launcher 插件通过在 Windows 桌面创建一个快捷方式，将上述操作封装为一个双击动作，实现了在 Windows 桌面直接访问 WSL 中运行的 DeepSeek Harness Web UI。

插件介绍¶

dsh-wsl-launcher 是一个 Windows 桌面启动器，用于启动运行在 WSL 中的 DeepSeek Harness Web UI。它由开发者 rqzhao1 维护，遵循 MIT 许可证。

该插件主要解决“在 Windows 环境下启动和访问 WSL 中的 DSH Web 服务”这一痛点，通过桌面快捷方式和命令行工具简化交互流程。

核心功能¶

该插件提供以下核心能力：

双击启动：在 Windows 桌面生成一个快捷方式（图标为黑鲸），双击即可触发 WSL 启动并打开 Web UI，无需打开终端。
自动后台运行：插件会在后台启动 dsh web 服务，控制台窗口可关闭而不影响服务运行。
幂等性设计：如果 Web UI 端口已监听，插件仅打开浏览器；多次双击不会产生冲突或错误。
模型工具集成：注册了 wsl_launcher 模型工具，支持在 DSH 会话中通过命令进行安装、状态检查、启动和卸载管理。

安装与启用¶

安装前需确保已安装 DSH 并配置好 profile（例如 web profile）。

在终端中执行以下命令安装插件：

dsh plugin --profile web add dsh-wsl-launcher

安装完成后，重启 dsh web。插件会自动在 WSL 中创建启动脚本和图标，并在 Windows 桌面生成快捷方式。

使用方式¶

安装并重启后，可通过以下方式使用：

桌面快捷方式：在 Windows 桌面找到名为“DeepSeek Harness Web”的快捷方式，双击即可启动服务并打开浏览器。
命令行工具：在 DSH 的会话中，可以调用 wsl_launcher 工具：
- 检查状态：wsl_launcher status（用于检测 WSL 是否可用及端口监听情况）。
- 打开服务：wsl_launcher open（直接在浏览器中打开 Web UI）。
- 安装/卸载：wsl_launcher install / wsl_launcher uninstall（用于管理插件自身的文件和快捷方式）。

适用场景与注意¶

适用场景：需要在 WSL 环境中使用 DeepSeek Harness 进行开发或调试，但习惯使用 Windows 桌面进行操作的用户。

注意事项：
1. 环境依赖：需在 dsh 0.1.1-rc.2 版本上验证通过；Host 端需安装 Node.js (>=20)。
2. WSL 要求：必须启用 WSL1 或 WSL2，且 Windows 互操作性功能已开启（默认开启）。
3. 权限与安全：插件会在 WSL 和 Windows 端写入文件，但不会读取、存储或发送任何凭证，仅进行本地端口探测和浏览器调用。

结尾¶

dsh-wsl-launcher 通过封装 WSL 启动逻辑，降低了在 Windows 环境下使用 DeepSeek Harness 的门槛。若你需要在 WSL 中管理 DSH 实例，该插件提供了一个轻量级的桌面入口。

插件详情可查阅：GitHub