游戏叙事与剧情 / 系统课时
为关系系统设计回归用例
为关系系统设计回归用例
关系系统的回归测试不能只验证“加 10 点好感后数值正确”,因为真正容易出问题的是剧情节点、阶段边界、分支事件和跨版本存档。本课把这些风险整理成一组可长期维护的测试集合,并用可运行示例覆盖阶段跃迁与存档恢复。
学习目标
- 能按剧情节点、关系阶段和存档生命周期划分回归覆盖面。
- 能为阶段阈值设计边界用例,而不是只测正常路径。
- 能把核心关系规则写成可自动重复执行的回归测试。
先确定必须守住的行为
回归集应优先覆盖“改坏后玩家最难恢复”的规则,而不是把所有剧情对白都自动化。关系系统通常至少有三类高价值对象:阶段阈值、关键剧情门槛、长期存档兼容。
阶段阈值要测边界前后,例如 29、30、69、70;关键剧情节点要验证事件只触发一次且条件正确;长期存档则要验证保存、加载后关系状态不漂移,并保留旧版本迁移测试。
| 风险面 | 代表用例 | 主要防止的问题 |
|---|---|---|
| 关系阶段 | 29→30、69→70、70→69 | 边界条件写错、降级遗漏 |
| 剧情节点 | 达标触发、未达标不触发、重复进入 | 漏触发或重复领奖 |
| 长期存档 | 保存后读档、旧档迁移 | 阶段漂移、字段缺失 |
把阶段边界写成参数化测试
下面使用 Python 标准库 unittest,不依赖第三方框架。测试数据同时覆盖阈值前一格、阈值本身和高阶段,能直接暴露 > 与 >= 写错的问题。
import unittest
def relation_stage(affinity: int) -> str:
if affinity >= 70:
return "CLOSE"
if affinity >= 30:
return "FRIEND"
return "STRANGER"
class RelationStageTest(unittest.TestCase):
def test_stage_boundaries(self):
cases = [
(29, "STRANGER"),
(30, "FRIEND"),
(69, "FRIEND"),
(70, "CLOSE"),
]
for affinity, expected in cases:
with self.subTest(affinity=affinity):
self.assertEqual(relation_stage(affinity), expected)
if __name__ == "__main__":
unittest.main(verbosity=2)预期输出:
test_stage_boundaries (__main__.RelationStageTest.test_stage_boundaries) ... ok
----------------------------------------------------------------------
Ran 1 test in <TIME>s
OK<TIME> 会随机器不同而变化。这个测试很短,但它锁住了最容易被条件修改破坏的阶段边界。
把存档恢复纳入同一套回归
只测内存状态还不够。长期运行的游戏更容易在序列化、字段新增或版本迁移时产生关系漂移。下面用 JSON 模拟保存和读取,并在读档后重新派生阶段,确保源数据与派生状态一致。
import json
def relation_stage(affinity: int) -> str:
if affinity >= 70:
return "CLOSE"
if affinity >= 30:
return "FRIEND"
return "STRANGER"
save_text = json.dumps({"version": 2, "affinity": 75})
loaded = json.loads(save_text)
loaded["stage"] = relation_stage(loaded["affinity"])
assert loaded == {"version": 2, "affinity": 75, "stage": "CLOSE"}
print(loaded)预期输出:
{'version': 2, 'affinity': 75, 'stage': 'CLOSE'}如果未来版本新增“锁定关系”“剧情强制阶段”等规则,就应把这些字段加入迁移测试,而不是只改当前逻辑测试。长期存档测试的关键不是模拟几十小时游戏,而是固定几份具有代表性的历史输入,持续验证加载后的不变量。
组织一套可维护的回归集合
测试集合可以按“规则稳定性”而不是按代码文件划分。阶段边界适合每次提交都跑;关键剧情节点适合在剧情逻辑修改时跑;历史存档兼容测试适合发布前和存档格式变更时重点执行。
一套好的关系系统回归测试,不追求用例数量最大,而是确保核心阶段、不可逆剧情和长期存档始终有可重复验证的证据。新增规则时先判断它会破坏哪条既有不变量,再补相应回归,测试集才能长期保持有效。