DeepSeek Harness 桌面版（Electron 便携打包工程）

August 13, 2026 · View on GitHub

把 DeepSeek Harness（dsh web）打包成 Windows 上双击即用的单文件便携 .exe：打开后弹出独立桌面窗口，无需在浏览器里访问本地网页。

  • 底层：Electron 外壳 + DeepSeek Harness（MIT）
  • 便携包：NSIS 静默解压到 %TEMP% 后直接运行，退出时自动清理，不弹任何 setup 窗口

仓库内容

├── main.js                 Electron 主进程（启动 harness、等就绪后开窗口）
├── preload.js              Electron preload（空，渲染进程不暴露 Node）
├── app-icon.png            应用窗口/任务栏图标
├── package.json            electron + electron-builder 配置
├── build-portable.ps1      一键打包脚本（--dir → 拷贝运行时 → 自检 → tar → NSIS）
├── portable/
│   └── portable.nsi        NSIS 便携脚本（静默解压 + 运行 + 清理）
└── resources/
    ├── icon.png / icon.ico 程序图标
    └── ico/                多尺寸 ICO

前置要求

  • Windows 10/11 x64
  • Node.js ≥ 22.19（本工程用 Electron 内置 Node 22.22 运行 harness）
  • pnpm
  • 一个已准备好的 DeepSeek Harness 运行时目录（staging\harness），它包含构建好的 apps/cli/lib/bin.js 及完整 node_modules（符号链接必须保留）

如何准备运行时目录

  1. 克隆官方源码并构建： 
    git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install          # 中国大陆可加 `--registry=https://registry.npmmirror.com`
pnpm run build
  2. 把整个目录复制为 本仓库\staging\harness（务必保留符号链接，Windows 下用 robocopy /E /SL 或 tar）。
  3. （可选，减小体积）按运行时闭包裁剪 node_modules 中仅构建/测试用依赖，并重建 node_modules/.pnpm/node_modules 虚拟根；不裁剪也能打包，只是 exe 更大。

打包

cd 本仓库
pnpm install                      # 安装 electron / electron-builder
powershell -ExecutionPolicy Bypass -File build-portable.ps1

产出：portable\DeepSeek Harness-1.0.0-portable.exe（单文件，双击即用，约 500-700MB）。

首次使用：Windows SmartScreen 可能提示"已保护你的电脑"，点 更多信息 → 仍要运行 即可（未签名）。

说明

  • 会话/配置存放在 %USERPROFILE%\.dsh，与 dsh web 内网用法一致。
  • 后台服务监听随机端口（--port 0），不占用固定端口。
  • 应用窗口图标、exe 图标使用 resources/icon.png；如需更换，替换该文件后重新打包。

许可

本工程是 DeepSeek Harness（MIT）的打包外壳，使用 MIT 许可。请保留上游 LICENSE 与 THIRD_PARTY_NOTICES 署名。