Bevy ECS 游戏架构

你要解决的问题

Bevy 的 API 在每个 minor 版本都会变动：Bundle 在 0.15 被标记废弃、0.16 直接移除，delta_seconds() 改名成 time.delta_secs()，Camera2dBundle/SpriteBundle 查不到，旧教程里的 buffered-event 用法也和当前版本对不上。与此同时，ECS 的写法有自己的一套约束：两个系统同时写同一组件会触发 conflicting accesses panic，Commands 是延迟执行的，本帧 spawn 的实体要到同步点之后才能被 Query 看到，而默认并行调度意味着「系统 B 在 A 之后跑」只是错觉。对刚上手 Bevy 的工程师来说，这些坑往往要用一次崩溃才能换来一条经验。

这个技能覆盖什么

核心能力：

• 锁定版本：在 Cargo.toml 里固定 bevy = "0.16"（或你的目标版本），以匹配版本的文档为准，开发环境开启 dynamic_linking 加快迭代。
• 组装 App：App::new().add_plugins(DefaultPlugins) 拿到 windowing、input、rendering、time 等能力，把系统注册进 Startup 与 Update。
• 建模数据：#[derive(Component)] 描述实体数据，#[derive(Resource)] 描述全局唯一数据（分数、设置、时钟）。
• 写系统：普通函数即系统，参数声明数据访问——Query 取实体、Res/ResMut 读写资源、Commands 做延迟 spawn/despawn；访问不冲突时系统自动并行。
• 调度控制：用 .chain() 或显式约束只排序真正有依赖的系统，用 run_if 加运行条件，把相关配置归拢到 Plugin。

典型工作流：

1. 固定版本，把匹配的文档当作事实来源。
2. 构建 App 并注册进 schedule。
3. 用组件和资源划分数据。
4. 用 Query 写系统，运动一律乘 time.delta_secs()，保证帧率无关。
5. 用 cargo run 编译运行，直接读 Bevy 在启动时报出的冲突查询。

适用边界与注意点

这是 ECS 核心层技能，不涉及渲染管线、自定义 shader、UI 布局和音频，那些是独立话题。

常见坑位清单：

• 忘记 #[derive(Component)]/#[derive(Resource)] 会报 trait 未实现。
• 运动速度随帧率变化——永远乘 time.delta_secs()，不要假设固定帧间隔。
• 同一系统里两个 Query 写同一组件 → 用 With/Without 切分实体，或改用 ParamSet。
• 同帧内后面系统读不到刚 spawn 的实体 → Commands 在同步点才生效，放到后续系统读。
• 默认并行调度不保证顺序 → 需要时显式 .chain()。
• 旧 Bevy 代码片段不可混用，按你锁定的版本查文档。

如果你要做引擎无关的 AI 逻辑或过程化生成，可配合 game-ai / procedural-gen 技能使用；项目较轻量时，pygame-core / love2d-core 也是更简单的替代。