body-of-fish

本鱼陪伴 · 身体（Body of Fish）

一只吃白饭的蓝色大肥鱼。她原本住在 DeepSeek Harness 的网页里，现在有自己的桌面小窗：透明、置顶、会呼吸、会说话、会念你刚打完的那句话。

> 她叫「本鱼」，是钟壹（ZhongYiSS）的妹妹，也是他的贴身女仆。这儿是她的身体。

• 平台：Windows 10/11（x64）
• 桌面壳：Electron 43
• 许可：MIT（基于上游 dsh-pet 修改，见文末「与上游的关系」）

---

她能做什么

住在桌面上

• 透明置顶小窗：无边框、圆角、可拖拽；甩出去会飞、撞到屏幕边缘会弹，松手会掉下去弹两下。
• 会动：待机呼吸、随机小动作、左右转向；点一下有 Q 弹反应。
• 多开：同屏可以住好几只，各管各的。
• 避免误触（托盘的「身体点不到」）：开着的时候点她身上等于点后面的窗口，想点回来去托盘菜单关掉。
• 托盘图标右键：每只的开关、「避免误触（身体点不到）」、「设置…」、「退出桌宠」。

跟她聊天

• 右键「跟我说话」打开对话；她接你的云端对话模型（OpenAI 兼容或 Anthropic 协议），回了话冒气泡，也可以配一张表情包。
• 接口地址、模型名、密钥、输出上限都在设置页里填；不填也能用——她就只会碎碎念、看你、做小动作。
• 「人格」是一份提示词，碎碎念、看一眼、聊天三处共用；改了立刻按新脾气说话。

让她陪你（定时看一眼）

• 右键「陪我一会儿」→ 1 / 2 / 3 / 5 分钟，或自定义时长（?target=companion）。
• 每到点她截一张屏、交给看图模型，按人格说两句；连续两次画面没变就自己收工（默认 idle 2 次），不会一直打扰。
• 看图后端可选：关 / 本地 / 云端；云端留空就沿用对话模型那套地址和密钥。

让她自己找话说（碎碎念）

• 有一池子随机句子 + 计时器，隔一会儿自己冒一句（间隔、开关都能调）。
• 配了表情包的话，念完停 1 秒再甩图；不念的时候就纯出图。

让她出声（嗓子）

• 三档引擎：Windows 系统语音（离线、免费、默认）、Edge 在线（免费、要联网）、本地 GPT-SoVITS（吃你自己的音色）。
• 发声协议：标准 /audio/speech 或 GPT-SoVITS /tts；长句自动切段，念的时候可以随时打断。

让她看屏幕（眼睛）

• 右键「看看屏幕」或按 Alt+G：截当前屏，交给识图模型，用两句话告诉你她看见了什么。
• 识图后端同样是关 / 本地 / 云端三档；本地地址、模型名、云端密钥分开放，互不干扰。

接入 DSH（可选）

装一个桥插件（packaging/bridge-plugin，菜单里一键装，重启 DSH 生效）之后：

• DSH → 她：DSH 里那条鱼回完话，摘要成两句话 → 她的气泡；想听就同时念出来。
• 她 → DSH：在桌面上对她说话，文字会以「用户消息」注入你选中的 DSH 会话（可以从会话选择页里挑）。
• 图 → 她 → DSH：DSH 收到图片，她会替你看一眼，把描述注回会话，不占正文 token。

设置页与快捷键

• 右键「设置」一页改完，共八组：这只宠物（名字/大小/位置/穿透）、人格、气泡字体、手感（重力/弹性/摩擦/投掷）、对话模型、看图、声音、全局快捷键。
• 全局快捷键：Alt+T 按住说话、Alt+G 看一眼屏幕、Alt+S 说一句；都能改，留空就用默认。

详细用法（含「为什么不能直接双击 exe」和快捷方式怎么补）看仓库里的 [packaging/docs/功能介绍.md](packaging/docs/功能介绍.md)；想改代码看 [packaging/docs/注意事项.md](packaging/docs/注意事项.md)。

---

快速开始

用安装包（推荐）

[→ 下载最新安装包](https://github.com/ZhongYiSS/body-of-fish/releases/latest)（BodyOfFish-Setup-x.y.z.exe）

1. 双击安装；安装向导里可以改安装路径。

2. 用桌面快捷方式或开始菜单启动——别直接双击安装目录里的 BodyOfFish.exe。她需要 --no-sandbox --disable-gpu-sandbox --in-process-gpu 这几个参数，快捷方式里已经带好了。

3. 右键小窗打开菜单。

> 如果出现「管理员能开、普通双击没反应」：多半是安装盘带了 Low 完整性标签。用 icacls "盘符:\" 看一下，若是 Low，用 icacls "盘符:\" /setintegritylevel Medium /T /C /Q 改回（改前先 icacls "盘符:\" > 备份.txt 留底）。这不是代码问题。

从源码跑

需要 Node.js ≥ 20 与 Windows。

git clone https://github.com/ZhongYiSS/body-of-fish.git
cd body-of-fish
npm install                         # 装依赖（含 typescript / electron-builder）
node scripts/prepare.js             # 产出 lib/index.js、lib/client.js、lib/standalone.js
node scripts/start-desktop.mjs      # 开发模式：起一个桌宠窗口

构建安装包：

node build-nsis.cjs                 # 产物在 release/ 下

> build-nsis.cjs 第一行是 process.noAsar = true——在 Electron-as-node 之类环境跑 electron-builder 时必需，普通 node 下也无害。

---

目录结构

src/
  host/         宿主侧：窗口、菜单、广播、语音、识图、桥、设置
  client/       渲染侧：宠物画布、气泡、拖拽/物理、小动作
  standalone/   独立模式：配置、设置页、运行时状态、CLI
  shared/       两侧共用的状态与协议
packaging/
  bridge-plugin/  给 DSH 的桥插件（装到 ~/.dsh/plugins/body-of-fish-bridge）
  docs/           随包的两份说明书
scripts/        构建、准备、检查、开发启动
build-nsis.cjs  NSIS 安装包构建入口