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…

178 ·GitHub
WhaleIsle
这是什么？WhaleIsle（鲸屿）是一个社区维护的 DeepSeek Harness 桌面客户端，让你在一个窗口里与 AI 聊天、浏览项目、运行终端并管理 Git。
它是 DeepSeek 官方应用，还是只是 CLI 的图形外壳？它是构建在 DeepSeek Harness CLI 之上的独立维护的非官方社区客户端；它自带 Harness 本体，所以你不需要自己配置 Node.js，也不用手动运行 'dsh web'。
怎么安装并开始使用？下载 Windows x64 v0.2.9 安装程序并运行，然后在设置中配置模型服务的 API 密钥，并选择一个项目文件夹（或直接开始无工作区聊天）即可开始使用。
需要我自己准备模型服务的 API 密钥吗？需要——无论连接哪家模型服务，你都必须提供对应的 API 密钥；WhaleIsle 不提供任何模型额度，用量由该服务商计费。
有像 Windows 那样开箱即用的 macOS 安装包吗？没有——本版本只提供打包好的 Windows 安装程序；在 macOS 上目前必须从源码构建并运行（macOS 14+、Apple Silicon、Node 22.19+/24+、pnpm 11）。
我能从官方 DeepSeek CLI 迁移数据吗？可以，使用启动器的「导入」页面从官方 CLI 或 0.2.7 桌面版迁移；不要直接复制 profiles 文件夹或数据库，迁移后还需要重新添加工作区路径。
我能在手机上访问桌面会话吗？可以，启用远程访问后，扫描二维码就能在手机浏览器中打开当前活跃的桌面会话。
如果已安装的插件导致应用启动崩溃怎么办？使用启动器的插件故障排查界面禁用出问题的插件再重启；旧的 dshbot 风格插件可能与新版 Harness 不兼容。
WhaleIsle 有它名字里提到的那种鲸鱼娘桌面宠物吗？有，根据项目描述，它内置了鲸鱼娘桌面宠物，还有壁纸画廊以及磨砂玻璃/像素化主题特效，可用于个性化应用外观。
What are similar projects?oh-dsh, dsh_desktop, deepseek-harness-studio, DSH-better-sidebar, EAC-Desktop, dsh-liang-skin, deepseek-harness-desktop, ds-harness-remote
Which topics is it in?remote-desktop, qr-code, theme, plugin-system, dsh-plugin, deepseek-harness, electron, git, chatbot, deepseek, customization, china
Creator
ChisaAlter
Size
365.6 MB
Stars
178
Updated
CommitOct 18Releasev0.3.9Oct 18
Age
2mo
Commits · 90 Days