游戏叙事与剧情 / 系统课时
建立剧情内容的发布检查点
建立剧情内容的发布检查点
剧情能在编辑器里跑通,并不代表它适合发布。真正需要防住的是编译遗漏、入口改名、公共变量缺失、Tag 契约变化和关键分支断路。本节把这些风险收敛成一条发布检查链,并给出可放进 CI 与 Unity Test Runner 的最小检查方案。
学习目标
- 建立从 Ink 编译到 Unity 冒烟测试的发布检查顺序。
- 自动确认编译产物存在,并验证入口、公共变量和关键 Tag 契约。
- 区分必须阻断发布的问题与可以留给人工验收的内容问题。
把发布检查做成一条有顺序的链路
检查点应按“越便宜越靠前”的原则排列:先检查 Ink 是否能编译,再检查编译产物是否生成,然后验证 Unity 运行时契约,最后才进行关键分支和人工文案验收。这样语法错误、缺文件之类的问题不会等到完整构建后才暴露。

这条链路中,编译错误、缺少运行时入口、公共变量契约失效都应直接阻断发布;错别字、语气调整、非关键分支体验则可以留在人工验收中处理。把“技术正确性”和“内容质量”分开,才能让自动检查稳定且可维护。
先让 CI 确认 Ink 能编译
最基础的发布门槛是每次合并都重新编译总入口,并确认输出文件非空。下面脚本假设仓库中已经可以通过环境变量 INKLECATE 找到 Ink 命令行编译器;没有设置时则使用 PATH 中的 inklecate。
#!/usr/bin/env bash
set -euo pipefail
INKLECATE="${INKLECATE:-inklecate}"
SOURCE="Story/main.ink"
OUTPUT="Assets/Resources/Story/Compiled/main.json"
mkdir -p "$(dirname "$OUTPUT")"
"$INKLECATE" -o "$OUTPUT" "$SOURCE"
test -s "$OUTPUT"
echo "story-check: compiled-json-ready"预期结果是脚本退出码为 0,并至少出现脚本主动输出的最后一行;inklecate 自身的附加输出可能随版本不同。
story-check: compiled-json-ready如果编译器返回非零退出码,set -e 会立即终止脚本;如果编译命令没有生成非空 JSON,test -s 也会失败。这两个条件都应该直接阻断合并或发布。
用 Unity 冒烟测试守住运行时契约
编译成功只能证明 Ink 语法和引用关系成立,不能证明 Unity 依赖的入口、变量与 Tag 仍然存在。把这些名字当作接口契约,针对少量关键项写 EditMode 测试最合适。
下面示例假设编译文件位于 Assets/Resources/Story/Compiled/main.json,故事中存在全局变量 trust、入口 prologue,且进入该入口后的第一段可继续内容带有 # scene:prologue。项目如果使用其他命名,应替换为自己的真实契约。
using Ink.Runtime;
using NUnit.Framework;
using UnityEngine;
public sealed class StoryReleaseSmokeTests
{
[Test]
public void EntryVariablesAndTags_AreAvailable()
{
TextAsset asset = Resources.Load<TextAsset>("Story/Compiled/main");
Assert.That(asset, Is.Not.Null);
var story = new Story(asset.text);
Assert.That(story.variablesState["trust"], Is.Not.Null);
Assert.DoesNotThrow(() => story.ChoosePathString("prologue"));
Assert.That(story.canContinue, Is.True);
story.Continue();
CollectionAssert.Contains(story.currentTags, "scene:prologue");
}
}预期结果是在 Unity Test Runner 中该用例状态为 Passed;不同 Unity 版本的显示文本可能不同,但语义结果相同。
Passed这个测试故意只检查少量稳定契约,不尝试“自动读完整个故事”。测试越像完整剧情回放,越容易因为正常文案调整而频繁失效,最后反而没人愿意维护。
关键分支要检查可达性而不是逐字比对
对于结局、付费节点、教程结束点等关键分支,可以为每条路径保存一组输入条件与期望到达的 Knot 或业务事件。发布前回放这些路径,重点确认“还能到达目标状态”,而不是比较整段输出文本。这样作者改一句台词不会让测试变红,但删错跳转或改坏条件会被及时发现。
Tag 也应只检查真正被 Unity 消费的键,例如 scene:*、speaker:*、event:*。纯编辑备注不要进入发布契约,否则内容团队每次调整标记都会触发无意义的代码测试。
把检查结果分成阻断和提醒
适合作为阻断条件的项目包括:Ink 编译失败、总故事 JSON 缺失、Unity 无法构造 Story、运行时入口不存在、必须的共享变量缺失、关键 Tag 契约失效、核心分支无法到达。它们一旦出现,继续构建只会把问题推迟到运行时。
人工检查更适合处理错别字、排版、节奏、配音占位和非关键分支体验。发布流程的目标不是自动证明“剧情完美”,而是确保技术契约没有断、关键路径仍可走、编译产物确定来自当前源码。当这些检查点固定下来后,剧情迭代就能从“上线前凭记忆检查”变成可重复的工程流程。