BongoCat 互动桌宠玩法拆解：5 步上手，让猫咪跟着你的键盘、鼠标与手柄动起来

计煦能Leanne

867人浏览 · 2026-08-15 16:26:20

计煦能Leanne · 2026-08-15 16:26:20 发布

BongoCat 互动桌宠玩法拆解：5 步上手，让猫咪跟着你的键盘、鼠标与手柄动起来

【免费下载链接】BongoCat 🐱 跨平台互动桌宠 BongoCat，为桌面增添乐趣！项目地址: https://gitcode.com/gh_mirrors/bong/BongoCat

同样是桌面上的"小宠物"，有的只会呆萌地循环卖萌，BongoCat 却像养了一只真猫：你敲键盘，它跟着敲；你移动鼠标，它目光追随；你接上手柄，它连按键都会照做。这只基于 Tauri 打造的跨平台 Live2D 桌宠，把"陪伴"从单向观看升级成实时互动，支持 Windows、macOS 与 Linux(x11)，离线可用、零数据收集，完全开源。接下来这份上手手册，会带你用 5 步把它从"装好"玩到"玩出花样"。

第 1 步先认识这只猫：它不是壁纸，是会回应的伙伴

BongoCat 的核心只有一句话：你的操作，就是它的剧本。它不会自言自语，而是根据你手上的设备实时做出对应动作：

敲键盘时，猫咪的小爪子跟着起落，动作节拍和你的打字速度完全同步；
点按鼠标左右键、滑动指针时，它的眼神和头部会跟着光标移动；
接入游戏手柄后，摇杆、扳机、各颗按键都能触发专属动画。

这套"输入设备 → 桌宠动作"的联动逻辑，全部落在源码的 src/composables/useModel.ts 中，按键映射、鼠标轨迹换算、手柄轴值处理都在这里。模型本身则存放在 src-tauri/assets/models/ 目录下，按用途分类，随时可以替换。

它之所以反应跟手、不吃资源，靠的是一套轻巧的组合：Vue 3 + Pinia 管理界面状态，Pixi.js 配合 easy-live2d 负责 Live2D 渲染，Tauri 的 Rust 后端专职监听设备输入。想看渲染细节，可以翻一翻 src/utils/live2d.ts。

第 2 步装好它：一份代码，三平台通用

比起不少"仅限某系统"的桌宠，BongoCat 天然具备跨平台基因。得益于 Tauri 的架构，同一个项目在三个系统上表现一致：

系统	体验	说明
macOS	完整支持	保留了原作者 Bongo-Cat-Mver 的经典手感，还加入了系统级权限适配
Windows	完整支持	下载对应安装包即可，托盘、快捷键一应俱全
Linux (x11)	完整支持	窗口、设备监听均有独立实现，见 `src-tauri/src/core/`

想直接上手玩，下载对应平台的安装包就行；如果你是想折腾代码的开发者，也可以克隆项目跑开发版：

git clone https://gitcode.com/gh_mirrors/bong/BongoCat
cd BongoCat
pnpm install
pnpm dev

提示：项目使用 pnpm 管理依赖，首次启动前记得先安装 pnpm。跑起来后，桌面上会多出一只随时待命的猫咪。

第 3 步给猫换"皮肤"：三套预置模型怎么挑

BongoCat 出厂自带三套模型，分别对应不同的使用场景。它们共用同一套表情与动作体系，但互动的侧重点完全不同：

模型	最佳搭档	适合谁
标准模型	鼠标	日常办公、摸鱼陪伴，眼神跟随鼠标很传神
键盘模型	键盘	写代码、写文档的重度打字用户，敲击动作节奏感拉满
手柄模型	手柄	游戏玩家，手柄按键会映射成猫咪的动作

三套模型在设置页可以随时一键切换，无需重启。切换入口就在偏好设置 → 猫猫（模型）页面，点选即换装。

小建议：第一次玩，建议先用键盘模型打字，再切手柄模型接上游戏，感受它"看人下菜碟"的切换体验。

第 4 步调教细节：让猫待得舒服，你也舒服

桌面宠物最怕两件事：挡视线、占资源。BongoCat 的偏好设置把这些问题都拆成了细粒度选项，集中在 src/pages/preference/ 下，按猫猫、模型、通用三个板块管理。

窗口行为，主打"不挡事"：

鼠标穿透：开启后猫咪只做背景板，点击操作全部穿透到下层窗口，打游戏必开；
置顶显示 / 缩放 / 透明度 / 圆角：自由调整猫咪的存在感；
悬停隐藏：鼠标靠近时自动隐身，配合延迟时间防止误触；
保持屏幕内：窗口移动再远也不会飞出屏幕边界。

模型行为，主打"跟手感"：

镜像 / 鼠标镜像：翻转动作朝向，让猫咪"左右手"配合你的习惯；
自动松开延迟：抬起按键后猫咪爪子回弹的等待时间，调大更慵懒、调小更利落；
最大 FPS：限制渲染帧率，低配机器也能流畅运行；
动作音效开关：不想被打扰时可以一键静音。

外观与语言：

深色 / 浅色 / 跟随系统三档主题；
界面支持简中、繁中、英文、越南语、葡语，多语言文件统一放在 src/locales/ 目录。

组合拳示例：白天办公用"置顶 + 100% 缩放 + 键盘模型"，晚上打游戏切"鼠标穿透 + 70% 透明度 + 手柄模型"，一套配置对应一种心情。

第 5 步进阶玩法：导入自己的模型 + 一键触发动作

玩熟预置模型后，就可以进入"造猫"环节了。

模型文件长什么样？ 一个 Live2D 模型通常由这些文件组成：cat.model3.json 主配置、.moc3 核心模型数据、.1024 目录下的贴图纹理，以及 exp_*.exp3.json 表情和 .motion3.json 动作。整套结构在 src-tauri/assets/models/ 里一目了然。

怎么导入？ 偏好设置 → 模型 → 上传，选择你制作好的模型文件即可，上传逻辑实现在 src/pages/preference/components/model/components/upload/。想从旧版 Bongo-Cat-Mver 迁移模型？项目也提供了格式转换工具，社区里还有大量现成模型可以直接拿来用。

一键触发"表演"： 每套模型都自带多个动作（motion）和表情（expression）。在偏好设置的"行为"弹窗里，可以把它们绑定到快捷键上——比如按下 Ctrl+1 让猫咪做指定动作、Ctrl+Shift+Q 切换表情。快捷键的生成规则在 src/composables/useModel.ts 里，数字键与字母键都预留了层级，行为再多的模型也不怕不够绑。