Deepseek-Harness-Desktop

Whale Isle

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

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

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

功能

• AI 对话：管理工作区与历史会话，查看工具调用、确认操作审批，编辑并重新发送消息；支持 Agent 团队与多子代理并行任务。
• 项目工具：搜索和编辑文件、查看代码差异、预览网页，将文件或终端选区加入对话；Browser 预览支持在聊天区域内切换 mini-player。
• 集成终端与 Git：在应用内运行命令，切换分支、提交更改、推送代码及创建 Pull Request。
• 模型与扩展：配置模型服务，在设置中管理 MCP、技能和插件，通过内置市场安装扩展；内置机器人（Bots）页签可编排多机器人会话。
• 用量统计：查看跨会话 Token 用量、热力图和按峰谷时段估算的会话费用，支持导出统计数据。
• 桌面宠物 ：Live2D 鲸鱼娘常驻桌面，随 Token 用量成长、推送钉住的常驻通知，支持「看看」「聊聊」与摸头互动。
• 个性化外观：浅色、深色与透明主题；壁纸图库（必应每日、Wallhaven 与自定义 HTTPS 图源）配合毛玻璃、像素化和流动渐变背景，终端透明度与按钮悬停光泽可独立调节。
• 远程访问：按需开启远程连接，通过扫码在手机浏览器访问桌面会话；默认不监听远程端口。
• 桌面集成：托盘驻留、增量更新（只下载变化的安装块），以及启动器中的数据导入和插件故障排查。

工作方式

• 本地优先：会话、设置和插件配置保存在桌面专用的 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 社区的支持。

许可证