03 — Run、Scenario 与插件

远程控制方通常要先获得不可变上下文再开始工作。本案例读取 Run 身份、应用快照、完整 Scenario 投影、插件宿主状态、存在时的精确单实例状态，以及一页有上限的插件事件。

验证等级

通过 loopback HTTP 检查公开应用。 Run 配置会实际编译，客户端会访问公开检查面。本配置特意带有可选 Scenario 分区，便于查看其原样、opaque 的数据。当前配置没有插件实例，因此客户端会明确报告这一事实，不会虚构一个插件。

运行

终端 A：

bash

cd demo/server/03_run_scenario_and_plugins
fastsim config validate run.yaml --json
fastsim-server run.yaml

终端 B：

bash

cd demo/server/03_run_scenario_and_plugins
python main.py

scenario/source 说明 Scenario 来自内联还是组件；scenario/scene 保存固定布局。 behavior 和 evaluation 是可选的插件数据，FastSim Core 不解释其中的任务语义。它们不存在时，单独读取会返回 404 scenario_section_absent。

插件事件使用 after_sequence 游标和有上限的 limit。生产客户端应保存 next_after_sequence，不要反复下载旧事件。

三类插件查询各有用途：

GET /api/v1/plugins/status 返回插件宿主和全部已配置实例。
GET /api/v1/plugins/{instance}/status 返回一个精确实例及有上限的宿主上下文。将此客户端用于带插件的 Run 时，可传 --plugin-instance NAME；实例不存在时会给出清晰提示，不会输出 traceback。
GET /api/v1/plugins/events 返回基于游标的事件页，并支持 instance 和 topic 筛选。

插件不能通过此 API 脱离 Run 单独启停。其 prepare、start、reset、stop 和 cleanup 阶段跟随所属 Run 的生命周期。

下一步：04 — 状态与控制目标。