想用 DeepSeek Harness 跑本地 Agent，先装 Node 环境、敲 CLI 启动命令、排查端口占用、再打开浏览器访问，折腾十分钟还没进到交互界面。插件崩了整个进程挂死，升级一次丢一次配置——很多 AI Agent 工具不是不能用，而是 不够顺手 。本地桌面场景， 稳定性永远比功能列表更重要 。

DeepSeek Harness（DSH）本身是一套完整的开源 Agent 运行框架，负责调度模型、插件与工具，但偏工程化的命令行使用方式，把不少普通开发者挡在了门外。端口管理、进程守护、数据持久化、跨平台适配这些桌面端基础能力，都需要使用者自行补齐。

现在，由 AtomGit G-Star 组织 BISHENG 团队开源的 dsh-desktop 把 DeepSeek Harness 封装为开箱即用的桌面应用，补齐桌面端工程化能力。现已入驻 AtomGit 并加入 G-Star 推广计划。这是一款独立的第三方桌面封装项目， 与 DeepSeek 官方无任何隶属关系 ，采用 MIT 协议开源。

截至目前，项目累计安装量突破 124,888 ，官网累计访问量达 160,832 ，飞速增长中。

📦 AtomGit 仓库：www.atomgit.com/dataelem/dsh-desktop

🔗 项目官网：www.dshdesktop.com

问题定义：原生 Harness 的桌面体验缺口

本地 Agent 的使用与开发主要有三类典型场景，各自的核心诉求差异明显。

• 个人日常使用：追求启动快、配置少，开箱就能用 Agent 处理代码、文档任务。

• 小团队协作：希望统一配置、降低上手成本，成员不用重复搭建环境。

• 二次开发调试：需要稳定的本地运行环境，方便调试插件、定制工作流。

原生 DeepSeek Harness 依赖 CLI 启动，在桌面场景下存在三类共性痛点。一是使用门槛高，需手动配置 Node 环境、管理端口与启动目录，每次使用都要走一遍命令行流程。二是稳定性不足，插件异常容易导致整体进程崩溃，缺少故障恢复与降级机制。三是维护成本高，用户数据与安装目录混杂，应用升级易丢失配置、会话与插件，跨平台适配需要自行处理。

dsh-desktop 的核心目标，就是补上桌面产品的宿主能力，把 Harness 从“命令行工具”变成 “可长期日常使用的桌面软件” 。

运行架构：桌面封装层 + Harness 子进程

DSH Desktop 是一个 local-first、跨平台的 DeepSeek Harness 桌面封装（desktop shell）。它不重新实现 Harness，而是把 Harness 的本地 Web 体验封装为桌面应用，补上桌面产品所需的宿主能力。

运行架构如下：

1. Electron 主进程：管理应用专属启动目录、Harness 子进程生命周期、随机回环端口与启动检测、原生日志与错误恢复入口。

2. Harness 独立子进程：运行完整 DeepSeek Harness 运行时。Cordis HMR 所需的 --expose-internals 只授予该子进程，不授予 Web Renderer。

3. 安全 BrowserWindow：加载 http://127.0.0.1: 的 Harness Web UI。Renderer 关闭 Node.js 权限，启用 contextIsolation、sandbox 与导航限制。

4. Electron userData 目录：Profile、会话、插件与用户数据保存在应用安装目录之外（launch-root/、logs/harness.log、harness/），升级应用不丢数据。

项目当前固定依赖 @deepseek-ai/dsh@0.1.1-rc.1。首启 Provider 列表与 Preset 导入导出界面由 patch-package 固化在 patches/ 目录中；侧边栏品牌标识与底部入口填充 Harness 提供的 sidebar.brand.* 与 sidebar.footer.action 插槽，不需要补丁。

核心价值：把 Harness 真正用进日常

dsh-desktop 的价值，在于接住了桌面端所有细碎的工程细节，让 Harness 可以稳定进入日常开发工作流。

• 降低使用门槛

开发者不需要每次手动起服务、管端口、开浏览器，而是可以像打开普通桌面应用一样启动 DSH，一键完成模型 Provider、自定义模型和本地环境配置。从环境安装到进入交互界面，核心流程压缩为 2 步 ：下载安装、填入 API Key。

• 复用 Agent 工作流

支持 Preset 工作配方机制——把角色设定、工具、插件、Skills 和任务规则组合成可复用的配置包。用户可以直接导入场景化工作流，比如创作、研究、开发辅助等任务，不必从零组合插件和提示词。

• 补齐桌面端稳定性

针对本地 Agent 常见的插件异常、后台服务残留、系统权限、Shell 环境读取等问题，提供完整的进程守护、故障恢复与清理机制。 插件出错不再等于整个工具不可用 。

0.6.2 版本更新亮点

• 安全模式

基于主进程与子进程的隔离设计，即使遇到系统无法识别的插件错误，用户也可以进入安全模式，绕过故障插件加载基础功能，并在安全模式下强制卸载、彻底清理故障插件，避免 “插件崩 = 工具废” 。

• 更彻底的插件卸载

针对 macOS 下插件注册后台服务、卸载后仍有残留进程的问题，新版本会识别被卸载插件的后台组件，停止相关服务并移入恢复区， 减少卸载残留 。

• Windows 数字签名

安装包加入 EV 代码签名证书。随着用户安装量与信任度积累，会逐步降低 Windows SmartScreen 拦截概率，后续安装体验会更顺畅。

能力矩阵

支持模型服务商

服务商类型	支持厂商	配置方式
主流大模型厂商	DeepSeek、OpenAI、Anthropic、Google Gemini、xAI、月之暗面 Moonshot、MiniMax、智谱 GLM、Mistral、Groq、Together AI	选择服务商 + 填入 API Key，自动配置路由与模型列表
模型聚合平台	OpenRouter	同上

平台与技术细节

1. 适配平台：macOS Apple Silicon / Intel、Windows x64

2. 上游内核：基于 @deepseek-ai/dsh@0.1.1-rc.1

3. 核心能力：Preset 导入导出、插件扩展、多工作区管理、进程故障恢复

4. 安全特性：渲染进程沙箱、上下文隔离、本地回环端口监听

快速上手

• 普通用户：安装包方式（推荐）

前往 dsh-desktop 官网下载安装包： https://dshdesktop.com/

• 开发者：源码运行

git clone https://atomgit.com/dataelem/dsh-desktop.git
cd dsh-desktop
npm install
npm run dev

常用检查命令

npm test # 运行测试
npm run typecheck # 类型检查
npm run build # 构建项目

关于 AtomGit

AtomGit 是面向 AI 时代的开源代码协作平台，提供代码托管、模型与数据集管理、CI/CD 一体化的研发协作能力，致力于为开发者与团队提供高效、稳定的开源协作体验。

平台推出的 G-Star 开源摘星计划 ，是针对开源项目成长全流程的扶持计划，为入选项目提供流量扶持、资源对接、品牌市场推广与社区化运营支持，帮助开源项目从代码托管走向社区活跃。dsh-desktop 作为 G-Star 计划的入选项目，将在 AtomGit 上获得源码托管、版本发布与社区运营的一体化支持。

🔗 项目地址：https://atomgit.com/dataelem/dsh-desktop

🌟 G-Star 推广计划：https://atomgit.com/g-star/apply

欢迎前往仓库体验，提交 Issue 与 PR 参与共建。也欢迎更多 AI 基础设施、开发者工具和开源模型项目入驻 AtomGit，加入 G-Star 计划，共建 AI 开源生态。