游戏 AI / 系统课时

角色记忆表该怎么设计

角色记忆表该怎么设计

角色记忆表的目标不是把所有聊天内容永久保存,而是把以后仍有价值的信息记录成可检索、可更新、可淘汰的记忆。设计时要让每条记录都能回答“是谁、记住什么、何时发生、从哪来、重要吗、现在还能不能用”。

学习目标

  • 能为角色记忆设计稳定且可扩展的核心字段
  • 能区分记忆内容、来源和状态,避免把原始文本当成全部数据
  • 能根据时间、重要性和状态决定哪些记忆进入后续生成上下文

先定义一条记忆记录

一条经历记忆需要回答“哪个存档分支里的哪个角色,基于什么证据记住了什么”。以下字段供本节 SQLite 示例使用。

字段 作用 示例
save_id / branch_id / character_id / player_id 限定故事、角色和玩家范围 save-01 / main / npc-elias / player-42
memory_id / summary 稳定标识与短摘要 mem-1832 和“玩家在夜袭中救过 Elias”
occurred_tick 事件发生的分支逻辑时间 73
recorded_at 记录入库的 UTC 时间 2026-10-07T09:30:00Z
source_kind / source_event_id 来源类型和稳定的证据引用 quest / evt-1832
importance 同类记忆的选择优先级 整数 0–100
status / expires_tick 逻辑状态与有效截止 active / 140

来源和时间为什么必须单独保存

只保存“玩家救过我”这种文本,很快就会出现无法解释的问题。系统不知道这条记忆是什么时候发生的,也无法判断它来自任务脚本、玩家对话还是系统事件,更无法在冲突出现时找到可信的依据。

事件发生的 tick、写入的 UTC 时间和来源应独立记录。导入旧存档时,新写入的记录可能描述很早的事件。索引和排序选择的时钟应与问题相符。来源属于可信度的线索;任务事件和玩家自述需要按不同类型处理。生产中可用带相同范围的复合外键关联权威事件表,SQLite 每个连接需显式启用外键约束。SQLite 外键

重要性和状态负责记忆生命周期

重要性不是“这句话写得多漂亮”,而是它对未来行为有多大影响。例如“玩家喜欢蓝色”可能有一定价值,而“玩家杀死了角色的兄长”通常属于高价值事件。后续可以按重要性做排序,只把最有用的记忆送进生成上下文。

状态回答记录当前能否参与生成。记录可标记 active、expired 或 suppressed。查询还需直接检查 expires_tick,从而在清理作业尚未执行时排除到期记录。逻辑失效的记录仍可能存在于主库、缓存和索引中;实际删除及各副本清理是另一个流程。

不要把“重要性”和“状态”合并成一个字段。重要性描述价值,状态描述生命周期;一条低重要性记忆也可能仍然有效,一条高重要性记忆也可能已经失效。

用 SQLite 检查范围与过期边界

将下例保存为 memory_store.py,用 Python 3 运行。示例创建内存数据库,录入同一玩家的主支、另一分支和到期记录,再查询主支。SQL 参数绑定适用于值;范围由已验证的存档会话取得。SQLite CREATE TABLE · Python sqlite3

python
import sqlite3

SCHEMA = """
CREATE TABLE memory (
  save_id TEXT NOT NULL,
  branch_id TEXT NOT NULL,
  character_id TEXT NOT NULL,
  player_id TEXT NOT NULL,
  memory_id TEXT NOT NULL,
  summary TEXT NOT NULL,
  source_kind TEXT NOT NULL CHECK (source_kind IN ('quest', 'dialogue', 'system')),
  source_event_id TEXT NOT NULL,
  occurred_tick INTEGER NOT NULL CHECK (typeof(occurred_tick) = 'integer' AND occurred_tick >= 0),
  recorded_at TEXT NOT NULL,
  importance INTEGER NOT NULL CHECK (typeof(importance) = 'integer' AND importance BETWEEN 0 AND 100),
  status TEXT NOT NULL CHECK (status IN ('active', 'expired', 'suppressed')),
  expires_tick INTEGER CHECK (expires_tick IS NULL OR (typeof(expires_tick) = 'integer' AND expires_tick > occurred_tick)),
  PRIMARY KEY (save_id, branch_id, character_id, player_id, memory_id)
);
CREATE INDEX memory_lookup
  ON memory(save_id, branch_id, character_id, player_id, status,
            importance DESC, occurred_tick DESC, memory_id);
"""


def active_memories(db, scope, tick, limit=5):
    if type(tick) is not int or tick < 0 or type(limit) is not int or not 1 <= limit <= 20:
        raise ValueError("invalid tick or limit")
    return db.execute("""
        SELECT memory_id, summary, source_event_id
        FROM memory
        WHERE (save_id, branch_id, character_id, player_id) = (?, ?, ?, ?)
          AND status = 'active'
          AND occurred_tick <= ?
          AND (expires_tick IS NULL OR expires_tick > ?)
        ORDER BY importance DESC, occurred_tick DESC, memory_id
        LIMIT ?
    """, (*scope, tick, tick, limit)).fetchall()


if __name__ == "__main__":
    db = sqlite3.connect(":memory:")
    db.executescript(SCHEMA)
    scope = ("save-01", "main", "npc-elias", "player-42")
    alternate = (scope[0], "alternate", *scope[2:])
    rows = [
        (*scope, "mem-1832", "夜袭救援", "quest", "evt-1832", 73, "2026-10-07T09:30:00Z", 90, "active", None),
        (*scope, "mem-1880", "临时封门", "system", "evt-1880", 120, "2026-10-07T09:31:00Z", 95, "active", 140),
        (*alternate, "mem-1832", "备用分支结局", "quest", "evt-1990", 80, "2026-10-07T09:32:00Z", 100, "active", None),
    ]
    db.executemany("INSERT INTO memory VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", rows)
    for tick in (139, 140):
        print(tick, [row[0] for row in active_memories(db, scope, tick)])
    db.close()
bash
python memory_store.py
text
139 ['mem-1880', 'mem-1832']
140 ['mem-1832']

示例按重要性和时间提供一个可重复的基础查询。下一课加入当前场景和上下文预算。重要性应由规则或复核得到,生效的任务状态仍从权威任务表读取。

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

目录与阅读设置

阅读设置

17

记录一个想法

角色记忆表该怎么设计

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

登录哪都通