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 的分支(fork)吗?它会改变 harness 的工作方式吗?都不是——它只是一个套壳。后端就是官方的 @deepseek-ai/dsh npm 包,和命令行版完全一样;Bigfish 只是给它加了一个原生窗口。
我怎么把它跑起来?下载 Windows、macOS 或 Linux 的最新版本并安装——一体化安装包自带 Node.js 运行环境和 dsh 后端,装好后双击即可。不需要手动配置任何环境。
我需要先装好 Node.js 或别的东西吗?不需要。打包好的应用自带 Node 运行环境,甚至内置了一个独立的 pnpm 用来安装插件;只有从源码运行(npm start)的开发者才会用到系统的 Node,这时还可以用 DSHNODE 环境变量来指定。
作为用户,或者自己从源码构建时,有什么要注意的坑吗?对用户来说坑不多——Windows、macOS 和 Linux 都有开箱即用的版本(当前版本 0.1.2)。麻烦的是从源码构建:node-pty、sharp、koffi 这类原生依赖必须在每个目标操作系统上分别编译,所以跨平台构建需要每个平台各有 CI 或机器。
我从没用过 dsh——完全的新手能用得起来吗?它就是为这类用户做的:首次运行向导会一步步带你完成注册、充值和填写 API Key;如果后端启动失败,还有引导式自动修复(重置插件配置但保留密钥和会话,或者彻底恢复出厂设置)。
预装了哪些技能?图像识别、PPT 生成、文档总结、写作助手和翻译——面向普通用户而不是开发者。
插件市场是怎么回事?从托盘菜单可以浏览社区的 awesome-dsh-plugin 目录(1000 多个插件),支持搜索和分类,然后一键安装或卸载;应用会重启以应用更改。插件都是官方 Cordis 体系下的 npm 包,离线时会回退到内置的一份目录副本。
那个鲸鱼宠物是怎么回事?一个住在透明、可拖动悬浮窗里的桌面宠物(鲸鱼娘):它会随机走动、睡觉、说话,点击可以和它互动,动画素材持续更新。它基于插件实现,功劳归于社区项目 dsh-BigfishPet(作者 s17179XTY)。
和直接在浏览器里跑 dsh 相比,它还多了什么?带全局快捷键(Ctrl+Shift+D)的系统托盘、任务完成的气泡提醒加系统通知、可自定义背景并适配深色/浅色模式、开机自启,以及 Windows 右键菜单里的“用 Bigfish 打开”。
Creator
turtle2209
Size
4.9 MB
Stars
323
Age
2mo
Commits · 90 Days