开发指南

i在用编程智能体？从这里开始

参伍为编程智能体提供了两个 skill。请让智能体在写代码前先加载它们：canwu-engine-docs 与 canwu-engine-usage。然后从快速开始和相关可运行示例入手，按需查阅开发指南。

可以直接发送的提示

请先加载 canwu-engine-docs 和 canwu-engine-usage 两个 skill，再阅读与本任务对应的参伍教程、开发指南页面和示例。只通过 canwu-api 实现；动手修改前先说明需要保持的约束；完成后运行示例或针对性检查。

这组指南写给在参伍之上开发游戏、研究工具或智能体系统的开发者。每一页讲一项任务， 并给出其中需要的 canwu-api 调用。

第一次接入

1. 运行移动军队教程，确认本地 Rust 工具链可以构建并运行参伍。
2. 阅读接入并驱动模拟运行，把同样的流程放进自己的应用。
3. 在下面选择与下一项任务对应的指南。

按任务选择指南

接入并驱动模拟运行添加依赖、创建模拟运行、提交命令，并把现实时间换算成模拟时间。

安全读取与呈现状态只向玩家和智能体展示其角色知道的内容，完整快照只留给受信任的代码。

存档、重放与派生分支在快照和检查点日志之间选择，用相同插件重新加载，并重放或派生一次模拟运行。

通过插件扩展用领域命令和边界系统添加自己的规则。

只涉及某个领域系统的指南，例如生产、资源与运输的职责划分， 与对应系统一起列在领域系统下。

每个接入都要遵守的规则

1. 以 canwu-api 和已发布的扩展为依赖。 具体规则来自 canwu-military 等模拟领域扩展、 参考整合包或你自己编写的插件。不要直接依赖 canwu-sim 等内部 crate，它们不提供兼容性承诺。
2. 通过命令改变世界。 使用引擎命令、领域命令或插件输入。
3. 给玩家和智能体使用角色相对视图。 完整快照只用于受信任的上层应用代码和调试工具。
4. 时钟由上层应用掌管。 渲染、输入和现实时间都留在上层应用；调用引擎前，先把经过的 现实时间换算成模拟时长。
5. 需要存档时固定版本。 固定引擎版本，并用相同的插件加载或重放。引擎会把它们与存档中 保存的插件描述逐一比对。

其他资料

• 可运行代码：快速开始与案例。
• 结算、事件和随机数为什么这样设计：引擎架构。
• 完整类型与函数签名：canwu-api 源码及其示例。