BongoCat 桌宠完整指南3 步上手会敲键盘的 Live2D 猫咪【免费下载链接】BongoCat BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址: https://gitcode.com/gh_mirrors/bong/BongoCatBongoCat 是一款跨平台Windows 与 macOS的 Live2D 桌宠应用核心代码为 Rust设置界面基于 GPUI 构建模型渲染走 Live2D Cubism Core。它适合经常敲代码、写文档、玩手柄的玩家你按下的每个按键、点下的每个鼠标键、按下的每个手柄键屏幕上这只猫都会实时做出对应动作。想给桌面加一个不打扰、不联网、可换形象的互动伙伴从这篇指南开始就够了。功能一览输入方式猫咪响应适用场景键盘按键对应按键的敲击动画编程、写作、办公鼠标移动与按键眼神跟随指针按键触发对应爪子动作日常操作、设计工作游戏手柄按键与摇杆按键映射的爪击动画游戏、模拟器平台范围首发支持 Windows 10 1903 与 macOS 12Linux 在 ADR-0006 中明确为首发后的独立评估项。隐私与资源完全开源、离线运行、不收集任何用户数据配置 schema 中overlay段的maximum_fps默认 60可按机器情况下调。三步上猫从零到可用的最短路径第一步获取git clone https://gitcode.com/gh_mirrors/bong/BongoCat普通用户也可以直接下载 Release 页面对应平台的安装包无需自行构建。第二步基础配置启动后从系统托盘状态图标打开设置窗口推荐起步值不透明度opacity_percent调到 30~50合法范围 1~100既看得见猫也不挡屏幕内容圆角corner_radius_percent设 10~25合法范围 0~50窗口边缘更柔和开机自启动开启后每次登录自动驻留macOS 上首次开启会走系统权限流程缩放scale_percent合法范围 25~400默认 100按屏幕大小调整即可。第三步启动验证连续敲几个键、再移动鼠标和点击鼠标键。如果猫的眼睛跟随指针、爪子按按键落下说明输入链路捕获 → 状态协调 → 动画已经跑通配置完成。模型怎么选三种内置模型的适用场景内置模型位于 resources/models/在设置窗口的模型库中切换。你是混合输入用户 → 标准版standard55 个左手键动画键盘、鼠标、手柄混合输入时不违和作为默认选择没问题。你是键盘重度用户 → 键盘版keyboard55 个左手键外加 4 个右手键每个物理按键都有独立的贴图层长时间写代码、打字时敲击反馈最完整。你是手柄玩家 → 手柄版gamepad左右各 6 个按键位对应 ABXY、方向键、肩键与扳机玩模拟器或接手柄时按键对得上。进阶自定义与扩展如何导入自定义 Live2D 模型一个可导入的模型文件夹至少包含.model3.json模型配置文件.moc3模型数据文件.cdi3.json显示信息文件PNG 纹理图片可选的.motion3.json动作与.exp3.json表情文件在设置窗口的模型导入入口选择该文件夹即可。应用会先做包校验防止路径穿越、符号链接逃逸见 crates/bongocat-model/src/package.rs通过后才复制进本地模型库导入的模型可以单独重命名或删除。开发者扩展入口crates/bongocat-ui/设置窗口与全部 GPUI 控件新增界面入口从这里加crates/bongocat-input/键盘、鼠标、手柄的输入事件捕获接入新输入源改这里crates/bongocat-runtime/输入状态与动作、参数、动画的协调逻辑改「按什么出什么动画」在这里crates/bongocat-plugin-service/插件以独立 Rust 进程运行新能力可以做成插件而不是改主程序性能调优设置窗口的 Overlay 分组直接编辑以下字段典型调法{ overlay: { maximum_fps: 30, opacity_percent: 40, scale_percent: 100 } }maximum_fps合法范围 15~240默认 60机器负载高时降到 30 最稳妥。快速答疑QLinux 能用吗A不能。首发平台只有 Windows 与 macOSLinux 按独立 spike 在首发后评估不在当前支持矩阵内。Q导入的模型提示校验失败A多半是引用文件缺失或.model3.json指向了包外路径补齐纹理与 moc3 文件后重试。Q猫咪窗口卡顿怎么办A先把maximum_fps降到 30再适当调低不透明度两者都在设置窗口即时生效。Q支持多显示器吗A支持。窗口可以拖到任意屏幕keep_inside_screen默认开启防止猫咪被拖出屏幕边界。资源清单shared/config/config.schema.json配置字段的完整契约每个字段的类型、范围、默认值以它为准crates/bongocat-platform/窗口、输入、托盘、开机自启动等系统集成实现定位平台相关问题时从这里入手docs/technical-design.md整体架构与平台分工理解各 crate 边界之前先读它CONTRIBUTING.zh-CN.md贡献指南提交代码前从这里走流程参与贡献的入口就一个按贡献指南提交议题或拉取请求即可。【免费下载链接】BongoCat BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址: https://gitcode.com/gh_mirrors/bong/BongoCat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
