DSH‑Desktop：开源DeepSeek Harness本地AI智能体桌面客户端

AI新闻 AI工具箱 2个月前

134

一、DSH‑Desktop是什么

DSH‑Desktop是一款基于Electron构建的跨平台桌面外壳程序，开源协议为MIT，它并非DeepSeek官方出品软件，核心作用是对DeepSeek Harness（简称DSH）进行桌面化封装。

DeepSeek Harness本身是一套Agent智能体运行时，自带Web界面，但必须依靠命令行启动，需要用户手动管理服务端口、进程、本地数据。DSH‑Desktop不改动DSH核心业务逻辑，仅承担桌面宿主的角色，自动拉起本地DSH服务，接管进程管理、端口分配、日志存储、用户数据管理，把原本命令行驱动的AI智能体运行环境，转化为普通用户开箱即用的桌面应用，支持对接DeepSeek以及各类第三方大模型服务商，当前锁定上游版本为@deepseek‑ai/dsh@0.1.0‑rc.6，项目处于早期预览阶段，不建议用于核心生产业务。

DSH Desktop（图1）

二、功能特色

零命令行一键启动DSH
软件打开即可加载DSH Web交互界面，自动生成运行目录，无需手动输入命令。服务仅监听本机127.0.0.1随机回环端口，不会对外网暴露AI服务，降低安全风险。
完整DSH进程生命周期管控
全权管理DSH子进程，内置启动失败重试机制，提供进程重启、优雅退出、运行日志查看能力，方便排查智能体运行报错问题。
独立安全的数据存储体系
会话记录、模型配置、插件、预设智能体全部存放在Electron独立用户数据目录。软件升级不会覆盖用户业务数据；支持导入导出.dshpreset智能体预设包，导入时会做冲突校验与安全风险提示。
强化Electron安全防护
渲染进程关闭Node访问权限，开启上下文隔离、沙箱机制、网页导航限制，仅给DSH子进程授予必要权限，降低桌面端常见的安全漏洞风险。
对接社区插件市场
兼容dsh‑market插件市场，可使用社区900+数量的第三方插件，绝大多数插件安装完成后无需重启客户端即可直接生效，拓展智能体能力边界。
跨平台自动更新能力
Windows、macOS客户端支持后台检测更新，下载完成后提示用户重启完成升级；macOS安装包完成苹果签名与公证处理。

三、技术细节

整体架构

项目采用Electron经典的主进程‑渲染进程架构，DSH作为独立Node子进程运行，三者分工明确：

Electron主进程(src/main)：负责创建窗口、管理应用数据目录、启停监控DSH子进程、端口就绪检测、日志收集、软件更新、安全策略配置。
DSH子进程：独立Node子实例，真实运行DeepSeek Harness Agent服务，提供后端API与WebUI资源。
BrowserWindow渲染窗口：访问本机回环地址，加载DSH原生Web界面，渲染进程严格限制权限，不直接访问底层系统。

关键技术模块

patches目录：使用patch‑package工具对上游DSH源码做UI层面补丁修改，上游DSH版本升级后需要重新打补丁做回归测试。
src/shared：存放全项目共用TS类型定义，统一前后端数据结构。
scripts：跨平台打包、资源处理脚本，打包需要在对应目标操作系统编译，规避原生模块兼容异常。
build：存放桌面程序图标等静态资源。
test：包含安全校验、模型服务商、配置相关自动化测试用例，提交代码前需要执行测试。

平台支持情况

平台	支持状态	备注
macOS Apple Silicon	✅完整支持	开发、打包、签名公证全部验证通过
macOS Intel	⚠️配置可用	缺少真实硬件运行验证
Windows x64	✅支持	提供NSIS安装包、便携版打包配置
Windows ARM64	❌暂不支持	暂无适配计划

环境依赖：本地开发需要Node.js ≥22版本。

四、应用场景

本地AI智能体爱好者：不想敲命令行，以桌面软件形式使用DeepSeek Harness，调试各类Agent智能体、测试社区插件。
模型多服务商测试人员：本地快速切换多家大模型服务商，在同一套Agent运行环境下对比不同模型的智能体执行效果。
智能体预设包创作者：编辑、导出.dshpreset智能体预设文件，分享给其他使用者。
个人非生产AI工作流：本地运行Agent，会话数据保存在本机，适合做学习、原型验证；不建议企业核心业务直接使用，项目为早期预览版本。

DSH Desktop（图2）

五、使用方法

普通用户使用

前往项目发布页下载对应操作系统安装包；
Windows运行NSIS安装包或者便携版程序，macOS打开dmg镜像完成安装；
启动DSH‑Desktop，软件会自动后台拉起DSH服务，等待片刻自动加载交互界面；
在界面配置模型服务商API密钥，即可使用智能体功能；
可在客户端查看运行日志，导入导出.dshpreset预设，管理社区插件。

开发者本地编译运行

git clone https://github.com/dataelement/dsh-desktop.git
cd dsh-desktop
npm install
npm run dev

执行单元测试：npm test
类型检查：npm run typecheck
项目构建：npm run build
打包必须在对应目标操作系统执行，跨系统编译会出现原生模块异常。提交PR前执行全部校验，禁止提交包含真实API密钥的代码。

六、竞品对比

对比项	DSH‑Desktop	Open Agent Desktop	LocalAI Desktop
底层Agent内核	DeepSeek Harness	自定义Agent内核	LocalAI推理内核
实现方式	Electron外壳封装上游开源内核	完整自研Electron应用	Electron封装推理服务
命令行依赖	完全屏蔽命令行，后台自动启动	部分高级功能仍需CLI操作	本地模型加载需要基础配置
插件生态	对接dsh‑market，900+社区插件	内置少量官方插件，社区生态小	以模型拓展为主，Agent插件较少
数据存储	独立隔离目录，升级数据不丢失	用户目录存储，自定义路径可选	模型文件与会话分开存储
安全特性	Electron沙箱隔离，仅本地回环端口	基础沙箱，支持开启局域网访问	可手动开启局域网对外服务
官方归属	社区第三方封装，非DeepSeek官方	独立开源项目	独立开源项目

七、常见问题解答

DSH‑Desktop是DeepSeek官方开发的软件吗？

不是，它属于社区第三方开源封装项目，DeepSeek Harness才是DeepSeek官方智能体运行内核，DSH‑Desktop只是桌面外壳，遵循MIT协议，内核本身遵守DeepSeek自身许可证。

启动软件之后界面一直加载失败如何排查？

打开客户端内置日志面板，查看DSH子进程日志，大概率是端口冲突、Node环境依赖异常；可以尝试重启客户端，软件会自动更换随机本地端口。

升级DSH‑Desktop，我的智能体会话和插件会丢失吗？

正常版本升级不会丢失，用户数据独立保存在Electron的userData目录，和程序本体分开；只有手动删除应用数据文件夹才会清空全部配置。

能不能把这个服务开放给局域网其他设备访问？

当前版本仅绑定127.0.0.1本地回环地址，设计上不支持局域网暴露，出于安全考量没有开放该配置。

为什么上游DeepSeek Harness更新之后，DSH‑Desktop不能直接升级？

项目使用patch‑package对上游做UI补丁，上游版本发生变更，补丁会失效，需要维护者重新打补丁并回归测试，才可以更新锁定的内核版本。

Windows ARM64设备可以运行DSH‑Desktop吗？

目前项目暂未适配Windows ARM64架构，没有对应的安装包，无法正常运行。

导入.dshpreset预设包的时候提示冲突是什么意思？

代表本地已经存在同名的智能体预设，软件会提示风险，你可以选择覆盖或者放弃导入，避免预设互相覆盖损坏配置。

八、相关链接

项目GitHub仓库：https://github.com/dataelement/dsh-desktop

九、总结

DSH‑Desktop以Electron作为载体，解决了DeepSeek Harness原生需要命令行操作的使用门槛，在不修改内核核心逻辑的前提下，完成进程管理、本地数据管理、安全加固、插件市场对接等桌面端能力，为普通用户提供开箱即用的本地AI智能体桌面客户端，适合AI爱好者、智能体原型创作者本地测试使用，但项目处于早期预览阶段，生产业务使用需要谨慎评估风险。