2.4 KiB
2.4 KiB
Q7 后端接口收口与 VM 验收记录
目标
在不修改前端、不切换数据库的前提下,先把运维版陪伴插件的 Bot 自有存储、用户记忆边界和真实日程对账整理成稳定的只读后端契约,为后续前端统一改造准备接口。
Q7 阶段结果
Q7.0 数据边界复核
- Bot 日程、人格、创作、梦境、自我时间线和主动行为归入
bot_self。 - 用户记忆继续通过独立记忆插件保存。
- Bot 自有数据不作为用户记忆写入。
- 旧数据迁移继续采用预览和非破坏性隔离。
Q7.1 总览接口
/overview 新增:
bot_selfmemory_boundaryagenda_contract
这些字段只返回摘要、状态、数量、时间和迁移预览,不返回可直接修改底层存储的写入口。
Q7.2 只读详情接口
新增页面接口:
/bot-self/summary/bot-self/timeline/bot-self/agenda/bot-self/persona/memory-boundary/status/agenda/reconciliation/migration/bot-self/preview
实现文件:
q7_backend_contracts.pypage_api.py
Q7.3 日程契约
日程接口分别返回:
- 计划项;
- 实际活动;
- 时间窗口快照;
- 对账历史;
- 计划状态统计;
- 当前现实时间和本地时区;
- 计划、实际和 World 来源策略。
计划与实际不会被压成同一条无来源记录。
Q7.4 测试
新增:
tests/test_q7_backend_contracts.py
覆盖:
- Bot 自有存储摘要和命名空间隔离;
- 旧数据迁移预览不修改原始计划;
- 计划、实际、对账历史分离;
- 用户记忆边界为
user_only; - Bot 自有数据外写状态为关闭。
本地验收
python -m unittest discover -s tests -v:32 项通过。- Python
compileall:通过。 git diff --check:通过。
Q7.5 VM 验收计划
提交并部署后需要在 VM 复核:
- AstrBot 服务保持
active,重启次数不增加。 - 运维陪伴插件正常加载。
/overview能返回三个新对象。- Bot 自有摘要能读取
bot_self_store。 - 记忆边界接口返回用户数据专用策略。
- 日程对账接口能返回计划、实际和历史分区。
- 迁移预览返回
preview_only,不删除原数据。 - 记忆插件目录和数据库保持不变。
暂不包含
- 前端页面改造;
- 主存储切换 SQLite;
- World Server 接入;
- 任意 Bot 自有数据删除操作。