示例的分类与用途

  • Fundamentals 展示单一核心合同，例如编译、生命周期、状态、控制或后端选择。
  • Components 展示 Registry 组件、机器人、传感器、Scenario 与插件的装配方式。
  • Server 展示远程发现、生命周期、控制、媒体与场景接口。

每个案例的版本与前置条件以其页面为准。页面底部会链接原始 README；若示例与概念页表述冲突，以当前源码合同和参考页为准。

全部案例

下面的目录由站点构建器从 FastSim demo/ 树生成，避免手工导航与源码分叉。

示例位于文档体系的资源层。概念页说明设计边界，指南描述一类可验证目标，参考页给出当前接口，示例提供一份可运行实例。单个示例未使用某字段不表示该能力不存在，demo 的临时目录也不构成 Project/Registry 规范。

使用方法与验收标准

先复制或引用与目标最接近的最小案例，记录其 Core、插件和 Provider 版本；在不修改内容时完成 validate/运行；随后一次只改变一个维度，并比较 expand、Plan digest、Application snapshot 与结果。复杂案例失败时回到最小 Fundamentals，而不是继续向大 Run 添加调试代码。

成功标准不只是命令退出：配置应解析到预期组件和插件；Application 进入期望终态；generation/tick 正常；所需 capability 与 targets 存在；Operation 给出明确结果；Record 场景还要验证正式 FSR 和 finalizer。需要 GUI/GPU/后端真实行为的案例必须保存对应证据。

  • 编译、生命周期、状态、控制和 backend 选择：从 Fundamentals 开始。
  • 组件 release、Registry、机器人、传感器与 Scenario 装配：进入 Components。
  • 远程客户端、operation 或媒体/场景协议：进入 Server。
  • Mission、Record、Replay 或其他组合能力：先阅读官方插件目录，再进入对应仓库案例。

示例页面直接来自当前源码 README，因此会跟随实现更新；主概念与跨页面术语仍以本网站的架构文档为准。