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

2.5 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 的冒烟检查。