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

257 行
13 KiB
Markdown

2026-07-26 03:14:03 +08:00
# M6 日程拆分与陪伴插件调整评估
- 评估日期:2026-07-25
- 适用分支:`ops-main`
- 评估对象:运维版陪伴插件、运维版记忆插件
- 目标:把 Bot 日程从“陪伴插件自己保存的一套数据”调整为“陪伴插件负责运行,记忆插件负责长期归档和检索”,不影响普通陪伴分支。
## 一、先给结论
**可行,而且不建议把日程运行代码整体搬走。**
最稳妥的拆分方式是:
```text
陪伴插件:现实时间、当前日程、下一项活动、主动消息时机、活动捕获、计划/实际对账、睡前触发
记忆插件: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 第一轮删除。
处理顺序应是:
```text
继续双写 -> 观察期核对数量 -> 页面改读稳定视图 -> 再评估历史字段迁移 -> 最后才考虑缩减旧数组
```
## 五、建议的陪伴插件调整队列
### M6.1.3-A:陪伴侧统一归档适配器
新增一个面向 M6 的归档适配层,统一处理:`plan`、`observed_activity`、`reconciliation`、`window_snapshot`、`daily_diary`、`calendar_event`、`creative_work`、`media_memory`、`subjective_memory`。
每种记录至少包含:
```text
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 陪伴侧适配**,但第一步应是“统一归档合同和补偿状态”,不是删除本地日程。
推荐顺序:
```text
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`