BongoCat 桌宠完整指南5 步养好一只会敲键盘的 Live2D 小猫【免费下载链接】BongoCat BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址: https://gitcode.com/gh_mirrors/bong/BongoCatBongoCat 是一款纯 Rust 编写的跨平台交互桌宠一只 Live2D 小猫住在你的屏幕角落目光和爪子跟着鼠标走你敲下的每个键、手柄上按下的每枚按钮它都会做出对应的动作。装上它写代码、打游戏、做 PPT 的过程会多一份即时反馈而且全程离线运行、不收集任何数据。在 Windows 和 macOS 上安装 BongoCat 的完整步骤这一节解决怎么把这只猫跑起来。仓库是一个 Cargo workspace见根目录 Cargo.toml当前产品版本面向 macOS 与 Windows 两个平台Linux 属于计划中的后续目标暂不覆盖。普通用户从项目的 release 渠道下载对应系统的安装包双击完成安装无需任何运行环境。源码构建先安装 Rust 工具链和任务管理工具just然后git clone https://gitcode.com/gh_mirrors/bong/BongoCat just build仓库里的 justfile 把常用动作都做成了 recipejust dev启动开发版just preview standard 30可以单独跑一个确定性的 Live2D 预览窗口just test与just check则是完整的测试与质量门禁。它对你意味着什么改任何代码之前先跑一遍门禁就能确认没把渲染或配置逻辑改坏。BongoCat 桌宠的三大输入模式与核心功能一览这一节用一张表说清楚它能干什么、谁会用得上。功能实际效果适合谁用键盘 / 鼠标输入按键触发对应键位图与爪部动作眼球跟随指针编程、写作、日常办公手柄输入摇杆、扳机与按钮逐一映射到模型按键游戏、模拟器场景三档内置模型standard / keyboard / gamepad 三种交互模式一键切换不同场景各取所需离线运行无网络请求、零数据上报配置全部存本地对隐私敏感的用户键盘模型的键位图层覆盖完整键位词表手柄模型的按键图层左右各 6 枚完整功能清单见 README.md。桌宠外观、模型切换与 8 个关键配置项建议值这一节解决怎么把它调成自己喜欢的样子。所有外观与模型设置最终落在本地config.json字段全集和取值范围见 shared/config/config.schema.json语义解释见 shared/config/contract.md。overlay.opacity_percent窗口不透明度默认 100猫窗口本身是透明的日常建议保持 100想更低调时降到 70~90。overlay.maximum_fps目标帧率范围 15~240默认 60核显或集显本可降到 30~45省下的功耗立刻能感觉到。overlay.corner_radius_percent窗口圆角范围 0~50取 10~25 时边缘最柔和0 为直角。overlay.scale_percent模型缩放默认 100小屏笔记本建议 80 左右避免挡住任务栏。model.play_motion_audio动作音效开关默认关闭需要敲键盘有声音的氛围感时再打开。model.random_behavior.modeinterval_seconds无人操作时随机播放表情或动作默认 off想让它自己活起来就设成expressions、间隔 30 秒。input.gamepad.stick_dead_zone摇杆死区默认 0.15手柄摇杆漂移误触时可调到 0.2~0.3。appearance.language界面语言支持简体中文在内的 8 种语言默认system跟随系统。模型切换在设置窗口的模型页完成三个内置模型standard、keyboard、gamepad各是一张卡片可重命名。喜欢手柄玩法的话还可以打开model.gamepad_auto_switch插上手柄自动切到手柄模型、拔下再切回来不用手动点。导入自定义 Live2D 模型与开发者扩展的入口这一节回答怎么换一只自己的猫以及想改代码从哪里下手。导入模型在设置窗口里选一个完整模型文件夹即可里面需要.model3.json、.moc3、.cdi3.json与 PNG 纹理内置包的结构可以参考 resources/models/ 下 standard 目录的排布。导入时必须选定交互模式standard鼠标 键盘、keyboard仅键盘或gamepad仅手柄模式判定依据是模型里左/右手键位图left-keys/right-keys的排布判定失败会直接拒绝导入不会给你留下一只半残的猫。动作层行为导入后可以按需开启allow_motion_overlap多段动作叠加播放、remember_last_expression切回模型时恢复上次的表情语义细节都在 shared/config/contract.md 里写明了。如果你打算写代码仓库按 Cargo crate 切分职责边界清晰crates/bongocat-input/键盘、鼠标与手柄的原始采集和状态对齐是所有动作的源头。crates/bongocat-live2d-playback/动作与表情的播放调度想让新行为按你的规则触发改这里。crates/bongocat-config/配置的读写、原子提交、备份与损坏恢复任何新增设置项都从这里的 Rust 类型出发。插件体系官方插件放在独立仓库通过环境变量BONGOCAT_PLUGINS_ROOT指向本地 checkout再跑just dev即可随应用一起构建加载插件以独立进程运行单个插件崩溃不会带崩主应用。贡献规范见 CONTRIBUTING.zh-CN.md提交前跑一遍just check是硬性要求。调低帧率、修好卡键与 4 个高频问题避坑这一节收集最容易踩的坑先给三条实用技巧高刷屏 显卡较弱把maximum_fps从默认 60 降到 30~45帧间隔按截止时间计算帧率降了但动作节拍不乱。全屏游戏里猫不跟手多数游戏会捕获并钉住光标此时绝对坐标不动。打开input.mouse.force_move改为按设备报告的相对位移累加猫就能继续跟随代价是程序化移动指针比如自动定位不再被感知所以默认是关的。想让猫隐身开启hide_on_idle并设 10 秒延迟手一停它就淡出并临时穿透再开hold_modifier_to_interact配一个修饰键需要拖窗口时按住该键即可把它抓回来。常见问题Q猫卡着某个键不放怎么办A不会发生。释放只由真实的 KeyUp、平台状态校正或生命周期 Reset 触发项目刻意不用超时自动松手来区分慢帧和卡键。Q导入自定义模型失败A先核对文件是否齐全.model3.json、.moc3、.cdi3.json、纹理再确认交互模式与键位图排布匹配——判定失败会直接拒绝而不是导入后无法使用。Q运行会上传数据吗A不会。核心功能完全离线配置与窗口状态都写在本机更新检查默认也是关闭的。QLinux 上能用吗A当前正式发行只覆盖 macOS 与 WindowsLinux 支持见仓库的 ADR 文档暂不可用。关键资源与上手清单继续深入时按这份路径走配置字段全集shared/config/config.schema.json每个字段的语义与边界shared/config/contract.md内置模型源码结构resources/models/开发者任务脚本justfile贡献指南CONTRIBUTING.zh-CN.md上手清单下载安装包或just build让猫先在屏幕角落出现。把窗口拖到顺眼的位置设置scale_percent与corner_radius_percent。按使用场景挑一个内置模型游戏玩家顺手打开gamepad_auto_switch。导入自己的 Live2D 模型选对交互模式。想动手改代码读justfile跑just check从crates/bongocat-input开始顺藤摸瓜。【免费下载链接】BongoCat BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址: https://gitcode.com/gh_mirrors/bong/BongoCat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
BongoCat 桌宠完整指南5 步养好一只会敲键盘的 Live2D 小猫【免费下载链接】BongoCat BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址: https://gitcode.com/gh_mirrors/bong/BongoCatBongoCat 是一款纯 Rust 编写的跨平台交互桌宠一只 Live2D 小猫住在你的屏幕角落目光和爪子跟着鼠标走你敲下的每个键、手柄上按下的每枚按钮它都会做出对应的动作。装上它写代码、打游戏、做 PPT 的过程会多一份即时反馈而且全程离线运行、不收集任何数据。在 Windows 和 macOS 上安装 BongoCat 的完整步骤这一节解决怎么把这只猫跑起来。仓库是一个 Cargo workspace见根目录 Cargo.toml当前产品版本面向 macOS 与 Windows 两个平台Linux 属于计划中的后续目标暂不覆盖。普通用户从项目的 release 渠道下载对应系统的安装包双击完成安装无需任何运行环境。源码构建先安装 Rust 工具链和任务管理工具just然后git clone https://gitcode.com/gh_mirrors/bong/BongoCat just build仓库里的 justfile 把常用动作都做成了 recipejust dev启动开发版just preview standard 30可以单独跑一个确定性的 Live2D 预览窗口just test与just check则是完整的测试与质量门禁。它对你意味着什么改任何代码之前先跑一遍门禁就能确认没把渲染或配置逻辑改坏。BongoCat 桌宠的三大输入模式与核心功能一览这一节用一张表说清楚它能干什么、谁会用得上。功能实际效果适合谁用键盘 / 鼠标输入按键触发对应键位图与爪部动作眼球跟随指针编程、写作、日常办公手柄输入摇杆、扳机与按钮逐一映射到模型按键游戏、模拟器场景三档内置模型standard / keyboard / gamepad 三种交互模式一键切换不同场景各取所需离线运行无网络请求、零数据上报配置全部存本地对隐私敏感的用户键盘模型的键位图层覆盖完整键位词表手柄模型的按键图层左右各 6 枚完整功能清单见 README.md。桌宠外观、模型切换与 8 个关键配置项建议值这一节解决怎么把它调成自己喜欢的样子。所有外观与模型设置最终落在本地config.json字段全集和取值范围见 shared/config/config.schema.json语义解释见 shared/config/contract.md。overlay.opacity_percent窗口不透明度默认 100猫窗口本身是透明的日常建议保持 100想更低调时降到 70~90。overlay.maximum_fps目标帧率范围 15~240默认 60核显或集显本可降到 30~45省下的功耗立刻能感觉到。overlay.corner_radius_percent窗口圆角范围 0~50取 10~25 时边缘最柔和0 为直角。overlay.scale_percent模型缩放默认 100小屏笔记本建议 80 左右避免挡住任务栏。model.play_motion_audio动作音效开关默认关闭需要敲键盘有声音的氛围感时再打开。model.random_behavior.modeinterval_seconds无人操作时随机播放表情或动作默认 off想让它自己活起来就设成expressions、间隔 30 秒。input.gamepad.stick_dead_zone摇杆死区默认 0.15手柄摇杆漂移误触时可调到 0.2~0.3。appearance.language界面语言支持简体中文在内的 8 种语言默认system跟随系统。模型切换在设置窗口的模型页完成三个内置模型standard、keyboard、gamepad各是一张卡片可重命名。喜欢手柄玩法的话还可以打开model.gamepad_auto_switch插上手柄自动切到手柄模型、拔下再切回来不用手动点。导入自定义 Live2D 模型与开发者扩展的入口这一节回答怎么换一只自己的猫以及想改代码从哪里下手。导入模型在设置窗口里选一个完整模型文件夹即可里面需要.model3.json、.moc3、.cdi3.json与 PNG 纹理内置包的结构可以参考 resources/models/ 下 standard 目录的排布。导入时必须选定交互模式standard鼠标 键盘、keyboard仅键盘或gamepad仅手柄模式判定依据是模型里左/右手键位图left-keys/right-keys的排布判定失败会直接拒绝导入不会给你留下一只半残的猫。动作层行为导入后可以按需开启allow_motion_overlap多段动作叠加播放、remember_last_expression切回模型时恢复上次的表情语义细节都在 shared/config/contract.md 里写明了。如果你打算写代码仓库按 Cargo crate 切分职责边界清晰crates/bongocat-input/键盘、鼠标与手柄的原始采集和状态对齐是所有动作的源头。crates/bongocat-live2d-playback/动作与表情的播放调度想让新行为按你的规则触发改这里。crates/bongocat-config/配置的读写、原子提交、备份与损坏恢复任何新增设置项都从这里的 Rust 类型出发。插件体系官方插件放在独立仓库通过环境变量BONGOCAT_PLUGINS_ROOT指向本地 checkout再跑just dev即可随应用一起构建加载插件以独立进程运行单个插件崩溃不会带崩主应用。贡献规范见 CONTRIBUTING.zh-CN.md提交前跑一遍just check是硬性要求。调低帧率、修好卡键与 4 个高频问题避坑这一节收集最容易踩的坑先给三条实用技巧高刷屏 显卡较弱把maximum_fps从默认 60 降到 30~45帧间隔按截止时间计算帧率降了但动作节拍不乱。全屏游戏里猫不跟手多数游戏会捕获并钉住光标此时绝对坐标不动。打开input.mouse.force_move改为按设备报告的相对位移累加猫就能继续跟随代价是程序化移动指针比如自动定位不再被感知所以默认是关的。想让猫隐身开启hide_on_idle并设 10 秒延迟手一停它就淡出并临时穿透再开hold_modifier_to_interact配一个修饰键需要拖窗口时按住该键即可把它抓回来。常见问题Q猫卡着某个键不放怎么办A不会发生。释放只由真实的 KeyUp、平台状态校正或生命周期 Reset 触发项目刻意不用超时自动松手来区分慢帧和卡键。Q导入自定义模型失败A先核对文件是否齐全.model3.json、.moc3、.cdi3.json、纹理再确认交互模式与键位图排布匹配——判定失败会直接拒绝而不是导入后无法使用。Q运行会上传数据吗A不会。核心功能完全离线配置与窗口状态都写在本机更新检查默认也是关闭的。QLinux 上能用吗A当前正式发行只覆盖 macOS 与 WindowsLinux 支持见仓库的 ADR 文档暂不可用。关键资源与上手清单继续深入时按这份路径走配置字段全集shared/config/config.schema.json每个字段的语义与边界shared/config/contract.md内置模型源码结构resources/models/开发者任务脚本justfile贡献指南CONTRIBUTING.zh-CN.md上手清单下载安装包或just build让猫先在屏幕角落出现。把窗口拖到顺眼的位置设置scale_percent与corner_radius_percent。按使用场景挑一个内置模型游戏玩家顺手打开gamepad_auto_switch。导入自己的 Live2D 模型选对交互模式。想动手改代码读justfile跑just check从crates/bongocat-input开始顺藤摸瓜。【免费下载链接】BongoCat BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址: https://gitcode.com/gh_mirrors/bong/BongoCat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
