2026-07-26 00:05:56 +08:00
|
|
|
|
# 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 自有数据删除操作。
|
2026-07-26 00:14:02 +08:00
|
|
|
|
|
|
|
|
|
|
## 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 已完成。前端和数据库仍按既定计划暂不改造。
|