企业官网建设流程全解析

BongoCat 交互桌宠实战:5 分钟从安装到自定义 Live2D 模型

【免费下载链接】BongoCat🐱 BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址: https://gitcode.com/gh_mirrors/bong/BongoCat

BongoCat 是运行在 Windows 与 macOS 的 Live2D 交互桌宠,把按键、鼠标点击与手柄输入实时转成猫咪动画,离线运行、配置本地保存,适合写代码、录屏、直播时想要低干扰反馈的用户。

功能全景:按键、鼠标与手柄的输入驱动能力

核心机制是一条输入到动画的映射链路:系统捕获输入事件,匹配模型内对应的键位图,叠加到 Live2D 模型上渲染。按使用场景整理如下:

• 内置 standard、keyboard、gamepad 三个预设模型,分别覆盖基础交互、全键盘键位与手柄按键。
• 模型窗口支持置顶、点击穿透、透明度、圆角与缩放调节,可配置开机自启动。
• 插件中心提供番茄钟、按键音效、输入法状态插件,插件以独立进程运行。

三步完成安装并看到第一个效果

1. 从仓库 Releases 页下载对应系统的安装包:Windows 为 NSIS 安装器,macOS 为 .dmg。
2. 安装后启动 BongoCat,猫咪窗口出现在桌面,状态栏出现托盘图标。
3. 敲击键盘或移动鼠标,确认爪子动画与光标跟随;右键猫咪窗口或点击托盘图标打开设置窗口。

⚙️ 按场景调整透明度、圆角与自动隐藏参数

默认值以 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 --release

• Rust 单进程架构,20 个 crate 的工作区,平台无关逻辑与 Win32、Metal 适配层分离。
• just check运行格式化、clippy 与全部测试;just build产出发布安装包。
• 构建环境、入口与打包流程见 docs/product-runtime.md。

卡顿、输入不响应与窗口异常的排查

1. 现象:按键后猫咪无动画(仅 macOS)。 原因:未授予输入监控权限,全局键盘与鼠标事件被降级。 处理:系统设置 → 隐私与安全性 → 输入监控,勾选 BongoCat(开发版勾选启动终端)。
2. 现象:部分按键不显示对应键位图。 原因:当前模型缺少该键的键位图,缺图的按键不触发。 处理:切换到 keyboard 预设模型,或导入覆盖更全的自定义模型。
3. 现象:手柄摇杆漂移或误触发。 原因:摇杆死区小于实际漂移量。 处理:输入设置中把摇杆死区从默认 0.15 调到 0.2–0.3。
4. 现象:OBS 捕获不到猫咪窗口(仅 Windows)。 原因:透明置顶窗口对部分采集模式不可见。 处理:开启窗口模式并设置窗口背景色,再采集该窗口。
5. 现象:模型导入失败或列表中无封面。 原因:目录缺少 .model3.json、.moc3 或纹理不完整。 处理:对照预设模型目录补齐文件后重新导入。

BongoCat 用 Rust 单进程串起输入捕获、Live2D 渲染与模型管理,离线可用,配置与模型保存在本地。更多模型可从模型目录导入,问题反馈与贡献流程见下方文档。

• 中文 README
• 构建与运行说明 docs/product-runtime.md
• 配置契约 shared/config/contract.md
• 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