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…

Что это?WhaleIsle (鲸屿) — поддерживаемый сообществом десктоп-клиент для DeepSeek Harness, позволяющий общаться с AI, просматривать проект, запускать терминал и работать с Git в одном окне.
Это официальное приложение DeepSeek или просто GUI-обёртка над CLI?Это независимо поддерживаемый неофициальный клиент сообщества, построенный поверх CLI DeepSeek Harness; он включает сам Harness, поэтому не нужно настраивать Node.js или запускать 'dsh web' самостоятельно.
Как установить и начать пользоваться?Скачайте установщик Windows x64 v0.2.9, запустите его, затем настройте API-ключ своего модельного сервиса в настройках и выберите папку проекта (или начните чат без воркспейса), чтобы начать.
Нужен ли свой API-ключ для модельного сервиса?Да — нужно предоставить API-ключ того модельного сервиса, к которому вы подключаетесь; WhaleIsle не даёт никаких модельных кредитов, поэтому использование тарифицирует сам провайдер.
Есть ли готовый установщик для macOS, как для Windows?Нет — этот релиз поставляет только упакованный установщик Windows; на macOS пока придётся собрать и запустить из исходников (macOS 14+, Apple Silicon, Node 22.19+/24+, pnpm 11).
Можно ли перенести данные из официального CLI DeepSeek?Да, используйте страницу импорта в лаунчере, чтобы мигрировать с официального CLI или десктоп-сборки 0.2.7; не копируйте папку profiles или базу данных напрямую и после этого заново добавьте пути воркспейсов.
Можно ли попасть в свою десктоп-сессию с телефона?Да, включив удалённый доступ, можно отсканировать QR-код и открыть активную десктоп-сессию в мобильном браузере.
Что делать, если установленный плагин ломает приложение при запуске?Используйте экран диагностики плагинов в лаунчере, чтобы отключить проблемный плагин и перезапуститься; старые плагины в стиле dshbot могут быть несовместимы с новыми версиями Harness.
Есть ли в WhaleIsle десктоп-питомец «девочка-кит», на который намекает название?Да, согласно описанию проекта, в него входит десктоп-питомец «девочка-кит», а также галерея обоев и эффекты оформления «матовое стекло»/«пикселизация» для персонализации приложения.
Creator
ChisaAlter
Size
365.6 MB
Stars
178
Age
2mo
Commits · 90 Days