27 行
2.2 KiB
Markdown
27 行
2.2 KiB
Markdown
# 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。
|
||
- 日历历史 Service 内部兼容测试保留,但公开 Bridge 按 Q5 合同拒绝,能力探测返回 `accepts_calendar_history=false`。
|
||
- 旧 Q4.2 测试中与 Q5 冲突的 Bridge 断言已调整为新合同;普通陪伴分支未修改。
|