From b227a7e02d39267474c66a32cb76c74e90b2f194 Mon Sep 17 00:00:00 2001 From: YokiiroBW Date: Fri, 24 Jul 2026 23:12:02 +0800 Subject: [PATCH] docs: record Q4 VM acceptance --- docs/Q4_VM部署验收记录.md | 58 +++++++++++++++++++++++++++++++++++++++ docs/错题本.md | 2 +- 2 files changed, 59 insertions(+), 1 deletion(-) create mode 100644 docs/Q4_VM部署验收记录.md diff --git a/docs/Q4_VM部署验收记录.md b/docs/Q4_VM部署验收记录.md new file mode 100644 index 0000000..2e51d15 --- /dev/null +++ b/docs/Q4_VM部署验收记录.md @@ -0,0 +1,58 @@ +# 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` 弃用提示,不影响本次功能。 +- 部署后服务:`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 定向测试和启动加载证据完成插件级验收。 \ No newline at end of file diff --git a/docs/错题本.md b/docs/错题本.md index d64c1f7..5d0a32a 100644 --- a/docs/错题本.md +++ b/docs/错题本.md @@ -180,4 +180,4 @@ - 根因:时间跨度、跨日、事实有效期和时间来源没有统一合同;如果把“距今多久”持久化,下一次读取就会过期。 - 修复或规避:新增 `core/temporal_context.py`,在检索/注入/Bridge/Archivist 出口动态生成 `temporal`;metadata 只补来源、时区、精度和估算标记;增加 `bridge_get_reply_delay()`,群聊默认不产生私密等待情绪。 - 预防规则:不得用 `last_accessed_at` 代替事件时间;不得把 `age_seconds` 写入数据库;运维当前状态必须重新取 Controller 事实,旧记忆只作历史背景。 -- 验证证据:时间合同测试 13 项通过;非宿主依赖的 unittest 130 项通过;`compileall` 通过;数据库无需迁移,版本升至 `1.6.2-ops.2`。 \ No newline at end of file +- 验证证据:时间合同测试 13 项通过;非宿主依赖的 unittest 130 项通过;`compileall` 通过;数据库无需迁移,版本升至 `1.6.2-ops.2`。VM 定向测试 `20 passed`,服务 `active` 且 `NRestarts=0`,Archivist 已发现 `1.6.2-ops.2`。 \ No newline at end of file