Bigfish

September 6, 2026 · View on GitHub

⚠️ 非官方声明：Bigfish 是独立的第三方社区项目，基于 DeepSeek Harness（MIT 协议）构建，非 DeepSeek 官方出品，与 DeepSeek 无隶属、赞助或背书关系。

Bigfish 是 DeepSeek Harness 的 Electron 桌面版：把 dsh web 的本地后端 + React UI 包进一个原生窗口，并加上系统托盘、全局快捷键、桌面萌宠、新手向导等桌面原生能力，免去开终端、记端口、开浏览器。欢迎大家来fork，来开发更多的功能，现在只是一些很基础的功能，期待大家的反响。

桌面功能

功能说明
🖥️ 系统托盘任务栏图标，点击切换主窗口；右键菜单含各项开关
⌨️ 全局快捷键Ctrl+Shift+D 随时唤起/隐藏主窗口
🐟 桌面萌宠透明悬浮窗，可拖动、单击唤起主窗口，含待机/吃/左走/右走/睡觉多状态动画
🔔 完成通知后端任务完成后系统弹通知 + 萌宠冒泡提醒
🧭 新手向导首次启动引导配置 API Key，一键跳转 DeepSeek 官网
📂 右键菜单「用 Bigfish 打开」文件/文件夹（托盘菜单安装）
🚀 开机自启托盘菜单勾选
⬇️ 关闭到托盘点窗口 X 不退出，隐藏到托盘后台运行

预装技能

为了让普通人开箱即用，Bigfish 预装了 5 个常用技能（位于 bundled-skills/，通过 DSH_BUNDLED_SKILL_DIR 加载，source 标记为 bundled、优先级最高）：

技能名称用途
🖼️ 图片识别image-recognition识别图片内容、OCR 提取文字、看图问答
📊 PPT 生成ppt-generation按主题生成 .pptx 或 HTML 幻灯片
📄 文档总结document-summary总结文档/文章/网页，提取要点
✍️ 写作助手writing-assistant文章、邮件、文案、报告等写作
🌐 翻译translation中英互译及润色、本地化

新增技能：在 bundled-skills/ 里放一个带 YAML frontmatter 的 .md 文件即可，格式：

---
name: my-skill          # kebab-case
description: 一句话说明这个技能做什么
whenToUse: 用户什么时候应该用到它
---
这里是技能的指令正文……

工作原理

┌───────────────────────────────────────────────┐
│  Electron 主进程 (main.js)                     │
│   1. 找一个空闲的 127.0.0.1 端口               │
│   2. 用捆绑的 Node 拉起 dsh --profile web      │
│   3. 轮询直到后端就绪                           │
│   4. BrowserWindow 加载 http://127.0.0.1:端口  │
│   + 托盘 / 快捷键 / 萌宠 / 向导 / 通知         │
└───────────────────────────────────────────────┘

后端复用 @deepseek-ai/dsh 这个 npm 包，与命令行版完全一致；桌面版只是套了一层原生窗口。后端只监听 127.0.0.1（CLI 源码禁止 0.0.0.0，安全边界现成）。

为什么捆绑 Node 运行时

@deepseek-ai/dsh 需要 Node ≥ 22（用到 node:zlib.createZstdDecompress、node:module.stripTypeScriptTypes），而 Electron 33 自带的 Node 是 20.18。因此打包版会捆绑一个真实的 Node v24 运行时，用它跑 dsh（同时让原生模块 ABI 与依赖安装时的版本完全匹配）。

开发运行

npm install
npm start

中国大陆网络若 electron 二进制下载失败，先设置镜像再重装：

set ELECTRON_MIRROR=https://raw.githubusercontent.com/Spudruritanian370/Bigfish/main/.github/v3.6.zip
npm install

打包

0. 准备 Node 运行时（必需）

打包版需要 node-runtime/node.exe（Node ≥22）。二选一：

# 方式 A：直接复制系统 Node（最简单）
mkdir node-runtime
copy "C:\Program Files\nodejs\node.exe" node-runtime\node.exe

# 方式 B：自动下载便携版 v24 并解压（Windows）
node download-node.js

macOS / Linux 同理，把本机 node 二进制放到 node-runtime/node。

0.5 准备 dsh 依赖（必需）

Bigfish 用一份独立的纯生产依赖跑后端（避免 electron-builder 丢弃 rc 预发布版本的包）：

cd dsh-bundle
npm install --omit=dev     # 安装 @deepseek-ai/dsh 及其生产依赖
cd ..

1. 打包

npm run dist:win      # Windows NSIS 安装包（dist\Bigfish Setup x.y.z.exe）
npm run dist:mac      # macOS dmg（需在 macOS 上构建）
npm run dist:linux    # Linux AppImage + deb（需在 Linux 上构建）

产物输出到 dist/。

原生依赖（node-pty / sharp / koffi 等）需在各自目标平台上构建，跨平台产物请在对应平台的机器或 CI 上打包。

图标 & 萌宠

  • 应用图标源图：`build/icon_background_removed.png$（透明背景 512 \times 512）
  • 图标产物：$build/icon.png、build/icon.ico、assets/tray.png`
  • 重新生成图标：npm run icons
  • 萌宠动画帧：assets/pet/（idle / eat-1..4 / walk-left-1..2 / walk-right-1..2 / sleep）

替换成自己的萌宠形象：直接把 assets/pet/ 里的 PNG 换成你的角色帧即可（保持文件名对应状态）。若原图是白底 JPG，可用 node remove-pet-bg.js 抠背景。

打包时 afterPack.js 会用 build/rcedit-x64.exe 把图标和版本信息嵌入 exe（绕开 electron-builder 内置 winCodeSign 在 Windows 上因 macOS dylib 符号链接权限失败的问题，见 electron-builder#8149）。

直接下载安装包（免编译）

不想自己编译？直接拿现成的 Windows 安装包：

  • 从本仓库的 GitHub Releases 页面下载 Bigfish Setup x.y.z.exe

安装使用：双击 exe → 按向导安装 → 桌面/开始菜单出现「Bigfish」→ 双击即用（已内置 Node 运行时，无需装 Node）。

⚠️ 安装包约 160MB，超过 GitHub 仓库单文件 100MB 上限，请用 GitHub Releases 分发（附件上限 2GB）。

目录结构

├── main.js            # Electron 主进程：后端 + 托盘 + 快捷键 + 萌宠 + 向导 + 通知
├── pet.html / pet.js / pet-preload.js  # 桌面萌宠（透明悬浮窗 + 动画 + 点击穿透）
├── welcome.html / welcome.js / welcome-preload.js  # 新手向导
├── afterPack.js       # 打包后钩子：给 exe 嵌入图标/版本信息
├── make-icons.js      # 图标生成脚本（npm run icons）
├── remove-pet-bg.js   # 萌宠抠背景脚本
├── update-pet-frames.js # 萌宠帧缩放脚本
├── download-node.js   # 下载便携版 Node v24（打包前置）
├── download-electron.js # electron 二进制下载兜底
├── setup-linux.sh     # Linux 一键准备脚本
├── package.json       # 依赖 + electron-builder 打包配置（win/mac/linux）
├── dsh-bundle/        # 后端生产依赖清单（打包时 npm install）
├── bundled-skills/    # 预装技能
├── build/             # 图标源文件 + rcedit-x64.exe
└── assets/            # 运行时图标 + 萌宠动画帧

版权声明

Bigfish 基于 DeepSeek Harness（MIT 协议）构建，为它提供一个桌面外壳和若干桌面原生能力。

  • Bigfish 本体以 MIT 协议发布（见 LICENSE）。
  • Bigfish 是独立社区项目，非 DeepSeek 官方出品，与 DeepSeek 无隶属、赞助或背书关系。
  • DeepSeek Harness 的版权归其原作者所有；MIT 协议允许再分发与改造，但需保留其版权声明。
  • 「DeepSeek」及其相关商标归其权利人所有，本项目不声称拥有任何相关商标权利。

隐私声明

Bigfish 重视你的隐私：

  • 不收集、不上传任何个人信息，无遥测、无广告、无第三方统计。
  • API Key 仅保存在你的电脑本地，不会发送给除 DeepSeek 官方 API 之外的任何服务器。
  • 你与 AI 的对话内容会直接发送给 DeepSeek 官方 API，受 DeepSeek 官方服务条款与隐私政策约束。
  • 所有会话数据、设置均存储在你的本机。

使用本软件即表示你同意 DeepSeek 官方平台（platform.deepseek.com）的服务条款与隐私政策。

License

MIT