2.2 KiB
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 断言已调整为新合同;普通陪伴分支未修改。