企业官网建设流程全解析

给桌面养一只会敲键盘的猫：BongoCat 桌面宠物上手指南

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

深夜赶工写代码，屏幕右下角蹲着一只猫：你敲回车，它拍爪子，你滚鼠标滚轮，它的爪子跟着打滑。这只 BongoCat 是免费开源的跨平台桌面宠物，键盘、鼠标、手柄都能接住，Windows 和 macOS 都能装。

它到底是什么：BongoCat 桌面猫咪定位

BongoCat 是一只输入互动的 Live2D 桌面宠物。Live2D 是让立绘能动的 2D 动画技术，这里用来驱动一只趴在键盘前的小猫。它住在屏幕角落的透明窗口里，眼神和爪子跟随鼠标，你按下的每个键、每个鼠标键、每个手柄键都会触发对应的动画和音效。

它解决的是个小问题：把你对着屏幕敲了一天的输入，变成看得见的反馈，适合写代码、直播、教学演示时挂着。当前官方支持 Windows 10 1903 及以上、macOS 12 及以上，完全离线运行，不收集任何用户数据。

五分钟上手：BongoCat 安装与首次配置

不管哪个系统，路径都一样：下载安装包 → 安装 → 点系统托盘图标打开设置。差别只在权限这一步。

Windows 安装步骤

• 从官方发布页下载每用户安装包，双击按向导装完即可，不需要管理员权限。
• 安装后 BongoCat 常驻系统托盘，右键图标就能打开设置面板。
• 全局键鼠捕获走系统 Raw Input 通道，首次运行没有额外的权限弹窗。

macOS 权限怎么开

• 把 DMG 里的应用拖进 Applications 文件夹。
• 首次启动时应用会引导你打开「系统设置 → 隐私与安全性 → 输入监控」，给 BongoCat 打勾；这个引导流程的实现可以看 crates/bongocat-platform/。
• 授权后如果输入没反应，重启一次应用即可。

Linux 支持现状

Linux 不在首发支持矩阵里，项目保留的是平台无关的共享模块，X11 与 Wayland 的适配在首发后单独评估，结论都记录在 docs/adr/ 的架构决策文档中。现阶段建议直接使用 Windows 或 macOS 的构建产物。

装完不需要任何配置：窗口默认是透明的桌宠形态，拖到屏幕任意角落，所有偏好都会自动保存，下次启动原样恢复。

三种性格的猫：标准、键盘、手柄模型怎么选 🐱

应用内置三套预设模型，在设置面板一键切换，各自适合的人群不太一样。

标准模型是万金油。眼睛和爪子跟鼠标走，点触控板、按鼠标键爪子都会动，日常浏览、办公、轻度游戏都够用。

键盘模型给程序员和文字工作者。它带完整键位词表，你按哪个键，对应按键图就出现在爪子上方，修饰键、F 区、功能键都覆盖，看别人直播敲代码时沉浸感最强。

手柄模型给玩家。接上游戏手柄，十字键和 ABXY 的按键图会随你的操作点亮，手柄一连上还能自动切到这个模型，打游戏、跑模拟器时最合拍。

玩出花来的进阶操作：模型导入、快捷键与个性化

导入自定义 Live2D 模型

有自己的 moc3 模型包时，在设置面板直接导入，应用会校验文件结构、生成封面，然后进模型库。导入与校验的入口在 crates/bongocat-app/src/application/model_import.rs。

自定义快捷键

显示/隐藏窗口、切换模型、暂停交互，都能绑全局热键。快捷键在配置层编译后持久化，规则实现见 crates/bongocat-config/src/shortcuts/。

个性化交互与外观

单键模式只显示最后一个按键的动画，减少渲染负担；按住修饰键可以临时接管交互；空闲自动隐藏、悬停隐藏、置顶、圆角、透明度和大小都能调，随机行为频率和物理摆动也单独可配。

为什么它这么轻巧：Rust 技术栈与代码组织

当前仓库是一个单一 Rust 工作区（早期版本基于 Tauri + Vue 3 + TypeScript 的 Web 技术栈）。设置窗口由 GPUI 框架绘制，模型窗口是 Rust 平台模块直接创建的透明 overlay：Windows 走 D3D11，macOS 走 Metal。

Live2D 的计算调用官方 Cubism Core，这是整个应用唯一的 FFI 例外；键鼠捕获由平台适配器完成，手柄统一走 gilrs。业务逻辑全部写在 Rust 里，没有 web 容器、没有多余常驻进程，内存和安装包体积自然压得住。想读模型运行时代码，从 crates/bongocat-live2d/ 进。

翻车了怎么办：故障排除与性能调优 🛠️

• 猫咪对输入没反应：macOS 先回「输入监控」看权限是否被关掉；Windows 检查是不是别的程序占用了同一组全局热键。
• 窗口位置、大小不对：右键托盘图标进设置，窗口几何是持久化的，随时可以改回来。
• 游戏时觉得占资源：调低随机行为频率、关掉动画重叠，或者干脆用快捷键把窗口藏起来。
• 实在定位不了：应用自带受限日志和诊断导出，把诊断包带上再求助社区，效率最高。

社区与资源：第三方模型和插件在哪找

更多猫咪模型、主题和插件，可以去 Awesome-BongoCat 仓库浏览和分享；插件以独立进程运行，往模型窗口上加 HUD 一类的扩展。代码采用 Apache-2.0 许可，想贡献的话先读 CONTRIBUTING.md，源码拉取方式：

git clone https://gitcode.com/gh_mirrors/bong/BongoCat

项目还有官方 QQ 群，入口写在 README 里。去发布页下载对应系统的安装包，给桌角这只猫腾个位置吧。

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