补齐模板库模板源、空白模板与确定性打包

- 新增仓库模板源 apps/ai-game-creator-shell/template-library/：空白网页、空白二维画布、空白三维场景三个空白模板，以及 Phaser 2D、Three.js 3D 两个起步工程模板 - 发布脚本改为按 project/ 现场打包确定性 zip（条目排序 + 固定时间戳），支持 svg 封面、--prune 清理旧对象与 --index-out - 模板库新增真连检查：读取线上清单、下载并安装线上模板包后校验文件落盘 - 刷新线上清单 fixture，并同步技术方案与实施计划的封面格式、模板源与发布方式
2026-09-17 11:24:50 +08:00
parent 8ee50e8b94
commit 7eaaa1a499
41 changed files with 1962 additions and 86 deletions
@@ -8,9 +8,10 @@ Milestone Spec: `docs/project-memory/plans/【里程碑】AGC模板库客户端
 ## 步骤

 1. **OSS 库布局与契约**
-   - 在 `agc-dev` 落地 `templates/` 前缀：`index.json`、`v1/<id>/{template.json,template.zip,cover.png}`。
+   - 在 `agc-dev` 落地 `templates/` 前缀：`index.json`、`v1/<id>/{template.json,template.zip,cover.*}`。
   - 清单补齐 `tags`、`coverKey/coverWidth/coverHeight/coverSha256`，正文改为 zip（zip 根 == 项目根）。
-   - 交付：`scripts/agc-template-library-publish.mjs`（校验 + 上传 + 回读校验）、`templates/README.md`。
+   - 模板源落在 `apps/ai-game-creator-shell/template-library/v1/<id>/{meta.json,project/**,cover.*}`；zip 由 `scripts/agc-template-library-publish.mjs` 现场打包（不落仓库）。
+   - 交付：发布脚本（校验 + 打包 + 上传 + 回读校验，支持 `--dry-run` / `--prune`）、`templates/README.md`，以及 5 个模板（3 个空白 + 2 个起步工程）。
   - 验收：匿名 `GET templates/index.json` 可读，每个 `zipKey` 回读 SHA-256 与清单一致。

 2. **Rust 模板库模块**
@@ -16,7 +16,7 @@ templates/
  v1/<templateId>/
    template.json                  # 单模板元数据（含文件级摘要）
    template.zip                   # 模板正文，zip 根 == AGC 项目根（如 game/index.html）
-    cover.png                      # 封面图（卡片展示，客户端 <img> 直接取）
+    cover.(png|jpg|webp|svg)       # 封面图（卡片展示，客户端 <img> 直接取）
 ```

 `index.json`（schema `agc-template-library.v1`）：
@@ -39,7 +39,9 @@ templates/

 - 所有对象键必须落在 `templates/` 前缀内；客户端只用「受信任 OSS 主机 + 对象键」自行拼 URL，**不直接信任清单里的地址**。
 - 任何一项校验失败（schema、标识符、sha256、尺寸、键前缀）都让整次清单读取失败，前端拿到的是全有或全无的清单。
- 上传与校验由仓库脚本 [`scripts/agc-template-library-publish.mjs`](../../scripts/agc-template-library-publish.mjs) 完成：源目录放 `v1/<id>/{meta.json,template.zip,cover.png,project/}`，脚本生成 `template.json` 与 `index.json`、上传并回读校验。
+- 模板源在仓库 `apps/ai-game-creator-shell/template-library/`：`v1/<id>/{meta.json, project/**, cover.(png|jpg|webp|svg)}`，`template.zip` **不落仓库**，由脚本按 `project/` 现场打包（条目排序、固定时间戳，同内容重复打包摘要一致）。
+- 上传与校验由 [`scripts/agc-template-library-publish.mjs`](../../scripts/agc-template-library-publish.mjs) 完成：`--source apps/ai-game-creator-shell/template-library [--dry-run] [--prune]`，脚本生成 `template.json` 与 `index.json`、上传后回读 zip 摘要；`--prune` 清理该模板前缀下本次没有产出的旧对象（例如换封面扩展名后的残留）。
+- 当前模板：`blank-web`（空白网页）、`blank-2d-canvas`（空白二维画布）、`blank-3d-scene`（空白三维场景）、`phaser-2d-starter`（Phaser 2D 起步工程）、`threejs-3d-starter`（Three.js 3D 起步工程）。
 - 客户端可用 `AGC_TEMPLATE_LIBRARY_BASE_URL` 覆盖库地址；只接受 `https://agc-dev.oss-rg-china-mainland.aliyuncs.com`（拒绝其他主机、路径、http）。

 ## 客户端实现