docs: record Q5 VM deployment acceptance

这个提交存在于:
YokiiroBW 2026-07-25 23:41:55 +08:00
父节点 a8598e755d
当前提交 17d171a5c8
共有 2 个文件被更改,包括 24 次插入 和 0 次删除

查看文件

@ -68,3 +68,17 @@
- Runtime result: `astrbot.service active`, `NRestarts=0`, plugin version `1.6.2-ops.2`, Memory Archivist reported `available=True search=True`.
- VM validation: `tests.test_calendar_bridge` and `tests.test_temporal_context` ran `5 tests` and passed.
- Rollback: restore the backup plugin directory above while keeping the independent data directory unchanged, then restart `astrbot.service`.
## Q5 用户记忆硬边界部署验收 — a8598e7(2026-07-25)
- Forgejo:`origin/ops-main` 已推进到 `a8598e7`,修复 Q5 首次部署暴露的旧库索引迁移顺序问题。
- 发布包:`/tmp/memory-q5-a8598e7.tar.gz`,本地与 VM SHA-256:`f4d11d3812d6dc66208732a9be6e72a511202b68f7c36edfbab6bd8c78931e82`。
- 部署备份:`/var/lib/astrbot/ops-replace-backups/20260725-2359-q5-a8598e7/plugin-before`。
- 数据保护:`/var/lib/astrbot/data/plugin_data/astrbot_plugin_memory_companion_ops` 保留,未删除数据库、WAL、SHM 或独立数据目录。
- 运行状态:`astrbot.service active`,`NRestarts=0`。
- 插件日志:`astrbot_plugin_memory_companion_ops (1.6.2-ops.2)` 成功加载,数据目录正确。
- Archivist:`source=memory_companion version=1.6.2-ops.2 available=True search=True`。
- VM smoke:使用 AstrBot 实际 Python 对 Q5 源码只读编译通过,用户记忆合同输出 `Q5_SMOKE_OK user_memory`。
- VM pytest:运行时未提供 `pytest`,因此未宣称 VM pytest 全量通过;本地排除普通陪伴宿主依赖的全量 `142 tests` 通过。
- 回滚:停止服务后恢复上述 `plugin-before`,保持 `plugin_data/astrbot_plugin_memory_companion_ops` 不变,再启动并复核服务与 Archivist。

查看文件

@ -115,3 +115,13 @@
- 修复或规避:将域索引创建移动到 `_ensure_memory_columns_sync()` 之后;增加真实 Q4 schema 去掉单字段的升级测试;不删除或重建用户数据目录。
- 预防规则:任何新增数据库列必须先完成幂等字段迁移,再创建索引、触发器和查询约束;部署验收必须看插件加载日志和 Bridge 可用性,不能只看 systemd active。
- 验证证据:本地旧库迁移测试通过;待修复提交重新部署后复核插件加载、Archivist capability、服务状态和数据目录。
## 2026-07-25 — Q5 修复版 VM 验收完成
- 阶段:Q5 修复部署与最终验收
- 类型:部署 / 测试 / 环境
- 现象:修复版需要确认不只是 systemd 存活,而是插件真正加载并被 Archivist 发现。
- 根因:AstrBot 会在插件构造阶段捕获初始化错误,服务仍可保持 active,单看 systemd 会漏报插件失效。
- 修复或规避:部署后检查插件启动日志、数据目录、Archivist capability、服务重启次数,并用 AstrBot 实际 Python 做只读编译和合同 smoke test。
- 预防规则:VM 验收必须同时满足服务 active、目标插件加载、Bridge/Archivist 可用、数据目录保留和无新增 traceback;pytest 不可用时必须明确标注而不是伪造通过。
- 验证证据:提交 `a8598e7`;插件 `1.6.2-ops.2` loaded;`available=True search=True`;`NRestarts=0`;`Q5_SMOKE_OK user_memory`;部署包 SHA-256 与 VM 一致。