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…

What is this?Bigfish is an unofficial Electron desktop client for DeepSeek Harness (dsh): it wraps the dsh local backend and its React web UI in a native window, so you never open a terminal, remember a port, or launch a browser. Install it and just double-click.
Is this a fork of dsh, or does it change how the harness works?Neither — it is a wrapper. The backend is the official @deepseek-ai/dsh npm package, identical to the CLI version; Bigfish just puts a native window around it.
How do I get it running?Download the latest release for Windows, macOS, or Linux and install it — the all-in-one package bundles the Node.js runtime and the dsh backend, so after installing you just double-click. No manual environment setup.
Do I need Node.js or anything else installed first?No. The packaged app ships its own Node runtime and even a built-in standalone pnpm for installing plugins; only developers running from source (npm start) use the system Node, which the DSHNODE environment variable can override.
Any pitfalls, as a user or when building it from source?For users, not many — ready-to-run releases exist for Windows, macOS, and Linux (current version 0.1.2). Building from source is the tricky part: native dependencies like node-pty, sharp, and koffi must be compiled on each target OS, so cross-platform builds need per-platform CI or machines.
I have never used dsh — is this manageable for a total beginner?That is who it is built for: a first-run wizard walks you through registering, topping up, and entering your API Key, and if the backend fails to start there is guided self-repair (reset plugin config keeping keys and sessions, or a full factory reset).
What skills come pre-installed?Image recognition, PPT generation, document summarization, a writing assistant, and translation — aimed at ordinary users rather than developers.
What is the plugin marketplace about?From the tray menu you can browse the community's awesome-dsh-plugin catalog (1000+ plugins) with search and categories, then install or uninstall with one click; the app restarts to apply changes. Plugins are npm packages under the official Cordis system, and the catalog falls back to a bundled copy when offline.
What is the deal with the whale pet?A desktop pet (a whale girl) living in a transparent, draggable floating window: click to interact while it randomly walks, sleeps, and talks, with animation assets updated continuously. Its plugin-based approach credits the community project dsh-BigfishPet by s17179XTY.
What else does it add over running dsh in a browser?System tray with a global shortcut (Ctrl+Shift+D), task-completion bubbles plus system notifications, custom backgrounds with dark/light adaptation, auto-start on boot, and a Windows right-click 'Open with Bigfish' action.
Creator
turtle2209
Size
4.9 MB
Stars
323
Age
2mo
Commits · 90 Days