Merge origin/master into hermes/hermes-4fd30995

2026-05-15 03:41:50 +08:00
parent 1b54db4f92 2eded08bc7
commit b97a3ccebd
348 changed files with 31117 additions and 4591 deletions
@@ -1,28 +1,29 @@
-# 移动端创作页作品列表统一卡片设计 2026-04-29
+# 移动端草稿页作品列表统一卡片设计 2026-04-29

 ## 背景

-创作页的作品模块需要同时承载 RPG、拼图和大鱼吃小鱼等玩法。不同玩法卡片不能各自展示阶段、素材、主题等细节标签，否则作品列表会在移动端显得拥挤，并且草稿作品会暴露过多编辑态信息。
+草稿页的作品模块需要同时承载 RPG、拼图和大鱼吃小鱼等玩法。不同玩法卡片不能各自展示阶段、素材、主题等细节标签，否则作品列表会在移动端显得拥挤，并且草稿作品会暴露过多编辑态信息。

-本次将作品列表卡片收口成统一信息结构：草稿只用于快速识别和继续创作，已发布作品才展示公开数据与分享入口。
+本次将作品列表卡片收口成统一信息结构：草稿只用于快速识别和继续创作，已发布作品才展示公开数据；删除与分享等低频操作收进长按动作面板，避免列表常态被按钮挤占。

 ## 落地范围

 - 列表容器：`src/components/custom-world-home/CustomWorldCreationHub.tsx`
 - 作品卡片：`src/components/custom-world-home/CustomWorldWorkCard.tsx`
 - 不改动作品数据聚合、筛选、打开和体验逻辑。
- 已发布作品右上角动作从删除改为分享；草稿仍保留删除入口。
+- 已发布作品保留分享能力，卡片右上角常驻分享图标；可删除作品保留删除能力，但常态不显示删除按钮。

 ## 卡片结构规则

-1. 标题上方只显示两个标签：作品状态与游戏类型。
+1. 卡片整体对齐发现 / 分类页的横向作品列表结构：内容层承载标题、状态、类型、摘要与必要数据，封面作为不占内容布局的右半区透明背景层。
 2. 不再显示阶段、主题、素材完成度、作者、作品号等额外标签。
-3. 标签下方依次显示作品名称与作品描述。
-4. 草稿卡片到作品描述为止，不显示其他统计、作品号或体验按钮。
+3. 标题区域保留作品状态与游戏类型；草稿和已发布状态只用图标化 UI 标识，不再在卡片上显示“草稿 / 已发布”文字。
+4. 草稿卡片到作品描述为止，不显示右侧“继续创作”等固定动作、统计、作品号或公开指标。
 5. 已发布卡片在描述下方显示三项公开指标：游玩数、改造数、点赞数。
-6. 已发布卡片右上角显示分享 icon，点击后复制作品分享文案，不触发卡片打开。
-7. 草稿卡片右上角继续显示删除 icon，点击删除不触发卡片打开。
+6. 已发布卡片右上角显示分享图标，点击后复制作品分享文案，不触发卡片打开。
+7. 长按草稿作品弹出独立动作面板，只展示删除作品；长按已发布作品弹出独立动作面板，展示分享和删除。动作按钮点击后不得触发卡片打开。
 8. 卡片不显示最后修改时间；`updatedAt` 只用于作品列表排序。
+9. 生成中的卡片在整卡上叠加半透明蒙版、旋转等待符号和“生成中...”标识；蒙版不能移除标题、状态、类型、摘要、右侧封面等原有信息。

 ## 公开指标重点展示补充

@@ -31,16 +32,24 @@
 3. 用户每次进入创作页时，前端读取上一次进入该页面缓存的公开指标快照；当已发布作品卡片滑动进入视口后，数字从缓存值增长到本次接口返回的最新值。
 4. 若最新值高于缓存值，动画完成后在对应指标右下角展示红色向上箭头和本次上涨的具体数值，字号低于主数字，避免抢占主信息层级。
 5. 若没有缓存值、缓存值不低于最新值或作品仍是草稿，则直接显示最新值，不展示上涨标记。
-6. 每张作品卡片继续使用作品封面作为整卡背景，封面保持主视觉可见；遮罩只用于保证标题、描述和指标可读，不能把封面洗成普通面板底色。
+6. 每张作品卡片继续使用作品封面作为右侧半区透明背景主视觉；封面从右向左渐隐，不能出现独立方形边界，也不能因为列表收缩挤占正文布局或被拉伸变形。
 7. 作品列表按 `updatedAt` 倒序排列；前端排序需要兼容 ISO 时间和 Rust 后端常用的 `seconds.microsZ` 时间文本。
 8. 若玩法摘要缺少 `coverImageSrc`，允许从同一作品的正式关卡图、背景图或素材图里取第一张可用图片作为卡片背景兜底。
+9. 若作品真实图片为空、私有资源换签失败或浏览器图片加载失败，卡片必须切到对应玩法的 `public/creation-type-references/` 参考图；最终兜底底色使用平台浅粉暖白色系，不允许退回黑色普通面板。

 ## 移动端布局规则

-1. 作品列表默认仍使用 2 列网格，保证草稿可以快速扫视。
-2. 已发布作品卡片在移动端固定 `col-span-2`，即占据一整行，避免公开指标和分享入口互相挤压。
-3. `sm` 及以上视口恢复普通网格跨度，由卡片自然进入多列布局。
+1. 作品列表默认使用单列纵向列表，视觉上与发现页分类列表保持一致。
+2. 移动端每张卡片使用绝对定位右半区封面背景层，封面在右边缘最清晰、向左渐隐；草稿卡即使复用分类页基础类名，也必须用自身选择器覆盖分类页的 `4.3rem + 正文 + action` 三列规则，避免正文被压进窄列。
+3. 已发布作品的公开指标在卡片正文内保留，但需要压缩字号和间距，不能依赖右侧封面列参与排版。
 4. 小屏卡片降低高度、内边距、标题字号和徽标尺寸，避免长标题或中文描述撑破容器。
+5. 右侧封面层本身必须带玩法参考图 CSS 背景兜底；`img` 的真实封面或 `ResolvedAssetImage` fallback 加载失败时，也不能出现空白或黑卡。
+
+## 网页端布局规则
+
+1. 网页端作品架不能继续拉成整行超宽列表；从 `768px` 起使用多列卡片式网格，默认两列，宽屏提升到三列。
+2. 网页端卡片保留移动端同一信息结构，但卡片高度增加，正文区可显示更多摘要与公开指标，右侧封面改为更高的半透明视觉区。
+3. 删除与分享仍然只在长按动作面板或键盘揭示态显示；默认态不得透出红色删除底层。

 ## 文案约束

@@ -1,6 +1,6 @@
 # 平台创作 Tab 模板入口设计

-更新时间：`2026-05-07`
+更新时间：`2026-05-14`

 ## 1. 目标

@@ -18,7 +18,7 @@

 ```text
 标题：10分钟创作一个精品互动玩法
-模板 Tab：拼图 / 抓大鹅 / 视觉小说（敬请期待）/ AIRP
+模板 Tab：拼图 / 抓大鹅 / AIRP
 默认内容：拼图创作表单
 ```

@@ -34,16 +34,17 @@
 1. 打开“创作”一级 Tab 时默认停留在拼图 Tab，不主动创建拼图 session。
 2. 点击拼图表单“生成草稿”后，才创建拼图 session 并执行 `compile_puzzle_draft`。
 3. 拼图表单内的模板按钮使用 `tablist / tab` 语义，点击后只填充画面描述。
-4. 点击非拼图且已开放的模板 Tab 时，进入该玩法既有工作台；视觉小说与 AIRP 当前保持敬请期待禁用态。
-5. `creative-agent` 不出现在模板 Tab 和选择弹层中，不再作为创作 Tab 首屏入口。
-6. 方洞挑战暂时从创作页完全隐藏，不出现在模板 Tab、旧选择弹层和创作 Hub 卡片中；既有作品链路继续保留。
+4. 点击非拼图且已开放的模板 Tab 时，进入该玩法既有工作台；AIRP 当前保持敬请期待禁用态。
+5. `visual-novel` 暂时从创作页完全隐藏，不出现在模板 Tab、旧选择弹层和创作 Hub 卡片中；既有作品、详情、运行链路继续保留。
+6. `creative-agent` 不出现在模板 Tab 和选择弹层中，不再作为创作 Tab 首屏入口。
+7. 方洞挑战暂时从创作页完全隐藏，不出现在模板 Tab、旧选择弹层和创作 Hub 卡片中；既有作品链路继续保留。

 ## 4. 验收

 1. 点击“创作”后首屏出现“10分钟创作一个精品互动玩法”。
 2. 顶部选择模板入口为 Tab，拼图 Tab 默认 `aria-selected=true`。
 3. 创作 Tab 默认显示拼图创作表单内容，且不显示旧“Hi, 朋友”、输入框或智能创作快捷按钮。
-4. 隐藏的智能创作类型与方洞挑战不出现在模板 Tab、旧选择弹层和创作 Hub 卡片中。
+4. 隐藏的智能创作类型、视觉小说与方洞挑战不出现在模板 Tab、旧选择弹层和创作 Hub 卡片中。
 5. 草稿页返回创作页后仍回到同一模板入口，并可保留拼图表单草稿内容。

 ## 5. 嵌入式表单 UI 细节
@@ -59,3 +60,5 @@
 3. 风格卡标签使用浅底胶囊，保证图片仍是主体。
 4. 难度等分段选项可以使用主品牌色，但选中态需要降低阴影和饱和度。
 5. UI 中不补充玩法规则说明文案，保持创作入口清爽。
+6. 拼图创作表单在未上传主图时，画面描述输入框右下角保留一个参考图上传入口；支持多选，最多 5 张，上传后以下方小缩略图展示，点击缩略图可放大预览。
+7. 当前拼图后端只消费第一张有效参考图做生成，前端仍需保留数组输入，方便后续扩展多参考图能力。
@@ -69,7 +69,7 @@
 - 入口、删除、分享、领取拼图激励等行为全部复用现有 `CustomWorldCreationHub` 的作品卡逻辑。
 - 一级底部 Tab 文案为“草稿”，内部仍可按草稿与已发布筛选。
 - 作品列表必须按最后修改时间倒序排列；排序使用后端 `updatedAt`，前端需要兼容 ISO 字符串和 `seconds.microsZ` 两种时间文本。
- 每张作品卡以作品封面图铺满整卡背景，并叠加遮罩保证标题和描述可读；遮罩不能把封面洗成普通面板底色。缺 `coverImageSrc` 但同一作品已有正式关卡图、背景图或素材图时，优先用这些真实作品图兜底，再使用现有兜底底图。
+- 每张作品卡以作品封面图铺满整卡背景，并叠加遮罩保证标题和描述可读；遮罩不能把封面洗成普通面板底色。缺 `coverImageSrc` 但同一作品已有正式关卡图、背景图或素材图时，优先用这些真实作品图兜底；若封面签名失败或作品还没有可用图片，再按玩法使用 `public/creation-type-references/` 的参考图兜底，最终无图底色也必须保持百梦浅粉暖色调，不能回退为黑色卡片。
 - 草稿页卡片不展示“最后修改时间”“更新于”或原始 `updatedAt` 文本，时间只参与排序。

 ## 6. 我的页玩过列表
@@ -126,6 +126,7 @@
 - 用户再进入草稿 Tab 并点击同一草稿时，若生成仍未完成，进入对应生成过程页查看最新进度；若已完成，直接进入对应结果页。
 - 草稿作品卡在生成中展示“生成中”状态标记；新生成完成且用户尚未查看的草稿在卡片右上角展示红点。
 - 底部一级“草稿”Tab 在存在未查看新完成草稿时展示红点；用户点击查看带红点的作品后，该作品红点消失。若草稿页已无任何带红点作品，底部“草稿”Tab 红点同步消失。
+- 红点通知链路覆盖所有进入草稿作品架的生成型玩法；宝贝识物等仅有 `profileId` 和 `draftId` 的轻量草稿，也必须把两个 ID 都纳入同一组通知 key，避免卡片红点和底部草稿 Tab 红点漂移。
 - 生成完成时如果用户仍停留在对应生成过程页，可自动进入结果页；如果用户已经回到创作中心或其它功能页，不打断当前操作。
 - 创作 Tab 的模板入口只允许被模板自身的开放状态禁用；某个草稿后台生成中时，不得用该玩法的 busy 状态禁用其它模板入口、同模板再次创建入口或阻止用户继续创建新作品。
 - 同模板再次点击生成时必须创建新的草稿生成任务，不得因为当前玩法已有后台生成 session 就跳回上一条草稿的生成过程页；查看上一条生成进度只能从草稿 Tab 的对应作品卡进入。
@@ -61,6 +61,7 @@
 - 平台层正文、按钮、说明、功能标签统一使用非像素字体
 - 左上角 `陶泥儿 / GENARRATIVE` 品牌字标允许单独做成像素化 logo
 - `GENARRATIVE` 与 `陶泥儿` 都优先直接使用游戏内同款 `Fusion Pixel`
+- 品牌中文主标固定显示为 `陶泥` + 半字号 `儿`，`儿` 必须继承主标同一字体和字号后再视觉缩放到 50%，并与 `陶泥` 底部对齐，随移动端和场景覆盖等比例缩放
 - 品牌字标默认保持正常像素字观感，禁止再叠双层粗阴影或手动加粗到影响识别
 - 品牌字标直接使用字体文件内原字形，不额外做运行时描字、轮廓拼字或伪粗体处理
 - 主标题保留明显层级，但不再做像素描边效果
@@ -5,6 +5,7 @@
 ## 文档列表

 - [CHILD_MOTION_DEMO_WARMUP_LEVEL_DESIGN_2026-05-09.md](./CHILD_MOTION_DEMO_WARMUP_LEVEL_DESIGN_2026-05-09.md)：4-8 岁儿童动作识别互动玩法 Demo 固定热身关的横屏体验流程、识别目标、表现需求与待确认事项。
+- [TAONIER_BRAND_LOGO_CONCEPTS_2026-05-13.md](./TAONIER_BRAND_LOGO_CONCEPTS_2026-05-13.md)：候选产品名“陶泥儿”的品牌定位归纳、gpt-image-2 Logo 概念图和主标选择建议。
 - [CUSTOM_WORLD_CREATOR_INPUT_AND_AI_BOUNDARY_DESIGN_2026-04-06.md](./CUSTOM_WORLD_CREATOR_INPUT_AND_AI_BOUNDARY_DESIGN_2026-04-06.md)：自定义世界里陶泥儿主输入与 AI 分工边界设计。
 - [CUSTOM_WORLD_CREATOR_MANUAL_AI_SYSTEM_BALANCE_DESIGN_2026-04-12.md](./CUSTOM_WORLD_CREATOR_MANUAL_AI_SYSTEM_BALANCE_DESIGN_2026-04-12.md)：自定义世界创作里“手填锚点 / AI 可改初稿 / 系统托管层”的平衡设计。
 - [CUSTOM_WORLD_CREATOR_PURE_AGENT_COMPARISON_AND_CONVERSION_DESIGN_2026-04-12.md](./CUSTOM_WORLD_CREATOR_PURE_AGENT_COMPARISON_AND_CONVERSION_DESIGN_2026-04-12.md)：纯 Agent 式创作工具与结构化工作台方案的优缺点对比，以及转型设计。
@@ -0,0 +1,423 @@
+# 陶泥儿品牌 Logo 概念稿
+
+> 本稿是围绕候选产品名“陶泥儿”的品牌视觉探索，不替代当前已冻结的“百梦”正式命名口径。若后续确认更名，需要另起产品命名、前后端文案和商标检索落地方案。
+
+## 1. 品牌定位归纳
+
+“陶泥儿”适合承接的不是传统陶艺或儿童黏土，而是“把灵感塑形成可玩内容”的 AI 创作平台隐喻。
+
+核心关键词：
+
+- 精品：作品不是随手糊出来，而是经过 AI 辅助打磨、可被消费和传播的轻精品内容。
+- UGC：用户是主要造物者，平台降低创作门槛。
+- 创作：从一句脑洞、一个梗、一张图，生成小游戏、互动作品或可分享内容。
+- 裂变与梗：名字要支持“开捏”“捏个梗”“捏个小游戏”这类用户语言。
+- 轻度休闲：体验应松弛、即时、好玩，不走硬核生产工具气质。
+- AI：AI 是塑形能力，不是冷冰冰的技术标签。
+
+推荐品牌主张：
+
+```text
+把脑洞捏成小游戏
+```
+
+备选表达：
+
+```text
+捏个脑洞，马上开玩
+AI 开捏，人人会创作
+随手造梗，随心开玩
+```
+
+## 2. 生成原则
+
+本轮使用仓库 GPT-image-2 / VectorEngine 工作流生成 Logo 概念图，生成时刻意要求“无文字 Logo 图标”。
+
+原因：
+
+- AI 生图直接生成中文品牌字容易出现笔画错误，不适合作为正式字标。
+- 当前阶段更适合先确定图形符号方向，再由设计师或前端继续做矢量化、字标搭配和多尺寸适配。
+- 图标需要优先服务 App icon、平台左上角品牌、分享卡片和加载页，而不是一次性海报图。
+
+生成文件：
+
+```text
+public/branding/taonier-logo-v3-concepts/
+├─ taonier-logo-v3-contact-sheet.png
+├─ taonier-v3-finger-spark.png
+├─ taonier-v3-seed-pop.png
+├─ taonier-v3-magic-dot.png
+├─ taonier-v3-work-gem.png
+└─ taonier-v3-soft-t.png
+
+public/branding/taonier-logo-magic-dot-concepts/
+├─ taonier-logo-magic-dot-contact-sheet.png
+├─ taonier-magic-dot-orbit.png
+├─ taonier-magic-dot-seal.png
+├─ taonier-magic-dot-squish.png
+├─ taonier-magic-dot-mold.png
+└─ taonier-magic-dot-bloom.png
+
+public/branding/taonier-logo-flat-concepts/
+├─ taonier-logo-flat-contact-sheet.png
+├─ taonier-flat-play-clay.png
+├─ taonier-flat-spark-clay.png
+├─ taonier-flat-meme-smile.png
+├─ taonier-flat-loop-mold.png
+└─ taonier-flat-seal-blocks.png
+
+public/branding/taonier-logo-concepts/
+├─ taonier-logo-contact-sheet.png
+├─ taonier-clay-spark.png
+├─ taonier-play-mold.png
+├─ taonier-meme-bubble.png
+├─ taonier-creation-loop.png
+└─ taonier-premium-seal.png
+```
+
+生成脚本：
+
+```text
+scripts/generate-taonier-logo-concepts.mjs
+```
+
+## 3. V3-03 一捏成型延展
+
+这一组专门沿 V3 “一捏成型”继续打磨。目标是保留“两个软形触点 + 中央作品核”的成型瞬间，同时降低括号感、碰撞特效感和功能按钮感。
+
+![陶泥儿 Logo 一捏成型延展总览](../../public/branding/taonier-logo-magic-dot-concepts/taonier-logo-magic-dot-contact-sheet.png)
+
+### 3.1 捏合星核
+
+![捏合星核](../../public/branding/taonier-logo-magic-dot-concepts/taonier-magic-dot-orbit.png)
+
+定位：一捏成型方向的主标首选。
+
+这个方向最稳地保留了“左右合拢、中央成型”的核心动作，中心青绿色星核形成了明确焦点，整体比原 V3-03 更完整，也没有明显播放器、聊天或表情联想。
+
+优点：
+
+- 结构清楚，第一眼能看出“合拢生成”。
+- 元素少，小尺寸适配潜力好。
+- 中央星核可以做加载、生成成功、发布完成等动效延展。
+
+风险：
+
+- 左右软形仍有一点括号感，后续矢量化可把外轮廓做得更不对称、更像被捏塑的软泥。
+
+建议用途：主 Logo 备选首选、AI 生成按钮、启动动效核心符号。
+
+### 3.2 成型印记
+
+![成型印记](../../public/branding/taonier-logo-magic-dot-concepts/taonier-magic-dot-seal.png)
+
+定位：完整主标感最强的延展方向。
+
+这个方向把左右触点收成一个更完整的软形图腾，减少了“两个括号”的割裂感。视觉上更像独立品牌符号，但也因此少了一点“捏合动作”的即时感。
+
+建议用途：主 Logo 强备选；若选择它，后续应去掉背景底色并强化中心负形星点。
+
+### 3.3 软泥合拍
+
+![软泥合拍](../../public/branding/taonier-logo-magic-dot-concepts/taonier-magic-dot-squish.png)
+
+定位：轻松、年轻、动效友好。
+
+这个方向的上下软形更活泼，适合表达“啪嗒一下成型”。但静态 Logo 中的黄色星点和短线略像特效贴纸，主标使用前需要继续简化。
+
+建议用途：生成中动效、运营图、互动反馈，不建议直接定为主 Logo。
+
+### 3.4 灵感模口
+
+![灵感模口](../../public/branding/taonier-logo-magic-dot-concepts/taonier-magic-dot-mold.png)
+
+定位：最有“模口 / 造物容器”意味。
+
+这个方向图形独特，和“从软泥模口里生成作品”的隐喻贴合。但外形复杂度比 01、02 更高，边缘细节在小尺寸下可能损失。
+
+建议用途：主 Logo 备选探索，适合继续做专业矢量简化。
+
+### 3.5 捏开灵感
+
+![捏开灵感](../../public/branding/taonier-logo-magic-dot-concepts/taonier-magic-dot-bloom.png)
+
+定位：温和、包裹、生成容器。
+
+这个方向亲和、平衡，但整体像眼睛 / 容器 / 开合结构，陶泥儿的“捏”动作弱一些。
+
+建议用途：AI 生成入口、等待态、创作容器辅助图形。
+
+## 4. V3 抽象主标候选
+
+V3 根据评审反馈重新避开了五个问题：播放三角、褐色陶土主色、聊天气泡 / 表情包、循环符号，以及过多碎元素。方向转为更抽象、更亮眼、更像长期主 Logo 的符号。
+
+![陶泥儿 Logo V3 概念总览](../../public/branding/taonier-logo-v3-concepts/taonier-logo-v3-contact-sheet.png)
+
+### 4.1 灵感捏痕
+
+![灵感捏痕](../../public/branding/taonier-logo-v3-concepts/taonier-v3-finger-spark.png)
+
+定位：主 Logo 首选。
+
+这个方向用醒目的珊瑚红软形、指纹捏痕和星点负形建立记忆点。它不再依赖“陶泥的褐色”，而是用“被捏过的痕迹”表达陶泥儿的核心动作：用户把脑洞捏成作品。
+
+优点：
+
+- 第一眼足够醒目，远离旧版褐色和播放器感。
+- 指纹捏痕有独特性，能承接“人人创作”和“亲手塑形”。
+- 元素少，适合继续矢量化和小尺寸适配。
+
+风险：
+
+- 指纹弧线后续需要进一步简化，避免在 24px 以下变糊。
+- 星点比例要克制，避免变成普通灵感图标。
+
+建议用途：主 Logo、App icon、平台顶栏、启动页、生成按钮。
+
+### 4.2 脑洞种子
+
+![脑洞种子](../../public/branding/taonier-logo-v3-concepts/taonier-v3-seed-pop.png)
+
+定位：创意生长与新手友好。
+
+这个方向从“灵感发芽”切入，比陶泥更偏创造生命力。它亲和、可爱，但容易让用户联想到教育、植物、儿童启蒙或种植类产品。
+
+建议用途：新手引导、创作孵化、儿童 / 寓教于乐支线，不建议作为主 Logo。
+
+### 4.3 一捏成型
+
+![一捏成型](../../public/branding/taonier-logo-v3-concepts/taonier-v3-magic-dot.png)
+
+定位：AI 把灵感合成为作品的瞬间。
+
+这个方向很简洁，用左右两个软形触点和中心星点表达“捏合”。它避开了播放器和聊天气泡，也能做动效，但静态图形目前稍像碰撞特效或括号，需要继续重绘增强独特轮廓。
+
+建议用途：生成按钮、AI 施法动效、主 Logo 备选微调方向。
+
+### 4.4 作品胶囊
+
+![作品胶囊](../../public/branding/taonier-logo-v3-concepts/taonier-v3-work-gem.png)
+
+定位：精品内容和作品沉淀。
+
+这个方向更稳、更精品，青绿色也比褐色更吸睛。但整体像水滴、宝石或通用内容图标，和“捏”这个动作的关系弱。
+
+建议用途：精选作品、作品库、创作者中心，不建议优先做主 Logo。
+
+### 4.5 软体 T 形
+
+![软体 T 形](../../public/branding/taonier-logo-v3-concepts/taonier-v3-soft-t.png)
+
+定位：英文辅助名 / Taonier 的抽象首字母。
+
+这个方向试图做更品牌化的抽象符号，但当前形体还不够自然，也未形成足够强的“陶泥儿”心智。若未来英文名确定为 `Taonier` 或类似形式，可以继续沿这个方向做专业字母标重绘。
+
+建议用途：英文标识探索，不作为当前主 Logo 首选。
+
+## 5. V2 扁平矢量候选
+
+第一批图形偏 3D 和拟物，更适合作为吉祥物、运营图或启动页气氛图，不适合作为长期主 Logo。V2 已把约束收紧为扁平、矢量、少元素、强轮廓和小尺寸可识别。
+
+![陶泥儿 Logo 扁平概念总览](../../public/branding/taonier-logo-flat-concepts/taonier-logo-flat-contact-sheet.png)
+
+### 5.1 扁平开捏
+
+![扁平开捏](../../public/branding/taonier-logo-flat-concepts/taonier-flat-play-clay.png)
+
+定位：最直接的主 Logo 候选。
+
+这个方向用一团柔软陶泥承载播放符号，用户一眼能理解“点开玩 / 马上玩”，同时外形保留“捏出来”的不规则软泥感。
+
+优点：
+
+- 识别速度最快，移动端小尺寸也成立。
+- 符合主流 App Logo 语言，亲和、不重、不技术冷。
+- 和“把脑洞捏成小游戏”的主张绑定最强。
+
+风险：
+
+- 播放符号是常见母题，后续矢量化时要通过不规则软泥外轮廓、颜色和字标形成独特资产。
+
+建议用途：主 Logo 首选、App icon、平台顶栏、分享卡片角标。
+
+### 5.2 灵感泥星
+
+![灵感泥星](../../public/branding/taonier-logo-flat-concepts/taonier-flat-spark-clay.png)
+
+定位：AI 创作与灵感生成。
+
+这个方向比“扁平开捏”更品牌化，中心负形星点表达灵感、AI 生成和创意爆发。它没有播放符号那么直白，但更容易和“陶泥儿”的创作平台气质绑定。
+
+优点：
+
+- 图形更简洁，品牌记忆点强。
+- 陶泥心智、AI 灵感和精品感比较平衡。
+- 适合未来扩成字标、启动页和生成态动效。
+
+风险：
+
+- 对“小游戏/马上玩”的表达弱于播放符号。
+
+建议用途：主 Logo 强备选、创作首页、AI 生成按钮和品牌主视觉。
+
+### 5.3 造梗笑泥
+
+![造梗笑泥](../../public/branding/taonier-logo-flat-concepts/taonier-flat-meme-smile.png)
+
+定位：社交传播和玩梗亲和力。
+
+这个方向的气泡与笑脸非常亲和，适合表达“分享快乐”和“造梗”。但它和聊天、社区类产品的通用图形过近，作为主 Logo 可能会让用户误判产品品类。
+
+建议用途：社区、评论、分享、活动贴纸，不建议做主 Logo。
+
+### 5.4 共创泥环
+
+![共创泥环](../../public/branding/taonier-logo-flat-concepts/taonier-flat-loop-mold.png)
+
+定位：AI 与用户共创闭环。
+
+这个方向表达共创与循环，但生成结果带有偏柔和彩虹渐变的视觉倾向，与“陶泥儿”的软泥名称关联不够直观，也不如 01/02 容易记住。
+
+建议用途：创作流程、共创能力、生成进度辅助图形。
+
+### 5.5 精品泥印
+
+![精品泥印](../../public/branding/taonier-logo-flat-concepts/taonier-flat-seal-blocks.png)
+
+定位：精品作品和内容集合。
+
+这个方向像内容平台或作品库入口，能表达图片、用户、游戏等多形态内容。但图形元素较多，主标识别不如 01/02 凝练。
+
+建议用途：精选作品、作品集、创作者中心、内容品质标识。
+
+## 6. V1 立体探索
+
+### 6.1 灵感陶团
+
+![灵感陶团](../../public/branding/taonier-logo-concepts/taonier-clay-spark.png)
+
+定位：AI 共创与灵感造物。
+
+这个方向把“陶泥”作为主视觉，内部用发光火花和节点表达 AI 赋能。它最贴“陶泥儿”名字本身，也能说明平台不是普通小游戏集合，而是从灵感生成作品的创作容器。
+
+优点：
+
+- 与“陶泥儿”的名称绑定最强。
+- 有 AI、创作、造物的综合含义。
+- 适合启动页、品牌介绍、创作首页空状态。
+
+风险：
+
+- 小尺寸下细节偏多，需要后续矢量化时压缩节点和纹理。
+- 如果色彩处理不当，会回到手工陶艺联想。
+
+建议用途：品牌主视觉备选、官网/启动页、创作入口图形。
+
+### 6.2 开玩模具
+
+![开玩模具](../../public/branding/taonier-logo-concepts/taonier-play-mold.png)
+
+定位：把脑洞捏成小游戏。
+
+这个方向用软陶捏出播放符号，最直接地连接“创作”和“马上玩”。它比单纯陶泥团更有产品动作，也更适合轻休闲、小游戏、短内容传播。
+
+优点：
+
+- 识别强，小尺寸也清楚。
+- 与轻度休闲小游戏的关系最直接。
+- 适合作为 App icon 和主 Logo 图形。
+
+风险：
+
+- 播放符号相对常见，需要后续在外轮廓、捏痕和色彩上做独特性。
+- 如果三角形过硬，会削弱“陶泥儿”的柔软感。
+
+建议用途：主 Logo 首选、App icon、分享卡片角标、加载态图形。
+
+### 6.3 造梗气泡
+
+![造梗气泡](../../public/branding/taonier-logo-concepts/taonier-meme-bubble.png)
+
+定位：社交传播、玩梗、裂变。
+
+这个方向把陶泥变形成聊天气泡和表情，强调“梗”和“传播”。它最有社交平台感，也适合表情包、活动贴纸和运营视觉。
+
+优点：
+
+- 传播感强，年轻、轻松、容易做 IP 化。
+- 能承接社区、评论、分享和玩梗场景。
+- 比较容易延展成贴纸和表情包。
+
+风险：
+
+- 偏软萌，可能削弱“精品 AI 创作平台”的质感。
+- 作为主 Logo 容易显得像聊天或表情产品。
+
+建议用途：社区模块、活动运营、IP 辅助形象，不建议作为唯一主 Logo。
+
+### 6.4 共创回路
+
+![共创回路](../../public/branding/taonier-logo-concepts/taonier-creation-loop.png)
+
+定位：AI 与用户共同迭代生成。
+
+这个方向用软陶带形成循环和造物轨迹，表达“灵感 -> AI 塑形 -> 用户修改 -> 作品传播”的闭环。它比其他方向更抽象，也更有平台级和工具级气质。
+
+优点：
+
+- 高级、简洁，避免儿童化。
+- 适合表达 AI 共创、迭代和作品循环。
+- 可用于创作者工作台或生成进度标识。
+
+风险：
+
+- 与“陶泥儿”名称的直观关联较弱。
+- 缺少小游戏和玩梗的即时识别。
+
+建议用途：创作流程标识、AI 共创能力图标、品牌辅助图形。
+
+### 6.5 精品泥印
+
+![精品泥印](../../public/branding/taonier-logo-concepts/taonier-premium-seal.png)
+
+定位：精品内容、作品认证、创作者成果。
+
+这个方向像一个被压印的软陶徽章，中间有方块和火花，比较适合表达“作品被打磨成型”。它的内容平台感强于游戏入口感。
+
+优点：
+
+- 精品感和作品库气质较强。
+- 适合作品认证、精选、创作者徽章。
+- 与“陶泥压印”隐喻相对自然。
+
+风险：
+
+- 细节较多，主 Logo 小尺寸可读性不如“开玩模具”。
+- 徽章感偏静态，轻休闲的即时性稍弱。
+
+建议用途：精选作品标识、创作者荣誉、内容品质标签。
+
+## 7. 推荐结论
+
+优先级建议：
+
+```text
+主 Logo 首选：V3 01 灵感捏痕
+一捏成型首选：V3-03 延展 01 捏合星核
+完整主标备选：V3-03 延展 02 成型印记
+英文标识探索：V3 05 软体 T 形
+精品内容辅助：V3 04 作品胶囊
+新手 / 寓教于乐辅助：V3 02 脑洞种子
+```
+
+若要兼顾主流、亲和、醒目和“陶泥儿”的动作隐喻，优先继续打磨 V3 “灵感捏痕”。
+若想把 Logo 做得更抽象、更像 AI 生成瞬间，可以继续打磨 V3-03 延展中的“捏合星核”或“成型印记”。
+V1 的 3D 图标不建议直接作为主 Logo，只适合做运营图、吉祥物探索或风格参考；V2 的播放、气泡、碎元素方向本轮已降级为历史探索。
+
+## 8. 后续落地建议
+
+1. 先围绕 V3 “灵感捏痕”做 3 到 5 个专业矢量微调版：减少指纹线条、强化软形轮廓、测试深色 / 浅色底。
+2. 同步对 V3-03 “捏合星核”做一版更独特的轮廓重绘，弱化括号感，保留中央成型星核。
+3. 字标不要直接使用生图结果，应单独设计“陶泥儿”中文字标，并准备英文辅助名。
+4. 正式应用前做商标近似检索，重点覆盖第 9、35、38、41、42 类。
+5. 若确认替换“百梦”，再更新现有命名规范文档、前端品牌组件、HTML metadata、后台和后端默认文案。
@@ -0,0 +1,5 @@
+生成一张适合商业路演 PPT 使用的横版高清主视觉配图，主题是“陶泥：将 Harness Engineering 理论、专家知识、多 Agent 调度融入 AI 创作工具与 AI 原生游戏框架”。
+画面构图：深色但清爽的现代科技工作室/游戏创作中枢，中心是一个温润陶泥质感的抽象核心装置，核心装置连接两条清晰的知识管线。左侧表现 AI 创作工具：多 Agent 协作节点、策划 SOP、美术 SOP、模板框架、剧本/数值/系统/角色/场景/CG 等垂类任务以图标化模块呈现。右侧表现 AI 原生游戏框架：实时剧情生成、数值与剧情对齐、画面与剧情对齐、实时任务与物品生成，以游戏世界投影、角色剪影、场景画面和规则约束网格呈现。
+底部远景加入克制的学术评审氛围：讲台、投影、评审席、优秀课程设计的荣誉感，但不要出现真实学校校徽、真实教授肖像或任何可识别真实人物。
+视觉风格：高端产品发布会 Key Visual，精致 3D 插画结合轻量界面光效，专业、可信、面向 AI 游戏与创作者工具，色彩使用陶土暖色、青绿色、冷白光和少量金色点缀，信息结构清楚，主体居中偏左，右上和左上保留干净留白用于 PPT 叠加标题。
+要求：无文字、无字母、无水印、无 UI 按钮、无品牌 logo、无真实校徽、无真实人物肖像、避免杂乱、避免过暗、避免卡通幼稚、避免纯抽象背景。
@@ -142,6 +142,15 @@
  4. 说明
  5. 标签

+## 6.3 草稿页作品卡对齐分类列表
+- 草稿 Tab 的作品架要优先对齐发现页分类列表的横向卡片：内容层承载标题/状态/类型/摘要，封面作为右半区半透明背景层。
+- 草稿卡不能为了视觉对齐丢掉原有信息：删除、分享、已发布统计、拼图积分激励、未读红点都要保留；其中删除属于低频动作，常态不显示按钮，长按列表项后进入独立动作面板；已发布作品右上角可以常驻分享图标。
+- 卡片右侧不再常驻“继续创作”“查看详情”“查看进度”等动作按钮，打开作品由整张卡片承担。
+- 移动端保持单列列表；网页端使用多列卡片式网格，避免在宽屏上把作品卡拉成一整行长条。
+- 生成中的状态使用整卡蒙版、旋转等待符号和“生成中...”标识；蒙版只能作为状态层，不能替换或移除卡片本身的信息。
+- 草稿卡复用分类页基础类名时，要用 `.creation-work-card.platform-category-game-item` 覆盖分类页移动端三列规则；否则正文会被当作封面列压缩，中文标题会断成一两个字一行。
+- 右侧封面不要只依赖 `img` fallback，容器层也要有玩法参考图 CSS 背景兜底，私有资源换签失败或图片 onerror 时仍能看到封面视觉；封面层适合绝对定位铺到卡片右半区，作为半透明背景从右到左渐隐，不应出现独立方形边界或参与内容排版。
+
 ## 7. 样式与动画经验

 ### 7.1 轮播动画要连续，不要离散
@@ -226,3 +235,12 @@
 - 主站移动端以固定游戏画布体验为准，入口 `viewport` 需要锁定 `minimum-scale=1.0`、`maximum-scale=1.0` 和 `user-scalable=no`，同时保留 `viewport-fit=cover` 适配安全区。
 - 浏览器仍可能通过 iOS `gesture*` 或多指 `touchmove` 触发整页缩放，因此主站启动入口应统一调用 `lockMobileViewportZoom()` 拦截页面级捏合与快速双击缩放。
 - 不要在每个画布组件里重复注册缩放拦截；单指滚动、点击、拖拽应继续留给具体页面和玩法处理。
+
+### 10.4 移动端输入法不要压缩画布
+- 平台主站点击输入框弹出输入法时，不能让 `100dvh` 跟随键盘缩小后重新压缩整页布局。
+- 正确做法是在输入法未打开时记录稳定布局高度，输入法打开期间保持画布高度不变，只根据当前输入框位置计算画面上移量。
+- 该行为应在主站入口统一注册，业务组件只保留普通 `input` / `textarea`，不要在每个输入框里重复写键盘适配逻辑。
+
+### 10.5 移动端创作生成页不要暴露批次视角
+- 拼图、抓大鹅这类轻量玩法的草稿生成页只保留“预计等待”和“计时”两个用户关心的状态，移动端放在同一行；不要默认展示“当前批次”这类模型执行视角。
+- 生成步骤在移动端进入页面时按顺序从左侧滑入，强化“正在推进”的节奏；动画只绑定步骤卡，不影响桌面端密集布局和其它信息卡。
@@ -198,13 +198,13 @@ Match3D 首版参考拼图后期的入口表单收集方式，而不是早期的

 ## 6.3 参考图片

-抓大鹅入口页不展示参考图片上传。题材表现由题材文本和草稿切割图片链路承接；草稿生成阶段会生成多视角 2D 物品素材并写入作品 profile。结果页 `素材配置 > 物品` 继续承接物品素材预览、删除、批量新增和音效配置。
+抓大鹅入口页不展示参考图片上传。题材表现由题材文本和草稿切割图片链路承接；草稿生成阶段会生成多视角 2D 物品素材并写入作品 profile。结果页 `素材配置 > 物品` 继续承接物品素材预览、删除和批量新增；点击音效配置当前临时隐藏。

 ## 6.4 生成音效入口

 抓大鹅入口页不展示 `生成音效` Toggle。草稿生成阶段只保存 `generatedItemAssets[].soundPrompt`，不调用 Vidu 生成点击音效，也不产生点击音效相关扣费。

-结果页仍保留单个物品音效的手动补生成入口。用户在 `素材配置 > 物品` 详情面板中生成点击音效时，后端复用通用创作音频接口和资产落点，把结果写入对应 `generatedItemAssets[].clickSound`。
+结果页当前不保留单个物品音效的手动补生成入口。历史 `generatedItemAssets[].clickSound` 字段继续兼容传递给运行态；后续恢复音效能力时再复用通用创作音频接口和资产落点。

 ---

@@ -239,7 +239,7 @@ Match3D 首版参考拼图后期的入口表单收集方式，而不是早期的

 生成出的独立图片必须作为结果页 `素材配置 > 物品` 的预览资产返回。图片素材生成成功时 `generatedItemAssets[].status = image_ready`，并携带 `imageViews[]`，兼容字段 `imageSrc` / `imageObjectKey` 指向首张视角图；正式平台资产绑定和更完整的二次编辑流程以后续技术方案为准。

-局内 UI 生成分为两类图片：`9:16` 纯背景图和 `1:1` 中心容器 UI 图。纯背景图只表现题材氛围和环境，不得生成锅、圆盘、托盘、拼图槽、物品槽、HUD、文字、按钮、倒计时、分数或物品；中心容器 UI 图单独生成，贴合题材设定，用于覆盖运行态默认圆形竞技容器。容器图必须参考 `public/match3d-background-references/pot-fused-reference.png` 的大尺寸轻俯视构图：容器外轮廓接近画布四边，宽度约占画布 `86%-92%`、高度约占 `82%-90%`，内口为横向椭圆，不能生成小圆盘、正俯视扁盘、侧视碗或小托盘。底部备选栏、顶部控件和拼图/物品槽位继续使用运行态默认 UI，不烘进生成背景。
+局内 UI 生成分为两类图片：`9:16` 纯背景图和 `1:1` 中心容器 UI 图。纯背景图只表现题材氛围和环境，不得生成锅、圆盘、托盘、拼图槽、物品槽、HUD、文字、按钮、倒计时、分数或物品；中心容器 UI 图单独生成，贴合题材设定，用于覆盖运行态默认圆形竞技容器。容器图必须通过 VectorEngine `/v1/images/edits` multipart 图生图生成，并参考 `public/match3d-background-references/pot-fused-reference.png` 的大尺寸轻俯视构图：容器外轮廓接近画布四边，宽度约占画布 `86%-92%`、高度约占 `82%-90%`，内口为横向椭圆，不能生成小圆盘、正俯视扁盘、侧视碗或小托盘。底部备选栏、顶部控件和拼图/物品槽位继续使用运行态默认 UI，不烘进生成背景；容器图成功加载后，运行态默认圆形锅壳不得再覆盖或裁切生成容器。

 ## 7.4 发布前试玩

@@ -728,7 +728,7 @@ GET /api/runtime/match3d/runs/:runId
 3. 入口页不展示参考图上传。
 4. 内置风格显示画风参考图，自定义风格通过独立面板填写并进入提交 payload。
 5. 移动端入口页所有内容一屏展示，不产生纵向滚动。
-6. 入口页不展示 `生成音效` Toggle；草稿生成不产生 `clickSound`，结果页物品详情仍可手动生成点击音效。
+6. 入口页不展示 `生成音效` Toggle；草稿生成不产生 `clickSound`，结果页物品详情当前也不展示点击音效生成入口。
 7. 系统可生成待发布结果页，并在草稿中返回首批多视角 2D 切割图片素材预览。
 8. 用户可编辑游戏名称、标签、封面图等基础信息。
 9. 用户可发布前试玩，且试玩失败不阻断发布。
@@ -348,6 +348,7 @@ interface PuzzleAnchorPack {
 7. 历史拼图素材库读取 `asset_kind = puzzle_cover_image` 的资产记录，只用于选择参考图，不直接替换正式图。
 8. 从历史素材库选择素材后，前端把该素材的 `imageSrc` 作为 `referenceImageSrc` 传入下一次生成请求。
 9. 本地上传参考图与历史素材参考图互斥；后选择者覆盖先选择者。
+10. 历史素材列表的图片名称必须从 `imageSrc` 的路径末尾推导，不能把 `ownerLabel` 账号归属文案当成图片名称；生成时间必须兼容 SpacetimeDB 秒级时间字符串。

 前端 UI 规则：

@@ -0,0 +1,101 @@
+# 宝贝爱画寓教于乐独立关卡 PRD 2026-05-13
+
+## 1. 目标
+
+新增寓教于乐内容线独立关卡：
+
+```text
+宝贝爱画
+```
+
+工程 ID 固定为：
+
+```text
+baby-love-drawing
+```
+
+该关卡默认出现在“发现 / 寓教于乐”板块下方。当前阶段只做本地 Demo 保存，验证完成后再补正式持久化。
+
+## 2. 关卡结构
+
+启动宝贝爱画后进入绘画运行态：
+
+1. 屏幕中央是带边框的空白画板；
+2. 画板边框内是可绘画区域；
+3. 画板外左侧展示彩虹 7 色；
+4. 画板外右侧中下方展示画笔和橡皮；
+5. 用户进入内容后默认手持画笔；
+6. 手持画笔或橡皮时，屏幕上实时显示跟随右手位置的工具图案标识。
+
+## 3. 输入规则
+
+颜色选择：
+
+1. 仅检测左手；
+2. 左手悬停在某个颜色区域 1.5 秒后，选中该颜色；
+3. 颜色固定为彩虹 7 色。
+
+工具切换：
+
+1. 右手移动到画笔或橡皮工具区域；
+2. 右手握拳后，将手里的工具切换为对应工具。
+
+绘画与擦除：
+
+1. 右手在画布区域握拳时，当前工具生效；
+2. 当前工具为画笔时留下轨迹；
+3. 当前工具为橡皮时擦除轨迹；
+4. 右手张开时，画笔或橡皮抬起，不在画布上生效。
+
+按钮选择：
+
+1. 完成；
+2. 使用绘画魔法；
+3. 保存；
+4. 再画一张；
+5. 返回。
+
+以上按钮都使用任一手悬停 2 秒完成选中。
+
+## 4. 绘画魔法
+
+用户完成绘画后，可使用“绘画魔法”。
+
+绘画魔法使用 image-2，以用户绘画内容和笔触轨迹生成对应绘本风格图片内容。
+
+前端不得直接读取、拼接或暴露图片生成密钥。image-2 调用必须通过后端代理。
+
+## 5. 保存规则
+
+当前只做本地 Demo 保存。
+
+保存规则：
+
+1. 魔法生成前保存，只保存一张原图；
+2. 若用户未保存原图，直接点击魔法生成，则魔法生成后保存时同时保存原图和魔法图；
+3. 保存完毕后，可继续“再画一张”或“返回”。
+
+## 6. 展示与开关
+
+宝贝爱画只属于寓教于乐内容线。
+
+`VITE_ENABLE_EDUTAINMENT_ENTRY` 关闭时：
+
+1. 不展示“发现 / 寓教于乐”频道；
+2. 不展示宝贝爱画默认卡片；
+3. 不允许通过 `/runtime/baby-love-drawing` 直达运行态。
+
+## 7. 验收
+
+1. 寓教于乐开启时，“发现 / 寓教于乐”下方展示“宝贝爱画”默认关卡卡片；
+2. 寓教于乐关闭时，不展示宝贝爱画，也不能直达运行态；
+3. 进入后展示空白画板、彩虹 7 色、画笔和橡皮；
+4. 默认工具为画笔；
+5. 左手悬停颜色 1.5 秒后选中颜色；
+6. 右手移动到工具区并握拳后切换画笔或橡皮；
+7. 右手握拳在画布内绘制或擦除，张开时不生效；
+8. 任一手悬停按钮 2 秒后触发按钮；
+9. 完成后可保存原图；
+10. 完成后可使用绘画魔法生成绘本风格图片；
+11. 未保存原图直接使用绘画魔法后，保存会同时保存原图和魔法图；
+12. 保存后可再画一张或返回。
@@ -29,11 +29,24 @@
 2. 模板名称：`宝贝识物`；
 3. 两个物品；
 4. 两个物品图；
-5. 作品标签。
+5. 游戏视觉主题包；
+6. 作品标签。

-物品图使用 VectorEngine `gpt-image-2-all` / image-2 生成。图片生成只能走后端或后续后端预留接口，前端不得泄露 `VECTOR_ENGINE_API_KEY`。
+物品图使用 VectorEngine `gpt-image-2-all` / image-2 生成。图片生成只能走后端接口，前端不得读取、拼接或暴露 `VECTOR_ENGINE_API_KEY`。

-本地 Demo 阶段若真实生图接口未接入完成，允许前端 service 返回明确标记为 `placeholder` 的占位图形，用于打通创作到结果页的交互链路；该占位结果不得伪装成正式 image-2 资产。
+每个关键词只生成一张围绕该关键词的单一物品形象。生成 prompt 必须锁定寓教于乐板块统一的卡通绘本草地舞台插画风，但最终画面不生成背景、场景、氛围渲染、人物、手、篮子、礼物盒、文字、水印或 UI。服务端必须把生成结果转成透明 PNG，并执行透明抠图后处理；只有透明抠图后的素材才允许写入草稿 `itemAssets` 并进入游戏运行态。
+
+同一次创作还必须使用 image-2 生成游戏视觉主题包，包含背景环境、UI 装饰框、礼物盒、篮子和烟雾弹出特效资源。主题包必须继续保持寓教于乐插画风，并根据用户填写的两个物品关键词匹配主题：例如关键词偏动漫角色或玩具时，背景环境和元素可使用动漫、玩具主题；关键词偏水果时，背景环境和元素可匹配果园、自然主题；其它关键词按其语义匹配合适主题。主题包不得改变关卡玩法规则，不新增文字说明、额外按钮或额外判定规则。
+
+视觉主题包的资源边界：
+
+1. 背景环境图不做透明抠图，但必须保证屏幕中间、中下方和底部左右篮子区域清爽，不遮挡放大后的物品、礼物盒和篮子；
+2. UI 装饰框用于字幕条和计数器风格化包装，只生成装饰边框和主题点缀，不生成文字、数字或按钮；
+3. 礼物盒资源输出为透明 PNG，运行态按当前礼盒视觉的 2 倍尺寸展示，素材主体必须饱满清晰；
+4. 篮子资源输出为透明 PNG，运行态按当前篮子视觉的 1.5 倍尺寸展示，左右篮子仍固定为两个物品对应选项，篮子造型资源可以复用同一张主题篮子图；
+5. 烟雾弹出特效资源输出为透明 PNG，用于礼物盒打开瞬间覆盖开盒区域并承接中央物品弹出，不生成物品、篮子、礼物盒或文字。
+
+当前本地 Demo 阶段已接入真实 image-2 资源链路。创作提交必须成功获得 `generationProvider = "vector-engine-gpt-image-2"` 的两个物品透明 PNG 和完整视觉主题包后，才能进入结果页、试玩或发布；若后端接口、登录态、VectorEngine 配置或上游生成失败，前端必须停留在生成失败状态并展示错误，不得静默回退为占位图。历史草稿中若仍存在 `generationProvider = "placeholder"` 的占位资源，结果页必须提示重新生成，试玩和发布前必须先补齐 image-2 资源。

 ## 4. 标签规则

@@ -63,6 +76,8 @@

 试玩按钮进入宝贝识物首关运行态，运行态消费当前草稿中的两个物品名称和两张物品图，不重新生成或改写物品内容。

+若草稿包含视觉主题包，运行态还必须消费该主题包中的背景环境、UI 装饰、礼物盒、篮子和烟雾弹出特效资源；旧草稿或接口失败时允许回退到当前 CSS 绘本风兜底。
+
 ## 6. 发布后体验

 发布完成后作品应进入寓教于乐内容线，并在寓教于乐入口开启时可被板块消费。
@@ -73,27 +88,30 @@

 本 PRD 同步约束首关运行态，已确认规则包括：

-1. 礼物盒打开在本地调试绑定 `F` 键；
+1. 进入关卡后礼物盒自动打开并弹出首个随机物品；
 2. 每轮仅中间礼物盒跳出的物品随机；左右两侧篮子固定为当前草稿两个物品的顺序；
 3. 下一关按钮当前占位；
 4. 不新增用户未确认的计时、失败次数、分数、体力或难度递增。
 5. 屏幕中上方字幕固定为“将物品放入对应的篮子里”。
-6. 礼物盒位于屏幕中下方，任意手抬起后打开并跳出下一个随机物品。
+6. 礼物盒位于屏幕中下方并按当前视觉放大一倍，首次进入关卡和每次正确反馈结束后的新轮次都从上方落下后自动打开。
 7. 屏幕下方左侧和右侧分别展示两个固定篮子，左侧固定使用草稿第一个物品图，右侧固定使用草稿第二个物品图。
-8. 明确左手连续横向移动达到阈值时将当前物品送入左侧篮子，明确右手连续横向移动达到阈值时将当前物品送入右侧篮子；选篮不使用动作名判定，侧别未知的手部轨迹不参与选篮。
-9. 正确时展示“真棒”字幕和正确特效；错误时展示“再想一想吧”字幕和错误特效，物品回到中央。
-10. 成功 20 次后展示“恭喜你！小朋友！”字幕和特效，并展示“再来一次”和“下一关”按钮。
-11. 当前本地 Demo 阶段音效与语音播报接口只预留调用点，不在前端写死外部硬件或服务接口。
+8. 左右篮子按当前视觉放大 50%。
+9. 礼物盒打开时播放烟雾特效，中央物品从烟雾特效中弹出；物品弹出后礼物盒从舞台移除。
+10. 明确左手连续横向移动达到阈值时将当前物品送入左侧篮子，明确右手连续横向移动达到阈值时将当前物品送入右侧篮子；选篮不使用动作名判定，侧别未知的手部轨迹不参与选篮。
+11. 正确时展示“真棒”字幕和正确特效；错误时展示“再想一想吧”字幕和错误特效，物品回到中央。
+12. 成功 20 次后展示“恭喜你！小朋友！”字幕和特效，并展示“再来一次”和“下一关”按钮。
+13. 当前本地 Demo 阶段音效与语音播报接口只预留调用点，不在前端写死外部硬件或服务接口。

 ## 8. 验收

 1. 创作入口显示 `宝贝识物` 并可进入模板表单。
 2. 未填写任一物品名称时不能生成草稿。
 3. 生成草稿后进入结果页，展示两个物品名称和物品图。
-4. 草稿标签中始终包含精确 `寓教于乐`。
-5. 发布 payload 始终包含精确 `寓教于乐`。
-6. 发布完成后出现分享弹窗或发布完成状态。
-7. 前端不读取或暴露 VectorEngine 密钥。
-8. 结果页试玩进入宝贝识物运行态，不再显示“试玩关卡正在接入中”。
-9. 运行态可通过 `F` 打开礼物盒，通过鼠标左键拖动映射左手横向移动，通过鼠标右键拖动映射右手横向移动。
-10. 成功 20 次后出现“再来一次”和“下一关”按钮。
+4. 生成草稿后包含视觉主题包，主题包含背景环境、UI 装饰框、礼物盒、篮子和烟雾弹出特效资源。
+5. 草稿标签中始终包含精确 `寓教于乐`。
+6. 发布 payload 始终包含精确 `寓教于乐`。
+7. 发布完成后出现分享弹窗或发布完成状态。
+8. 前端不读取或暴露 VectorEngine 密钥。
+9. 结果页试玩进入宝贝识物运行态，不再显示“试玩关卡正在接入中”。
+10. 运行态通过鼠标左键拖动映射左手横向移动，通过鼠标右键拖动映射右手横向移动。
+11. 成功 20 次后出现“再来一次”和“下一关”按钮。
@@ -4,7 +4,7 @@

 - 需求来源：用户提供的视频 `C:\Users\DSK\Videos\一款双方比狗叫的游戏 - 1.一款双方比狗叫的游戏(Av116504192360177,P1).mp4`，并已在 `.hermes/plans/2026-05-11_144229-bark-battle-2d-game-bdd-ddd-tdd-plan.md` 中完成抽帧分析和玩法方案整理。
 - 玩法定位：浏览器 2D 声控狗叫对战小游戏，暂定中文名 `汪汪声浪大作战`，英文代号与 play type ID 建议为 `bark-battle`。
- 核心玩法：双方狗狗在 30 秒限时内通过麦克风输入“狗叫声”进行声浪拔河；系统依据声音强度、有效叫声次数和叫声节奏计算推动力，实时推动顶部红蓝能量条；倒计时结束后按能量条位置判定胜负或平局。
+- 核心玩法：双方狗狗在 30 秒限时内通过麦克风输入“狗叫声”进行声浪拔河；系统依据声音强度、有效声浪触发次数和声浪节奏计算推动力，实时推动顶部红蓝能量条；倒计时结束后按能量条位置判定胜负或平局。
 - 文档目的：为产品、测试、前端、后端在编码前统一可验证验收口径；本文只定义 PRD/BDD 级行为与测试映射，不实现工程代码。

 ## 角色与目标
@@ -20,14 +20,14 @@
 ### 用户目标

 - 玩家可以在开局前完成麦克风授权和环境噪音校准。
- 玩家发出有效狗叫时，能看到叫声计数、狗狗动画、拟声词/冲击波以及能量条变化。
- 低于阈值的背景噪音不会被误计为有效叫声。
+- 玩家产生有效声浪触发时，能看到声浪计数、狗狗动画、拟声词/冲击波以及能量条变化。
+- 低于阈值的背景噪音不会被误计为有效声浪触发。
 - 单局在 30 秒后给出明确胜负、平局和关键数据。
 - 移动端和不支持麦克风的环境不会进入不可操作状态。

 ### 非目标

- MVP 不要求识别“是否真实狗叫”，不引入机器学习声纹/物种分类；有效输入以音量阈值、峰值间隔、持续时间和校准结果为准。
+- MVP 不要求识别“是否真实狗叫”，不引入机器学习声纹/物种分类；有效输入以音量阈值、峰值冷却间隔和校准结果为准。
 - MVP 不要求实时联机对战；可先按“玩家 vs AI 对手”完成单机浏览器 runtime。
 - MVP 不要求成绩持久化、作品发布、作品架、广场和排行榜；若后续接入 Genarrative 作品闭环，需要另补玩法类型集成 PRD/技术文档。
 - MVP 不要求在 UI 中长期展示大段规则说明；游戏界面应保持倒计时、能量条、狗狗、麦克风状态和结算信息为主。
@@ -38,10 +38,10 @@
 - 单局时长：默认 30 秒，从正式进入 `playing` 阶段开始计时。
 - 能量条：使用 `-100` 到 `100` 的连续值表示，负数偏对手侧，正数偏玩家侧，`0` 为中线。
 - 平局阈值：倒计时结束时，若能量条绝对值小于或等于 `drawThreshold`，判定平局；具体数值由实现配置，但测试需可注入固定阈值。
- 有效叫声：一次有效叫声至少满足：音量超过校准后的有效阈值、与上一次有效峰值间隔不小于 `minBarkGapMs`、持续时长在 `minBarkDurationMs` 到 `maxBarkDurationMs` 之间。
- 背景噪音：校准阶段采集到的环境声用于计算动态阈值；低于阈值的输入不得增加叫声次数，也不得让能量条出现可见推进。
- 推动力：玩家推动力由音量分数、有效叫声频率和连击加成组成；能量条按玩家推动力与对手推动力差值移动，并被限制在 `-100` 到 `100`。
- UI 反馈：有效叫声应触发可观察反馈，包括玩家侧狗狗张嘴/吠叫动画、拟声词或冲击波；反馈不应遮挡倒计时和顶部能量条。
+- 有效声浪触发：一次有效声浪触发满足：当前麦克风采样点的归一化响度达到或超过校准后的有效阈值，且与上一次有效声浪触发间隔不小于 `minBarkGapMs`；不再要求持续高响度时长达标，也不等待响度回落。
+- 背景噪音：校准阶段采集到的环境声用于计算动态阈值；低于阈值的输入不得增加声浪触发次数，也不得让能量条出现可见推进。
+- 推动力：玩家推动力由音量分数、有效声浪触发频率和连击加成组成；能量条按玩家推动力与对手推动力差值移动，并被限制在 `-100` 到 `100`。
+- UI 反馈：有效声浪触发应触发可观察反馈，包括玩家侧狗狗张嘴/吠叫动画、拟声词或冲击波；反馈不应遮挡倒计时和顶部能量条。

 ## 中文 Gherkin 场景

@@ -66,7 +66,7 @@
  场景: 校准完成后进入开局倒计时
    假如玩家已允许麦克风权限
    而且系统已采集足够的环境噪音样本
-    当校准计算出有效叫声阈值
+    当校准计算出有效声浪阈值
    那么系统应进入开局倒计时阶段
    而且倒计时结束后应进入 30 秒对战阶段
    而且初始能量条应位于中线
@@ -84,19 +84,19 @@
 功能: 环境噪音校准
  为了减少背景噪音误触发
  作为浏览器玩家
-  我希望游戏在开局前根据当前环境设置有效叫声阈值
+  我希望游戏在开局前根据当前环境设置有效声浪阈值

  场景: 安静环境生成低但非零的有效阈值
    假如校准阶段采集到的环境噪音 RMS 稳定低于默认噪音基线
    当系统完成校准
-    那么有效叫声阈值应高于环境噪音平均值
+    那么有效声浪阈值应高于环境噪音平均值
    而且阈值不应低于系统配置的最小阈值

  场景: 嘈杂环境生成更高的有效阈值
    假如校准阶段采集到的环境噪音 RMS 高于默认噪音基线
    当系统完成校准
-    那么有效叫声阈值应随环境噪音上调
-    而且低于该阈值的后续输入不应计为有效叫声
+    那么有效声浪阈值应随环境噪音上调
+    而且低于该阈值的后续输入不应计为有效声浪触发

  场景: 校准期间无法获得有效音频样本
    假如麦克风授权成功但音频样本持续为空或不可读
@@ -106,36 +106,36 @@
    而且不应直接开始对战
 ```

-### 功能: 有效叫声计数
+### 功能: 有效声浪触发计数

 ```gherkin
-功能: 有效叫声计数
-  为了把玩家的狗叫行为转换为可计分输入
+功能: 有效声浪触发计数
+  为了把玩家的声控行为转换为可计分输入
  作为玩家
-  我希望每次符合规则的短促叫声只被计数一次
+  我希望每次超过阈值且满足冷却的声浪触发只被计数一次

  背景:
    假如游戏处于 30 秒 playing 阶段
    而且系统已完成环境噪音校准

-  场景: 单次超过阈值且间隔足够的叫声计数加一
-    假如玩家当前叫声次数为 0
-    而且上一次有效叫声时间早于 minBarkGapMs
-    当麦克风输入出现一次超过有效阈值且持续时长合规的峰值
-    那么玩家叫声次数应变为 1
+  场景: 单次超过阈值且间隔足够的声浪触发计数加一
+    假如玩家当前声浪触发次数为 0
+    而且上一次有效声浪触发时间早于 minBarkGapMs
+    当某个麦克风采样点达到或超过有效阈值且满足声浪冷却
+    那么玩家声浪触发次数应变为 1
    而且玩家侧应出现一次吠叫动画反馈
    而且画面应出现一次拟声词或冲击波反馈

-  场景: 持续噪音不会被无限计数
-    假如玩家当前叫声次数为 1
-    当麦克风输入持续超过阈值但没有新的峰值间隔
-    那么玩家叫声次数不应在每个 tick 中持续增加
-    而且系统最多只应记录当前连续声音段内的一次有效叫声
+  场景: 持续高响度输入只按冷却节奏计数
+    假如玩家当前声浪触发次数为 1
+    当麦克风输入持续超过阈值但仍处于声浪冷却内
+    那么玩家声浪触发次数不应在每个 tick 中持续增加
+    而且系统只应在冷却结束后的采样点再次达阈值时记录下一次有效声浪触发

  场景: 间隔过短的连续峰值不重复计数
-    假如玩家刚刚产生一次有效叫声
-    当麦克风输入在 minBarkGapMs 内再次出现峰值
-    那么玩家叫声次数不应增加
+    假如玩家刚刚产生一次有效声浪触发
+    当麦克风输入在 minBarkGapMs 内再次达到有效阈值
+    那么玩家声浪触发次数不应增加
    而且连击或推动力不应因该峰值重复加成
 ```

@@ -145,23 +145,23 @@
 功能: 声浪推动能量条
  为了复刻双方比狗叫的核心体验
  作为玩家
-  我希望更响、更连续的有效叫声能把顶部能量条推向自己一侧
+  我希望更响、更高频的有效声浪触发能把顶部能量条推向自己一侧

  背景:
    假如游戏处于 30 秒 playing 阶段
    而且能量条当前位于中线

  场景: 玩家推动力高于对手时能量条向玩家侧移动
-    假如玩家在短时间窗口内产生多次有效叫声
+    假如玩家在短时间窗口内产生多次有效声浪触发
    而且玩家推动力高于对手推动力
    当系统推进一个 simulation tick
    那么能量条数值应向玩家侧增加
    而且顶部红蓝能量条的玩家侧占比应变大

-  场景: 连续大声叫声触发更强反馈
-    假如玩家连续产生多次高于强叫声阈值的有效叫声
+  场景: 连续强声浪触发触发更强反馈
+    假如玩家连续产生多次高于强声浪阈值的有效声浪触发
    当系统计算玩家连击加成
-    那么玩家侧推动力应高于单次普通叫声推动力
+    那么玩家侧推动力应高于单次普通声浪触发推动力
    而且玩家侧声浪或冲击波反馈应比普通叫声更明显
    但是反馈不应遮挡倒计时和能量条

@@ -185,31 +185,30 @@
 功能: 背景噪音过滤
  为了避免环境声替玩家自动得分
  作为玩家
-  我希望低于阈值或不合规的声音不会被当作有效狗叫
+  我希望低于阈值或处于冷却内的声音不会被当作有效声浪触发

  背景:
    假如游戏处于 30 秒 playing 阶段
    而且系统已完成环境噪音校准

  场景: 低于阈值的背景噪音不计数
-    当麦克风只接收到低于有效叫声阈值的背景噪音
-    那么玩家叫声次数不应增加
+    当麦克风只接收到低于有效声浪阈值的背景噪音
+    那么玩家声浪触发次数不应增加
    而且玩家侧不应播放吠叫动画
    而且能量条不应因为该背景噪音出现可见推进

-  场景: 过短脉冲不计为有效叫声
-    假如麦克风输入峰值超过有效阈值
-    但是持续时长短于 minBarkDurationMs
-    当系统完成该声音段判定
-    那么玩家叫声次数不应增加
+  场景: 冷却内重复达阈值不计数
+    假如玩家刚刚产生一次有效声浪触发
+    当麦克风输入在 minBarkGapMs 内再次达到有效声浪阈值
+    那么玩家声浪触发次数不应增加
    而且不应触发连击加成

-  场景: 过长持续声被削弱为单段输入
-    假如麦克风输入持续超过有效阈值
-    但是持续时长长于 maxBarkDurationMs
-    当系统完成该声音段判定
-    那么系统不应按多个叫声重复计数
-    而且该声音段的推动力应按持续噪音削弱规则处理
+  场景: 持续高响度输入只按冷却节奏产生触发
+    假如麦克风输入持续达到或超过有效声浪阈值
+    当声浪冷却尚未结束
+    那么系统不应在每个 tick 中重复计数
+    当声浪冷却结束且当前采样仍达到有效声浪阈值
+    那么系统可以记录下一次有效声浪触发
 ```

 ### 功能: 倒计时与胜负结算
@@ -227,20 +226,20 @@
    当系统时间从 30 秒推进到 0 秒
    那么界面应显示倒计时归零
    而且系统应进入 finished 结算阶段
-    而且归零后的麦克风输入不应再改变本局能量条和叫声次数
+    而且归零后的麦克风输入不应再改变本局能量条和声浪触发次数

  场景: 玩家侧占优时判定玩家胜利
    假如倒计时归零时能量条数值大于 drawThreshold
    当系统进入结算阶段
    那么系统应判定玩家胜利
-    而且结算面板应展示玩家叫声次数、最大音量和声浪评分
+    而且结算面板应展示玩家声浪触发次数、最大音量和声浪评分
    而且应提供再来一局入口

  场景: 对手侧占优时判定玩家失败
    假如倒计时归零时能量条数值小于 -drawThreshold
    当系统进入结算阶段
    那么系统应判定对手胜利
-    而且结算面板应展示玩家叫声次数、最大音量和声浪评分
+    而且结算面板应展示玩家声浪触发次数、最大音量和声浪评分
    而且应提供再来一局入口

  场景: 能量条接近平衡时判定平局
@@ -265,7 +264,7 @@
    当玩家选择再来一局
    那么系统应重置剩余时间为 30 秒
    而且能量条应回到中线
-    而且玩家叫声次数、最大音量、连击和胜负结果应清零
+    而且玩家声浪触发次数、最大音量、连击和胜负结果应清零
    而且系统应重新进入校准或开局倒计时流程

  场景: 结算后返回玩法入口
@@ -353,7 +352,7 @@
    假如玩家在 playing 阶段刷新页面
    当页面重新加载 bark-battle
    那么系统应重新进入权限检查或授权准备状态
-    而且不应沿用刷新前的剩余时间、能量条和叫声次数作为新局结果
+    而且不应沿用刷新前的剩余时间、能量条和声浪触发次数作为新局结果
 ```

 ## 测试映射
@@ -367,15 +366,15 @@
 | 嘈杂环境生成更高的有效阈值 | unit | `src/games/bark-battle/domain/BarkNoiseCalibration.test.ts` | planned |
 | 校准期间无法获得有效音频样本 | application/component | `src/games/bark-battle/application/BarkBattleController.test.ts`, `src/games/bark-battle/ui/BarkBattlePermissionPanel.test.tsx` | planned |
 | 单次超过阈值且间隔足够的叫声计数加一 | unit | `src/games/bark-battle/domain/BarkDetector.test.ts` | planned |
-| 持续噪音不会被无限计数 | unit | `src/games/bark-battle/domain/BarkDetector.test.ts` | planned |
+| 持续高响度输入只按冷却节奏计数 | unit | `src/games/bark-battle/domain/BarkDetector.test.ts` | planned |
 | 间隔过短的连续峰值不重复计数 | unit | `src/games/bark-battle/domain/BarkDetector.test.ts` | planned |
 | 玩家推动力高于对手时能量条向玩家侧移动 | unit | `src/games/bark-battle/domain/EnergyTugOfWar.test.ts` | planned |
-| 连续大声叫声触发更强反馈 | unit/integration/component | `src/games/bark-battle/domain/BarkBattleScoring.test.ts`, `src/games/bark-battle/ui/BarkBattleHud.test.tsx` | planned |
+| 连续强声浪触发触发更强反馈 | unit/integration/component | `src/games/bark-battle/domain/BarkBattleScoring.test.ts`, `src/games/bark-battle/ui/BarkBattleHud.test.tsx` | planned |
 | 能量条到达边界后不会越界 | unit | `src/games/bark-battle/domain/EnergyTugOfWar.test.ts` | planned |
 | 对手推动力高于玩家时能量条向对手侧移动 | unit | `src/games/bark-battle/domain/EnergyTugOfWar.test.ts` | planned |
 | 低于阈值的背景噪音不计数 | unit | `src/games/bark-battle/domain/BarkDetector.test.ts` | planned |
-| 过短脉冲不计为有效叫声 | unit | `src/games/bark-battle/domain/BarkDetector.test.ts` | planned |
-| 过长持续声被削弱为单段输入 | unit | `src/games/bark-battle/domain/BarkDetector.test.ts` | planned |
+| 冷却内重复达阈值不计数 | unit | `src/games/bark-battle/domain/BarkDetector.test.ts` | planned |
+| 持续高响度输入只按冷却节奏产生触发 | unit | `src/games/bark-battle/domain/BarkDetector.test.ts` | planned |
 | 倒计时每秒递减并在归零时停止对战输入 | unit/application | `src/games/bark-battle/domain/BarkBattleSession.test.ts`, `src/games/bark-battle/application/BarkBattleController.test.ts` | planned |
 | 玩家侧占优时判定玩家胜利 | unit/component | `src/games/bark-battle/domain/BarkBattleSession.test.ts`, `src/games/bark-battle/ui/BarkBattleResultPanel.test.tsx` | planned |
 | 对手侧占优时判定玩家失败 | unit/component | `src/games/bark-battle/domain/BarkBattleSession.test.ts`, `src/games/bark-battle/ui/BarkBattleResultPanel.test.tsx` | planned |
@@ -394,8 +393,8 @@
 ## 验收清单

 - [ ] 权限允许、拒绝、非安全上下文、API 不支持、麦克风未找到/不可读、AudioContext 被拦截、校准超时或样本不可读均有明确状态，且不会误进入 playing。
- [ ] 校准阶段会影响有效叫声阈值，低噪音不会增加叫声计数。
- [ ] 有效叫声计数具备阈值、峰值间隔、持续时长约束。
+- [ ] 校准阶段会影响有效声浪阈值，低噪音不会增加叫声计数。
+- [ ] 有效声浪触发计数具备阈值与声浪冷却约束。
 - [ ] 能量条根据双方推动力差值双向移动，并限制在 `-100` 到 `100`。
 - [ ] 30 秒归零后停止本局输入影响，并按玩家胜利、对手胜利、平局三类结果结算。
 - [ ] 移动端核心元素可见，非关键设置收起，不在主画面堆叠长规则说明。
@@ -405,8 +404,8 @@
 ## 开放问题

 1. MVP 是否确认只做“玩家 vs AI”，还是第一版需要双人同屏或联机对战？
-2. `drawThreshold`、`minBarkGapMs`、`minBarkDurationMs`、`maxBarkDurationMs` 的首版默认值由产品/调参阶段确认，还是先采用开发可配置默认值？
+2. `drawThreshold`、`minBarkGapMs`、有效声浪阈值 的首版默认值由产品/调参阶段确认，还是先采用开发可配置默认值？
 3. 是否允许无麦克风设备提供键盘/点击备用输入？若允许，需要另补非声控模式场景；若不允许，当前降级只提供返回入口。
-4. 是否需要在结算中记录或上报成绩、最高音量、叫声次数和声浪评分？若需要，需补埋点/后端持久化场景。
+4. 是否需要在结算中记录或上报成绩、最高音量、声浪触发次数和声浪评分？若需要，需补埋点/后端持久化场景。
 5. bark-battle 是否作为 Genarrative 正式 play type 接入创作入口、作品发布和广场，还是先作为独立 runtime 原型验证？
 6. 狗狗、背景、拟声词和冲击波素材来源是临时占位、AI 生成，还是复用项目现有素材管线？
@@ -80,6 +80,7 @@
 - `PlatformHomeView` 继续作为“我的”Tab 首屏承载层
 - 优先采用现有面板、抽屉、弹窗，不新建独立大系统
 - 页面只展示后端返回的状态，不自行计算结论型业务状态
+- 会员中心与充值入口只保留在顶部身份卡右侧按钮，不在“常用功能”区重复展示
 - 每日任务入口放在“常用功能”，点击后弹出独立任务面板

 ### 4.2 后端边界
@@ -75,6 +75,8 @@
 3. 中部显示权益卡片
 4. 底部显示套餐与购买按钮

+2026-05-14 补充：充值入口只保留在“我的”页顶部身份卡右侧按钮，常用功能区不再重复展示充值卡片，避免同屏出现两个相同业务入口。
+
 ## 4.2 页面内容

 页面展示模块：
@@ -4,6 +4,7 @@

 ## 重点入口

+- [宝贝爱画寓教于乐独立关卡 PRD](./BABY_LOVE_DRAWING_EDUTAINMENT_LEVEL_PRD_2026-05-13.md)：定义寓教于乐内容线的 `宝贝爱画` 独立本地 Demo 关卡，覆盖画板、七色选择、画笔/橡皮、手部绘画、完成、image-2 绘画魔法、本地保存和关闭入口隐藏边界。
 - [宝贝识物寓教于乐模板 PRD](./BABY_OBJECT_MATCH_EDUTAINMENT_TEMPLATE_PRD_2026-05-11.md)：定义寓教于乐内容线的 `宝贝识物` 创作模板，覆盖两个物品名称输入、image-2 物品图生成、精确 `寓教于乐` 标签、结果页和发布边界。
 - [AI 原生幕间文字游戏模板 PRD：参考 MOKU 的剧本模拟器闭环](./AI_NATIVE_TEXT_GAME_TEMPLATE_MOKU_REFERENCE_PRD_2026-05-05.md)：参考 MOKU / 幕间类 AI 文游的剧本游乐场、自由行动、AI GM、记忆和模拟器强反馈经验，但只落为陶泥儿 `text-game` 模板，复用平台接口，不迁入外部社区、支付、私有存档或回放。
 - [AI 原生视觉小说模板 PRD：TXT 玩法平台化接入](./AI_NATIVE_VISUAL_NOVEL_TEMPLATE_PRD_2026-05-05.md)：参考 `Interactive-fiction-backend` / `Interactive-fiction-frontend` 的 TXT 玩法经验，但只保留视觉小说模板创作与运行闭环，完全使用 Genarrative 平台接口，并明确删除回放和外部平台功能。
@@ -67,6 +67,8 @@ Admin Web

 `visible=false` 会让创作中心不展示对应入口；`open=false` 会让前端展示锁定态，并让 api-server 熔断对应玩法创作 / 运行态 API。隐藏入口但仍保留既有作品号、广场详情或试玩链路时，应只关闭 `visible`，不要关闭 `open`。

+当前默认配置中，`visual-novel` 暂时从创作页隐藏并关闭入口，默认种子为 `visible=false`、`open=false`。如果后续只想恢复已发布作品试玩而不恢复创作入口，需要先明确 API 熔断范围，再通过后台入口开关调整，不能在前端硬编码恢复模板 Tab。
+
 ## 注意

 - 前端后台页面只做管理表单，不成为配置事实源。
@@ -70,7 +70,7 @@ Query：
 - SQL 固定为 `SELECT * FROM {tableName} LIMIT {limit}`；SpacetimeDB 2.2 HTTP SQL 不拼 `ORDER BY`。
 - 用户输入不直接拼入 SQL；关键词和条件在 API Server 内存中过滤。
 - private 表或 token 不可见时返回后台可读错误信息。
- SpacetimeDB SQL 行和 SATS 值统一转成人可读 JSON：Option None 为 null，Some 展开为内部值，Timestamp 单元素数组展开为内部值，enum 可保留 tag/name 或原始数组文本。
+- SpacetimeDB SQL 行和 SATS 值统一转成人可读 JSON：Option None 为 null，Some 展开为内部值，Timestamp 单元素数组展开为内部值；已知业务枚举列应在 API Server 按表名和列名转换为业务字符串，例如 `profile_recharge_order.kind` 转为 `points` / `membership`，`profile_recharge_order.status` 转为 `pending` / `paid` / `failed` / `closed` / `refunded`。

 ## 前端页面

@@ -34,15 +34,15 @@ GENARRATIVE_LLM_BASE_URL=
 GENARRATIVE_LLM_API_KEY=
 GENARRATIVE_LLM_MODEL=

-# APIMart / OpenAI 兼容 Responses 文本网关与抓大鹅 nanobanana 物品素材图
+# APIMart / OpenAI 兼容 Responses 文本网关
 APIMART_BASE_URL=
 APIMART_API_KEY=
 APIMART_IMAGE_REQUEST_TIMEOUT_MS=180000

-# VectorEngine / GPT-image-2 / Suno / Vidu 生成网关
-VECTOR_ENGINE_BASE_URL=https://api.vectorengine.ai
+# VectorEngine / Gemini 原生图片 / GPT-image-2 / Suno / Vidu 生成网关
+VECTOR_ENGINE_BASE_URL=https://api.vectorengine.cn
 VECTOR_ENGINE_API_KEY=
-VECTOR_ENGINE_IMAGE_REQUEST_TIMEOUT_MS=180000
+VECTOR_ENGINE_IMAGE_REQUEST_TIMEOUT_MS=1000000
 VECTOR_ENGINE_AUDIO_REQUEST_TIMEOUT_MS=180000

 # Hyper3D Rodin Gen-2 3D 模型生成
@@ -102,14 +102,14 @@ HYPER3D_MODEL_REQUEST_TIMEOUT_MS / RODIN_MODEL_REQUEST_TIMEOUT_MS
 3. 文本 LLM provider 为 `ark` 且未配置 `GENARRATIVE_LLM_BASE_URL` 时，仍回退到 Ark 公开基础 URL。
 4. 角色视频 provider 复用 Ark 且未配置 `ARK_CHARACTER_VIDEO_BASE_URL` 时，仍回退到 Ark 公开基础 URL。
 5. 具体模型名缺失时不在配置层伪造默认模型，调用到对应能力时由下游配置校验返回缺配置错误。
-6. VectorEngine 图片与音频生成只读取 `VECTOR_ENGINE_BASE_URL` / `VECTOR_ENGINE_API_KEY`，其中 GPT-image-2 图片生成额外读取 `VECTOR_ENGINE_IMAGE_REQUEST_TIMEOUT_MS`；不复用 `APIMART_*`、`GENARRATIVE_LLM_*` 或前端变量。拼图 Agent 的生成 action 不做前端自动重试，避免一次点击在上游超时后重复触发外部生图与钱包扣退费；若 VectorEngine 请求达到该超时窗口，api-server 返回 `504 Gateway Timeout`，`error.details.provider` 为 `vector-engine`，并保留具体超时 message。
+6. VectorEngine 图片与音频生成只读取 `VECTOR_ENGINE_BASE_URL` / `VECTOR_ENGINE_API_KEY`，其中 GPT-image-2 与抓大鹅 Gemini 素材 sheet 图片生成额外读取 `VECTOR_ENGINE_IMAGE_REQUEST_TIMEOUT_MS`；不复用 `APIMART_*`、`GENARRATIVE_LLM_*` 或前端变量。图片请求默认超时窗口为 `1000000ms`，且 api-server 会把旧环境中较小的 `VECTOR_ENGINE_IMAGE_REQUEST_TIMEOUT_MS` 提升到该下限，避免 500 秒级生图被提前截断。拼图 Agent 的生成 action 不做前端自动重试，避免一次点击在上游超时后重复触发外部生图与钱包扣退费；若 VectorEngine 请求达到该超时窗口，api-server 返回 `504 Gateway Timeout`，`error.details.provider` 为 `vector-engine`，并保留具体超时 message。
 7. 火山引擎语音能力由 `platform-speech` 收口协议帧与上游鉴权，`api-server` 只暴露平台鉴权后的代理路由，不向前端返回任何密钥字段。
 8. Hyper3D Rodin Gen-2 使用公开默认 `https://api.hyper3d.com/api/v2`，API Key 只读取 `HYPER3D_API_KEY` / `RODIN_API_KEY`，不复用文本 LLM、图片或音频网关密钥。
-9. APIMart 当前保留给创意 Agent 的 `gpt-5` Responses 文本/多模态理解链路，并用于抓大鹅物品素材 sheet 的 `nanobanana2` / Gemini 图片模型；GPT-image-2 图片生成不得读取 APIMart 配置。
+9. APIMart 当前只保留给创意 Agent 的 `gpt-5` Responses 文本/多模态理解链路；抓大鹅物品素材 sheet、GPT-image-2 图片生成和音频生成都不得读取 APIMart 配置。
 10. 本地 `npm run api-server`、`npm run dev:rust`、`npm run dev` 与 `npm run dev:web` 的环境文件优先级固定为非空外层 shell 变量最高，其后 `.env`、`.env.local`、`.env.secrets.local` 逐层覆盖；真实密钥建议放在 `.env.secrets.local`，防止 `.env` 中的空示例值覆盖私密配置。外层 shell 变量如果是空字符串或全空白，不再遮蔽本地 env 文件中的真实值。
 11. OSS 客户端只在 `ALIYUN_OSS_BUCKET`、`ALIYUN_OSS_ENDPOINT`、`ALIYUN_OSS_ACCESS_KEY_ID`、`ALIYUN_OSS_ACCESS_KEY_SECRET` 四项齐全时初始化。四项全部缺失表示未启用 OSS；部分缺失时 `api-server` 记录 warning 并继续启动，具体上传、换签或读取 generated 私有资产的接口返回 `OSS 未完成环境变量配置`，并在 `error.details.missingEnv` 中列出缺失变量。
-12. 抓大鹅 2D 草稿素材生成需要同时具备 APIMart、VectorEngine 与 OSS 配置：APIMart `gemini-3.1-flash-image-preview` 负责生成 5x5 物品素材 sheet，VectorEngine `gpt-image-2-all` 负责封面、9:16 背景图和 1:1 容器 UI 图，OSS 负责保存切割后的五视角图片及其它生成图。缺少 APIMart、VectorEngine 或 OSS 时应通过 `error.details.reason` 向前端暴露具体缺项，不能只显示泛化“服务暂不可用”。素材图、封面图和背景图生成在调用外部生图前必须先预检 OSS，避免已消耗外部生图后才发现无法落库。
-13. 拼图有参考图且开启 AI 重绘时使用 VectorEngine `POST /v1/images/edits` multipart 接口。若返回 `error sending request for url`，代表后端未收到 HTTP 响应；响应 `details` 会带 `reason`、`source`、`connect`、`body`、`timeout` 和 `endpoint`，排查时优先检查服务器网络、DNS、防火墙、代理和参考图大小。拼图图片客户端强制 HTTP/1.1，以降低上游 multipart HTTP/2 连接中断风险。
+12. 抓大鹅 2D 草稿素材生成需要同时具备 VectorEngine 与 OSS 配置：VectorEngine Gemini `gemini-3-pro-image-preview` 原生 `generateContent` 负责生成 5x5 物品素材 sheet；封面和 `9:16` 背景图走 VectorEngine `/v1/images/generations` 的 `gpt-image-2-all` JSON 链路；`1:1` 容器 UI 图走 VectorEngine `/v1/images/edits` multipart 链路，并把 `public/match3d-background-references/pot-fused-reference.png` 作为 `image` part 上传，不能再用 generations `image` 数组弱参考。OSS 负责保存切割后的五视角图片及其它生成图。缺少 VectorEngine 或 OSS 时应通过 `error.details.reason` 向前端暴露具体缺项，不能只显示泛化“服务暂不可用”。素材图、封面图和背景图生成在调用外部生图前必须先预检 OSS，避免已消耗外部生图后才发现无法落库。
+13. 拼图有参考图且开启 AI 重绘时使用 VectorEngine `POST /v1/images/edits` multipart 接口。若返回 `error sending request for url`，代表后端未收到 HTTP 响应；响应 `details` 会带 `reason`、`source`、`connect`、`body`、`timeout` 和 `endpoint`，前端展示优先使用 `details.reason`，排查时优先检查服务器网络、DNS、防火墙、代理和参考图大小。拼图图片客户端强制 HTTP/1.1，以降低上游 multipart HTTP/2 连接中断风险。
 14. 本地排查 `OSS 未完成环境变量配置` 时必须核对键名是否精确为 `ALIYUN_OSS_ACCESS_KEY_SECRET`。常见误写是把 `OSS` 的首字母 `O` 写成数字 `0`，例如 `ALIYUN_0SS_ACCESS_KEY_SECRET`；该键不会被 `api-server` 读取。

 ## 本地配置检查
@@ -21,7 +21,7 @@
 - Puzzle Agent 图片生成动作 `compile_puzzle_draft`、`generate_puzzle_images`
 - Puzzle Agent 动作 `publish_puzzle_work`
 - Match3D / 抓大鹅草稿生成动作 `match3d_compile_draft`
- 拼图 / 抓大鹅结果页手动生成背景音乐、UI 背景与抓大鹅批量新增物品素材
+- 拼图 / 抓大鹅结果页 UI 背景与抓大鹅批量新增物品素材；背景音乐和点击音效生成入口当前临时关闭，不进入计费范围

 暂不接入以下入口：

@@ -34,7 +34,6 @@

 - 每次可计费资产操作消耗 `1` 枚泥点。
 - 例外：Match3D / 抓大鹅草稿生成是一次完整草稿外部生成动作，固定消耗 `10` 枚泥点；流水仍复用 `asset_operation_consume` / `asset_operation_refund`，`asset_kind = match3d_draft_generation`。
- 例外：拼图 / 抓大鹅背景音乐生成固定消耗 `5` 枚泥点；物品点击音效仍按单个音效任务消耗 `10` 枚泥点。
 - 例外：拼图 / 抓大鹅 UI 背景重新生成固定消耗 `2` 枚泥点。
 - 例外：抓大鹅结果页批量新增物品素材按实际可新增物品名计费，每 `5` 个消耗 `2` 枚泥点，不足 `5` 个向上按 `5` 个计。重复名称、作品中已有名称和超过容量上限的名称不进入计费数量。
 - 图片生成和作品发布都按资产操作计费；余额不足时禁止继续执行。
@@ -42,6 +41,22 @@
 - 如果图片生成、远程下载、OSS 写入、资产记录确认或发布 mutation 失败，资产操作服务自动发起同额退款。
 - 如果退款失败，原始错误仍返回给调用方，同时服务端日志记录退款失败，便于后续人工核对。

+## 前端确认交互
+
+所有前端可见且会消耗泥点的按钮，点击后必须先弹出独立确认面板，面板标题使用 `确认消耗泥点`，正文只展示本次消耗数量，例如 `消耗 2 泥点`。用户点击 `确定` 后才允许调用后端扣费动作；点击 `取消` 或关闭面板不得触发接口。
+
+2026-05-14 补充：创作页入口点击确认后，前端必须先刷新 `/api/profile/dashboard` 钱包余额；余额大于等于本次消耗时才允许创建玩法 session / 草稿，余额不足时停留在创作页并展示不足提示。该预检不替代后端扣费原子校验，只用于避免余额明显不足时先生成半成品草稿。
+
+2026-05-14 当前已覆盖的草稿页入口包括：
+
+- 拼图入口 `AI重绘=true` 的 `生成拼图游戏草稿`：`2` 泥点；`AI重绘=false` 直接使用上传图，不显示泥点确认。
+- 拼图结果页关卡 `生成画面` / `重新生成画面`：`2` 泥点。
+- 拼图结果页 `素材配置 > UI` 的 `生成UI背景` / `重新生成`：`2` 泥点。
+- 拼图结果页发布按钮：`1` 泥点，发布确认面板必须显示本次消耗数量。
+- 抓大鹅入口 `生成抓大鹅草稿`：`10` 泥点。
+- 抓大鹅结果页 `素材配置 > 物品` 的批量新增与批量重新生成：按实际计费数量展示动态泥点数。
+- 抓大鹅结果页 `素材配置 > UI` 与 `素材配置 > 容器形象` 的 `重新生成`：各 `2` 泥点。
+
 ## 钱包流水

 公开两个流水来源类型，统一覆盖“资产生成”和“资产发布”这两类资产操作。流水金额由具体资产操作成本决定，不再假定所有资产操作都是 `1` 枚泥点：
@@ -13,6 +13,9 @@
 1. `server-rs/crates/api-server/src/assets.rs` 中的历史素材类型白名单统一收口为单一常量源。
 2. HTTP 层错误文案与实际支持列表由同一函数生成，避免后续再出现“校验改了但提示文案还是旧口径”的漂移。
 3. 增加 `puzzle_cover_image` 的回归测试，确保拼图封面素材不会再次被历史接口遗漏。
+4. `ownerLabel` 只表示资产归属账号，不是历史图片标题；前端历史素材卡片标题必须从 `imageSrc` 的路径末尾推导，例如 `/generated-puzzle-assets/history/image.png` 展示为 `image.png`。
+5. `createdAt / updatedAt` 可能来自 SpacetimeDB / shared-kernel 的秒级字符串，例如 `1713686400.000000Z`，前端不得只用 `new Date(value)` 解析后把它显示成未知时间。
+6. 历史素材选中后仍把 `imageSrc` 作为 `referenceImageSrc` 传给生成链路；创作页和关卡详情页的预览必须通过 `ResolvedAssetImage` 换签展示，不直接请求裸 `/generated-*` 路径。

 ## 后续约束

@@ -21,3 +24,7 @@
   - `spacetime-module` 的历史素材白名单
   - 对应前端调用常量与测试
 2. 如果运行态仍返回旧白名单错误，优先检查本地 `api-server.exe` 是否已按最新源码重新编译并重启，而不是先回退前端类型参数。
+3. 历史素材列表的 UI 回归测试应覆盖：
+   - 卡片标题不使用 `账号 user-1` 这类归属文案。
+   - `1713686400.000000Z` 能显示为可读生成时间。
+   - 选中素材后工作台 / 关卡详情展示 `历史素材 · image.png`，并继续提交原始 `imageSrc`。
@@ -53,11 +53,18 @@ POST /api/profile/referrals/redeem-code

 若用户登录的是已有账号，则不会弹出新账号邀请码面板。

-## 5. 完成定义
+## 5. 新账号泥点初始化
+
+当短信登录、开发密码入口或微信激活流程创建新账号时，后端注册链路必须调用 `grant_new_user_registration_wallet_reward`，为该用户写入 `10` 个初始泥点。
+
+该赠送落在 `profile_dashboard_state.wallet_balance` 与 `profile_wallet_ledger` 中，流水来源为 `new_user_registration_reward`，流水 ID 固定为 `new-user-registration:{user_id}`，用于保证重复调用不重复发放。已有账号登录不得再次发放。
+
+## 6. 完成定义

 1. 登录弹窗内不可见注册入口。
 2. 短信登录创建新账号后弹出邀请码面板。
 3. 邀请码为空时按钮为 `跳过`，非空时按钮为 `提交`。
 4. 取消按钮可关闭面板。
 5. 已登录邀请码接口允许提交，并继续由 SpacetimeDB procedure 兜底业务校验。
-6. 前端测试覆盖注册入口删除、新账号弹窗、URL 邀请码预填与提交。
+6. 新账号创建成功后默认获得 `10` 个泥点，且重复登录或重试不得重复发放。
+7. 前端测试覆盖注册入口删除、新账号弹窗、URL 邀请码预填与提交。
@@ -0,0 +1,202 @@
+# 宝贝爱画本地 Demo 运行态实现方案 2026-05-13
+
+## 1. 范围
+
+本方案落地寓教于乐独立关卡：
+
+```text
+baby-love-drawing / 宝贝爱画
+```
+
+当前范围只做本地 Demo 闭环：
+
+1. 寓教于乐频道默认关卡卡片；
+2. 独立运行态；
+3. mocap 与开发者调试输入；
+4. Canvas 绘制和擦除；
+5. image-2 绘画魔法后端代理；
+6. localStorage 本地保存；
+7. 直达路由开关保护。
+
+本阶段不接正式持久化表，不新增作品发布、作品号、公开详情或搜索入口。
+
+## 2. 前端接入点
+
+已新增页面阶段：
+
+```text
+baby-love-drawing-runtime
+```
+
+已新增路由：
+
+```text
+/runtime/baby-love-drawing
+```
+
+已新增文件：
+
+```text
+packages/shared/src/contracts/edutainmentBabyDrawing.ts
+src/services/edutainment-baby-drawing/babyDrawingClient.ts
+src/components/edutainment-runtime/babyLoveDrawingModel.ts
+src/components/edutainment-runtime/BabyLoveDrawingRuntimeShell.tsx
+server-rs/crates/api-server/src/edutainment_baby_drawing.rs
+```
+
+已接入：
+
+1. `src/components/rpg-entry/RpgEntryHomeView.tsx`：寓教于乐频道默认展示宝贝爱画卡片；
+2. `src/components/platform-entry/PlatformEntryFlowShellImpl.tsx`：启动宝贝爱画运行态；
+3. `src/components/platform-entry/platformEntryTypes.ts`：扩展 `SelectionStage`；
+4. `src/routing/appPageRoutes.ts`：扩展路由；
+5. `src/routing/appRoutes.tsx`：直达路由开关保护；
+6. `src/index.css`：补齐寓教于乐默认关卡卡片和宝贝爱画运行态样式；
+7. `server-rs/crates/api-server/src/app.rs`：挂载绘画魔法后端路由。
+
+## 3. 契约
+
+契约放在：
+
+```text
+packages/shared/src/contracts/edutainmentBabyDrawing.ts
+```
+
+核心字段：
+
+1. `templateId = "baby-love-drawing"`；
+2. `templateName = "宝贝爱画"`；
+3. `originalImageSrc` 保存原始画布图；
+4. `magicImageSrc` 保存 image-2 魔法图，可为 `null`；
+5. `strokeTrace` 保存画笔和橡皮轨迹；
+6. `saveMode = "original-only" | "original-and-magic"` 记录保存结果。
+
+## 4. 运行态模型
+
+运行态状态：
+
+```text
+drawing
+finished
+magicPending
+magicReady
+saved
+```
+
+工具：
+
+```text
+brush
+eraser
+```
+
+颜色：
+
+```text
+红、橙、黄、绿、青、蓝、紫
+```
+
+按钮悬停：
+
+1. 颜色选择只接受左手悬停，阈值 1500ms；
+2. 按钮选择接受任一手悬停，阈值 2000ms；
+3. 工具切换只接受右手在工具区域握拳。
+4. 画笔 / 橡皮光标位置只接受右手坐标；左手缺帧或左手移动不得重置、替换或驱动画笔位置。
+5. 左手需要显示独立位置指示器，帮助用户确认当前是否悬停在目标颜色上；该指示器只表达左手位置，不参与画笔 / 橡皮操作。
+6. 本地 mocap handedness 当前按摄像头视角输出，宝贝爱画运行态消费前需要换算为用户身体视角：`rightHand` 作为用户左手，`leftHand` 作为用户右手。键鼠调试输入不做该换算。
+7. 真实硬件短暂缺失某只手时，显示层保留上一帧位置约 320ms 并做轻微坐标平滑；绘制层仍只在当前帧确认用户右手存在时生效。
+8. 为避免左手抢画笔，本关不做动态 handedness 换手纠正；`rightHand` 永远只进入用户左手选色通道，`leftHand` 永远只进入用户右手画笔通道。若硬件侧 handedness 继续抖动，宁可右手画笔短暂停住，也不允许左手驱动画笔。
+9. 右手画笔通道增加单帧最大位移门禁；若 camera-left 候选点相对上一帧右手位置出现不合理大跳，判定为不可信帧，只保留上一帧光标并停止绘制。
+
+## 5. Canvas 绘制
+
+画板使用 DOM Canvas。
+
+绘制规则：
+
+1. 右手在画板内且状态为 `grab` 时生效；
+2. 工具为 `brush` 时，以当前颜色绘制连续线段；
+3. 工具为 `eraser` 时，以 `destination-out` 擦除；
+4. 右手状态为 `open_palm` 或离开画板时结束当前笔画；
+5. 当前帧没有右手坐标时只结束当前笔画，不把左手坐标用于绘制、擦除或光标定位；
+6. 每条笔画记录工具、颜色、点位和时间。
+
+## 6. 绘画魔法
+
+前端 service：
+
+```text
+createBabyDrawingMagicImage(payload)
+```
+
+后端接口：
+
+```text
+POST /api/creation/edutainment/baby-love-drawing/magic
+```
+
+请求体：
+
+```json
+{
+  "originalImageSrc": "data:image/png;base64,...",
+  "strokeTrace": []
+}
+```
+
+响应体：
+
+```json
+{
+  "magicImageSrc": "data:image/png;base64,...",
+  "generationProvider": "vector-engine-gpt-image-2",
+  "prompt": "..."
+}
+```
+
+后端使用 VectorEngine `gpt-image-2-all`，把原始画布图作为参考图，生成绘本风格图片。
+
+本地未配置 VectorEngine 或接口失败时，前端允许提示错误并保留原图保存能力；不得把失败伪装成正式魔法图。
+
+后端接入约束：
+
+1. 接口需要 Bearer 鉴权；
+2. 请求体限制为 8MB；
+3. `originalImageSrc` 只接受图片 Data URL；
+4. 笔触数量上限为 600 条；
+5. 上游参考图字段使用 VectorEngine 统一契约 `image`；
+6. 关闭入口时，`creation_entry_config` 路由熔断可识别 `baby-love-drawing`。
+
+## 7. 本地保存
+
+本地保存使用：
+
+```text
+localStorage key = genarrative.edutainmentBabyDrawing.localDrawings.v1
+```
+
+保存策略：
+
+1. 魔法生成前保存：`saveMode = "original-only"`，只保存 `originalImageSrc`；
+2. 未保存原图直接生成魔法后保存：`saveMode = "original-and-magic"`，保存 `originalImageSrc` 和 `magicImageSrc`；
+3. 保存后展示“再画一张”和“返回”。
+
+## 8. 验收命令
+
+```bash
+npm run test -- src/components/edutainment-runtime/babyLoveDrawingModel.test.ts src/components/edutainment-runtime/BabyLoveDrawingRuntimeShell.test.tsx src/services/edutainment-baby-drawing/babyDrawingClient.test.ts src/routing/appRoutes.test.ts
+cargo test -p api-server edutainment_baby_drawing --manifest-path server-rs/Cargo.toml
+cargo test -p api-server resolves_runtime_paths_to_creation_type_ids --manifest-path server-rs/Cargo.toml
+npx eslint src/components/edutainment-runtime/BabyLoveDrawingRuntimeShell.tsx src/components/edutainment-runtime/babyLoveDrawingModel.ts src/services/edutainment-baby-drawing/babyDrawingClient.ts src/routing/appRoutes.tsx --ext .ts,.tsx --max-warnings 0
+npm run typecheck
+npm run check:encoding
+```
+
+## 9. 已覆盖测试
+
+1. `src/components/edutainment-runtime/babyLoveDrawingModel.test.ts`：颜色 / 按钮悬停阈值、坐标归一化、笔触追加；
+2. `src/components/edutainment-runtime/BabyLoveDrawingRuntimeShell.test.tsx`：画板、七色、画笔 / 橡皮、完成保存、返回按钮、左手位置指示器、mocap 摄像头视角到用户身体视角换算、左手输入不替换画笔光标位置、左手短暂缺帧不闪烁、用户左手不能抢占右手画笔、camera-left 大跳不接入画笔；
+3. `src/services/edutainment-baby-drawing/babyDrawingClient.test.ts`：原图保存、原图加魔法图保存、后端魔法接口请求；
+4. `src/routing/appRoutes.test.ts`：`/runtime/baby-love-drawing` 开启可达、关闭回落主应用；
+5. `server-rs/crates/api-server/src/edutainment_baby_drawing.rs` 内部单测：prompt、Data URL 校验、PNG 输出和轨迹范围摘要；
+6. `server-rs/crates/api-server/src/creation_entry_config.rs` 路由映射单测：确认后端熔断可识别 `baby-love-drawing`。
--- a/Show More
+++ b/Show More