2.5 KiB
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 和构建时间。
外部阻断项
以下事项不能以仓库提交替代,发布前必须由有对应权限的操作者完成:
- 按
审计/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 的冒烟检查。