桌面端托管壳DolphinMiner/deepseek-desktop

DSH Desktop

CI
License

English

DSH Desktop 是一个独立的社区项目，用 Electron 在 macOS 桌面端托管官方
DeepSeek Harness Web UI。

[!IMPORTANT]
当前版本是面向 Apple Silicon 的早期 MVP，尚未签名和公证。本项目与
DeepSeek 没有关联，也未获得 DeepSeek 官方背书。

功能展示

DSH Desktop 运行官方 DeepSeek Harness Web UI

MVP 刻意保持很薄：

1. Electron 启动项目锁定版本并随应用打包的 @deepseek-ai/dsh 进程。
2. Harness 只监听 127.0.0.1，端口由操作系统随机分配。
3. Electron 验证健康状态后，在原生窗口中加载官方 Web UI。
4. 应用退出时，Electron 负责停止 Harness 子进程。

项目不 fork 或修改 Harness 的 Agent 循环、模型适配器、会话存储、工具和
Web UI。跨平台复用依赖 Electron 和官方 React Web UI，不依赖 React Native。

架构边界

Electron 主进程
-> 启动并托管 dsh CLI 子进程
-> 等待本机回环地址上的健康检查
-> 在沙箱窗口中加载官方 Harness Web UI
-> 应用退出时停止子进程

Harness 仍然是 Agent、模型调用、工具、会话、审批和持久化的唯一事实来源。
Electron 层只负责窗口、进程生命周期、导航策略和启动页所需的少量 IPC。

环境要求

- Apple Silicon Mac，当前仅打包 arm64 版本
- Node.js 24
- npm 10 或更高版本

本地开发

nvm use
npm ci
npm run check
npm start

生成未签名的 Apple Silicon 应用：

npm run package:mac
open "release/mac-arm64/DSH Desktop.app"

生成未签名的 DMG 和 ZIP：

npm run dist:mac

本地数据

Harness 数据保存在：

~/Library/Application Support/DSH Desktop/harness

运行日志保存在：

~/Library/Logs/DSH Desktop/harness.log

Electron 层不会读取或复制模型凭据。官方 Harness 的凭据提供器会把凭据
保存在它自己的数据目录中。日志和本地数据都应视为敏感信息。

安全模型

Harness 仅监听 127.0.0.1。Electron 渲染进程启用沙箱并关闭 Node.js
集成；外部导航会被拦截；桌面 IPC 只接受来自内置启动页精确地址的调用。
安全问题请按 SECURITY.md 私下报告。

当前限制

- 仅提供 Apple Silicon 构建。
- 尚未进行代码签名和 Apple 公证。
- 暂无自动更新。
- 原生通知、Dock 集成、Keychain 和 Computer Use 尚未实现。

Computer Use 属于更大的独立能力，需要明确申请屏幕录制和辅助功能权限，
并提供严格限制的截图、点击和键盘操作。仅把 Harness 放进 Electron 窗口，
并不会自动获得这些能力。

参与贡献

提交 PR 前请阅读 CONTRIBUTING.md。桌面宿主相关问题在
本仓库处理；Agent、模型、工具、会话和官方 Web UI 问题请提交到
DeepSeek Harness。

版本变化记录在 CHANGELOG.md。本项目采用
Apache-2.0 许可证，依赖许可证见
THIRD_PARTY_NOTICES.md。