eshmeshek/deepseek-harness-desktop

DSH 桌面版

我本来只是想发布这个项目，但 Claude 说“我们必须尽可能在所有地方写明这个仓库是非官方的”。所以就这样吧……

DeepSeek Harness 的桌面启动器、后台服务和更新提示。

与 DeepSeek 无关联

这是一个独立的社区项目。它不是 DeepSeek 的官方产品，也未以任何方式获得 DeepSeek 的认可、赞助或与之关联。harness 本身的所有功劳均归上游所有。

“DeepSeek”和“DeepSeek Harness”是各自所有者的商标。此处使用它们仅是为了如实说明本项目所配合使用的对象，这符合上游品牌指南的许可。应用程序图标是上游项目自己的标志，复用自 MIT 许可的仓库；它表示此启动器所启动的对象，并不构成对作者身份或官方地位的声明。如果上游项目不希望以这种方式使用它，请提交 issue，我们会更改。

它增加了什么

DeepSeek Harness 只提供一个浏览器 UI（dsh web），别无其他：没有桌面应用、没有后台服务，也没有更新器——其中没有任何版本检查，也没有“有可用更新”按钮。DSH 桌面版恰好增加了这三样东西，并且刻意不加更多：

| | |
|---|---|
| 在后台运行 | 关闭窗口后，harness 宿主仍会继续运行，因此正在进行的任务不会受 UI 是否打开的影响。 |
| 一个真正的停止方式 | 一个托盘图标，其退出是唯一会关闭宿主的操作。 |
| 提供更新 | 启动时它会向 npm 询问是否存在更新的 harness，并提供安装选项。绝不自动更新——上游是开发者预览版，会宣布破坏性变更。 |

它不贡献任何自己的界面。 它唯一显示的页面就是 harness 自己的 Web UI。这个应用要表达的一切——进度、失败、更新提议——都通过原生操作系统对话框来传达。

安装

从 Releases 下载安装程序：

| 平台 | 文件 |
|---|---|
| Windows | -setup.exe |
| Linux | .AppImage、.deb 或 .rpm |

macOS 尚未构建：它需要在构建之上进行签名和公证，否则 Gatekeeper 会直接拒绝下载的 .dmg。

不发布 .msi。 它最初被构建过，但后来被放弃了：它无法正常工作，而且无论如何它都是慢的那个——在一台机器上以相同内容测量，直接复制载荷文件耗时 7.6 秒，NSIS 安装程序耗时 10 秒，而 MSI 超过一分钟。MSI 会将约 14,000 个捆绑文件中的每一个都注册为独立组件，并为每个组件记录回滚日志，这不是靠任何精简能解决的。

在 Linux 上，.AppImage 完全无需安装：使其可执行并运行即可。.deb 和 .rpm 还会额外添加一个菜单项。
无需安装其他任何东西。 不需要 Node.js，不需要 npm，不需要 pnpm，不需要 git，也不需要
检出代码：该应用自带 Node 运行时和自己的包管理器。安装它并运行即可。

（如果机器恰好自带合适的 Node，而捆绑的副本不知为何无法运行，应用会回退到它，而不是拒绝启动。）

工作原理

没有任何补丁、分支或内置副本。上游完全按照 npm 上发布的内容被使用：

/runtimes//node_modules/@deepseek-ai/dsh/lib/bin.js

每个版本都落在自己的目录中，因此更新是目录切换而非修改，并且上一个版本会保留在磁盘上作为回滚目标。启动时，应用以 dsh web --no-open --port 0 启动该二进制文件，读取宿主打印的环回 URL，并在原生窗口中打开它。

捆绑了什么，以及为什么

| | 大小 | 为什么不留给机器处理 |
|---|---|---|
| Node.js（固定 LTS 版本） | 约 90 MB | 该 harness 是一个 Node 应用。要求预装 Node 会让“下载、安装、运行”变得不成立。构建时从 nodejs.org 获取，并在进入任何安装程序之前根据发布的 SHA-256 进行校验。 |
| DeepSeek Harness | 约 240 MB | 这样首次启动就是即时且离线的。改为在首次运行时下载它，意味着二十秒的空白，无法显示进度，并且在最糟糕的时刻硬依赖网络。在安装期间下载它不可移植：macOS 安装是拖入 /Applications，根本没有安装时脚本。 |
| pnpm | 约 19 MB | 见下面的测量结果。 |

这三者都在构建时准备好，因此安装是唯一需要网络的步骤。首次启动会就地读取捆绑的 harness——已验证可从写入被拒绝的目录（也就是 Program Files）中运行——并在大约两秒内启动。更新仍然来自 npm，进入应用数据目录，在其之上进行。

为什么用 pnpm 而不是 npm

该 harness 不是一个包，而是大约一百个单独发布的 @deepseek-ai/dsh-* 模块，解析后约 500 个包。在同一台机器、相同网络和注册表上测量：

| 安装器 | 结果 |
|---|---|
| npm install | 12 分钟后仍在解析，写入 0 字节 |
| pnpm add | 22 秒完成——504 个包，243 MB |

因此，包管理器不能留给机器上现有的任何东西：使用 npm 时，首次启动不是慢，而是实际上无法工作。应用内附带了一份 pnpm（约 19 MB）并直接驱动它，这也意味着机器不需要自己的包管理器。

每个已安装的 harness 版本预算约 250 MB；应用保留当前版本和一个先前版本，并且文件从共享存储硬链接而来，因此两个版本的成本远低于两倍。

这也让更新保持简单：更新意味着获取更新的上游，而不是将本地更改变基到它上面，因为没有任何本地更改需要变基。

从源码构建

需要 Rust、Node.js 和
你的平台的 Tauri 先决条件。

npm install
npm run dev      # 运行它
npm run build    # 为当前平台生成安装程序

跨平台构建产物由 CI 在推送标签时构建；单台机器只能
为其自身操作系统打包。

许可证

MIT。DeepSeek Harness 本身在上游采用 MIT 许可证，且不在此处
重新分发——它在运行时从 npm 下载。