桌面 AI 工作台ChisaAlter/Deepseek-Harness-Desktop

Deepseek-Harness-Desktop

基于 DeepSeek Harness 的开源桌面客户端
在同一个窗口里与 AI 对话、浏览项目、运行终端和管理 Git。

中文 · English
 · 
下载
 · 
更新日志
 · 
反馈问题

这是一个由社区独立维护的 Electron 桌面壳，非 DeepSeek 官方客户端。它将 DeepSeek Harness 的 Web UI、工具调用和插件体系带到本地桌面，并补充启动器、工作区、窗口、托盘和更新等桌面能力。安装版无需自行配置 Node.js 或启动 dsh web。

功能

- AI 对话：管理工作区与历史会话，查看工具调用、确认操作审批，编辑并重新发送消息。
- 项目工具：搜索和编辑文件、查看代码差异、预览网页，将文件或终端选区加入对话；Browser 预览支持在聊天区域内切换 mini-player。
- 集成终端与 Git：在应用内运行命令，切换分支、提交更改、推送代码及创建 Pull Request。
- 模型与扩展：配置模型服务，在设置中管理 MCP、技能和插件，通过内置市场安装扩展。
- 用量统计：查看跨会话 Token 用量、热力图和会话费用，支持导出统计数据。
- 个性化外观：浅色、深色与透明主题，配合壁纸图库、毛玻璃和像素化效果。
- 远程访问：按需开启远程连接，通过扫码在手机浏览器访问桌面会话；默认不监听远程端口。
- 桌面集成：托盘驻留、应用更新，以及启动器中的数据导入和插件故障排查。

工作方式

- 本地优先：会话、设置和插件配置保存在桌面专用的 dsh-home，与官方 CLI 的 ~/.dsh 分开。
- 统一工作区：对话、文件、Browser、Diff、终端和 Git 围绕当前工作区协作，文件引用和终端选区可以直接回到 Composer。
- 可扩展运行时：模型服务、MCP、技能和插件由 DeepSeek Harness 的插件机制提供；桌面自有功能通过受控的桌面插件接入。
- 桌面安全边界：高风险工具操作遵循 Harness 的审批和权限策略；远程功能需要用户主动开启。

下载与安装

| 平台 | 下载 |
| --- | --- |
| Windows 10 及以上 · x64 | 下载最新公开版 |

公开分发以 Windows x64 安装包为主；其他平台可按下方说明从源码运行或构建。版本和变更记录见 Releases。

[!NOTE]
Windows 安装包尚未进行数字签名，系统可能显示安全提示。请仅从本仓库下载；发布页提供 SHA512SUMS.txt 供核对文件完整性。

开始使用

1. 安装并打开应用，等待启动器进入主界面。
2. 在设置中配置模型服务与 API 密钥。
3. 选择项目目录作为工作区，或新建无工作区会话，开始对话。

如果你使用过官方 CLI，可在启动器的「导入」页面选择需要迁移的数据。

常见问题
需要自己准备 API 密钥吗？

需要配置所使用模型服务的 API 密钥。本项目不提供模型额度，调用费用由对应服务商收取。

如何升级？

应用启动时会检查更新，也可以下载新的安装包覆盖安装。桌面版用户通常可以保留现有数据升级；升级前建议备份数据目录。

从官方 CLI 或早期桌面版本迁移，请使用启动器的「导入」，不要直接覆盖数据库或复制整个 profiles 目录。导入后重新添加原来的工作区路径即可查找对应会话。

数据保存在哪里？

桌面端使用独立的数据目录，不会直接读取官方 CLI 的 ~/.dsh。可在「设置 → 关于 → 打开运行目录」中查看。

| 平台 | 会话与设置目录 |
| --- | --- |
| Windows | %APPDATA%\Deepseek-Harness-Desktop\dsh-home |
| macOS（源码运行） | ~/Library/Application Support/Deepseek-Harness-Desktop/dsh-home |

安装插件后无法启动怎么办？

在启动器的插件排查中禁用出错插件，再重新启动。旧版 dshbot 可能与新版 Harness 不兼容，也可用此方式单独禁用，无需删除配置或会话。

从源码运行

开发环境：Windows 10+ 或 macOS 14+（Apple Silicon），Node.js 22.19+（22.x）或 24+，pnpm 11。

git clone https://github.com/ChisaAlter/Deepseek-Harness-Desktop.git
cd Deepseek-Harness-Desktop
npm install
npm run setup:harness
npm start

首次运行会构建仓库内的 Harness，耗时较长。源码版与安装版共用单实例锁，启动前请先退出已安装的应用，包括托盘进程。

npm test          # 桌面单元测试
npm run dist      # 构建 Windows 安装包
npm run dist:mac  # 构建 macOS 安装包，需在 macOS 上运行

文档

- 产品与架构手册
- 界面设计规范 · 动效规范
- 功能契约
- 构建与发布指南

参与贡献

欢迎提交 Issue 和 Pull Request，参与功能开发、问题修复或文档改进。报告问题时，请附上应用版本、操作系统、复现步骤和必要截图，并移除日志中的密钥等敏感信息。

社区

欢迎扫码加入微信交流群。二维码失效时，请通过 Issue 联系维护者。

致谢

感谢 DeepSeek Harness 提供基础能力，以及 Linux.do 社区的支持。

许可证

MIT