BongoCat1.12.0

BongoCat 是一款会随键盘、鼠标和手柄操作做出动作的跨平台桌面宠物。它把 Live2D 角色放在透明桌面窗口中，可调整置顶、点击穿透、窗口大小、透明度、声音和快捷键，并支持从模型库下载或导入 Mver 等模型。它适合想在日常输入、直播或录屏中加入互动角色的人，但首次使用真正需要完成的不是“让猫出现”，而是确认模型能响应输入、窗口不会挡住工作，同时理解全局输入监听的权限与退出边界。

下载前先按平台和处理器选包

截至 2026 年 9 月 21 日，官方最新稳定版为 v1.12.0。开发团队在该版本说明中特别指出，Windows 版本经过了更充分的测试；macOS 和 Linux 虽然提供正式构建，但遇到平台兼容问题时应优先查看当前 Release 与 Issue，不宜把 Windows 上的表现直接套用到其他系统。

平台	可用安装包	选择建议
Windows	x64 / x86 安装版与便携版；另有 Microsoft Store	多数 Windows 10/11 电脑选 x64 安装版；需要随用随走、避免建立安装项时再选便携版。只有 32 位系统才用 x86。
macOS	Apple Silicon arm64 与 Intel x64 ZIP	M1 及更新 Apple 芯片选择 arm64；Intel Mac 选择 x64。首次启动若被系统拦截，应核对下载来源与系统安全提示。
Linux	x64 AppImage 与 tar.gz	希望直接运行可先选 AppImage；需要自行管理目录与依赖时选 tar.gz。Wayland 的输入和窗口能力受合成器影响。

v1.12.0 的 Windows x64 安装包约 5.92 MiB，便携版约 6.28 MiB；macOS Intel 与 Apple Silicon 压缩包约 5.92 MiB 和 5.74 MiB；Linux AppImage 约 10.07 MiB。包体大小只用于辨认资产，不代表功能等级。下载后应核对文件名中的版本、平台和架构，不要从同名第三方项目或不明网盘取得可执行文件。

第一次启动要完成一条可验收的互动链路

首次配置的目标是得到一个不遮挡操作、能正确响应输入并可随时退出的桌宠。开始前先保存正在编辑的内容；BongoCat 会接收全局键鼠状态来驱动动画，测试时无需输入密码或其他敏感信息。

1. 启动默认模型：从官网、Microsoft Store 或官方 GitHub Releases 获取对应安装包。启动后先保留内置模型，确认透明角色窗口能够显示，不急于导入外部资源。
2. 调整窗口行为：打开 Preferences，在 Window 中设置 Always on Top、Keep on Screen、窗口大小和透明度。需要点击角色后方窗口时开启 Pass Through；如果暂时无法再次点中桌宠，应使用托盘菜单或已设快捷键回到设置。
3. 验证输入响应：在普通文本编辑器里按左右区域的常用按键、点击鼠标，再连接手柄测试对应动作。观察角色是否随输入变化即可，不以动画帧数或连击数字判断系统性能。
4. 设置停止方式：确认系统托盘中能找到 BongoCat，并记住退出入口。隐藏窗口并不等于停止输入监听；需要完全停止时应退出程序。
5. 做一次结果检查：切换回常用工作窗口，确认置顶角色没有挡住按钮、点击穿透按预期工作、输入没有被应用吞掉，并重新打开 Preferences 验证设置已保存。

验收标准很具体：角色显示正常，键盘、鼠标或手柄至少有一种输入能触发动作；桌面后方窗口仍可操作；你知道如何打开设置和完全退出。若其中一步失败，先用内置模型复查平台权限与窗口设置，再处理第三方模型，而不是同时更换模型、权限和渲染选项。

导入模型时先分清格式、程序和美术授权

BongoCat 把 Mver 作为规范模型格式，也能发现和转换部分 Tauri 来源、Live2D .model3.json 与图像补丁。比较稳妥的顺序是先到官方模型库查看预览和来源，再在 Model 页面选择 Add Model 导入下载的包或目录。程序会发现候选、验证内容、生成标识，并把规范化模型安装到模型目录；导入失败时应保留原压缩包，检查目录层级和入口文件，而不是随意改名或把多个模型文件混进同一目录。

• 先看预览和作者信息：相似角色可能来自不同创作者，模型库收录不自动等于允许商用、直播变现或再次分发。
• 一次只导入一个模型：成功后切换到新模型，分别测试左右手、鼠标跟随、声音和快捷键，便于定位缺失资源。
• 保留来源记录：保存模型页面、作者和许可证说明。删除软件或迁移电脑前，另外备份自己取得授权的模型包。

BongoCat 程序运行时采用 AGPL-3.0-only；内置 standard、keyboard 和 gamepad 模型资源另以 MIT 许可覆盖。这个区分只说明官方代码和随附资产的边界，第三方模型仍按各自作者声明使用，不能因为程序开源就默认所有角色素材也可自由商用。

全局输入监听要结合系统权限判断

官方说明称，BongoCat 在本地处理键盘与鼠标事件，用来驱动动画和快捷键，不记录或上传按键内容；配置保存在本地，程序不含广告、分析或用户追踪，更新检查只请求公开版本元数据。Windows 版本使用 Raw Input，在普通权限下运行，不安装全局输入钩子、不注入游戏、不读取游戏内存，也不向游戏模拟输入。这个设计降低了干预范围，但并不等于获得所有反作弊系统的认证；有严格安全策略的游戏、考试或企业设备应以本机规则为准。

Linux X11 默认使用 XInput2。Wayland 的实验性 evdev 后端默认关闭，因为原始设备输入可能包含密码框按键，而且隐藏桌宠、锁屏或切换会话不会自动停止监听。官方明确不建议为了启用它以 root 运行，或把个人账号广泛加入 input 组。无法接受这种权限范围时，继续使用默认后端，或者退出 BongoCat。

直播录屏先解决透明窗口和点击穿透

桌面显示正常不代表录屏软件一定能捕获透明窗口。Preferences 中的 Solid Background 用于处理某些窗口捕获出现黑屏的情况；是否需要开启，取决于录屏软件、捕获模式和平台窗口合成。先建立一个十几秒的测试录制，检查角色透明边缘、动作、声音和鼠标点击，再进入正式直播。若启用点击穿透后无法拖动角色，可暂时从托盘关闭该选项或调用设置快捷键，不要反复结束进程来代替配置。

多显示器场景还要检查 Keep on Screen 与缩放比例：把角色移到目标屏幕边缘，切换分辨率或系统缩放后确认它仍在可见区域。高刷新率设置主要影响动画调度，不能据此推断整机游戏帧率；直播时应同时观察录制软件和目标应用的实际负载。

v1.12.0 的维护状态与使用边界

v1.12.0 发布于 2026 年 9 月 21 日，提供 Windows x64/x86、macOS arm64/x64 和 Linux x64 构建。项目以 C/C++、SDL3 与 OpenGL 实现，完整 Live2D 构建还涉及 Cubism SDK；普通用户直接使用 Release 安装包即可，不需要自行配置编译环境。当前版本迭代较快，官网摘要可能晚于 GitHub Release，核对版本时应以具体 Release 页面、资产列表和发布日期为准。

本文根据 BongoCat 官网、官方仓库、README、Security Policy 与 v1.12.0 Release 整理，未在本机安装或运行软件，不把公开演示当成性能实测。若你的目标只是安静的静态桌面装饰，全局输入驱动可能没有必要；如果需要键鼠联动、模型切换和直播叠加，BongoCat 才能体现它与普通壁纸或挂件的差别。