dataelement/dsh-desktop · 上手攻略

  • 仓库：dataelement/dsh-desktop
  • 链接：https://github.com/dataelement/dsh-desktop
  • 分类：ai（桌面应用 / Agent Runtime 封装）
  • 作者：Jay
  • 更新：2026-08-15

是什么

DSH Desktop 是 DeepSeek Harness 的跨平台桌面包装器（Electron），把本地运行的 DeepSeek Harness Web UI 封装为 macOS / Windows 原生桌面应用，让用户无需手动启动 CLI、无需管理本地端口，在桌面窗口中直接使用完整的 Harness Agent Runtime 体验。

本质上是一个 Electron 宿主进程，内嵌 DeepSeek Harness 作为子进程运行，两者在同一桌面窗口内协同工作。

解决什么问题

DeepSeek Harness 本身是命令行工具，需要用户手动 npm run dev 启动、管理端口、处理子进程生命周期。DSH Desktop 解决了以下痛点：

  • 免 CLI 启动：自动启动 Harness 子进程，自动分配随机 loopback 端口，等 Harness 就绪后直接打开界面
  • 进程托管：统一管理子进程的启动检测、日志查看、失败重试与优雅关闭
  • 数据持久化：Profile / 插件 / 会话数据存在 Electron userData 目录（~/Library/Application Support/ 或 %APPDATA%），升级应用不丢失用户数据
  • 安全加固：关闭 renderer 的 Node.js 权限，启用 contextIsolation、sandbox 和导航限制，端口仅监听 127.0.0.1
  • 预设导入导出：Agent 预设可打包为 .dshpreset 便携文件，方便分享与备份

快速安装

方式一：下载安装包（推荐日常使用）

macOS 和 Windows 用户直接前往 官网下载页：

https://www.dshdesktop.com/#download

macOS 版本已完成 Apple 代码签名与公证，安装后即用。Windows 版本通过 NSIS / Portable 分发。

启动后每 6 小时自动检查更新，也可在应用菜单手动「检查更新…」。

方式二：从源码构建（开发者）

环境要求： - Node.js ≥ 22 - npm - macOS Apple Silicon / Intel 或 Windows x64

git clone https://github.com/dataelement/dsh-desktop.git
cd dsh-desktop
npm install
npm run dev        # 开发模式运行

⚠️ npm install 会执行 patch-package，重放对固定 DSH 版本的界面定制（模型配置、preset 导入导出、侧栏品牌），这是正常的构建步骤。

打包命令：

npm run build                              # 构建生产版本

# macOS
npm run package:mac                        # 生成当前架构 DMG + ZIP
npm run package:mac:arm64                  # Apple Silicon
npm run package:mac:x64                    # Intel

# Windows
npm run package:win                        # 生成 NSIS + Portable

⚠️ Windows ARM64 暂不支持；原生模块需在对应平台上重新构建，不能跨架构复制 node_modules。

核心用法

首次启动配置

  1. 启动 DSH Desktop，应用自动创建内部启动目录
  2. 首次配置时选择模型提供方并填写 API Key（直接写入系统凭据存储，不落地文件）
  3. 支持的模型厂商（首启列表）：
类型 支持 Provider
模型厂商 DeepSeek、OpenAI、Anthropic、Google Gemini、xAI、Moonshot/Kimi、MiniMax、智谱 GLM、Mistral AI
模型聚合 OpenRouter
推理平台 Groq、Together AI
  1. 更多 Provider 可在 Harness 界面「设置 → 模型」中添加

Agent 预设导入 / 导出

在 Harness 侧栏菜单中选择「导出预设」，生成 .dshpreset 便携包；导入时将文件拖入应用即可（会检查命名冲突并提示信任风险）。

子进程管理

  • 应用窗口内置「重启 Harness」和「查看日志」菜单项
  • 退出应用时自动优雅关闭 Harness 子进程
  • 启动失败时提供重试 / 查看日志 / 直接退出三个选项

典型适用场景

  1. 本地 AI Agent 开发与调试：不想每次手动启动 CLI，在桌面窗口直接操作 Harness
  2. 多会话管理：多个 Profile / 插件 / 会话数据分离管理，适合团队或个人不同项目
  3. 预设分享：将调好的 Agent 预设打包发给同事或在不同机器间迁移
  4. 安全要求较高的内网环境：全程本地运行，无外网依赖（端口仅 127.0.0.1）

坑与注意

问题 说明
早期预览版 当前固定 @deepseek-ai/dsh@0.1.0-rc.6，API 和界面仍在快速迭代，生产环境慎用
Windows ARM64 不支持 暂无可用安装包
自动更新未接入 需手动从官网下载新版本
原生模块需同平台构建 node_modules 不可跨 macOS Intel / ARM / Windows 复制
macOS 安装包来源 官方仅通过 dshdesktop.com 分发，未上架 Mac App Store

与同类对比

工具 定位 与 DSH Desktop 的区别
DeepSeek Harness（原生 CLI） 核心 Runtime DSH Desktop 是其桌面封装，两者不是一个层面的竞品
Open WebUI 本地 LLM Web UI 通用的 Web UI 包装，不绑定 DeepSeek / Harness 生态
anything-llm 本地 RAG / Chat UI 面向 RAG 场景，DSH Desktop 面向 Agent Runtime
DSH Desktop Harness 桌面壳 直接托管 Harness 子进程，Harness 的所有功能均可用

一句话：DSH Desktop 是目前最原生的 Harness 桌面体验，若你已在用或计划用 DeepSeek Harness 进行 Agent 开发，这是最省心的启动方式。

一句话结论

DSH Desktop 把 DeepSeek Harness 包装成开箱即用的桌面应用，省去 CLI 管理负担，适合深度 Harness 用户和本地 Agent 开发者尝试——注意它目前仍是预览版，依赖版本锁定到 rc.6，不适合对稳定性要求高的生产场景。