游戏 AI / 系统课时
写入玩家关系和重大事件记忆
写入玩家关系和重大事件记忆
玩家送礼、作出关键选择或与 NPC 结仇后,下一次对话必须能找回这些事实。本课把一次性游戏事件写成可查询的长期记忆,演示关系值如何避免重复累加,并处理记忆修订与删除。
学习目标
- 区分可持久化的游戏事实、关系变化和模型生成的建议。
- 用稳定事件 ID 实现幂等写入、关系重算与查询。
- 正确处理承诺修订、事件撤销和彻底删除。
只记录能被游戏确认的事实
长期记忆的写入入口应是服务端已确认的事件,例如背包确实扣除了礼物、任务选择已经提交,或战斗系统确认玩家攻击了该 NPC。模型说出“玩家送了我药草”,不能作为送礼成功的依据。
每条记忆至少关联 event_id、player_id、npc_id、kind、summary 和发生顺序 turn。生产系统还应保留来源任务或交易 ID、事件版本与写入时间,便于查证“是谁在什么时候根据什么事实写入”。
| 事件类型 | 典型事实 | 后续用途 |
|---|---|---|
gift |
玩家交付一份药草 | 调整好感,改变称呼 |
choice |
玩家选择隐瞒真相 | 影响信任与后续话题 |
hostility |
玩家主动攻击 NPC | 触发戒备或拒绝服务 |
promise |
NPC 承诺归还地图 | 记录待履行约定 |
trust_delta 等关系改变量必须由游戏规则计算,不能直接采用模型提供的数值。关系值也不能只在对话历史里保存,否则上下文截断后,人物态度会突然重置。
规划写入、撤销与关系重算链路
同一交易可能因网络重试被上报两次,因此要用稳定的业务事件 ID 去重。事件记录作为事实依据,当前信任值从基准值和仍有效的事件变化量计算,删除或修订后才不会留下错误加分。

需要区分两类更新:修正记忆的文本描述,不应改变已确认的交易事实;撤销整个事件,则必须同步撤销它带来的关系变化。下面用 SQLite 将这两条规则直接落实到查询条件。
用 SQLite 验证幂等、修订和撤销
示例仅依赖 Python 标准库。在临时目录创建真正的 SQLite 文件,并在关闭连接后重新打开,以验证不是只保存在进程内存中。生产环境应改用受备份保护的持久目录,不要使用临时目录。
import sqlite3
from pathlib import Path
from tempfile import TemporaryDirectory
def trust(db, player_id, npc_id):
base = db.execute(
"SELECT base_trust FROM npc_relation WHERE player_id=? AND npc_id=?",
(player_id, npc_id),
).fetchone()[0]
delta = db.execute(
"SELECT COALESCE(SUM(trust_delta), 0) FROM npc_memory "
"WHERE player_id=? AND npc_id=? AND deleted=0",
(player_id, npc_id),
).fetchone()[0]
# 从有效事件重算,避免重复投递或撤销导致累计漂移
return max(0, min(100, base + delta))
with TemporaryDirectory() as root:
path = Path(root) / "npc.sqlite"
db = sqlite3.connect(path)
db.executescript("""
CREATE TABLE npc_relation (
player_id TEXT NOT NULL,
npc_id TEXT NOT NULL,
base_trust INTEGER NOT NULL,
PRIMARY KEY (player_id, npc_id)
);
CREATE TABLE npc_memory (
event_id TEXT PRIMARY KEY,
player_id TEXT NOT NULL,
npc_id TEXT NOT NULL,
kind TEXT NOT NULL CHECK (kind IN ('gift','choice','hostility','promise')),
summary TEXT NOT NULL,
trust_delta INTEGER NOT NULL,
turn INTEGER NOT NULL,
deleted INTEGER NOT NULL DEFAULT 0
);
""")
db.execute("INSERT INTO npc_relation VALUES (?, ?, ?)", ("p7", "merchant", 50))
insert_sql = (
"INSERT OR IGNORE INTO npc_memory "
"(event_id, player_id, npc_id, kind, summary, trust_delta, turn) "
"VALUES (?, ?, ?, ?, ?, ?, ?)"
)
gift = ("e-gift", "p7", "merchant", "gift", "赠送药草", 12, 8)
promise = ("e-promise", "p7", "merchant", "promise", "承诺归还地图", 0, 9)
db.execute(insert_sql, gift)
db.execute(insert_sql, gift) # 同一业务事件重投,不重复写入
db.execute(insert_sql, promise)
print("重复送达后信任:", trust(db, "p7", "merchant"))
db.execute(
"UPDATE npc_memory SET summary=? "
"WHERE event_id=? AND player_id=? AND npc_id=? AND deleted=0",
("承诺明早归还地图", "e-promise", "p7", "merchant"),
)
db.execute(
"UPDATE npc_memory SET deleted=1 "
"WHERE event_id=? AND player_id=? AND npc_id=?",
("e-gift", "p7", "merchant"),
)
db.commit()
db.close()
# 重新打开文件后仍能读取有效记录并重算关系
db = sqlite3.connect(path)
print("重开后信任:", trust(db, "p7", "merchant"))
rows = db.execute(
"SELECT summary FROM npc_memory "
"WHERE player_id=? AND npc_id=? AND deleted=0 ORDER BY turn",
("p7", "merchant"),
).fetchall()
print("有效记忆:", [row[0] for row in rows])
db.close()预期输出:
重复送达后信任: 62
重开后信任: 50
有效记忆: ['承诺明早归还地图']第一次送礼将基准信任 50 提高到 62,第二次投递因相同 event_id 被忽略。软删除礼物后,重算结果回到 50;承诺内容已修正,且重新打开文件仍能查到。示例里的玩家和事件 ID 是固定测试值;真实项目应由可信服务生成。
让长期记忆可追责、可删除
INSERT OR IGNORE 适合演示去重,但上线时还要核对重复 ID 对应的原始载荷。如果同一个 ID 携带不同玩家、礼物或关系变化,应该记录冲突并拒绝,而不是静默吞掉异常。多事件同时提交时,写入和关系快照更新要放在同一事务中。
deleted=1 代表业务撤销:记录仍留在数据库供审计,但所有对话召回查询必须排除它。若玩家提出真正的资料删除请求,应依照数据保留规则清除原文、派生摘要、检索索引与缓存;只做软删除不等于彻底删除。
关系变化还需要来源约束。例如敌对事件的负向分数由战斗规则确定,任务承诺的完成状态由任务服务维护。这样即使模型输出了“我们已经和好”,也只能作为待核实的对话建议,不能直接修改持久关系。