docs: record ops companion VM deployment

这个提交存在于:
YokiiroBW 2026-07-25 01:46:37 +08:00
父节点 0e2848db14
当前提交 12a2fd0ade

查看文件

@ -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`。