dsh-desktop-shell：把 DeepSeek Harness WebUI 变成桌面应用

前言¶

DeepSeek Harness（DSH）默认在浏览器中运行。dsh-desktop-shell 插件通过将 WebUI 转换为独立的桌面应用来解决这一问题。它会在用户目录下生成一个便携启动器，创建桌面和开始菜单快捷方式，并接管 DSH 后端的运行。

核心功能¶

该插件通过 WebView2 窗口实现独立应用体验，具备以下能力：

1. 独立窗口：复用系统 WebView2 运行时，无浏览器地址栏与标签页。
2. 关闭即最小化到托盘：关闭窗口仅隐藏，必须通过托盘菜单“退出”才能停止后端。
3. 无痕启动：后端静默运行，不弹控制台窗口，日志输出至指定目录。
4. 就绪门控：界面不会提前加载，需等待后端打印认证 URL 后才进入，避免闪现 404。
5. 零 Electron 依赖：载荷约 1.2MB，不引入庞大的 Electron 运行时。
6. 调试模式：提供独立的调试快捷方式，后端以可见控制台运行，方便查看报错。
7. 看门狗与自动接管：后端意外退出会自动拉起；支持接管外部启动的 DSH 后端。
8. 设置内控制：在设置 → 通用设置 → DSH 桌面外壳 中提供安装、修复、清理及自启开关。

安装与前置条件¶

前置条件：
* 系统：Windows 10/11 (x64)。
* 运行时：WebView2（通常已预装），Node.js >= 22，DSH >= 0.1.5-rc.1。
* 权限：不需要管理员权限，安装文件位于用户目录。

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

dsh plugin --profile web add dsh-desktop-shell

安装后必须重启 DSH 使插件生效。重启后，可在设置 → 通用设置 → DSH 桌面外壳 中确认安装状态。

使用方法¶

检查状态¶

可以通过接口检查安装状态：

curl.exe http://127.0.0.1:3080/api/dsh-desktop/status

托盘操作¶

启动器会在系统托盘常驻。右键托盘图标可进行以下操作：
* 打开界面：恢复窗口。
* 重启后端 / 以调试模式重启：重启 DSH 后端。
* 接管外部后端：将非托管的后端进程纳入启动器管理。
* 查看日志 / 配置 / 数据目录：快速定位相关文件。

设置操作¶

在设置界面中，针对“DSH 桌面外壳”行可进行：
* 安装 / 修复：重新落地文件并刷新配置。
* 重建快捷方式：更新桌面、开始菜单快捷方式。
* 开启 / 关闭登录自启：默认关闭，需手动开启。
* 清理安装：删除快捷方式与用户目录下的插件文件。
* 重启后端：由启动器托管重启。

安装后文件¶

插件安装后，会在 %USERPROFILE%\dsh-desktop 目录下生成以下内容：

• 可执行文件：DSHLauncher.exe（约 90KB）。
• 依赖库：Microsoft.Web.WebView2.*.dll、WebView2Loader.dll。
• 源码与校验：DSHLauncher.cs、build-icons.mjs、SHA256SUMS.txt。
• 配置与日志：launcher.config.json、preferences.json、logs\dsh-web.log。
• 快捷方式：桌面与开始菜单的 .lnk 文件。

清理与卸载¶

卸载插件：

dsh plugin --profile web remove dsh-desktop-shell

卸载后，建议在设置中点击“清理安装”，以删除快捷方式和 %USERPROFILE%\dsh-desktop 目录。

注意：若插件仍启用，宿主下次启动会自动重新安装。要永久移除，请先卸载插件或设置环境变量 DSH_DESKTOP_NO_AUTOINSTALL=1。

生态背景¶

DSH 采用插件化架构。本插件由开发者 RINGOLINK 维护，符合 MIT 许可证。所有文件与行为均由插件自身管理，不改动 DSH 本体。