桌面客户端打包器csthinker/deepseek-harness-desktop

DeepSeek Harness 桌面版

一个自包含的 Windows 桌面外壳，用于 DeepSeek Harness
Web UI。双击 exe，应用便会在自己的原生窗口中打开——无需
npx 命令，也无需浏览器。捆绑的 Node 服务器、所有
插件以及构建好的 Web 前端都随包一同发布；目标
机器无需安装 Node.js。

完全使用 DeepSeek Harness（dsh）构建。
本仓库——Electron 外壳、载荷构建流水线、CI
工作流以及本 README——均由运行于
DeepSeek Harness（dsh）内部的智能体端到端生成。

请参阅构建过程记录以查看截图和成本。

下载

每个版本发布两个产物：

| 产物 | 用途 |
| --- | --- |
| DeepSeekHarness--portable.exe | 双击即可运行。 自解压到临时目录，无需安装。 |
| DeepSeekHarness--x64.zip | 解压并运行。 解压到任意位置，然后双击 DeepSeek Harness.exe。 |

首次启动会解压一次服务器载荷（约 30 秒）；之后的启动
只需几秒钟。应用数据（会话、设置、配置文件）位于 ~/.dsh，
与 CLI 写入的位置完全一致。

本项目是什么

DeepSeek Harness 附带一个浏览器 UI（dsh web，服务于 http://127.0.0.1:3080）。
本项目将其封装为桌面应用：

- main.cjs —— Electron 主进程。它针对
捆绑的服务器载荷启动一个捆绑的 node.exe，等待 dsh web: URL 行，然后在该源上打开一个
BrowserWindow。harness 从不在 Electron 自身的
Node 运行时内运行（其原生插件与捆绑的 Node 进行了 ABI 匹配）。
- scripts/build-server.mjs —— 生成 server/，即 @deepseek-ai/dsh 的生产 pnpm deploy
闭包，其中每个 @deepseek-ai/ 工作区包
（包括仅作为 peer 的包、vendored 包，以及 koffi 的原生 FFI 绑定）
都被重新实体化为真实的、无符号链接的文件。
- scripts/archive-server.mjs —— 将 server/ 打包为单个 server.tar。
- scripts/copy-node.mjs —— 将当前活动的 Node 可执行文件复制为 node/node.exe。
- scripts/sync-version.mjs —— 将 harness 版本复制到 package.json。
- after-pack.cjs —— electron-builder 钩子，将 server.tar 和
node.exe 放入打包后的 resources/。

为什么使用 tar 归档

服务器载荷在 node_modules 下有约 34 000 个文件。electron-builder 的
extraResources 过滤器会丢弃直接位于
from 目录下的 node_modules 目录，而 NSIS 的 File /r 会在文件
数量超过较大值后静默丢弃文件。发布单个 server.tar（首次启动时解压一次到 userData）
可将便携式安装程序保持在少量文件，并规避这两个限制。

构建过程

先决条件

- Node.js ^22.19 || >=24
- pnpm 11.x
- 一份 DeepSeek Harness 检出（已克隆并构建）

1. 构建 harness

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build

2. 构建桌面安装包

cd deepseek-harness-desktop
npm install                        # electron + electron-builder
node scripts/build-server.mjs --harness ../deepseek-harness
node scripts/copy-node.mjs
node scripts/archive-server.mjs
node scripts/sync-version.mjs ../deepseek-harness
npx electron-builder --win portable zip --publish never

或者，在 harness 构建完成后，运行 npm run dist（它会串联服务器载荷、
node 复制、归档和打包步骤）。

产物输出到 dist/：

- dist/DeepSeekHarness--portable.exe
- dist/DeepSeekHarness--x64.zip（electron-builder 的 zip 目标）

在无法直接访问 GitHub 的网络上，请在 npm install
和 electron-builder 之前设置以下环境变量：

export ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
export ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/

持续集成

.github/workflows/build-release.yml 使发布与上游保持同步：

- 监控 — 一个定时任务每 6 小时轮询
deepseek-ai/deepseek-harness
（其 master 分支 package.json 中的版本号）。
- 版本同步 — 桌面版发布使用与上游完全一致的版本号
（例如 0.1.0-rc.6）；仅当版本发生变化时才触发构建（或在
workflow_dispatch 时触发，可选带 force）。
- 构建 — 在 windows-latest 上：检出 harness，执行 pnpm install +
pnpm run build，构建服务器载荷，然后用 electron-builder 打包
portable exe 和 zip。
- 发布 — 发布一个标签为 v 的 GitHub release，包含两个
产物（当版本号包含 - 时标记为预发布）。

许可证

MIT。本项目是
DeepSeek Harness 的桌面打包版，
后者本身也采用 MIT 许可证。

中文说明

DeepSeek Harness 桌面版：把 DeepSeek Harness 的 Web UI 封装成独立的
Windows 桌面程序，双击即可在原生窗口中使用，无需 npx 命令、无需浏览器。
程序内置了 Node 运行时、全部插件和已构建的前端，目标机器无需安装 Node.js。

本仓库（Electron 外壳、载荷构建脚本、CI 工作流、本 README）全程由
DeepSeek Harness（dsh）中的 agent 完成*。

构建过程截图与花费见 构建过程记录。

每次 Release 提供两种产物：-portable.exe（双击即用）与 -win64.zip
（解压即用）。构建流程见上文；CI 会每 6 小时监控上游版本，版本更新时自动编译
exe 与 zip 并发布同名版本号的 Release。项目采用 MIT 协议开源。