astrbot_plugin_memory_compa.../docs/Q5用户记忆硬边界实施说明.md

2.2 KiB

Q5 用户记忆硬边界实施说明

日期:2026-07-25 目标:运维版 astrbot_plugin_memory_companion-main,不修改普通陪伴分支。

已实现

  • 用户记忆合同:record_user_fact、record_user_event、record_user_decision、record_user_summary。
  • 用户主体硬校验:必须是 subject.kind=user,私聊使用 scope=private,群聊使用 scope=group 且必须携带 group_id、证据和来源消息。
  • 域字段:memory_domain=user_memory;旧 Bot 记录、混合记录和未知记录分别进入 bot_self_legacy、shared_or_mixed、unknown,默认不参与检索。
  • 时间字段沿用 Q4.2:occurred_at、created_at、updated_at、来源、精度、时区和估算标记;动态年龄只在序列化/检索时生成。
  • 检索隔离:默认仅允许 user_memory,阻断原因包含 bot_self_domain、mixed_domain、missing_user_subject。
  • 混合总结隔离:包含 Bot 回复材料的总结标记为 shared_or_mixed;Bot 自身事实不再由记忆插件单独保存。
  • 旁路封堵:通用 record_event、Bot 行为、人格生活、主动消息、日历历史公开 Bridge 均失败关闭;tool_remember 改为用户主体,Bot 笔记入口只读拒绝。
  • LivingMemory:导入、修复和命令入口按合同停用,不再作为数据源。
  • 旧数据迁移:提供只读 preview、apply 和 rollback;迁移不删除记录,应用后重建 FTS。
  • 管理 API:增加 /migration/preview、/migration/apply、/migration/rollback,并禁止把非用户域记录改成公开用户可见性。

跨插件联动

陪伴插件只提交用户事实、用户行为和用户决定;Bot 日程、人格、自我时间线和主动行为由陪伴插件内部保存。双方不读取对方数据库。记忆 Bridge 不可用时,陪伴插件的本地日历和正常聊天链路不依赖本插件。

验证边界

  • 私聊和群聊用户记忆分别验证;群聊记录绑定实际发言用户和群 ID。
  • 日历直写路径已退役,公开 Bridge 按 Q5 合同拒绝,能力探测返回 accepts_calendar_events=false。
  • 旧 Q4.2 测试中与 Q5 冲突的 Bridge 断言已调整为新合同;普通陪伴分支未修改。