diff --git a/docs/release-readiness-2026-07-27.md b/docs/release-readiness-2026-07-27.md index b5f6339..610b189 100644 --- a/docs/release-readiness-2026-07-27.md +++ b/docs/release-readiness-2026-07-27.md @@ -42,3 +42,12 @@ scripts/package_plugin.sh v1.0.73 dist 3. 清理 NAS 路径 `/volume2/Dockers/qqbot/astrbot-ops-pro/data/plugins/astrbot_plugin_imagestudio` 中的旧密钥、历史包和扫描目录内备份。 4. 将备份留在 `data/plugin_backups` 或插件扫描树外;不能在 `data/plugins` 下留下隐藏备份目录。 5. NAS 部署后验证 AstrBot 日志已加载 `1.0.73`,并执行权限、迁移、队列取消竞争和前端新资源 hash 的冒烟检查。 + + +## NAS 部署结果 + +- 发布源:`v1.0.73`,release commit `734c92c9f2b14b0ca36617f370c0aa8a619e7a87`,归档 SHA-256 为 `94b19be31ddaeacc3a80e20e95316da3611c784de2dd4655aea6ec653464a19b`。 +- 部署目标:`/volume2/Dockers/qqbot/astrbot-ops-pro/data/plugins/astrbot_plugin_imagestudio`;部署前版本为 `1.0.72`,部署后为 `1.0.73`。 +- 回滚备份:`/volume2/Dockers/qqbot/astrbot-ops-pro/data/plugin_backups/astrbot_plugin_imagestudio-pre-1.0.73-20260727-121627`,位于插件扫描树外。 +- 验收:AstrBot 在 2026-07-27 12:21 +08:00 日志中加载 `astrbot_plugin_imagestudio (1.0.73)`;`metadata.yaml`、`pages/imagestudio/index.html`、`web/index.html` 的 NAS SHA-256 与本地一致。 +- 运行环境遗留:`astrbot-ops-pro` 在部署前后均为 `unhealthy`。健康检查报空 exit 1,日志另有缺失 `faiss.swigfaiss_avx2` 与模型元数据外连失败;此项不作为 ImageStudio 发布失败,但需由运行环境单独修复。 diff --git a/docs/错题本.md b/docs/错题本.md index 2ec3752..825f124 100644 --- a/docs/错题本.md +++ b/docs/错题本.md @@ -232,3 +232,24 @@ - 修复或规避:在所有归档路径断言前统一把反斜杠转换为正斜杠;同一规范同时覆盖秘密路径和必需入口。 - 预防规则:跨平台归档校验必须在比较前规范化路径分隔符,并在 Windows Git Bash 与 POSIX shell 各执行一次。 - 验证证据:`v1.0.73` 归档通过必需入口、秘密路径和 SHA-256 检查。 + + +## 2026-07-27 — NAS overlay must not restore directory metadata + +- 阶段:1.0.73 NAS 部署 +- 类型:部署 / 环境 +- 现象:将 staging tar 直接解入运行中的插件目录时,NAS 上由容器创建的目录拒绝恢复归档权限位,tar 在内容写入后以 `Cannot change mode` 失败,导致部署流程未能自动重启容器。 +- 根因:目标目录含 root-owned 运行时目录;tar 提取会尝试恢复归档目录 mode,agent 用户无权修改这些既有目录元数据。 +- 修复或规避:保留 staging 与扫描树外备份;只为源包中缺失目录执行 `mkdir -p`,逐文件 `cp -f` 覆盖源码,不删除缓存或 `plugin_data`,再由 NAS 宿主机重启容器。 +- 预防规则:NAS 插件覆盖禁止直接 `rm -rf` 或 tar 解入并恢复目录元数据;必须使用 staging、外部备份和文件级覆盖,并在重启前复核 metadata 版本。 +- 验证证据:`/volume2/Dockers/qqbot/astrbot-ops-pro/data/plugin_backups/astrbot_plugin_imagestudio-pre-1.0.73-20260727-121627` 已创建;AstrBot 日志加载 `astrbot_plugin_imagestudio (1.0.73)`;metadata 与两份前端 index 的 SHA-256 和本地一致。 + +## 2026-07-27 — ImageStudio deployment does not clear pre-existing container health failure + +- 阶段:1.0.73 NAS 部署验证 +- 类型:环境 / 部署 +- 现象:`astrbot-ops-pro` 重启后成功加载 ImageStudio 1.0.73,但健康检查仍为 `unhealthy`,内部 `healthcheck.py` 每 30 秒 exit 1 且无输出。 +- 根因:运行日志显示 `faiss.swigfaiss_avx2` 缺失及模型元数据外连失败;这两项发生在插件加载后,当前没有证据将健康失败归因于 ImageStudio。 +- 修复或规避:本次发布只确认插件版本、加载日志和关键文件 hash;容器健康检查问题保留为独立运行环境故障处理。 +- 预防规则:部署验收必须分别报告插件加载与容器健康;插件加载成功不能掩盖宿主健康失败,也不能在无证据时归责于插件变更。 +- 验证证据:2026-07-27 12:21 +08:00 日志显示 ImageStudio 1.0.73 已加载;健康日志连续 exit 1,容器保持 running。