游戏 AI / 系统课时
把 NPC 记忆接到任务系统
把 NPC 记忆接到任务系统
本篇把任务系统中的完成、失败和关键选择转换成结构化记忆,再在下一次 NPC 对话前检索这些事实,让角色行为真正受到玩家经历影响。
学习目标
- 设计任务事件到 NPC 记忆的映射规则
- 将可检索记忆与任务状态解耦,避免直接覆盖关键事实
- 在下一阶段剧情中读取记忆并验证行为变化
先把任务状态变成事件
任务系统真正适合写入记忆的,不是每一次 UI 刷新,而是已经确认的业务事实。例如任务完成、任务失败、关键选项被选择、关键目标被放弃。这些事件应带有稳定的任务标识、玩家标识和发生时间,方便后续检索与审计。
一个可投递事件包含存档、分支、玩家、任务实例、事件 ID、事件类型、权威状态版本、时间和最小业务载荷。事件发布和目标 NPC 的可见授权均由任务服务确定,玩家输入只能提出意图。NPC 记忆则保存“对谁、发生了什么、为什么重要”,而不是简单复制整条任务记录。

只把稳定事实写入记忆
任务状态本身仍应由任务系统作为权威来源。记忆层保存的是适合语言模型理解和检索的事实副本,例如“玩家帮助守卫完成北门护送”或“玩家拒绝交付遗物”。这样做可以让 NPC 快速获取上下文,同时避免模型输出反向修改任务状态。
可以用如下结构完成最小转换:
{
"eventId": "evt-204",
"saveId": "save-1",
"branchId": "main",
"playerId": "player-17",
"questId": "quest-north-gate",
"type": "quest_completed",
"timestamp": "2026-01-02T12:00:00Z",
"stateVersion": 12,
"payload": {
"npcId": "guard-01",
"choice": "helped_guard"
}
}预期结果
事件被识别为已确认的任务事实,并携带可追溯的 eventId;后续记忆记录可以引用 sourceEventId=evt-204,而不是重新猜测任务状态。进入记忆层后,建议生成短而稳定的摘要,并附带来源事件。例如 玩家帮助守卫完成北门护送、玩家拒绝交付王室遗物。对于明显无关、重复或尚未确认的中间状态,不应直接写入长期记忆。
让记忆驱动下一阶段行为
下一阶段 NPC 对话开始前,先用当前存档、分支、玩家、NPC 实例、任务阶段和版本筛选相关记忆,再把命中的记忆作为只读上下文提供给生成层。模型负责表达“认出了玩家”“调整语气”或“改变互动策略”,而任务状态仍由任务系统决定。
最小的运行链路可以写成:
def relevant_memories(rows, view, stage, world_version):
allowed_stages = {"return_to_town", "north_gate_followup"}
if stage not in allowed_stages:
return []
return [
{"summary": row["summary"], "sourceEventId": row["sourceEventId"]}
for row in rows
if row["scope"] == view and row["active"]
and row["confirmedVersion"] <= world_version
and row["kind"] == "escort_completed"
][:3]
view = ("save-1", "main", "player-17", "guard-01")
memory = {
"scope": view,
"kind": "escort_completed",
"summary": "玩家帮助守卫完成北门护送",
"sourceEventId": "evt-204",
"confirmedVersion": 12,
"active": True,
}
rows = [memory, {**memory, "scope": ("save-1", "branch-b", "player-17", "guard-01")}]
items = relevant_memories(rows, view, "return_to_town", 12)
assert len(items) == 1
assert relevant_memories(rows, view, "return_to_town", 11) == []
assert relevant_memories(rows, view, "escort_in_progress", 12) == []
assert relevant_memories([{**memory, "active": False}], view, "return_to_town", 12) == []
print(items[0]["summary"] if items else "暂无已确认的护送记忆")预期输出
玩家帮助守卫完成北门护送示例输入是已确认的只读事实投影,排序省略,只返回前三条。生产中先过滤授权、阶段、失效和版本,再按相关性与重要性排序并限制数量和 token 预算。没有命中时采用无记忆话术。
失败和选择也要有明确语义
“完成”“失败”和“选择”不能都写成模糊的“任务发生变化”。建议为它们定义稳定事件类型,并明确哪些类型会影响人格关系、哪些只影响剧情上下文。例如失败可能让 NPC 更谨慎,关键选择可能改变信任判断,而普通进度更新只用于任务流程。
还要处理重复事件。事件消费应尽量具备幂等性:为存档、分支、玩家、目标 NPC、来源事件和事实类型组合设唯一键。相同事件重放时不重复写入;同一作用域和事件 ID 携带冲突内容时隔离并告警。这样重试、断线恢复或消息队列重复投递都不会让 NPC 的历史被放大。
让记忆更新可回溯
最终验收不要只看 NPC 有没有“说对台词”,还要检查这句话能否追溯到真实任务事件。一个完整记录至少要能回答三个问题:这条记忆描述了什么、由哪个事件产生、当前是否仍然有效。
当玩家完成任务后重新进入 NPC 对话,系统应能够检索到对应记忆,并由此改变称呼、语气或可讨论内容;若任务服务纠正原事件,发布新的撤销或替代事件并更新投影。立即收紧披露权限时,交付层还要按当前权限版本过滤,并使旧缓存与在途结果失效。这样任务系统与角色记忆形成的是可验证的数据链,而不是一次性的文本拼接。