
源码系统概览
DeepSeek Harness 桌面版把官方 DeepSeek Harness 封装成开箱即用的桌面应用,本地启动即用,无需命令行。
文章正文
DeepSeek Harness桌面端源码是一款基于 Electron 的桌面应用项目,目标是把官方 DeepSeek Harness 打包成普通用户可以双击运行的桌面程序。
用户不再需要安装 Node.js、不再需要记住 npx 命令,打开应用后本地 Harness 服务自动拉起,直接在窗口内使用 Web UI 进行对话、调用工具与插件,窗口关闭后应用转入系统托盘继续驻留后台。
项目源码完整开放,桌面外壳与底层 Harness 代码均可阅读与二次开发,适合想研究 AI 智能体框架、Electron 桌面封装,或打算在本地私有化部署 Harness 工作台的开发者。
本页提供源码免费下载,包含完整 TypeScript 源码、构建脚本与打包配置。
技术架构与部署指南
源码简介
deepseek-harness-desktop 是 anywhere-labs 在官方 deepseek-ai/deepseek-harness 基础上构建的 Electron 桌面外壳。
官方 Harness(dsh)默认通过命令行 npx @deepseek-ai/dsh web 启动本地 Web UI,本项目把这一过程封装成桌面应用:自动启动并托管本地 Harness 服务,窗口关闭后由系统托盘保活,需要时通过托盘菜单恢复窗口或退出。
项目的核心能力、插件系统与 Web UI 均来自官方开源项目,桌面层主要负责 Electron 外壳、本地服务生命周期管理、窗口与托盘集成、macOS 与 Windows 安装包构建以及桌面环境下的界面适配。
仓库采用 pnpm workspace 单仓库结构,包含 apps/desktop 桌面端、apps/cli 命令行入口、packages 系列功能包、python SDK 与示例工程。
适用场景
适合不想接触命令行、希望像普通软件一样使用 DeepSeek Harness 的个人用户,也适合在本地或内网搭建 AI 智能体工作台、研究 Cordis 插件机制与 Electron 桌面集成的开发者,以及需要把 Harness 能力分发给团队内部使用的场景。
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 桌面端基于 Electron 43 与 TypeScript 6 编写,使用 electron-builder 26 打 | 依具体方案选型,需自行搭建与维护 |
| 部署方式 | 从源码构建时先执行 pnpm install,再运行 pnpm run build 完成库与前端编译; | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 免配置启动:打包版内嵌运行环境,无需安装 Node.js 或手工执行命令,双击即可运行。 | 功能通用,定制深度有限 |
| 数据归属 | 数据自持,部署在自有服务器,不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署,无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
桌面端基于 Electron 43 与 TypeScript 6 编写,使用 electron-builder 26 打包,单仓库采用 pnpm workspace 管理。底层 Harness 采用一切皆插件的 Cordis 架构,服务与客户端为全 TypeScript 实现。从源码构建需要 Node.js 22.19 或更高版本;官方安装包支持 macOS Apple Silicon 与 Windows x64,macOS Intel 为计划支持。桌面窗口默认尺寸为 1440×920。
功能亮点
免配置启动:打包版内嵌运行环境,无需安装 Node.js 或手工执行命令,双击即可运行。
托盘托管生命周期:关闭窗口仅隐藏应用,托盘菜单可恢复窗口或彻底退出,退出时等待 Host 服务在宽限期内安全停止。
原生平台适配:macOS 使用无边框内嵌标题栏、traffic lights 与侧栏 vibrancy,Windows 保留系统边框、窗口阴影、Snap 贴靠与 Win11 圆角。
安全锁定:桌面端只接受 dsh web 输出的 127.0.0.1/localhost 就绪地址,页面导航锁定同源,外链 HTTP/HTTPS 一律交给系统浏览器打开。
安装与部署提示
从源码构建时先执行 pnpm install,再运行 pnpm run build 完成库与前端编译;
开发调试使用 pnpm run dev:desktop,分发打包使用 pnpm run package:desktop 生成当前平台应用目录。
macOS 签名分发需要 Developer ID 证书与 notarytool 公证凭据,可参考仓库 release-mac 脚本配置。
普通用户无需自行编译,直接前往项目官网 deepseekdesktop.com 下载官方打包版本即可。
截图与演示说明
项目 README 提供了桌面应用主界面预览图,展示 Electron 窗口内运行的 Harness Web UI 效果,第一张图即为主界面预览。仓库还附带社区交流群入口的两张二维码图片,分别是企微群二维码与 QQ 群二维码,方便使用者加入讨论交流。

常见问题
问:使用桌面版还需要安装 Node.js 吗。
答:不需要。打包版已内嵌运行环境,开箱即用;只有从源码自行构建时才需要 Node.js 22.19 或更高版本。
问:支持哪些操作系统。
答:当前支持 macOS Apple Silicon 与 Windows x64,macOS Intel 计划支持。
问:应用数据保存在哪里。
答:应用数据与 Harness 服务均运行在本地,不会上传云端。
问:与官方 deepseek-harness 是什么关系。
答:本项目在其基础上做桌面封装、生命周期管理与界面适配,核心 Harness 能力来自官方开源项目。
安全风险提示
源码审计未发现 eval、base64 解码、命令注入等恶意后门或混淆代码。
桌面应用内嵌本地服务,建议从官方渠道下载安装包并核对签名;
在应用中配置模型 API Key 等凭据时注意本机安全,避免在公共设备长期保存;
项目依赖较多开源组件,生产环境使用请关注上游更新与供应链安全。
下载说明
本源码仅供学习研究、测试部署和二次开发参考。下载后请遵守 MIT 开源协议,保留原版权声明;
涉及模型 API 调用的功能请以官方服务条款为准。如需最新版本与官方安装包,可前往项目官网或源码仓库查看。
GitHub项目开源地址:https://github.com/anywhere-labs/deepseek-harness-desktop