docs: record M6.1.8 rollback-copy-in-scan-dir pitfall

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
这个提交存在于:
agent-bot 2026-07-27 01:48:26 +08:00
父节点 85d5069bbd
当前提交 56444d59dd

查看文件

@ -501,3 +501,13 @@ docs\运维陪伴错题本.md
- 修复或规避:Harness 改用 `adapter_mod._BRIDGE_UNPROBED`,与生产同源。
- 预防规则:验收工件里凡是复刻宿主行为的代码,都要直接引用生产模块的常量/函数,不要抄一份值。抄下来的那一刻它就开始过期,而且过期得无声无息。
- 验证证据:`docs/验收工件/M6.1.5/joint_e2e.py` 的 `Harness.reset_bridge_cache`;改后 S 组陪伴侧注入两项转通过,全量 115 项全通过。
## 2026-07-27 — 回滚副本放在插件目录里,就会被当成插件加载
- 阶段:M6.1.8 VM 部署
- 类型:部署 / 环境
- 现象:替换记忆插件时把原件留成同目录下的 `astrbot_plugin_memory_companion_ops.old`,AstrBot 扫描插件目录时把它当成一个插件去导入,报 `ModuleNotFoundError: No module named 'data.plugins.astrbot_plugin_memory_companion_ops.old'`,日志里多出一条 ERRO。功能没受影响,但启动日志从此不干净——而部署验收恰恰要靠「启动日志无错误」来判断。
- 根因:把「就近留个回滚副本」和「插件扫描目录」放在了同一个地方。本仓错题本里早有「回滚副本不入扫描目录」这条,部署时没有对照执行。
- 修复或规避:两个回滚副本一律移进 `ops-replace-backups/<时间戳>/`,扫描目录里只留活动插件;替换后立即 `ls` 确认无 `.old`/`.new`/`.stage` 残留。
- 预防规则:任何「原地改名保留旧版」的操作,先确认这个目录会不会被某个扫描器遍历——插件目录、任务目录、配置目录都算。部署脚本里把「回滚副本落到备份区」写成固定步骤,而不是临时决定。
- 验证证据:移出后重启,最新启动窗口内无 ERRO / Traceback / 导入失败;服务 active、NRestarts=0。