# Q7 后端接口收口与 VM 验收记录 ## 目标 在不修改前端、不切换数据库的前提下,先把运维版陪伴插件的 Bot 自有存储、用户记忆边界和真实日程对账整理成稳定的只读后端契约,为后续前端统一改造准备接口。 ## Q7 阶段结果 ### Q7.0 数据边界复核 - Bot 日程、人格、创作、梦境、自我时间线和主动行为归入 `bot_self`。 - 用户记忆继续通过独立记忆插件保存。 - Bot 自有数据不作为用户记忆写入。 - 旧数据迁移继续采用预览和非破坏性隔离。 ### Q7.1 总览接口 `/overview` 新增: - `bot_self` - `memory_boundary` - `agenda_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.py` - `page_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 复核: 1. AstrBot 服务保持 `active`,重启次数不增加。 2. 运维陪伴插件正常加载。 3. `/overview` 能返回三个新对象。 4. Bot 自有摘要能读取 `bot_self_store`。 5. 记忆边界接口返回用户数据专用策略。 6. 日程对账接口能返回计划、实际和历史分区。 7. 迁移预览返回 `preview_only`,不删除原数据。 8. 记忆插件目录和数据库保持不变。 ## 暂不包含 - 前端页面改造; - 主存储切换 SQLite; - World Server 接入; - 任意 Bot 自有数据删除操作。