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 份）
1.8 KiB
1.8 KiB
AGC 游戏模板库
- 用途：AGC 客户端读取的游戏模板库，正文是可直接解压到项目根的 zip（zip 根 == AGC 项目根，例如
game/index.html）。 - 位置：bucket
agc-dev（endpointoss-rg-china-mainland.aliyuncs.com）的templates/前缀，随 bucket 公共读。客户端只读templates/index.json（schemaagc-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；发布不删除历史对象，历史版本仍可按旧键下载。