BongoCat 互动桌宠快速上手指南：键盘、鼠标、手柄全响应

BongoCat 互动桌宠快速上手指南：键盘、鼠标、手柄全响应

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

BongoCat 是一款跨平台互动桌宠，用 Live2D 技术（一套让 2D 贴图实时做骨骼动画的渲染方案）在桌面里画出一只随你键盘、鼠标或游戏手柄同步动作的猫。写代码、做文档、打游戏时都想让屏幕角落多一点反馈的人，值得给它留个位置。全程离线运行，不收集任何数据。

🐾 速览

三分钟跑起来

普通用户不必看源码：从发布渠道（夸克网盘或 GitHub Releases，仓库 README 有说明）下载对应系统的安装包，双击安装即可。开发者想从源码构建，按下面步骤走：

1. 克隆仓库：

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

2. 进入项目目录，安装依赖并启动（需要 Node.js 与 Rust 工具链）：

pnpm install && pnpm tauri dev

完成后你应该看到桌面上出现一个透明的无窗口边框猫咪，敲任意键，爪子会落在对应按键位置；通过托盘图标或设置快捷键可打开设置页。

BongoCat 标准模型，响应基础键鼠操作

功能拆解

键盘模型：按到哪、爪到哪

键盘模型的爪子与实体按键一一对应，按下哪键哪里的爪子落下。场景：深夜赶 deadline 时，猫的爪子跟着你的敲键节奏起舞，比听单调的键盘声有意思。

键盘模型，按键响应经过单独优化

鼠标跟随与一键关闭

可开启镜像模式，让猫朝向跟随鼠标方向。若跟随干扰视线，打开「忽略鼠标」开关即可，猫保持静止只等键盘输入。

手柄模型：按键复刻主机布局

手柄模型的爪子对应十字键、四个主按键与扳机。场景：接上手柄玩模拟器或主机模拟器时，猫的爪子同步「按」出你手上的每一次操作。

游戏手柄模型，支持手柄按键映射

导入自己的模型不用重启

在设置页把完整模型文件夹拖进去或选中它即可。系统读取resources/right-keys目录内容自动判断类型：含East键图为游戏柄，含字母键图为键盘，否则归为标准模型，新模型随即出现在列表中可直接切换。

进阶玩法

普通用户

• 配置全局快捷键：显示/隐藏猫咪、打开设置、切换镜像与点击穿透，见 快捷键设置页
• 调节透明度（最低 10%）、缩放（1%~500%）、圆角、置顶、悬停自动隐藏，见 猫咪设置页
• 管理开机自启、托盘图标、主题与界面语言（中/英/繁中/葡/越），见 通用设置页

开发者

• 输入事件捕获与按键映射：device.rs、gamepad.rs
• 前端交互编排：useModel.ts、useDevice.ts
• Live2D 渲染与帧率控制：live2d.ts
• 窗口行为（透明、置顶、穿透）声明：tauri.conf.json

常见问题

猫咪卡顿或 GPU 占用高？在猫咪设置页调低 maxFPS（默认 60），低配机器可降到 30 左右；同时关掉「behavior」开关减少随机动画。

怎么添加新模型？不需要手动放目录。设置页模型栏选中或拖入完整 Live2D 文件夹（需含.model3.json、.moc3与贴图），应用会将其复制到应用数据目录并立即可选。内置模型结构可参考 standard 模型目录。

能离线用吗？会收集数据吗？完全离线运行，代码公开可审查，不收集任何用户数据。

Linux 兼容性如何？官方支持 Linux x11 桌面环境；非 x11 环境下的兼容不作保证。

macOS 上按键没反应？首次运行时若系统弹出授权提示，请允许「输入监控」权限，设置页内也有专门的权限指引，见 macOS 权限指引。

写在最后

桌宠占的资源很少，换来的是工作间隙多一个小反馈源。

下一步建议：

1. 安装启动，敲几个键确认同步
2. 设置显示/隐藏全局快捷键
3. 切到键盘模型体验按键同步
4. 导入一个自己下载的 Live2D 模型
5. 翻一翻源码，找到你想动的模块

📎 资源导航：

• tauri.conf.json：看窗口透明、置顶、不进任务栏等属性声明
• src/stores/cat.ts：所有猫咪设置的默认值（帧率、透明度、穿透）
• src/stores/model.ts：模型列表与预设模型加载逻辑
• src/pages/preference/：各设置页的界面源码

如果你做了新模型或有改进想法，欢迎到项目社区交流，代码贡献同样随时需要。

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