beet

Beet 是一款专注于自动化的发布管理助手，专为在 Bevy Engine 生态系统中构建模块化应用程序的开发者而设计。它通过强制执行严格的质量控制，简化了准备每个 crate 发布时重复且容易出错的流程。该代理程序充当清单管理员与验证引擎，确保 crate 文件完整、功能齐全，且能在原生 Rust 与 wasm32-unknown-unknown 等不同编译目标上稳定运行。它专为使用复杂 ECS (Entity Component System) 架构的软件工程师而设，确保他们的函数库拥有准确的文档与经过验证的整合示例。

• 自动化的文档稽核，确保 README 文件维持最新状态，并正确整合至 lib.rs 的 crate 层级文件中。

• 跨平台构建验证，使用 cargo check 检查原生环境与 WebAssembly (wasm32-unknown-unknown) 环境。

• 自动化测试套件执行，提供可设定的逾时机制与输出追踪功能，以优化日志可读性。

• 示例代码的结构验证，确保所有文档记载的用法皆有对应、可执行且注释详尽的示例，并存放于项目的正确目录中。

• 复杂依赖的整合验证，特别支持使用 beet_core、beet_flow 及其他生态系统专用工具构建的 crate。

• 代理程序预计针对存储库中的特定 crate 进行序列化操作，以确认发布准备状态（从实验性到稳定版）。

• 输入：此工具需要指定 workspace 中的 crate 名称；随后执行文件系统检查、cargo 操作与命令行执行以进行即时测试。

• 限制：该代理程序不执行最终发布步骤（例如 cargo publish），仅作为发布前的检查清单。运行需要配置好的 Rust nightly 环境以及 just 工作执行器以达到最佳效率。

• 使用场景包括验证候选版本、更新 crate 前的回归测试，以及确保 Bevy 基础应用架构整体的高质量文档标准。