zsyu9779/dsh-desktop
Unofficial cross-platform desktop app for DeepSeek Harness. Native Wails shell for the DSH Web UI on macOS, Windows, and Linux.
安装Install
dsh plugin --profile web add github:zsyu9779/dsh-desktop把 zsyu9779/dsh-desktop 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
中文 · English
DeepSeek Harness Desktop
Unofficial cross-platform desktop app for DeepSeek Harness — a native Wails shell for the DSH Web UI on macOS, Windows, and Linux.
DeepSeek Harness Desktop 是一个开源、跨平台的 DeepSeek Harness 桌面客户端。它使用 Go 和 Wails 将官方 @deepseek-ai/dsh Web UI 封装为原生窗口，为 DSH 提供更直接的桌面启动、进程管理和日志查看体验。
项目官网 · 下载最新版 · 查看 DeepSeek Harness · 报告问题
[!IMPORTANT] 本项目是社区维护的非官方桌面壳，与 DeepSeek 或 DeepSeek AI 无隶属关系。DeepSeek Harness 仍处于开发者预览阶段，其功能和接口可能发生变化。
什么是 DeepSeek Harness Desktop？
DeepSeek Harness Desktop 是 DeepSeek Harness 的桌面启动器和原生容器，也可以理解为一个非官方 DSH GUI 客户端。它不重新实现 Harness，而是启动固定版本的官方 npm 包，并在桌面窗口中显示其 Web UI。
项目适合希望通过原生窗口使用 DeepSeek Harness、减少命令行启动步骤，或需要自动管理 DSH 后台进程的 macOS、Windows 和 Linux 用户。
核心功能
- 跨平台桌面应用：支持 macOS、Windows 和 Linux。
- 原生应用体验：提供独立窗口、Dock/任务栏图标和应用菜单。
- 自动启动 DSH：通过
npm exec获取上游使用的 pnpm，再拉取并运行固定版本的@deepseek-ai/dsh。 - 可靠的进程管理：关闭窗口或退出应用时清理
npm → pnpm → node → dsh进程树。 - 稳定的窗口恢复：保留 Wails 原生容器，修复 macOS 最小化后恢复白屏的问题。
- 局域网手机远程：同一 Wi-Fi 下扫码即可在手机浏览器操控当前 DeepSeek Harness。
- 预装常用插件：启动时把 diff-review、subagent-max、file-changes、open-editor 四个插件装进 DSH profile，并做版本跟踪与升级。
- 启动状态与错误提示：显示环境检查、首次下载、服务启动和失败状态。
- 日志与故障排查：可在启动页查看日志，也会写入本地日志文件。
- 可配置工作目录：支持通过环境变量覆盖命令、工作区和 DSH Home。
DeepSeek Harness 的对话、模型、插件、会话和设置能力均由上游项目提供。本项目只负责桌面容器、启动流程和子进程生命周期。
手机远程（局域网）
电脑和手机连在同一个可信 Wi-Fi 后，在启动面板点击「开启」，用手机扫描二维码即可打开当前 DeepSeek Harness。无需账号、无需云端中继，任务、会话和文件仍留在电脑上。
- 通过带一次性配对码的二维码完成设备配对，成功后写入 HttpOnly 设备凭据
- 重新生成配对码只会替换尚未使用的配对码；已配对设备需在设备列表中单独撤销
- 关闭手机远程后会停止局域网代理并清除待使用的配对码，已配对设备记录会保留
当前版本通过自签名 HTTPS 在可信局域网内直连，并显示证书指纹供核对；它不是公网远程访问。请勿直接暴露到互联网。
下载与安装
运行 DeepSeek Harness Desktop 前，请先安装 Node.js 22.19+（22.x）或 24+。应用依赖 Node.js 附带的 npm 下载和启动 DSH。
前往 GitHub Releases 下载对应平台的安装包：
| 平台 | 架构 | 发布文件 |
|---|---|---|
| macOS | Intel + Apple Silicon | dsh-desktop-darwin-universal.dmg 或 .zip |
| Windows | amd64 | dsh-desktop.exe |
| Linux | amd64 | dsh-desktop-linux-amd64.tar.gz |
macOS
下载并打开 DMG，将应用拖入 Applications。由于当前发布包未签名，首次启动时可右键应用并选择“打开”。
也可以在终端移除下载隔离标记：
xattr -d com.apple.quarantine "/Applications/dsh-desktop.app"
Windows
下载 dsh-desktop.exe 后直接运行。若 Windows SmartScreen 提示未知发布者，请确认文件来自本仓库的官方 Release 页面。
Linux
下载并解压 dsh-desktop-linux-amd64.tar.gz，然后运行其中的 dsh-desktop 可执行文件。桌面环境需要 WebKitGTK 等常规 Wails 运行依赖。
工作原理
应用启动后会完成以下流程：
- 检查本机能否找到 Node.js 和
npm。 - 通过
npm exec获取固定版本的 pnpm，在独立缓存中运行固定版本的@deepseek-ai/dsh。 - 优先使用本地端口
3080；端口被占用时自动选择可用端口。 - 轮询 DSH Web 服务，等待其返回成功响应。
- 在保留 Wails 顶层容器的前提下，通过全屏页面载入 DSH UI。
- 窗口关闭或应用退出时，终止完整的 DSH 子进程树。
DeepSeek Harness Desktop (Wails / Go)
└── npm exec --package=pnpm@11.7.0 -- pnpm dlx @deepseek-ai/dsh web --no-open
└── node / dsh
└── Local Web UI on 127.0.0.1
应用默认固定上游版本 @deepseek-ai/dsh@0.1.1-rc.2，避免每次启动因上游最新版变化而产生不可预测的行为。
配置
| 环境变量 | 作用 |
|---|---|
DSH_COMMAND |
覆盖启动命令，例如 DSH_COMMAND="pnpm dsh" 或本地 DSH 可执行文件路径 |
DSH_WORKSPACE |
设置 DSH 工作目录；默认使用当前用户主目录 |
DSH_HOME |
透传给 DSH，用于控制 profiles 等数据的位置 |
应用日志默认保存在：
~/.dsh-desktop/logs/dsh.log
应用使用独立 npm 缓存和 pnpm store，减少共享执行缓存损坏或并发访问造成的 sh: dsh: command not found 问题。
从源码构建
开发环境需要：
- Go 1.23+
- Node.js 22.19+（22.x）或 24+
- Wails v2.11+
安装 Wails CLI 并构建：
go install github.com/wailsapp/wails/v2/cmd/wails@v2.11.0
wails build
macOS 构建产物位于：
build/bin/dsh-desktop.app
启动开发模式：
wails dev
常见问题
这是 DeepSeek 官方项目吗？
不是。DeepSeek Harness Desktop 是社区维护的非官方开源项目。官方 Harness 源码位于 deepseek-ai/deepseek-harness。
它与 DeepSeek Harness Web UI 有什么区别？
界面和核心能力来自官方 DSH Web UI。本项目增加原生桌面窗口、自动启动、端口选择、日志展示、进程清理和跨平台发布包。
为什么必须安装 Node.js？
DeepSeek Harness 通过 npm 发布。桌面应用使用 Node.js、npm exec 和固定版本的 pnpm 下载并运行固定版本的 @deepseek-ai/dsh，因此当前版本不是完全独立的离线安装包。
关闭应用后 DSH 还会在后台运行吗？
正常关闭窗口或退出应用时，桌面壳会终止完整的 npm → pnpm → node → dsh 进程树。若应用被操作系统强制终止，仍建议通过任务管理器确认是否存在异常残留进程。
数据和设置保存在哪里？
会话、模型、插件和设置由上游 DeepSeek Harness 管理。可通过 DSH_HOME 调整其 profiles 等数据目录；桌面壳自己的日志保存在 ~/.dsh-desktop/logs/。
首次启动为什么比较慢？
首次运行需要通过 npm 下载 DeepSeek Harness 及其依赖，耗时取决于网络和 npm registry。完成缓存后，后续启动通常会更快。
出现白屏或启动失败怎么办？
先确认 node --version 和 npm --version 可用，再查看启动页日志或 ~/.dsh-desktop/logs/dsh.log。提交 Issue 时请附上操作系统、应用版本和相关日志。
发布流程
推送 v* 标签会触发 GitHub Actions，为 macOS universal、Windows amd64 和 Linux amd64 构建产物，并创建 GitHub Release。
git tag v0.1.7
git push origin v0.1.7
更新 DeepSeek Harness 版本时，请修改 dsh.go 中的 dshPackage 常量并完成真实启动测试。
许可证
DeepSeek Harness Desktop 使用 MIT License。上游 DeepSeek Harness 也采用 MIT License，但两者是独立项目。
如果这个项目对你有帮助，欢迎提交 Issue、Pull Request 或 Star。
相关推荐Related
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
Tencent/WeKnora
Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-m…
- Nagi-ovo/voyager Enhancement suite for Gemini, AI Studio, Claude & ChatGPT — plus a prompt manager for any web UI, DeepSeek Harness inclu…
-
anywhere-labs/deepseek-harness-desktop
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。
-
EverMind-AI/EverOS
One portable memory layer for every AI agent: local-first, Markdown-native, user-owned, and self-evolving across apps, t…
-
freestylefly/awesome-gpt-image-2
Prompt as Code | GPT-Image2 工业级提示词引擎与模板库，470+ 个案例逆向工程，20+ 套工业级模板，并提炼出Skills，持续更新中