游戏 AI / 系统课时

写入玩家关系和重大事件记忆

写入玩家关系和重大事件记忆

玩家送礼、作出关键选择或与 NPC 结仇后,下一次对话必须能找回这些事实。本课把一次性游戏事件写成可查询的长期记忆,演示关系值如何避免重复累加,并处理记忆修订与删除。

学习目标

  • 区分可持久化的游戏事实、关系变化和模型生成的建议。
  • 用稳定事件 ID 实现幂等写入、关系重算与查询。
  • 正确处理承诺修订、事件撤销和彻底删除。

只记录能被游戏确认的事实

长期记忆的写入入口应是服务端已确认的事件,例如背包确实扣除了礼物、任务选择已经提交,或战斗系统确认玩家攻击了该 NPC。模型说出“玩家送了我药草”,不能作为送礼成功的依据。

每条记忆至少关联 event_id、player_id、npc_id、kind、summary 和发生顺序 turn。生产系统还应保留来源任务或交易 ID、事件版本与写入时间,便于查证“是谁在什么时候根据什么事实写入”。

事件类型 典型事实 后续用途
gift 玩家交付一份药草 调整好感,改变称呼
choice 玩家选择隐瞒真相 影响信任与后续话题
hostility 玩家主动攻击 NPC 触发戒备或拒绝服务
promise NPC 承诺归还地图 记录待履行约定

trust_delta 等关系改变量必须由游戏规则计算,不能直接采用模型提供的数值。关系值也不能只在对话历史里保存,否则上下文截断后,人物态度会突然重置。

规划写入、撤销与关系重算链路

同一交易可能因网络重试被上报两次,因此要用稳定的业务事件 ID 去重。事件记录作为事实依据,当前信任值从基准值和仍有效的事件变化量计算,删除或修订后才不会留下错误加分。

NPC 重大事件写入与关系重算数据流

需要区分两类更新:修正记忆的文本描述,不应改变已确认的交易事实;撤销整个事件,则必须同步撤销它带来的关系变化。下面用 SQLite 将这两条规则直接落实到查询条件。

用 SQLite 验证幂等、修订和撤销

示例仅依赖 Python 标准库。在临时目录创建真正的 SQLite 文件,并在关闭连接后重新打开,以验证不是只保存在进程内存中。生产环境应改用受备份保护的持久目录,不要使用临时目录。

python
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()

预期输出:

text
重复送达后信任: 62
重开后信任: 50
有效记忆: ['承诺明早归还地图']

第一次送礼将基准信任 50 提高到 62,第二次投递因相同 event_id 被忽略。软删除礼物后,重算结果回到 50;承诺内容已修正,且重新打开文件仍能查到。示例里的玩家和事件 ID 是固定测试值;真实项目应由可信服务生成。

让长期记忆可追责、可删除

INSERT OR IGNORE 适合演示去重,但上线时还要核对重复 ID 对应的原始载荷。如果同一个 ID 携带不同玩家、礼物或关系变化,应该记录冲突并拒绝,而不是静默吞掉异常。多事件同时提交时,写入和关系快照更新要放在同一事务中。

deleted=1 代表业务撤销:记录仍留在数据库供审计,但所有对话召回查询必须排除它。若玩家提出真正的资料删除请求,应依照数据保留规则清除原文、派生摘要、检索索引与缓存;只做软删除不等于彻底删除。

关系变化还需要来源约束。例如敌对事件的负向分数由战斗规则确定,任务承诺的完成状态由任务服务维护。这样即使模型输出了“我们已经和好”,也只能作为待核实的对话建议,不能直接修改持久关系。

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

目录与阅读设置

阅读设置

17

记录一个想法

写入玩家关系和重大事件记忆

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

登录哪都通