如何快速安装 BongoCat：跨平台桌宠完整指南

【免费下载链接】BongoCat🐱 BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址: https://gitcode.com/gh_mirrors/bong/BongoCat

深夜赶需求，屏幕角落里那只猫正跟着你的指尖一鼓一鼓——左手敲下空格，它的右爪就落下去；鼠标一挪，那双眼睛立刻跟过去。BongoCat 就是这样一只跨平台桌宠：Live2D 小猫住在你的屏幕上，离线运行、不收集任何数据，只在你的指尖落下时做出反应。

谁该用它：一张快速决策卡

• 适合：主力机是 Windows 或 macOS，想让桌面"活"起来的人——写代码、打游戏、开直播都合适。
• 暂时不适合：Linux 用户。项目首发只覆盖 Windows 与 macOS，Linux 列在后续路线图上。
• 和原版的差异：它受 Bongo-Cat-Mver 启发，但原版只在 Windows 上跑；BongoCat 把猫咪带到了 macOS，并加上了自定义 Live2D 模型导入与游戏手柄同步。

从零到跑起来：BongoCat 桌宠安装与首次启动

下载安装包

到项目的发布页面，下载对应平台的安装包：Windows 用户拿.exe安装程序，macOS 用户拿.dmg镜像。Windows 只提供 x64 构建，Intel 与 ARM 机器（经系统仿真）都能跑。

安装应用

双击安装包，按向导一路默认即可。启动后，一只默认的猫会出现在桌面角落，爪子搭在键盘上，眼睛跟着光标转。

首次启动与权限授权

Windows 开箱即用。macOS 需要读取全局输入，首次启动时应用会引导你完成"输入监控"等系统权限的授权——照提示打开系统设置、勾选对应选项，猫咪就开始动了。

为 BongoCat 桌宠做最小可用配置

打开设置窗口，只做三件事就够：

• 在模型页挑一只预置猫：standard（键盘+鼠标）、keyboard（纯键盘）、gamepad（手柄）三种模式；
• 把窗口拖到不挡事的位置，按住右键拖动可以调整大小；
• 把全局快捷键改成不冲突的组合，方便随时唤出设置。

真实使用场景：写代码、打游戏、开直播

写代码时。切到 keyboard 模型，每按下一个键，对应位置的爪子就落下去再弹起，按键音效跟着轻响一声。连打一段 tab 补全，屏幕角落就是一场小小的鼓点；移动鼠标，它的视线始终追着你。

打游戏时。插上手柄，BongoCat 可以按你的设置自动切到 gamepad 模型——ABXY、十字键、肩键按下时爪子同步落下，手柄一断又切回键盘猫。打两把，它比你还投入。

开直播或录屏时。透明置顶的桌宠窗口有时不便采集；Windows 下可以切到普通窗口模式：系统标题栏、不透明背景，方便窗口捕获。不想看它的时候，悬停或空闲自动隐藏的设置也能让它识趣地退场。

给想深入的人：从源码构建与自定义模型

BongoCat 是单一 Rust 应用，按领域拆成 bongocat-app、bongocat-input、bongocat-live2d、bongocat-overlay 等 crate，设置界面基于 GPUI。构建需要 Rust 工具链（版本由 rust-toolchain.toml 锁定）、just 和 python3：

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

跑起来之后，just build出发布产物，just test跑全部测试。想换一只猫？自定义入口是 Live2D 模型包（.model3.json），在设置窗口的模型库中导入即可；社区模型仓库 Awesome-BongoCat 里有更多现成的猫可以淘。

资源与下一步

• 项目仓库与贡献指南：README.md、CONTRIBUTING.zh-CN.md
• 架构设计文档：docs/technical-design.md
• 配置字段契约：shared/config/contract.md
• 更多模型：社区仓库 Awesome-BongoCat

技术栈速览：

• 架构：单一 Rust 应用，Apache-2.0 开源
• 界面：GPUI 设置窗口 + 平台原生模型窗口
• 渲染：Live2D（Cubism Core），Windows 用 D3D11、macOS 用 Metal
• 输入与音效：键鼠与游戏手柄（gilrs）、rodio 播放按键音

把它放到桌面角落，然后忘掉它的存在——直到某个加班的夜晚，你需要一个理由微笑。

【免费下载链接】BongoCat🐱 BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址: https://gitcode.com/gh_mirrors/bong/BongoCat