BongoCat 2.0 迁移指南原生 Rust 架构重写、手柄死区与模型自动切换【免费下载链接】BongoCat BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址: https://gitcode.com/gh_mirrors/bong/BongoCatBongoCat 2.0 用原生 Rust 架构替换了此前的实现。本文基于 CHANGELOG.md 中 2.0.0 与 2.0.1 的记录及仓库内 crate 源码讲清升级前的确认项、输入忽略与手柄死区、模型自动切换、封面捕获、表情记忆、日志管理的新能力边界以及 Mver 导入转换的完整语义让读过 README 的进阶用户不深入源码也能完成升级判断与配置。① 升级决策动手前必须确认的三件事1. 先卸载再安装不支持覆盖升级CHANGELOG.md 的 Upgrade Notice 写得明确BongoCat 2.0.0 采用新的原生 Rust 架构内部实现与旧版完全不同因此必须先卸载之前的版本再手动下载并安装新版本不支持在旧版之上覆盖安装。⚠️ 彻底卸载旧版本包括残留的安装与数据目录之后再装新版。旧版安装的 Mver 模型不需要手动转换装好新版后用 BongoCat Mver 导入 功能一键导入语义见 ④。2. 平台支持矩阵与许可证变更平台2.0 支持情况Windows 10 1903x64官方支持Windows ARM64通过模拟运行 x64 构建无专属构建Windows x86不提供macOS 12Intel / Apple Silicon官方支持Linux不提供策略见 0006-linux-post-launch-strategy.md工作区清单 Cargo.toml 中license Apache-2.0是许可证变更的落地证据项目从 MIT 改为 Apache License 2.0。若你要在其它项目复用这份代码这一点影响复用条款。3. 被移除的能力与过渡方案Key release timeout 设置被移除2.0 的按键状态模型在设备切换、锁屏、睡眠、权限变化后不再卡键修复见 ⑤这个兜底设置失去存在前提无需任何迁移动作。繁体中文、葡萄牙语、越南语在 2.0.0 被移除2.0.1 已把这三种语言重新带回并新增阿拉伯语需要它们就直接安装 2.0.1 或更高版本。② 架构骨架换代后内部世界长什么样2.0.0 发布时 workspace 由 21 个成员 crate 组成后续版本又加入 3 个插件 crate当前 Cargo.toml 列出 24 个。主要职责如下Crate一句话职责bongocat-app产品入口串联配置、运行时与设置服务bongocat-config配置 schema、校验与原子持久化bongocat-model/bongocat-model-store模型包校验、模型存储与 Mver 转换bongocat-runtime输入状态、模型播放与随机行为调度bongocat-overlay模型窗口Windows / macOS 各一套原生渲染bongocat-live2dCubism Core 的 FFI 边界bongocat-platform全局快捷键、启动项、系统菜单等平台服务bongocat-log人类可读日志的等级过滤、轮转与保留清理bongocat-input/bongocat-audio手柄与键盘输入归一化、动作音效bongocat-i18nJSON 本地化目录加载与覆盖率校验全局约束同样写在清单里edition 2024[workspace.lints.rust]下unsafe_code forbid应用入口 lib.rs 第一行也声明#![forbid(unsafe_code)]——整个应用不依赖任何手写 unsafe 代码这是原生 Rust 架构最直接的源码证据。关键数据流是配置 → 投影 → 运行时 → 渲染设置窗口与主进程之间通过bongocat-ui-protocol协议通信窗口不直接接触运行时。bongocat-config持久化NativeConfigconfig_projection.rs 是持久化词汇与运行时词汇的唯一交汇点文件注释写明一边加了字段而另一边漏掉在这里是编译错误而不是一个悄悄失效的设置。投影出的ModelSettings、OverlaySettings、RandomBehaviorSettings由bongocat-runtime逐帧消费bongocat-overlay负责渲染模型窗口。该设计的含义是新增一个设置时映射缺失会在编译期暴露用户选了但产品无视不是可用的失败模式。③ 能力逐项拆解3.1 为鼠标、键盘、手柄输入配置独立忽略用户视角2.0 之前三类输入要么全生效要么全关闭现在可以分别忽略任意一类【免费下载链接】BongoCat BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址: https://gitcode.com/gh_mirrors/bong/BongoCat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
)
