游戏叙事与剧情 / 系统课时
定位一次关系状态错乱
定位一次关系状态错乱
关系状态错乱通常不是“某个变量值错了”这么简单,而是事件顺序、持久化数据和状态转换之间出现了不一致。本课用一个可复现的小型状态机演示如何从复现步骤、事件日志、变量快照一直追到错误转换条件,并给出修复后的验证方法。
学习目标
- 按固定顺序复现关系状态异常,避免边查边改破坏现场。
- 能把事件日志、变量快照和状态转换对应到同一条时间线上。
- 能用最小回归脚本确认修复没有引入新的状态跳转问题。
先把“错乱”变成可重复现象
假设角色关系有 STRANGER、FRIEND、CLOSE 三个阶段:好感达到 30 进入 FRIEND,达到 70 进入 CLOSE。玩家报告“好感已经 75,但读档后仍显示 FRIEND”。
排查时不要先改阈值。先记录最短复现路径:初始状态、触发事件、保存时机、读档动作和最终界面。只要这五项不能稳定复现,后续日志很容易比较错样本。

用日志和快照对齐时间线
下面的 Python 示例模拟一个常见错误:事件把好感从 65 提升到 75,但保存逻辑在状态刷新前执行,因此存档里写入了旧状态 FRIEND。
from dataclasses import dataclass, asdict
import json
@dataclass
class Relation:
affinity: int
stage: str
def refresh_stage(r: Relation) -> None:
if r.affinity >= 70:
r.stage = "CLOSE"
elif r.affinity >= 30:
r.stage = "FRIEND"
else:
r.stage = "STRANGER"
relation = Relation(affinity=65, stage="FRIEND")
print("before_event", asdict(relation))
relation.affinity += 10
print("after_event", asdict(relation))
saved = json.dumps(asdict(relation), ensure_ascii=False)
print("saved", saved)
refresh_stage(relation)
print("after_refresh", asdict(relation))预期输出:
before_event {'affinity': 65, 'stage': 'FRIEND'}
after_event {'affinity': 75, 'stage': 'FRIEND'}
saved {"affinity": 75, "stage": "FRIEND"}
after_refresh {'affinity': 75, 'stage': 'CLOSE'}这里已经能确认:事件本身正确,好感变量也正确,异常发生在“保存”与“状态刷新”的顺序之间。变量快照的价值就在于把“数值错”和“状态派生错”分开。
回到状态转换检查不变量
关系系统最好明确一个不变量:同一时刻的 stage 必须能由当前 affinity 推导出来。只要存档允许 affinity=75 与 stage=FRIEND 同时存在,就意味着系统保存了互相矛盾的事实。
修复可以有两种方向:保存前先刷新状态,或者存档只保存好感等源数据,读档时重新派生阶段。前者改动小,后者更能避免长期存档积累历史脏状态。无论选择哪种,都要让状态转换只有一个权威入口。
修复后做最小回归
下面采用“保存前刷新”的最小修复,并用断言验证保存结果。
from dataclasses import dataclass, asdict
import json
@dataclass
class Relation:
affinity: int
stage: str
def refresh_stage(r: Relation) -> None:
r.stage = "CLOSE" if r.affinity >= 70 else "FRIEND" if r.affinity >= 30 else "STRANGER"
relation = Relation(affinity=65, stage="FRIEND")
relation.affinity += 10
refresh_stage(relation)
saved = json.dumps(asdict(relation), ensure_ascii=False)
loaded = json.loads(saved)
assert loaded == {"affinity": 75, "stage": "CLOSE"}
print(loaded)预期输出:
{'affinity': 75, 'stage': 'CLOSE'}真正可靠的定位顺序是先稳定复现,再对齐事件与快照,最后检查状态转换和持久化边界。这样可以避免看到错误界面就直接改阈值,也能把“显示错”“状态错”“存档错”快速拆成不同责任层。