DeepSeek Harness Desktop（dsh-desktop）
⚠️ 非官方项目声明 / Disclaimer
本项目为个人开发的 DeepSeek Harness 桌面封装应用，与 DeepSeek（深度求索）官方无任何关联，
非官方发布，未获得官方授权、认可或支持。DeepSeek Harness 官方项目地址：https://github.com/deepseek-ai/deepseek-harness
上游项目基于 MIT License，本应用仅在其基础上做桌面化封装；使用中出现问题请优先查阅
官方文档，本项目不提供官方技术支持。
把 DeepSeek Harness 的 服务器（dsh web） 和 网页前端 打包进一个 Electron 桌面应用。
启动应用 = 自动拉起服务器 + 打开前端窗口，关闭应用 = 自动停掉服务器。
工作原理
┌─────────────────────────── Electron 应用 ───────────────────────────┐
│ 主进程 (main.js) │
│ ├─ 解析 Node 运行时（见下） │
│ ├─ spawn 子进程：node <dsh>/lib/bin.js web --port 0 │
│ │ └─ @deepseek-ai/dsh 服务器（含 @deepseek-ai/dsh-web-frontend │
│ │ 构建好的前端 dist，一并作为依赖打包） │
│ ├─ 等待就绪行 "dsh web: http://127.0.0.1:<port>" │
│ ├─ HTTP 探测 200 后 → BrowserWindow 加载该 URL │
│ └─ 退出时 taskkill /T 清理服务器进程树 │
└──────────────────────────────────────────────────────────────────────┘- 服务器就是官方 dsh CLI：同一个 npm 包、同一套 profile/数据目录（默认 ~/.dsh），
不是重写或简化版。 - 端口：默认 --port 0，由操作系统自动分配空闲端口，避免 3080 被占用时冲突；
也可用环境变量 DSH_DESKTOP_PORT 固定端口。 - 前端：@deepseek-ai/dsh 的依赖 @deepseek-ai/dsh-web-app 会在运行时通过
require.resolve('@deepseek-ai/dsh-web-frontend/dist/index.html') 找到已构建的前端
dist 并托管，因此应用内自带完整网页 UI，无需另外构建前端。
快速开始（开发模式）
要求：Node.js ≥ 22.19（或 ≥ 24）。本机已验证 Node v24.17.0。
cd dsh-desktop
npm install # 安装 electron + @deepseek-ai/dsh（含全部运行时依赖）
npm start # 启动应用国内网络若 Electron 二进制下载慢/失败：已内置 .npmrc 指向 npmmirror 镜像，无需处理。
冒烟测试（无窗口，自动退出）
npm run start:smoke
# 输出 DSH_DESKTOP_SMOKE_OK http://127.0.0.1:<port> 即通过打包成安装程序（Windows）
npm run dist # 先构建 resources/server.zip，再产出 dist/DeepSeek Harness Desktop-0.1.0-setup.exe产物为 NSIS 安装包，安装后可独立运行。安装包内已包含 DSH 服务与前端，目标机器
无需安装 Node（服务器可用系统 Node，或兜底用 Electron 内置 Node 24）。
两段式部署（安装快 + 插件系统兼容）
- 安装包只包含：应用外壳（main.js 等 3 个文件）+ Electron 运行时 + 一个
resources/server.zip（76MB，由npm run server:pack把 @deepseek-ai/dsh
全依赖树打成单文件归档）。安装时只需写少量文件，安装速度远快于逐文件解压
1.5 万个零散小文件。 - 首次启动时，应用把 server.zip 解压到
%APPDATA%\DeepSeek Harness Desktop\server\（真实文件目录）。解压是异步的，
加载窗口立即出现并显示进度（约 10–20 秒），之后启动直接复用，约 6 秒打开。 - 为什么不用 asar 打包服务器？DSH 的插件加载器会在 profile 目录建立指向安装目录
node_modules 的 junction（healProfilesModuleFallback），junction 必须指向
磁盘上的真实目录——asar 归档内的虚拟路径在 OS 层不存在，导致所有
@deepseek-ai/*包解析失败、服务器启动即退出（ERR_MODULE_NOT_FOUND）。
解压成真实文件后该机制正常工作。 - 版本升级：server.zip 内容版本（
SERVER_VERSION，main.js 中）变化时自动重新解压。
Node 运行时的解析顺序（给服务器子进程用）
打包版（asar 已启用）：应用内容（含 node_modules）在 app.asar 里，只有
Electron 自带 Node（ELECTRON_RUN_AS_NODE）能读取该归档，因此打包版固定使用
Electron 内置 Node（v43.4.0 内置 Node 24.18.1，满足 DSH 引擎要求）。
开发版 / DSH_ROOT 源码模式（松散文件，无 asar）依次尝试：
- DSH_NODE 环境变量显式指定；
- 应用内置 Node：把 node.exe 放到 resources/node/；
- 系统 PATH 中的 node（必须满足 ^22.19 || >=24）；
- 兜底：ELECTRON_RUN_AS_NODE=1 使用 Electron 自带 Node。
node-pty 是 N-API 预编译，Node/Electron 通用，无需重编译；服务器启动参数统一
带 --expose-internals（HMR 服务需要，且避开原生插件在 Electron 下失效的问题）。
用本地源码代替 npm 包（改造 / 调试你的源码）
# 方式 A：源码已构建（pnpm install && pnpm run build 之后）
set DSH_ROOT=D:\<你的deepseek-harness源码目录>\deepseek-harness-master
npm start
# 方式 B：未构建的源码（该目录需先 pnpm install，用 tsx 直接跑 TS）
set DSH_ROOT=D:\<你的deepseek-harness源码目录>\deepseek-harness-master
set DSH_DESKTOP_PORT=3080
npm start主进程会优先用