botaochen840-lgtm/fatfish-pet-smart-companion 预览 preview

botaochen840-lgtm/fatfish-pet-smart-companion

FatFish Pet Smart Companion - 自包含智能桌面桌宠(改编自 whale-girl),下载即用,可选真连 DeepSeek Harness

Project Overview项目介绍

FatFish Pet Smart Companion is an Electron-based, self-contained desktop pet application adapted from vlln's whale-girl web plugin, lifting the original browser-bound character out onto the operating system desktop as a floating companion. It ships with its own asset bundle of fifteen expressions embedded inside the installer, so no browser host and no separately loaded DSH plugin are required to use it out of the box. Distribution happens through GitHub Releases, where the maintainer publishes a Windows NSIS installer plus a portable build alongside a Linux AppImage and an RPM package; users simply download the appropriate artifact for their platform, double-click it, and the pet appears immediately as a transparent, frameless, always-on-top overlay that does not occupy a taskbar window and exposes only a small tray icon for show, hide, and quit.

The companion's primary workflow is ambient desktop presence and reactive feedback. A single click feeds the pet, a right-click triggers a play animation, click-and-drag repositions it on screen while remembering the location for next launch, and the mouse wheel rescales the sprite between 0.6x and 2x. While idle, the character wanders randomly, blinks, and occasionally turns its head; long inactivity triggers a sleep animation with a groggy wake-up sequence. Speech-bubble overlays above the head report on simulated work states such as deep thinking, tool use, awaiting approval, task completion, and request failure, making the pet feel responsive even without an attached agent.

When DeepSeek Harness happens to be running on the same machine, FatFish automatically detects it and switches from its built-in idle simulation into a real follow mode, mirroring the live DSH work state through the same expression set and bubbles used by the original web-based whale-girl, without requiring any extra configuration. The project depends on Electron, the character assets inherited from whale-girl's assets/characters folder, and original artwork by ZipZipPipe; the MIT license covers the codebase, which the author notes was generated by an AI and adapted from whale-girl. Official builds target only Windows and Linux, and a minor known bug that occasionally pushes text and sprite apart can be fixed by dragging the pet once, no restart needed.

大肥鱼(FatFish Pet Smart Companion)是一款基于 Electron 的独立桌面宠物应用,灵感改编自 vlln 的 whale-girl 网页插件,将原本只在浏览器内活动的鲸鱼娘形象搬到桌面层运行。应用以透明、无边框、始终置顶的悬浮窗形态呈现,自带 15 种表情素材,无需浏览器、无需手动加载 DSH 插件即可独立运行;用户只需从 GitHub Releases 下载 Windows 的 NSIS/便携版或 Linux 的 AppImage/RPM 安装包,双击启动即可获得一条活跃在桌面的小精灵。

应用的核心交互围绕桌面陪伴展开:单击可喂食、右键可逗玩、按住可拖拽归位、滚轮可在 0.6x 到 2x 区间缩放大小,空闲状态下角色会自动在屏幕上随机散步、眨眼、转头,长时间不操作则进入睡眠动画。头顶气泡会实时汇报工作状态,包括深入思考、使用工具、等待批准、任务完成、请求失败等场景;位置与大小会在重启后自动恢复,不占独立任务栏窗口,仅在系统托盘留一个小鱼图标供右键显示、隐藏或退出。

当本机同时运行 DeepSeek Harness 时,大肥鱼会自动检测并切换到真实跟随模式,依据 DSH 的实时工作状态切换表情,与网页端 whale-girl 体验保持一致;未连接 DSH 时则像普通桌宠一样安静等待或入睡。该项目依赖 Electron、whale-girl 的 assets/characters 表情素材以及 ZipZipPipe 的原创美术,遵循 MIT 许可(代码由 AI 生成并改编自 whale-girl),仅在 Windows 与 Linux 平台提供官方安装包,文字与宠物偶现距离异常时可拖动一次自动归位,无需重启即可恢复。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:botaochen840-lgtm/fatfish-pet-smart-companion

把 botaochen840-lgtm/fatfish-pet-smart-companion 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

大肥鱼(FatFish Pet Smart Companion)

啊哈哈哈,大肥鱼来喽!一条透明置顶、飘在你桌面上的智能桌宠。

空闲 干活 庆祝
睡觉 进食 开心

🐋 这是什么

大肥鱼 是一款自包含的智能桌面宠物——下载安装即可使用,无需额外配置。它用一套丰富的表情和动作陪伴你:

  • 🧠 会跟着你的工作状态变表情:深入思考、使用工具、等待批准、任务完成、请求失败
  • 😴 空闲太久就自己睡觉,醒来有起床气(刚睡醒动画)
  • 🍚 单击喂它吃饭、🎮 右键逗它玩、🖱️ 拖它散步、🔄 滚轮调大小
  • 🚶 还会自己在屏幕上溜达散步

它是一条透明、置顶、无边框的小精灵,不占任务栏窗口(只在右下角托盘留一个小鱼图标,右键可显示/隐藏/退出),像真的宠物一样安安静静飘在桌面。


🔌 自包含,开箱即用

大肥鱼内置了全部表情素材,所以:

  • ✅ 下载即可用:安装后直接运行,立即有一条活生生的桌宠
  • ✅ 完全独立:不依赖浏览器、不需要单独安装任何 DSH 插件
  • 😴 安静陪伴:未连接 DSH 时,它会像平时空闲一样自己睡觉、用睡觉动画等待,不打扰你
  • 🔗 可选增强:如果你恰好也在运行 DeepSeek Harness,大肥鱼会自动识别并切换成真实跟随模式——它会跟着你的 DSH 实时状态(正在干活/思考/等待批准/任务完成)变化表情

🙏 致谢原作者

本桌宠改编自 @vlln 的 whale-girl 网页端插件,表情素材与状态语义源自该插件。

  • 🎨 鲸鱼娘表情素材由 ZipZipPipe 创作(来自 whale-girl 的 assets/characters)
  • 💡 状态语义、行为逻辑、素材清单源自 vlln 的 whale-girl(Web GUI 版)

感谢 @vlln 的付出,也感谢 ZipZipPipe 的精美素材! 本桌宠不仅把原本活在浏览器里的鲸鱼娘搬到了桌面上,更在 whale-girl 的基础上调整并增加了实用的功能——让它能独立运行、离线陪伴,并在运行 DSH 时智能跟随你的实时工作状态。


✨ 特性

陪伴与表情

  • 15 种表情:空闲 / 干活 / 深入思考 / 等待批准 / 任务完成 / 请求失败 / 失望 / 开心 / 刚睡醒 / 睡觉 / 进食 / 玩耍 / 散步 / 拖拽 / 欢迎
  • 工作汇报气泡:干活、思考、等批准、庆祝、出错时,头顶会冒出小气泡实时汇报
  • 自动游走:空闲时会自己在屏幕上散步溜达,方向随机
  • 眨眼与转身:静止时会随机眨眼、偶尔转头,活灵活现
  • 睡觉等待:长时间空闲或未连接 DSH 时,自己打盹睡觉

交互操作

  • 拖拽移动:按住拖到任意位置,松手归位记忆
  • 滚轮缩放:滚动滚轮调整大小(0.6x–2x)
  • 单击喂食:点一下喂它吃,有进食动画和气泡回复
  • 右键玩耍:右键逗它玩,有玩耍动画

形态与体验

  • 透明置顶:透明、无边框、始终置顶,安安静静飘在桌面
  • 托盘图标:右下角托盘留小鱼图标,右键菜单(显示 / 隐藏 / 退出)
  • 不占任务栏:不显示独立窗口按钮,不打扰工作
  • 状态记忆:位置和大小重启后自动恢复
  • 自包含离线:内置全部表情素材,未连接 DSH 也能完整显示
  • 可选真连:运行 DSH 时自动跟随实时状态,与网页端体验一致

平台

  • Windows:NSIS 安装包 / 便携版
  • Linux:AppImage / RPM

🚀 安装使用

本桌宠是独立应用,下载对应平台安装包即可,不需要浏览器、不需要额外装插件。

# 从发行版页面下载
# https://github.com/botaochen840-lgtm/fatfish-pet-smart-companion/releases
  • Windows:NSIS 安装包 / 便携版
  • Linux:AppImage / RPM

下载后双击运行即可,大肥鱼就会出现在你桌面上~

可选:想让它「真连」跟随你的 DSH 实时状态?装好 DeepSeek Harness 并跑起来,大肥鱼会自动检测并切换到真实跟随模式,无需任何额外设置。

💡 小提示:如果偶尔遇到文字和宠物之间的距离变远的小 bug,用鼠标拖一下宠物就会自动归位,不用重启。


⭐ 支持

点个星标吧~这对我真的很重要

许可:MIT(代码由 AI 生成 + 改编自 whale-girl)


🔗 也看看我其他的插件吧~

← 上一个 Prev dsh-sub2api 下一个 Next dsh-stool-plugin →