章节调度

章节调度决定项目从哪里开始、普通章节如何进入，以及一章结束后由固定顺序还是扩展策略选择下一章。

​

打开运行设置

在剧本编辑器左侧点击「剧本运行设置」。右侧会集中显示调度方式、高级调度开始位置和章节前处理。

​

基础调度

基础调度按照左侧普通章节的顺序从上到下执行，适合线性故事和以 Fragment 分支为主的项目。

• 章节顺序就是运行顺序。
• 禁用章节会被跳过。
• 不需要安装或编写调度扩展。
• 调整章节顺序后，运行顺序随之改变。

​

高级调度

高级调度先运行固定章节，然后进入根调度节点。每次需要选择下一章时，由扩展策略返回要运行的章节，或结束项目流程。 适合：

• 地图选点式章节；
• 日程、周目或回合结构；
• 根据存档状态动态开放章节；
• 由自定义 UI 等待玩家选择下一章。

只有调度节点下方、未禁用的章节会交给扩展策略。切回基础调度不会清除已经填写的高级配置，之后重新启用时可以继续使用。

​

章节前处理

章节前处理独立于基础或高级调度。启用后，每个普通章节开始前都会先运行这一特殊章节，适合放置公共状态更新、周目统计或统一初始化逻辑。

1. 在「章节前处理」中点击「添加前处理」。
2. 点击「打开章节」，像普通章节一样编辑其中的 Block。
3. 从多个章节入口调试，确认公共逻辑不会重复产生副作用。

章节前处理不会出现在普通章节列表或高级调度候选池中。 取消前处理会删除这份特殊章节及其中的全部 Block，并且无法恢复。取消前先复制需要保留的内容。

​

片段调度事件

使用高级调度、且调度策略支持事件配置时，被调度章节的片段顶部会出现「调度事件配置」卡片。它是提供给调度策略读取的元数据，不属于剧本正文，也不会插入剧本执行队列。

• 点击「登记事件」把当前片段登记为调度事件。正文片段（main）和分支片段都可以登记。
• 卡片中的可配置字段完全由所选调度策略的扩展声明，Studio 按声明自动生成表单；策略没有提供时配置保持只读。
• 卡片底部的「事件池状态」开关可以临时停用该事件而不删除配置；「移除配置」只移除片段元数据，不会删除剧情正文。
• 「按条件调试」会构造能满足该事件条件的临时调试状态并直接进入调试，事件仍需通过正式调度规则命中。

​

调度调试面板

项目启用高级调度后，调试模块右侧面板会出现「调度」页签，集中调试调度策略：

• 调试起点：直接进入调度器，或从某个固定章节开始。
• 临时调度条件：按策略声明的表单（或 JSON）填写临时条件，点击「应用并重启调试」生效。临时条件只注入调试运行，不影响正式预览与构建。
• 最近一次决策：回显最近一轮调度决策的周期、当前章节和决策结果，方便核对策略行为。

​

选择建议

扩展开发者可以继续阅读提供章节调度策略。