BongoCat 交互桌宠实战:5 分钟从安装到自定义 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 交互桌宠,把按键、鼠标点击与手柄输入实时转成猫咪动画,离线运行、配置本地保存,适合写代码、录屏、直播时想要低干扰反馈的用户。功能全景:按键、鼠标与手柄的输入驱动能力核心机制是一条输入到动画的映射链路:系统捕获输入事件,匹配模型内对应的键位图,叠加到 Live2D 模型上渲染。按使用场景整理如下:功能触发方式适用场景按键动画物理键盘按键,逐键匹配键位图编码、写作、键音直播鼠标跟随与点击光标移动、左右键点击录屏演示、桌面导航手柄反馈已连接手柄的按键与摇杆游戏、模拟器操作随机行为定时调度器,默认间隔 30 秒待机陪伴闲置自动隐藏无输入达到延迟秒数,默认 10 秒窗口常驻桌面动作音效模型自带动作音轨,默认关闭直播音画同步内置 standard、keyboard、gamepad 三个预设模型,分别覆盖基础交互、全键盘键位与手柄按键。模型窗口支持置顶、点击穿透、透明度、圆角与缩放调节,可配置开机自启动。插件中心提供番茄钟、按键音效、输入法状态插件,插件以独立进程运行。三步完成安装并看到第一个效果从仓库 Releases 页下载对应系统的安装包:Windows 为 NSIS 安装器,macOS 为 .dmg。安装后启动 BongoCat,猫咪窗口出现在桌面,状态栏出现托盘图标。敲击键盘或移动鼠标,确认爪子动画与光标跟随;右键猫咪窗口或点击托盘图标打开设置窗口。⚙️ 按场景调整透明度、圆角与自动隐藏参数默认值以 shared/config/fixtures/default.json 为准,常用调节区间如下:透明度:日常使用 100%;需要弱化存在感时取 70%–90%。圆角:默认 0%;取 10%–25% 获得柔和边缘。缩放:80%–150%,按屏幕尺寸选择。帧率上限:默认 60 FPS;纯陪伴场景可降到 30 FPS。闲置隐藏:延迟在 10–60 秒之间取值;悬停隐藏用于录屏时让位光标。模型切换在设置窗口的模型页完成;手柄连接与断开可配置为自动切换到指定模型。 导入自定义 Live2D 模型、扩展插件与性能调优导入自定义 Live2D 模型一个目录一个模型,需包含 .model3.json、.moc3、纹理 PNG 与动作、表情文件;支持嵌套子目录导入。内置 BongoCatMver 旧格式转换,导入时按内容自动识别并在应用内转换,无需外部工具。预设模型的完整目录结构可参考 resources/models/。插件扩展插件中心管理安装、启用与卸载;插件以独立进程运行,崩溃不影响主窗口。官方插件:番茄钟、按键音效、输入法状态。性能调优帧率:maximum_fps 默认 60;低配机器或纯陪伴场景设 30。纹理分辨率:预设纹理宽 1024px,替换更低分辨率纹理可降低显存占用。帧时序基准数据见 docs/benchmark/ 目录;just preview standard 30可运行 30 秒确定性渲染预览。从源码构建git clone https://gitcode.com/gh_mirrors/bong/BongoCat cd BongoCat cargo run -p bongocat-app --releaseRust 单进程架构,20 个 crate 的工作区,平台无关逻辑与 Win32、Metal 适配层分离。just check运行格式化、clippy 与全部测试;just build产出发布安装包。构建环境、入口与打包流程见 docs/product-runtime.md。卡顿、输入不响应与窗口异常的排查现象:按键后猫咪无动画(仅 macOS)。 原因:未授予输入监控权限,全局键盘与鼠标事件被降级。 处理:系统设置 → 隐私与安全性 → 输入监控,勾选 BongoCat(开发版勾选启动终端)。现象:部分按键不显示对应键位图。 原因:当前模型缺少该键的键位图,缺图的按键不触发。 处理:切换到 keyboard 预设模型,或导入覆盖更全的自定义模型。现象:手柄摇杆漂移或误触发。 原因:摇杆死区小于实际漂移量。 处理:输入设置中把摇杆死区从默认 0.15 调到 0.2–0.3。现象:OBS 捕获不到猫咪窗口(仅 Windows)。 原因:透明置顶窗口对部分采集模式不可见。 处理:开启窗口模式并设置窗口背景色,再采集该窗口。现象:模型导入失败或列表中无封面。 原因:目录缺少 .model3.json、.moc3 或纹理不完整。 处理:对照预设模型目录补齐文件后重新导入。BongoCat 用 Rust 单进程串起输入捕获、Live2D 渲染与模型管理,离线可用,配置与模型保存在本地。更多模型可从模型目录导入,问题反馈与贡献流程见下方文档。中文 README构建与运行说明 docs/product-runtime.md配置契约 shared/config/contract.mdCONTRIBUTING.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），仅供参考