桌面客户端 xiincs/deepseek-harness-desktop

DeepSeek Harness Desktop

把 DeepSeek Harness 装进一个真正的桌面应用

不用再守着浏览器标签页——一个图标，双击打开，关掉窗口它还在后台安静运行。

⬇️ 立即下载 ·功能一览 ·常见问题

✨ 这是什么

DeepSeek Harness 官方提供的是一个网页版工具——好用，但终究是浏览器里的一个标签页：不小心关错标签、被一堆其他标签淹没、电脑重启后要重新找回来。

DeepSeek Harness Desktop 把它做成了一个真正的桌面应用：像微信、VS Code 一样，图标钉在任务栏或 Dock 上，双击就开，关窗口不等于退出——它安静地待在系统托盘里，随时点一下就回来，之前的会话原封不动。

🚀 这个应用能做什么

- 双击即用：打开应用，自动帮你把后台服务准备好，不需要敲命令行、不需要搞懂端口是什么。
- 关窗不等于退出：点右上角的关闭按钮只是把窗口藏起来，工作还在继续；托盘图标右键才是真的退出。
- 数据和网页版完全通用：所有会话、配置都存在同一个地方，网页版和桌面版随便切换，互不冲突。
- 文件面板：右侧一键唤出文件目录树，点开任意文件直接预览、编辑、保存，改动会用颜色标出来，不用再切去别的编辑器来回对照。
- 插件市场：浏览、搜索、安装社区插件，目录持续更新、条目数以百计——插件来自社区众包目录，安装前会先给你看清楚要执行的确切命令，确认后才会真正安装，不会点一下就悄悄装上。
- 内置终端：需要跑个命令的时候，不用再额外开一个终端窗口，应用里直接就有。
- 崩溃了自己爬起来：后台服务万一意外挂掉，应用会自动帮你重启一次；实在起不来也会告诉你原因，而不是一片空白让你猜。
- 有新版本会提醒你：打开应用时自动检查更新，一键装上，不用跑去发布页面翻。
- 体积小、开得快：走的是系统自带的浏览器内核，不用像很多同类应用那样自带一个完整的 Chromium，装包小很多，打开也更快。

⬇️ 下载

前往 Releases 页面，根据你的系统下载对应安装包：

| 系统 | 安装包 | 说明 |
| Windows | .exe | 已签名，支持自动更新，双击安装即可 |
| macOS | .dmg | 首次打开需要在「系统设置 → 隐私与安全性」里手动允许一次（未加入 Apple 开发者计划，属正常现象） |
| Linux | .deb | dpkg -i 或用系统自带的安装器打开即可 |

macOS / Linux 版暂不支持自动更新，有新版本时需要自己回来这个页面重新下载。

❓ 常见问题

这是官方产品吗？ 不是。DeepSeek Harness 本体由官方维护，这个桌面壳是社区做的第三方封装，专门解决"网页版不方便"这一件事。

我的数据安全吗？ 应用里的网页界面（也就是 DeepSeek Harness 本体的部分）运行在一个隔离的沙箱里，没有权限访问你电脑上的任何东西，和你原本用网页版时完全一样。唯一会读写本地文件的是桌面壳自带的文件面板——这是一个独立、刻意加上去的功能，方便你不用切出去就能改文件，跟网页那部分完全隔离。

能不能带着走，不用联网也能用？ 应用本身可以离线打开，但里面加载的 DeepSeek Harness 服务该怎么工作还是怎么工作——具体取决于你配置的模型服务本身是否需要联网。

为什么应用里的 dsh 版本没跟着最新的预发布版本走？ 是刻意的：只有上游把某个版本标为正式默认版本时，这个应用才会跟进，不会因为看到一个更新的预发布版本号就抢先跟——预发布版本有的过几天会转正，也有的会被后续版本悄悄顶替、从未转正过，提前跟等于让桌面壳替你承担这种不确定性。

想参与开发或者自己编译？
欢迎，看 开发指南。

License

MIT

dsh-fleet

一个插件，用来管理多个 dsh 实例，并让它们互相通信。

dsh-fleet 让你运行一组 dsh 智能体，每个智能体都有自己的工作区、模型和工具，然后让它们通过消息传递来协作。

功能

- 多个实例 —— 在同一个主机上启动任意数量的 dsh 实例，每个实例都有自己的配置档。
- 消息传递 —— 实例之间可以互发消息，支持点对点和广播两种方式。
- 共享上下文 —— 把上下文片段附加到消息上，让接收方拿到完整背景。
- 健康检查 —— 轮询每个实例的状态，在某个实例无响应时收到告警。
- 优雅关闭 —— 一条命令停掉所有实例，并等待它们完成手头的工作。

安装

npm install -g dsh-fleet

或者直接用 npx 运行：

npx dsh-fleet start

快速开始

先创建一个配置文件：

fleet.yaml
instances:
- name: planner
profile: default
workspace: ./workspaces/planner
model: deepseek-chat

- name: coder
profile: default
workspace: ./workspaces/coder
model: deepseek-coder

- name: reviewer
profile: default
workspace: ./workspaces/reviewer
model: deepseek-chat

然后启动整个集群：

dsh-fleet start --config fleet.yaml

命令

| 命令 | 说明 |
| dsh-fleet start | 启动配置文件中定义的所有实例 |
| dsh-fleet stop | 停止所有正在运行的实例 |
| dsh-fleet status | 打印每个实例的状态 |
| dsh-fleet send | 向某个实例发送消息 |
| dsh-fleet broadcast | 向所有实例发送消息 |
| dsh-fleet logs | 查看某个实例的日志 |

发送消息

向单个实例发送消息：

dsh-fleet send --to coder --message "实现 parseConfig 函数"

广播给所有实例：

dsh-fleet broadcast --message "十分钟后开会"

附加一段上下文：

dsh-fleet send --to reviewer \
--message "审查这个补丁" \
--context ./notes/review.md

配置

fleet.yaml 支持以下字段：

| 字段 | 类型 | 说明 |
| instances | 数组 | 实例定义列表 |
| instances[].name | 字符串 | 实例的唯一名称 |
| instances[].profile | 字符串 | 要使用的配置档名称 |
| instances[].workspace | 字符串 | 工作区目录路径 |
| instances[].model | 字符串 | 覆盖配置档里的模型 |
| instances[].env | 对象 | 传给实例的额外环境变量 |
| healthCheckInterval | 数字 | 健康检查间隔，单位毫秒，默认 30000 |
| shutdownTimeout | 数字 | 关闭超时，单位毫秒，默认 10000 |

钩子

你可以在实例生命周期的各个阶段挂上钩子：

hooks:
beforeStart: ./scripts/setup.sh
afterStart: ./scripts/notify.sh
beforeStop: ./scripts/cleanup.sh

每个钩子都会拿到实例名称，作为第一个参数传入。

与 MCP 配合

dsh-fleet 自带一个 MCP 服务器，这样其他智能体就能驱动整个集群：

dsh-fleet mcp --port 8787

这个服务器暴露以下工具：

- fleet_list —— 列出所有实例及其状态
- fleet_send —— 向某个实例发送消息
- fleet_broadcast —— 向所有实例发送消息
- fleet_status —— 获取某个实例的详细状态

环境变量

| 变量 | 说明 |
| DSH_FLEET_CONFIG | 配置文件的路径 |
| DSH_FLEET_LOG_LEVEL | 日志级别：debug、info、warn、error |
| DSH_FLEET_HOME | 存放运行时状态和日志的目录 |

开发

git clone https://github.com/deepseek-ai/dsh-fleet.git
cd dsh-fleet
npm install
npm run build
npm test

协议

MIT