13 KiB
M6 日程拆分与陪伴插件调整评估
- 评估日期:2026-07-25
- 适用分支:
ops-main - 评估对象:运维版陪伴插件、运维版记忆插件
- 目标:把 Bot 日程从“陪伴插件自己保存的一套数据”调整为“陪伴插件负责运行,记忆插件负责长期归档和检索”,不影响普通陪伴分支。
一、先给结论
可行,而且不建议把日程运行代码整体搬走。
最稳妥的拆分方式是:
陪伴插件:现实时间、当前日程、下一项活动、主动消息时机、活动捕获、计划/实际对账、睡前触发
记忆插件:Bot 日程历史、窗口快照、实际活动摘要、对账结果、日记、创作和主观记忆的长期归档与检索
陪伴插件本地 bot_self_store:运行热数据、Bridge 不可用时的降级副本、短期页面读取
用户记忆 user_memory:只保存用户事实,禁止写入 Bot 日程和 Bot 自我记录
M6 不是“删除陪伴插件的日程”,而是“拆开日程的运行责任和长期记忆责任”。
二、已核对的源码事实
1. 记忆插件已经具备的能力
源码位置:
astrbot_plugin_memory_companion-main/core/bot_personal.pyastrbot_plugin_memory_companion-main/core/service.pyastrbot_plugin_memory_companion-main/core/bridge.pyastrbot_plugin_memory_companion-main/page_api.py
已经存在:
- 专属域:
memory_domain=bot_self_schedule - 固定会话:
session_id=bot_personal - 固定可见性:
visibility=bot_self - 专属类型:计划、实际活动、窗口快照、日记、创作、媒体、主观记忆、共同活动等
- 专用 Bridge:
record_bot_personal_memory - 类型化 Bridge 方法:
record_bot_schedule_plan、record_bot_observed_activity、record_bot_window_snapshot等 - 专用检索:
search_bot_personal_memory - 能力探测:
probe_bot_personal_memory_capabilities - 页面接口:
/companion/personal-memory - 记忆域过滤:普通检索不会直接返回
bot_self_schedule
已有测试覆盖专属域、幂等键、普通检索隔离和 Bridge 缺失降级:
astrbot_plugin_memory_companion-main/tests/test_bot_personal_memory.pyastrbot_plugin_memory_companion-main/tests/test_calendar_bridge.py
2. 陪伴插件已经具备的能力
源码位置:
astrbot_plugin_private_companion-main/calendar_system.pyastrbot_plugin_private_companion-main/agenda_contracts.pyastrbot_plugin_private_companion-main/agenda_runtime.pyastrbot_plugin_private_companion-main/bot_self_store.pyastrbot_plugin_private_companion-main/memory_companion_adapter.pyastrbot_plugin_private_companion-main/planning.py
已经存在:
- 现实日期时间和
Asia/Shanghai时区处理 - 四段式时间窗:深夜、早晨、下午、晚上
- 计划项、日历事件、实际活动和窗口快照
- 活动捕获:
ActivityCapture - 计划/实际对账:
unified_agenda及相关合同 - 睡前日记触发:
_agenda_maintenance_tick - 本地 Bot 专属存储:
bot_self_store - 本地幂等写入:
record_bot_self_entry - 记忆插件不可用时的本地降级
- 记忆插件可用时的专用远端写入
陪伴侧的远端写入映射已经存在:
| 陪伴事件 | 记忆类型 |
|---|---|
| 每日日程 | bot_schedule_plan |
| 窗口快照 | bot_window_snapshot |
| 日程细化片段 | bot_detail_fragment |
| 日历事件 | bot_calendar_event |
| 创作进度 | bot_creative_work |
| 梦境/主观片段 | bot_subjective_memory |
| 主动消息 | bot_proactive_message |
| 图片/相册 | bot_media_memory |
三、当前实现与 M6 合同的差距
| 项目 | 当前状态 | 判断 | 调整要求 |
|---|---|---|---|
| 日程运行归属 | 陪伴插件负责 | 正确 | 保留,不搬到记忆插件 |
| 日程长期归档 | 陪伴本地写入后再 Bridge 归档 | 方向正确 | 统一每种事件的类型、字段和幂等键 |
| Bot 自有本地存储 | bot_self_store 已存在 |
正确 | 明确为热数据/降级副本,不作为用户记忆 |
| Bot 个人记忆写入 | 已有通用入口和类型化入口 | 基础完成 | 增加 M6 标准化字段校验 |
| 四段式窗口 | 陪伴侧已有 | 基础完成 | 远端记录必须稳定保存 date/window |
| 计划与实际分层 | 本地合同已有 planned/real 和证据等级 |
基础完成 | 远端写入禁止把计划写成 observed/completed |
| 计划/实际对账 | 本地有快照和历史数组 | 部分完成 | 增加正式 bot_schedule_reconciliation 归档,而不是只塞进快照 |
| 睡前日记 | 本地触发和保存存在 | 部分完成 | 确认日记通过 bot_daily_diary 归档,并保持幂等 |
| Bot 专用检索 Profile | 目前主要是通用 search_bot_personal_memory |
缺失 | 增加 current/history/creative/subjective/locked-frame 语义层 |
| Locked Frame API | 目前有组合接口 /companion/personal-memory |
部分完成 | 后续补齐只读摘要、日程、时间线、创作、相册、日记等稳定视图 |
source_refs |
多数调用方已有,但结构不统一 | 部分完成 | 强制为字符串数组并限制长度 |
occurred_at |
由事件字段或当前时间补齐 | 基础完成 | 计划使用生成时间,实际活动使用发生时间,日记使用结算时间 |
certainty |
可能存在于陪伴本地 payload,但记忆服务未统一提升为合同字段 | 缺失 | 计划、真实活动、推测候选必须有明确 certainty |
version |
本地和记忆记录各自有版本 | 部分完成 | 远端更新时保留创建时间和版本链 |
| 普通用户检索隔离 | 记忆侧已有域过滤 | 基础完成 | 增加页面、Bridge 和上下文注入三条路径回归测试 |
| 远端失败降级 | 陪伴侧保留本地记录 | 正确 | 增加失败计数和待补写标记,避免静默丢失长期归档 |
四、最重要的实现问题
1. “拆出来”不能删除本地日程
busy_reply_gate.py、state_views.py、scene_context.py、主动消息逻辑和日程生成器都直接读取陪伴插件的当前日程。若直接改成每轮从记忆插件查询,会产生:
- 每轮对话增加 Bridge/SQLite 查询;
- 记忆插件短暂不可用时当前状态消失;
- 主动消息和休息闸门变成依赖长期归档;
- 计划、实际和当前活动的实时状态延迟。
因此当前日程必须继续由陪伴插件掌握,记忆插件只接收归档事件和提供历史检索。
2. 远端归档已经接入,但字段还不够严格
memory_companion_adapter.py 的 _memory_companion_record_bot_self_local() 会:
- 先写
bot_self_store; - 再根据
kind映射成bot_*类型; - 通过
record_bot_personal_memory()写入记忆插件; - 失败时保留本地副本。
这个链路是正确的,但目前不同事件的 payload 结构不一致。例如计划、窗口快照、创作进度使用的字段集合不同,部分嵌套对象会在通用清洗时被压扁为字符串或丢弃。M6 应增加统一的事件标准化函数,而不是让记忆插件猜字段。
3. 记忆插件目前有专用检索,但没有完整 Profile 层
当前 search_bot_personal_memory() 能按域、会话、可见性和类型过滤,但还没有把以下语义固化:
bot_schedule_current:当前窗口、最近实际活动、未完成事项;bot_schedule_history:窗口快照、对账、日记和历史活动;bot_creative:创作、阅读、媒体和作品关联;bot_subjective:主观记忆、梦境和连续性线索;locked_frame_personal:只读聚合,不暴露底层写入口。
这部分应在记忆插件侧完成,陪伴插件只调用明确的方法,不自行拼底层查询。
4. 现有兼容数据不能立即删除
daily_plan、calendar_events、observed_activities、window_snapshots、bot_diaries 等仍被陪伴运行时直接读取。它们属于当前运行态和迁移兼容数据,不能在 M6 第一轮删除。
处理顺序应是:
继续双写 -> 观察期核对数量 -> 页面改读稳定视图 -> 再评估历史字段迁移 -> 最后才考虑缩减旧数组
五、建议的陪伴插件调整队列
M6.1.3-A:陪伴侧统一归档适配器
新增一个面向 M6 的归档适配层,统一处理:plan、observed_activity、reconciliation、window_snapshot、daily_diary、calendar_event、creative_work、media_memory、subjective_memory。
每种记录至少包含:
record_id
memory_type
date
window
occurred_at
source_refs
certainty
evidence_level
status
version
idempotency_key
计划必须使用 source_kind=planned、evidence_level=L0;真实活动必须使用 source_kind=real;推测内容只能使用 source_kind=simulated 或 projection,不能伪装成已发生。
M6.1.3-B:把对账从“快照里的字段”提升为正式记录
窗口快照仍然保留,但每个窗口结束时额外写一条 bot_schedule_reconciliation,至少说明计划完成、延期、跳过、部分完成、无计划实际活动,以及关联的活动 ID、计划 ID、生成时间和版本。
M6.1.3-C:远端写入失败的补偿机制
当前失败时只记录日志并保留本地数据。建议在 bot_self_store 增加:archive_sync_status、archive_retry_count、archive_last_error(脱敏)、archive_next_retry_at。
这样不会把“本地写成功、长期归档失败”误判为完全成功,也方便 VM 观察期补写。
M6.1.3-D:陪伴侧调用专用方法,不调用通用入口
优先调用 record_bot_schedule_plan、record_bot_observed_activity、record_bot_schedule_reconciliation、record_bot_window_snapshot、record_bot_daily_diary、record_bot_creative_work、record_bot_media_memory、record_bot_subjective_memory。保留 record_bot_personal_memory 作为兼容底层接口,但业务代码不再直接依赖它。
M6.1.3-E:上下文读取分层
- 当前时段、当前活动、下一项日程:读本地运行态;
- 最近历史、跨日时间线、睡前回顾:调用记忆插件 Profile;
- 记忆插件不可用:使用本地
bot_self_store最近记录; - 普通用户聊天:只调用用户记忆接口,不读取 Bot 专属域。
M6.1.3-F:前端保持“两块内容”
Q8 页面后续不应把两侧数据显示成一张表:当前运行态来自陪伴插件,长期归档/Locked Frame 来自记忆插件只读接口。当前页面可以继续使用现有 /bot-self/* 和 /companion/personal-memory,待 Profile API 稳定后再切换历史区域,避免一次改动影响运行态。
六、记忆插件侧需要配合的调整
- 增加统一 Bot 个人记录标准化,不让不同调用方各自定义字段。
- 固定
plan/observed/reconciled/snapshot/diary的生命周期和真实性字段。 - 增加
current、history、creative、subjective、locked_frame五类 Profile。 - 将
/companion/personal-memory明确为只读聚合,并返回readonly=true、memory_domain=bot_self_schedule。 - 增加普通私聊、群聊、用户事实查询、上下文注入四类污染回归测试。
- 对旧
schedule_fragment、bot_self_legacy只做预览和迁移标记,不直接删除。
七、暂时不要做的事
- 不删除陪伴插件的
daily_plan、calendar_events、observed_activities等运行态字段。 - 不让每轮消息都去记忆插件查询当前日程。
- 不把完整聊天、Prompt、原始媒体写入长期 Bot 记忆。
- 不把用户共同活动自动复制成 Bot 已完成事实。
- 不恢复已经删除的娱乐模块。
- 不因为 M6 开始就直接覆盖当前 VM 的 Q8 部署。
- 不在观察期内删除旧数据或关闭本地降级。
八、最终可执行结论
当前可以进入 M6.1.3 陪伴侧适配,但第一步应是“统一归档合同和补偿状态”,不是删除本地日程。
推荐顺序:
1. 冻结当前运行态字段
2. 统一陪伴侧 Bot 归档 payload
3. 正式写入 observed/reconciliation/diary 类型
4. 加入远端归档失败补偿
5. 增加 Profile 调用适配
6. 更新 Q8 历史区域
7. 本地、VM、回滚和跨域污染验收
8. 观察一段时间后再决定是否减少旧历史数组
评估结果:可实施,风险可控;不建议现在把 Bot 日程全部搬到记忆插件,也不建议现在删除陪伴插件本地日程。
九、依据文件
跨插件改造任务/给记忆插件窗口/Q6.1-Locked Frame Bot个人记忆与四段式日程联动.mdastrbot_plugin_memory_companion-main/core/bot_personal.pyastrbot_plugin_memory_companion-main/core/service.pyastrbot_plugin_memory_companion-main/core/bridge.pyastrbot_plugin_memory_companion-main/page_api.pyastrbot_plugin_memory_companion-main/tests/test_bot_personal_memory.pyastrbot_plugin_private_companion-main/calendar_system.pyastrbot_plugin_private_companion-main/agenda_contracts.pyastrbot_plugin_private_companion-main/agenda_runtime.pyastrbot_plugin_private_companion-main/bot_self_store.pyastrbot_plugin_private_companion-main/memory_companion_adapter.pyastrbot_plugin_private_companion-main/planning.pyastrbot_plugin_private_companion-main/docs/Q8前端改造与验收记录.md