53 行
3.4 KiB
Markdown
53 行
3.4 KiB
Markdown
# 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 上执行并记录输出:
|
||
|
||
```powershell
|
||
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 发布失败,但需由运行环境单独修复。
|