diff --git a/docs/运维陪伴错题本.md b/docs/运维陪伴错题本.md index ae3e4cb..f3254d2 100644 --- a/docs/运维陪伴错题本.md +++ b/docs/运维陪伴错题本.md @@ -73,3 +73,33 @@ - 修复或规避:从 `HEAD` 恢复源码,并使用 UTF-8 显式读写;新增文件也统一 UTF-8。 - 预防规则:修改中文源码时禁止默认编码读写;写回后立即运行 `py_compile` 和最小测试。 - 验证证据:核心文件恢复为可编译状态,14 项单元测试通过。 + +## 2026-07-24 — 运维陪伴插件已完成 VM 部署验收 + +- 阶段:Q4.2 运维陪伴部署 +- 类型:部署 / 环境 / API契约 +- 现象:本地提交和 Forgejo 推送完成后,需要确认 VM 只替换运维陪伴插件,不影响普通陪伴插件和运维记忆数据。 +- 根因:插件代码目录、插件数据目录、普通陪伴插件目录和运行中的 AstrBot 服务是不同边界;只看本地 Git 状态不足以证明实机已生效。 +- 修复或规避:按提交 `0e2848d` 生成归档,核对本地/VM SHA-256;停服前备份活动插件与运维数据;仅移动替换 `astrbot_plugin_private_companion_ops`,保留普通插件和数据;启动后核对加载日志、关键文件、服务状态和重启次数。 +- 预防规则:运维版部署必须使用精确提交归档;先备份再替换;禁止覆盖普通陪伴插件或直接读取/改写记忆数据库;必须保留可回滚目录。 +- 验证证据:VM 备份 `/var/lib/astrbot/ops-replace-backups/private-companion-ops-20260725-014151`;日志确认 `5.10.4-ops.1` 加载、主动消息循环启动、WAL 优化应用;`astrbot.service=active`、`NRestarts=0`;VM AstrBot Python 编译检查通过。 + +## 2026-07-24 — VM 没有系统级 python 命令 + +- 阶段:Q4.2 运维陪伴部署 +- 类型:环境 +- 现象:直接执行 `python -m py_compile` 返回 `python: command not found`。 +- 根因:VM 只通过 AstrBot 的 uv 工具环境提供运行时,不保证系统 PATH 暴露 `python`。 +- 修复或规避:使用 `/var/lib/astrbot/.local/share/uv/tools/astrbot/bin/python` 完成同一检查。 +- 预防规则:VM Python 验证优先读取 systemd 实际启动命令,使用 AstrBot 运行时,不假设系统 PATH。 +- 验证证据:关键文件 VM 编译检查输出 `VM_PYCOMPILE=passed`。 + +## 2026-07-24 — 日记主动任务依赖默认模型 Provider + +- 阶段:Q4.2 运维陪伴部署 +- 类型:环境 / 功能行为 +- 现象:旧进程日志出现 `task=diary provider=default` 未找到可用默认模型 Provider 的警告。 +- 根因:VM 的 AstrBot Provider 配置未提供名为 `default` 的可用模型;不是本次代码归档或目录替换造成的异常。 +- 修复或规避:本次不修改 VM Provider 配置;记录为独立部署后配置项,避免把环境问题混入插件替换。 +- 预防规则:验收主动日记、主动消息等 LLM 任务时,同时检查 Provider 可用性;区分旧日志、当前进程日志和代码回归。 +- 验证证据:部署后新进程加载日志无该错误;服务保持 `active` 且 `NRestarts=0`。