递增三个已更新模板的 templateVersion 以解除发布守卫 #643

2026-10-06T11:09:30+08:00

suzmii commented

2026-10-06 11:09:30 +08:00

为什么

#624 改了 phaser-2d-starter / threejs-3d-starter / blank-3d-scene 的 project/ 内容，而发布脚本 scripts/agc-template-library-publish.mjs 的 planLibraryIndex 对「同 templateVersion 的 ZIP 内容变化」fail-closed：在 master 上直接 dry-run 会报 blank-3d-scene@0.1.1 同版本 ZIP 内容或尺寸变化，请递增 templateVersion，发布无法进行。

改了什么

三个 meta.json 的 templateVersion：0.1.1 → 0.1.2。title / summary / tags / runtime / engine / engineVersion / entry / coverWidth / coverHeight 一个字未动。

发布前置链

本 PR 合入 master 后，由有 OSS 权限的人执行（建议先 dry-run 看清单）：

node scripts/agc-template-library-publish.mjs --source apps/ai-game-creator-shell/template-library --only phaser-2d-starter,threejs-3d-starter,blank-3d-scene --dry-run
node scripts/agc-template-library-publish.mjs --source apps/ai-game-creator-shell/template-library --only phaser-2d-starter,threejs-3d-starter,blank-3d-scene

预期产出（发布后对账用）

模板	templateVersion	zipSizeBytes	zipSha256
phaser-2d-starter	0.1.2	1700	`0f719414ed54699fe8cf45b0730f93b4b6746826f0518526dc74249495afab3a`
threejs-3d-starter	0.1.2	2050	`f683b606313eeccd935174924148f32bb4dfd8f804b214381fad80e529f1bb5d`
blank-3d-scene	0.1.2	1992	`85364c91639a8ee6adf23a25b883715416ff71c734ea12bc8fa7ee9116f100f5`

未指定的 blank-2d-canvas@0.1.0 与 blank-web@0.1.0 按 --only 语义原样保留线上值（版本与 sha256 与线上逐字一致）。

验证

本分支 dry-run：EXIT=0，三个摘要与上表逐字节一致。
node --test scripts/agc-template-library-publish.test.mjs：28 passed / 0 failed。
apps/ai-game-creator-shell/tests/templateLibraryModel.test.ts、templateLibraryGrid.test.ts、templateLibraryView.test.tsx：通过（19 + 14 例）。
npm run agc:typecheck、node scripts/check-doc-index.mjs、npm run check:encoding、git diff --check：全部通过。

发布前不需要改模板正文或发布脚本；源侧 template-library/README.md 已写明「同一个 templateVersion 的 ZIP 字节发生变化时必须递增该模板的 templateVersion」，本 PR 不改动它。

## 为什么 #624 改了 `phaser-2d-starter` / `threejs-3d-starter` / `blank-3d-scene` 的 `project/` 内容，而发布脚本 `scripts/agc-template-library-publish.mjs` 的 `planLibraryIndex` 对「同 `templateVersion` 的 ZIP 内容变化」fail-closed：在 master 上直接 dry-run 会报 `blank-3d-scene@0.1.1 同版本 ZIP 内容或尺寸变化，请递增 templateVersion`，发布无法进行。 ## 改了什么三个 `meta.json` 的 `templateVersion`：`0.1.1` → `0.1.2`。`title / summary / tags / runtime / engine / engineVersion / entry / coverWidth / coverHeight` 一个字未动。 ## 发布前置链本 PR 合入 master 后，由有 OSS 权限的人执行（建议先 dry-run 看清单）： ``` node scripts/agc-template-library-publish.mjs --source apps/ai-game-creator-shell/template-library --only phaser-2d-starter,threejs-3d-starter,blank-3d-scene --dry-run node scripts/agc-template-library-publish.mjs --source apps/ai-game-creator-shell/template-library --only phaser-2d-starter,threejs-3d-starter,blank-3d-scene ``` ## 预期产出（发布后对账用） | 模板 | templateVersion | zipSizeBytes | zipSha256 | | ---- | --------------- | ------------ | --------- | | phaser-2d-starter | 0.1.2 | 1700 | `0f719414ed54699fe8cf45b0730f93b4b6746826f0518526dc74249495afab3a` | | threejs-3d-starter | 0.1.2 | 2050 | `f683b606313eeccd935174924148f32bb4dfd8f804b214381fad80e529f1bb5d` | | blank-3d-scene | 0.1.2 | 1992 | `85364c91639a8ee6adf23a25b883715416ff71c734ea12bc8fa7ee9116f100f5` | 未指定的 `blank-2d-canvas@0.1.0` 与 `blank-web@0.1.0` 按 `--only` 语义原样保留线上值（版本与 sha256 与线上逐字一致）。 ## 验证 - 本分支 dry-run：EXIT=0，三个摘要与上表逐字节一致。 - `node --test scripts/agc-template-library-publish.test.mjs`：28 passed / 0 failed。 - `apps/ai-game-creator-shell/tests/templateLibraryModel.test.ts`、`templateLibraryGrid.test.ts`、`templateLibraryView.test.tsx`：通过（19 + 14 例）。 - `npm run agc:typecheck`、`node scripts/check-doc-index.mjs`、`npm run check:encoding`、`git diff --check`：全部通过。发布前不需要改模板正文或发布脚本；源侧 `template-library/README.md` 已写明「同一个 `templateVersion` 的 ZIP 字节发生变化时必须递增该模板的 `templateVersion`」，本 PR 不改动它。

suzmii added 1 commit 2026-10-06 11:09:30 +08:00

递增三个已更新模板的 templateVersion

Project CI / AI game creator shell Rust lane 1/2 (pull_request) Successful in 6m37s

Details

Project CI / AI game creator shell Rust crates (pull_request) Successful in 3m52s

Details

Project CI / AI game creator shell Rust lane 2/2 (pull_request) Successful in 5m52s

Details

Project CI / Frontend tests (pull_request) Successful in 3m24s

Details

Project CI / Backend tests (pull_request) Successful in 7m36s

Details

Project CI / AI game creator shell web tests (pull_request) Successful in 2m43s

Details

Project CI / Repository checks (pull_request) Successful in 6m46s

Details

Project CI / Native shell tests (pull_request) Successful in 9m7s

Details

fdf6424e42

- phaser-2d-starter / threejs-3d-starter / blank-3d-scene 的 meta.json templateVersion 0.1.1 → 0.1.2
- 解除发布脚本对「同 templateVersion 的 ZIP 内容变化」的 fail-closed 守卫，其余字段一个字未动

suzmii commented

2026-10-06 11:46:10 +08:00

CI 8/8 全绿；head sha fdf6424e425fddd593d118da2e8096e111a5b8ae。

三个模板摘要与 --dry-run 逐字节一致：phaser-2d-starter@0.1.2 1700B 0f719414ed54…、threejs-3d-starter@0.1.2 2050B f683b606313e…、blank-3d-scene@0.1.2 1992B 85364c91639a…。

等待合入后由有 OSS 权限的人发布。

CI 8/8 全绿；head sha `fdf6424e425fddd593d118da2e8096e111a5b8ae`。三个模板摘要与 `--dry-run` 逐字节一致：`phaser-2d-starter@0.1.2` 1700B `0f719414ed54…`、`threejs-3d-starter@0.1.2` 2050B `f683b606313e…`、`blank-3d-scene@0.1.2` 1992B `85364c91639a…`。等待合入后由有 OSS 权限的人发布。

suzmii merged commit 52c83cc2a1 into master

2026-10-06 11:50:27 +08:00

suzmii deleted branch chore/bump-template-versions

2026-10-06 11:50:27 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: GenarrativeAI/Genarrative#643