diff --git a/docs/Q4_VM部署验收记录.md b/docs/Q4_VM部署验收记录.md index 6390659..84d6105 100644 --- a/docs/Q4_VM部署验收记录.md +++ b/docs/Q4_VM部署验收记录.md @@ -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。 diff --git a/docs/运维记忆错题本.md b/docs/运维记忆错题本.md index 7079a95..9a70fea 100644 --- a/docs/运维记忆错题本.md +++ b/docs/运维记忆错题本.md @@ -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 一致。