Bigfish README

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

Bigfish 🐳

DeepSeek Harness 的 Electron 桌面版 —— 把 dsh web 包进原生桌面窗口。

免去手动开终端、记端口、开浏览器。装完双击即用。

下载最新版本 · 版本说明 · 使用说明 · 已知问题与排查 · 致谢与合规

GitHub Release · Stars · Downloads · License

Bigfish 默认背景

Bigfish 是 DeepSeek Harness 的 Electron 桌面版。

把 dsh web 的本地后端 + React UI 包进一个原生桌面窗口,免去手动开终端、记端口、开浏览器。

当前版本:0.1.2 · Windows / macOS / Linux

功能亮点

截图

鲸鱼娘桌宠 兑换屋
鲸鱼娘桌宠 兑换屋
模式选择
专注模式/鲸鱼模式

工作原理

┌─────────────────────────────────────────┐
│  Electron 主进程 (main.js)               │
│   1. 找一个空闲的 127.0.0.1 端口         │
│   2. 拉起 dsh --profile web 子进程        │
│   3. 轮询直到后端就绪                     │
│   4. BrowserWindow 加载 http://127.0.0.1:端口 │
│   5. 插件市场:内置 pnpm 管理 profile 插件 │
└─────────────────────────────────────────┘

后端复用的是 @deepseek-ai/dsh 这个 npm 包,与命令行版完全一致;桌面版只是给它套了一层原生窗口。后端本身只监听 127.0.0.1(CLI 源码禁止 0.0.0.0,安全边界现成)。

开发运行

npm install
npm start

打包

npm run dist:win      # Windows NSIS 安装包
npm run dist:mac      # macOS dmg(需在 macOS 上构建)
npm run dist:linux    # Linux AppImage + deb(需在 Linux 上构建)

产物输出到 dist/。

注意:原生依赖(node-pty / sharp / koffi 等)需在各自目标平台上构建;跨平台产物请用对应平台的 CI 或机器打包。

运行时选择

场景 执行 dsh 的运行时
开发 (npm start) 系统 Node(DSH_NODE 环境变量可覆盖)
打包后 自带 Node(node-runtime/),无需系统 Node

插件系统

Bigfish 遵循 DeepSeek Harness 官方 Cordis 插件体系:

目录

致谢与合规

Bigfish (turtle2209/Bigfish)

Searching Database…

Что это такое?Bigfish — это неофициальный настольный клиент для DeepSeek Harness (dsh) на Electron: он оборачивает локальный бэкенд dsh и его веб-интерфейс на React в обычное окно приложения, так что вам не нужно открывать терминал, помнить порт или запускать браузер. Установили — и просто запускаете двойным кликом.
Это форк dsh или он как-то меняет работу самого harness?Ни то, ни другое — это просто оболочка. Бэкендом служит официальный npm-пакет @deepseek-ai/dsh, точно такой же, как в версии для командной строки; Bigfish лишь помещает его в нативное окно.
Как его запустить?Скачайте последнюю сборку для Windows, macOS или Linux и установите её — универсальный пакет уже содержит среду выполнения Node.js и бэкенд dsh, так что после установки достаточно двойного клика. Настраивать окружение вручную не нужно.
Нужно ли сначала поставить Node.js или что-то ещё?Нет. В комплекте с приложением идёт собственная среда Node и даже встроенный автономный pnpm для установки плагинов; системный Node используют только разработчики, запускающие проект из исходников (npm start), и его путь можно переопределить переменной окружения DSHNODE.
Есть ли подводные камни — при использовании или при сборке из исходников?Для пользователей их почти нет — готовые сборки есть для Windows, macOS и Linux (текущая версия 0.1.2). Сложнее приходится тем, кто собирает из исходников: нативные зависимости вроде node-pty, sharp и koffi нужно компилировать под каждую целевую ОС, поэтому кроссплатформенная сборка требует CI или машин под каждую платформу.
Я ни разу не пользовался dsh — справлюсь ли я как полный новичок?Именно для таких программа и сделана: мастер первого запуска проведёт вас через регистрацию, пополнение баланса и ввод вашего API Key, а если бэкенд не стартует, есть пошаговое самовосстановление (сброс настроек плагинов с сохранением ключей и сессий либо полный сброс к заводским настройкам).
Какие навыки предустановлены?Распознавание изображений, создание презентаций, краткий пересказ документов, помощник по письму и перевод — всё рассчитано на обычных пользователей, а не на разработчиков.
Что за магазин плагинов?Из меню в системном трее можно просмотреть каталог сообщества awesome-dsh-plugin (более 1000 плагинов) с поиском и категориями, а затем установить или удалить любой в один клик; чтобы изменения вступили в силу, приложение перезапускается. Плагины — это npm-пакеты в рамках официальной системы Cordis, а при отсутствии интернета каталог подгружается из встроенной копии.
Что за питомец-кит?Это настольный питомец (девочка-кит) в прозрачном перетаскиваемом плавающем окне: по клику с ним можно взаимодействовать, а сам он гуляет, спит и разговаривает, причём анимации постоянно обновляются. Реализация на основе плагинов позаимствована у проекта сообщества dsh-BigfishPet от s17179XTY.
Чем это лучше, чем просто открыть dsh в браузере?Значок в системном трее с глобальной горячей клавишей (Ctrl+Shift+D), всплывающие уведомления о завершении задач плюс системные уведомления, настраиваемые фоны с поддержкой тёмной и светлой темы, автозапуск вместе с системой, а в Windows — пункт «Открыть с помощью Bigfish» в контекстном меню.
Creator
turtle2209
Size
4.9 MB
Stars
323
Age
2mo
Commits · 90 Days