anywhere-labs/deepseek-harness-desktop · 上手攻略
- 仓库：anywhere-labs/deepseek-harness-desktop
- 链接：https://github.com/anywhere-labs/deepseek-harness-desktop
- 分类：AI Agent 工具链 / 桌面应用
- 作者：Tom
- 更新：2026-08-17
这是什么
DSH Desktop（DeepSeek Harness Desktop）是 DeepSeek Harness（DSH）插件生态的原生桌面封装。把官方 Harness 的本地 Web UI、Host 服务和插件系统装进 Electron/Tauri 原生桌面应用，一键安装、自动管理服务、集成系统托盘，无需安装 Node.js 或手动敲命令。
核心理念：万物皆插件，桌面本身也是插件。DSH Desktop 的桌面壳不是一个魔改的外壳，而是遵循官方插件约定的合法 DSH 插件，与第三方插件走同一条组合路径，可替换、可演进。
解决什么问题
官方 DeepSeek Harness 需要用户在终端里启动服务、管理进程、安装插件——这对开发者友好，但普通用户门槛较高。
DSH Desktop 解决了： - 门槛问题：一键安装包（Windows NSIS / macOS DMG），开箱即用，无需配环境 - 管理问题：桌面托盘管理服务，Profile 切换，插件增删 - 移动端问题：支持手机远程控制 Desktop，在手机上发起任务、查看进度
快速安装
下载安装包
| 平台 | 下载 | 安装方式 |
|---|---|---|
| Windows x64 | 下载安装程序 | 运行 NSIS 安装程序，按提示完成 |
| macOS Apple Silicon | 下载 DMG | 打开 DMG，将 DSH Desktop 拖入 Applications |
也可从 GitHub Releases 获取安装包和 SHA-256 校验和。
⚠️ 安装包内已自带 Electron、Node 和 DSH 运行时，普通用户不需要另行安装 Node.js、pnpm 或 DSH。
从源码构建（开发者）
git clone https://github.com/anywhere-labs/deepseek-harness-desktop.git
cd deepseek-harness-desktop
git submodule update --init --recursive
corepack yarn install --immutable
corepack yarn dev
核心用法
基本操作
- 关闭窗口：仅隐藏窗口，可从托盘重新打开；选「退出」才会真正结束应用和 Host 进程
- Profile 切换：托盘 → Profile 菜单，可创建、切换不同 profile（每个 profile 是一组 bundle + 依赖 + patch 的组合）
- 插件管理：在托盘打开的终端中使用官方 DSH CLI：
# 安装插件
dsh plugin add <plugin>
# 查看已装插件
dsh plugin list
# 更新插件
dsh plugin update
# 移除插件
dsh plugin remove <plugin>
⚠️ 插件变更后需要重启 DSH Desktop，才能让新 bundle 进入 Loader 组合。
终端
从托盘选择 Open DSH Terminal： - macOS 打开 Terminal - Windows 优先用 Windows Terminal，找不到则回退到 PowerShell
Desktop 在自己的 user-data 目录生成 dsh/pnpm/node 私有 shim，只对这个终端进程设置 PATH，不会修改系统 PATH。
显示模式
| 模式 | 说明 |
|---|---|
| 兼容模式 | 使用官方默认 Web client + profile 自己的 layout/sidebar/conversation，适合希望接近官方 Harness 体验的用户 |
| 高级模式 | 在不改变上游 Web carrier 的前提下加入 Desktop 自有 frame、布局、Mica/vibrancy 和原生拖动区域 |
| Linux | 仅支持兼容模式 |
更新
- 后台自动检查：
https://www.dshdesktop.cn/api/desktop/version，不阻塞启动 - 手动检查：托盘 → Check for Updates…（即使已是最新版也会显示结果）
- 只有服务端版本严格高于本地版本时才会询问下载
典型适用场景
- 普通用户快速上手 DSH：不想折腾 Node.js/终端，直接装桌面版
- 多 Profile 管理：同时跑官方/社区多个 DSH 配置，互不干扰
- 移动端远程操控：手机连上 Desktop，随时发起任务、查看进度
- 开发者调试桌面插件：桌面壳本身是合法 DSH 插件，可在此基础上开发桌面特有功能
坑与注意
| 坑 | 说明 |
|---|---|
| 关闭窗口 ≠ 退出应用 | 只会隐藏窗口，要真正退出才选托盘「退出」 |
| 插件安装后不生效 | 需要重启 DSH Desktop，不是热加载 |
| 切换 Profile 会重启 | 终端里正在跑的任务会被中断 |
| Linux 只有兼容模式 | 高级模式（Mica/vibrancy）仅支持 Windows/macOS |
| 桌面插件能力有限 | 并非所有 DSH 插件能力都能暴露给桌面插件，详见桌面插件接口说明 |
| 后台更新检查静默失败 | 网络错误、超时等不会弹窗提示；需要手动检查更新 |
与同类对比
| 项目 | 安装方式 | 复杂度 | 插件生态 | 移动端支持 |
|---|---|---|---|---|
| DSH Desktop | 一键安装包 | 低 | 官方 DSH 插件体系 | ✅ 手机远程控制 |
| 官方 DeepSeek Harness | 命令行 | 高 | 官方插件体系 | ❌ |
| Koishi Desktop | 安装包 | 中 | Koishi 插件生态 | ❌ |
DSH Desktop 最大的差异化是与官方 DSH 插件体系完全兼容，且桌面壳本身也是插件——这意味着第三方插件作者无需额外适配，天然可以在 Desktop 里运行。
一句话推荐结论
不想折腾终端，只想快速用上 DeepSeek Harness 插件生态，DSH Desktop 是最省心的入口；开发者若需深度定制或参与核心开发，仍推荐直接使用官方仓库。