astrbot_plugin_private_comp.../docs/Q7后端接口收口与VM验收记录.md

3.3 KiB

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 自有数据删除操作。

Q7.5 实际 VM 验收结果

  • Forgejo 推送提交:cd9d554,已进入 ops-main。
  • VM 替换备份:/var/lib/astrbot/ops-replace-backups/private-companion-ops-q7-cd9d554-20260726-000954。
  • AstrBot 服务:active。
  • NRestarts:0。
  • 运维陪伴插件:astrbot_plugin_private_companion_ops (5.10.4-ops.1) 已加载。
  • 运维记忆插件:astrbot_plugin_memory_companion_ops (1.6.2-ops.2) 已加载。
  • Memory Archivist:available=True search=True。
  • companions.json:存在,仍包含 bot_self_store。
  • 记忆插件数据目录:仍存在,未被覆盖。
  • 新页面 API 受 AstrBot API 认证保护;未授权请求返回 401,正确 API 前缀为 /api/astrbot_plugin_private_companion_ops/page/...。
  • VM 编译验证:使用 PYTHONPYCACHEPREFIX=/tmp/private-companion-q7-pycache 后通过。

Q7 状态

Q7.0–Q7.5 已完成。前端和数据库仍按既定计划暂不改造。