BongoCat终极指南：如何快速配置你的键盘猫咪助手

BongoCat是一款跨平台的虚拟桌面宠物应用，让可爱的邦戈猫实时响应你的键盘敲击和鼠标操作。这款开源工具通过Tauri框架构建，支持macOS、Windows和Linux三大操作系统，为你的工作学习增添无限趣味！🎮

✨ BongoCat核心功能特色

BongoCat不仅仅是一个简单的桌面宠物，它拥有以下强大功能：

• 实时动作同步 - 猫咪会跟随你的键盘、鼠标和手柄操作做出相应动作
• 多平台兼容 - 完美支持macOS、Windows和Linux(x11)系统
• 自定义模型支持 - 可导入个人专属的猫咪模型
• 完全离线运行 - 保护隐私，无需网络连接
• 开源透明 - 代码完全公开，不收集任何用户数据

BongoCat键盘模式展示 - 猫咪实时响应键盘输入

🚀 快速安装配置步骤

下载安装包

前往项目仓库下载对应系统的安装包，支持以下平台：

• macOS (.dmg文件)
• Windows (.exe文件)
• Linux (.AppImage文件)

基础配置指南

1. 首次启动应用 - 双击安装包完成安装并启动BongoCat
2. 选择操作模式 - 在设置中切换键盘、鼠标或手柄模式
3. 个性化设置 - 调整猫咪大小、位置和透明度

BongoCat游戏手柄模式 - 支持各类游戏控制器

🎨 自定义模型使用方法

BongoCat支持导入自定义Live2D模型，让你的桌面猫咪独一无二：

模型文件结构

• 模型配置文件：cat.model3.json
• 纹理图片：位于各模型的.1024目录下
• 动作文件：.motion3.json
• 表情文件：.exp3.json

导入自定义模型

1. 准备符合Live2D格式的模型文件
2. 通过应用内的模型管理界面上传
3. 保存配置并重启应用

BongoCat标准模式 - 经典的猫咪形象

⚙️ 高级配置技巧

快捷键设置

通过useTauriShortcut.ts组件可自定义全局快捷键，方便快速呼出或隐藏猫咪。

主题适配

应用支持深色和浅色主题切换，自动跟随系统主题设置。

🔧 故障排除与优化

常见问题解决

• 猫咪不显示：检查应用权限设置，特别是macOS的屏幕录制权限
• 动作不同步：确认输入设备连接正常
• 性能优化：调整模型复杂度或降低帧率

📁 项目架构概览

BongoCat采用现代化的技术架构：

• 前端框架：Vue 3 + TypeScript
• 后端框架：Rust + Tauri
• UI组件：Naive UI
• 构建工具：Vite

核心功能模块包括：

• 设备输入处理：device.rs
• 游戏手柄支持：gamepad.rs
• 模型渲染：useModel.ts

💡 使用场景推荐

BongoCat适合以下场景使用：

• 编程开发 - 陪伴你的代码编写过程
• 游戏娱乐 - 增强游戏互动的趣味性
• 学习办公 - 缓解长时间工作的疲劳感
• 直播录制 - 作为有趣的桌面装饰元素

无论是工作还是娱乐，BongoCat都能为你的数字生活增添一抹可爱的色彩！🐱