astrbot_plugin_memory_compa.../docs/Q4_VM部署验收记录.md

7.3 KiB

Q4 VM 部署验收记录

验收日期:2026-07-24(Asia/Shanghai) 目标:agent@192.168.31.215 / AstrBot 4.26.6 提交:8d21776 (feat: add temporal awareness to ops memory) 发布版本:astrbot_plugin_memory_companion_ops 1.6.2-ops.2

1. 发布与备份

  • 发布包由 git archive HEAD 生成,排除了 .git、测试缓存和字节码。
  • 本地与 VM /tmp/memory-q4-8d21776.tar.gz SHA-256 一致:ca99bfdbde5e09f47afdfb955ffc87ef30dad510e9f95b2a57570e754fe56518。
  • 部署前停止 astrbot.service,代码备份位于:/var/lib/astrbot/ops-replace-backups/20260724-2300-q4-8d21776/plugin-before。
  • 记忆数据目录单独保留并备份:/var/lib/astrbot/data/plugin_data/astrbot_plugin_memory_companion_ops。
  • 本次没有数据库迁移;仅替换插件代码目录,记忆数据库和 WAL 未删除。

2. 本地验证

检查项 结果
compileall core tests 通过
Q4 时间合同测试 13 项通过
既有 unittest(排除宿主 astrbot 依赖的 security_cache 收集项) 130 项通过
完整 unittest 入口 131 项运行,1 个已知宿主依赖收集错误;不是本次改造回归
git diff --check 通过

本地宿主依赖缺口:tests/test_security_cache.py 导入 page_api.py 时需要 AstrBot runtime 的 astrbot 包;该项在 VM runtime 中单独执行。

3. VM 运行时验收

  • SSH 只读前检:VM_OK、用户 agent、astrbot.service active、NRestarts=0。
  • 部署后插件目录包含 core/temporal_context.py,metadata 版本为 1.6.2-ops.2。
  • AstrBot 启动日志确认:astrbot_plugin_memory_companion_ops (1.6.2-ops.2) 已加载。
  • 启动日志确认数据目录仍为 /var/lib/astrbot/data/plugin_data/astrbot_plugin_memory_companion_ops。
  • Archivist 启动日志确认:source=memory_companion version=1.6.2-ops.2 available=True search=True。
  • VM 定向测试:20 passed, 1 warning;唯一警告是 AstrBot register_star 弃用提示,不影响本次功能。
  • VM 完整回归:使用 PYTHONPATH=/var/lib/astrbot/data/plugins/astrbot_plugin_private_companion_ops:.:core 匹配双插件测试导入合同,结果 155 passed, 1 warning。未设置该路径时的 2 个迁移测试失败是既有导入路径问题,不是本次改造回归。
  • 部署后服务:active;NRestarts=0。

4. Q4 场景结论

  • 隔夜天气:动态结果带 age_label=overnight、relative_label=昨晚、age_display=约 11 小时、crossed_date=true;天气 TTL 超时后标记 stale。
  • 长时间未回复:bridge_get_reply_delay() 返回 delay_label=overnight;私聊开放话题可建议承认延迟,群聊默认不建议输出私密等待情绪。
  • 运维状态:时间感知层只标记旧事实的新鲜度,不把记忆当作当前 Controller 状态。
  • 长期创作/偏好:保留历史背景,不因年龄自动标记为实时失效。

5. 回滚

  1. 停止 astrbot.service。
  2. 将 /var/lib/astrbot/ops-replace-backups/20260724-2300-q4-8d21776/plugin-before 恢复为活动插件目录。
  3. 保持 plugin_data/astrbot_plugin_memory_companion_ops 不变;如需回退数据库,使用同一备份下的 data-before,先做 SQLite 一致性检查。
  4. 启动服务并复核 active、NRestarts、插件版本和 Archivist source。

6. 来源

  • 本地源码与测试:astrbot_plugin_memory_companion-main/,提交 8d21776。
  • Q4 要求:Q4_记忆插件时间感知改造要求.md。
  • 平台说明:astrbot_plugin_memory_companion-main/docs/时间感知兼容说明.md。
  • VM 实证:SSH 服务状态、插件启动日志、Archivist 日志和 VM runtime pytest 输出。
  • 不可用/未执行:未通过真实 QQ/Telegram 用户消息触发人工对话;本次以 Bridge 合同、VM runtime 定向测试和启动加载证据完成插件级验收。

Deployment writeback - bcd9d9a (2026-07-24)

  • Forgejo push: origin/ops-main advanced to bcd9d9a (feat: add calendar-aware ops memory history).
  • Package: local and VM /tmp/memory-bcd9d9a.tar.gz SHA-256 014fd492b68c47e67d5f3616fd33f5948011c0c188e56d297e942c8e4f4e9bb4.
  • Deployment target: agent@192.168.31.215, active plugin /var/lib/astrbot/data/plugins/astrbot_plugin_memory_companion_ops.
  • Backup: /var/lib/astrbot/ops-replace-backups/20260724-2350-bcd9d9a/plugin-before.
  • Data preservation: /var/lib/astrbot/data/plugin_data/astrbot_plugin_memory_companion_ops retained; database, WAL and SHM were not removed.
  • 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。

Q6 只读用户事实 Bridge VM 部署验收 — 7530774(2026-07-25)

  • Forgejo:origin/ops-main 已推进到 7530774(feat: add read-only user fact bridge)。
  • 发布包:/tmp/memory-q6-7530774.tar.gz。
  • 本地与 VM SHA-256:766dcb98bbd6a4598478653db4ab03dad1df24ec8f74f12e35ef5ced67e07bd8。
  • 部署备份:/var/lib/astrbot/ops-replace-backups/20260726-022018-q6-7530774/plugin-before;该目录名由 VM 主机时间生成。
  • 替换范围:仅替换 /var/lib/astrbot/data/plugins/astrbot_plugin_memory_companion_ops。
  • 数据保护:/var/lib/astrbot/data/plugin_data/astrbot_plugin_memory_companion_ops 保留,memory_companion.db 存在,未执行数据库迁移。
  • 运行状态:astrbot.service active,NRestarts=0,最近 10 分钟日志 Traceback=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。
  • Q6 VM smoke:Q6_VM_SMOKE_OK;VM compileall 通过。
  • 回滚:停止服务后恢复上述 plugin-before,保持独立 plugin_data 不变,再启动并复核服务与 Archivist。
  • 未执行:VM pytest;VM 当前 Python 环境未安装 pytest。