docs: record Q4 VM acceptance
这个提交存在于:
父节点
8d21776528
当前提交
b227a7e02d
共有 2 个文件被更改,包括 59 次插入 和 1 次删除
58
docs/Q4_VM部署验收记录.md
普通文件
58
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 定向测试和启动加载证据完成插件级验收。
|
||||
|
|
@ -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`。
|
||||
- 验证证据:时间合同测试 13 项通过;非宿主依赖的 unittest 130 项通过;`compileall` 通过;数据库无需迁移,版本升至 `1.6.2-ops.2`。VM 定向测试 `20 passed`,服务 `active` 且 `NRestarts=0`,Archivist 已发现 `1.6.2-ops.2`。
|
||||
正在加载…
添加表格
在新工单中引用