游戏 AI / 系统课时

存档加载后记忆怎样恢复

存档加载后记忆怎样恢复

这一课解决存档恢复后 NPC 记忆、剧情状态和关系数据彼此不一致的问题,最终建立一套带版本号、明确加载顺序且可兼容旧存档的恢复流程。

学习目标

  • 设计带版本号的角色记忆与关系存档结构
  • 按依赖关系恢复剧情、关系和记忆数据
  • 处理旧版本存档迁移并验证恢复结果

先确定什么数据必须恢复

存档不是把所有运行时对象原样序列化,而是保存重新构建角色状态所需的权威数据。对动态剧情系统,至少要区分剧情进度、关系事实和可检索记忆;瞬时上下文、模型请求中的临时 token 等数据通常不应直接进入存档。

快照根节点保存 schemaVersion 用来迁移格式,worldSeq 定位世界事件水位,另存配置引用与人格版本。三者解决不同问题。快照中的任务、关系、事件和记忆应来自同一保存边界,不能把不同世界版本的部分直接拼在一起。

存档恢复中的状态依赖与加载顺序

用版本号保证旧存档可迁移

示例假定版本 1 的 relationships 是“NPC ID → 关系对象”的映射,版本 2 为每个 NPC 增加阵营值。0 是本项目明确的迁移默认值,只补新字段。未知版本、缺少权威任务或关系结构无效时停止加载。无法追溯到已授权事件的旧记忆放入复核清单。

将下例保存为 restore_save.py,运行 python restore_save.py。加载入口接收从可信存储读出的快照和服务端授权的范围。示例只演示内存加载,不会改写原快照。Python deepcopy

python
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"])
text
[0, 0]
active 0 ['legacy-note']
original version: 1

玩家可见回忆只从通过范围和来源检查的记录重建。模型无法从缺失字段补出权威事实。示例假设快照来自可信游戏存储;导入玩家提供的文件还需先验证完整格式、数据规模与权限。

按依赖顺序恢复运行时状态

加载顺序应遵循“权威状态先于派生状态”的原则。先恢复世界和剧情进度,再恢复关系事实,随后恢复长期记忆记录或索引,最后才组装供模型使用的当前上下文。

例如旧自由文本声称“玩家已经完成护送”,而权威任务仍进行中。加载器将缺证据的文本隔离,保留可审计标识。若确有可信历史事件,应按任务实例说明“上一轮完成”,当前任务仍以当前实例的权威状态为准。

对于向量索引等派生数据,也不要把索引本身当成唯一存档。存档应保留可重建的原始记忆记录,加载后可以重新建立索引或校验索引版本,避免因索引损坏导致角色“失忆”。

处理缺失数据与不兼容版本

恢复流程必须把“字段缺失”和“版本无法迁移”分开处理。可安全补齐的字段使用明确默认值;无法判断语义的字段则拒绝静默猜测,并把存档标记为需要修复。

常见策略是保留 migrationVersion 或 schemaVersion,每次迁移只处理一个相邻版本。例如 1 → 2、2 → 3,而不是写一个包含所有历史分支的巨大函数。这样新版本上线后,旧存档仍能沿迁移链逐步升级。

用恢复测试验证存档真的一致

恢复测试至少覆盖三种情况:当前版本正常加载、旧版本成功迁移、关键字段缺失时进入可预期的降级路径。验证时不要只检查“能否打开存档”,还应检查 NPC 最终看到的关系和记忆是否与剧情状态一致。

先在临时对象中迁移并校验,再整体替换已加载状态。数据库快照可在同一读事务获取一致视图。迁移落库时保留旧快照和失败恢复路径;恢复较早存档或切换分支后,递增加载代数或切换分支范围,拒绝仍引用旧快照的异步回写。测试当前版、旧版、未知版、必填项缺失、错误范围、孤立证据以及重复加载。SQLite 事务

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

存档加载后记忆怎样恢复

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通