游戏 AI / 系统课时
存档加载后记忆怎样恢复
存档加载后记忆怎样恢复
这一课解决存档恢复后 NPC 记忆、剧情状态和关系数据彼此不一致的问题,最终建立一套带版本号、明确加载顺序且可兼容旧存档的恢复流程。
学习目标
- 设计带版本号的角色记忆与关系存档结构
- 按依赖关系恢复剧情、关系和记忆数据
- 处理旧版本存档迁移并验证恢复结果
先确定什么数据必须恢复
存档不是把所有运行时对象原样序列化,而是保存重新构建角色状态所需的权威数据。对动态剧情系统,至少要区分剧情进度、关系事实和可检索记忆;瞬时上下文、模型请求中的临时 token 等数据通常不应直接进入存档。
快照根节点保存 schemaVersion 用来迁移格式,worldSeq 定位世界事件水位,另存配置引用与人格版本。三者解决不同问题。快照中的任务、关系、事件和记忆应来自同一保存边界,不能把不同世界版本的部分直接拼在一起。

用版本号保证旧存档可迁移
示例假定版本 1 的 relationships 是“NPC ID → 关系对象”的映射,版本 2 为每个 NPC 增加阵营值。0 是本项目明确的迁移默认值,只补新字段。未知版本、缺少权威任务或关系结构无效时停止加载。无法追溯到已授权事件的旧记忆放入复核清单。
将下例保存为 restore_save.py,运行 python restore_save.py。加载入口接收从可信存储读出的快照和服务端授权的范围。示例只演示内存加载,不会改写原快照。Python deepcopy
from copy import deepcopy
CURRENT_SCHEMA = 2
def migrate(save):
version = save.get("schemaVersion")
if type(version) is not int or version not in {1, CURRENT_SCHEMA}:
raise ValueError("unsupported save schema")
data = deepcopy(save)
relationships = data.get("relationships")
if not isinstance(relationships, dict):
raise ValueError("invalid relationships")
if version == 1:
for relationship in relationships.values():
if not isinstance(relationship, dict):
raise ValueError("invalid relationship entry")
relationship.setdefault("factionStanding", 0)
data.setdefault("events", {})
data["schemaVersion"] = CURRENT_SCHEMA
return data
def load_runtime(save, expected_scope):
if not isinstance(save, dict) or not isinstance(expected_scope, dict) or save.get("scope") != expected_scope:
raise ValueError("save scope mismatch")
data = migrate(save)
world_seq = data.get("worldSeq")
story = data.get("story")
if (type(world_seq) is not int or world_seq < 0 or not isinstance(story, dict)
or story.get("questStage") not in ("active", "completed", "failed")):
raise ValueError("invalid story or world sequence")
relationships = data["relationships"]
for relation in relationships.values():
if not isinstance(relation, dict):
raise ValueError("invalid relationship entry")
for name in ("trust", "factionStanding"):
value = relation.get(name)
if type(value) is not int or not 0 <= value <= 100:
raise ValueError(f"invalid relationship field: {name}")
events = data.get("events")
memories = data.get("memories")
if not isinstance(events, dict) or not isinstance(memories, list):
raise ValueError("invalid event or memory collection")
projected = []
quarantined = []
seen = set()
for memory in memories:
if not isinstance(memory, dict) or not isinstance(memory.get("id"), str):
raise ValueError("invalid memory entry")
memory_id = memory["id"]
source_id = memory.get("sourceEventId")
npc_id = memory.get("npcId")
evidence = events.get(source_id) if isinstance(source_id, str) else None
if (not isinstance(npc_id, str) or npc_id not in relationships or not isinstance(evidence, dict)
or evidence.get("npcId") != npc_id or type(evidence.get("seq")) is not int
or not 0 < evidence["seq"] <= world_seq or not isinstance(evidence.get("summary"), str)):
quarantined.append(memory_id)
continue
key = (npc_id, source_id)
if key not in seen:
projected.append({"npcId": npc_id, "sourceEventId": source_id, "summary": evidence["summary"]})
seen.add(key)
return {
"schemaVersion": data["schemaVersion"], "worldSeq": world_seq, "story": story,
"relationships": relationships, "memories": projected, "quarantined": quarantined,
}
if __name__ == "__main__":
scope = {"saveId": "save-01", "branchId": "main", "playerId": "player-42"}
legacy = {
"scope": scope, "schemaVersion": 1, "worldSeq": 20,
"story": {"questStage": "active"},
"relationships": {"npc-elias": {"trust": 72}, "npc-merchant": {"trust": 45}},
"memories": [{"id": "legacy-note", "text": "玩家完成了护送"}],
}
runtime = load_runtime(legacy, scope)
print([rel["factionStanding"] for rel in runtime["relationships"].values()])
print(runtime["story"]["questStage"], len(runtime["memories"]), runtime["quarantined"])
print("original version:", legacy["schemaVersion"])[0, 0]
active 0 ['legacy-note']
original version: 1玩家可见回忆只从通过范围和来源检查的记录重建。模型无法从缺失字段补出权威事实。示例假设快照来自可信游戏存储;导入玩家提供的文件还需先验证完整格式、数据规模与权限。
按依赖顺序恢复运行时状态
加载顺序应遵循“权威状态先于派生状态”的原则。先恢复世界和剧情进度,再恢复关系事实,随后恢复长期记忆记录或索引,最后才组装供模型使用的当前上下文。
例如旧自由文本声称“玩家已经完成护送”,而权威任务仍进行中。加载器将缺证据的文本隔离,保留可审计标识。若确有可信历史事件,应按任务实例说明“上一轮完成”,当前任务仍以当前实例的权威状态为准。
对于向量索引等派生数据,也不要把索引本身当成唯一存档。存档应保留可重建的原始记忆记录,加载后可以重新建立索引或校验索引版本,避免因索引损坏导致角色“失忆”。
处理缺失数据与不兼容版本
恢复流程必须把“字段缺失”和“版本无法迁移”分开处理。可安全补齐的字段使用明确默认值;无法判断语义的字段则拒绝静默猜测,并把存档标记为需要修复。
常见策略是保留 migrationVersion 或 schemaVersion,每次迁移只处理一个相邻版本。例如 1 → 2、2 → 3,而不是写一个包含所有历史分支的巨大函数。这样新版本上线后,旧存档仍能沿迁移链逐步升级。
用恢复测试验证存档真的一致
恢复测试至少覆盖三种情况:当前版本正常加载、旧版本成功迁移、关键字段缺失时进入可预期的降级路径。验证时不要只检查“能否打开存档”,还应检查 NPC 最终看到的关系和记忆是否与剧情状态一致。
先在临时对象中迁移并校验,再整体替换已加载状态。数据库快照可在同一读事务获取一致视图。迁移落库时保留旧快照和失败恢复路径;恢复较早存档或切换分支后,递增加载代数或切换分支范围,拒绝仍引用旧快照的异步回写。测试当前版、旧版、未知版、必填项缺失、错误范围、孤立证据以及重复加载。SQLite 事务