kdletters
b5e1c0f1d6
Project CI / AI game creator shell Rust crates (push) Successful in 2m48s
Project CI / AI game creator shell Rust smoke (push) Successful in 3m37s
Project CI / AI game creator shell Rust lane 2/2 (push) Failing after 6m5s
Project CI / AI game creator shell Rust lane 1/2 (push) Failing after 8m59s
Project CI / Backend tests (push) Has been cancelled
Project CI / Native shell tests (push) Has been cancelled
Project CI / Frontend tests (push) Has been cancelled
Project CI / AI game creator shell web tests (push) Has been cancelled
Project CI / Repository checks (push) Has been cancelled
- 新增 docs/【模板规范】AGC模板包组织指南-2026-09-21.md：ZIP 根目录契约、html 与 Cocos 工程的建议结构与保留项、禁止放入的内容（.agent/.git/node_modules/dist/密钥/嵌套锁文件）、路径与体积上限、封面要求、元数据字段约束、版本不可变规则与发布前自检清单 - 说明两条发布路径的输入差异（CLI 源目录 vs 后台成品 ZIP 上传）与各自上限，并标注「工具不会自动拦截 .agent/.git」这一已知边界 - 主规范与模板库 README（会发布到 OSS templates/README.md）各加一条指向该指南的入口 - docs/README.md 登记新文档，check:doc-index 通过（194 份）
12 lines
1.8 KiB
Markdown
12 lines
1.8 KiB
Markdown
# AGC 游戏模板库
|
||
|
||
- 用途：AGC 客户端读取的**游戏模板库**，正文是可直接解压到项目根的 zip（zip 根 == AGC 项目根，例如 `game/index.html`）。
|
||
- 位置：bucket `agc-dev`（endpoint `oss-rg-china-mainland.aliyuncs.com`）的 `templates/` 前缀，随 bucket 公共读。客户端只读 `templates/index.json`（schema `agc-template-library.v1`）。
|
||
- 目录结构：`templates/index.json` + `templates/v1/<templateId>/sha256/<内容摘要>/{template.zip,template.json,cover.*}`；条目元数据含 `tags`、封面键与尺寸/摘要、包大小与 SHA-256、`templateVersion`。所有正文按自身字节摘要寻址，重复发布复用同一对象。
|
||
- 封面支持 `png / jpg / webp / svg`。
|
||
- 客户端只信任「受信任 OSS 主机 + 对象键」，清单里的地址字段不参与请求；下载后强校验包大小与 SHA-256，安装完成的唯一判据是模板目录里的 `installed.json`。
|
||
- 这份文件就是线上 `templates/README.md` 的源：内容随每次发布覆盖写，所以改契约要改这里，不要只改线上对象。
|
||
- 契约与验收以仓库文档 `docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md` 为准；模板源在 `apps/ai-game-creator-shell/template-library/`，发布用 `node scripts/agc-template-library-publish.mjs --source apps/ai-game-creator-shell/template-library [--dry-run] [--only <id,id,...>]`（脚本现场打包 zip、按内容地址上传、逐个回读校验、持锁提交清单）。
|
||
- 准备新模板（ZIP 里放什么、不能放什么、封面与元数据约束、发布前自检）先读 `docs/【模板规范】AGC模板包组织指南-2026-09-21.md`。
|
||
- 同一个 `templateVersion` 的 ZIP 字节发生变化时发布会失败关闭，必须递增该模板的 `templateVersion`；发布不删除历史对象，历史版本仍可按旧键下载。
|