DeepSeek Harness — Desktop 客户端（Electron 薄外壳）
⚠️ 注意：本程序不是独立项目。需要先
git clone https://github.com/deepseek-ai/deepseek-harness.git编译 Harness 源码，再将本目录（desktop/）拷贝到 Harness 仓库中进行编译，生成客户端可执行文件。
把 DeepSeek Harness 的 dsh web 运行时以原生窗口形式交付的 Electron 薄外壳。
Harness 本体是一个 Node 进程（dsh web = --profile web，boot host 运行时 + webserver +
构建好的 React 前端，监听 http://127.0.0.1:3080）。所有重活都在这个进程里；本外壳只负责：
- 拉起 harness 运行时（
desktop/main.mjs） - 等待其打印的地址（默认
http://127.0.0.1:3080） - 在原生
BrowserWindow中渲染该地址，并管理 harness 子进程的生命周期
这个方案贴合项目官方设计路线：架构笔记《GUI 分层与 RPC 协议》明确预留了
“在 Electron 中使用与 dsh web 相同的 Web 技术启动”。本外壳复用现有的 host/client
全部能力，无需重复实现任何业务逻辑。
两种运行模式
| 模式 | 判定 | harness 来源 | Node 来源 |
|---|---|---|---|
| 开发 | app.isPackaged === false（或 DSH_DEV=1） |
检出的仓库 apps/cli/lib/bin.js --profile web |
系统 node（复用仓库 node_modules 与原生插件） |
| 打包 | app.isPackaged === true |
resources/runtime 部署闭包 |
resources/node（可选，本地捆绑） |
目录结构
desktop/
main.mjs Electron 主进程（薄外壳）
electron-builder.yml 打包配置（Windows x64: nsis + portable）
package.json 仅含 electron / electron-builder 开发依赖
scripts/
dev.mjs 开发模式启动
prepare-runtime.mjs 预安装全部依赖 + 可选 Node/Python 运行时
resources/ (gitignore) 预安装的运行时载荷
runtime/ harness 部署闭包：node_modules + dsh bin + web dist
node/ (可选) 捆绑的 Node 运行时
python/ (可选) 捆绑的 Python 运行时快速开始
前置
- 仓库根目录已
pnpm install且pnpm build（apps/cli/lib与apps/web/dist已生成）。 - 首次运行需在
desktop/安装外壳依赖：
pnpm --dir desktop install # 或 cd desktop && npm install开发模式（验证本地可启动）
pnpm --dir desktop dev会拉起仓库的 dsh web 并打开原生窗口加载 UI。开发模式直接复用仓库现有
node_modules 与原生插件，不压缩、不生成产物——用于快速验证。
预安装全部依赖与运行时
pnpm --dir desktop prepare:runtime该脚本会把：
- 全部 Node 依赖（
@deepseek-ai/*插件 + 三方依赖 + Web 前端 dist）通过
pnpm deploy物化为自包含的resources/runtime闭包——即“预先安装所有依赖”。
前端 dist 经require.resolve('@deepseek-ai/dsh-web-frontend/dist/index.html')
通过 node_modules 解析，因此闭包天然自包含，无需改路径。 - Node 运行时（可选）：设置
DSH_VENDOR_NODE=1会下载 Node win-x64 到
resources/node，让最终用户无需安装 Node。 - Python 运行时（可选）：设置
DSH_PYTHON_SOURCE=<便携 Python 目录>会将其
拷贝到resources/python（供 Python SDK / code-runtime 离线使用）。
说明：为免影响你正在快速迭代的仓库，
desktop/不在 pnpm workspace 里，是独立
自包含工程，拥有自己的依赖与忽略规则。
打包 Windows 安装器
先 prepare:runtime 生成载荷，再：
pnpm --dir desktop build:win在 desktop/dist/ 生成 DeepSeek Harness-Setup-<version>.exe（nsis 安装器）与
DeepSeek Harness-Portable-<version>.exe（绿色版）。二者都内嵌 resources/runtime
（+ 可选的 node/python），离线可用。
一次性说明 / 注意
- 原生插件 ABI：
prepare:runtime物化的 node_modules 里的原生模块
（node-pty、koffi、better-sqlite3 等）是在打包机器的 Node 版本下构建的。若最终
用户机不装 Node，请在打包机用DSH_VENDOR_NODE=1捆绑同一个 Node 版本，
使 ABI 匹配。开发模式不受此影响（直接用系统 Node）。 - Visual C++ 运行时（重要）：闭包内的原生模块（尤其 koffi 驱动的"打开文件夹"
对话框）依赖msvcp140.dll / vcruntime140.dll / vcruntime140_1.dll（VC++ 2015-2022
Redistributable）。未安装该运行时的机器上，目录选择会失败，报
... worker exited before reporting a result。prepare:runtime会自动从构建机
System32把这几个可再分发 DLL 拷贝到resources/node/，main.mjs将resources/node
注入 harness 的 PATH；因此无需用户另行安装运行库。这些 DLL 属于可再分发组件，
可随客户端分发。 - 原生选择器自动降级：Windows 原生"打开文件夹"对话框在子进程里用 koffi 驱动
COM。若某台机器上它的依赖无论如何无法初始化（CRT/ABI 损坏、shell COM 异常等），
harness 启动时会先对原生对话框做一次无窗口自检；自检失败则自动改用
browse交互（客户端内置的纯 Web 目录树，不依赖任何原生组件），保证在所有机器上
都能选择文件夹，而不是抛worker exited before reporting a result。启动日志会打印
falling back to the browse picker提示。 - 退出清理：窗口关闭/应用退出时，外壳会
taskkill /T /F拉起的 harness
进程组，避免遗留 node-pty / sandbox 子进程。 - 自定义图标：把
desktop/assets/icon.ico放入并在electron-builder.yml的
win.icon上引用（当前用 Electron 默认图标）。