deepseek-harness-desktop

DeepSeek Harness Desktop 是一个基于 Electron 的跨平台桌面客户端，将 DeepSeek Harness 的 Web 界面整合到独立的原生窗口中。

项目负责运行环境检测、服务启动、连接管理和桌面端生命周期，让 DeepSeek Harness 可以像普通桌面应用一样启动和使用。支持 Windows、macOS 和 Linux。

本项目为非官方桌面客户端，与 DeepSeek 官方无隶属关系。

主要特性

• 独立桌面窗口，支持系统菜单、单实例和窗口状态记忆
• 自动检测 Node.js 20 及以上版本
• 未找到可用 Node.js 时，可在用户目录中安装免配置运行时
• 自动检测已运行的 DSH 服务，并在需要时启动服务
• 提供启动状态、安装进度、连接失败提示和重新连接功能
• 退出时管理由应用启动的服务进程
• 会话数据保存在 DSH 数据目录中，可与浏览器版共用
• 外部链接使用系统默认浏览器打开

工作方式

应用启动后会连接默认地址 http://127.0.0.1:3080。如果端口上已有 DSH 服务，应用会直接加载它；否则会准备 Node.js 运行环境，然后执行：

npx --yes @deepseek-ai/dsh web --host 127.0.0.1 --port 3080

首次启动可能需要下载 Node.js 和 DSH 依赖，耗时取决于网络环境。

内容	默认位置
DSH 数据目录	~/.dsh/
内置 Node.js 运行时	~/.dsh/node-runtime/
应用日志	~/.dsh/dsh-electron.log

从源码运行

开发环境

• Node.js 20 或更高版本
• npm

启动

git clone https://github.com/AndanteL/deepseek-harness-desktop.git
cd deepseek-harness-desktop
npm install
npm start

构建安装包

npm run dist:mac
npm run dist:win
npm run dist:linux

构建结果位于 dist/ 目录。

平台	默认产物
macOS	DMG
Windows	NSIS 安装包、Portable 免安装版
Linux	AppImage、DEB

Windows 和 Linux 构建命令默认生成 x64 产物。macOS 产物架构与当前构建机一致。

项目默认未配置代码签名。直接分发构建结果时，操作系统可能显示未签名应用警告。

测试

npm test
npm run test:unit
npm run test:e2e

• npm test：运行全部测试
• npm run test:unit：运行单元和集成测试
• npm run test:e2e：启动真实 Electron 窗口运行端到端测试

环境变量

变量	默认值	说明
DSH_HOST	127.0.0.1	DSH 服务地址
DSH_PORT	3080	DSH 服务端口
DSH_START_CMD	npx --yes @deepseek-ai/dsh web	自定义服务启动命令
DSH_KEEP_SERVER	未设置	设为 1 时，退出应用后保留由应用启动的服务
DSH_WAIT_SECS	180	等待服务就绪的最长时间
DSH_HOME	~/.dsh	DSH 数据目录
DSH_NODE_MIRROR	https://nodejs.org/dist	Node.js 下载源
DSH_NODE_SCAN_DIRS	系统常见目录	覆盖 Node.js 安装目录扫描列表

项目结构

.
├── main.js              Electron 主进程
├── node-env.js          Node.js 环境检测与安装
├── loading.html         启动页
├── error.html           连接错误页
├── assets/              运行时资源
├── build/               图标、打包和清理脚本
├── test/                单元、集成和端到端测试
└── package.json         项目配置

许可证与声明

项目源码使用 MIT License。

DeepSeek、DeepSeek Harness 及相关名称和图形标识的权利归其各自权利人所有。