新增 AGC 模板库与由模板创建项目链路 #396

Merged

kdletters merged 10 commits from codex/agc-template-library into master 2026-09-17 17:48:06 +08:00

Conversation 2 Commits 10 Files Changed 92

+6110 -203

10 Commits

Author	SHA1	Message	Date
kdletters	b3d289f3aa	合入 master 并解决模板库分支冲突 ... - directActiveTurns：保留 master 的重试定时器清理与本分支的快照签名去重（两侧在同一位置相邻插入） - directActiveTurns 测试：合并两侧用例（master 的定时器清理与面板用例 + 本分支的快照引用稳定用例） - decision-log：两侧新增条目都保留（AGC 模板库约定 + CI 宿主 CPU 上限） - 冲突后复核：cargo check 0 错误、tsc 通过、33 项前端单测通过、编码 / 文档索引 / diff 检查通过	2026-09-17 17:44:29 +08:00
kdletters	5a219e53a5	修复虚拟列表卡片区空白：页面高度按父级实测 ... - 页面根节点高度改为内联写入父级 .launcher-main 的实测高度：外壳的 .launcher-main > .platform-theme { height:100% } 特异性高于 Tailwind，且该百分比在 min-height:100vh 链上是不定高，页面退化成内容高度后虚拟网格视口为 0（卡片区整片空白）；100vh 又比舞台高一个标题栏会裁掉底部 - 技术方案补页面高度契约说明 - 真机复测（1000 条假数据）：可视区 16 张卡、进入页面后 23ms 出现卡片、搜索到空态 22ms、清空搜索回全量 22ms；WebView2 组工作集 487MB（修复前 4.2-4.6GB）	2026-09-17 17:27:30 +08:00
kdletters	13d272c2d4	修复 AGC 壳首页无限 setState 循环 ... - WorkspaceLauncher 发布活动项目面板的 effect 不再依赖每次渲染都换身份的 openActiveProject：回调改走 ref，依赖只留数据 - useDirectActiveTurns 轮询只在快照内容变化时更新状态，空态保持引用稳定，避免每 5 秒换数组身份带动下游 effect - WindowChrome 的 context value 用 useMemo 收口，避免所有 useWindowChrome 消费方被无谓重渲染 - 新增回归测试 directActiveTurns.test.tsx：轮询返回值不变时快照引用必须不变 - pitfalls 记录现象/根因/定位手段（console.error 里抓调用栈）与验证数据：修复后 35 秒 0 条深度错误、renderer 工作集 4.2GB -> 254MB	2026-09-17 16:53:34 +08:00
kdletters	066d0fe6f9	模板库卡片列表接入虚拟滚动 ... - 用 workspace 已有的 react-window@1.8.11 的 FixedSizeGrid：只渲染可视行 + 2 行 overscan，1000 条不再一次性挂 1000 个卡片节点 - 新增 templateLibraryGrid.ts 纯函数布局契约（列数/列宽/行高/行数/按行切分），单测覆盖 - 卡片抽成 memo 化的 TemplateCard；筛选条件变化时把滚动位置复位到顶部 - 筛选区（运行时/标签）改为可独立滚动区块，标签膨胀不再挤压卡片区 - 页面回归改用固定视口：断言 1000 条只渲染 ≤40 张卡、滚动高度按 250 行计算 - 技术方案补虚拟滚动契约说明	2026-09-17 16:36:04 +08:00
kdletters	19e9dea45c	模板库假数据注入改为 Cargo feature 控制 ... - 新增 feature template-library-fixtures（默认关闭）：关闭时 apply_template_library_fixtures 为恒等透传，正式产物不含注入分支 - 注入实现下沉为 cfg 模块：按真实清单循环补齐假数据（唯一 id/标题/封面地址，标签追加批次分组，安装态 1/3 混合），条数由 AGC_TEMPLATE_LIBRARY_SYNTHETIC_COUNT 控制（默认 1000） - 两种编译模式各补一条用例：默认构建必须恒等透传，开启 feature 必须补齐到配置条数；另补假数据识别/计数解析单测 - 前端补 1000 条渲染回归：1000 张卡片渲染 + 已安装/标签/关键词过滤数量自洽 - 技术方案补「本地压测假数据注入」与 1000 条实测结论（标签条膨胀、一次性渲染 1000 卡片与封面请求需后续收口）	2026-09-17 15:09:02 +08:00
kdletters	a9d5ac0931	修复模板库页无法上下滚动 ... - 模板库页面根节点补 platform-theme / platform-theme--light 与 h-full + overflow-y-auto：shell 只给 .launcher-main 下带 platform-theme 的直接子元素 height:100% + overflow:auto，缺这个类时整页没有滚动容器，模板一多就滚不动 - 补回归单测：页面根节点必须同时具备 platform-theme 与 overflow-y-auto	2026-09-17 14:52:44 +08:00
kdletters	ff542085e1	模板库卡片按安装状态收口并改用浮层提示 ... - 已下载且版本一致的模板不再显示下载入口，只保留「使用模板」；版本落后显示「更新」，缺包显示「下载」 - 下载完成、开始建项目等过程提示改为浮层 toast（复用 PlatformRuntimeStatusToast，2.6 秒自动消失），不再占用页面内位置；页面内只保留错误与空态 - 补充/更新页面单测：已下载无下载按钮、落后显示更新、toast 渲染在页面外并自动消失 - 同步技术方案与里程碑的交互口径	2026-09-17 14:43:43 +08:00
kdletters	46d395763d	补齐模板库页面单测与真连建项目检查 ... - 前端单测迁到 apps/ai-game-creator-shell/tests/，与根 vitest include 一致；新增模板库页面与首页推荐位 8 项渲染/交互测试（卡片封面、标签、已下载徽标、搜索、筛选、下载与使用模板、空态与错误态） - 模板库的运行时与标签筛选补 aria-label，避免同名按钮歧义 - 真连检查扩展为「读线上清单 → 下载安装线上模板 → 据此建项目」的完整链路 - 同步技术方案、里程碑与实施计划的验证命令与验收口径	2026-09-17 11:37:29 +08:00
kdletters	7eaaa1a499	补齐模板库模板源、空白模板与确定性打包 ... - 新增仓库模板源 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
kdletters	8ee50e8b94	新增 AGC 模板库与由模板创建项目链路 ... - 新增 Rust 模板库模块 template_library.rs：读取 OSS 清单、校验并安装模板包、由模板创建项目 - 注册 fetch_game_template_library、download_game_template、create_automatic_local_game_project_from_template 命令 - 新增前端模板库模型与状态链路：搜索、标签/运行时/已下载筛选、下载与建项 - 新增模板库全屏页，并在左侧导航增加模板库入口 - 首页「灵感推荐」替换为模板库推荐位，删除本机灵感图目录与 InspirationGallery 组件 - tauri.conf.json 的 img-src 放行受信任 OSS 主机，用于加载模板封面 - 新增模板库发布脚本 scripts/agc-template-library-publish.mjs - 新增模板库技术方案、里程碑与实施计划文档，并更新 docs/README.md 索引 - decision-log 记录模板库 OSS 路径、清单 schema、安装缓存目录与 CSP 约定	2026-09-17 11:20:13 +08:00