桌面客户端 MonshinYu/dsh-desktop

DeepSeek Harness 桌面版 (dsh-desktop)

DeepSeek Harness 的桌面客户端。为 @deepseek-ai/dsh 提供原生桌面外壳：内置 Bun 打包的 dsh 运行时、系统托盘、开机启动 dsh 本地服务，并以 iframe 承载其 Web 界面。

特性

- 零依赖运行时 — dsh 运行时由 Bun 编译为单个可执行文件 (runtime/dsh)，随应用一起分发，无需用户安装 Node.js
- 兼容层 — 通过影子化 node_modules 与 Node 子进程重定向，让 dsh 在 Bun 下以与 Node 完全一致的方式启动
- 嵌入式 zstd archive — node_modules 与兼容层以自定义 DSHA 格式（zstd 单 frame）内嵌进二进制，首次启动解压到 ~/.cache/dsh//，内容不变缓存永久有效
- 系统托盘 — 显示/隐藏窗口、使用默认浏览器打开、开发者控制台、退出；关闭窗口最小化到托盘
- 自动端口管理 — 启动时自动选择可用端口，运行中若端口变化（dsh 重启）前端自动跟随跳转
- 启动动画 — 加载态 splash（品牌 logo 绘制动画），dsh 服务就绪后淡出并载入 iframe

架构

┌─────────────────────────── dsh-desktop ───────────────────────────┐
│ │
│ ┌─────────────────────────────┐ ┌──────────────────────┐ │
│ │ Tauri shell (Rust) │ │ Frontend (TS/Vite) │ │
│ │ · 启动/守护 runtime/dsh │ IPC │ · splash 加载动画 │ │ │ │ · 系统托盘 │◄─────►│ · 轮询 check_page │ │ │ │ · 端口分配与监控 │ port │ · iframe 承载 Web UI │ │ │ └──────────────┬──────────────┘ └──────────┬───────────┘ │ │ │ spawn │ http:// │ │ ▼ ▼ │ │ ┌─────────────────────────────────────────────────────────────┐ │ │ │ runtime/dsh (Bun 编译的独立可执行文件) │ │ │ │ ┌───────────────────────────────────────────────────────┐ │ │ │ │ │ main.ts 启动器 │ │ │ │ │ │ · dev: 直接用源码树，不碰 archive │ │ │ │ │ │ · bin: 解压 .dsh-archive.bin → ~/.cache/dsh// │ │ │ │ │ │ · spawn bun --preload lib/.dsh-preload.js dsh/bin │ │ │ │ │ └───────────────────────────────────────────────────────┘ │ │ │ │ lib/preload.js 影子 node_modules + Node API 重定向 │ │ │ │ node_modules @deepseek-ai/dsh 及其依赖 │ │ │ └─────────────────────────────────────────────────────────────┘ │ └───────────────────────────────────────────────────────────────────┘

运行时启动流程

1. Tauri shell 在 setup 阶段获取可用端口，spawn runtime/dsh
2. dsh 启动器对内嵌 archive 做 sha256，定位 ~/.cache/dsh//
- 命中 marker → 直接复用缓存，热启动 ≈ 400ms
- 未命中 → 单次 zstd 解压（33k 个文件），冷启动 ≈ 5–6s
3. 前端轮询 check_page（每 1s），dsh 的 HTTP 服务就绪后把 iframe 指向 http://127.0.0.1:
4. 运行期间每 3s 检测端口 generation，端口变化（进程重启）时自动重新加载 iframe

目录结构

dsh-desktop/
├── src/ # 前端：启动 splash + iframe 宿主 │ ├── main.ts # 轮询/加载/端口变更跟随 │ └── assets/ # logo 与图标 ├── src-tauri/ # Tauri 壳 (Rust) │ ├── src/main.rs # 启动 runtime、托盘、窗口事件 │ └── src/core/ # 端口分配、状态存储、托盘 ├── plugins/dsh-bun-pkg/ # Bun 打包插件（独立仓库 clone 而来） │ ├── main.ts # 启动器 │ ├── lib/ # Node 兼容垫片 │ ├── scripts/embed.ts # DSHA 归档构建 │ └── target/dsh # bun build --compile 产物 ├── runtime/ # 构建产物，被 src-tauri 打包为资源 │ └── dsh # 最终随应用分发的可执行文件 ├── scripts/ │ ├── clone_runtime_build_lib.ts # git clone dsh-bun-pkg │ └── build_runtime.ts # bun install → build → runtime/ └── index.html # 宿主页面（splash + iframe）

环境要求

- Bun ≥ 1.x（构建与运行脚本依赖）
- Rust stable + Tauri 2 的系统依赖（macOS：Xcode CLT；Windows：WebView2 + MSVC；Linux：webkit2gtk 等）
- Node.js（仅运行时兼容层重定向 worker_threads 时使用，不是用户要求）

开发

bun install # 安装前端依赖

方式一：先构建运行时再跑 Tauri dev
bun run clone:runtime:lib
bun run build:runtime
bun run tauri dev

构建与打包

bun run tauri:build
= bun run clone:runtime:lib # clone 最新 dsh-bun-pkg
+ bun run build:runtime # bun install + build → runtime/dsh
+ bun tauri build # 产出安装包（dmg/msi/AppImage 等）

runtime/ 与 src/assets/ 作为资源打包进应用（runtime/dsh 约 110 MB）。

常见问题

想强制重新解压运行时缓存？
删除 ~/.cache/dsh/ 即可，下次启动会重新解压。

自定义 dsh-bun-pkg？
scripts/clone_runtime_build_lib.ts 中的 REPO_URL 指向你的 fork 后重新执行 bun run tauri:build。

开发控制台/浏览器打开？
通过托盘菜单：右键托盘图标 → 「链接」→「打开开发者控制台」或「使用默认浏览器打开」。

License

MIT © MonshinYu