桌面客户端外壳cmmnhm/DeepSeek-Harness-Desktop

DeepSeek Harness — 桌面客户端（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）。所有重活都在这个进程里；本外壳只负责：

1. 拉起 harness 运行时（desktop/main.mjs）
2. 等待其打印的地址（默认 http://127.0.0.1:3080）
3. 在原生 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= 会将其
拷贝到 resources/python（供 Python SDK / code-runtime 离线使用）。

说明：为免影响你正在快速迭代的仓库，desktop/ 不在 pnpm workspace 里，是独立
自包含工程，拥有自己的依赖与忽略规则。

打包 Windows 安装器

先 prepare:runtime 生成载荷，再：

pnpm --dir desktop build:win

在 desktop/dist/ 生成 DeepSeek Harness-Setup-.exe（nsis 安装器）与
DeepSeek Harness-Portable-.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 默认图标）。