智能体桌面客户端WeiLiu03/deepseek-harness-desktop

DeepSeek Harness Desktop

DeepSeek Harness Desktop

一切皆插件——如今尽在一个原生窗口中。

一个面向 DeepSeek Harness（dsh）的非官方桌面应用，dsh 是 DeepSeek 推出的开源、插件优先的 AI 智能体运行时。
安装一次，双击即可获得完整的 dsh 网页体验——无需终端。

GitHub Repo stars
GitHub Downloads
GitHub Release
License: MIT

下载 · 中文文档 · 报告问题 · 上游：deepseek-ai/deepseek-harness

什么是 DeepSeek Harness Desktop？

DeepSeek Harness 是 DeepSeek 推出的开源 AI 智能体运行时，它围绕一个简单的公式构建：Agent = Model + Harness——并秉持 一切皆插件 的理念。它以 CLI（dsh）形式发布，其 dsh web 命令会提供一个本地网页 UI，默认端口为 3080。

DeepSeek Harness Desktop 将该运行时打包为一个原生桌面应用，让你双击即可运行 DeepSeek 智能体运行时：

- 内置 @deepseek-ai/dsh（0.1.0-rc.6）——无需 npm install，无需终端
- 自动启动本地 dsh 服务器，并显示实时启动画面
- 复用同一端口上已在运行的 dsh web（对开发友好）
- 系统托盘：显示窗口 / 重启 dsh 服务器 / 重新加载 / 退出
- Windows NSIS 安装程序 + 便携版 exe；包含 Linux 和 macOS 构建配置
- 写入详细的服务器日志（dsh-server.log），便于排查问题

下载

从 Releases 页面获取最新安装程序：

| 文件 | 平台 | 说明 |
| --- | --- | --- |
| DeepSeek-Harness-Desktop-Setup-x.x.x.exe | Windows 10/11 (x64) | NSIS 安装程序 |
| DeepSeek-Harness-Desktop-x.x.x.exe | Windows 10/11 (x64) | 便携版，无需安装 |

注意： 未签名的社区构建——Windows SmartScreen 可能会发出警告（点击“更多信息”>“仍要运行”）。dsh 需要 PATH 中存在 Node.js >= 22.6。

快速开始

方式 1——预构建版本（推荐）

1. 从 Releases 下载安装程序。
2. 安装（或直接运行便携版 exe）。
3. 启动——应用会启动 dsh web 并自动打开 http://127.0.0.1:3080。

方式 2——从源码运行

git clone https://github.com/WeiLiu03/deepseek-harness-desktopbash
cd deepseek-harness-desktop
npm install
npm start

选项 3 - 构建你自己的安装程序
bash
npm run dist        # 当前平台
npm run dist:win    # Windows：NSIS 安装程序 + 便携版

构建产物会写入 dist/。一个 afterPack 钩子（scripts/after-pack.js）会恢复 dsh 隐式的 workspace 风格依赖，因此打包后的应用可以直接运行。

配置

| 环境变量 | 默认值 | 描述 |
| --- | --- | --- |
| DSH_PORT | 3080 | 应用所连接/启动的 dsh Web 服务器的端口 |

注意： 建议你的 PATH 中有一个较新的 Node（>= 22.6）；应用会优先使用系统的 Node.js，并回退到 Electron 内置的 Node 运行时。

工作原理

1. 启动时，应用会探测配置的端口（默认 3080）。
2. 如果你自己的 dsh web 已经在该端口上监听，则直接加载它。
3. 否则，它会启动内置的 dsh web（优先使用系统 Node.js，Electron 运行时作为回退），并轮询直到服务器就绪。
4. 当应用退出时，所启动的 dsh 服务器会被终止。

常见问题

这是 DeepSeek 的官方产品吗？
不是。这是一个非官方的社区项目。DeepSeek Harness 本身由 DeepSeek-AI 开发：deepseek-ai/deepseek-harness。

它使用哪个端口？
默认 3080，可通过 DSH_PORT 覆盖。

服务器日志在哪里？
Windows：%APPDATA%/DeepSeek Harness Desktop/dsh-server.log（也可通过托盘菜单工作流访问）。

我可以使用自己安装的 dsh 吗？
可以——你自己启动 dsh web；应用会在该端口上检测到它并连接，而不是再启动第二个服务器。

为什么 dsh 需要 Node.js >= 22.6？
dsh 使用了较新的 Node API（例如 stripTypeScriptCodes），旧版运行时不提供这些 API。

路线图

- [ ] 首次运行引导（模型 API 密钥设置）
- [ ] 自动更新
- [ ] 配置文件支持（dsh --profile）
- [ ] 内置服务器日志查看器

相关

- deepseek-ai/deepseek-harness - 上游 agent 运行时
- @deepseek-ai/dsh - 官方 npm 包

贡献

欢迎提交 issue 和 pull request！开发需要 Node.js 20+：npm install，然后 npm start 即可开始修改 Electron 外壳。

支持与 Star

如果 DeepSeek Harness Desktop 为你省下了一个终端窗口，请给它一个 Star——多多支持！Star 能帮助更多开发者在搜索 deepseek harness 时发现 DeepSeek Harness 生态，也能让这个项目持续前进。Star、fork、分享——都非常感谢！

Star 历史

Star History Chart

免责声明

非官方社区项目。DeepSeek Harness 由 DeepSeek-AI 在 MIT 许可证下开发。

许可证

MIT (c) DeepSeek Harness Desktop 贡献者