新增后台 AGC 模板管理与模板库内容寻址落库

- 后台新增「模板管理」页：按权限查看并编辑模板名称/简介/标签/封面，支持上架与下架；路由、侧栏、tab 权限、API 客户端与 DTO 同步接入 - api-server 新增 /admin/api/agc-templates 读取与更新路由，复用现有后台鉴权与 tab 权限校验，权限不足按既有失败关闭口径拒绝 - module-assets 收敛模板库纯规则（active/inactive 投影、索引 schema 与重复项校验、ZIP 大小与摘要核对），platform-oss 承担对象存储读写、不可变对象复用与发布互斥锁 - shared-contracts 补后台模板 DTO；spacetime-module 账号存储适配保持既有 schema 不变 - AGC 壳内置模板索引与建项读取改为内容寻址对象，补模板安装、越界归档、索引不匹配等用例 - 模板库发布脚本支持定向发布与上架/下架合并、内容地址复用与锁语义，CLI 守卫用例同步；jenkins 两条客户端打包管线统一触发邮件通知 Job 并传递首装包链接 - 内置 5 个 Cocos 官方模板载荷与索引 fixture（内容地址对象，共 90 个文件） - 补「后台模板管理」里程碑与实施计划，更新模板库技术方案、开发运维文档与共享记忆 - 验证：admin-web 39 项用例与 typecheck、发布脚本 25 项用例、api-server 与 AGC 壳编译、模板库定向 Rust 用例（AGC 壳 18 项、module-assets/platform-oss 16 项、后台权限 1 项）、check:encoding / check:doc-index / check:production-ops / rustfmt 全部通过
2026-09-21 13:50:26 +08:00
parent 6845cdcbc5
commit 02a7abeb3f
129 changed files with 21480 additions and 198 deletions
@@ -0,0 +1,18 @@
+# 后台模板管理实施计划
+
+| 字段 | 值 |
+| --- | --- |
+| Milestone | `docs/project-memory/plans/【里程碑】后台模板管理-2026-09-19.md` |
+| Status | in-progress |
+| Owner | Codex |
+
+## 修改边界与顺序
+
+1. 评审主规范和 DTO，确认权限、单清单 inactive 投影、锁与凭据配置。
+2. 前端独立负责 admin-web 页面/路由/类型/API/tests；存储分支负责 platform-oss 模板 adapter；领域分支负责 module-assets 纯规则、shared-contracts/admin DTO；主线程负责 API/配置/状态装配、CLI状态兼容、文档和集成验证。
+3. 后端共用已定义锁语义，CLI同步inactive合并；并行完成定向测试，Cargo依赖编译串行协调。
+4. 复审、API与浏览器smoke，回填证据，删除本里程碑临时计划。
+
+## 时间盒与风险
+
+按规格评审、最小读写闭环、权限/冲突边界、界面验收四个检查点推进。旧客户端仅识别templates，不能把下架条目留在该数组；正文与index不能跨bucket；异步请求取消不能误释放结果不明的锁。只新增必要执行层，保留现有Cocos改动和个人工具数据，不扩大为新模板上传系统。
@@ -0,0 +1,23 @@
+# 后台模板管理
+
+| 字段 | 值 |
+| --- | --- |
+| Version | 1.0 |
+| Status | approved |
+| Date | 2026-09-19 |
+| Parent Spec | `docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md` |
+
+## 目标与范围
+
+后台管理员按权限查看并编辑 AGC 模板名称/简介/标签/封面，支持上架/下架。用户已明确选择此范围，不新增模板、ZIP 上传、版本发布、删除、部署或提交。
+
+## 合同与依赖
+
+OSS index 单一真相，active/inactive 两组；CLI/Rust 共用不可变对象及互斥发布锁；客户端沿用 active 读取。后台现有鉴权/权限/组件复用；不改 SpacetimeDB schema。
+
+## 验收
+
+- 页面、导航、权限和请求/响应合同一致，未授权无读取/写入。
+- 编辑、封面、上下架真实通过存储适配器写回；ZIP与版本不变，其他模板及未知字段保留。
+- 并发、旧revision、失败/未知写入和页面迟到响应失败关闭；CLI不重新上架下架项。
+- 定向测试/类型/构建/编码/格式与文档检查通过；本地API健康检查与桌面/移动受控浏览器smoke，真实OSS不写。
@@ -51,6 +51,8 @@ SpacetimeDB crate、SDK、CLI / standalone 与生成 bindings 按 `2.8.3` 对齐

 ## AGC DirectProject 与 UI workflow

+- AGC 模板库包含 Creator 3.8.8 的四个官方 Cocos 模板；Cocos 建项复用原生导入，重建项目 UUID 并保留场景与资源。发布使用内容地址保留历史对象，并在确认 Bucket 从未开启版本控制后获取排他锁；`--only` 在锁内合并最新清单，清单写入结果不明时留锁，同版本 ZIP 变化拒绝发布。详细合同见 [AGC 模板库与模板建项](../../technical/【技术方案】AGC模板库与模板建项-2026-09-17.md)。
+
 - AGC 的本地 `llm.customEnabled` 默认关闭，只能手动修改配置文件；开启后设置支持自定义 Responses 端点、读取 `/models`、勾选和预览 `visibleModels`。对话下拉只显示勾选项，LLM 请求经客户端凭据代理直连自定义上游；不会回退官方中转，平台资源服务仍使用账号权限。详见 AGC 后台模型别名与对话选择规范。

 - DirectProject 对话先在完整历史中按回合/原始 item 身份关联，再分页渲染；每个回合只有一个呈现入口。有流按 item `seq` 交替文本和工具，无流采用历史正文；禁止位置猜配或同时展示累计回复与 item 正文。流写入单调归并，收尾等待落盘任务，不按磁盘“最后一段”猜最终回复位置。详见 AGC 实施计划的“DirectProject 回合展示唯一归属”。