DSH 桌面版：用 Wails 把 DeepSeek Harness 做成开箱即用的桌面应用（macOS / Windows / Linux）

[zsyu9779]

说明：这是我维护的非官方社区项目，与 DeepSeek 官方无隶属或背书关系。

最近做了一个 DeepSeek Harness Desktop，用 Wails/Go 给官方 @deepseek-ai/dsh Web UI 加了一层轻量桌面外壳。

• 项目官网：https://zsyu9779.github.io/dsh-desktop/
• GitHub：https://github.com/zsyu9779/dsh-desktop
• 下载地址：https://github.com/zsyu9779/dsh-desktop/releases/latest

为什么会做这个项目

我很喜欢 DSH 官方的 Web UI，不过日常使用时总要重复一套流程：打开终端、切到工作目录、运行 dsh web、找到浏览器标签页，结束后还得确认后台进程有没有退出。

所以这个项目的目标一直很克制：不修改 Agent Runtime，也不重做一套界面，只把官方 Harness 更稳妥地装进桌面窗口里。

DeepSeek Harness Desktop（Wails / Go）
└── npx @deepseek-ai/dsh web
    └── node / dsh
        └── 官方本地 Web UI

桌面端负责启动固定版本的官方 npm 包，等待本地服务就绪，再用原生窗口显示官方 Web UI；关闭应用时，它也会接管并清理整条子进程链。

这层桌面外壳解决了什么

• 使用 Wails 和系统 WebView，不额外打包 Electron/Chromium。
• 自动选择可用端口，并在服务真正就绪后再打开界面。
• 启动状态和错误直接可见，同时保留本地日志，出问题时不用盲猜。
• 退出时清理完整的 npx → node → dsh 进程树，避免后台残留。
• 提供 macOS Universal、Windows amd64 和 Linux amd64 构建。
• 支持可信局域网内的手机访问：扫一下二维码，就能在同一 Wi-Fi 下继续处理当前 Harness 会话。

目前 v0.1.5 的安装包大约是：macOS DMG 8.9 MB、Windows 10.8 MB、Linux 压缩包 4.2 MB。不同平台的打包格式不一样，这些只是当前 Release 的实际体积，不作为桌面框架之间的性能对比。

一个我自己很需要的功能：手机接管

Agent 跑长任务时，经常会在我离开电脑后停下来等一句确认。现在可以临时打开局域网访问，用手机扫描二维码，在同一网络里继续当前会话。

配对成功后，随机 Token 会保存在 HttpOnly Cookie 中；重新生成二维码会让之前的手机会话失效，关闭远程访问则会停止代理并清除当前配对状态。

这里需要强调一下：这个功能只适合可信的本地网络。它使用局域网 HTTP，不是公网远程控制服务，请不要在咖啡店 Wi-Fi、访客网络或其他不可信网络中开启。

目前的限制

• 仍需预先安装 Node.js，应用通过 npx 获取并启动 DSH；暂时还不是完全离线、自包含的发行包。
• Release 尚未签名，macOS Gatekeeper 和 Windows SmartScreen 可能提示未知开发者。
• DeepSeek Harness 目前仍是 Developer Preview，上游变化可能需要桌面启动器跟进。
• 模型、会话、插件、Skills、MCP 和各项设置仍由官方 Harness 管理，桌面层不会接管这些能力。

想听听大家的真实反馈

目前尤其想验证这几个问题：

1. 在不同版本的 macOS、Windows 和 Linux 上，首次启动和退出清理是否稳定？
2. 窗口恢复、全屏等行为是否符合各平台习惯，尤其是 macOS？
3. 手机接管对长任务是否真的有用，扫码配对流程是否足够清楚？
4. 后续是否值得把 Runtime 一起打进安装包？这样开箱体验更完整，但包体和升级成本也会增加。

欢迎提 Issue 或 PR。如果遇到启动失败，请附上操作系统、应用版本，以及 ~/.dsh-desktop/logs/dsh.log 中对应的日志片段。

感谢 DeepSeek Harness 团队开源 Runtime 和 Web UI。也想听听社区的建议：这类桌面发行版接下来最应该补齐的能力是什么？

---

English summary: DeepSeek Harness Desktop is an unofficial, lightweight Wails/Go shell around the official @deepseek-ai/dsh Web UI. It handles service startup, port selection, readiness checks, logs, process cleanup, cross-platform releases, and optional phone access on a trusted LAN. Source and downloads are available through the links above.