docs: record ops companion deployment acceptance

这个提交存在于:
YokiiroBW 2026-07-26 01:56:15 +08:00
父节点 f4d160ce86
当前提交 868225270d
共有 2 个文件被更改,包括 57 次插入 和 0 次删除

查看文件

@ -0,0 +1,37 @@
# VM 部署验收:运维娱乐功能清理
- 验收日期:2026-07-26
- Git 提交:`f4d160c feat: remove ops entertainment integrations`
- 部署目标:AstrBot VM `agent@192.168.31.215`
- AstrBot 服务:`astrbot.service`
- 运维陪伴插件:`/var/lib/astrbot/data/plugins/astrbot_plugin_private_companion_ops`
- 运维陪伴数据:`/var/lib/astrbot/data/plugin_data/astrbot_plugin_private_companion_ops`
- 运维记忆数据:`/var/lib/astrbot/data/plugin_data/astrbot_plugin_memory_companion_ops`
## 部署过程
1. 使用归档 `/tmp/astrbot_plugin_private_companion_ops-f4d160c.tar.gz`。
2. 停止 `astrbot.service`。
3. 将原插件复制到 `/var/backups/astrbot-plugin-private-companion/20260725T175146Z`。
4. 替换活动插件目录,保留两个插件的数据目录不变。
5. 修正插件目录为 AstrBot 可读权限:目录 `0755`,文件 `0644`。
6. 删除本次部署误生成在插件扫描目录中的同级临时副本。
7. 重启并检查 AstrBot、陪伴插件和记忆插件。
## 验收结果
- `astrbot.service`:`active (running)`。
- `NRestarts`:`0`。
- 运维陪伴插件成功加载,版本:`5.10.4-ops.1`。
- 运维记忆插件成功加载,版本:`1.6.2-ops.2`。
- Memory Archivist 仍使用 `memory_companion` 来源。
- 主动消息循环正常启动。
- SQLite WAL 并发优化正常应用。
- `news_exploration.py`、`qzone_integration.py`、`qzone_media.py` 等已删除模块未进入活动插件目录。
- 两个插件数据目录均保留且可访问。
## 注意事项
- 不要把回滚副本放在 `/var/lib/astrbot/data/plugins/` 下,否则 AstrBot 会把它当作插件尝试加载。
- 从 Windows PowerShell 通过 SSH 发送多行脚本时,避免 BOM/CRLF 混入 shell 命令;本次后续改用单行命令完成权限修正和重启。
- 发布归档需要检查目录权限;本地插件目录若为 `0700`,直接解压后 AstrBot 用户会无法读取 `main.py`。

查看文件

@ -184,3 +184,23 @@ docs\运维陪伴错题本.md
- 修复或规避:先移除 Mixin/导入/路由,再删除独立文件;保留旧数据命名空间但不再执行外部调用;主动动作开关强制关闭。
- 预防规则:删除插件能力必须同时检查导入、Mixin、路由、schema、命令、后台任务和页面脚本。
- 验证证据:独立模块文件已删除;已删除模块导入和 qzone 页面脚本残留扫描无结果;源码编译通过。
## 2026-07-26 — VM 发布归档继承了不可读目录权限
- 阶段:部署
- 类型:部署 / 权限
- 现象:插件归档部署后,AstrBot 日志提示运维陪伴插件没有可加载的 `main.py`。
- 根因:归档保留了本地插件根目录的 `0700` 权限,运行服务的 `astrbot` 用户无法读取插件目录。
- 修复或规避:部署后统一将插件目录设为 `0755`、文件设为 `0644`,并保持 `root:root` 所有权。
- 预防规则:发布归档不能只检查文件存在,必须检查运行用户对根目录、`main.py` 和配置文件的读取权限。
- 验证证据:AstrBot 重启后加载 `astrbot_plugin_private_companion_ops (5.10.4-ops.1)`;服务 `active`,`NRestarts=0`。
## 2026-07-26 — 回滚副本不能放入插件扫描目录
- 阶段:部署
- 类型:部署 / AstrBot 插件发现
- 现象:AstrBot 将 `astrbot_plugin_private_companion_ops.previous-*` 当作插件加载,产生 `ModuleNotFoundError`。
- 根因:回滚副本被放在活动插件目录的同级扫描范围内,且目录名不是合法的 Python 模块名。
- 修复或规避:删除本次误生成的同级副本;正式备份放在 `/var/backups/astrbot-plugin-private-companion/`。
- 预防规则:任何备份、临时解压目录都必须放在 AstrBot 插件扫描根目录之外。
- 验证证据:清理后重启日志只保留正式运维陪伴插件加载记录,没有新的 `previous-*` 导入错误。