docs: record ops deployment validation pitfalls

这个提交存在于:
YokiiroBW 2026-07-24 22:17:41 +08:00
父节点 234030be2e
当前提交 8722ce746d

查看文件

@ -118,3 +118,23 @@
- 保留:旧 LivingMemory 迁移代码暂不立即删除,待 Q9 清理遗留依赖时移除;不作为运行时依赖。 - 保留:旧 LivingMemory 迁移代码暂不立即删除,待 Q9 清理遗留依赖时移除;不作为运行时依赖。
- 影响:Memory Archivist 只联动 `astrbot_plugin_memory_companion_ops`,不再设计 LivingMemory 回退路径。 - 影响:Memory Archivist 只联动 `astrbot_plugin_memory_companion_ops`,不再设计 LivingMemory 回退路径。
- 验证:运维人格仍通过 compileall;MemoryCompanion 运行时探测和归档 Bridge 测试保持通过。 - 验证:运维人格仍通过 compileall;MemoryCompanion 运行时探测和归档 Bridge 测试保持通过。
## 2026-07-24 — VM 生产仍是普通版,不能提前宣称运维版验收
- 阶段:Q2 VM 只读验收
- 类型:部署 / API契约 / 环境
- 现象:本地运维版已完成 Q1/Q2,但 VM 上未发现 `_ops` 插件目录,因此无法执行 `/mcomp runtime` 或验证 Archivist 的运维 Bridge 发现。
- 根因:源码完成、Forgejo 推送和生产部署是三个独立状态;不能用本地提交或普通版插件在线来代表运维版已加载。
- 修复或规避:只读确认 AstrBot `4.26.6`、systemd active、`NRestarts=0`、普通版插件和 Archivist 状态;不覆盖普通版目录,不重启生产,不绕过管理认证;记录缺口并等待单独部署验收。
- 预防规则:任何“实机验收通过”必须同时具备目标插件目录、启动导入证据、命令或 Bridge 返回结果;缺一项只能标记为“部署前置未完成”。
- 验证证据:`Q2_VM只读验收记录.md`;SSH 只读检查于 2026-07-24 21:49 CST 完成。
## 2026-07-24 — Q3 事件合同必须在启动后重新发现 Bridge
- 阶段:Q3 运维事件与数据模型、VM 部署验收
- 类型:API契约 / 部署 / 功能行为
- 现象:两个 ops 插件已成功加载,但 Memory Archivist 初始仍报告 `source=unavailable`。
- 根因:Archivist 在 `__init__` 阶段解析记忆源,早于 MemoryCompanion 完成插件实例化;`on_astrbot_loaded` 只探测旧适配器,没有重新解析。
- 修复或规避:在宿主加载完成 Hook 中重新调用 `resolve_memory_source`;同时优先复用当前进程已加载的 ops 模块,避免重复导入造成空 Bridge。
- 预防规则:跨插件发现不能只测试“模块能否 import”;必须验证插件生命周期顺序、Bridge 实例是否已初始化和实机 capability 返回。
- 验证证据:VM 日志 `source=memory_companion version=1.6.2-ops.1 available=True search=True`;AstrBot `4.26.6`、`NRestarts=0`。