3.4 KiB
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 和构建时间。
外部阻断项
以下事项不能以仓库提交替代,发布前必须由有对应权限的操作者完成:
- 按
审计/02-BUG清单.md第 0.1 节轮换已泄露的五类凭据。 - 轮换确认后删除本机
.env.imagestudio_codex_handoff.yaml。 - 清理 NAS 路径
/volume2/Dockers/qqbot/astrbot-ops-pro/data/plugins/astrbot_plugin_imagestudio中的旧密钥、历史包和扫描目录内备份。 - 将备份留在
data/plugin_backups或插件扫描树外;不能在data/plugins下留下隐藏备份目录。 - NAS 部署后验证 AstrBot 日志已加载
1.0.73,并执行权限、迁移、队列取消竞争和前端新资源 hash 的冒烟检查。
NAS 部署结果
- 发布源:
v1.0.73,release commit734c92c9f2b14b0ca36617f370c0aa8a619e7a87,归档 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 发布失败,但需由运行环境单独修复。