deepseek-harness-desktop

跨平台桌面壳，目标是在 Windows 和 macOS 上双击启动 DeepSeek Harness，并复用官方 Web UI。

非官方社区项目。本项目与 DeepSeek 没有隶属或背书关系，DeepSeek Harness 的商标、源码和发布由其原项目维护。

当前状态

这是可运行的 MVP：Electron 主进程负责启动和停止本地 dsh web，窗口加载 127.0.0.1 上的 Harness Web UI。项目不修改 DeepSeek Harness 源码，可以独立发布到 GitHub。

DeepSeek Harness 当前仍处于开发者预览阶段，桌面端默认锁定 @deepseek-ai/dsh@0.1.0-rc.6，升级版本需要单独验证。

开发环境

• Node.js 22+
• pnpm 10+
• macOS 或 Windows

pnpm install
pnpm typecheck
pnpm test
pnpm dev

启动器按以下顺序寻找 Harness：

1. DSH_EXECUTABLE 环境变量；
2. runtime/harness/dsh 或 runtime/harness/dsh.exe；
3. runtime/harness 内固定版本的 @deepseek-ai/dsh@0.1.0-rc.6；
4. 仅当开发依赖不完整时，尝试 PATH 中的 dsh / dsh.exe。

.env.example 仅列出可用变量，应用不会自动读取 .env。开发时请在启动命令所在的 shell 中设置变量。API Key 仍由 Harness 自己的凭据配置管理，不要写入本项目环境文件。

打包

pnpm build
pnpm dist

也可以按平台和架构单独构建：

pnpm dist:mac:arm64
pnpm dist:mac:x64
pnpm dist:win:x64

安装包会把 runtime/harness 作为独立资源携带，并通过 Electron 自带的 Node 运行模式启动，因此用户不需要另行安装 Node.js、pnpm、npx 或 dsh。Harness 与 Electron 壳分开打包，可以避免构建器扫描超大依赖图时耗尽内存。

如果未来官方提供单文件运行时，也可以在打包前放入 runtime/harness/，其优先级高于 npm 依赖：

• macOS: dsh
• Windows: dsh.exe

Harness 含有平台相关的原生依赖。GitHub Actions 会分别在 macOS ARM64、macOS Intel x64 和 Windows x64 runner 上安装依赖并生成对应安装包。不要把 ARM Mac 上交叉生成的 Intel 包作为正式发布产物，因为其中可能混入 ARM64 原生模块。

Windows 安装器使用 ZIP payload，减少安装时解压大量 Harness runtime 文件带来的 CPU 开销。发布版会立即显示本地启动页，同时在后台启动 Harness，并移除应用菜单、关闭 Electron DevTools。

Release Artifacts 工作流支持手动运行。每个 runner 会先启动一次内置 Harness runtime 并访问其本地 Web UI，冒烟通过后才生成安装包。推送 v* 标签时，同一工作流会自动创建 GitHub Release 并上传三平台产物。

架构

Electron main process
  -> spawn bundled dsh web --port 0
  -> parse dsh web: http://127.0.0.1:<port>
  -> BrowserWindow loads the validated loopback URL
  -> app quit terminates the whole Harness process tree

窗口启用了 contextIsolation、禁用 Node 集成和 sandbox。非 Harness 外部链接交给系统默认浏览器打开。桌面端只接受 127.0.0.1 ready URL，不允许子进程日志把窗口导航到远程地址。

GitHub 发布

先在 Actions 页面手动运行 Release Artifacts 验证三平台构建。三项均成功后再推送版本标签，例如 v0.1.0；工作流会自动创建同名 Release。

应用图标已配置。首次公开版本暂不包含 Windows/macOS 代码签名、macOS notarization 和自动更新，安装时系统可能显示未验证开发者或安全提示。DeepSeek Harness 本身及其第三方依赖继续遵循各自许可证，发布时需要保留对应 notices。