astrbot_plugin_private_comp.../docs/M6日程拆分与陪伴插件调整评估.md

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.py
  • astrbot_plugin_memory_companion-main/core/service.py
  • astrbot_plugin_memory_companion-main/core/bridge.py
  • astrbot_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.py
  • astrbot_plugin_memory_companion-main/tests/test_calendar_bridge.py

2. 陪伴插件已经具备的能力

源码位置:

  • astrbot_plugin_private_companion-main/calendar_system.py
  • astrbot_plugin_private_companion-main/agenda_contracts.py
  • astrbot_plugin_private_companion-main/agenda_runtime.py
  • astrbot_plugin_private_companion-main/bot_self_store.py
  • astrbot_plugin_private_companion-main/memory_companion_adapter.py
  • astrbot_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() 会:

  1. 先写 bot_self_store;
  2. 再根据 kind 映射成 bot_* 类型;
  3. 通过 record_bot_personal_memory() 写入记忆插件;
  4. 失败时保留本地副本。

这个链路是正确的,但目前不同事件的 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 稳定后再切换历史区域,避免一次改动影响运行态。

六、记忆插件侧需要配合的调整

  1. 增加统一 Bot 个人记录标准化,不让不同调用方各自定义字段。
  2. 固定 plan/observed/reconciled/snapshot/diary 的生命周期和真实性字段。
  3. 增加 current、history、creative、subjective、locked_frame 五类 Profile。
  4. 将 /companion/personal-memory 明确为只读聚合,并返回 readonly=true、memory_domain=bot_self_schedule。
  5. 增加普通私聊、群聊、用户事实查询、上下文注入四类污染回归测试。
  6. 对旧 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个人记忆与四段式日程联动.md
  • astrbot_plugin_memory_companion-main/core/bot_personal.py
  • astrbot_plugin_memory_companion-main/core/service.py
  • astrbot_plugin_memory_companion-main/core/bridge.py
  • astrbot_plugin_memory_companion-main/page_api.py
  • astrbot_plugin_memory_companion-main/tests/test_bot_personal_memory.py
  • astrbot_plugin_private_companion-main/calendar_system.py
  • astrbot_plugin_private_companion-main/agenda_contracts.py
  • astrbot_plugin_private_companion-main/agenda_runtime.py
  • astrbot_plugin_private_companion-main/bot_self_store.py
  • astrbot_plugin_private_companion-main/memory_companion_adapter.py
  • astrbot_plugin_private_companion-main/planning.py
  • astrbot_plugin_private_companion-main/docs/Q8前端改造与验收记录.md