diff --git a/docs/错题本.md b/docs/错题本.md index 578202d..97e5b3a 100644 --- a/docs/错题本.md +++ b/docs/错题本.md @@ -78,3 +78,13 @@ - 修复或规避:删除流程只保留角色存在、未处于删除中和后端写权限检查;移除删除专用的 `sample` 静默拦截。示例角色的生成、工作流和素材编辑限制保持不变。 - 预防规则:前端禁止操作必须有明确 UI 状态或错误提示;不要在单个操作中复用与其他操作不同的 `sample` 保护条件,先对照后端路由权限和资源生命周期。 - 验证证据:已修改 `frontend/standalone-web/src/App.vue:6241`;前端 `vue-tsc --noEmit` 通过;契约测试 26/26 通过;`git diff --check` 通过。 + +## 2026-07-23 — NAS 部署路径与容器重启边界 + +- 阶段:部署 +- 类型:部署 / 环境 +- 现象:首次部署校验失败是插件目录拼写错误;随后在容器内执行 `docker restart` 导致执行 shell 被 `context canceled` 终止,旧 staging 目录短暂留在插件扫描目录并被 AstrBot 当作第二个插件加载。 +- 根因:实际目录是 `astrbot_plugin_imagestudio`,不是 `astrabot_plugin_imagestudio`;容器内重启自身会立即杀掉当前 exec;AstrBot 会扫描 `data/plugins` 下所有目录,旧目录不能用改名方式留在那里。 +- 修复或规避:改用正确目录名;旧目录移入 `/AstrBot/data/plugin_backups`;重启必须由 NAS 宿主机执行;部署包先做 SHA-256 校验再替换。 +- 预防规则:部署脚本必须先验证目标目录存在;禁止在目标容器内部重启自身;插件旧版本只允许放在 `plugin_backups`,不得留在 `data/plugins`。 +- 验证证据:NAS 容器 `Up`;日志只加载一个 `astrbot_plugin_imagestudio (1.0.66)`;插件 metadata 为 `1.0.66`;`frontend/standalone-web/src/App.vue:6241` 删除修复标记存在;容器状态为已知的 `health: starting`。 \ No newline at end of file