astrbot_plugin_imagestudio/docs/release-readiness-2026-07-27.md

3.4 KiB

ImageStudio 1.0.73 本地发布收口记录

日期:2026-07-27

本轮范围

  • 阶段 0:移除历史发布归档并使用 git archive 从 Git 树构建发布包,阻断忽略文件被目录复制带入归档。
  • 阶段 1:权限矩阵、路由归属校验、storage 沙箱、迁移覆盖确认与审计、配置快照脱敏、成人内容复核、聊天媒体目录白名单和魔数校验。
  • 阶段 2:队列 CAS/FIFO、轮次重试、PostgreSQL 占位符、归档语义、错误传播、尺寸字段和素材绑定 fail-closed。
  • 阶段 3:服务组合根、WorkflowService 事件总线完整装配、分层边界测试和 core 下沉。
  • 阶段 4:删除死代码、区分同名异义文本辅助函数、拆分 App.vue 样式。

本地发布门禁

发布前必须在本次最终 commit 上执行并记录输出:

python -m pytest -q
Push-Location frontend
npm.cmd run test:contracts
npm.cmd run typecheck
npm.cmd run build
Pop-Location
git diff --check
scripts/package_plugin.sh v1.0.73 dist

本次实测结果:后端 371 passed, 1 skipped(共 372 项,2026-07-27,使用仓库隔离临时目录);前端 26/26 通过;typecheck 和两套前端产物构建通过;工作树通过 whitespace 检查。归档仍须在最终 tag 上验证包含 metadata.yaml、main.py、web/index.html 与 pages/imagestudio/index.html,且不含秘密路径。

发布构造边界

  • scripts/package_plugin.sh 仅从指定 Git ref 构建 tar.gz,默认 HEAD 若含未提交 tracked 改动则拒绝执行。
  • tar.gz 是 NAS 部署格式;历史 Windows ZIP 曾出现路径分隔符兼容性问题,不能恢复为直接 Compress-Archive 流程。
  • 归档名称必须由同一 SHA 或 tag 推导;部署记录需保存 tag、commit SHA、归档 SHA-256 和构建时间。

外部阻断项

以下事项不能以仓库提交替代,发布前必须由有对应权限的操作者完成:

  1. 按 审计/02-BUG清单.md 第 0.1 节轮换已泄露的五类凭据。
  2. 轮换确认后删除本机 .env.imagestudio_codex_handoff.yaml。
  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 发布失败,但需由运行环境单独修复。