游戏叙事与剧情 / 系统课时
让复杂剧情更容易复现
让复杂剧情更容易复现
这一节解决“问题偶尔才出现、必须点很多分支才能撞到”的调试困境。核心做法是把随机性和无关剧情拿掉,固定初始变量、选择路径和关键观察点,让同一个故障可以在几步内稳定出现,再用这条最小路径验证修复。
学习目标
- 把长剧情压缩成可重复执行的最小复现路径
- 用固定初始状态和调试标记消除“偶现”干扰
- 记录足够的路径证据,让其他人可以按同样步骤复现
从失败现场反推必要条件
不要从章节开头重新试玩几十次。先记录故障发生时真正相关的条件,例如当前 knot、关键变量、最近两三个选择以及是否经过某个分支。然后逐项删除无关步骤,只要问题仍能出现,就继续缩短路径。
一个有效的最小复现通常只保留三类信息:初始状态、选择序列、失败观察点。随机事件、装饰对白和不影响条件判断的支线都应暂时绕开。

在脚本里留下可搜索的标记
下面是一个完整的最小 Ink 脚本。它故意把状态缩减为 has_key 一个变量,并在关键节点打印 DBG: 标记。复制到 Inky 后即可手动选择两条路径,观察门的判断是否符合变量状态。
VAR has_key = false
-> start
=== start ===
DBG:start has_key={has_key}
+ [拿钥匙]
~ has_key = true
-> gate
+ [直接去门口]
-> gate
=== gate ===
DBG:gate has_key={has_key}
{
- has_key:
门打开了。
- else:
门锁着。
}
-> END预期结果:选择“拿钥匙”时,第二个调试标记中的 has_key 应为 true,结局为“门打开了”;选择“直接去门口”时应为 false,结局为“门锁着”。
路径 A:start -> 拿钥匙 -> gate
DBG:gate has_key=true
门打开了。
路径 B:start -> 直接去门口 -> gate
DBG:gate has_key=false
门锁着。如果复杂项目中的同类问题在这个最小脚本里消失,说明根因很可能藏在被删掉的初始化、外部变量同步或其他分支副作用中;再逐项加回这些因素,比继续盲点完整剧情更快。
固定输入而不是依赖记忆
复现记录不要写“按正常流程走到门口”,而要写成机器和人都能重复的明确输入,例如“初始 has_key=false,选择 start 的第 1 个选项,再进入 gate”。对真实项目,还应记录 Ink 内容版本或构建号,避免脚本更新后路径含义改变。
如果故障与随机分支有关,调试阶段优先把随机条件改造成可控输入,例如临时变量 debug_roll,由测试场景显式指定结果。验证完根因后再恢复随机逻辑。这样复现依赖的是确定状态,而不是“多试几次应该能碰到”。
用同一条路径验证修复
修复前先保存最小路径及其预期失败结果,修复后不要换一套测试方法。仍然使用相同初始状态、相同选择序列和相同观察点,只比较故障行为是否消失。
如果修复的是“拿到钥匙后门仍然锁着”,验收就应固定执行路径 A,并确认 has_key=true 与“门打开了”同时成立。只有状态和可见结果都符合预期,才算真正修复;否则只是把症状移动到了别的位置。