DSH Desktop

DeepSeek Harness 桌面端 —— 基于 ElectroBun 的原生桌面壳。

不再需要先开终端跑 dsh web：双击应用，它自动在后台启动 DeepSeek Harness 引擎、 等端口就绪后在原生窗口里打开完整 GUI，退出时干净地停掉引擎。

与 deepseek-harness 仓库完全解耦：本应用只是引擎的外壳，引擎来自 npm 上最新的 @deepseek-ai/dsh，引擎自身仍跑在 Node 上。

特性

• 自动跟进最新引擎：每次启动时检查 npm 上的最新 @deepseek-ai/dsh，发现新版本就自动 下载安装到用户数据目录（内置 pnpm + Node），下次启动直接用最新版——不需要重新打包。 离线时优雅回退到应用内置的离线引擎。
• 自包含后端：pnpm backend:provision 把一份 @deepseek-ai/dsh 和 Node 运行时打进 应用作为离线兜底，新机器无网络也能用。
• 动态端口：以 dsh web --port 0 启动（OS 分配端口），从 dsh web: http://… 输出行 解析真实地址——不会再撞上固定 3080 端口（比如另一个正在运行的 Harness）。
• 启动加载页：打开窗口先显示品牌化启动页（含更新进度），引擎就绪后自动切换到真实 GUI。
• 系统托盘：打开窗口 / 在浏览器中打开 / 重新启动引擎 / 检查并更新引擎 / 退出； 关闭窗口后应用留在托盘，引擎继续运行。
• 单实例：Windows 用命名互斥量（进程退出自动释放），其余平台用 PID 锁文件。
• 干净退出：退出时用 taskkill /T 终止引擎进程树。

架构

DSH Desktop (ElectroBun)
  ├─ 主进程 (Bun): src/bun/index.ts
  │    ├─ 单实例检查
  │    ├─ 解析后端来源（内置 → 本地源码 → npx 兜底）
  │    ├─ spawn dsh web --port 0（stdout 解析 URL 行）
  │    ├─ 加载页窗口 → 就绪后 loadURL(真实 GUI)
  │    └─ 托盘 / 关闭到托盘 / 退出时 kill 进程树
  └─ 后端（未改动）: @deepseek-ai/dsh web，跑在 Node + 自带原生插件上

需求

• Bun（构建/开发工具链）
• Windows 10/11（Edge WebView2 运行时，系统已预装）；macOS/Linux 架构兼容但未验证
• 实际使用模型需要 DEEPSEEK_API_KEY（沿用你的 ~/.dsh 与 .env）

开发

bun install
bun start          # 运行已构建的应用（或 bun dev：构建并运行）
bun run dev:watch  # 改动自动重建

开发态默认从相邻的 ../deepseek-harness 源码 checkout 启动后端（等价于 node --import tsx/esm apps/cli/src/bin.ts web --port 0），方便迭代。

配置（环境变量）

变量	默认	说明
DSH_DESKTOP_BACKEND_DIR	内置 resources/backend	显式指定后端目录
DSH_DESKTOP_NODE	内置 resources/node，否则 PATH	显式指定 Node 可执行文件
DSH_DESKTOP_DEV_BACKEND	../deepseek-harness	开发用的源码 checkout 路径
DSH_DESKTOP_USER_DATA	%LOCALAPPDATA%\dsh-desktop 等	日志与单实例锁目录

内置后端（离线兜底）

pnpm backend:provision   # 安装 npm 最新 @deepseek-ai/dsh 到 resources/backend，并拷贝 Node 运行时 + pnpm
pnpm backend:pin 0.1.0-rc.6   # 固定一个具体版本
pnpm backend:check       # 对比内置版本与 npm 最新版（有新版本时退出码 2）
pnpm gen:icons           # 重新生成托盘/应用图标

resources/backend/VERSION 记录内置版本。日常使用不需要手动重打包：应用启动时会自动检查 npm 上的最新版并安装到 %LOCALAPPDATA%\dsh-desktop\backend；重新执行 backend:provision 只是为了刷新这份离线兜底（比如给离线机器分发时）。

打包

pnpm build:stable      # 产出 artifacts/ 下的构建产物 + Setup.zip
pnpm build:installer   # 产出图形化 NSIS 安装程序：artifacts/DeepSeek Harness-Installer.exe
pnpm build:portable    # 产出单文件自解压包：artifacts/DeepSeek Harness-Setup.exe

build:installer 需要 NSIS（makensis；可用 DSHP_NSIS_MAKENSIS 指定路径，或加入 PATH）。

macOS 构建必须在 macOS 上进行（ElectroBun 面向当前机器系统构建）。

分发给他人

首选：图形化安装程序 artifacts/DeepSeek Harness-Installer.exe（约 79MB）。

1. 把这一个 exe 发给对方，双击即出现标准 Windows 安装向导：欢迎页 → 选择安装目录 → 进度条 → 完成（勾选"运行 DeepSeek Harness"）。
2. 默认安装到 %LOCALAPPDATA%\Programs\DeepSeek Harness（免管理员），创建桌面和开始菜单 快捷方式，并注册"应用和功能"里的卸载项（带 Uninstall.exe）。
3. 对方的机器需要：
   • Windows 10/11（系统自带 WebView2 运行时；很老的系统可能缺，需要装 WebView2）。
   • 自己的 DEEPSEEK_API_KEY：在应用界面里按引导配置（设置 → 模型/提供商），或设置同名 环境变量。程序本身完全自包含，不需要装 Node / npm / pnpm。
4. 首次启动会自动检查并安装最新引擎（在线约 200MB 下载；离线直接用内置引擎）。
5. 安装包未签名，Windows SmartScreen 可能提示"已保护你的电脑"——点"更多信息 → 仍要运行"即可。

备用：build:portable 产出单文件自解压包（DeepSeek Harness-Setup.exe，无向导）； build:stable 的 zip 是原始分发包（需解压）。日常分发用图形化安装程序。

已知限制

• 关闭主窗口后应用驻留托盘；如系统托盘创建失败，关闭窗口会直接退出。
• macOS 用 WKWebView（Safari 内核），尚未在此环境验证 dsh 前端行为。
• 首次更新会下载并安装最新引擎（约 200MB，视网络而定），期间加载页会显示进度。
• 应用外壳自身更新（ElectroBun Updater / bsdiff 增量）尚未接入——引擎版本已自动跟进， 外壳基本不再需要更新。