WhaleIsle README

The project's README from github.com/ChisaAlter/WhaleIsle. As one markdown file: README.md.

Deepseek-Harness-Desktop

Deepseek-Harness-Desktop

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

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

Release License Windows x64

Deepseek-Harness-Desktop 主界面

本项目由社区独立维护,非 DeepSeek 官方客户端。沿用 DeepSeek Harness 的对话界面,并提供桌面集成;安装后无需自行配置 Node.js 或启动 dsh web。

功能

对话、文件与代码差异 自定义壁纸
外观主题 外观设置

下载与安装

平台 下载
Windows 10 及以上 · x64 下载 v0.2.9 安装包

本版仅提供 Windows 安装包。其他版本与更新说明见 Releases。

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

开始使用

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

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

常见问题

需要自己准备 API 密钥吗?

需要配置所使用模型服务的 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 社区的支持。

许可证

MIT

WhaleIsle (ChisaAlter/WhaleIsle)

Searching Database…

What is this?WhaleIsle (鲸屿) is a community-maintained desktop client for DeepSeek Harness that lets you chat with an AI, browse a project, run a terminal, and manage Git all in one window.
Is this an official DeepSeek app or just a GUI wrapper around the CLI?It's an independently maintained, unofficial community client built on top of the DeepSeek Harness CLI; it bundles the Harness itself so you don't need to set up Node.js or run 'dsh web' yourself.
How do I install and start using it?Download the Windows x64 v0.2.9 installer, run it, then configure your model service's API key in Settings and pick a project folder (or start a workspace-less chat) to begin.
Do I need my own API key for the model service?Yes — you must supply an API key for whichever model service you connect; WhaleIsle doesn't give you any model credits, so usage is billed by that provider.
Is there a ready-to-use macOS installer, like the Windows one?No — this release only ships a packaged Windows installer; on macOS you currently have to build and run it from source (macOS 14+, Apple Silicon, Node 22.19+/24+, pnpm 11).
Can I migrate my data from the official DeepSeek CLI?Yes, use the launcher's Import page to migrate from the official CLI or the 0.2.7 desktop build; don't copy the profiles folder or database directly, and re-add your workspace paths afterward.
Can I access my desktop session from my phone?Yes, enabling remote access lets you scan a QR code to open your active desktop session in a mobile browser.
What if an installed plugin breaks the app on startup?Use the launcher's plugin troubleshooting screen to disable the misbehaving plugin and restart; older dshbot-style plugins can be incompatible with newer Harness versions.
Does WhaleIsle have the whale-girl desktop pet mentioned in its name?Yes, according to the project description it ships a whale-girl desktop pet alongside its wallpaper gallery and frosted-glass/pixelated theme effects for personalizing the app.
Creator
ChisaAlter
Size
398.9 MB
Stars
176
Age
2mo
Commits · 90 Days