deepseek-harness-desktop-macos

English | 中文

Electron 壳启动标准的 dsh web --port 0 界面，等待其回环就绪 URL，然后在采用原生内嵌标题栏的 BrowserWindow 中加载该 URL。主进程拥有 DSH 子进程，并在 Electron 退出前等待子进程优雅关闭。应用不再内嵌任何替代 UI 主题或展示插件。

Prerequisites

源码包可独立构建。先安装桌面端开发依赖，再准备 .desktop-runtime/npm-runtime；运行时会下载固定版本的 DeepSeek Harness 和 pnpm。

npm install
npm run prepare:runtime
npm run check

Development

运行 npm run dev 启动桌面端。设置 DSH_DESKTOP_DSH 可使用显式的 dsh 可执行文件；否则开发模式会使用已准备的固定版本运行时。

macOS build

构建器将 .desktop-runtime/npm-runtime 复制到应用资源中的 harness-runtime，并生成本地临时签名的 arm64 产物。DMG 使用 build/background.png，窗口尺寸为 800 × 500 点，DeepSeek 应用图标位于 (220, 260)，Applications 链接位于 (580, 260)。

npm run build:mac
npm run build:dmg

.app 目录写入 dist/mac-arm64/DeepSeek Harness.app。 DMG 写入 dist/DeepSeek Harness-0.1.0-rc.5-arm64.dmg。

Runtime and data

子进程收到 Electron app.getPath('userData') 作为 DSH_HOME，因此 profiles、node_modules 和 dsh plugin 管理使用标准 Harness 主目录布局。打包运行时会把 harness-runtime/node_modules/.bin 置于 PATH 前端，使 profile 插件操作能够找到 pnpm。

Limitations

构建目标为 macOS arm64，产物采用本地临时签名但未经公证。打包前必须完成运行时准备命令；运行时缺失会以可操作的错误报告启动失败。