The project's README from github.com/ChisaAlter/WhaleIsle. As one markdown file: README.md.
基于 DeepSeek Harness 的开源桌面客户端
在同一个窗口里与 AI 对话、浏览项目、运行终端和管理 Git。
中文 · English · 下载 · 更新日志 · 反馈问题
本项目由社区独立维护,非 DeepSeek 官方客户端。沿用 DeepSeek Harness 的对话界面,并提供桌面集成;安装后无需自行配置 Node.js 或启动 dsh web。
![]() |
![]() |
![]() |
![]() |
| 平台 | 下载 |
|---|---|
| Windows 10 及以上 · x64 | 下载 v0.2.9 安装包 |
本版仅提供 Windows 安装包。其他版本与更新说明见 Releases。
[!NOTE] Windows 安装包尚未进行数字签名,系统可能显示安全提示。请仅从本仓库下载;发布页提供 SHA512SUMS.txt 供核对文件完整性。
如果你使用过官方 CLI,可在启动器的「导入」页面选择需要迁移的数据。
需要配置所使用模型服务的 API 密钥。本项目不提供模型额度,调用费用由对应服务商收取。
应用启动时会检查更新,也可以下载新版安装包覆盖安装。已使用 0.2.7 桌面版的用户可保留现有数据升级到 0.2.9;升级前建议备份数据目录。
从官方 CLI 或早于 0.2.7 的版本迁移,请使用启动器的「导入」,不要直接覆盖数据库或复制整个 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 社区的支持。