快速开始
先运行一个小示例,再去了解它用到的接口。
在用编程智能体?从这里开始
参伍为编程智能体提供了两个 skill。请让智能体在写代码前先加载它们:canwu-engine-docs 与 canwu-engine-usage。然后从快速开始和相关可运行示例入手,按需查阅开发指南。
可以直接发送的提示
请先加载 canwu-engine-docs 和 canwu-engine-usage 两个 skill,再阅读与本任务对应的参伍教程、开发指南页面和示例。只通过 canwu-api 实现;动手修改前先说明需要保持的约束;完成后运行示例或针对性检查。建议从 移动军队 开始。它只需要几分钟,在任何装有 Rust 1.88 或更新版本的机器上都能运行, 并完整展示一个周期:提交命令、推进时间,再对这次运行做存档、派生分支和重放。其他教程可以 等到需要对应功能时再看。
文档如何组织
Section titled “文档如何组织”| 部分 | 适用情况 | 从这里开始 |
|---|---|---|
| 快速开始 | 第一次使用参伍,想先运行起来 | 移动军队 |
| 教程 | 想逐一掌握引擎的核心功能 | 连续时间游戏循环 |
| 开发指南 | 正在把参伍接入自己的应用,要完成某项具体任务 | 接入并驱动模拟运行 |
| 引擎架构 | 想了解命令如何结算、记录和重放 | 架构总览 |
| 领域系统 | 需要知识、资源、移动、战争、技术、赋税或社会方面的规则 | 领域系统 |
| 案例 | 想看几个系统在同一个场景中配合运行 | 案例 |
| 参考 | 需要查某个概念的规范中英文术语 | 参伍术语表 |
这些教程只用到 canwu-api,移动军队还用到参考世界。
渲染器、窗口、输入设备和游戏框架仍由你的应用选择。
移动军队:参考整合起步示例排入一条移动命令并推进时间,然后对这次运行做存档、读档、派生分支和重放。
连续时间游戏循环用实时游戏循环驱动引擎,并在任何帧率下得到相同结果。
命令插件添加自己的命令:校验载荷、检查谁有权签发,并声明它读写的状态。
阶段边界与资源分配一个插件提供粮食,另一个在同一边界中申请,后续阶段读取结算后的分配结果。
领域系统提供知识、资源、军事、财政等方面的具体规则,大多是按需注册的可选 crate。 其中三个系统还有实践教程,对应的设计页面分别是路线、运输与移动、 军事和技术。
领域系统八个领域系统的设计页面,以及提供它们的 crate。
路线规划与送信执行跟随一封从无锡寄往北京的信:根据观察者所知规划最快路线,再记录每个路段、交接与改道。
运行军事扩展:从接敌到占领用可选的军事扩展建立部队、行军接敌、结算战斗并建立占领。
发明、使用与技术传播跟随一项技术从工坊试验到安装、为一种用途采用,再开放一次师徒传授。
案例把几个系统组合进一个可运行的历史场景。
粮食、生产与军事补给运行合成粮食循环,再结合带出处的松江与汉冶萍案例,查看生产、资源与军事后勤。
军阀请求邻军援助一位军阀决定是否出兵。演示决策票据、选项、效用决策策略,以及这次选择的精确重放。
本地社区传播与制度回应一个观念在本地社区中传播,议事会通过决策票据作出回应。演示人口群体(cohort)、社会影响与观察者估计。
机密副本与定向发布中转者在途中复制文书,向两位读者发布副本后撤回:之后的读取被拒绝,此前的读取记录仍然保留。
编码传递与中途截取中转者复制了密文却无法解读,收件人委托他人完成解读。演示如何区分持有、读取与理解。
从无锡发出、按路线投递的通信从无锡把同一封信分别寄往本地和北京,按发送者自己所知规划路线,并逐段记录投递过程。
全部案例浏览所有场景。
开发指南按任务说明如何接入、读取状态、存档和编写插件。
GitHub 上的示例源码所有示例的 Rust 源码,位于提供它们的各个 crate 中。