# 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。