diff --git a/.hermes/shared-memory/decision-log.md b/.hermes/shared-memory/decision-log.md
index 54f6f6e6..f0f26e0c 100644
--- a/.hermes/shared-memory/decision-log.md
+++ b/.hermes/shared-memory/decision-log.md
@@ -186,6 +186,14 @@
 - 验证方式：`cargo check -p api-server`、`cargo test -p module-puzzle creative`、`cargo test -p api-server creative_agent`、`npm run api-server` 后检查 `/healthz`、`POST /api/runtime/creative-agent/sessions`、`POST /api/runtime/creative-agent/sessions/{sessionId}/messages/stream`。
 - 关联文档：`docs/prd/CREATIVE_INTERACTIVE_AGENT_PHASE1_LANGCHAIN_RUST_PUZZLE_LOOP_PRD_2026-05-05.md`。
 
+## 2026-05-10 视觉小说入口收敛为单句创作 + 画风选择
+
+- 背景：视觉小说入口页要对齐抓大鹅式的线性创作入口，只保留最小可用输入，避免再暴露文档 / 空白 / 对话式工作台。
+- 决策：入口页只展示一句话创作输入框和横向视觉画风卡片；画风通过 `seedText` 追加 `视觉画风` 和 `画风要求` 两行透传给既有创作链路；点击生成后先进入 `visual-novel-generating` 过程页，再自动进入 `visual-novel-result`。
+- 影响范围：`VisualNovelAgentWorkspace`、`PlatformEntryFlowShellImpl`、`platformEntryTypes`、视觉小说 PRD；不新增后端字段或数据库结构。
+- 验证方式：视觉小说工作台单测通过，`npm run check:encoding` 通过；`npm run typecheck` 仍受仓库里 `src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx` 的既有类型错误影响。
+- 关联文档：`docs/prd/AI_NATIVE_VISUAL_NOVEL_TEMPLATE_PRD_2026-05-05.md`。
+
 ## 2026-05-07 移动端整页缩放由入口统一锁定
 
 - 背景：移动端游戏式页面如果允许浏览器整页缩放，容易把固定画布、HUD 和底部操作区一起放大或缩小，破坏操作节奏。
diff --git a/.hermes/shared-memory/pitfalls.md b/.hermes/shared-memory/pitfalls.md
index c2e3f02e..fe718996 100644
--- a/.hermes/shared-memory/pitfalls.md
+++ b/.hermes/shared-memory/pitfalls.md
@@ -67,6 +67,14 @@
 - 验证：后端单测覆盖 `build_puzzle_levels_with_primary_update` 和 `apply_generated_puzzle_candidates_to_session_snapshot`；结果页重新生成应在未重新上传时继续带入 `level.pictureReference`。
 - 关联：`server-rs/crates/api-server/src/puzzle.rs`、`src/components/puzzle-result/PuzzleResultView.tsx`。
 
+## 拼图图生图仍不像参考图时先看是否走了 edits
+
+- 现象：Network payload 已带 `referenceImageSrc`，但 VectorEngine 生成结果仍明显不像上传图。
+- 原因：`gpt-image-2-all` 的 `/v1/images/generations` 更适合纯文生图；有参考图且需要重绘时应切到 `/v1/images/edits` 的 multipart 图生图接口。
+- 处理：`referenceImageSrc` 存在且 `aiRedraw = true` 时直接走 edits，prompt 仍保留参考图强约束；入口页关闭 AI 重绘时直接应用上传图，不调用图片生成；前端把参考图压到单边 1024 内，后端解析后拒绝超过 8MB 的参考图字节。
+- 验证：后端单测应覆盖 `images/edits` 路由、`b64_json` 响应解码和参考图强提示；真实联调先看日志里是否命中 `拼图 VectorEngine 图片编辑 HTTP 返回`。
+- 关联：`server-rs/crates/api-server/src/puzzle.rs`、`src/services/puzzleReferenceImage.ts`、`docs/technical/VECTOR_ENGINE_GPT_IMAGE_2_GENERATION_2026-05-09.md`。
+
 ## 旧后端路线文档造成判断漂移
 
 - 现象：开发时参考到 Express、Node、PostgreSQL 或 Go 方向旧文档，导致接口、数据真相或部署路径与当前主线不一致。
@@ -147,6 +155,14 @@
 - 验证：不打印密钥内容，只检查 `VECTOR_ENGINE_API_KEY` 非空；重启后触发拼图生成不再返回本地配置缺失的 503。
 - 关联：`docs/technical/VECTOR_ENGINE_GPT_IMAGE_2_GENERATION_2026-05-09.md`、`.codex/skills/gpt-image-2-apimart/SKILL.md`。
 
+## `npm run api-server` 读取 env 的顺序必须让 `.env.secrets.local` 最后覆盖
+
+- 现象：`POST /api/assets/hyper3d/text-to-model` 在本地返回 503，详情里提示 `HYPER3D_API_KEY 未配置`，但开发者明明已经在本地私密文件里写了 key。
+- 原因：`scripts/api-server-dev.mjs` 之前按 `.env.secrets.local → .env.local → .env` 合并，结果仓库里的 `.env` 空示例值会把前面已经设置好的私密 key 覆盖掉。
+- 处理：`npm run api-server` / `npm run dev:rust` / `npm run dev` 统一按“外层 shell 变量优先，其后 `.env`、`.env.local`、`.env.secrets.local` 逐层覆盖”的顺序加载；真实密钥优先放 `.env.secrets.local`。
+- 验证：本地加入临时测试后，`HYPER3D_API_KEY` 应能被 `.env.secrets.local` 覆盖，且 shell 变量仍然最高优先级。
+- 关联：`scripts/api-server-dev.mjs`、`server-rs/crates/api-server/src/hyper3d_generation.rs`、`docs/technical/HYPER3D_RODIN_GEN2_MODEL_GENERATION_2026-05-08.md`。
+
 ## 拼图图片生成 98% 后报 OSS V4 签名时间格式化失败
 
 - 现象：拼图创作表单生成进度卡在 98%，`POST /api/runtime/puzzle/agent/sessions/{sessionId}/actions` 返回 `502 Bad Gateway`，前端提示 `拼图图片生成失败：OSS V4 签名时间格式化失败`。
@@ -325,6 +341,14 @@
 - 验证：查看 `server-rs/Cargo.toml` default-members，并按相关 SpacetimeDB 文档执行模块构建。
 - 关联：`server-rs/Cargo.toml`、`docs/technical/RUST_WORKSPACE_DEFAULT_BUILD_SCOPE_FIX_2026-04-25.md`。
 
+## Windows 原生 `spacetime-module` 单测会链接缺失 SpacetimeDB 宿主符号
+
+- 现象：在 Windows 上执行 `cargo test -p spacetime-module --manifest-path server-rs/Cargo.toml` 可能编译到链接阶段后失败，出现 `LNK2019` / `LNK1120`，缺失 `datastore_insert_bsatn`、`procedure_start_mut_tx`、`console_log` 等 SpacetimeDB 宿主符号。
+- 原因：`spacetime-module` 依赖的 SpacetimeDB runtime API 面向 wasm 宿主环境，原生 test exe 链接不到这些宿主导出。
+- 处理：日常语法和类型验证使用 `cargo check -p spacetime-module --manifest-path server-rs/Cargo.toml`；需要验证模块行为时走 SpacetimeDB publish/dev 或模块域纯 Rust crate 的单测，不把该原生链接错误当作业务测试失败。
+- 验证：`cargo check -p spacetime-module --manifest-path server-rs/Cargo.toml` 能通过；原生 `cargo test` 若仍报上述宿主符号缺失，按当前限制记录为未执行。
+- 关联：`server-rs/crates/spacetime-module`、`docs/technical/SPACETIMEDB_SCHEMA_CHANGE_CONSTRAINTS.md`。
+
 ## Rust 构建不要让不可用的 sccache 阻断 rustc
 
 - 现象：Cargo 报 `could not execute process sccache ... rustc.exe -vV (never executed)`，或 `sccache: caused by: Failed to send data to or receive data from server / Failed to read response header / failed to fill whole buffer`；真实 `rustc -Vv` 可以执行，但构建在调用包装器时失败。
@@ -364,3 +388,43 @@
 - 处理：前端发布弹窗在用户点击发布后必须保留并展示后端业务错误，不能只把错误写到弹窗背后的页面 banner。
 - 验证：`PuzzleResultView` 单测覆盖发布弹窗内展示 `光点余额不足`。
 - 关联：`src/components/puzzle-result/PuzzleResultView.tsx`、`docs/technical/PUZZLE_RESULT_AUTOSAVE_AND_TAG_GATE_FIX_2026-04-28.md`、`docs/technical/ASSET_GENERATION_POINTS_CONSUMPTION_2026-04-27.md`。
+
+## WebGL 画布在高 DPR 移动端放大溢出
+
+- 现象：抓大鹅试玩入口进入后，3D 锅体和物体从中心圆形区域向右下溢出，顶部状态和底部备选栏也可能看起来被右侧裁切。
+- 原因：`WebGLRenderer.setPixelRatio(...)` 会把绘图缓冲区乘上设备 DPR；如果没有给 `renderer.domElement` 单独设置 CSS `width/height: 100%` 和绝对铺满，浏览器可能把高 DPR 缓冲区尺寸当成页面显示尺寸。
+- 处理：中心棋盘和托盘预览的 WebGL canvas 统一套用 `position:absolute; inset:0; width:100%; height:100%; display:block`，`renderer.setSize(..., false)` 只负责同步绘图缓冲区。
+- 验证：强制移动端 `390x844`、DPR 2 截图，确认棋盘左右边界在视口内，canvas CSS 尺寸等于容器尺寸，内部 `width/height` 属性可大于 CSS 尺寸。
+- 关联：`src/components/match3d-runtime/Match3DPhysicsBoard.tsx`、`docs/technical/MATCH3D_RUNTIME_3D_GEOMETRY_EXPERIMENT_2026-05-02.md`。
+
+## Hyper3D subscriptionKey 不要按固定短文本限长
+
+- 现象：抓大鹅生成草稿时，内联 Rodin 图生 3D 模型提交成功后，状态轮询报 `subscriptionKey 超过 256 字符`，导致 `/api/creation/match3d/sessions/{sessionId}/actions` 返回 400。
+- 原因：`subscriptionKey` 是 Hyper3D 返回的 opaque token，长度由上游决定；后端状态查询曾复用普通文本校验，把它限制在 256 字符。
+- 处理：`query_task_status` 对 `subscriptionKey` 只做 trim 和非空校验，不做固定长度限制；前端临时任务和 Match3D 草稿响应可继续展示该 token，但不要把它当作可编辑短文本。
+- 验证：`cargo test -p api-server accepts_opaque_subscription_key_without_length_cap --manifest-path server-rs/Cargo.toml`。
+- 关联：`server-rs/crates/api-server/src/hyper3d_generation.rs`、`docs/technical/HYPER3D_RODIN_GEN2_MODEL_GENERATION_2026-05-08.md`。
+
+## 抓大鹅草稿生成不要阻塞在 Rodin 模型下载
+
+- 现象：抓大鹅草稿生成时 Hyper3D 状态已完成，但下载列表为空或没有可用模型文件，`/api/creation/match3d/sessions/{sessionId}/actions` 返回 `502 Bad Gateway`，前端提示 `Hyper3D 已完成但未返回可下载模型文件`。
+- 原因：草稿生成链路曾在切割图片后立即并行调用 Rodin 图生模型，并把模型下载成功作为草稿完成前置条件；上游完成态和可下载文件列表不是强一致，容易把本来可用的图片草稿卡死。
+- 处理：草稿阶段只生成物品名、素材图、切割独立图片并上传 OSS，返回 `status = image_ready`；Rodin 3D 模型生成留到结果页 `3D素材` Tab 手动触发。
+- 验证：草稿响应中的 `generatedItemAssets[].imageSrc` 有值、`modelSrc` 为空、状态为 `image_ready`；结果页显示 `图片已就绪` 和 `0 文件`，不会自动请求 Hyper3D 下载。
+- 关联：`server-rs/crates/api-server/src/match3d.rs`、`src/components/match3d-result/Match3DResultView.tsx`、`docs/technical/MATCH3D_DRAFT_ASSET_GENERATION_PIPELINE_2026-05-10.md`。
+
+## 抓大鹅切图路径不能只用中文物品名
+
+- 现象：草稿页 `3D素材` Tab 中多个素材名称不同，但预览图片完全一样；点击图生模型生成时还可能提示 `参考图必须是 data URL`。
+- 原因：中文物品名经过 OSS 路径段清洗后都可能退化成 `item`，多张切割图片写到同一个 `items/item/image.png` object key，后写入覆盖先写入；结果页手动 Rodin 图生模型还曾把 `/generated-match3d-assets/...` 私有路径直接作为 `imageDataUrls` 提交。
+- 处理：切割图上传路径必须带稳定唯一 `itemId` 前缀，例如 `items/match3d-item-1-item/image.png`；结果页提交图生模型前，generated 私有路径先经同源 `/api/assets/read-bytes` 由后端换签并读取字节，前端再转成 `data:image/...;base64,...`，不要在浏览器里直接 `fetch` OSS 签名 URL，否则会被 bucket CORS 拦截。
+- 验证：后端单测覆盖中文名路径唯一；前端单测覆盖 generated 参考图会换签、fetch 并以 Data URL 调用 `submitHyper3dImageToModel`。
+- 关联：`server-rs/crates/api-server/src/match3d.rs`、`src/components/match3d-result/Match3DResultView.tsx`、`docs/technical/MATCH3D_DRAFT_ASSET_GENERATION_PIPELINE_2026-05-10.md`。
+
+## 抓大鹅生成素材不能只挂在 compile response
+
+- 现象：抓大鹅草稿生成完成后停留在结果页能看到切割好的 `3D素材` 图片；退出后从草稿 Tab 重新进入同一草稿，素材列表变回默认占位或为空，已生成的物品名称和图片丢失。
+- 原因：`generatedItemAssets` 如果只附加在 `match3d_compile_draft` 的 HTTP response draft 上，刷新或重进时 `getMatch3DWorkDetail` 只能读取 SpacetimeDB 中的 `match3d_work_profile`；旧 mapper 返回空数组，自然无法恢复素材。拼图链路已经通过 `save_puzzle_generated_images` 把候选图和 levels 写回 work profile，抓大鹅也必须同样写持久字段。
+- 处理：compile 成功时把独立物品图片列表序列化写入 `match3d_work_profile.generated_item_assets_json`；`update_match3d_work` / `publish_match3d_work` 保留该字段；API work summary/detail 映射反序列化为 `generatedItemAssets`。前端保持“本次 draft 优先，重进 profile 兜底”的读取顺序。
+- 验证：`cargo test -p spacetime-client match3d --manifest-path server-rs/Cargo.toml`、`cargo test -p api-server match3d --manifest-path server-rs/Cargo.toml`、`npm run test -- src/components/match3d-result/Match3DResultView.test.tsx`。
+- 关联：`server-rs/crates/spacetime-module/src/match3d/*`、`server-rs/crates/spacetime-client/src/mapper.rs`、`server-rs/crates/api-server/src/match3d.rs`、`src/components/match3d-result/Match3DResultView.tsx`、`docs/technical/MATCH3D_DRAFT_ASSET_GENERATION_PIPELINE_2026-05-10.md`。
diff --git a/apps/admin-web/src/api/adminApiTypes.ts b/apps/admin-web/src/api/adminApiTypes.ts
index 7206e1d4..b39ca305 100644
--- a/apps/admin-web/src/api/adminApiTypes.ts
+++ b/apps/admin-web/src/api/adminApiTypes.ts
@@ -154,6 +154,7 @@ export interface AdminUpsertProfileRedeemCodeRequest {
 export interface AdminUpsertProfileInviteCodeRequest {
   inviteCode: string;
   metadata?: Record<string, unknown>;
+  grantedUserTags: string[];
   startsAt?: string | null;
   expiresAt?: string | null;
 }
@@ -200,6 +201,7 @@ export interface ProfileInviteCodeAdminResponse {
   userId: string;
   inviteCode: string;
   metadata: Record<string, unknown>;
+  grantedUserTags: string[];
   startsAt?: string | null;
   expiresAt?: string | null;
   status: 'pending' | 'active' | 'expired';
diff --git a/apps/admin-web/src/pages/AdminInviteCodePage.tsx b/apps/admin-web/src/pages/AdminInviteCodePage.tsx
index dfbf119a..48f7c3c4 100644
--- a/apps/admin-web/src/pages/AdminInviteCodePage.tsx
+++ b/apps/admin-web/src/pages/AdminInviteCodePage.tsx
@@ -28,6 +28,7 @@ export function AdminInviteCodePage({
   const [inviteCode, setInviteCode] = useState('');
   const [startsAt, setStartsAt] = useState('');
   const [expiresAt, setExpiresAt] = useState('');
+  const [grantedTagsText, setGrantedTagsText] = useState('');
   const [metadataText, setMetadataText] = useState('{}');
   const [errorMessage, setErrorMessage] = useState('');
   const [listErrorMessage, setListErrorMessage] = useState('');
@@ -80,6 +81,7 @@ export function AdminInviteCodePage({
       const payload: AdminUpsertProfileInviteCodeRequest = {
         inviteCode: inviteCode.trim(),
         metadata: parseMetadata(metadataText),
+        grantedUserTags: parseUserTags(grantedTagsText),
         startsAt: startsAt ? toIsoDateTime(startsAt) : null,
         expiresAt: expiresAt ? toIsoDateTime(expiresAt) : null,
       };
@@ -115,6 +117,7 @@ export function AdminInviteCodePage({
     setInviteCode(entry.inviteCode);
     setStartsAt(toDateTimeLocalValue(entry.startsAt));
     setExpiresAt(toDateTimeLocalValue(entry.expiresAt));
+    setGrantedTagsText(entry.grantedUserTags.join('、'));
     setMetadataText(JSON.stringify(entry.metadata, null, 2));
   }
 
@@ -174,6 +177,15 @@ export function AdminInviteCodePage({
             </label>
           </div>
 
+          <label className="admin-field">
+            <span>用户标签</span>
+            <input
+              autoComplete="off"
+              value={grantedTagsText}
+              onChange={(event) => setGrantedTagsText(event.target.value)}
+            />
+          </label>
+
           <label className="admin-field">
             <span>Metadata JSON</span>
             <textarea
@@ -222,6 +234,7 @@ export function AdminInviteCodePage({
                   <thead>
                     <tr>
                       <th>邀请码</th>
+                      <th>标签</th>
                       <th>有效期</th>
                       <th>创建</th>
                     </tr>
@@ -238,6 +251,9 @@ export function AdminInviteCodePage({
                             {entry.inviteCode}
                           </button>
                         </td>
+                        <td>
+                          <TagList tags={entry.grantedUserTags} />
+                        </td>
                         <td>
                           <span className={`admin-status ${inviteValidityClass(entry)}`}>
                             {inviteValidityLabel(entry)}
@@ -272,6 +288,12 @@ export function AdminInviteCodePage({
                   <dt>有效期</dt>
                   <dd>{formatValidityWindow(result)}</dd>
                 </div>
+                <div>
+                  <dt>标签</dt>
+                  <dd>
+                    <TagList tags={result.grantedUserTags} />
+                  </dd>
+                </div>
                 <div>
                   <dt>创建</dt>
                   <dd>{result.createdAt}</dd>
@@ -300,6 +322,33 @@ export function AdminInviteCodePage({
   );
 }
 
+function TagList({tags}: {tags: string[]}) {
+  if (!tags.length) {
+    return <span className="admin-muted-text">-</span>;
+  }
+
+  return (
+    <span className="admin-tag-list">
+      {tags.map((tag) => (
+        <span className="admin-tag" key={tag}>
+          {tag}
+        </span>
+      ))}
+    </span>
+  );
+}
+
+function parseUserTags(value: string) {
+  const tags: string[] = [];
+  for (const raw of value.split(/[\n,，;；、]+/)) {
+    const tag = raw.trim();
+    if (tag && !tags.includes(tag)) {
+      tags.push(tag);
+    }
+  }
+  return tags;
+}
+
 function parseMetadata(value: string): Record<string, unknown> {
   const trimmed = value.trim();
   if (!trimmed) {
diff --git a/apps/admin-web/src/styles/admin.css b/apps/admin-web/src/styles/admin.css
index 24096c02..93ee4007 100644
--- a/apps/admin-web/src/styles/admin.css
+++ b/apps/admin-web/src/styles/admin.css
@@ -684,6 +684,32 @@ button:disabled {
   font-size: 12px;
 }
 
+.admin-muted-text {
+  color: #86939c;
+}
+
+.admin-tag-list {
+  display: flex;
+  min-width: 0;
+  flex-wrap: wrap;
+  gap: 6px;
+}
+
+.admin-tag {
+  display: inline-flex;
+  max-width: 100%;
+  align-items: center;
+  border: 1px solid #cbdfe6;
+  border-radius: 999px;
+  background: #eef7f8;
+  color: #0f5666;
+  padding: 3px 8px;
+  font-size: 12px;
+  font-weight: 750;
+  line-height: 1.2;
+  overflow-wrap: anywhere;
+}
+
 .admin-table-compact {
   min-width: 360px;
 }
diff --git a/docs/design/PLATFORM_MOBILE_RECOMMEND_DISCOVER_DRAFT_TAB_REDESIGN_2026-05-05.md b/docs/design/PLATFORM_MOBILE_RECOMMEND_DISCOVER_DRAFT_TAB_REDESIGN_2026-05-05.md
index 6673f80a..a17f8e3d 100644
--- a/docs/design/PLATFORM_MOBILE_RECOMMEND_DISCOVER_DRAFT_TAB_REDESIGN_2026-05-05.md
+++ b/docs/design/PLATFORM_MOBILE_RECOMMEND_DISCOVER_DRAFT_TAB_REDESIGN_2026-05-05.md
@@ -32,15 +32,15 @@
 - 数据来源沿用 `featuredEntries + latestEntries` 去重后的公开作品列表。
 - 首个可运行作品自动进入推荐页内嵌运行态，主视口不再展示作品封面卡。
 - 主视口占据顶部栏与作品信息区之间的主要空间，使用平台主题 token 控制运行容器背景、边框、阴影、加载态文字和错误态按钮；亮色主题不得残留纯黑底白字加载块。
-- 主视口下方展示当前作品的游玩、点赞、评论/改造等紧凑指标、作者头像、作者名与作品名，不写规则说明类文案。
+- 主视口下方展示当前作品操作区与基础信息：作者头像、作者名、作品名、点赞按钮、点赞数、分享按钮、改造按钮；不展示游玩次数、评论入口或额外心形收藏入口，不写规则说明类文案。
 - 作品信息区不再提供详情箭头或点击详情入口；点击该区域无效，上滑切换下一个推荐作品，下滑切换上一个推荐作品。
 - 推荐页切换参考短视频上下滑交互：当前运行画布位于中间，上一个/下一个作品的封面预览提前挂载在画布上下屏幕外；拖动作品信息区时三屏轨道跟随位移，松手后完成切换或回弹。
 - 用户停留在推荐页时，底部当前 Tab 从“推荐”切换为“下一个”，图标使用向下的倒三角 / 双下箭头语义，点击后切换下一个推荐作品。
-- 推荐页不再展示额外的底部作品切换块；当前作品的完整操作继续收敛在详情页和作品自身运行态中。
+- 推荐页不再展示额外的底部作品切换块；当前作品的点赞、分享与改造在推荐页底部操作区直接完成，其它作品深层操作继续由详情页和作品自身运行态承接。
 - 推荐页嵌入运行只调整平台外壳容器、主题注入和玩法壳层配色，不改写作品数据、关卡设定、道具设定或图片资产。
 - 屏幕外预览只允许使用公开封面、作品名和类型，不提前启动其它作品 run，不触发道具、计时、存档或作品数据变更。
 - 推荐页嵌入拼图玩法时隐藏拼图左上返回按钮，并在设置弹层中隐藏退出入口；作品切换前对当前拼图 run 执行既有“保存并退出”收口，正式 run 的交互状态以已写回后端的快照为准。
-- 点赞、改造、复制作品号等完整操作继续收敛在详情页，详情入口由作品自身运行态或其它广场列表承接，推荐页作品信息区只负责展示和上下滑切换。
+- 底部操作区移除游玩次数、评论功能和额外心形收藏入口；点赞按钮可直接点击并刷新公开读模型返回的点赞数，分享按钮复制作品号与公开作品链接，改造按钮只保留改造 icon 并复用既有改造入口。操作按钮只响应自身点击，按钮外的信息区点击无效，拖动时仍跟随整张推荐卡上下切换作品。
 - 无数据、加载中、启动失败和暂不支持内嵌运行的作品沿用短状态文案。
 
 桌面端仍保持现有首页布局，只把一级导航文案从“首页”改为“推荐”。
@@ -93,6 +93,7 @@
 11. 仅推荐页嵌入拼图态隐藏返回与设置内退出入口；详情页、新手引导和普通拼图运行态继续保留原有退出能力。
 12. 推荐页切换作品前，如果当前作品是拼图，必须先执行当前拼图 run 的退出收口，再启动下一作品。
 13. 已登录推荐页的上/下滑切换必须展示相邻作品的屏幕外预览，并在拖动不足阈值时回弹；相邻预览不得提前启动玩法运行态。
+14. 推荐页底部区域不展示游玩次数、评论入口和额外心形收藏入口；点赞、分享和改造都使用 icon 按钮，点赞数紧邻点赞按钮展示。
 
 ## 8. 2026-05-07 未登录三栏补充
 
diff --git a/docs/design/PUZZLE_RUNTIME_HEADER_AND_CLEAR_EFFECT_DESIGN_2026-04-27.md b/docs/design/PUZZLE_RUNTIME_HEADER_AND_CLEAR_EFFECT_DESIGN_2026-04-27.md
index ef2fb54e..28ddb82d 100644
--- a/docs/design/PUZZLE_RUNTIME_HEADER_AND_CLEAR_EFFECT_DESIGN_2026-04-27.md
+++ b/docs/design/PUZZLE_RUNTIME_HEADER_AND_CLEAR_EFFECT_DESIGN_2026-04-27.md
@@ -65,7 +65,7 @@
 
 1. 玩家需要优先依赖画面主体、构图和色块识别位置。
 2. 编号覆盖会削弱“完整图片被逐步复原”的视觉奖励。
-3. 合成后的拼图块只保留原图切片、外轮廓描边和必要的拖拽层级，不叠加额外的色块、暗层或蒙版，避免破坏原图识别。
+3. 单块和合成后的拼图块只保留原图切片、外轮廓描边和必要的拖拽层级，不叠加额外的色块、暗层或蒙版，避免破坏原图识别。
 
 ### 3. 设置能力
 
diff --git a/docs/prd/AI_NATIVE_MATCH3D_CREATOR_AND_GAMEPLAY_SYSTEM_PRD_2026-04-30.md b/docs/prd/AI_NATIVE_MATCH3D_CREATOR_AND_GAMEPLAY_SYSTEM_PRD_2026-04-30.md
index 9d8254a3..43bcdebf 100644
--- a/docs/prd/AI_NATIVE_MATCH3D_CREATOR_AND_GAMEPLAY_SYSTEM_PRD_2026-04-30.md
+++ b/docs/prd/AI_NATIVE_MATCH3D_CREATOR_AND_GAMEPLAY_SYSTEM_PRD_2026-04-30.md
@@ -1,6 +1,6 @@
 # AI 原生抓大鹅 Match3D 玩法创作工具与玩法系统 PRD
 
-更新时间：`2026-04-30`
+更新时间：`2026-05-10`
 
 ## 0. 文档目的
 
@@ -16,7 +16,7 @@
 
 ## 1. 一句话定义
 
-让百梦主通过 Agent 对话确认题材、需要消除次数和难度，系统编译出一个可试玩、可发布的单局抓大鹅玩法作品；玩家在 `10` 分钟倒计时内点击圆形空间中可见物品，把物品放入下方 `7` 格备选栏，每凑齐 `3` 个同物品 id 自动消除，最终清空圆形空间内全部物品即胜利。
+让百梦主在创作页通过表单确认题材主题和难度选项，系统根据难度选项派生需要消除次数与难度数值，并编译出一个可试玩、可发布的单局抓大鹅玩法作品；玩家在 `10` 分钟倒计时内点击圆形空间中可见物品，把物品放入下方 `7` 格备选栏，每凑齐 `3` 个同物品 id 自动消除，最终清空圆形空间内全部物品即胜利。
 
 ---
 
@@ -36,7 +36,7 @@
 ```text
 平台创作入口
 -> 选择“抓大鹅”
--> Agent 对话确认题材、需要消除次数、难度
+-> 入口表单确认题材主题、难度选项
 -> 生成待发布结果页
 -> 编辑作品基础信息
 -> 发布前试玩
@@ -62,7 +62,7 @@
 ## 3.1 复用什么
 
 1. 复用平台创作中心入口。
-2. 复用 Agent-first 创作体验。
+2. 复用拼图式创作页入口表单体验。
 3. 复用“创作会话 -> 结果页 -> 发布 -> 运行态”的平台主链。
 4. 复用作品基础信息、标签、封面、发布接口和作品管理体验。
 5. 复用现有 Rust / SpacetimeDB 后端基线。
@@ -93,13 +93,13 @@ Match3D 必须形成独立玩法域，后续技术方案至少需要覆盖：
 首版 demo 必须满足：
 
 1. 平台新增“抓大鹅”玩法创作入口。
-2. 创建流程采用 Agent 对话收集关键配置。
-3. Agent 必须在进入结果页前确认：
+2. 创建流程采用入口表单收集关键配置。
+3. 表单必须在进入结果页前确认：
    - 题材主题
-   - 需要消除次数
-   - 难度 `1~10`
-4. 支持系统自动补全配置，用户确认后开始创造。
-5. 题材阶段允许上传参考图片。
+   - 3D 素材风格
+   - 难度选项
+4. `需要消除次数` 与难度 `1~10` 数值不再作为独立输入框展示，由难度选项派生。
+5. 生成抓大鹅草稿消耗 `20` 光点，生成按钮必须显式展示。
 6. 结果页支持编辑游戏名称、标签、封面图等基础发布信息。
 7. 发布前支持试玩，并允许随时停止和修改配置。
 8. 发布不要求试玩通关。
@@ -110,7 +110,8 @@ Match3D 必须形成独立玩法域，后续技术方案至少需要覆盖：
 13. 清空圆形空间中全部物品即胜利。
 14. 倒计时结束或备选栏满即失败。
 15. 胜利 / 失败后展示结算界面。
-16. 点击、入槽、消除、失败、胜利的即时反馈效果由前端先行呈现，后端负责权威确认、状态落库和成绩可信性。
+16. 入口页的 3D 素材风格选择会进入素材图提示词，并作为结果页手动 Rodin 3D 模型生成的默认提示词依据。
+17. 点击、入槽、消除、失败、胜利的即时反馈效果由前端先行呈现，后端负责权威确认、状态落库和成绩可信性。
 
 ---
 
@@ -137,13 +138,22 @@ Match3D 必须形成独立玩法域，后续技术方案至少需要覆盖：
 
 ## 6.1 创作方式
 
-Match3D 首版参考拼图早期的 Agent 对话收集锚点，而不是拼图后期的纯表单入口。
+Match3D 首版参考拼图后期的入口表单收集方式，而不是早期的 Agent 对话锚点收集。
 
-Agent 的职责是帮助用户确认可以直接编译 demo 的最小配置：
+表单的职责是帮助用户确认可以直接编译 demo 的最小配置：
 
 1. 题材主题。
-2. 需要消除次数。
-3. 游戏难度。
+2. 3D 素材风格。
+3. 游戏难度选项。
+
+`需要消除次数` 与游戏难度数值仍属于后端会话配置，但不再要求用户手填。当前入口页固定采用以下映射：
+
+```text
+轻松 -> 需要消除 8 次，难度 2
+标准 -> 需要消除 12 次，难度 4
+进阶 -> 需要消除 16 次，难度 6
+硬核 -> 需要消除 20 次，难度 8
+```
 
 ## 6.2 必填配置
 
@@ -151,13 +161,13 @@ Agent 的职责是帮助用户确认可以直接编译 demo 的最小配置：
 
 题材决定后续生成或选择物品素材的方向。用户可以自定义主题，例如水果、玩具、食物、符号等。
 
-首版 demo 不接入真实图片生成。当前运行态可消除物统一使用参考图方向的 25 个积木件类型表现，不使用透明气泡，也不在图案上放文字标识。前端首版用差异化颜色、积木造型和 3D 程序化模型表现可消除物，避免玩家在堆叠状态下难以辨认。
+首版 demo 不接入真实图片生成。当前运行态可消除物统一使用题材方向的 25 个积木件类型表现，不使用透明气泡，也不在图案上放文字标识。前端首版用差异化颜色、积木造型和 3D 程序化模型表现可消除物，避免玩家在堆叠状态下难以辨认。
 
 可消除物尺寸使用五档相对体积规则：XL 型相对体积为 `1.60~2.30`，L 型为 `1.25~1.60`，M 型为 `1.00`，XS 型为 `0.65~0.85`，S 型为 `0.35~0.50`。单局中 XL / L / M / XS / S 按本局使用的消除物类型数的 `20% / 30% / 30% / 15% / 5%` 分配；非整数配额按最大余数补齐，确保总数等于本局使用类型数量。同一关卡内同一个颜色和造型的物品只能对应一个尺寸档位；可存在同尺寸但不同颜色和造型的物品。后端运行态通过 `radius` 下发权威尺寸，前端只按快照表现。
 
 ### 需要消除次数
 
-用户输入任意正整数。
+该字段由难度选项派生，不作为入口页独立输入框展示。
 
 该字段不是胜利条件，而是本局总物品规模配置：
 
@@ -169,21 +179,23 @@ Agent 的职责是帮助用户确认可以直接编译 demo 的最小配置：
 
 ### 难度
 
-用户输入 `1~10` 的数字，代表从低到高的难度感受。
+用户选择 `轻松 / 标准 / 进阶 / 硬核` 之一，系统派生 `1~10` 范围内的难度数值。
 
 首版 demo 中，用户只需凭感觉选择难度；具体难度规则由系统内部解释。后续优化阶段再细化难度曲线、生成算法和遮挡策略。
 
-## 6.3 自动配置
+### 3D 素材风格
 
-如果用户不想逐项填写，系统可以自动补全题材、需要消除次数和难度。
+入口页在题材主题与难度之间展示 `3D素材风格` 横向滑动选择。首批固定选项为：
 
-自动补全后的配置必须展示给用户确认，用户确认后才能开始创造。
+```text
+黏土手作 / 低多边形 / 玩具塑料 / 木质雕刻 / 体素积木 / 金属机甲 / 自定义
+```
 
-## 6.4 参考图片
+每个内置选项使用 VectorEngine `gpt-image-2-all` 生成的画风参考图展示；参考图保存在 `public/match3d-style-references/`，只作为入口选择的视觉提示，不作为用户上传参考图。选择内置风格时，前端提交 `assetStyleId`、`assetStyleLabel` 与对应 `assetStylePrompt`。选择 `自定义` 时必须弹出独立面板，用户填写描述后才允许应用；自定义描述作为 `assetStylePrompt` 进入后端生成链路。
 
-题材阶段允许用户上传参考图片。
+## 6.3 参考图片
 
-首版只支持图片参考，不支持视频参考。参考图片用于影响题材表现，不作为运行时规则裁决依据。
+抓大鹅入口页不展示参考图片上传。题材表现先由题材文本和草稿切割图片链路承接；后续需要 3D 模型时，在结果页 `3D素材` Tab 以切割图片作为图生模型参考图手动触发。
 
 ---
 
@@ -210,9 +222,9 @@ Agent 的职责是帮助用户确认可以直接编译 demo 的最小配置：
 
 ## 7.3 素材生成边界
 
-首版结果页暂时不生成额外素材。
+抓大鹅草稿生成链路会生成首批 `3` 个题材物品素材：文本模型生成物品名，VectorEngine 生成 `2*2` 素材图并切割独立图片。入口页选择的 `assetStylePrompt` 必须写入素材图提示词；结果页手动 Rodin 图生模型时，继续以该物品图片和默认提示词作为起点。
 
-后续如果需要生成题材物品、伪 3D 物品、场景背景或封面图，需要先补充本文档或新增技术方案，再进入编码。
+生成出的独立图片先作为草稿页 `3D素材` Tab 的预览资产返回，状态为 `image_ready`，模型文件为空。正式平台资产绑定、Rodin 生成模型转存和二次编辑流程以后续技术方案为准。
 
 ## 7.4 发布前试玩
 
@@ -415,15 +427,14 @@ itemTypeCount = clearCount <= 25 ? clearCount : 25
 
 前端负责所有游戏过程中需要即时呈现的反馈效果：
 
-1. 展示 Agent 创作界面。
+1. 展示表单式创作界面。
 2. 展示结果页和基础编辑表单。
-3. 上传参考图片。
-4. 展示运行态场景、物品、倒计时和备选栏。
-5. 基于最新后端快照执行 2D 命中检测、悬停、按压和选中反馈。
-6. 发送玩家点击意图。
-7. 在等待后端确认期间，先行播放飞入、入槽、三消、腾格、胜利和失败过渡效果。
-8. 收到后端确认后，把本地表现校正到权威快照。
-9. 展示结算界面。
+3. 展示运行态场景、物品、倒计时和备选栏。
+4. 基于最新后端快照执行 2D 命中检测、悬停、按压和选中反馈。
+5. 发送玩家点击意图。
+6. 在等待后端确认期间，先行播放飞入、入槽、三消、腾格、胜利和失败过渡效果。
+7. 收到后端确认后，把本地表现校正到权威快照。
+8. 展示结算界面。
 
 前端可以做即时表现预判，但不得把预判结果作为最终规则真相或成绩来源。
 
@@ -444,7 +455,7 @@ itemTypeCount = clearCount <= 25 ? clearCount : 25
 ```ts
 interface Match3DCreatorConfig {
   themeText: string;
-  referenceImageSrc?: string;
+  referenceImageSrc?: string | null;
   clearCount: number;
   difficulty: number;
 }
@@ -453,9 +464,9 @@ interface Match3DCreatorConfig {
 字段说明：
 
 1. `themeText`：题材主题。
-2. `referenceImageSrc`：可选参考图片。
-3. `clearCount`：需要消除次数，必须为正整数。
-4. `difficulty`：难度，范围为 `1~10`。
+2. `referenceImageSrc`：历史兼容字段，入口页固定提交为 `null`。
+3. `clearCount`：由难度选项派生的需要消除次数，必须为正整数。
+4. `difficulty`：由难度选项派生的难度数值，范围为 `1~10`。
 
 ## 11.2 作品结构
 
@@ -656,15 +667,17 @@ GET /api/runtime/match3d/runs/:runId
 
 创作入口只展示必要信息，不默认堆叠玩法规则说明。
 
-## 14.2 Agent 工作区
+## 14.2 入口表单
 
-Agent 每轮优先追问最影响 demo 生成的一个问题。
+入口表单只展示三个输入块：
 
-已确认的信息应清晰展示给用户确认：
+1. `想做一个什么题材的抓大鹅？` 大文本输入框。
+2. `3D素材风格` 横向滑动风格卡，最后一个为 `自定义`。
+3. `难度` 选项按钮。
 
-1. 题材主题。
-2. 需要消除次数。
-3. 难度。
+入口页不展示参考图、`需要消除次数` 数值输入、`难度数值` 滑杆，也不展示 `题材 / 物品 / 难度` 三个摘要框。`需要消除次数` 和 `difficulty` 由难度选项派生后提交给后端。
+
+抓大鹅入口页必须适配移动端创作页一屏内展示，页面自身不产生纵向滚动。题材输入框、风格横滑区、难度按钮和生成按钮根据可视高度自适应压缩，风格区只允许横向滑动。
 
 ## 14.3 结果页
 
@@ -689,22 +702,24 @@ Agent 每轮优先追问最影响 demo 生成的一个问题。
 首版 PRD 对应 demo 验收标准：
 
 1. 用户可从平台创作入口进入“抓大鹅”模板。
-2. Agent 能确认题材、需要消除次数和难度。
-3. 用户可上传参考图片。
-4. 系统可生成待发布结果页。
-5. 用户可编辑游戏名称、标签、封面图等基础信息。
-6. 用户可发布前试玩，且试玩失败不阻断发布。
-7. 运行态能展示圆形空间、倒计时、物品和 `7` 格备选栏。
-8. 物品可重叠、遮挡、堆叠。
-9. 被完全遮挡物品不可点击，露出可点击区域的物品可点击。
-10. 点击通过后物品飞入备选栏。
-11. 备选栏中 `3` 个相同物品 id 自动消除。
-12. 清空空间中全部物品后胜利。
-13. 倒计时结束或备选栏满后失败。
-14. 胜利结算展示使用时间。
-15. 失败结算展示完成进度和重新开始按钮。
-16. 局内即时反馈由前端先行呈现，关键状态以后端确认快照校正。
-17. 相关中文文档通过编码检查。
+2. 入口表单能确认题材主题、3D 素材风格和难度选项，并提交派生后的消除次数与难度数值。
+3. 入口页不展示参考图上传。
+4. 内置风格显示画风参考图，自定义风格通过独立面板填写并进入提交 payload。
+5. 移动端入口页所有内容一屏展示，不产生纵向滚动。
+6. 系统可生成待发布结果页，并在草稿中返回首批切割图片素材预览。
+7. 用户可编辑游戏名称、标签、封面图等基础信息。
+8. 用户可发布前试玩，且试玩失败不阻断发布。
+9. 运行态能展示圆形空间、倒计时、物品和 `7` 格备选栏。
+10. 物品可重叠、遮挡、堆叠。
+11. 被完全遮挡物品不可点击，露出可点击区域的物品可点击。
+12. 点击通过后物品飞入备选栏。
+13. 备选栏中 `3` 个相同物品 id 自动消除。
+14. 清空空间中全部物品后胜利。
+15. 倒计时结束或备选栏满后失败。
+16. 胜利结算展示使用时间。
+17. 失败结算展示完成进度和重新开始按钮。
+18. 局内即时反馈由前端先行呈现，关键状态以后端确认快照校正。
+19. 相关中文文档通过编码检查。
 
 ---
 
@@ -719,7 +734,7 @@ Agent 每轮优先追问最影响 demo 生成的一个问题。
 ## 阶段 B：创作与结果页
 
 1. 新增平台创作入口。
-2. 接入 Agent 会话。
+2. 接入创作会话。
 3. 编译草稿并进入结果页。
 4. 复用基础信息编辑和发布链。
 
diff --git a/docs/prd/AI_NATIVE_VISUAL_NOVEL_TEMPLATE_PRD_2026-05-05.md b/docs/prd/AI_NATIVE_VISUAL_NOVEL_TEMPLATE_PRD_2026-05-05.md
index 2d817456..18a413c7 100644
--- a/docs/prd/AI_NATIVE_VISUAL_NOVEL_TEMPLATE_PRD_2026-05-05.md
+++ b/docs/prd/AI_NATIVE_VISUAL_NOVEL_TEMPLATE_PRD_2026-05-05.md
@@ -110,9 +110,10 @@
 ```text
 平台创作中心
 -> 选择视觉小说
--> 选择创作起点：一句话 / 文档 / 空白
--> 进入 visual-novel-agent-workspace
--> Agent 生成或补齐底稿
+-> 视觉小说入口页只展示一句话创作输入框和视觉画风选项
+-> 点击生成草稿
+-> 进入 visual-novel-generating
+-> 生成或补齐底稿
 -> 进入 visual-novel-result
 -> 编辑世界观、角色、场景、剧情阶段、资产和运行时配置
 -> 点击试玩
@@ -154,10 +155,11 @@
 
 1. 作品标题。
 2. 一句话简介。
-3. 世界观摘要。
-4. 玩家身份。
-5. 3 到 6 个主要角色。
-6. 3 到 8 个可用场景。
+3. 视觉画风。
+4. 世界观摘要。
+5. 玩家身份。
+6. 3 到 6 个主要角色。
+7. 3 到 8 个可用场景。
 7. 3 到 6 个剧情阶段。
 8. 初始场景、初始旁白和第一轮可选行动。
 
@@ -772,20 +774,23 @@ service client 要复用现有请求封装、鉴权和错误提示风格，不
 
 ### 12.1 工作台
 
-工作台只展示创作需要的输入和状态：
+入口页只展示创作需要的输入和状态：
 
-1. 创作起点选择：一句话、文档、空白。
-2. 文本输入框和文档上传。
-3. Agent 对话区域。
-4. 底稿生成进度。
-5. 进入结果页按钮。
+1. 一句话创作输入框。
+2. 视觉画风选项，参考抓大鹅入口页的横向卡片选择结构。
+3. 生成草稿按钮。
+4. 错误、忙碌与禁用态。
+
+点击生成草稿后进入 `visual-novel-generating` 过程页，过程页复用平台已有生成进度面板，展示一句话输入、画风和草稿生成阶段；完成后自动进入 `visual-novel-result` 草稿页。
 
 不展示：
 
 1. 平台规则说明。
 2. 外部仓库平台功能介绍。
-3. 回放、分享回放、录像、复盘入口。
-4. 大段字段解释。
+3. 文档 / 空白创建入口。
+4. Agent 对话侧栏。
+5. 回放、分享回放、录像、复盘入口。
+6. 大段字段解释。
 
 ### 12.2 结果页
 
diff --git a/docs/technical/API_SERVER_EXTERNAL_SERVICE_ENV_CONFIG_2026-05-07.md b/docs/technical/API_SERVER_EXTERNAL_SERVICE_ENV_CONFIG_2026-05-07.md
index 78f31f19..14e1ed41 100644
--- a/docs/technical/API_SERVER_EXTERNAL_SERVICE_ENV_CONFIG_2026-05-07.md
+++ b/docs/technical/API_SERVER_EXTERNAL_SERVICE_ENV_CONFIG_2026-05-07.md
@@ -105,6 +105,7 @@ HYPER3D_MODEL_REQUEST_TIMEOUT_MS / RODIN_MODEL_REQUEST_TIMEOUT_MS
 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 文本/多模态理解链路；GPT-image-2 图片生成不得再读取 APIMart 配置。
+10. 本地 `npm run api-server`、`npm run dev:rust` 与 `npm run dev` 的环境文件优先级固定为外层 shell 变量最高，其后 `.env`、`.env.local`、`.env.secrets.local` 逐层覆盖；真实密钥建议放在 `.env.secrets.local`，防止 `.env` 中的空示例值覆盖私密配置。
 
 ## 示例文件
 
diff --git a/docs/technical/HYPER3D_RODIN_GEN2_MODEL_GENERATION_2026-05-08.md b/docs/technical/HYPER3D_RODIN_GEN2_MODEL_GENERATION_2026-05-08.md
index 97b3c1b0..68e6c299 100644
--- a/docs/technical/HYPER3D_RODIN_GEN2_MODEL_GENERATION_2026-05-08.md
+++ b/docs/technical/HYPER3D_RODIN_GEN2_MODEL_GENERATION_2026-05-08.md
@@ -44,7 +44,8 @@ RODIN_MODEL_REQUEST_TIMEOUT_MS
 
 1. `HYPER3D_API_KEY` / `RODIN_API_KEY` 只允许写入本地或生产私密环境，不提交到 Git。
 2. 缺少 API Key 时，后端返回 `503 SERVICE_UNAVAILABLE`。
-3. `HYPER3D_BASE_URL` 默认使用公开 API 基础地址；如果团队后续改用代理网关，可通过环境变量覆盖。
+3. 本地真实联调推荐把 key 放在 `.env.secrets.local`；`npm run api-server`、`npm run dev:rust` 与 `npm run dev` 均应保持“外层 shell 变量优先，随后 `.env`、`.env.local`、`.env.secrets.local` 逐层覆盖”的口径，避免 `.env` 里的空示例值压掉私密 key。
+4. `HYPER3D_BASE_URL` 默认使用公开 API 基础地址；如果团队后续改用代理网关，可通过环境变量覆盖。
 
 ## 4. 后端路由
 
@@ -91,6 +92,7 @@ RODIN_MODEL_REQUEST_TIMEOUT_MS
 6. `meshMode` 限定为 `Quad/Raw`，默认 `Quad`。
 7. `addons` 首版只允许 `HighPack`。
 8. `bboxCondition` 必须为 3 个正数，按上游要求序列化为 JSON 字符串。
+9. `subscriptionKey` 是 Hyper3D 返回的 opaque token，状态查询只校验非空，不在本地做 256 字符等固定长度限制，避免长 token 阻断抓大鹅草稿内联模型生成。
 
 ## 6. 返回语义
 
diff --git a/docs/technical/MATCH3D_DRAFT_ASSET_GENERATION_PIPELINE_2026-05-10.md b/docs/technical/MATCH3D_DRAFT_ASSET_GENERATION_PIPELINE_2026-05-10.md
new file mode 100644
index 00000000..f8fe9268
--- /dev/null
+++ b/docs/technical/MATCH3D_DRAFT_ASSET_GENERATION_PIPELINE_2026-05-10.md
@@ -0,0 +1,130 @@
+# 抓大鹅草稿素材生成流水线 2026-05-10
+
+## 1. 范围
+
+本方案用于改造 `生成抓大鹅草稿` 的首版生成链路：点击按钮后先进入独立生成过程页，生成结束后自动进入抓大鹅草稿页，并在草稿页 `3D素材` Tab 预览本次生成的 3D 模型。
+
+本次只把任意难度都收敛为 `3` 件物品。后续难度曲线恢复时，再把物品数、网格数和手动 3D 任务数量从配置中放开。
+
+## 2. 前端流程
+
+入口仍复用 `Match3DAgentWorkspace` 表单。点击 `生成抓大鹅草稿` 后：
+
+1. 创建 Match3D session。
+2. 进入 `match3d-generating` 生成过程页。
+3. 过程页复用拼图生成页的 `CustomWorldGenerationView` 结构。
+4. 生成成功后自动进入 `match3d-result`。
+5. 生成失败时停留在生成过程页，允许重新生成或返回创作中心。
+
+生成页步骤固定为：
+
+```text
+生成物品名称 -> 生成素材图 -> 切割独立图片 -> 生成 3D 模型 -> 上传图片与模型资产 -> 写入草稿页
+```
+
+生成页只展示题材和物品数量，不展示玩法规则说明。
+
+## 3. 后端编排边界
+
+外部模型和 OSS 上传全部由 `api-server` 编排，不进入 SpacetimeDB reducer。SpacetimeDB 继续只负责 Match3D 会话、草稿和作品 profile 的确定性写入。
+
+`match3d_compile_draft` action 的后端顺序为：
+
+1. 读取 session config。
+2. 将本次 MVP 的 `clearCount` 固定为 `3`，并同步用于草稿编译。
+3. 调用文本模型生成 `3` 个题材下的短物品名称。
+4. 调用项目当前图片链路 VectorEngine `gpt-image-2-all` 生成一张 `1:1` 素材图，提示词必须合入入口页选择的 `assetStylePrompt`。历史 `nanobanana2` 图片选项当前按项目统一决策回落到 VectorEngine，不重新接入 APIMart 图片网关。
+5. 将素材图按 `n*n` 网格切割成独立图片。当前 `3` 件物品使用 `2*2` 网格，取前 `3` 格。
+6. 将素材图和每张独立图片上传到 OSS，其中独立图片作为 Rodin 图生模型参考图。
+7. 对每张独立图片调用 Hyper3D Rodin Gen-2 图生模型，等待任务完成，读取 GLB 下载文件并转存到 `generated-match3d-assets`。
+8. 调用现有 SpacetimeDB compile procedure 写入草稿，并把本次生成的独立物品图片与模型文件引用序列化写入 `match3d_work_profile.generated_item_assets_json`。这一步对标拼图的 `save_puzzle_generated_images`：生成资产不能只挂在本次 HTTP response 上，否则退出结果页后从草稿架读取 `getMatch3DWorkDetail` 会丢失素材列表。
+9. 在 HTTP 返回的 draft/profile DTO 中附带本次生成的素材资产预览信息，模型生成成功时状态为 `model_ready`；后续重进草稿页时从 work profile 的持久化 `generatedItemAssets` 恢复同一批素材。
+
+草稿生成阶段会调用 Hyper3D Rodin，并等待 GLB 模型文件可下载；不得把上游下载 URL 直接写入 Match3D profile，必须先转存 OSS，再保存 `/generated-match3d-assets/...` 引用。结果页 `3D素材` Tab 的重新生成按钮仍可手动触发 Rodin 任务，但正式持久化仍以后端草稿生成链路写入的模型文件为准。
+
+## 4. 图片提示词
+
+素材图提示词必须显式包含：
+
+```text
+生成一张1:1图片
+生成2*2网格素材图
+整体画风遵循：...
+只绘制这些物品：...
+不要出现文字、水印、UI、边框
+```
+
+`包含若干个物品名称` 在落地中解释为“按生成出的物品名称绘制对应主体”，不要求图片上写出物品名称。这样可以避免文字渲染污染切图和后续手动 3D 模型参考。
+
+入口页内置风格参考图通过同一 VectorEngine `gpt-image-2-all` 能力生成，保存路径固定为：
+
+```text
+public/match3d-style-references/clay-toy.png
+public/match3d-style-references/low-poly.png
+public/match3d-style-references/toy-plastic.png
+public/match3d-style-references/wood-carved.png
+public/match3d-style-references/voxel-block.png
+public/match3d-style-references/metal-mecha.png
+```
+
+这些图片只作为入口页风格选择的视觉参考，不进入用户草稿资产，不替代生成时的物品素材图。
+
+## 5. OSS 路径
+
+新增 generated legacy prefix：
+
+```text
+generated-match3d-assets
+```
+
+建议对象分组：
+
+```text
+generated-match3d-assets/{sessionId}/{profileId}/material-sheet/{taskId}/sheet.png
+generated-match3d-assets/{sessionId}/{profileId}/items/{itemSlug}/image.png
+generated-match3d-assets/{sessionId}/{profileId}/items/{itemSlug}/model/{taskUuid}/model.glb
+```
+
+`itemSlug` 必须带 `itemId` 前缀，例如 `match3d-item-1-item`。中文物品名清洗后可能都退回 `item`，不能只用物品名做路径，否则多张切割图会写到同一个 object key，导致草稿页预览图全部一致。
+
+HTTP DTO 同时返回 `imageSrc`、`imageObjectKey`、`modelSrc`、`modelObjectKey`、`modelFileName`、`taskUuid`、`subscriptionKey` 和 `status = model_ready`。前端模型预览不得直接请求裸 `/generated-match3d-assets/...` 路径；需要通过 `/api/assets/read-bytes` 读取模型字节，转成 Blob URL 后交给 Three.js GLTFLoader 加载，以绕开私有 bucket CORS。
+
+## 6. 自动保存与草稿恢复
+
+抓大鹅结果页的基础信息自动保存继续调用 `PUT /api/runtime/match3d/works/{profileId}` 更新名称、题材、描述、标签、封面、消除数和难度；该保存不得清空 `generated_item_assets_json`。SpacetimeDB `update_match3d_work` / `publish_match3d_work` 必须保留当前行的生成素材 JSON。
+
+草稿架重进路径为：
+
+```text
+草稿 Tab -> getMatch3DWorkDetail(profileId) -> Match3DResultView(profile.generatedItemAssets)
+```
+
+因此 `map_match3d_work_summary_response` / `map_match3d_work_profile_response` 需要从 work profile snapshot 反序列化 `generated_item_assets_json` 并输出 `generatedItemAssets`。前端 `Match3DResultView` 仍保持现有优先级：本次生成流程内有 `draft.generatedItemAssets` 时用 draft；从草稿架重进没有 draft 时，用 `profile.generatedItemAssets`；两者都没有才回退到默认 3D 素材占位。
+
+`3D素材` 详情页只保留：
+
+1. 模型预览区：优先加载 `modelSrc` 对应 GLB，支持拖动旋转；没有模型时展示空预览。
+2. 素材名称输入。
+3. `重新生成` 按钮。
+
+详情页不再展示参考图、用途、提示词、文生/图生切换、状态查询、下载列表、taskUuid 或 subscriptionKey。
+
+## 7. 验收
+
+建议执行：
+
+```powershell
+npm run check:encoding
+npm run test -- src\services\miniGameDraftGenerationProgress.test.ts
+npm run test -- src\components\match3d-result\Match3DResultView.test.tsx
+npm run typecheck
+cargo test -p shared-contracts match3d --manifest-path server-rs\Cargo.toml
+cargo test -p spacetime-client match3d --manifest-path server-rs\Cargo.toml
+cargo test -p platform-oss --manifest-path server-rs\Cargo.toml
+cargo test -p api-server match3d --manifest-path server-rs\Cargo.toml
+cargo check -p api-server --manifest-path server-rs\Cargo.toml
+cargo check -p spacetime-client --manifest-path server-rs\Cargo.toml
+cargo check -p spacetime-module --manifest-path server-rs\Cargo.toml
+```
+
+真实草稿生成需要本地私密环境配置 `VECTOR_ENGINE_API_KEY`、`HYPER3D_API_KEY` 和 OSS 访问变量。后端改动后使用 `npm run api-server` 启动，并检查 `/healthz`。
diff --git a/docs/technical/MATCH3D_F1_CREATION_ENTRY_AND_AGENT_UI_2026-04-30.md b/docs/technical/MATCH3D_F1_CREATION_ENTRY_AND_AGENT_UI_2026-04-30.md
index 22603f23..9d4ffbef 100644
--- a/docs/technical/MATCH3D_F1_CREATION_ENTRY_AND_AGENT_UI_2026-04-30.md
+++ b/docs/technical/MATCH3D_F1_CREATION_ENTRY_AND_AGENT_UI_2026-04-30.md
@@ -1,6 +1,10 @@
 # 抓大鹅 Match3D F1 创作入口与 Agent UI 落地记录 2026-04-30
 
 > 2026-05-08 更新：抓大鹅创作端入口已重新开放，当前 `match3d.visible` 为 `true`。本文件记录 F1 接入能力，入口是否展示以 `NEW_WORK_ENTRY_CONFIG_2026-05-01.md` 和 `src/config/newWorkEntryConfig.ts` 为准。
+>
+> 2026-05-10 更新：抓大鹅入口页对齐拼图入口页，直接嵌入创作页模板 Tab。入口表单不再展示参考图、消除次数输入、难度数值滑杆和题材/物品/难度摘要框，仅保留题材主题大输入框和难度选项。难度选项负责派生 `clearCount` 与 `difficulty`，生成按钮必须展示 `消耗20光点`。
+>
+> 2026-05-10 补充：入口页新增 `3D素材风格` 横向滑动选择，首批风格参考图通过 VectorEngine `gpt-image-2-all` 生成并保存到 `public/match3d-style-references/`。最后一个选项为 `自定义`，点击后弹出独立面板填写画风描述。
 
 ## 1. 阶段边界
 
@@ -30,19 +34,38 @@ badge: 可创建
 
 入口来源统一走 `getVisiblePlatformCreationTypes()`，因此创作首页首屏卡带与“选择创作类型”弹层会同时出现抓大鹅。
 
-## 4. Agent 工作区
+## 4. 入口表单工作区
 
-新增 `Match3DAgentWorkspace`，复用通用 `CreationAgentWorkspace`。
+新增 `Match3DAgentWorkspace`，组件名继续兼容既有路由、草稿恢复和父层分流；当前主入口已从固定 Agent 追问收口为拼图式表单。
 
-Agent 只收集三类锚点：
+创作页 `选择模板` Tab 中切换到 `抓大鹅` 时，直接渲染该表单，不创建会话，也不跳到独立工作台。点击生成后才创建 Match3D 会话并执行 `match3d_compile_draft`。
 
-1. 题材主题。
-2. 需要消除次数。
-3. 难度。
+表单只展示三个输入块：
 
-工作区支持参考图片上传入口。图片在 F1 中先以 Data URL 形式随消息 payload 带给 mock client；B5 接入后由后端 facade 替换为正式资产上传与引用。
+1. `想做一个什么题材的抓大鹅？`：大文本输入框，收集 `themeText`。
+2. `3D素材风格`：横向滑动风格卡，选择会写入 `assetStyleId`、`assetStyleLabel` 与 `assetStylePrompt`。
+3. `难度`：四个选项按钮，选项内部派生消除次数和难度数值。
 
-UI 中不默认展示玩法规则长文，只展示进度、锚点、聊天内容和必要按钮。
+当前难度映射固定为：
+
+```text
+轻松 -> clearCount 8,  difficulty 2
+标准 -> clearCount 12, difficulty 4
+进阶 -> clearCount 16, difficulty 6
+硬核 -> clearCount 20, difficulty 8
+```
+
+入口页不再上传参考图，提交 payload 中 `referenceImageSrc` 固定为 `null`。如果从旧会话或旧草稿恢复，前端只根据已有 `difficulty` 选择最接近的难度选项，并按当前选项重新派生 `clearCount` 与 `difficulty`。
+
+内置风格选项为：
+
+```text
+黏土手作 / 低多边形 / 玩具塑料 / 木质雕刻 / 体素积木 / 金属机甲 / 自定义
+```
+
+自定义风格必须在弹出面板中填写描述后才能应用。入口表单必须在移动端创作页可视区内完成题材、风格、难度和生成按钮的展示，页面自身不产生纵向滚动；风格卡只允许横向滑动。
+
+生成按钮文案为 `生成抓大鹅草稿`，按钮内必须同时展示 `消耗20光点`。UI 中不默认展示玩法规则长文，也不展示隐藏派生数值的摘要框。
 
 ## 5. mock client
 
@@ -84,10 +107,13 @@ POST /api/creation/match3d/sessions/:sessionId/compile
 
 ## 8. 验收口径
 
-1. 创作首页能看到“抓大鹅 / 经典消除玩法”。
-2. 弹层选择“抓大鹅”能进入 Agent 工作区。
-3. 输入题材、消除次数、难度后进度到 `100%`。
-4. 点击“生成结果页”进入草稿承接页。
-5. 可从草稿承接页返回 Agent 修改。
-6. `npm run check:encoding` 通过。
-7. `npm run typecheck` 通过。
+1. 创作页 `选择模板` Tab 能看到 `抓大鹅 / 经典消除玩法`。
+2. 切换到 `抓大鹅` Tab 后，页面内直接显示抓大鹅入口表单，不提前创建会话。
+3. 表单不展示参考图、`需要消除次数`、`难度数值`、`题材`、`物品`、`难度`摘要框。
+4. 输入题材、选择风格和难度后，提交 payload 包含派生后的 `clearCount` 与 `difficulty`，`referenceImageSrc` 为 `null`，并包含 `assetStyleId`、`assetStyleLabel` 与 `assetStylePrompt`。
+5. 生成按钮展示 `消耗20光点`。
+6. 点击 `自定义` 风格弹出独立面板，填写后应用到提交 payload；未填写时不能应用空自定义风格。
+7. 移动端创作页内抓大鹅入口内容不产生纵向滚动，风格卡横向滑动。
+8. 点击生成后创建会话并进入草稿生成/结果页链路。
+9. `npm run check:encoding` 通过。
+10. `npm run typecheck` 通过。
diff --git a/docs/technical/MATCH3D_RODIN_ASSET_TAB_2026-05-10.md b/docs/technical/MATCH3D_RODIN_ASSET_TAB_2026-05-10.md
new file mode 100644
index 00000000..810dec1c
--- /dev/null
+++ b/docs/technical/MATCH3D_RODIN_ASSET_TAB_2026-05-10.md
@@ -0,0 +1,75 @@
+# 抓大鹅 Rodin 3D 素材 Tab 接入方案 2026-05-10
+
+## 1. 范围
+
+本方案用于把抓大鹅结果页调整为多 Tab 工作台，并新增 `3D素材` Tab。该 Tab 专门服务抓大鹅玩法内物件、奖励、障碍等 3D 素材的 Rodin 生成试验。
+
+本次复用已有 Hyper3D Rodin Gen-2 后端安全代理，不新增 SpacetimeDB 表；草稿生成链路会把 Rodin 模型转存到 OSS，并通过 Match3D 作品 profile 的 `generatedItemAssets` 恢复。不得把 Hyper3D API Key、上游下载 URL 或本地 Data URL 写成正式资产真相。
+
+## 2. 页面结构
+
+抓大鹅结果页拆为三个 Tab：
+
+1. `作品信息`：承接封面、游戏名称、标签、简介。
+2. `玩法配置`：承接题材、消除次数、难度、参考图与局内数量摘要。
+3. `3D素材`：展示 Rodin 素材列表，点击列表项进入详情生成页。
+
+`3D素材` Tab 的列表布局参考 RPG 结果页角色列表：移动端纵向卡片，桌面端多列紧凑卡片；卡片展示素材名和状态。详情页只保留模型预览、素材名称和 `重新生成` 按钮。
+
+## 3. Rodin 任务边界
+
+前端只维护当前页面内的临时重新生成任务状态：
+
+1. 素材槽位名称。
+2. 模型预览。草稿生成的 `/generated-match3d-assets/...` GLB 必须通过同源 `/api/assets/read-bytes` 由后端换签并读取字节，前端再转成 Blob URL 后交给 Three.js GLTFLoader，避免浏览器直接 `fetch` OSS 签名 URL 时被 CORS 拦截。
+3. 图生模型参考图只作为重新生成的隐藏输入来源，不在详情页展示。上传图片在前端直接读成 Data URL；草稿生成的 `/generated-match3d-assets/...` 图片必须通过 `/api/assets/read-bytes` 转成 Data URL 后提交给 Hyper3D。
+4. Hyper3D `taskUuid` 与 `subscriptionKey`。
+5. 查询到的状态、进度与下载文件列表。
+
+正式资产链后续再接：
+
+1. 下载文件转存 OSS。
+2. `asset_object` 确认。
+3. `asset_entity_binding` 绑定到 Match3D 作品或物件槽位。
+
+首版不得把上游下载 URL 直接写入 Match3D profile，也不得把 Data URL 持久化到 SpacetimeDB。
+
+## 4. 接口复用
+
+继续使用既有前端 client：
+
+```text
+src/services/hyper3dModelGenerationService.ts
+```
+
+对应后端路由：
+
+```text
+POST /api/assets/hyper3d/text-to-model
+POST /api/assets/hyper3d/image-to-model
+POST /api/assets/hyper3d/status
+POST /api/assets/hyper3d/download
+```
+
+请求参数默认使用：
+
+```text
+geometryFileFormat = glb
+material = PBR
+quality = medium
+meshMode = Quad
+previewRender = true
+conditionMode = concat
+```
+
+## 5. 验收
+
+建议执行：
+
+```powershell
+npm run check:encoding
+npm run test -- src\components\match3d-result\Match3DResultView.test.tsx
+npm run typecheck
+```
+
+真实 Rodin 生成会消耗 Hyper3D Credit，只在本地私密环境配置 `HYPER3D_API_KEY` 或 `RODIN_API_KEY` 后手动验证。
diff --git a/docs/technical/MATCH3D_RUNTIME_3D_GEOMETRY_EXPERIMENT_2026-05-02.md b/docs/technical/MATCH3D_RUNTIME_3D_GEOMETRY_EXPERIMENT_2026-05-02.md
index c056f2ac..105964a0 100644
--- a/docs/technical/MATCH3D_RUNTIME_3D_GEOMETRY_EXPERIMENT_2026-05-02.md
+++ b/docs/technical/MATCH3D_RUNTIME_3D_GEOMETRY_EXPERIMENT_2026-05-02.md
@@ -262,3 +262,14 @@ cannon-es
 3. 可见 mesh 初始以较小比例显示，再用缓动动画放大到完整尺寸；视觉缩放不得反向修改 body shape、质量、边界半径或生成高度避让计算。
 4. 入场动画继续服从第 18 节的创建限流和第 19 节的生成高度避让；不能为了动画效果把物体直接放进已有堆叠内部。
 5. 动画结束后 mesh 缩放必须回到 `1`，避免影响后续点击可读性和托盘对应关系。
+
+## 21. 高 DPR 移动端 WebGL 画布尺寸锁定
+
+2026-05-10 针对移动端试玩入口中 3D 锅体和物体从中心区域向右下溢出的问题，补充 WebGL canvas 布局口径。
+
+编码口径：
+
+1. 中心 3D 棋盘和托盘 3D 预览都允许通过 `renderer.setPixelRatio(...)` 提升绘制清晰度，但 `WebGLRenderer.domElement` 的 CSS 显示尺寸必须单独锁定为 `position: absolute; inset: 0; width: 100%; height: 100%; display: block`。
+2. `renderer.setSize(width, height, false)` 只负责绘图缓冲区与当前容器尺寸同步，不能依赖 canvas 默认属性尺寸承载 CSS 布局；否则高 DPR 设备会把绘图缓冲区尺寸当成页面尺寸显示，导致棋盘内容放大并从容器右下溢出。
+3. 移动端验收仍以 `390px` 竖屏为基准：顶部状态、圆形棋盘和 `7` 格备选栏都必须完整可见，锅体内容应落在屏幕中间的圆形区域内。
+4. 该修复只影响 WebGL 画布 CSS 布局，不改变相机、物理世界、碰撞体、点击命中、后端权威快照或托盘规则。
diff --git a/docs/technical/PUZZLE_FORM_CREATION_FLOW_2026-04-29.md b/docs/technical/PUZZLE_FORM_CREATION_FLOW_2026-04-29.md
index 69c811a7..52a8b4d1 100644
--- a/docs/technical/PUZZLE_FORM_CREATION_FLOW_2026-04-29.md
+++ b/docs/technical/PUZZLE_FORM_CREATION_FLOW_2026-04-29.md
@@ -76,13 +76,14 @@
 4. 首图文生图 prompt 由 api-server 拼接固定拼图约束后统一压缩到 `500` 字符以内，避免玩家长画面描述触发 DashScope 参数非法；进度页和结果页仍展示玩家原始画面描述，不展示压缩后的内部 prompt。
 5. 图片生成仍在 api-server 内完成，遵守 SpacetimeDB reducer 不做网络 I/O 的约束。
 6. 参考图以 Data URL 进入 `POST /api/runtime/puzzle/agent/sessions` 和 `POST /api/runtime/puzzle/agent/sessions/{sessionId}/actions`，这两条路由必须单独放宽 JSON body 上限；不要放大全局默认 body limit。
-7. 前端仍应优先压缩参考图；后端 body 上限只用于容纳合理尺寸的单张参考图，超大原图不应直接落入 SpacetimeDB 或作为作品字段持久化。
-8. 作品更新接口 `PUT /api/runtime/puzzle/works/{profileId}` 必须支持作品信息和关卡列表一起写入，前端自动保存不得只写旧单关字段。
-9. `StartPuzzleRunRequest` 新增可选 `levelId`。详情页或草稿结果页单独体验某关时传入目标关卡，后端从作品/草稿的 `levels` 中选取该关卡生成运行态。
-10. `ExecutePuzzleAgentActionRequest` 必须保留 `pictureDescription` 字段。表单直达生成时，`compile_puzzle_draft` 优先用 `pictureDescription` 作为首图 prompt，再回退到旧 `promptText`；避免生成页展示的是玩家画面描述，但后端实际用作品名称或旧摘要出图。
-11. `compile_puzzle_draft` 中的图片上游失败不得映射成 `400 BAD_REQUEST`。DashScope 返回 `InvalidParameter` 或任务失败时，api-server 统一按 `502 UPSTREAM_ERROR` 暴露，并在 `details.message` 中保留“拼图图片生成失败：...”的业务原因，避免生成页只显示“请求参数不合法”。
-12. `compile_puzzle_draft` 前置光点预扣失败不得映射成 `400 BAD_REQUEST`。余额不足返回 `409 CONFLICT`，SpacetimeDB procedure 不可用、绑定不匹配、钱包服务异常等统一按 `502 UPSTREAM_ERROR` 暴露，并在 `details.message` 中保留真实钱包错误。
-13. 生成拼图作品草稿动作涉及的表单 seed prompt 与首图 prompt 来源选择统一收口在 `server-rs/crates/api-server/src/prompt/puzzle/draft.rs`；`puzzle.rs` 只负责调用 SpacetimeDB、计费、图片服务和持久化，不再直接拼草稿 prompt 文本。
+7. 前端仍应优先压缩参考图，入口上传图和裁剪图统一压到单边 1024 以内；后端 body 上限只用于容纳合理尺寸的单张参考图，超大原图不应直接落入 SpacetimeDB 或作为作品字段持久化，后端解析后会拒绝超过 8MB 字节的参考图。
+8. `aiRedraw = true` 且存在 `referenceImageSrc` 时，api-server 必须走 VectorEngine `POST /v1/images/edits` multipart 图生图接口；无参考图或入口页 `aiRedraw = false` 时不走图生图，关闭 AI 重绘会直接应用上传图为首关正式图。
+9. 作品更新接口 `PUT /api/runtime/puzzle/works/{profileId}` 必须支持作品信息和关卡列表一起写入，前端自动保存不得只写旧单关字段。
+10. `StartPuzzleRunRequest` 新增可选 `levelId`。详情页或草稿结果页单独体验某关时传入目标关卡，后端从作品/草稿的 `levels` 中选取该关卡生成运行态。
+11. `ExecutePuzzleAgentActionRequest` 必须保留 `pictureDescription` 字段。表单直达生成时，`compile_puzzle_draft` 优先用 `pictureDescription` 作为首图 prompt，再回退到旧 `promptText`；避免生成页展示的是玩家画面描述，但后端实际用作品名称或旧摘要出图。
+12. `compile_puzzle_draft` 中的图片上游失败不得映射成 `400 BAD_REQUEST`。DashScope 返回 `InvalidParameter` 或任务失败时，api-server 统一按 `502 UPSTREAM_ERROR` 暴露，并在 `details.message` 中保留“拼图图片生成失败：...”的业务原因，避免生成页只显示“请求参数不合法”。
+13. `compile_puzzle_draft` 前置光点预扣失败不得映射成 `400 BAD_REQUEST`。余额不足返回 `409 CONFLICT`，SpacetimeDB procedure 不可用、绑定不匹配、钱包服务异常等统一按 `502 UPSTREAM_ERROR` 暴露，并在 `details.message` 中保留真实钱包错误。
+14. 生成拼图作品草稿动作涉及的表单 seed prompt 与首图 prompt 来源选择统一收口在 `server-rs/crates/api-server/src/prompt/puzzle/draft.rs`；`puzzle.rs` 只负责调用 SpacetimeDB、计费、图片服务和持久化，不再直接拼草稿 prompt 文本。
 
 ## 结果页
 
@@ -104,10 +105,23 @@
 4. 底部吸底操作区只承载动作按钮，不默认写玩法说明或规则解释，避免压缩移动端编辑空间。
 5. 关卡详情面板内触发生成画面时，前端必须把当前编辑态完整 `levelsJson` 随 `generate_puzzle_images` action 一起提交。这样新建关卡在自动保存完成前立即生成，也能由后端写回目标关卡。
 6. api-server 处理 `generate_puzzle_images` 时，若 action 带有 `levelsJson`，必须用这份关卡快照覆盖本次生成的草稿关卡视图后再定位 `levelId`。若请求明确传入 `levelId` 但关卡列表中不存在该关卡，必须返回错误，不得静默回退第一关。
-7. 历史拼图素材入口只在已有正式图的 `画面图` 区域右下角展示，不再放在 `画面描述` 输入区；本地上传参考图入口仍保留在画面描述输入区右下角。
+7. 历史拼图素材入口和本地上传参考图入口统一收口到 `画面图` 图卡右下角，避免 `画面描述` 输入区同时承载文本编辑和素材入口；无正式图时也展示空图态图卡。
 8. 历史拼图素材列表必须由服务端按当前登录账号过滤，只返回 `asset_kind = puzzle_cover_image` 且 `owner_user_id = 当前账号` 的资产；不得依赖前端过滤，也不得展示其他账号素材。
+9. `画面图` 图卡本身就是上传热区，详情页不再保留右下角独立“上传参考图”按钮；历史入口统一使用带 `History` 图标和 `历史` 小字的按钮。入口页空图态的“点击上传拼图图片”只作为图卡内轻量提示，不使用胶囊按钮、边框或背景样式。
 
-画面描述区域不再展示候选图实际 prompt 或“请生成一张适合……”之类内部提示词模块。参考图入口保留在画面描述编辑区域内，便于重新生成时继续带入。结果页编辑关卡画面描述时只同步该关卡 `pictureDescription`；作品描述只在作品信息 Tab 编辑，作品详情页不得再回退使用画面描述。
+### 2026-05-10 关卡生图交互补充
+
+1. 关卡详情页的 `画面图` 与 `画面描述` 模块对齐入口页拼图表单：画面图使用稳定正方形图卡，画面描述使用固定高度输入区并保留图片模型选择。
+2. 新建关卡或无正式图关卡也展示 `画面图` 图卡；空图态只保留图标化占位和生成中状态，不追加规则说明文案。
+3. 关卡详情页删除手填 `参考图链接或资产ID` 输入框。参考图只能通过本地上传或历史拼图素材选择进入本次生成请求；字段 `levels[].pictureReference` 继续作为后端生成后的复用字段透传，不作为用户可手填表单项。
+4. 单关生成等待估算从 `30` 秒调整为 `90` 秒；生成按钮内展示小字 `等待时间可以制作更多关卡哦~`，不得另起说明面板。
+5. 触发某一关生成时，前端必须立即把该关 `generationStatus` 标为 `generating` 并随当前 `levelsJson` 写入草稿自动保存链路；后端生成完成后再写回 `ready`。
+6. `generationStatus = generating` 的关卡在详情弹窗关闭后仍保留进度展示，再次打开同一关详情能继续看到生成进度；关卡列表卡片也必须展示生成中的轻量状态。
+7. 单关图片生成必须作为后台 action 执行，不占用拼图结果页全局 busy 状态；生成期间仍允许编辑作品信息、编辑关卡、新增关卡、删除其他关卡、关卡测试和继续触发其他可并行动作。
+8. 发布是唯一必须等待全部图片生成完成的草稿结果页动作；发布检查需要把 `generationStatus = generating` 的关卡列为 blocker，避免未完成资源进入广场。
+9. 后台生图回包只合并对应关卡的图片候选、正式图、资产 ID 与生成状态，不得覆盖用户等待期间对关卡名、画面描述、作品信息或新增关卡所做的本地编辑。
+
+画面描述区域不再展示候选图实际 prompt 或“请生成一张适合……”之类内部提示词模块。参考图入口统一放在画面图图卡内，便于重新生成时继续带入，同时保持画面描述输入区只负责文本编辑。结果页编辑关卡画面描述时只同步该关卡 `pictureDescription`；作品描述只在作品信息 Tab 编辑，作品详情页不得再回退使用画面描述。
 
 ## 验收
 
diff --git a/docs/technical/README.md b/docs/technical/README.md
index 20d26357..f3055ae5 100644
--- a/docs/technical/README.md
+++ b/docs/technical/README.md
@@ -10,9 +10,12 @@
 - [VECTOR_ENGINE_GPT_IMAGE_2_GENERATION_2026-05-09.md](./VECTOR_ENGINE_GPT_IMAGE_2_GENERATION_2026-05-09.md)：记录 GPT-image-2 图片生成从 APIMart 迁移到 VectorEngine `gpt-image-2-all` 的接口、环境变量、尺寸映射、错误口径和验收命令。
 - [SPACETIMEDB_PUBLISH_SCCACHE_FALLBACK_2026-05-09.md](./SPACETIMEDB_PUBLISH_SCCACHE_FALLBACK_2026-05-09.md)：记录本地 `spacetime publish` 被 sccache wrapper 通信异常阻断时的根因、debug 构建参数口径和手动排障命令。
 - [AUTH_RESTORE_AND_RECOMMEND_LOADING_FIX_2026-05-09.md](./AUTH_RESTORE_AND_RECOMMEND_LOADING_FIX_2026-05-09.md)：记录刷新网页后登录态失效和推荐页作品卡卡在加载中的联合修复，覆盖 `AuthGate` 本地 token 优先恢复、refresh 失败不清 token、推荐页启动请求版本保护和错误态收口。
+- [USER_TAG_INVITE_AND_PUZZLE_LEADERBOARD_2026-05-10.md](./USER_TAG_INVITE_AND_PUZZLE_LEADERBOARD_2026-05-10.md)：冻结用户标签字段、后台邀请码授予标签、用户填写邀请码后合并账号标签，以及拼图排行榜只展示白名单标签 `北科` 的落地口径。
 - [RECOMMEND_RUNTIME_AUTH_FAILURE_ISOLATION_FIX_2026-05-09.md](./RECOMMEND_RUNTIME_AUTH_FAILURE_ISOLATION_FIX_2026-05-09.md)：记录平台推荐页自动加载作品、公开拼图作品完整运行态、平台 bootstrap 私有投影刷新和展示层图片换签的局部请求 `401` 不应扩散成全局登出的修复，覆盖 `authImpact: local` 请求策略、推荐页 embedded 运行态启动、拼图开局/排行榜/下一关和回归测试。
 - [AUTH_GATE_LOGIN_RACE_GUARD_FIX_2026-05-09.md](./AUTH_GATE_LOGIN_RACE_GUARD_FIX_2026-05-09.md)：记录 `AuthGate` 登录成功后又被旧 hydrate 覆盖回未登录态的竞态根因、版本号保护修复与回归测试。
 - [HYPER3D_RODIN_GEN2_MODEL_GENERATION_2026-05-08.md](./HYPER3D_RODIN_GEN2_MODEL_GENERATION_2026-05-08.md)：记录 Hyper3D Rodin Gen-2 文生 3D 模型、图生 3D 模型、状态查询和下载列表的后端代理、环境变量、请求约束与验收边界。
+- [MATCH3D_RODIN_ASSET_TAB_2026-05-10.md](./MATCH3D_RODIN_ASSET_TAB_2026-05-10.md)：记录抓大鹅结果页多 Tab 改造与 Rodin 3D 素材列表/详情页的前端接入边界，明确首版只复用 Hyper3D 后端代理，不新增表或正式资产写入。
+- [MATCH3D_DRAFT_ASSET_GENERATION_PIPELINE_2026-05-10.md](./MATCH3D_DRAFT_ASSET_GENERATION_PIPELINE_2026-05-10.md)：冻结抓大鹅草稿生成过程页、3 件物品名称生成、VectorEngine 1:1 素材图、n*n 切图、并行 Rodin 图生 3D 与 OSS 回填草稿页的端到端边界。
 - [VOLCENGINE_SPEECH_STREAMING_INTEGRATION_2026-05-08.md](./VOLCENGINE_SPEECH_STREAMING_INTEGRATION_2026-05-08.md)：记录火山引擎大模型 ASR 双向流式、TTS WebSocket 双向流式和 TTS HTTP SSE 单向流式的后端代理、环境变量、协议帧和验收边界。
 - [VECTOR_ENGINE_AUDIO_GENERATION_SUNO_VIDU_2026-05-08.md](./VECTOR_ENGINE_AUDIO_GENERATION_SUNO_VIDU_2026-05-08.md)：记录视觉小说结果页接入 VectorEngine Suno 文生背景音乐与 Vidu 文生音效的接口、环境变量、后端路由、OSS 资产回写和前端弹层交互边界。
 - [PROFILE_FEEDBACK_BACKEND_INTEGRATION_2026-05-08.md](./PROFILE_FEEDBACK_BACKEND_INTEGRATION_2026-05-08.md)：冻结“我的”页签帮助与反馈入口的后端接入方案，覆盖 `POST /api/profile/feedback`、`profile_feedback_submission`、凭证图片 Data URL 校验和前端预览/提交边界。
@@ -81,7 +84,7 @@
 - [PROFILE_INVITE_CODE_REGISTRATION_AND_ADMIN_2026-04-30.md](./PROFILE_INVITE_CODE_REGISTRATION_AND_ADMIN_2026-04-30.md)：冻结邀请码从“我的 Tab 填写”迁到注册环节的前后端边界、`profile_invite_code.metadata_json` 表结构扩展、管理员邀请码虚拟主体和奖励规则。
 - [MATCH3D_CREATION_AND_RUNTIME_MINIMAL_IMPLEMENTATION_2026-04-30.md](./MATCH3D_CREATION_AND_RUNTIME_MINIMAL_IMPLEMENTATION_2026-04-30.md)：冻结抓大鹅 Match3D 首版 demo 的独立玩法域、表与 procedure、HTTP facade、前端即时反馈/后端权威确认协议，以及可并行开发包。
 - [MATCH3D_DOMAIN_AND_CONTRACTS_STAGE1_2026-04-30.md](./MATCH3D_DOMAIN_AND_CONTRACTS_STAGE1_2026-04-30.md)：冻结抓大鹅 Match3D B1+B2 的纯领域规则 crate、Rust/TypeScript shared contracts，以及 Stage1 不触碰 SpacetimeDB 表和 api-server 的边界。
-- [MATCH3D_F1_CREATION_ENTRY_AND_AGENT_UI_2026-04-30.md](./MATCH3D_F1_CREATION_ENTRY_AND_AGENT_UI_2026-04-30.md)：记录抓大鹅 F1 创作入口、Agent 工作区、参考图入口、本地 mock client 与后续 B5 HTTP facade 替换点。
+- [MATCH3D_F1_CREATION_ENTRY_AND_AGENT_UI_2026-04-30.md](./MATCH3D_F1_CREATION_ENTRY_AND_AGENT_UI_2026-04-30.md)：记录抓大鹅 F1 创作入口与当前拼图式内嵌 Tab 表单，明确入口页仅保留题材大输入框和难度选项，由难度选项派生消除次数与难度数值。
 - [MATCH3D_F2_RESULT_AND_PUBLISH_2026-04-30.md](./MATCH3D_F2_RESULT_AND_PUBLISH_2026-04-30.md)：冻结抓大鹅 F2 结果页、基础信息编辑、发布前试玩入口、发布门槛、自动保存和已发布作品二次编辑恢复口径。
 - [MATCH3D_SPACETIME_CLIENT_AND_API_FACADE_2026-04-30.md](./MATCH3D_SPACETIME_CLIENT_AND_API_FACADE_2026-04-30.md)：记录抓大鹅 B4+B5 已落地的 SpacetimeDB bindings、`spacetime-client` facade、`api-server` HTTP 路由、shared contract 对齐和验收命令。
 - [MATCH3D_CREATION_ENTRY_COMING_SOON_2026-05-01.md](./MATCH3D_CREATION_ENTRY_COMING_SOON_2026-05-01.md)：记录抓大鹅创作页入口重新开放、首屏与弹层分流一致，以及公开广场失败不污染创作错误态的边界。
diff --git a/docs/technical/SPACETIMEDB_TABLE_CATALOG.md b/docs/technical/SPACETIMEDB_TABLE_CATALOG.md
index c16fd44a..38065907 100644
--- a/docs/technical/SPACETIMEDB_TABLE_CATALOG.md
+++ b/docs/technical/SPACETIMEDB_TABLE_CATALOG.md
@@ -71,8 +71,9 @@ SELECT * FROM auth_store_snapshot WHERE snapshot_id = 'default';
 
 ### `user_account`
 
-- 作用：用户账号主表，保存用户名、公开百梦号、手机号掩码、登录方式、密码登录开关和 token 版本。
-- 结构：`user_id PK: String`, `public_user_code: String`, `username: String`, `display_name: String`, `avatar_url: Option<String>`, `phone_number_masked: Option<String>`, `phone_number_e164: Option<String>`, `login_method: String`, `binding_status: String`, `wechat_bound: bool`, `password_hash: Option<String>`, `password_login_enabled: bool`, `token_version: u64`。
+- 作用：用户账号主表，保存用户名、公开百梦号、手机号掩码、登录方式、密码登录开关、token 版本和默认不前端展示的运营标签。
+- 结构：`user_id PK: String`, `public_user_code: String`, `username: String`, `display_name: String`, `avatar_url: Option<String>`, `phone_number_masked: Option<String>`, `phone_number_e164: Option<String>`, `login_method: String`, `binding_status: String`, `wechat_bound: bool`, `password_hash: String`, `password_login_enabled: bool`, `token_version: u64`, `user_tags: Vec<String>`。
+- 说明：`user_tags` 默认空数组，只允许后端白名单投影到特定业务接口；不得在登录态、个人资料等通用前端响应中直接暴露。
 - 索引：`username`, `public_user_code`。
 
 ```sql
@@ -255,10 +256,11 @@ SELECT * FROM profile_redeem_code_usage WHERE user_id = '<user_id>';
 
 ### `profile_invite_code`
 
-- 作用：用户邀请中心的邀请码主表，也承载后台运营预置邀请码。
-- 结构：`user_id PK: String`, `invite_code: String`, `metadata_json: String`, `created_at: Timestamp`, `updated_at: Timestamp`。
+- 作用：用户邀请中心的邀请码主表，也承载后台运营预置邀请码和使用后授予账号的运营标签。
+- 结构：`user_id PK: String`, `invite_code: String`, `metadata_json: String`, `created_at: Timestamp`, `updated_at: Timestamp`, `starts_at: Option<Timestamp>`, `expires_at: Option<Timestamp>`, `granted_user_tags: Vec<String>`。
 - 索引：主键 `user_id`，唯一索引 `invite_code`。
 - 后台读取：`GET /admin/api/profile/invite-codes` 只返回 `user_id` 以 `admin:` 开头的后台预置码；普通用户自己的邀请码不得进入后台运营列表。
+- 说明：`granted_user_tags` 默认空数组；用户注册填写该邀请码后合并进 `user_account.user_tags`，不回改历史用户。
 
 ```sql
 SELECT * FROM profile_invite_code WHERE user_id = '<user_id>';
@@ -661,8 +663,9 @@ SELECT * FROM match3d_agent_message WHERE session_id = '<session_id>' ORDER BY c
 
 ### `match3d_work_profile`
 
-- 作用：抓大鹅 Match3D 作品主表，保存作品基础信息、配置、发布状态和游玩次数。
-- 结构：`profile_id PK: String`, `owner_user_id: String`, `source_session_id: String`, `author_display_name: String`, `game_name: String`, `theme_text: String`, `summary_text: String`, `tags_json: String`, `cover_image_src: String`, `cover_asset_id: String`, `clear_count: u32`, `difficulty: u32`, `config_json: String`, `publication_status: String`, `play_count: u32`, `updated_at: Timestamp`, `published_at: Option<Timestamp>`。
+- 作用：抓大鹅 Match3D 作品主表，保存作品基础信息、配置、发布状态、游玩次数和草稿生成出的独立物品素材引用。
+- 结构：`profile_id PK: String`, `owner_user_id: String`, `source_session_id: String`, `author_display_name: String`, `game_name: String`, `theme_text: String`, `summary_text: String`, `tags_json: String`, `cover_image_src: String`, `cover_asset_id: String`, `clear_count: u32`, `difficulty: u32`, `config_json: String`, `publication_status: String`, `play_count: u32`, `updated_at: Timestamp`, `published_at: Option<Timestamp>`, `generated_item_assets_json: Option<String>`。
+- 说明：`generated_item_assets_json` 保存 `Match3DGeneratedItemAsset` 数组 JSON，用于草稿页退出后从作品架重进时恢复 `3D素材` Tab 中的切割图片预览；基础信息自动保存和发布必须保留该字段。
 - 索引：`owner_user_id`, `publication_status`。
 
 ```sql
diff --git a/docs/technical/USER_TAG_INVITE_AND_PUZZLE_LEADERBOARD_2026-05-10.md b/docs/technical/USER_TAG_INVITE_AND_PUZZLE_LEADERBOARD_2026-05-10.md
new file mode 100644
index 00000000..6fe00dc3
--- /dev/null
+++ b/docs/technical/USER_TAG_INVITE_AND_PUZZLE_LEADERBOARD_2026-05-10.md
@@ -0,0 +1,102 @@
+# 用户标签、邀请码授予与拼图榜单展示方案
+
+更新时间：`2026-05-10`
+
+## 1. 目标
+
+本次新增用户标签系统的最小闭环：
+
+1. `user_account` 增加账号标签字段，默认空。
+2. 后台预置邀请码可配置授予标签。
+3. 用户填写带标签的邀请码后，把标签合并到自己的账号。
+4. 标签默认不在前端资料页、邀请中心或通用接口展示。
+5. 拼图排行榜仅对白名单标签做展示，首版只展示 `北科`。
+
+## 2. 数据字段
+
+### `user_account.user_tags`
+
+- 类型：`Vec<String>`。
+- 默认：空数组。
+- 语义：账号级运营标签，属于后台与服务端投影数据，不作为普通前端个人资料字段。
+- 写入：首版只由邀请码兑换链路合并写入。
+- 迁移：旧迁移包和旧数据库按空数组兼容。
+
+### `profile_invite_code.granted_user_tags`
+
+- 类型：`Vec<String>`。
+- 默认：空数组。
+- 语义：使用该邀请码后授予被邀请账号的标签列表。
+- 范围：后台运营预置码和普通用户个人邀请码都可存字段，但后台表单首版只允许管理员配置预置码。
+- 迁移：旧邀请码按空数组兼容。
+
+## 3. 标签归一化
+
+标签由 `module-runtime` 提供统一归一化：
+
+1. trim 后为空的标签丢弃。
+2. 同一邀请码或同一账号内标签去重，保留首次出现顺序。
+3. 单个标签最长 `16` 字符，单次最多 `8` 个标签。
+4. 当前不做中英文互译，不把中文标签改写为英文。
+
+## 4. 邀请码授予流程
+
+用户填写邀请码时，后端按原有校验顺序完成身份、绑定状态、邀请码存在、自邀请与时间窗校验。校验通过后：
+
+1. 写入 `profile_referral_relation`。
+2. 发放原有双方奖励。
+3. 读取 `profile_invite_code.granted_user_tags`。
+4. 将这些标签合并进 `user_account.user_tags`。
+
+管理员更新邀请码时，`grantedUserTags` 代表覆盖该邀请码之后授予的标签集合；空数组代表不授予标签。更新邀请码不会回溯修改已经使用过该邀请码的账号。
+
+## 5. API 契约
+
+后台邀请码 upsert 请求增加：
+
+```json
+{
+  "inviteCode": "BEIKE2026",
+  "grantedUserTags": ["北科"],
+  "metadata": {},
+  "startsAt": null,
+  "expiresAt": null
+}
+```
+
+后台邀请码列表和 upsert 返回增加同名字段：
+
+```json
+{
+  "inviteCode": "BEIKE2026",
+  "grantedUserTags": ["北科"]
+}
+```
+
+用户侧邀请中心、账号资料、登录返回和普通 profile 接口不返回 `userTags`。
+
+## 6. 拼图排行榜展示
+
+拼图排行榜返回项增加 `visibleTags: string[]`。
+
+服务端构造排行榜时，从 `user_account.user_tags` 中仅投影允许公开展示的标签。首版公开展示白名单：
+
+```text
+北科
+```
+
+前端拼图通关弹窗按如下规则展示：
+
+1. 昵称保持第一行。
+2. `visibleTags` 非空时在昵称下方显示小标签。
+3. 没有 `visibleTags` 时不占额外文案。
+4. 本地兜底 run 的榜单 `visibleTags` 始终为空。
+
+## 7. 验收
+
+1. 新账号 `user_account.user_tags` 默认为空。
+2. 后台创建邀请码时可填写 `北科`，列表和结果面板可回显。
+3. 用户填写该邀请码后，账号表 `user_tags` 包含 `北科`。
+4. 不带标签的邀请码不改变账号标签。
+5. 拼图排行榜中带 `北科` 的用户昵称下方显示 `北科`，其它标签不显示。
+6. 执行 `npm run check:encoding`、`cargo check -p spacetime-module --manifest-path server-rs/Cargo.toml`，并按影响范围执行后台 typecheck / 拼图前端测试。
diff --git a/docs/technical/VECTOR_ENGINE_GPT_IMAGE_2_GENERATION_2026-05-09.md b/docs/technical/VECTOR_ENGINE_GPT_IMAGE_2_GENERATION_2026-05-09.md
index 440b01f7..9afbcb17 100644
--- a/docs/technical/VECTOR_ENGINE_GPT_IMAGE_2_GENERATION_2026-05-09.md
+++ b/docs/technical/VECTOR_ENGINE_GPT_IMAGE_2_GENERATION_2026-05-09.md
@@ -110,12 +110,13 @@ VECTOR_ENGINE_IMAGE_REQUEST_TIMEOUT_MS=180000
 1. 所有 GPT-image-2 生图请求都走 `POST {VECTOR_ENGINE_BASE_URL}/v1/images/generations`。
 2. 请求体 `model = gpt-image-2-all`，尺寸为 VectorEngine 支持的像素尺寸。
 3. 请求体不再包含 `official_fallback`。
-4. 参考图字段使用 `image`，不再使用 APIMart 的 `image_urls`。
+4. 无参考图时使用 `POST {VECTOR_ENGINE_BASE_URL}/v1/images/generations`；有参考图且处于 AI 重绘时改走 `POST {VECTOR_ENGINE_BASE_URL}/v1/images/edits`；入口页关闭 AI 重绘时直接应用上传图，不调用图片生成。
 5. 拼图入口页上传图生成首图后，返回的首关 `pictureReference` 保留该 Data URL；结果页重新生成在用户未重新上传参考图时会继续把 `pictureReference` 作为 `referenceImageSrc` 传给后端。
-6. 缺少 `VECTOR_ENGINE_BASE_URL` 或 `VECTOR_ENGINE_API_KEY` 时返回 `503 SERVICE_UNAVAILABLE`，`details.provider = "vector-engine"`。
-7. 上游错误映射为 `502 UPSTREAM_ERROR`，保留 `upstreamStatus`、业务 message 和截断后的 raw excerpt。
-8. 运行 `npm run check:encoding`、`cargo test -p api-server openai_image --manifest-path server-rs/Cargo.toml`、`cargo test -p api-server puzzle --manifest-path server-rs/Cargo.toml`、`cargo test -p api-server custom_world_ai --manifest-path server-rs/Cargo.toml`、`cargo test -p api-server character_visual --manifest-path server-rs/Cargo.toml`。
-9. 后端改动后使用 `npm run api-server` 重启，并确认 `/healthz`。
+6. 拼图有参考图时，后端 prompt 会显式要求以参考图为第一优先级，保留主体、构图、视角、姿态、配色和光影氛围；入口页会把参考图压到单边 1024 以内，后端拒绝超过 8MB 的参考图字节。
+7. 缺少 `VECTOR_ENGINE_BASE_URL` 或 `VECTOR_ENGINE_API_KEY` 时返回 `503 SERVICE_UNAVAILABLE`，`details.provider = "vector-engine"`。
+8. 上游错误映射为 `502 UPSTREAM_ERROR`，保留 `upstreamStatus`、业务 message 和截断后的 raw excerpt。
+9. 运行 `npm run check:encoding`、`cargo test -p api-server openai_image --manifest-path server-rs/Cargo.toml`、`cargo test -p api-server puzzle --manifest-path server-rs/Cargo.toml`、`cargo test -p api-server custom_world_ai --manifest-path server-rs/Cargo.toml`、`cargo test -p api-server character_visual --manifest-path server-rs/Cargo.toml`。
+10. 后端改动后使用 `npm run api-server` 重启，并确认 `/healthz`。
 
 ## 拼图链路排障日志
 
diff --git a/packages/shared/src/contracts/match3dAgent.ts b/packages/shared/src/contracts/match3dAgent.ts
index 743bf32c..d10b8b71 100644
--- a/packages/shared/src/contracts/match3dAgent.ts
+++ b/packages/shared/src/contracts/match3dAgent.ts
@@ -2,6 +2,8 @@
  * 抓大鹅 Match3D 创作 Agent 共享契约。
  * 字段按 HTTP facade 的 camelCase DTO 命名，后端领域层 snake_case 字段由 facade 映射。
  */
+import type { Match3DGeneratedItemAsset } from './match3dWorks';
+
 export type Match3DCreationStage =
   | 'collecting'
   | 'collecting_config'
@@ -29,6 +31,9 @@ export interface CreateMatch3DAgentSessionRequest {
   referenceImageSrc?: string | null;
   clearCount?: number;
   difficulty?: number;
+  assetStyleId?: string | null;
+  assetStyleLabel?: string | null;
+  assetStylePrompt?: string | null;
 }
 
 export type CreateMatch3DSessionRequest = CreateMatch3DAgentSessionRequest;
@@ -72,6 +77,9 @@ export interface Match3DCreatorConfig {
   referenceImageSrc?: string | null;
   clearCount: number;
   difficulty: number;
+  assetStyleId?: string | null;
+  assetStyleLabel?: string | null;
+  assetStylePrompt?: string | null;
 }
 
 export interface Match3DResultDraft {
@@ -88,6 +96,7 @@ export interface Match3DResultDraft {
   totalItemCount?: number;
   publishReady?: boolean;
   blockers?: string[];
+  generatedItemAssets?: Match3DGeneratedItemAsset[];
 }
 
 export interface Match3DAgentMessage {
diff --git a/packages/shared/src/contracts/match3dWorks.ts b/packages/shared/src/contracts/match3dWorks.ts
index e0b4194b..358caeb2 100644
--- a/packages/shared/src/contracts/match3dWorks.ts
+++ b/packages/shared/src/contracts/match3dWorks.ts
@@ -4,6 +4,28 @@
  */
 export type Match3DWorkPublicationStatus = 'draft' | 'published' | string;
 
+export type Match3DGeneratedItemAssetStatus =
+  | 'pending'
+  | 'image_ready'
+  | 'model_generating'
+  | 'model_ready'
+  | 'failed'
+  | string;
+
+export interface Match3DGeneratedItemAsset {
+  itemId: string;
+  itemName: string;
+  imageSrc?: string | null;
+  imageObjectKey?: string | null;
+  modelSrc?: string | null;
+  modelObjectKey?: string | null;
+  modelFileName?: string | null;
+  taskUuid?: string | null;
+  subscriptionKey?: string | null;
+  status: Match3DGeneratedItemAssetStatus;
+  error?: string | null;
+}
+
 export interface PutMatch3DWorkRequest {
   gameName: string;
   themeText?: string;
@@ -33,6 +55,7 @@ export interface Match3DWorkSummary {
   updatedAt: string;
   publishedAt?: string | null;
   publishReady: boolean;
+  generatedItemAssets?: Match3DGeneratedItemAsset[];
 }
 
 export interface Match3DWorkProfile extends Match3DWorkSummary {}
diff --git a/packages/shared/src/contracts/puzzleAgentActions.ts b/packages/shared/src/contracts/puzzleAgentActions.ts
index 42c4b8bf..8ba0656f 100644
--- a/packages/shared/src/contracts/puzzleAgentActions.ts
+++ b/packages/shared/src/contracts/puzzleAgentActions.ts
@@ -69,6 +69,7 @@ export type PuzzleAgentActionRequest =
       promptText?: string | null;
       referenceImageSrc?: string | null;
       imageModel?: string | null;
+      aiRedraw?: boolean;
       candidateCount?: number;
       workTitle?: string;
       workDescription?: string;
diff --git a/packages/shared/src/contracts/puzzleRuntimeSession.ts b/packages/shared/src/contracts/puzzleRuntimeSession.ts
index d64f8fa6..1c23952d 100644
--- a/packages/shared/src/contracts/puzzleRuntimeSession.ts
+++ b/packages/shared/src/contracts/puzzleRuntimeSession.ts
@@ -24,6 +24,7 @@ export interface PuzzleLeaderboardEntry {
   rank: number;
   nickname: string;
   elapsedMs: number;
+  visibleTags?: string[];
   isCurrentPlayer?: boolean;
 }
 
diff --git a/packages/shared/src/contracts/runtime.ts b/packages/shared/src/contracts/runtime.ts
index 34b1fa6a..db1e55f3 100644
--- a/packages/shared/src/contracts/runtime.ts
+++ b/packages/shared/src/contracts/runtime.ts
@@ -352,12 +352,19 @@ export type AdminDisableProfileRedeemCodeRequest = {
 export type AdminUpsertProfileInviteCodeRequest = {
   inviteCode: string;
   metadata?: Record<string, unknown> | null;
+  grantedUserTags?: string[];
+  startsAt?: string | null;
+  expiresAt?: string | null;
 };
 
 export type ProfileInviteCodeAdminResponse = {
   userId: string;
   inviteCode: string;
   metadata: Record<string, unknown>;
+  grantedUserTags: string[];
+  startsAt?: string | null;
+  expiresAt?: string | null;
+  status: 'pending' | 'active' | 'expired';
   createdAt: string;
   updatedAt: string;
 };
diff --git a/public/match3d-style-references/clay-toy.png b/public/match3d-style-references/clay-toy.png
new file mode 100644
index 00000000..3d48c230
Binary files /dev/null and b/public/match3d-style-references/clay-toy.png differ
diff --git a/public/match3d-style-references/low-poly.png b/public/match3d-style-references/low-poly.png
new file mode 100644
index 00000000..41a94f0f
Binary files /dev/null and b/public/match3d-style-references/low-poly.png differ
diff --git a/public/match3d-style-references/metal-mecha.png b/public/match3d-style-references/metal-mecha.png
new file mode 100644
index 00000000..11cea9a0
Binary files /dev/null and b/public/match3d-style-references/metal-mecha.png differ
diff --git a/public/match3d-style-references/toy-plastic.png b/public/match3d-style-references/toy-plastic.png
new file mode 100644
index 00000000..af2ea808
Binary files /dev/null and b/public/match3d-style-references/toy-plastic.png differ
diff --git a/public/match3d-style-references/voxel-block.png b/public/match3d-style-references/voxel-block.png
new file mode 100644
index 00000000..62dbc2dd
Binary files /dev/null and b/public/match3d-style-references/voxel-block.png differ
diff --git a/public/match3d-style-references/wood-carved.png b/public/match3d-style-references/wood-carved.png
new file mode 100644
index 00000000..e1546d9a
Binary files /dev/null and b/public/match3d-style-references/wood-carved.png differ
diff --git a/scripts/api-server-dev.mjs b/scripts/api-server-dev.mjs
index 95b60010..ad88f78e 100644
--- a/scripts/api-server-dev.mjs
+++ b/scripts/api-server-dev.mjs
@@ -1,6 +1,7 @@
 import { execFileSync, spawn } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 const repoRoot = process.cwd();
 const apiServerExePath = resolve(
@@ -8,8 +9,9 @@ const apiServerExePath = resolve(
   'server-rs/target/debug/api-server.exe',
 );
 const shellEnvKeys = new Set(Object.keys(process.env));
+const LOCAL_ENV_FILES = ['.env', '.env.local', '.env.secrets.local'];
 
-function loadEnvFile(path, target) {
+function loadEnvFile(path, target, protectedKeys = shellEnvKeys) {
   if (!existsSync(path)) {
     return;
   }
@@ -28,8 +30,9 @@ function loadEnvFile(path, target) {
 
     const [, key, rawValue] = match;
     // 只保留启动命令行和外层 shell 已显式传入的环境变量优先级；
-    // `.env.local` 需要能覆盖 `.env`，否则本地短信登录会被默认 false 压住。
-    if (shellEnvKeys.has(key)) {
+    // `.env.local` 与 `.env.secrets.local` 需要能覆盖 `.env`，
+    // 否则本地短信登录或私密模型密钥会被默认空值压住。
+    if (protectedKeys.has(key)) {
       continue;
     }
 
@@ -37,23 +40,20 @@ function loadEnvFile(path, target) {
   }
 }
 
-const mergedEnv = { ...process.env };
-loadEnvFile(resolve(repoRoot, '.env.secrets.local'), mergedEnv);
-loadEnvFile(resolve(repoRoot, '.env.local'), mergedEnv);
-loadEnvFile(resolve(repoRoot, '.env'), mergedEnv);
+export function loadApiServerEnv(
+  repoRootPath,
+  target,
+  protectedKeys = shellEnvKeys,
+) {
+  for (const fileName of LOCAL_ENV_FILES) {
+    loadEnvFile(resolve(repoRootPath, fileName), target, protectedKeys);
+  }
+}
 
-mergedEnv.GENARRATIVE_API_HOST = mergedEnv.GENARRATIVE_API_HOST || '127.0.0.1';
-mergedEnv.GENARRATIVE_API_PORT = mergedEnv.GENARRATIVE_API_PORT || '3100';
-mergedEnv.GENARRATIVE_SPACETIME_SERVER_URL =
-  mergedEnv.GENARRATIVE_SPACETIME_SERVER_URL || 'http://127.0.0.1:3101';
-mergedEnv.GENARRATIVE_SPACETIME_DATABASE = mergedEnv.GENARRATIVE_SPACETIME_DATABASE || '';
-mergedEnv.GENARRATIVE_SPACETIME_TOKEN = mergedEnv.GENARRATIVE_SPACETIME_TOKEN || '';
-
-if (!mergedEnv.GENARRATIVE_SPACETIME_DATABASE) {
-  console.error(
-    '[api-server] 缺少 GENARRATIVE_SPACETIME_DATABASE。',
-  );
-  process.exit(1);
+export function mergeApiServerEnv(repoRootPath, baseEnv = process.env) {
+  const mergedEnv = { ...baseEnv };
+  loadApiServerEnv(repoRootPath, mergedEnv, new Set(Object.keys(baseEnv)));
+  return mergedEnv;
 }
 
 function stopExistingWindowsApiServer() {
@@ -97,39 +97,63 @@ function stopExistingWindowsApiServer() {
   }
 }
 
-try {
-  stopExistingWindowsApiServer();
-} catch (error) {
-  console.error(
-    `[api-server] 清理旧 api-server 进程失败: ${error.message}`,
-  );
-  process.exit(1);
-}
+function main() {
+  const mergedEnv = mergeApiServerEnv(repoRoot);
 
-console.log(
-  `[api-server] SpacetimeDB ${mergedEnv.GENARRATIVE_SPACETIME_DATABASE} @ ${mergedEnv.GENARRATIVE_SPACETIME_SERVER_URL}`,
-);
+  mergedEnv.GENARRATIVE_API_HOST =
+    mergedEnv.GENARRATIVE_API_HOST || '127.0.0.1';
+  mergedEnv.GENARRATIVE_API_PORT = mergedEnv.GENARRATIVE_API_PORT || '3100';
+  mergedEnv.GENARRATIVE_SPACETIME_SERVER_URL =
+    mergedEnv.GENARRATIVE_SPACETIME_SERVER_URL || 'http://127.0.0.1:3101';
+  mergedEnv.GENARRATIVE_SPACETIME_DATABASE =
+    mergedEnv.GENARRATIVE_SPACETIME_DATABASE || '';
+  mergedEnv.GENARRATIVE_SPACETIME_TOKEN =
+    mergedEnv.GENARRATIVE_SPACETIME_TOKEN || '';
 
-const child = spawn(
-  'cargo',
-  ['run', '-p', 'api-server', '--manifest-path', 'server-rs/Cargo.toml'],
-  {
-    cwd: repoRoot,
-    env: mergedEnv,
-    stdio: 'inherit',
-  },
-);
-
-child.on('error', (error) => {
-  console.error(`[api-server] 启动 cargo 失败: ${error.message}`);
-  process.exit(1);
-});
-
-child.on('exit', (code, signal) => {
-  if (signal) {
-    console.error(`[api-server] api-server 被信号终止: ${signal}`);
+  if (!mergedEnv.GENARRATIVE_SPACETIME_DATABASE) {
+    console.error('[api-server] 缺少 GENARRATIVE_SPACETIME_DATABASE。');
     process.exit(1);
   }
 
-  process.exit(code ?? 0);
-});
+  try {
+    stopExistingWindowsApiServer();
+  } catch (error) {
+    console.error(`[api-server] 清理旧 api-server 进程失败: ${error.message}`);
+    process.exit(1);
+  }
+
+  console.log(
+    `[api-server] SpacetimeDB ${mergedEnv.GENARRATIVE_SPACETIME_DATABASE} @ ${mergedEnv.GENARRATIVE_SPACETIME_SERVER_URL}`,
+  );
+
+  const child = spawn(
+    'cargo',
+    ['run', '-p', 'api-server', '--manifest-path', 'server-rs/Cargo.toml'],
+    {
+      cwd: repoRoot,
+      env: mergedEnv,
+      stdio: 'inherit',
+    },
+  );
+
+  child.on('error', (error) => {
+    console.error(`[api-server] 启动 cargo 失败: ${error.message}`);
+    process.exit(1);
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      console.error(`[api-server] api-server 被信号终止: ${signal}`);
+      process.exit(1);
+    }
+
+    process.exit(code ?? 0);
+  });
+}
+
+if (
+  process.argv[1] &&
+  resolve(process.argv[1]) === fileURLToPath(import.meta.url)
+) {
+  main();
+}
diff --git a/scripts/api-server-dev.test.ts b/scripts/api-server-dev.test.ts
new file mode 100644
index 00000000..d0ded3e1
--- /dev/null
+++ b/scripts/api-server-dev.test.ts
@@ -0,0 +1,66 @@
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+
+import { describe, expect, test } from 'vitest';
+
+import { mergeApiServerEnv } from './api-server-dev.mjs';
+
+type EnvMap = Record<string, string>;
+
+function withTempEnvFiles(
+  files: Record<string, string>,
+  assertEnv: (env: EnvMap, tempDir: string) => void,
+) {
+  const tempDir = mkdtempSync(join(tmpdir(), 'genarrative-api-env-'));
+
+  try {
+    for (const [fileName, content] of Object.entries(files)) {
+      writeFileSync(join(tempDir, fileName), content, 'utf8');
+    }
+
+    assertEnv(mergeApiServerEnv(tempDir, {}) as EnvMap, tempDir);
+  } finally {
+    rmSync(tempDir, { recursive: true, force: true });
+  }
+}
+
+describe('api-server-dev env merge', () => {
+  test('.env.local 和 .env.secrets.local 可以覆盖 .env 默认值', () => {
+    withTempEnvFiles(
+      {
+        '.env': [
+          'SMS_AUTH_ENABLED=false',
+          'HYPER3D_API_KEY=',
+          'GENARRATIVE_SPACETIME_DATABASE=from-env',
+        ].join('\n'),
+        '.env.local': [
+          'SMS_AUTH_ENABLED=true',
+          'HYPER3D_API_KEY=local-key',
+        ].join('\n'),
+        '.env.secrets.local': 'HYPER3D_API_KEY=secret-key',
+      },
+      (env) => {
+        expect(env.SMS_AUTH_ENABLED).toBe('true');
+        expect(env.HYPER3D_API_KEY).toBe('secret-key');
+        expect(env.GENARRATIVE_SPACETIME_DATABASE).toBe('from-env');
+      },
+    );
+  });
+
+  test('外层 shell 变量优先于本地 env 文件', () => {
+    withTempEnvFiles(
+      {
+        '.env': 'HYPER3D_API_KEY=from-env',
+        '.env.local': 'HYPER3D_API_KEY=from-local',
+        '.env.secrets.local': 'HYPER3D_API_KEY=from-secrets',
+      },
+      (_env, tempDir) => {
+        expect(
+          mergeApiServerEnv(tempDir, { HYPER3D_API_KEY: 'from-shell' })
+            .HYPER3D_API_KEY,
+        ).toBe('from-shell');
+      },
+    );
+  });
+});
diff --git a/server-rs/crates/api-server/src/app.rs b/server-rs/crates/api-server/src/app.rs
index 129a34ae..53c540ed 100644
--- a/server-rs/crates/api-server/src/app.rs
+++ b/server-rs/crates/api-server/src/app.rs
@@ -24,7 +24,7 @@ use crate::{
     },
     assets::{
         bind_asset_object_to_entity, confirm_asset_object, create_direct_upload_ticket,
-        create_sts_upload_credentials, get_asset_history, get_asset_read_url,
+        create_sts_upload_credentials, get_asset_history, get_asset_read_bytes, get_asset_read_url,
     },
     auth::{
         AuthenticatedAccessToken, attach_refresh_session_token, inspect_auth_claims,
@@ -572,6 +572,7 @@ pub fn build_router(state: AppState) -> Router {
             post(resolve_role_asset_workflow).put(put_role_asset_workflow),
         )
         .route("/api/assets/read-url", get(get_asset_read_url))
+        .route("/api/assets/read-bytes", get(get_asset_read_bytes))
         .route(
             "/api/assets/hyper3d/text-to-model",
             post(submit_hyper3d_text_to_model).route_layer(middleware::from_fn_with_state(
diff --git a/server-rs/crates/api-server/src/assets.rs b/server-rs/crates/api-server/src/assets.rs
index b3d2dc25..ea7e6c80 100644
--- a/server-rs/crates/api-server/src/assets.rs
+++ b/server-rs/crates/api-server/src/assets.rs
@@ -1,7 +1,9 @@
 use axum::{
     Json,
+    body::Body,
     extract::{Extension, Query, State},
-    http::StatusCode,
+    http::{StatusCode, header},
+    response::Response,
 };
 use module_assets::{
     AssetObjectAccessPolicy, AssetObjectFieldError, INITIAL_ASSET_OBJECT_VERSION,
@@ -42,6 +44,8 @@ const SUPPORTED_ASSET_HISTORY_KINDS: [&str; 7] = [
     "square_hole_shape_image",
     "square_hole_hole_image",
 ];
+const ASSET_READ_BYTES_MAX_SIZE_BYTES: u64 = 10 * 1024 * 1024;
+const ASSET_READ_BYTES_DEFAULT_EXPIRE_SECONDS: u64 = 300;
 
 pub async fn create_direct_upload_ticket(
     State(state): State<AppState>,
@@ -150,6 +154,94 @@ pub async fn get_asset_read_url(
     ))
 }
 
+pub async fn get_asset_read_bytes(
+    State(state): State<AppState>,
+    Query(query): Query<GetReadUrlQuery>,
+) -> Result<Response, AppError> {
+    // 中文注释：浏览器可以用签名 URL 渲染图片，但不能稳定跨域 fetch 私有 OSS 字节；Rodin 图生模型参考图转 Data URL 走同源中转。
+    let oss_client = state.oss_client().ok_or_else(|| {
+        AppError::from_status(StatusCode::SERVICE_UNAVAILABLE).with_details(json!({
+            "provider": "aliyun-oss",
+            "reason": "OSS 未完成环境变量配置",
+        }))
+    })?;
+
+    let object_key = resolve_object_key_from_query(&query).ok_or_else(|| {
+        AppError::from_status(StatusCode::BAD_REQUEST).with_details(json!({
+            "field": "objectKey",
+            "reason": "必须提供 objectKey 或 legacyPublicPath",
+        }))
+    })?;
+
+    let signed = oss_client
+        .sign_get_object_url(OssSignedGetObjectUrlRequest {
+            object_key,
+            expire_seconds: Some(
+                query
+                    .expire_seconds
+                    .unwrap_or(ASSET_READ_BYTES_DEFAULT_EXPIRE_SECONDS),
+            ),
+        })
+        .map_err(|error| map_oss_error(error, "aliyun-oss"))?;
+
+    let upstream = reqwest::Client::new()
+        .get(signed.signed_url.as_str())
+        .send()
+        .await
+        .map_err(|error| map_asset_read_bytes_upstream_error(error.to_string()))?;
+    let upstream_status = upstream.status();
+    let content_type = upstream
+        .headers()
+        .get(reqwest::header::CONTENT_TYPE)
+        .and_then(|value| value.to_str().ok())
+        .map(str::trim)
+        .filter(|value| !value.is_empty())
+        .unwrap_or("application/octet-stream")
+        .to_string();
+
+    if upstream_status == reqwest::StatusCode::NOT_FOUND {
+        return Err(
+            AppError::from_status(StatusCode::NOT_FOUND).with_details(json!({
+                "provider": "aliyun-oss",
+                "message": "资源不存在",
+                "objectKey": signed.object_key,
+            })),
+        );
+    }
+    if !upstream_status.is_success() {
+        return Err(map_asset_read_bytes_upstream_error(format!(
+            "OSS 读取返回非成功状态：{}",
+            upstream_status.as_u16()
+        )));
+    }
+    if upstream
+        .content_length()
+        .is_some_and(|size| size > ASSET_READ_BYTES_MAX_SIZE_BYTES)
+    {
+        return Err(map_asset_read_bytes_too_large());
+    }
+
+    let bytes = upstream
+        .bytes()
+        .await
+        .map_err(|error| map_asset_read_bytes_upstream_error(error.to_string()))?;
+    if bytes.len() as u64 > ASSET_READ_BYTES_MAX_SIZE_BYTES {
+        return Err(map_asset_read_bytes_too_large());
+    }
+
+    Response::builder()
+        .status(StatusCode::OK)
+        .header(header::CONTENT_TYPE, content_type)
+        .header(header::CACHE_CONTROL, "private, max-age=60")
+        .body(Body::from(bytes))
+        .map_err(|error| {
+            AppError::from_status(StatusCode::INTERNAL_SERVER_ERROR).with_details(json!({
+                "provider": "asset-read-bytes",
+                "message": format!("构造资源内容响应失败：{error}"),
+            }))
+        })
+}
+
 pub async fn get_asset_history(
     State(state): State<AppState>,
     Extension(request_context): Extension<RequestContext>,
@@ -517,6 +609,23 @@ fn map_confirm_asset_object_error(error: SpacetimeClientError) -> AppError {
     }))
 }
 
+fn map_asset_read_bytes_upstream_error(message: String) -> AppError {
+    AppError::from_status(StatusCode::BAD_GATEWAY).with_details(json!({
+        "provider": "aliyun-oss",
+        "message": format!("读取资源内容失败：{message}"),
+    }))
+}
+
+fn map_asset_read_bytes_too_large() -> AppError {
+    AppError::from_status(StatusCode::PAYLOAD_TOO_LARGE).with_details(json!({
+        "provider": "aliyun-oss",
+        "message": format!(
+            "资源内容超过读取上限：{}MB",
+            ASSET_READ_BYTES_MAX_SIZE_BYTES / 1024 / 1024
+        ),
+    }))
+}
+
 fn current_utc_micros() -> i64 {
     use std::time::{SystemTime, UNIX_EPOCH};
 
@@ -866,6 +975,51 @@ mod tests {
         assert_eq!(response.status(), StatusCode::BAD_REQUEST);
     }
 
+    #[tokio::test]
+    async fn read_bytes_returns_service_unavailable_when_oss_missing() {
+        let app = build_router(AppState::new(AppConfig::default()).expect("state should build"));
+
+        let response = app
+            .oneshot(
+                Request::builder()
+                    .method("GET")
+                    .uri("/api/assets/read-bytes?legacyPublicPath=%2Fgenerated-match3d-assets%2Fsession%2Fprofile%2Fitems%2Fmatch3d-item-1-item%2Fimage.png")
+                    .header("x-genarrative-response-envelope", "1")
+                    .body(Body::empty())
+                    .expect("request should build"),
+            )
+            .await
+            .expect("request should succeed");
+
+        assert_eq!(response.status(), StatusCode::SERVICE_UNAVAILABLE);
+    }
+
+    #[tokio::test]
+    async fn read_bytes_rejects_missing_identifier() {
+        let config = AppConfig {
+            oss_bucket: Some("genarrative-assets".to_string()),
+            oss_endpoint: Some("oss-cn-shanghai.aliyuncs.com".to_string()),
+            oss_access_key_id: Some("test-access-key-id".to_string()),
+            oss_access_key_secret: Some("test-access-key-secret".to_string()),
+            ..AppConfig::default()
+        };
+
+        let app = build_router(AppState::new(config).expect("state should build"));
+
+        let response = app
+            .oneshot(
+                Request::builder()
+                    .method("GET")
+                    .uri("/api/assets/read-bytes")
+                    .body(Body::empty())
+                    .expect("request should build"),
+            )
+            .await
+            .expect("request should succeed");
+
+        assert_eq!(response.status(), StatusCode::BAD_REQUEST);
+    }
+
     #[tokio::test]
     async fn sts_upload_credentials_are_disabled_for_browser_writes() {
         let app = build_router(AppState::new(AppConfig::default()).expect("state should build"));
diff --git a/server-rs/crates/api-server/src/hyper3d_generation.rs b/server-rs/crates/api-server/src/hyper3d_generation.rs
index 3824f00c..4d9329df 100644
--- a/server-rs/crates/api-server/src/hyper3d_generation.rs
+++ b/server-rs/crates/api-server/src/hyper3d_generation.rs
@@ -136,7 +136,7 @@ async fn submit_text_to_model(
     )?)
 }
 
-async fn submit_image_to_model(
+pub(crate) async fn submit_image_to_model(
     state: &AppState,
     payload: contract::Hyper3dImageToModelRequest,
 ) -> Result<contract::Hyper3dTaskSubmitResponse, AppError> {
@@ -212,14 +212,15 @@ async fn submit_image_to_model(
     )?)
 }
 
-async fn query_task_status(
+pub(crate) async fn query_task_status(
     state: &AppState,
     payload: contract::Hyper3dTaskStatusRequest,
 ) -> Result<contract::Hyper3dTaskStatusResponse, AppError> {
     let settings = require_hyper3d_settings(state)?;
     let http_client = build_hyper3d_http_client(&settings)?;
+    // 中文注释：Hyper3D 返回的 subscriptionKey 是上游 opaque token，只做非空校验，不做人为 256 字符截断。
     let subscription_key =
-        normalize_required_text(&payload.subscription_key, "subscriptionKey", 256)?;
+        normalize_required_opaque_text(&payload.subscription_key, "subscriptionKey")?;
     let response = post_hyper3d_json(
         &http_client,
         &settings,
@@ -246,7 +247,7 @@ async fn query_task_status(
     })
 }
 
-async fn query_downloads(
+pub(crate) async fn query_downloads(
     state: &AppState,
     payload: contract::Hyper3dDownloadRequest,
 ) -> Result<contract::Hyper3dDownloadResponse, AppError> {
@@ -380,6 +381,7 @@ fn require_hyper3d_settings(state: &AppState) -> Result<Hyper3dSettings, AppErro
             AppError::from_status(StatusCode::SERVICE_UNAVAILABLE).with_details(json!({
                 "provider": HYPER3D_PROVIDER,
                 "reason": "HYPER3D_BASE_URL 未配置",
+                "message": "Hyper3D Rodin 服务地址未配置，请设置 HYPER3D_BASE_URL 或 RODIN_BASE_URL 后重启 api-server。",
             })),
         );
     }
@@ -394,6 +396,7 @@ fn require_hyper3d_settings(state: &AppState) -> Result<Hyper3dSettings, AppErro
             AppError::from_status(StatusCode::SERVICE_UNAVAILABLE).with_details(json!({
                 "provider": HYPER3D_PROVIDER,
                 "reason": "HYPER3D_API_KEY 未配置",
+                "message": "Hyper3D Rodin API Key 未配置，请在本地私密环境设置 HYPER3D_API_KEY 或 RODIN_API_KEY 后重启 api-server。",
             }))
         })?;
 
@@ -689,6 +692,21 @@ fn normalize_required_text(
     Ok(normalized)
 }
 
+fn normalize_required_opaque_text(value: &str, field: &'static str) -> Result<String, AppError> {
+    let normalized = value.trim().to_string();
+    if normalized.is_empty() {
+        return Err(
+            AppError::from_status(StatusCode::BAD_REQUEST).with_details(json!({
+                "provider": HYPER3D_PROVIDER,
+                "field": field,
+                "message": format!("{field} 不能为空"),
+            })),
+        );
+    }
+
+    Ok(normalized)
+}
+
 fn normalize_optional_limited_text(
     value: Option<&str>,
     max_chars: usize,
@@ -997,6 +1015,16 @@ mod tests {
         assert_eq!(error.status_code(), StatusCode::BAD_REQUEST);
     }
 
+    #[test]
+    fn accepts_opaque_subscription_key_without_length_cap() {
+        let long_key = "a".repeat(300);
+        let normalized =
+            normalize_required_opaque_text(&format!("  {long_key}  "), "subscriptionKey")
+                .expect("subscription key should be accepted");
+
+        assert_eq!(normalized, long_key);
+    }
+
     #[test]
     fn decodes_png_data_url() {
         let data_url = format!(
diff --git a/server-rs/crates/api-server/src/match3d.rs b/server-rs/crates/api-server/src/match3d.rs
index c2a78215..30df6286 100644
--- a/server-rs/crates/api-server/src/match3d.rs
+++ b/server-rs/crates/api-server/src/match3d.rs
@@ -1,6 +1,7 @@
 use std::{
+    collections::BTreeMap,
     convert::Infallible,
-    time::{SystemTime, UNIX_EPOCH},
+    time::{Duration, SystemTime, UNIX_EPOCH},
 };
 
 use axum::{
@@ -12,18 +13,25 @@ use axum::{
         sse::{Event, Sse},
     },
 };
+use base64::{Engine as _, engine::general_purpose::STANDARD as BASE64_STANDARD};
+use image::{GenericImageView, ImageFormat};
 use module_match3d::{
     MATCH3D_MESSAGE_ID_PREFIX, MATCH3D_PROFILE_ID_PREFIX, MATCH3D_RUN_ID_PREFIX,
     MATCH3D_SESSION_ID_PREFIX,
 };
+use platform_llm::{LlmMessage, LlmTextRequest};
+use platform_oss::{LegacyAssetPrefix, OssObjectAccess, OssPutObjectRequest};
 use serde::{Deserialize, Serialize};
 use serde_json::{Value, json};
 use shared_contracts::{
+    hyper3d as hyper3d_contract,
     match3d_agent::{
         CreateMatch3DAgentSessionRequest, ExecuteMatch3DAgentActionRequest,
         Match3DAgentActionResponse, Match3DAgentMessageResponse, Match3DAgentSessionResponse,
         Match3DAgentSessionSnapshotResponse, Match3DAnchorItemResponse, Match3DAnchorPackResponse,
-        Match3DCreatorConfigResponse, Match3DResultDraftResponse, SendMatch3DAgentMessageRequest,
+        Match3DCreatorConfigResponse,
+        Match3DGeneratedItemAssetResponse as Match3DAgentGeneratedItemAssetResponse,
+        Match3DResultDraftResponse, SendMatch3DAgentMessageRequest,
     },
     match3d_runtime::{
         ClickMatch3DItemRequest, Match3DClickConfirmationResponse, Match3DClickResponse,
@@ -51,6 +59,12 @@ use crate::{
     api_response::json_success_body,
     auth::AuthenticatedAccessToken,
     http_error::AppError,
+    hyper3d_generation::{query_downloads, query_task_status, submit_image_to_model},
+    openai_image_generation::{
+        DownloadedOpenAiImage, build_openai_image_http_client, create_openai_image_generation,
+        require_openai_image_settings,
+    },
+    platform_errors::{map_llm_error, map_oss_error},
     request_context::RequestContext,
     state::AppState,
     work_play_tracking::{WorkPlayTrackingDraft, record_work_play_start_after_success},
@@ -62,6 +76,12 @@ const MATCH3D_RUNTIME_PROVIDER: &str = "match3d-runtime";
 const MATCH3D_DEFAULT_THEME: &str = "缤纷玩具";
 const MATCH3D_DEFAULT_CLEAR_COUNT: u32 = 12;
 const MATCH3D_DEFAULT_DIFFICULTY: u32 = 4;
+const MATCH3D_GENERATED_ITEM_COUNT: usize = 3;
+const MATCH3D_GENERATED_CLEAR_COUNT: u32 = 3;
+const MATCH3D_MATERIAL_GRID_SIZE: u32 = 2;
+const MATCH3D_RODIN_STATUS_MAX_ATTEMPTS: usize = 36;
+const MATCH3D_RODIN_STATUS_POLL_INTERVAL_MS: u64 = 5_000;
+const MATCH3D_RODIN_MAX_MODEL_BYTES: usize = 120 * 1024 * 1024;
 const MATCH3D_QUESTION_THEME: &str = "你想创作什么题材";
 const MATCH3D_QUESTION_CLEAR_COUNT: &str = "需要消除多少次才能通关";
 const MATCH3D_QUESTION_DIFFICULTY: &str = "如果难度是从1-10，你要创作的关卡是难度几";
@@ -73,6 +93,70 @@ struct Match3DConfigJson {
     reference_image_src: Option<String>,
     clear_count: u32,
     difficulty: u32,
+    #[serde(default)]
+    asset_style_id: Option<String>,
+    #[serde(default)]
+    asset_style_label: Option<String>,
+    #[serde(default)]
+    asset_style_prompt: Option<String>,
+}
+
+#[derive(Clone, Debug)]
+struct Match3DGeneratedItemAsset {
+    item_id: String,
+    item_name: String,
+    image_src: Option<String>,
+    image_object_key: Option<String>,
+    model_src: Option<String>,
+    model_object_key: Option<String>,
+    model_file_name: Option<String>,
+    task_uuid: Option<String>,
+    subscription_key: Option<String>,
+    status: String,
+    error: Option<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+struct Match3DGeneratedItemAssetJson {
+    item_id: String,
+    item_name: String,
+    #[serde(default)]
+    image_src: Option<String>,
+    #[serde(default)]
+    image_object_key: Option<String>,
+    #[serde(default)]
+    model_src: Option<String>,
+    #[serde(default)]
+    model_object_key: Option<String>,
+    #[serde(default)]
+    model_file_name: Option<String>,
+    #[serde(default)]
+    task_uuid: Option<String>,
+    #[serde(default)]
+    subscription_key: Option<String>,
+    status: String,
+    #[serde(default)]
+    error: Option<String>,
+}
+
+#[derive(Clone, Debug)]
+struct Match3DAssetUpload {
+    src: String,
+    object_key: String,
+}
+
+struct Match3DRodinModelAsset {
+    task_uuid: String,
+    subscription_key: String,
+    model_file_name: String,
+    upload: Match3DAssetUpload,
+}
+
+struct Match3DDownloadedModel {
+    bytes: Vec<u8>,
+    file_name: String,
+    content_type: String,
 }
 
 #[derive(Clone, Debug, Deserialize)]
@@ -265,7 +349,7 @@ pub async fn execute_match3d_agent_action(
         ));
     }
 
-    let session = compile_match3d_draft_for_session(
+    let (session, generated_item_assets) = compile_match3d_draft_for_session(
         &state,
         &request_context,
         &authenticated,
@@ -280,7 +364,10 @@ pub async fn execute_match3d_agent_action(
     Ok(json_success_body(
         Some(&request_context),
         Match3DAgentActionResponse {
-            session: map_match3d_agent_session_response(session),
+            session: map_match3d_agent_session_response_with_assets(
+                session,
+                &generated_item_assets,
+            ),
         },
     ))
 }
@@ -307,7 +394,7 @@ pub async fn compile_match3d_agent_draft(
         "sessionId",
     )?;
 
-    let session = compile_match3d_draft_for_session(
+    let (session, generated_item_assets) = compile_match3d_draft_for_session(
         &state,
         &request_context,
         &authenticated,
@@ -322,7 +409,10 @@ pub async fn compile_match3d_agent_draft(
     Ok(json_success_body(
         Some(&request_context),
         Match3DAgentActionResponse {
-            session: map_match3d_agent_session_response(session),
+            session: map_match3d_agent_session_response_with_assets(
+                session,
+                &generated_item_assets,
+            ),
         },
     ))
 }
@@ -876,7 +966,7 @@ async fn compile_match3d_draft_for_session(
     summary: Option<String>,
     tags: Option<Vec<String>>,
     cover_image_src: Option<String>,
-) -> Result<Match3DAgentSessionRecord, Response> {
+) -> Result<(Match3DAgentSessionRecord, Vec<Match3DGeneratedItemAsset>), Response> {
     let owner_user_id = authenticated.claims().user_id().to_string();
     let session = state
         .spacetime_client()
@@ -889,7 +979,14 @@ async fn compile_match3d_draft_for_session(
                 map_match3d_client_error(error),
             )
         })?;
-    if session.current_turn < 3 || session.progress_percent < 100 {
+    let mut config = resolve_config_or_default(session.config.as_ref());
+    config.clear_count = MATCH3D_GENERATED_CLEAR_COUNT;
+    // 中文注释：抓大鹅入口已支持表单直创；完整表单创建的 session
+    // 不需要再伪造三轮聊天，只要配置字段完整即可进入草稿编译。
+    let has_complete_form_config = !config.theme_text.trim().is_empty()
+        && config.clear_count > 0
+        && (1..=10).contains(&config.difficulty);
+    if !has_complete_form_config && (session.current_turn < 3 || session.progress_percent < 100) {
         return Err(match3d_bad_request(
             request_context,
             MATCH3D_AGENT_PROVIDER,
@@ -897,17 +994,27 @@ async fn compile_match3d_draft_for_session(
         ));
     }
 
-    let config = resolve_config_or_default(session.config.as_ref());
     let tags_json = tags
         .as_ref()
         .map(|tags| serde_json::to_string(&normalize_tags(tags.clone())).unwrap_or_default());
 
-    state
+    let profile_id = build_prefixed_uuid_id(MATCH3D_PROFILE_ID_PREFIX);
+    let generated_item_assets = generate_match3d_item_assets(
+        state,
+        request_context,
+        owner_user_id.as_str(),
+        session.session_id.as_str(),
+        profile_id.as_str(),
+        &config,
+    )
+    .await?;
+
+    let session = state
         .spacetime_client()
         .compile_match3d_draft(Match3DCompileDraftRecordInput {
             session_id,
             owner_user_id,
-            profile_id: build_prefixed_uuid_id(MATCH3D_PROFILE_ID_PREFIX),
+            profile_id,
             author_display_name: resolve_author_display_name(state, authenticated),
             game_name: game_name.or_else(|| Some(format!("{}抓大鹅", config.theme_text))),
             summary_text: summary,
@@ -915,6 +1022,9 @@ async fn compile_match3d_draft_for_session(
             cover_image_src,
             cover_asset_id: None,
             compiled_at_micros: current_utc_micros(),
+            generated_item_assets_json: serialize_match3d_generated_item_assets(
+                &generated_item_assets,
+            ),
         })
         .await
         .map_err(|error| {
@@ -923,7 +1033,9 @@ async fn compile_match3d_draft_for_session(
                 MATCH3D_AGENT_PROVIDER,
                 map_match3d_client_error(error),
             )
-        })
+        })?;
+
+    Ok((session, generated_item_assets))
 }
 
 fn map_match3d_agent_session_response(
@@ -952,6 +1064,21 @@ fn map_match3d_agent_session_response(
     }
 }
 
+fn map_match3d_agent_session_response_with_assets(
+    session: Match3DAgentSessionRecord,
+    generated_item_assets: &[Match3DGeneratedItemAsset],
+) -> Match3DAgentSessionSnapshotResponse {
+    let mut response = map_match3d_agent_session_response(session);
+    if let Some(draft) = response.draft.as_mut() {
+        draft.generated_item_assets = generated_item_assets
+            .iter()
+            .cloned()
+            .map(map_match3d_generated_item_asset_for_agent)
+            .collect();
+    }
+    response
+}
+
 fn map_match3d_anchor_pack_response_for_turn(
     anchor: Match3DAnchorPackRecord,
     current_turn: u32,
@@ -1015,6 +1142,9 @@ fn map_match3d_config_response(config: Match3DCreatorConfigRecord) -> Match3DCre
         reference_image_src: config.reference_image_src,
         clear_count: config.clear_count,
         difficulty: config.difficulty,
+        asset_style_id: config.asset_style_id,
+        asset_style_label: config.asset_style_label,
+        asset_style_prompt: config.asset_style_prompt,
     }
 }
 
@@ -1033,6 +1163,43 @@ fn map_match3d_draft_response(draft: Match3DResultDraftRecord) -> Match3DResultD
         total_item_count: draft.total_item_count,
         publish_ready: draft.publish_ready,
         blockers: draft.blockers,
+        generated_item_assets: Vec::new(),
+    }
+}
+
+fn map_match3d_generated_item_asset_for_agent(
+    asset: Match3DGeneratedItemAsset,
+) -> Match3DAgentGeneratedItemAssetResponse {
+    Match3DAgentGeneratedItemAssetResponse {
+        item_id: asset.item_id,
+        item_name: asset.item_name,
+        image_src: asset.image_src,
+        image_object_key: asset.image_object_key,
+        model_src: asset.model_src,
+        model_object_key: asset.model_object_key,
+        model_file_name: asset.model_file_name,
+        task_uuid: asset.task_uuid,
+        subscription_key: asset.subscription_key,
+        status: asset.status,
+        error: asset.error,
+    }
+}
+
+fn map_match3d_generated_item_asset_for_work(
+    asset: Match3DGeneratedItemAssetJson,
+) -> shared_contracts::match3d_works::Match3DGeneratedItemAssetResponse {
+    shared_contracts::match3d_works::Match3DGeneratedItemAssetResponse {
+        item_id: asset.item_id,
+        item_name: asset.item_name,
+        image_src: asset.image_src,
+        image_object_key: asset.image_object_key,
+        model_src: asset.model_src,
+        model_object_key: asset.model_object_key,
+        model_file_name: asset.model_file_name,
+        task_uuid: asset.task_uuid,
+        subscription_key: asset.subscription_key,
+        status: asset.status,
+        error: asset.error,
     }
 }
 
@@ -1047,6 +1214,11 @@ fn map_match3d_message_response(message: Match3DAgentMessageRecord) -> Match3DAg
 }
 
 fn map_match3d_work_summary_response(item: Match3DWorkProfileRecord) -> Match3DWorkSummaryResponse {
+    let generated_item_assets =
+        parse_match3d_generated_item_assets(item.generated_item_assets_json.as_deref())
+            .into_iter()
+            .map(map_match3d_generated_item_asset_for_work)
+            .collect();
     Match3DWorkSummaryResponse {
         work_id: item.work_id,
         profile_id: item.profile_id,
@@ -1065,6 +1237,7 @@ fn map_match3d_work_summary_response(item: Match3DWorkProfileRecord) -> Match3DW
         updated_at: item.updated_at,
         published_at: item.published_at,
         publish_ready: item.publish_ready,
+        generated_item_assets,
     }
 }
 
@@ -1156,14 +1329,14 @@ fn build_config_from_create_request(
             .unwrap_or(MATCH3D_DEFAULT_THEME)
             .to_string(),
         reference_image_src: payload.reference_image_src.clone(),
-        clear_count: payload
-            .clear_count
-            .unwrap_or(MATCH3D_DEFAULT_CLEAR_COUNT)
-            .max(1),
+        clear_count: MATCH3D_GENERATED_CLEAR_COUNT,
         difficulty: payload
             .difficulty
             .unwrap_or(MATCH3D_DEFAULT_DIFFICULTY)
             .clamp(1, 10),
+        asset_style_id: normalize_optional_text(payload.asset_style_id.as_deref()),
+        asset_style_label: normalize_optional_text(payload.asset_style_label.as_deref()),
+        asset_style_prompt: normalize_optional_text(payload.asset_style_prompt.as_deref()),
     }
 }
 
@@ -1186,6 +1359,9 @@ fn build_config_from_message(
     let mut theme_text = current.theme_text;
     let mut clear_count = current.clear_count.max(1);
     let mut difficulty = current.difficulty.clamp(1, 10);
+    let asset_style_id = current.asset_style_id;
+    let asset_style_label = current.asset_style_label;
+    let asset_style_prompt = current.asset_style_prompt;
 
     match session.current_turn {
         0 => {
@@ -1219,6 +1395,9 @@ fn build_config_from_message(
         reference_image_src,
         clear_count,
         difficulty,
+        asset_style_id,
+        asset_style_label,
+        asset_style_prompt,
     }
 }
 
@@ -1229,15 +1408,28 @@ fn resolve_config_or_default(config: Option<&Match3DCreatorConfigRecord>) -> Mat
             reference_image_src: config.reference_image_src.clone(),
             clear_count: config.clear_count.max(1),
             difficulty: config.difficulty.clamp(1, 10),
+            asset_style_id: config.asset_style_id.clone(),
+            asset_style_label: config.asset_style_label.clone(),
+            asset_style_prompt: config.asset_style_prompt.clone(),
         })
         .unwrap_or_else(|| Match3DConfigJson {
             theme_text: MATCH3D_DEFAULT_THEME.to_string(),
             reference_image_src: None,
             clear_count: MATCH3D_DEFAULT_CLEAR_COUNT,
             difficulty: MATCH3D_DEFAULT_DIFFICULTY,
+            asset_style_id: None,
+            asset_style_label: None,
+            asset_style_prompt: None,
         })
 }
 
+fn normalize_optional_text(value: Option<&str>) -> Option<String> {
+    value
+        .map(str::trim)
+        .filter(|value| !value.is_empty())
+        .map(str::to_string)
+}
+
 fn serialize_match3d_config(config: &Match3DConfigJson) -> Option<String> {
     serde_json::to_string(config).ok()
 }
@@ -1349,6 +1541,44 @@ fn normalize_tags(tags: Vec<String>) -> Vec<String> {
     result
 }
 
+fn serialize_match3d_generated_item_assets(assets: &[Match3DGeneratedItemAsset]) -> Option<String> {
+    if assets.is_empty() {
+        return None;
+    }
+    let items = assets
+        .iter()
+        .cloned()
+        .map(Match3DGeneratedItemAssetJson::from)
+        .collect::<Vec<_>>();
+    serde_json::to_string(&items).ok()
+}
+
+fn parse_match3d_generated_item_assets(value: Option<&str>) -> Vec<Match3DGeneratedItemAssetJson> {
+    value
+        .map(str::trim)
+        .filter(|value| !value.is_empty())
+        .and_then(|value| serde_json::from_str::<Vec<Match3DGeneratedItemAssetJson>>(value).ok())
+        .unwrap_or_default()
+}
+
+impl From<Match3DGeneratedItemAsset> for Match3DGeneratedItemAssetJson {
+    fn from(asset: Match3DGeneratedItemAsset) -> Self {
+        Self {
+            item_id: asset.item_id,
+            item_name: asset.item_name,
+            image_src: asset.image_src,
+            image_object_key: asset.image_object_key,
+            model_src: asset.model_src,
+            model_object_key: asset.model_object_key,
+            model_file_name: asset.model_file_name,
+            task_uuid: asset.task_uuid,
+            subscription_key: asset.subscription_key,
+            status: asset.status,
+            error: asset.error,
+        }
+    }
+}
+
 fn resolve_author_display_name(
     state: &AppState,
     authenticated: &AuthenticatedAccessToken,
@@ -1363,6 +1593,376 @@ fn resolve_author_display_name(
         .unwrap_or_else(|| "玩家".to_string())
 }
 
+async fn generate_match3d_item_assets(
+    state: &AppState,
+    request_context: &RequestContext,
+    owner_user_id: &str,
+    session_id: &str,
+    profile_id: &str,
+    config: &Match3DConfigJson,
+) -> Result<Vec<Match3DGeneratedItemAsset>, Response> {
+    // 中文注释：外部模型、下载和 OSS 写入都留在 api-server，SpacetimeDB reducer 只保存确定性草稿。
+    let item_names = generate_match3d_item_names(state, config)
+        .await
+        .map_err(|error| match3d_error_response(request_context, MATCH3D_AGENT_PROVIDER, error))?;
+    let material_sheet = generate_match3d_material_sheet(state, config, &item_names)
+        .await
+        .map_err(|error| match3d_error_response(request_context, MATCH3D_AGENT_PROVIDER, error))?;
+    let generated_at_micros = current_utc_micros();
+    let _sheet_upload = persist_match3d_generated_bytes(
+        state,
+        owner_user_id,
+        session_id,
+        profile_id,
+        &["material-sheet", material_sheet.task_id.as_str()],
+        "sheet.png",
+        "image/png",
+        material_sheet.image.bytes.clone(),
+        "match3d_material_sheet",
+        Some(material_sheet.task_id.as_str()),
+        generated_at_micros,
+    )
+    .await
+    .map_err(|error| match3d_error_response(request_context, MATCH3D_AGENT_PROVIDER, error))?;
+    let item_images = slice_match3d_material_sheet(&material_sheet.image, &item_names)
+        .map_err(|error| match3d_error_response(request_context, MATCH3D_AGENT_PROVIDER, error))?;
+
+    let mut item_assets = Vec::with_capacity(item_images.len());
+    for (index, item_image) in item_images.into_iter().enumerate() {
+        let item_name = item_names
+            .get(index)
+            .cloned()
+            .unwrap_or_else(|| format!("物品{}", index + 1));
+        let item_id = format!("match3d-item-{}", index + 1);
+        let item_slug = format!(
+            "{item_id}-{}",
+            sanitize_match3d_asset_segment(&item_name, "item")
+        );
+        let image_bytes = item_image.bytes;
+        let image_upload = persist_match3d_generated_bytes(
+            state,
+            owner_user_id,
+            session_id,
+            profile_id,
+            &["items", item_slug.as_str(), "image"],
+            "image.png",
+            "image/png",
+            image_bytes.clone(),
+            "match3d_item_image",
+            Some(material_sheet.task_id.as_str()),
+            generated_at_micros.saturating_add(index as i64 + 1),
+        )
+        .await
+        .map_err(|error| match3d_error_response(request_context, MATCH3D_AGENT_PROVIDER, error))?;
+        let model_asset = generate_match3d_rodin_model_asset(
+            state,
+            owner_user_id,
+            session_id,
+            profile_id,
+            &item_slug,
+            &item_name,
+            config,
+            image_bytes,
+            generated_at_micros.saturating_add(100 + index as i64),
+        )
+        .await
+        .map_err(|error| match3d_error_response(request_context, MATCH3D_AGENT_PROVIDER, error))?;
+        item_assets.push(Match3DGeneratedItemAsset {
+            item_id,
+            item_name,
+            image_src: Some(image_upload.src),
+            image_object_key: Some(image_upload.object_key),
+            model_src: Some(model_asset.upload.src),
+            model_object_key: Some(model_asset.upload.object_key),
+            model_file_name: Some(model_asset.model_file_name),
+            task_uuid: Some(model_asset.task_uuid),
+            subscription_key: Some(model_asset.subscription_key),
+            status: "model_ready".to_string(),
+            error: None,
+        });
+    }
+
+    // 中文注释：草稿阶段必须同时产出 GLB 模型，结果页直接加载模型预览。
+    Ok(item_assets)
+}
+
+struct Match3DMaterialSheet {
+    task_id: String,
+    image: DownloadedOpenAiImage,
+}
+
+struct Match3DSlicedItemImage {
+    bytes: Vec<u8>,
+}
+
+async fn generate_match3d_item_names(
+    state: &AppState,
+    config: &Match3DConfigJson,
+) -> Result<Vec<String>, AppError> {
+    let Some(llm_client) = state
+        .creative_agent_gpt5_client()
+        .or_else(|| state.llm_client())
+    else {
+        return Ok(fallback_match3d_item_names(config.theme_text.as_str()));
+    };
+    let system_prompt = "你是抓大鹅游戏的物品命名编辑，只返回 JSON 字符串数组。";
+    let user_prompt = format!(
+        "题材：{}\n请生成 {} 个适合抓大鹅点击消除玩法的短中文物品名称。要求：只返回 JSON 数组，每项 2 到 6 个汉字，不要解释。",
+        config.theme_text, MATCH3D_GENERATED_ITEM_COUNT
+    );
+    let response = llm_client
+        .request_text(
+            LlmTextRequest::new(vec![
+                LlmMessage::system(system_prompt),
+                LlmMessage::user(user_prompt),
+            ])
+            .with_responses_api(),
+        )
+        .await
+        .map_err(map_llm_error)?;
+    let parsed = parse_match3d_item_names(response.content.as_str());
+    if parsed.len() == MATCH3D_GENERATED_ITEM_COUNT {
+        return Ok(parsed);
+    }
+
+    Ok(fallback_match3d_item_names(config.theme_text.as_str()))
+}
+
+fn parse_match3d_item_names(raw: &str) -> Vec<String> {
+    let raw = raw.trim();
+    let parsed_array = serde_json::from_str::<Vec<String>>(raw)
+        .ok()
+        .or_else(|| {
+            let start = raw.find('[')?;
+            let end = raw.rfind(']')?;
+            serde_json::from_str::<Vec<String>>(&raw[start..=end]).ok()
+        })
+        .unwrap_or_default();
+
+    let mut names = Vec::new();
+    for name in parsed_array {
+        let normalized = normalize_match3d_item_name(name.as_str());
+        if !normalized.is_empty() && !names.contains(&normalized) {
+            names.push(normalized);
+        }
+        if names.len() >= MATCH3D_GENERATED_ITEM_COUNT {
+            break;
+        }
+    }
+    names
+}
+
+fn normalize_match3d_item_name(raw: &str) -> String {
+    raw.trim()
+        .trim_matches(['"', '\'', '“', '”', '。', '，', ',', '、'])
+        .chars()
+        .filter(|character| !character.is_control())
+        .take(12)
+        .collect::<String>()
+        .trim()
+        .to_string()
+}
+
+fn fallback_match3d_item_names(theme_text: &str) -> Vec<String> {
+    let theme = theme_text.trim();
+    let normalized_theme = if theme.is_empty() { "主题" } else { theme };
+    ["小物件", "徽章", "摆件"]
+        .into_iter()
+        .map(|suffix| format!("{normalized_theme}{suffix}"))
+        .take(MATCH3D_GENERATED_ITEM_COUNT)
+        .collect()
+}
+
+async fn generate_match3d_material_sheet(
+    state: &AppState,
+    config: &Match3DConfigJson,
+    item_names: &[String],
+) -> Result<Match3DMaterialSheet, AppError> {
+    let settings = require_openai_image_settings(state)?;
+    let http_client = build_openai_image_http_client(&settings)?;
+    let prompt = build_match3d_material_sheet_prompt(config, item_names);
+    let generated = create_openai_image_generation(
+        &http_client,
+        &settings,
+        prompt.as_str(),
+        Some("文字、水印、UI、边框、网格线、标签、人物手部、复杂背景"),
+        "1:1",
+        1,
+        &[],
+        "抓大鹅素材图生成失败",
+    )
+    .await?;
+    let image = generated.images.into_iter().next().ok_or_else(|| {
+        AppError::from_status(StatusCode::BAD_GATEWAY).with_details(json!({
+            "provider": "vector-engine",
+            "message": "抓大鹅素材图生成失败：未返回图片",
+        }))
+    })?;
+
+    Ok(Match3DMaterialSheet {
+        task_id: generated.task_id,
+        image,
+    })
+}
+
+fn build_match3d_material_sheet_prompt(
+    config: &Match3DConfigJson,
+    item_names: &[String],
+) -> String {
+    let asset_style_prompt = resolve_match3d_asset_style_prompt(config);
+    let style_clause = asset_style_prompt
+        .as_ref()
+        .map(|prompt| format!("整体画风遵循：{prompt}。"))
+        .unwrap_or_default();
+    format!(
+        "生成一张1:1图片。生成{grid}*{grid}网格素材图，画面是{theme}题材的抓大鹅游戏素材。{style_clause}只绘制这些物品：{items}。每个格子一个独立居中的完整物体，统一柔和光照，正交或轻微俯视角，清晰轮廓，适合后续切割成图生3D模型参考。不要出现文字、水印、UI、边框、网格线、标签。",
+        grid = MATCH3D_MATERIAL_GRID_SIZE,
+        theme = config.theme_text,
+        style_clause = style_clause,
+        items = item_names.join("、"),
+    )
+}
+
+fn resolve_match3d_asset_style_prompt(config: &Match3DConfigJson) -> Option<String> {
+    config
+        .asset_style_prompt
+        .as_deref()
+        .or(config.asset_style_label.as_deref())
+        .map(str::trim)
+        .filter(|value| !value.is_empty())
+        .map(str::to_string)
+}
+
+fn slice_match3d_material_sheet(
+    image: &DownloadedOpenAiImage,
+    item_names: &[String],
+) -> Result<Vec<Match3DSlicedItemImage>, AppError> {
+    // 中文注释：当前 3 件物品使用 2x2 素材图，按阅读顺序取前三格，第四格作为生成冗余。
+    let source = image::load_from_memory(image.bytes.as_slice()).map_err(|error| {
+        AppError::from_status(StatusCode::BAD_GATEWAY).with_details(json!({
+            "provider": "match3d-assets",
+            "message": format!("抓大鹅素材图解码失败：{error}"),
+        }))
+    })?;
+    let (width, height) = source.dimensions();
+    let cell_width = width / MATCH3D_MATERIAL_GRID_SIZE;
+    let cell_height = height / MATCH3D_MATERIAL_GRID_SIZE;
+    if cell_width == 0 || cell_height == 0 {
+        return Err(
+            AppError::from_status(StatusCode::BAD_GATEWAY).with_details(json!({
+                "provider": "match3d-assets",
+                "message": "抓大鹅素材图尺寸过小，无法切割",
+            })),
+        );
+    }
+
+    let mut slices = Vec::with_capacity(item_names.len());
+    for index in 0..item_names.len().min(MATCH3D_GENERATED_ITEM_COUNT) {
+        let col = (index as u32) % MATCH3D_MATERIAL_GRID_SIZE;
+        let row = (index as u32) / MATCH3D_MATERIAL_GRID_SIZE;
+        let cropped = source.crop_imm(col * cell_width, row * cell_height, cell_width, cell_height);
+        let mut cursor = std::io::Cursor::new(Vec::new());
+        cropped
+            .write_to(&mut cursor, ImageFormat::Png)
+            .map_err(|error| {
+                AppError::from_status(StatusCode::BAD_GATEWAY).with_details(json!({
+                    "provider": "match3d-assets",
+                    "message": format!("抓大鹅素材图切割失败：{error}"),
+                }))
+            })?;
+        slices.push(Match3DSlicedItemImage {
+            bytes: cursor.into_inner(),
+        });
+    }
+
+    Ok(slices)
+}
+
+#[allow(clippy::too_many_arguments)]
+async fn persist_match3d_generated_bytes(
+    state: &AppState,
+    owner_user_id: &str,
+    session_id: &str,
+    profile_id: &str,
+    path_segments: &[&str],
+    file_name: &str,
+    content_type: &str,
+    bytes: Vec<u8>,
+    asset_kind: &str,
+    source_job_id: Option<&str>,
+    generated_at_micros: i64,
+) -> Result<Match3DAssetUpload, AppError> {
+    let oss_client = state.oss_client().ok_or_else(|| {
+        AppError::from_status(StatusCode::SERVICE_UNAVAILABLE).with_details(json!({
+            "provider": "aliyun-oss",
+            "reason": "OSS 未完成环境变量配置",
+        }))
+    })?;
+    let mut metadata = BTreeMap::new();
+    metadata.insert("x-oss-meta-asset-kind".to_string(), asset_kind.to_string());
+    metadata.insert(
+        "x-oss-meta-owner-user-id".to_string(),
+        owner_user_id.to_string(),
+    );
+    metadata.insert("x-oss-meta-profile-id".to_string(), profile_id.to_string());
+    if let Some(source_job_id) = source_job_id.filter(|value| !value.trim().is_empty()) {
+        metadata.insert(
+            "x-oss-meta-source-job-id".to_string(),
+            source_job_id.to_string(),
+        );
+    }
+
+    let put_result = oss_client
+        .put_object(
+            &reqwest::Client::new(),
+            OssPutObjectRequest {
+                prefix: LegacyAssetPrefix::Match3DAssets,
+                path_segments: std::iter::once(session_id)
+                    .chain(std::iter::once(profile_id))
+                    .chain(path_segments.iter().copied())
+                    .map(|segment| sanitize_match3d_asset_segment(segment, "asset"))
+                    .collect(),
+                file_name: file_name.to_string(),
+                content_type: Some(content_type.to_string()),
+                access: OssObjectAccess::Private,
+                metadata,
+                body: bytes,
+            },
+        )
+        .await
+        .map_err(|error| map_oss_error(error, "aliyun-oss"))?;
+
+    let _ = generated_at_micros;
+    Ok(Match3DAssetUpload {
+        src: put_result.legacy_public_path,
+        object_key: put_result.object_key,
+    })
+}
+
+fn sanitize_match3d_asset_segment(raw: &str, fallback: &str) -> String {
+    let normalized = raw
+        .trim()
+        .chars()
+        .map(|ch| {
+            if ch.is_ascii_alphanumeric() || ch == '-' || ch == '_' {
+                ch.to_ascii_lowercase()
+            } else {
+                '-'
+            }
+        })
+        .collect::<String>();
+    let collapsed = normalized
+        .split('-')
+        .filter(|part| !part.is_empty())
+        .collect::<Vec<_>>()
+        .join("-");
+    if collapsed.is_empty() {
+        fallback.to_string()
+    } else {
+        collapsed.chars().take(64).collect()
+    }
+}
+
 fn normalize_match3d_run_status(value: &str) -> &str {
     match value {
         "Running" => "running",
@@ -1529,6 +2129,9 @@ mod tests {
             reference_image_src: None,
             clear_count,
             difficulty,
+            asset_style_id: None,
+            asset_style_label: None,
+            asset_style_prompt: None,
         }
     }
 
@@ -1595,4 +2198,66 @@ mod tests {
         assert_eq!(response.difficulty.value, "");
         assert_eq!(response.difficulty.status, "missing");
     }
+
+    #[test]
+    fn match3d_item_image_path_segments_stay_unique_for_chinese_names() {
+        let item_names = ["草莓", "苹果", "香蕉"];
+        let slugs = item_names
+            .iter()
+            .enumerate()
+            .map(|(index, item_name)| {
+                let item_id = format!("match3d-item-{}", index + 1);
+                format!(
+                    "{item_id}-{}",
+                    sanitize_match3d_asset_segment(item_name, "item")
+                )
+            })
+            .collect::<Vec<_>>();
+
+        assert_eq!(
+            slugs,
+            vec![
+                "match3d-item-1-item",
+                "match3d-item-2-item",
+                "match3d-item-3-item",
+            ]
+        );
+    }
+
+    #[test]
+    fn match3d_work_summary_maps_persisted_generated_item_assets() {
+        let response = map_match3d_work_summary_response(Match3DWorkProfileRecord {
+            work_id: "match3d-profile-1".to_string(),
+            profile_id: "match3d-profile-1".to_string(),
+            owner_user_id: "user-1".to_string(),
+            source_session_id: Some("match3d-session-1".to_string()),
+            author_display_name: "玩家".to_string(),
+            game_name: "水果抓大鹅".to_string(),
+            theme_text: "水果".to_string(),
+            summary: "水果主题".to_string(),
+            tags: vec!["水果".to_string()],
+            cover_image_src: None,
+            cover_asset_id: None,
+            reference_image_src: None,
+            clear_count: 3,
+            difficulty: 3,
+            publication_status: "draft".to_string(),
+            play_count: 0,
+            updated_at: "2026-05-10T00:00:00.000Z".to_string(),
+            published_at: None,
+            publish_ready: false,
+            generated_item_assets_json: Some(
+                r#"[{"itemId":"match3d-item-1","itemName":"草莓","imageSrc":"/generated-match3d-assets/session/profile/items/match3d-item-1-item/image.png","imageObjectKey":"generated-match3d-assets/session/profile/items/match3d-item-1-item/image.png","status":"image_ready"}]"#
+                    .to_string(),
+            ),
+        });
+
+        assert_eq!(response.generated_item_assets.len(), 1);
+        assert_eq!(response.generated_item_assets[0].item_name, "草莓");
+        assert_eq!(response.generated_item_assets[0].status, "image_ready");
+        assert_eq!(
+            response.generated_item_assets[0].image_src.as_deref(),
+            Some("/generated-match3d-assets/session/profile/items/match3d-item-1-item/image.png")
+        );
+    }
 }
diff --git a/server-rs/crates/api-server/src/puzzle.rs b/server-rs/crates/api-server/src/puzzle.rs
index 0bde9d9f..0be38519 100644
--- a/server-rs/crates/api-server/src/puzzle.rs
+++ b/server-rs/crates/api-server/src/puzzle.rs
@@ -116,6 +116,8 @@ const PUZZLE_GENERATED_IMAGE_SIZE: &str = "1024*1024";
 const PUZZLE_VECTOR_ENGINE_GENERATED_IMAGE_SIZE: &str = "1024x1024";
 const VECTOR_ENGINE_PROVIDER: &str = "vector-engine";
 const PUZZLE_LEVEL_NAME_VISION_IMAGE_MAX_SIDE: u32 = 768;
+const PUZZLE_REFERENCE_IMAGE_MAX_BYTES: usize = 8 * 1024 * 1024;
+const PUZZLE_VECTOR_ENGINE_IMAGE_EDIT_MODEL: &str = "gpt-image-2";
 
 pub async fn create_puzzle_agent_session(
     State(state): State<AppState>,
@@ -197,6 +199,7 @@ pub async fn generate_puzzle_onboarding_work(
         level_name.as_str(),
         prompt_text.as_str(),
         None,
+        false,
         Some(PUZZLE_IMAGE_MODEL_GPT_IMAGE_2),
         1,
         0,
@@ -886,6 +889,7 @@ pub async fn execute_puzzle_agent_action(
                         &target_level.level_name,
                         &prompt,
                         payload.reference_image_src.as_deref(),
+                        payload.ai_redraw.unwrap_or(true),
                         payload.image_model.as_deref(),
                         candidate_count,
                         candidate_start_index,
@@ -2349,6 +2353,7 @@ fn map_puzzle_leaderboard_entry_response(
         rank: entry.rank,
         nickname: entry.nickname,
         elapsed_ms: entry.elapsed_ms,
+        visible_tags: entry.visible_tags,
         is_current_player: entry.is_current_player,
     }
 }
@@ -2809,6 +2814,7 @@ fn normalize_puzzle_levels_json_for_module(value: Option<&str>) -> Result<Option
                 "level_id": level.level_id,
                 "level_name": level.level_name,
                 "picture_description": level.picture_description,
+                "picture_reference": level.picture_reference,
                 "candidates": level
                     .candidates
                     .iter()
@@ -3098,8 +3104,9 @@ fn build_puzzle_levels_with_primary_update(
         .or_else(|| (!levels.is_empty()).then_some(0))
     {
         levels[index].level_name = target_level.level_name.clone();
-        if let Some(picture_reference) =
-            picture_reference.map(str::trim).filter(|value| !value.is_empty())
+        if let Some(picture_reference) = picture_reference
+            .map(str::trim)
+            .filter(|value| !value.is_empty())
         {
             levels[index].picture_reference = Some(picture_reference.to_string());
         }
@@ -3145,6 +3152,7 @@ async fn compile_puzzle_draft_with_initial_cover(
         &target_level.level_name,
         &image_prompt,
         reference_image_src,
+        true,
         image_model,
         1,
         target_level.candidates.len(),
@@ -4059,6 +4067,7 @@ async fn generate_puzzle_image_candidates(
     level_name: &str,
     prompt: &str,
     reference_image_src: Option<&str>,
+    use_reference_image_edit: bool,
     image_model: Option<&str>,
     candidate_count: u32,
     candidate_start_index: usize,
@@ -4066,12 +4075,14 @@ async fn generate_puzzle_image_candidates(
     let total_started_at = Instant::now();
     let count = candidate_count.clamp(1, 1);
     let resolved_model = resolve_puzzle_image_model(image_model);
-    let actual_prompt = build_puzzle_image_prompt(level_name, prompt);
     let http_client = build_puzzle_image_http_client(state, resolved_model)?;
-    let has_reference_image = reference_image_src
-        .map(str::trim)
-        .map(|value| !value.is_empty())
-        .unwrap_or(false);
+    let has_reference_image = has_puzzle_reference_image(reference_image_src);
+    let should_use_reference_image_edit =
+        should_use_puzzle_reference_image_edit(reference_image_src, use_reference_image_edit);
+    let actual_prompt = build_puzzle_vector_engine_generation_prompt(
+        build_puzzle_image_prompt(level_name, prompt).as_str(),
+        should_use_reference_image_edit,
+    );
     tracing::info!(
         provider = resolved_model.provider_name(),
         image_model = resolved_model.request_model_name(),
@@ -4080,12 +4091,14 @@ async fn generate_puzzle_image_candidates(
         prompt_chars = prompt.chars().count(),
         actual_prompt_chars = actual_prompt.chars().count(),
         has_reference_image,
+        use_reference_image_edit = should_use_reference_image_edit,
         "拼图图片生成请求已准备"
     );
     let reference_image_started_at = Instant::now();
     let reference_image = match reference_image_src
         .map(str::trim)
         .filter(|value| !value.is_empty())
+        .filter(|_| should_use_reference_image_edit)
     {
         Some(source) => {
             let resolved =
@@ -4104,12 +4117,14 @@ async fn generate_puzzle_image_candidates(
         }
         None => None,
     };
-    if !has_reference_image {
+    if !should_use_reference_image_edit {
         tracing::info!(
             provider = resolved_model.provider_name(),
             image_model = resolved_model.request_model_name(),
             session_id,
             level_name,
+            has_reference_image,
+            use_reference_image_edit = should_use_reference_image_edit,
             elapsed_ms = reference_image_started_at.elapsed().as_millis() as u64,
             "拼图参考图解析跳过"
         );
@@ -4118,19 +4133,36 @@ async fn generate_puzzle_image_candidates(
     // 中文注释：拼图作品资产统一按 1:1 正方形生成，前端运行时也按正方形棋盘切块承载。
     let settings = require_puzzle_vector_engine_settings(state)?;
     let vector_engine_started_at = Instant::now();
-    let generated = create_puzzle_vector_engine_image_generation(
-        &http_client,
-        &settings,
-        resolved_model,
-        actual_prompt.as_str(),
-        PUZZLE_DEFAULT_NEGATIVE_PROMPT,
-        PUZZLE_VECTOR_ENGINE_GENERATED_IMAGE_SIZE,
-        count,
-        reference_image
-            .as_ref()
-            .map(|image| image.data_url.as_str()),
-    )
-    .await
+    let generated = if should_use_reference_image_edit {
+        let reference_image = reference_image.as_ref().ok_or_else(|| {
+            AppError::from_status(StatusCode::BAD_REQUEST).with_details(json!({
+                "provider": "puzzle",
+                "field": "referenceImageSrc",
+                "message": "AI 重绘需要提供参考图。",
+            }))
+        })?;
+        create_puzzle_vector_engine_image_edit(
+            &http_client,
+            &settings,
+            actual_prompt.as_str(),
+            PUZZLE_DEFAULT_NEGATIVE_PROMPT,
+            PUZZLE_VECTOR_ENGINE_GENERATED_IMAGE_SIZE,
+            count,
+            reference_image,
+        )
+        .await
+    } else {
+        create_puzzle_vector_engine_image_generation(
+            &http_client,
+            &settings,
+            resolved_model,
+            actual_prompt.as_str(),
+            PUZZLE_DEFAULT_NEGATIVE_PROMPT,
+            PUZZLE_VECTOR_ENGINE_GENERATED_IMAGE_SIZE,
+            count,
+        )
+        .await
+    }
     .map_err(map_puzzle_generation_endpoint_error)?;
     tracing::info!(
         provider = resolved_model.provider_name(),
@@ -4219,14 +4251,13 @@ mod tests {
             PUZZLE_DEFAULT_NEGATIVE_PROMPT,
             PUZZLE_VECTOR_ENGINE_GENERATED_IMAGE_SIZE,
             4,
-            Some("data:image/png;base64,abcd"),
         );
 
         assert_eq!(body["model"], VECTOR_ENGINE_GPT_IMAGE_2_MODEL);
         assert_eq!(body["size"], PUZZLE_VECTOR_ENGINE_GENERATED_IMAGE_SIZE);
         assert_eq!(body["n"], 1);
         assert!(body.get("official_fallback").is_none());
-        assert_eq!(body["image"][0], "data:image/png;base64,abcd");
+        assert!(body.get("image").is_none());
         assert!(
             body["prompt"]
                 .as_str()
@@ -4235,6 +4266,61 @@ mod tests {
         );
     }
 
+    #[test]
+    fn puzzle_vector_engine_edit_url_uses_images_edits_endpoint() {
+        let settings = PuzzleVectorEngineSettings {
+            base_url: "https://vector.example/v1".to_string(),
+            api_key: "test-key".to_string(),
+        };
+
+        assert_eq!(
+            puzzle_vector_engine_images_edit_url(&settings),
+            "https://vector.example/v1/images/edits"
+        );
+    }
+
+    #[test]
+    fn puzzle_vector_engine_edit_response_decodes_b64_image() {
+        let images = puzzle_images_from_base64(
+            "edit-1".to_string(),
+            vec![BASE64_STANDARD.encode(b"\x89PNG\r\n\x1A\nrest")],
+            1,
+        );
+
+        assert_eq!(images.images.len(), 1);
+        assert_eq!(images.images[0].mime_type, "image/png");
+        assert_eq!(images.images[0].extension, "png");
+    }
+
+    #[test]
+    fn puzzle_vector_engine_prompt_strongly_uses_reference_image() {
+        let prompt = build_puzzle_vector_engine_generation_prompt("请生成雨夜猫街。", true);
+
+        assert!(prompt.contains("参考图作为第一优先级"));
+        assert!(prompt.contains("严格保留参考图的主要主体、构图关系、视角、姿态、配色和光影氛围"));
+        assert!(prompt.contains("请生成雨夜猫街。"));
+    }
+
+    #[test]
+    fn puzzle_vector_engine_prompt_keeps_text_only_prompt_unchanged() {
+        let prompt = build_puzzle_vector_engine_generation_prompt("请生成雨夜猫街。", false);
+
+        assert_eq!(prompt, "请生成雨夜猫街。");
+    }
+
+    #[test]
+    fn puzzle_reference_image_edit_requires_ai_redraw() {
+        assert!(!should_use_puzzle_reference_image_edit(None, true));
+        assert!(!should_use_puzzle_reference_image_edit(
+            Some("data:image/png;base64,abcd"),
+            false
+        ));
+        assert!(should_use_puzzle_reference_image_edit(
+            Some("data:image/png;base64,abcd"),
+            true
+        ));
+    }
+
     #[test]
     fn puzzle_compile_error_preserves_vector_engine_unavailable_status() {
         let error = map_puzzle_compile_error(SpacetimeClientError::Runtime(
@@ -4583,9 +4669,9 @@ struct PuzzleGeneratedImages {
 }
 
 struct PuzzleResolvedReferenceImage {
-    data_url: String,
     mime_type: String,
     bytes_len: usize,
+    bytes: Vec<u8>,
 }
 
 struct GeneratedPuzzleImageCandidate {
@@ -4721,7 +4807,6 @@ async fn create_puzzle_vector_engine_image_generation(
     negative_prompt: &str,
     size: &str,
     candidate_count: u32,
-    reference_image: Option<&str>,
 ) -> Result<PuzzleGeneratedImages, AppError> {
     let request_body = build_puzzle_vector_engine_image_request_body(
         image_model,
@@ -4729,13 +4814,8 @@ async fn create_puzzle_vector_engine_image_generation(
         negative_prompt,
         size,
         candidate_count,
-        reference_image,
     );
     let request_url = puzzle_vector_engine_images_generation_url(settings);
-    let has_reference_image = reference_image
-        .map(str::trim)
-        .map(|value| !value.is_empty())
-        .unwrap_or(false);
     let request_started_at = Instant::now();
     let response = http_client
         .post(request_url.as_str())
@@ -4762,7 +4842,7 @@ async fn create_puzzle_vector_engine_image_generation(
         status = status.as_u16(),
         prompt_chars = prompt.chars().count(),
         size,
-        has_reference_image,
+        has_reference_image = false,
         elapsed_ms = upstream_elapsed_ms,
         "拼图 VectorEngine 图片生成 HTTP 返回"
     );
@@ -4811,15 +4891,114 @@ async fn create_puzzle_vector_engine_image_generation(
     )
 }
 
+async fn create_puzzle_vector_engine_image_edit(
+    http_client: &reqwest::Client,
+    settings: &PuzzleVectorEngineSettings,
+    prompt: &str,
+    negative_prompt: &str,
+    size: &str,
+    candidate_count: u32,
+    reference_image: &PuzzleResolvedReferenceImage,
+) -> Result<PuzzleGeneratedImages, AppError> {
+    let request_url = puzzle_vector_engine_images_edit_url(settings);
+    let task_id = format!("vector-engine-edit-{}", current_utc_micros());
+    let file_name = format!(
+        "puzzle-reference.{}",
+        puzzle_mime_to_extension(reference_image.mime_type.as_str())
+    );
+    let image_part = reqwest::multipart::Part::bytes(reference_image.bytes.clone())
+        .file_name(file_name)
+        .mime_str(reference_image.mime_type.as_str())
+        .map_err(|error| {
+            map_puzzle_vector_engine_request_error(format!(
+                "构造拼图 VectorEngine 图片编辑参考图失败：{error}"
+            ))
+        })?;
+    let form = reqwest::multipart::Form::new()
+        .part("image", image_part)
+        .text("model", PUZZLE_VECTOR_ENGINE_IMAGE_EDIT_MODEL.to_string())
+        .text(
+            "prompt",
+            build_puzzle_vector_engine_prompt(prompt, negative_prompt),
+        )
+        .text("n", candidate_count.clamp(1, 1).to_string())
+        .text("size", size.to_string());
+    let request_started_at = Instant::now();
+    let response = http_client
+        .post(request_url.as_str())
+        .header(
+            reqwest::header::AUTHORIZATION,
+            format!("Bearer {}", settings.api_key),
+        )
+        .header(reqwest::header::ACCEPT, "application/json")
+        .multipart(form)
+        .send()
+        .await
+        .map_err(|error| {
+            map_puzzle_vector_engine_request_error(format!(
+                "创建拼图 VectorEngine 图片编辑任务失败：{error}"
+            ))
+        })?;
+    let status = response.status();
+    tracing::info!(
+        provider = VECTOR_ENGINE_PROVIDER,
+        image_model = PUZZLE_VECTOR_ENGINE_IMAGE_EDIT_MODEL,
+        endpoint = %request_url,
+        status = status.as_u16(),
+        prompt_chars = prompt.chars().count(),
+        size,
+        reference_mime = %reference_image.mime_type,
+        reference_bytes = reference_image.bytes_len,
+        elapsed_ms = request_started_at.elapsed().as_millis() as u64,
+        "拼图 VectorEngine 图片编辑 HTTP 返回"
+    );
+    let response_text = response.text().await.map_err(|error| {
+        map_puzzle_vector_engine_request_error(format!(
+            "读取拼图 VectorEngine 图片编辑响应失败：{error}"
+        ))
+    })?;
+    if !status.is_success() {
+        return Err(map_puzzle_vector_engine_upstream_error(
+            status,
+            response_text.as_str(),
+            "创建拼图 VectorEngine 图片编辑任务失败",
+        ));
+    }
+
+    let payload = parse_puzzle_json_payload(
+        response_text.as_str(),
+        "解析拼图 VectorEngine 图片编辑响应失败",
+    )?;
+    let image_urls = extract_puzzle_image_urls(&payload);
+    if !image_urls.is_empty() {
+        return download_puzzle_images_from_urls(http_client, task_id, image_urls, candidate_count)
+            .await;
+    }
+    let b64_images = extract_puzzle_b64_images(&payload);
+    if !b64_images.is_empty() {
+        return Ok(puzzle_images_from_base64(
+            task_id,
+            b64_images,
+            candidate_count,
+        ));
+    }
+
+    Err(
+        AppError::from_status(StatusCode::BAD_GATEWAY).with_details(json!({
+            "provider": VECTOR_ENGINE_PROVIDER,
+            "message": "拼图 VectorEngine 图片编辑未返回图片",
+        })),
+    )
+}
+
 fn build_puzzle_vector_engine_image_request_body(
     image_model: PuzzleImageModel,
     prompt: &str,
     negative_prompt: &str,
     size: &str,
     candidate_count: u32,
-    reference_image: Option<&str>,
 ) -> Value {
-    let mut body = Map::from_iter([
+    Value::Object(Map::from_iter([
         (
             "model".to_string(),
             Value::String(image_model.request_model_name().to_string()),
@@ -4830,16 +5009,37 @@ fn build_puzzle_vector_engine_image_request_body(
         ),
         ("n".to_string(), json!(candidate_count.clamp(1, 1))),
         ("size".to_string(), Value::String(size.to_string())),
-    ]);
+    ]))
+}
 
-    if let Some(reference_image) = reference_image
-        .map(str::trim)
-        .filter(|value| !value.is_empty())
-    {
-        body.insert("image".to_string(), json!([reference_image]));
+fn build_puzzle_vector_engine_generation_prompt(prompt: &str, has_reference_image: bool) -> String {
+    let prompt = prompt.trim();
+    if !has_reference_image {
+        return prompt.to_string();
     }
 
-    Value::Object(body)
+    format!(
+        concat!(
+            "请以随请求提供的参考图作为第一优先级生成依据，严格保留参考图的主要主体、构图关系、视角、姿态、配色和光影氛围；",
+            "允许按下面文字要求做风格化和细节增强，但不要改成与参考图无关的新画面。\n",
+            "{prompt}"
+        ),
+        prompt = prompt,
+    )
+}
+
+fn has_puzzle_reference_image(reference_image_src: Option<&str>) -> bool {
+    reference_image_src
+        .map(str::trim)
+        .map(|value| !value.is_empty())
+        .unwrap_or(false)
+}
+
+fn should_use_puzzle_reference_image_edit(
+    reference_image_src: Option<&str>,
+    use_reference_image_edit: bool,
+) -> bool {
+    use_reference_image_edit && has_puzzle_reference_image(reference_image_src)
 }
 
 fn build_puzzle_vector_engine_prompt(prompt: &str, negative_prompt: &str) -> String {
@@ -4860,6 +5060,14 @@ fn puzzle_vector_engine_images_generation_url(settings: &PuzzleVectorEngineSetti
     }
 }
 
+fn puzzle_vector_engine_images_edit_url(settings: &PuzzleVectorEngineSettings) -> String {
+    if settings.base_url.ends_with("/v1") {
+        format!("{}/images/edits", settings.base_url)
+    } else {
+        format!("{}/v1/images/edits", settings.base_url)
+    }
+}
+
 async fn download_puzzle_images_from_urls(
     http_client: &reqwest::Client,
     task_id: String,
@@ -4894,15 +5102,21 @@ async fn resolve_puzzle_reference_image_as_data_url(
 
     if let Some(parsed) = parse_puzzle_image_data_url(trimmed) {
         let bytes_len = parsed.bytes.len();
-        let data_url = format!(
-            "data:{};base64,{}",
-            parsed.mime_type,
-            BASE64_STANDARD.encode(&parsed.bytes)
-        );
+        if bytes_len > PUZZLE_REFERENCE_IMAGE_MAX_BYTES {
+            return Err(
+                AppError::from_status(StatusCode::BAD_REQUEST).with_details(json!({
+                    "provider": "puzzle",
+                    "field": "referenceImageSrc",
+                    "message": "参考图过大，请压缩后重试。",
+                    "maxBytes": PUZZLE_REFERENCE_IMAGE_MAX_BYTES,
+                    "actualBytes": bytes_len,
+                })),
+            );
+        }
         return Ok(PuzzleResolvedReferenceImage {
-            data_url,
             mime_type: parsed.mime_type,
             bytes_len,
+            bytes: parsed.bytes,
         });
     }
 
@@ -4976,9 +5190,9 @@ async fn resolve_puzzle_reference_image_as_data_url(
     let mime_type = normalize_puzzle_downloaded_image_mime_type(content_type.as_str());
     let bytes_len = body.len();
     Ok(PuzzleResolvedReferenceImage {
-        data_url: format!("data:{};base64,{}", mime_type, BASE64_STANDARD.encode(body)),
         mime_type,
         bytes_len,
+        bytes: body.to_vec(),
     })
 }
 
@@ -5228,6 +5442,36 @@ fn extract_puzzle_image_urls(payload: &Value) -> Vec<String> {
     deduped
 }
 
+fn extract_puzzle_b64_images(payload: &Value) -> Vec<String> {
+    let mut values = Vec::new();
+    collect_puzzle_strings_by_key(payload, "b64_json", &mut values);
+    values
+}
+
+fn puzzle_images_from_base64(
+    task_id: String,
+    b64_images: Vec<String>,
+    candidate_count: u32,
+) -> PuzzleGeneratedImages {
+    let images = b64_images
+        .into_iter()
+        .take(candidate_count.clamp(1, 1) as usize)
+        .filter_map(|raw| decode_puzzle_generated_image_base64(raw.as_str()))
+        .collect();
+
+    PuzzleGeneratedImages { task_id, images }
+}
+
+fn decode_puzzle_generated_image_base64(raw: &str) -> Option<PuzzleDownloadedImage> {
+    let bytes = BASE64_STANDARD.decode(raw.trim()).ok()?;
+    let mime_type = infer_puzzle_image_mime_type(bytes.as_slice());
+    Some(PuzzleDownloadedImage {
+        extension: puzzle_mime_to_extension(mime_type.as_str()).to_string(),
+        mime_type,
+        bytes,
+    })
+}
+
 fn find_first_puzzle_string_by_key(payload: &Value, target_key: &str) -> Option<String> {
     let mut results = Vec::new();
     collect_puzzle_strings_by_key(payload, target_key, &mut results);
@@ -5265,6 +5509,22 @@ fn collect_puzzle_string_values(payload: &Value, results: &mut Vec<String>) {
     }
 }
 
+fn infer_puzzle_image_mime_type(bytes: &[u8]) -> String {
+    if bytes.starts_with(b"\x89PNG\r\n\x1A\n") {
+        return "image/png".to_string();
+    }
+    if bytes.starts_with(b"\xFF\xD8\xFF") {
+        return "image/jpeg".to_string();
+    }
+    if bytes.starts_with(b"RIFF") && bytes.get(8..12) == Some(b"WEBP") {
+        return "image/webp".to_string();
+    }
+    if bytes.starts_with(b"GIF87a") || bytes.starts_with(b"GIF89a") {
+        return "image/gif".to_string();
+    }
+    "image/png".to_string()
+}
+
 fn normalize_puzzle_downloaded_image_mime_type(content_type: &str) -> String {
     let mime_type = content_type
         .split(';')
diff --git a/server-rs/crates/api-server/src/runtime_profile.rs b/server-rs/crates/api-server/src/runtime_profile.rs
index 8c1434de..b7442568 100644
--- a/server-rs/crates/api-server/src/runtime_profile.rs
+++ b/server-rs/crates/api-server/src/runtime_profile.rs
@@ -675,6 +675,7 @@ pub async fn admin_upsert_profile_invite_code(
             admin.session().username.clone(),
             payload.invite_code,
             metadata_json,
+            payload.granted_user_tags,
             starts_at_micros,
             expires_at_micros,
             updated_at_micros as i64,
@@ -1123,6 +1124,7 @@ fn build_profile_invite_code_admin_response(
         user_id: record.user_id,
         invite_code: record.invite_code,
         metadata,
+        granted_user_tags: record.granted_user_tags,
         starts_at: record.starts_at,
         expires_at: record.expires_at,
         status: record.status.as_str().to_string(),
diff --git a/server-rs/crates/module-puzzle/src/domain.rs b/server-rs/crates/module-puzzle/src/domain.rs
index 1ae4e83c..d932a758 100644
--- a/server-rs/crates/module-puzzle/src/domain.rs
+++ b/server-rs/crates/module-puzzle/src/domain.rs
@@ -305,6 +305,8 @@ pub struct PuzzleLeaderboardEntry {
     pub rank: u32,
     pub nickname: String,
     pub elapsed_ms: u64,
+    #[serde(default)]
+    pub visible_tags: Vec<String>,
     pub is_current_player: bool,
 }
 
diff --git a/server-rs/crates/module-runtime/src/application.rs b/server-rs/crates/module-runtime/src/application.rs
index 52e77ae8..6c4e739d 100644
--- a/server-rs/crates/module-runtime/src/application.rs
+++ b/server-rs/crates/module-runtime/src/application.rs
@@ -715,6 +715,7 @@ pub fn build_runtime_profile_invite_code_record(
         user_id: snapshot.user_id,
         invite_code: snapshot.invite_code,
         metadata_json: snapshot.metadata_json,
+        granted_user_tags: snapshot.granted_user_tags,
         starts_at: snapshot.starts_at_micros.map(format_utc_micros),
         starts_at_micros: snapshot.starts_at_micros,
         expires_at: snapshot.expires_at_micros.map(format_utc_micros),
diff --git a/server-rs/crates/module-runtime/src/commands.rs b/server-rs/crates/module-runtime/src/commands.rs
index 6341ea9d..51cec786 100644
--- a/server-rs/crates/module-runtime/src/commands.rs
+++ b/server-rs/crates/module-runtime/src/commands.rs
@@ -13,6 +13,9 @@ use crate::domain::*;
 use crate::errors::*;
 use crate::{format_utc_micros, runtime_profile_recharge_product_by_id};
 
+pub const PROFILE_USER_TAG_MAX_COUNT: usize = 8;
+pub const PROFILE_USER_TAG_MAX_CHARS: usize = 16;
+
 // 统一把共享必填字符串归一化映射到 runtime 各自的字段错误，避免输入构造函数重复 trim + 判空。
 fn normalize_runtime_settings_user_id(
     user_id: String,
@@ -425,6 +428,7 @@ pub fn build_runtime_profile_invite_code_admin_upsert_input(
     admin_user_id: String,
     invite_code: String,
     metadata_json: String,
+    granted_user_tags: Vec<String>,
     starts_at_micros: Option<i64>,
     expires_at_micros: Option<i64>,
     updated_at_micros: i64,
@@ -433,6 +437,7 @@ pub fn build_runtime_profile_invite_code_admin_upsert_input(
     let invite_code =
         normalize_invite_code(invite_code).ok_or(RuntimeProfileFieldError::MissingInviteCode)?;
     let metadata_json = normalize_invite_code_metadata_json(metadata_json)?;
+    let granted_user_tags = normalize_profile_user_tags(granted_user_tags)?;
     crate::commands::validate_runtime_profile_invite_code_validity_window(
         starts_at_micros,
         expires_at_micros,
@@ -442,6 +447,7 @@ pub fn build_runtime_profile_invite_code_admin_upsert_input(
         admin_user_id,
         invite_code,
         metadata_json,
+        granted_user_tags,
         starts_at_micros,
         expires_at_micros,
         updated_at_micros,
@@ -770,6 +776,27 @@ pub fn normalize_invite_code_metadata_json(
     serde_json::to_string(&parsed).map_err(|_| RuntimeProfileFieldError::InvalidInviteCodeMetadata)
 }
 
+pub fn normalize_profile_user_tags(
+    values: Vec<String>,
+) -> Result<Vec<String>, RuntimeProfileFieldError> {
+    let mut tags = Vec::new();
+    for value in values {
+        let Some(tag) = normalize_optional_string(Some(value)) else {
+            continue;
+        };
+        if tag.chars().count() > PROFILE_USER_TAG_MAX_CHARS {
+            return Err(RuntimeProfileFieldError::InvalidUserTag);
+        }
+        if !tags.iter().any(|existing| existing == &tag) {
+            tags.push(tag);
+        }
+        if tags.len() > PROFILE_USER_TAG_MAX_COUNT {
+            return Err(RuntimeProfileFieldError::InvalidUserTag);
+        }
+    }
+    Ok(tags)
+}
+
 pub fn validate_runtime_profile_invite_code_validity_window(
     starts_at_micros: Option<i64>,
     expires_at_micros: Option<i64>,
diff --git a/server-rs/crates/module-runtime/src/domain.rs b/server-rs/crates/module-runtime/src/domain.rs
index c5eea622..66bb99c7 100644
--- a/server-rs/crates/module-runtime/src/domain.rs
+++ b/server-rs/crates/module-runtime/src/domain.rs
@@ -1121,6 +1121,7 @@ pub struct RuntimeProfileInviteCodeAdminUpsertInput {
     pub admin_user_id: String,
     pub invite_code: String,
     pub metadata_json: String,
+    pub granted_user_tags: Vec<String>,
     pub starts_at_micros: Option<i64>,
     pub expires_at_micros: Option<i64>,
     pub updated_at_micros: i64,
@@ -1138,6 +1139,7 @@ pub struct RuntimeProfileInviteCodeSnapshot {
     pub user_id: String,
     pub invite_code: String,
     pub metadata_json: String,
+    pub granted_user_tags: Vec<String>,
     pub starts_at_micros: Option<i64>,
     pub expires_at_micros: Option<i64>,
     pub created_at_micros: i64,
@@ -1510,6 +1512,7 @@ pub struct RuntimeProfileInviteCodeRecord {
     pub user_id: String,
     pub invite_code: String,
     pub metadata_json: String,
+    pub granted_user_tags: Vec<String>,
     pub starts_at: Option<String>,
     pub starts_at_micros: Option<i64>,
     pub expires_at: Option<String>,
diff --git a/server-rs/crates/module-runtime/src/errors.rs b/server-rs/crates/module-runtime/src/errors.rs
index 0f48f663..520d6d5a 100644
--- a/server-rs/crates/module-runtime/src/errors.rs
+++ b/server-rs/crates/module-runtime/src/errors.rs
@@ -57,6 +57,7 @@ pub enum RuntimeProfileFieldError {
     InvalidRedeemCodeReward,
     InvalidRedeemCodeMaxUses,
     InvalidInviteCodeMetadata,
+    InvalidUserTag,
     InvalidInviteCodeValidityWindow,
     MissingTaskId,
     MissingTaskTitle,
@@ -115,6 +116,7 @@ impl std::fmt::Display for RuntimeProfileFieldError {
             Self::InvalidInviteCodeMetadata => {
                 f.write_str("邀请码 metadata 必须是合法 JSON object")
             }
+            Self::InvalidUserTag => f.write_str("用户标签格式无效"),
             Self::InvalidInviteCodeValidityWindow => f.write_str("邀请码开始时间不能晚于截止时间"),
             Self::MissingTaskId => f.write_str("profile_task.task_id 不能为空"),
             Self::MissingTaskTitle => f.write_str("profile_task.title 不能为空"),
diff --git a/server-rs/crates/module-runtime/src/lib.rs b/server-rs/crates/module-runtime/src/lib.rs
index 876cbd27..824c7ccc 100644
--- a/server-rs/crates/module-runtime/src/lib.rs
+++ b/server-rs/crates/module-runtime/src/lib.rs
@@ -146,6 +146,13 @@ pub fn runtime_profile_recharge_product_by_id(
         .find(|product| product.product_id == product_id)
 }
 
+pub fn visible_runtime_profile_user_tags(tags: &[String]) -> Vec<String> {
+    tags.iter()
+        .filter(|tag| tag.as_str() == "北科")
+        .cloned()
+        .collect()
+}
+
 fn build_points_recharge_product(
     product_id: &str,
     title: &str,
diff --git a/server-rs/crates/module-runtime/tests/invite_code_validity.rs b/server-rs/crates/module-runtime/tests/invite_code_validity.rs
index 96176dae..2997afcc 100644
--- a/server-rs/crates/module-runtime/tests/invite_code_validity.rs
+++ b/server-rs/crates/module-runtime/tests/invite_code_validity.rs
@@ -48,6 +48,7 @@ fn invite_code_record_formats_window_and_status() {
         user_id: "user-1".to_string(),
         invite_code: "SY00000001".to_string(),
         metadata_json: "{}".to_string(),
+        granted_user_tags: Vec::new(),
         starts_at_micros: Some(0),
         expires_at_micros: Some(1_000_000),
         created_at_micros: 0,
diff --git a/server-rs/crates/platform-oss/src/lib.rs b/server-rs/crates/platform-oss/src/lib.rs
index 440b7789..61a4f301 100644
--- a/server-rs/crates/platform-oss/src/lib.rs
+++ b/server-rs/crates/platform-oss/src/lib.rs
@@ -20,12 +20,13 @@ const OSS_V4_REQUEST: &str = "aliyun_v4_request";
 const OSS_V4_SERVICE: &str = "oss";
 const OSS_UNSIGNED_PAYLOAD: &str = "UNSIGNED-PAYLOAD";
 
-pub const LEGACY_PUBLIC_PREFIXES: [&str; 9] = [
+pub const LEGACY_PUBLIC_PREFIXES: [&str; 10] = [
     "generated-character-drafts",
     "generated-characters",
     "generated-animations",
     "generated-big-fish-assets",
     "generated-square-hole-assets",
+    "generated-match3d-assets",
     "generated-puzzle-assets",
     "generated-custom-world-scenes",
     "generated-custom-world-covers",
@@ -46,6 +47,7 @@ pub enum LegacyAssetPrefix {
     Animations,
     BigFishAssets,
     SquareHoleAssets,
+    Match3DAssets,
     PuzzleAssets,
     CustomWorldScenes,
     CustomWorldCovers,
@@ -232,6 +234,7 @@ impl LegacyAssetPrefix {
             "generated-animations" => Some(Self::Animations),
             "generated-big-fish-assets" => Some(Self::BigFishAssets),
             "generated-square-hole-assets" => Some(Self::SquareHoleAssets),
+            "generated-match3d-assets" => Some(Self::Match3DAssets),
             "generated-puzzle-assets" => Some(Self::PuzzleAssets),
             "generated-custom-world-scenes" => Some(Self::CustomWorldScenes),
             "generated-custom-world-covers" => Some(Self::CustomWorldCovers),
@@ -247,6 +250,7 @@ impl LegacyAssetPrefix {
             Self::Animations => "generated-animations",
             Self::BigFishAssets => "generated-big-fish-assets",
             Self::SquareHoleAssets => "generated-square-hole-assets",
+            Self::Match3DAssets => "generated-match3d-assets",
             Self::PuzzleAssets => "generated-puzzle-assets",
             Self::CustomWorldScenes => "generated-custom-world-scenes",
             Self::CustomWorldCovers => "generated-custom-world-covers",
@@ -1305,7 +1309,12 @@ mod tests {
             LegacyAssetPrefix::parse("/generated-puzzle-assets/*"),
             Some(LegacyAssetPrefix::PuzzleAssets)
         );
+        assert_eq!(
+            LegacyAssetPrefix::parse("/generated-match3d-assets/*"),
+            Some(LegacyAssetPrefix::Match3DAssets)
+        );
         assert!(LEGACY_PUBLIC_PREFIXES.contains(&"generated-puzzle-assets"));
+        assert!(LEGACY_PUBLIC_PREFIXES.contains(&"generated-match3d-assets"));
         assert_eq!(LegacyAssetPrefix::parse("unknown"), None);
     }
 
diff --git a/server-rs/crates/shared-contracts/src/match3d_agent.rs b/server-rs/crates/shared-contracts/src/match3d_agent.rs
index 8db4ea95..a2eb00ee 100644
--- a/server-rs/crates/shared-contracts/src/match3d_agent.rs
+++ b/server-rs/crates/shared-contracts/src/match3d_agent.rs
@@ -13,6 +13,12 @@ pub struct CreateMatch3DAgentSessionRequest {
     pub clear_count: Option<u32>,
     #[serde(default)]
     pub difficulty: Option<u32>,
+    #[serde(default)]
+    pub asset_style_id: Option<String>,
+    #[serde(default)]
+    pub asset_style_label: Option<String>,
+    #[serde(default)]
+    pub asset_style_prompt: Option<String>,
 }
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
@@ -52,6 +58,12 @@ pub struct Match3DCreatorConfigResponse {
     pub reference_image_src: Option<String>,
     pub clear_count: u32,
     pub difficulty: u32,
+    #[serde(default)]
+    pub asset_style_id: Option<String>,
+    #[serde(default)]
+    pub asset_style_label: Option<String>,
+    #[serde(default)]
+    pub asset_style_prompt: Option<String>,
 }
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
@@ -73,6 +85,32 @@ pub struct Match3DResultDraftResponse {
     pub total_item_count: u32,
     pub publish_ready: bool,
     pub blockers: Vec<String>,
+    #[serde(default, skip_serializing_if = "Vec::is_empty")]
+    pub generated_item_assets: Vec<Match3DGeneratedItemAssetResponse>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "camelCase")]
+pub struct Match3DGeneratedItemAssetResponse {
+    pub item_id: String,
+    pub item_name: String,
+    #[serde(default)]
+    pub image_src: Option<String>,
+    #[serde(default)]
+    pub image_object_key: Option<String>,
+    #[serde(default)]
+    pub model_src: Option<String>,
+    #[serde(default)]
+    pub model_object_key: Option<String>,
+    #[serde(default)]
+    pub model_file_name: Option<String>,
+    #[serde(default)]
+    pub task_uuid: Option<String>,
+    #[serde(default)]
+    pub subscription_key: Option<String>,
+    pub status: String,
+    #[serde(default)]
+    pub error: Option<String>,
 }
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
@@ -147,6 +185,9 @@ mod tests {
             reference_image_src: Some("data:image/png;base64,abc".to_string()),
             clear_count: Some(4),
             difficulty: Some(3),
+            asset_style_id: Some("clay-toy".to_string()),
+            asset_style_label: Some("黏土手作".to_string()),
+            asset_style_prompt: Some("圆润黏土手作风".to_string()),
         })
         .expect("payload should serialize");
 
@@ -157,5 +198,6 @@ mod tests {
             json!("data:image/png;base64,abc")
         );
         assert_eq!(payload["clearCount"], json!(4));
+        assert_eq!(payload["assetStyleId"], json!("clay-toy"));
     }
 }
diff --git a/server-rs/crates/shared-contracts/src/match3d_works.rs b/server-rs/crates/shared-contracts/src/match3d_works.rs
index 3bf85e55..8b652f36 100644
--- a/server-rs/crates/shared-contracts/src/match3d_works.rs
+++ b/server-rs/crates/shared-contracts/src/match3d_works.rs
@@ -40,6 +40,32 @@ pub struct Match3DWorkSummaryResponse {
     #[serde(default)]
     pub published_at: Option<String>,
     pub publish_ready: bool,
+    #[serde(default, skip_serializing_if = "Vec::is_empty")]
+    pub generated_item_assets: Vec<Match3DGeneratedItemAssetResponse>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct Match3DGeneratedItemAssetResponse {
+    pub item_id: String,
+    pub item_name: String,
+    #[serde(default)]
+    pub image_src: Option<String>,
+    #[serde(default)]
+    pub image_object_key: Option<String>,
+    #[serde(default)]
+    pub model_src: Option<String>,
+    #[serde(default)]
+    pub model_object_key: Option<String>,
+    #[serde(default)]
+    pub model_file_name: Option<String>,
+    #[serde(default)]
+    pub task_uuid: Option<String>,
+    #[serde(default)]
+    pub subscription_key: Option<String>,
+    pub status: String,
+    #[serde(default)]
+    pub error: Option<String>,
 }
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
diff --git a/server-rs/crates/shared-contracts/src/puzzle_runtime.rs b/server-rs/crates/shared-contracts/src/puzzle_runtime.rs
index 4eb476a3..2dff956b 100644
--- a/server-rs/crates/shared-contracts/src/puzzle_runtime.rs
+++ b/server-rs/crates/shared-contracts/src/puzzle_runtime.rs
@@ -85,6 +85,8 @@ pub struct PuzzleLeaderboardEntryResponse {
     pub nickname: String,
     pub elapsed_ms: u64,
     #[serde(default)]
+    pub visible_tags: Vec<String>,
+    #[serde(default)]
     pub is_current_player: bool,
 }
 
diff --git a/server-rs/crates/shared-contracts/src/runtime.rs b/server-rs/crates/shared-contracts/src/runtime.rs
index d0a56bd6..c9a4f46c 100644
--- a/server-rs/crates/shared-contracts/src/runtime.rs
+++ b/server-rs/crates/shared-contracts/src/runtime.rs
@@ -486,6 +486,8 @@ pub struct AdminUpsertProfileInviteCodeRequest {
     #[serde(default)]
     pub metadata: Option<serde_json::Value>,
     #[serde(default)]
+    pub granted_user_tags: Vec<String>,
+    #[serde(default)]
     pub starts_at: Option<String>,
     #[serde(default)]
     pub expires_at: Option<String>,
@@ -524,6 +526,7 @@ pub struct ProfileInviteCodeAdminResponse {
     pub user_id: String,
     pub invite_code: String,
     pub metadata: serde_json::Value,
+    pub granted_user_tags: Vec<String>,
     pub starts_at: Option<String>,
     pub expires_at: Option<String>,
     pub status: String,
diff --git a/server-rs/crates/spacetime-client/src/mapper.rs b/server-rs/crates/spacetime-client/src/mapper.rs
index b2dfd9fb..5ff8c3d6 100644
--- a/server-rs/crates/spacetime-client/src/mapper.rs
+++ b/server-rs/crates/spacetime-client/src/mapper.rs
@@ -320,6 +320,7 @@ impl From<module_runtime::RuntimeProfileInviteCodeAdminUpsertInput>
             admin_user_id: input.admin_user_id,
             invite_code: input.invite_code,
             metadata_json: input.metadata_json,
+            granted_user_tags: input.granted_user_tags,
             starts_at_micros: input.starts_at_micros,
             expires_at_micros: input.expires_at_micros,
             updated_at_micros: input.updated_at_micros,
@@ -2315,6 +2316,7 @@ pub(crate) fn map_runtime_profile_invite_code_snapshot(
         user_id: snapshot.user_id,
         invite_code: snapshot.invite_code,
         metadata_json: snapshot.metadata_json,
+        granted_user_tags: snapshot.granted_user_tags,
         starts_at_micros: snapshot.starts_at_micros,
         expires_at_micros: snapshot.expires_at_micros,
         created_at_micros: snapshot.created_at_micros,
@@ -2935,6 +2937,9 @@ fn map_match3d_creator_config(
         reference_image_src: snapshot.reference_image_src,
         clear_count: snapshot.clear_count,
         difficulty: snapshot.difficulty,
+        asset_style_id: snapshot.asset_style_id,
+        asset_style_label: snapshot.asset_style_label,
+        asset_style_prompt: snapshot.asset_style_prompt,
     }
 }
 
@@ -2993,6 +2998,7 @@ fn map_match3d_work_snapshot(snapshot: Match3DWorkJsonRecord) -> Match3DWorkProf
         updated_at: format_timestamp_micros(snapshot.updated_at_micros),
         published_at: snapshot.published_at_micros.map(format_timestamp_micros),
         publish_ready: snapshot.publish_ready,
+        generated_item_assets_json: snapshot.generated_item_assets_json,
     }
 }
 
@@ -3745,6 +3751,7 @@ pub(crate) fn map_puzzle_leaderboard_entry(
         rank: snapshot.rank,
         nickname: snapshot.nickname,
         elapsed_ms: snapshot.elapsed_ms,
+        visible_tags: snapshot.visible_tags,
         is_current_player: snapshot.is_current_player,
     }
 }
@@ -5997,6 +6004,7 @@ pub struct Match3DCompileDraftRecordInput {
     pub cover_image_src: Option<String>,
     pub cover_asset_id: Option<String>,
     pub compiled_at_micros: i64,
+    pub generated_item_assets_json: Option<String>,
 }
 
 #[derive(Clone, Debug, PartialEq, Eq)]
@@ -6075,6 +6083,9 @@ pub struct Match3DCreatorConfigRecord {
     pub reference_image_src: Option<String>,
     pub clear_count: u32,
     pub difficulty: u32,
+    pub asset_style_id: Option<String>,
+    pub asset_style_label: Option<String>,
+    pub asset_style_prompt: Option<String>,
 }
 
 #[derive(Clone, Debug, PartialEq, Eq)]
@@ -6138,6 +6149,7 @@ pub struct Match3DWorkProfileRecord {
     pub updated_at: String,
     pub published_at: Option<String>,
     pub publish_ready: bool,
+    pub generated_item_assets_json: Option<String>,
 }
 
 #[derive(Clone, Debug, PartialEq)]
@@ -6201,6 +6213,12 @@ struct Match3DCreatorConfigJsonRecord {
     reference_image_src: Option<String>,
     clear_count: u32,
     difficulty: u32,
+    #[serde(default)]
+    asset_style_id: Option<String>,
+    #[serde(default)]
+    asset_style_label: Option<String>,
+    #[serde(default)]
+    asset_style_prompt: Option<String>,
 }
 
 #[derive(Clone, Debug, PartialEq, Eq, serde::Deserialize)]
@@ -6269,6 +6287,8 @@ struct Match3DWorkJsonRecord {
     play_count: u32,
     updated_at_micros: i64,
     published_at_micros: Option<i64>,
+    #[serde(default)]
+    generated_item_assets_json: Option<String>,
 }
 
 #[derive(Clone, Debug, PartialEq, serde::Deserialize)]
@@ -7309,6 +7329,7 @@ pub struct PuzzleLeaderboardEntryRecord {
     pub rank: u32,
     pub nickname: String,
     pub elapsed_ms: u64,
+    pub visible_tags: Vec<String>,
     pub is_current_player: bool,
 }
 
@@ -7870,6 +7891,53 @@ mod tests {
         assert_eq!(items[0].remix_count, 0);
         assert_eq!(items[0].like_count, 0);
     }
+
+    #[test]
+    fn match3d_work_mapper_keeps_generated_item_assets_json() {
+        let result = Match3DWorkProcedureResult {
+            ok: true,
+            work_json: Some(
+                r#"{
+                    "profileId":"match3d-profile-1",
+                    "ownerUserId":"user-1",
+                    "sourceSessionId":"match3d-session-1",
+                    "authorDisplayName":"测试作者",
+                    "gameName":"水果抓大鹅",
+                    "themeText":"水果",
+                    "summaryText":"水果主题",
+                    "tags":["水果"],
+                    "coverImageSrc":"",
+                    "coverAssetId":"",
+                    "clearCount":3,
+                    "difficulty":3,
+                    "config":{
+                        "themeText":"水果",
+                        "referenceImageSrc":null,
+                        "clearCount":3,
+                        "difficulty":3
+                    },
+                    "publicationStatus":"Draft",
+                    "publishReady":false,
+                    "playCount":0,
+                    "updatedAtMicros":123000000,
+                    "publishedAtMicros":null,
+                    "generatedItemAssetsJson":"[{\"itemId\":\"match3d-item-1\",\"itemName\":\"草莓\",\"imageSrc\":\"/generated-match3d-assets/session/profile/items/item/image.png\",\"status\":\"image_ready\"}]"
+                }"#
+                .to_string(),
+            ),
+            error_message: None,
+        };
+
+        let item = map_match3d_work_procedure_result(result)
+            .expect("match3d work JSON 应保留生成素材 JSON");
+
+        assert_eq!(
+            item.generated_item_assets_json.as_deref(),
+            Some(
+                r#"[{"itemId":"match3d-item-1","itemName":"草莓","imageSrc":"/generated-match3d-assets/session/profile/items/item/image.png","status":"image_ready"}]"#
+            )
+        );
+    }
 }
 
 #[derive(Clone, Debug, PartialEq, Eq)]
diff --git a/server-rs/crates/spacetime-client/src/match3d.rs b/server-rs/crates/spacetime-client/src/match3d.rs
index 32db7478..a2111088 100644
--- a/server-rs/crates/spacetime-client/src/match3d.rs
+++ b/server-rs/crates/spacetime-client/src/match3d.rs
@@ -124,6 +124,7 @@ impl SpacetimeClient {
             cover_image_src: input.cover_image_src,
             cover_asset_id: input.cover_asset_id,
             compiled_at_micros: input.compiled_at_micros,
+            generated_item_assets_json: input.generated_item_assets_json,
         };
 
         self.call_after_connect(move |connection, sender| {
diff --git a/server-rs/crates/spacetime-client/src/module_bindings/match_3_d_draft_compile_input_type.rs b/server-rs/crates/spacetime-client/src/module_bindings/match_3_d_draft_compile_input_type.rs
index e8b5776d..0d056847 100644
--- a/server-rs/crates/spacetime-client/src/module_bindings/match_3_d_draft_compile_input_type.rs
+++ b/server-rs/crates/spacetime-client/src/module_bindings/match_3_d_draft_compile_input_type.rs
@@ -17,6 +17,7 @@ pub struct Match3DDraftCompileInput {
     pub cover_image_src: Option<String>,
     pub cover_asset_id: Option<String>,
     pub compiled_at_micros: i64,
+    pub generated_item_assets_json: Option<String>,
 }
 
 impl __sdk::InModule for Match3DDraftCompileInput {
diff --git a/server-rs/crates/spacetime-client/src/module_bindings/match_3_d_work_profile_row_type.rs b/server-rs/crates/spacetime-client/src/module_bindings/match_3_d_work_profile_row_type.rs
index 750f4c34..03ff94b9 100644
--- a/server-rs/crates/spacetime-client/src/module_bindings/match_3_d_work_profile_row_type.rs
+++ b/server-rs/crates/spacetime-client/src/module_bindings/match_3_d_work_profile_row_type.rs
@@ -24,6 +24,7 @@ pub struct Match3DWorkProfileRow {
     pub play_count: u32,
     pub updated_at: __sdk::Timestamp,
     pub published_at: Option<__sdk::Timestamp>,
+    pub generated_item_assets_json: Option<String>,
 }
 
 impl __sdk::InModule for Match3DWorkProfileRow {
@@ -51,6 +52,8 @@ pub struct Match3DWorkProfileRowCols {
     pub play_count: __sdk::__query_builder::Col<Match3DWorkProfileRow, u32>,
     pub updated_at: __sdk::__query_builder::Col<Match3DWorkProfileRow, __sdk::Timestamp>,
     pub published_at: __sdk::__query_builder::Col<Match3DWorkProfileRow, Option<__sdk::Timestamp>>,
+    pub generated_item_assets_json:
+        __sdk::__query_builder::Col<Match3DWorkProfileRow, Option<String>>,
 }
 
 impl __sdk::__query_builder::HasCols for Match3DWorkProfileRow {
@@ -77,6 +80,10 @@ impl __sdk::__query_builder::HasCols for Match3DWorkProfileRow {
             play_count: __sdk::__query_builder::Col::new(table_name, "play_count"),
             updated_at: __sdk::__query_builder::Col::new(table_name, "updated_at"),
             published_at: __sdk::__query_builder::Col::new(table_name, "published_at"),
+            generated_item_assets_json: __sdk::__query_builder::Col::new(
+                table_name,
+                "generated_item_assets_json",
+            ),
         }
     }
 }
diff --git a/server-rs/crates/spacetime-client/src/runtime.rs b/server-rs/crates/spacetime-client/src/runtime.rs
index b21a87db..9ba85c7d 100644
--- a/server-rs/crates/spacetime-client/src/runtime.rs
+++ b/server-rs/crates/spacetime-client/src/runtime.rs
@@ -652,6 +652,7 @@ impl SpacetimeClient {
         admin_user_id: String,
         invite_code: String,
         metadata_json: String,
+        granted_user_tags: Vec<String>,
         starts_at_micros: Option<i64>,
         expires_at_micros: Option<i64>,
         updated_at_micros: i64,
@@ -660,6 +661,7 @@ impl SpacetimeClient {
             admin_user_id,
             invite_code,
             metadata_json,
+            granted_user_tags,
             starts_at_micros,
             expires_at_micros,
             updated_at_micros,
diff --git a/server-rs/crates/spacetime-module/src/auth/mapper.rs b/server-rs/crates/spacetime-module/src/auth/mapper.rs
index 1bc4342f..6fe205f0 100644
--- a/server-rs/crates/spacetime-module/src/auth/mapper.rs
+++ b/server-rs/crates/spacetime-module/src/auth/mapper.rs
@@ -57,6 +57,8 @@ pub(super) struct AuthUserSnapshot {
     pub(super) binding_status: String,
     pub(super) wechat_bound: bool,
     pub(super) token_version: u64,
+    #[serde(default)]
+    pub(super) user_tags: Vec<String>,
 }
 
 #[derive(Deserialize, Serialize)]
diff --git a/server-rs/crates/spacetime-module/src/auth/procedures.rs b/server-rs/crates/spacetime-module/src/auth/procedures.rs
index d7336c27..cd013890 100644
--- a/server-rs/crates/spacetime-module/src/auth/procedures.rs
+++ b/server-rs/crates/spacetime-module/src/auth/procedures.rs
@@ -210,6 +210,8 @@ fn import_auth_store_snapshot_tx(
             password_hash: stored_user.password_hash,
             password_login_enabled: stored_user.password_login_enabled,
             token_version: user.token_version,
+            user_tags: module_runtime::normalize_profile_user_tags(user.user_tags)
+                .map_err(|error| error.to_string())?,
         });
         imported_user_count += 1;
 
@@ -339,6 +341,7 @@ fn export_auth_store_snapshot_from_tables_tx(
             binding_status: user.binding_status,
             wechat_bound: user.wechat_bound,
             token_version: user.token_version,
+            user_tags: user.user_tags,
         };
         users_by_username.insert(
             user.username,
diff --git a/server-rs/crates/spacetime-module/src/auth/tables.rs b/server-rs/crates/spacetime-module/src/auth/tables.rs
index db0ee321..a82cd40e 100644
--- a/server-rs/crates/spacetime-module/src/auth/tables.rs
+++ b/server-rs/crates/spacetime-module/src/auth/tables.rs
@@ -28,6 +28,8 @@ pub struct UserAccount {
     pub(crate) password_hash: String,
     pub(crate) password_login_enabled: bool,
     pub(crate) token_version: u64,
+    #[default(Vec::<String>::new())]
+    pub(crate) user_tags: Vec<String>,
 }
 
 #[spacetimedb::table(
diff --git a/server-rs/crates/spacetime-module/src/match3d/mod.rs b/server-rs/crates/spacetime-module/src/match3d/mod.rs
index f1c14ade..c114529c 100644
--- a/server-rs/crates/spacetime-module/src/match3d/mod.rs
+++ b/server-rs/crates/spacetime-module/src/match3d/mod.rs
@@ -19,6 +19,8 @@ use module_match3d::{
 use serde::Serialize;
 use serde::de::DeserializeOwned;
 
+const MATCH3D_GENERATED_ITEM_COUNT_MVP: u32 = 3;
+
 #[spacetimedb::procedure]
 pub fn create_match3d_agent_session(
     ctx: &mut ProcedureContext,
@@ -439,7 +441,7 @@ fn compile_match3d_draft_tx(
 ) -> Result<Match3DAgentSessionSnapshot, String> {
     require_non_empty(&input.profile_id, "match3d profile_id")?;
     let session = find_owned_session(ctx, &input.session_id, &input.owner_user_id)?;
-    let config = parse_config(&session.config_json)?;
+    let config = normalize_match3d_generated_item_config(parse_config(&session.config_json)?);
     validate_config(&config)?;
     let tags = input
         .tags_json
@@ -480,6 +482,9 @@ fn compile_match3d_draft_tx(
         play_count: 0,
         updated_at: compiled_at,
         published_at: None,
+        generated_item_assets_json: normalize_generated_item_assets_json(
+            input.generated_item_assets_json.as_deref(),
+        )?,
     };
     upsert_work(ctx, work);
     replace_session(
@@ -514,9 +519,12 @@ fn update_match3d_work_tx(
     let tags = parse_tags(&input.tags_json)?;
     let config = Match3DCreatorConfigSnapshot {
         theme_text: clean_string(&input.theme_text, "经典消除"),
-        reference_image_src: parse_config_or_default(&current.config_json).reference_image_src,
+        ..parse_config_or_default(&current.config_json)
+    };
+    let config = Match3DCreatorConfigSnapshot {
         clear_count: input.clear_count,
         difficulty: input.difficulty,
+        ..config
     };
     validate_config(&config)?;
     let updated_at = Timestamp::from_micros_since_unix_epoch(input.updated_at_micros);
@@ -538,6 +546,7 @@ fn update_match3d_work_tx(
         play_count: current.play_count,
         updated_at,
         published_at: current.published_at,
+        generated_item_assets_json: current.generated_item_assets_json.clone(),
     };
     let snapshot = build_work_snapshot(&next)?;
     replace_work(ctx, &current, next);
@@ -944,6 +953,9 @@ fn build_work_snapshot(row: &Match3DWorkProfileRow) -> Result<Match3DWorkSnapsho
         published_at_micros: row
             .published_at
             .map(|value| value.to_micros_since_unix_epoch()),
+        generated_item_assets_json: normalize_generated_item_assets_json(
+            row.generated_item_assets_json.as_deref(),
+        )?,
     })
 }
 
@@ -1157,6 +1169,7 @@ fn clone_work(row: &Match3DWorkProfileRow) -> Match3DWorkProfileRow {
         play_count: row.play_count,
         updated_at: row.updated_at,
         published_at: row.published_at,
+        generated_item_assets_json: row.generated_item_assets_json.clone(),
     }
 }
 
@@ -1189,6 +1202,9 @@ fn default_config_from_seed(seed_text: &str) -> Match3DCreatorConfigSnapshot {
         reference_image_src: None,
         clear_count: 12,
         difficulty: 3,
+        asset_style_id: None,
+        asset_style_label: None,
+        asset_style_prompt: None,
     }
 }
 
@@ -1202,15 +1218,43 @@ fn parse_config(value: &str) -> Result<Match3DCreatorConfigSnapshot, String> {
         config.difficulty = config
             .difficulty
             .clamp(MATCH3D_MIN_DIFFICULTY, MATCH3D_MAX_DIFFICULTY);
+        config.asset_style_id = normalize_optional_text(config.asset_style_id);
+        config.asset_style_label = normalize_optional_text(config.asset_style_label);
+        config.asset_style_prompt = normalize_optional_text(config.asset_style_prompt);
         config
     })
 }
 
+fn normalize_match3d_generated_item_config(
+    mut config: Match3DCreatorConfigSnapshot,
+) -> Match3DCreatorConfigSnapshot {
+    // 中文注释：素材生成首版任意难度都只生成 3 件物品，草稿编译也同步收敛。
+    config.clear_count = MATCH3D_GENERATED_ITEM_COUNT_MVP;
+    config
+}
+
+fn normalize_optional_text(value: Option<String>) -> Option<String> {
+    value
+        .map(|value| value.trim().to_string())
+        .filter(|value| !value.is_empty())
+}
+
 fn parse_tags(value: &str) -> Result<Vec<String>, String> {
     let parsed = parse_json::<Vec<String>>(value, "match3d tags_json")?;
     Ok(normalize_tags(parsed))
 }
 
+fn normalize_generated_item_assets_json(value: Option<&str>) -> Result<Option<String>, String> {
+    let Some(trimmed) = value.map(str::trim).filter(|value| !value.is_empty()) else {
+        return Ok(None);
+    };
+    let parsed = parse_json::<serde_json::Value>(trimmed, "match3d generated_item_assets_json")?;
+    if !parsed.is_array() {
+        return Err("match3d generated_item_assets_json 必须是数组".to_string());
+    }
+    Ok(Some(to_json_string(&parsed)))
+}
+
 fn default_tags(theme_text: &str) -> Vec<String> {
     normalize_tags(vec![
         theme_text.to_string(),
@@ -1557,17 +1601,81 @@ mod tests {
                 reference_image_src: None,
                 clear_count: 4,
                 difficulty: 3,
+                asset_style_id: None,
+                asset_style_label: None,
+                asset_style_prompt: None,
             }),
             publication_status: MATCH3D_PUBLICATION_DRAFT.to_string(),
             play_count: 0,
             updated_at: Timestamp::from_micros_since_unix_epoch(1),
             published_at: None,
+            generated_item_assets_json: None,
         };
         let snapshot = build_initial_run_snapshot("run-1", &work, 10);
         assert_eq!(snapshot.total_item_count, 12);
         assert_eq!(snapshot.items.len(), 12);
     }
 
+    #[test]
+    fn match3d_work_snapshot_keeps_generated_item_assets_json() {
+        let work = Match3DWorkProfileRow {
+            profile_id: "profile-1".to_string(),
+            owner_user_id: "user-1".to_string(),
+            source_session_id: "session-1".to_string(),
+            author_display_name: "作者".to_string(),
+            game_name: "水果抓大鹅".to_string(),
+            theme_text: "水果".to_string(),
+            summary_text: "水果主题".to_string(),
+            tags_json: "[\"水果\"]".to_string(),
+            cover_image_src: "/cover.png".to_string(),
+            cover_asset_id: String::new(),
+            clear_count: 3,
+            difficulty: 3,
+            config_json: to_json_string(&Match3DCreatorConfigSnapshot {
+                theme_text: "水果".to_string(),
+                reference_image_src: None,
+                clear_count: 3,
+                difficulty: 3,
+                asset_style_id: None,
+                asset_style_label: None,
+                asset_style_prompt: None,
+            }),
+            publication_status: MATCH3D_PUBLICATION_DRAFT.to_string(),
+            play_count: 0,
+            updated_at: Timestamp::from_micros_since_unix_epoch(1),
+            published_at: None,
+            generated_item_assets_json: Some(
+                r#"[{"itemId":"match3d-item-1","itemName":"草莓","imageSrc":"/generated-match3d-assets/session/profile/items/item/image.png","status":"image_ready"}]"#
+                    .to_string(),
+            ),
+        };
+
+        let snapshot = build_work_snapshot(&work).expect("work snapshot should build");
+
+        assert_eq!(
+            snapshot.generated_item_assets_json.as_deref(),
+            Some(
+                r#"[{"imageSrc":"/generated-match3d-assets/session/profile/items/item/image.png","itemId":"match3d-item-1","itemName":"草莓","status":"image_ready"}]"#
+            )
+        );
+    }
+
+    #[test]
+    fn match3d_compile_normalizes_clear_count_to_three_item_mvp() {
+        let config = normalize_match3d_generated_item_config(Match3DCreatorConfigSnapshot {
+            theme_text: "水果".to_string(),
+            reference_image_src: None,
+            clear_count: 20,
+            difficulty: 8,
+            asset_style_id: None,
+            asset_style_label: None,
+            asset_style_prompt: None,
+        });
+
+        assert_eq!(config.clear_count, MATCH3D_GENERATED_ITEM_COUNT_MVP);
+        assert_eq!(config.difficulty, 8);
+    }
+
     #[test]
     fn match3d_domain_click_bridge_clears_three_items() {
         let snapshot = Match3DRunSnapshot {
diff --git a/server-rs/crates/spacetime-module/src/match3d/tables.rs b/server-rs/crates/spacetime-module/src/match3d/tables.rs
index 2c9ece38..950432cd 100644
--- a/server-rs/crates/spacetime-module/src/match3d/tables.rs
+++ b/server-rs/crates/spacetime-module/src/match3d/tables.rs
@@ -58,6 +58,8 @@ pub struct Match3DWorkProfileRow {
     pub(crate) play_count: u32,
     pub(crate) updated_at: Timestamp,
     pub(crate) published_at: Option<Timestamp>,
+    #[default(None::<String>)]
+    pub(crate) generated_item_assets_json: Option<String>,
 }
 
 #[spacetimedb::table(
diff --git a/server-rs/crates/spacetime-module/src/match3d/types.rs b/server-rs/crates/spacetime-module/src/match3d/types.rs
index 17d6dbf2..8f58d230 100644
--- a/server-rs/crates/spacetime-module/src/match3d/types.rs
+++ b/server-rs/crates/spacetime-module/src/match3d/types.rs
@@ -89,6 +89,7 @@ pub struct Match3DDraftCompileInput {
     pub cover_image_src: Option<String>,
     pub cover_asset_id: Option<String>,
     pub compiled_at_micros: i64,
+    pub generated_item_assets_json: Option<String>,
 }
 
 #[derive(Clone, Debug, PartialEq, Eq, SpacetimeType)]
@@ -223,6 +224,12 @@ pub struct Match3DCreatorConfigSnapshot {
     pub reference_image_src: Option<String>,
     pub clear_count: u32,
     pub difficulty: u32,
+    #[serde(default)]
+    pub asset_style_id: Option<String>,
+    #[serde(default)]
+    pub asset_style_label: Option<String>,
+    #[serde(default)]
+    pub asset_style_prompt: Option<String>,
 }
 
 #[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
@@ -287,6 +294,7 @@ pub struct Match3DWorkSnapshot {
     pub play_count: u32,
     pub updated_at_micros: i64,
     pub published_at_micros: Option<i64>,
+    pub generated_item_assets_json: Option<String>,
 }
 
 #[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
diff --git a/server-rs/crates/spacetime-module/src/migration.rs b/server-rs/crates/spacetime-module/src/migration.rs
index f6e5d033..26a81483 100644
--- a/server-rs/crates/spacetime-module/src/migration.rs
+++ b/server-rs/crates/spacetime-module/src/migration.rs
@@ -1134,6 +1134,10 @@ fn normalize_migration_row(table_name: &str, value: &serde_json::Value) -> serde
             object
                 .entry("avatar_url".to_string())
                 .or_insert(serde_json::Value::Null);
+            // 中文注释：账号标签字段晚于认证表加入，旧迁移包默认无标签。
+            object
+                .entry("user_tags".to_string())
+                .or_insert_with(|| serde_json::Value::Array(Vec::new()));
         }
     }
     if table_name == "profile_invite_code" {
@@ -1142,6 +1146,10 @@ fn normalize_migration_row(table_name: &str, value: &serde_json::Value) -> serde
             object
                 .entry("metadata_json".to_string())
                 .or_insert_with(|| serde_json::Value::String("{}".to_string()));
+            // 中文注释：邀请码授予标签字段晚于邀请表加入，旧迁移包默认不授予标签。
+            object
+                .entry("granted_user_tags".to_string())
+                .or_insert_with(|| serde_json::Value::Array(Vec::new()));
         }
     }
     if table_name == "big_fish_creation_session" {
@@ -1214,6 +1222,14 @@ fn normalize_migration_row(table_name: &str, value: &serde_json::Value) -> serde
                 .or_insert(fallback_description);
         }
     }
+    if table_name == "match3d_work_profile" {
+        if let Some(object) = next_value.as_object_mut() {
+            // 中文注释：抓大鹅生成素材字段晚于基础作品表加入，旧迁移包按未生成素材兼容。
+            object
+                .entry("generated_item_assets_json".to_string())
+                .or_insert(serde_json::Value::Null);
+        }
+    }
     next_value
 }
 
diff --git a/server-rs/crates/spacetime-module/src/puzzle.rs b/server-rs/crates/spacetime-module/src/puzzle.rs
index 80d25702..887d9f37 100644
--- a/server-rs/crates/spacetime-module/src/puzzle.rs
+++ b/server-rs/crates/spacetime-module/src/puzzle.rs
@@ -3218,6 +3218,13 @@ fn list_puzzle_leaderboard_entries(
         .take(limit)
         .enumerate()
         .map(|(index, row)| PuzzleLeaderboardEntry {
+            visible_tags: ctx
+                .db
+                .user_account()
+                .user_id()
+                .find(&row.user_id)
+                .map(|account| visible_runtime_profile_user_tags(&account.user_tags))
+                .unwrap_or_default(),
             rank: index as u32 + 1,
             nickname: row.nickname,
             elapsed_ms: row.best_elapsed_ms,
@@ -3483,12 +3490,14 @@ mod tests {
                 rank: 0,
                 nickname: "玩家 B".to_string(),
                 elapsed_ms: 5200,
+                visible_tags: Vec::new(),
                 is_current_player: false,
             },
             PuzzleLeaderboardEntry {
                 rank: 0,
                 nickname: "玩家 A".to_string(),
                 elapsed_ms: 3100,
+                visible_tags: Vec::new(),
                 is_current_player: true,
             },
         ];
diff --git a/server-rs/crates/spacetime-module/src/runtime/profile.rs b/server-rs/crates/spacetime-module/src/runtime/profile.rs
index 2aa624ba..ee8389c9 100644
--- a/server-rs/crates/spacetime-module/src/runtime/profile.rs
+++ b/server-rs/crates/spacetime-module/src/runtime/profile.rs
@@ -191,6 +191,8 @@ pub struct ProfileInviteCode {
     pub(crate) starts_at: Option<Timestamp>,
     #[default(None::<Timestamp>)]
     pub(crate) expires_at: Option<Timestamp>,
+    #[default(Vec::<String>::new())]
+    pub(crate) granted_user_tags: Vec<String>,
 }
 
 #[spacetimedb::table(
@@ -2031,6 +2033,16 @@ fn redeem_profile_referral_invite_code_record(
     let invitee_user_id = validated_input.user_id;
     let invite_code = validated_input.invite_code;
 
+    if ctx
+        .db
+        .user_account()
+        .user_id()
+        .find(&invitee_user_id)
+        .is_none()
+    {
+        return Err("用户不存在".to_string());
+    }
+
     if ctx
         .db
         .profile_referral_relation()
@@ -2051,6 +2063,7 @@ fn redeem_profile_referral_invite_code_record(
     if inviter_code.user_id == invitee_user_id {
         return Err("不能填写自己的邀请码".to_string());
     }
+    let granted_user_tags = inviter_code.granted_user_tags.clone();
 
     let invitee_balance_after = apply_profile_wallet_delta(
         ctx,
@@ -2097,6 +2110,7 @@ fn redeem_profile_referral_invite_code_record(
             invitee_reward_granted: true,
             bound_at,
         });
+    merge_user_account_tags(ctx, &invitee_user_id, granted_user_tags)?;
 
     Ok(RuntimeReferralRedeemSnapshot {
         center: build_profile_referral_invite_center_snapshot(ctx, &invitee_user_id),
@@ -2270,6 +2284,7 @@ fn admin_upsert_profile_invite_code_record(
         input.admin_user_id,
         input.invite_code,
         input.metadata_json,
+        input.granted_user_tags,
         input.starts_at_micros,
         input.expires_at_micros,
         input.updated_at_micros,
@@ -2306,6 +2321,7 @@ fn admin_upsert_profile_invite_code_record(
             expires_at: validated_input
                 .expires_at_micros
                 .map(Timestamp::from_micros_since_unix_epoch),
+            granted_user_tags: validated_input.granted_user_tags,
         });
         return Ok(build_profile_invite_code_snapshot_from_row(&inserted));
     }
@@ -2322,6 +2338,7 @@ fn admin_upsert_profile_invite_code_record(
         expires_at: validated_input
             .expires_at_micros
             .map(Timestamp::from_micros_since_unix_epoch),
+        granted_user_tags: validated_input.granted_user_tags,
     });
     Ok(build_profile_invite_code_snapshot_from_row(&inserted))
 }
@@ -2448,9 +2465,33 @@ fn ensure_profile_invite_code(ctx: &ReducerContext, user_id: &str) -> ProfileInv
         updated_at: ctx.timestamp,
         starts_at: None,
         expires_at: None,
+        granted_user_tags: Vec::new(),
     })
 }
 
+fn merge_user_account_tags(
+    ctx: &ReducerContext,
+    user_id: &str,
+    granted_tags: Vec<String>,
+) -> Result<(), String> {
+    let granted_tags =
+        normalize_profile_user_tags(granted_tags).map_err(|error| error.to_string())?;
+    if granted_tags.is_empty() {
+        return Ok(());
+    }
+
+    let Some(mut account) = ctx.db.user_account().user_id().find(&user_id.to_string()) else {
+        return Err("用户不存在".to_string());
+    };
+
+    account.user_tags.extend(granted_tags);
+    account.user_tags =
+        normalize_profile_user_tags(account.user_tags).map_err(|error| error.to_string())?;
+    ctx.db.user_account().user_id().delete(&account.user_id);
+    ctx.db.user_account().insert(account);
+    Ok(())
+}
+
 fn validate_profile_invite_code_redeem_time(
     invite_code: &ProfileInviteCode,
     now_micros: i64,
@@ -3475,6 +3516,7 @@ fn build_profile_invite_code_snapshot_from_row(
         user_id: row.user_id.clone(),
         invite_code: row.invite_code.clone(),
         metadata_json: row.metadata_json.clone(),
+        granted_user_tags: row.granted_user_tags.clone(),
         starts_at_micros: row
             .starts_at
             .map(|value| value.to_micros_since_unix_epoch()),
diff --git a/src/components/match3d-creation/Match3DAgentWorkspace.interaction.test.tsx b/src/components/match3d-creation/Match3DAgentWorkspace.interaction.test.tsx
new file mode 100644
index 00000000..bcbef695
--- /dev/null
+++ b/src/components/match3d-creation/Match3DAgentWorkspace.interaction.test.tsx
@@ -0,0 +1,170 @@
+/* @vitest-environment jsdom */
+
+import { fireEvent, render, screen } from '@testing-library/react';
+import { expect, test, vi } from 'vitest';
+
+import type { Match3DAgentSessionSnapshot } from '../../../packages/shared/src/contracts/match3dAgent';
+import { Match3DAgentWorkspace } from './Match3DAgentWorkspace';
+
+const baseSession: Match3DAgentSessionSnapshot = {
+  sessionId: 'match3d-session-1',
+  currentTurn: 0,
+  progressPercent: 0,
+  stage: 'collecting_config',
+  anchorPack: {
+    theme: {
+      key: 'theme',
+      label: '题材主题',
+      value: '水果摊',
+      status: 'confirmed',
+    },
+    clearCount: {
+      key: 'clearCount',
+      label: '需要消除次数',
+      value: '8',
+      status: 'confirmed',
+    },
+    difficulty: {
+      key: 'difficulty',
+      label: '难度',
+      value: '3',
+      status: 'confirmed',
+    },
+  },
+  config: {
+    themeText: '水果摊',
+    referenceImageSrc: null,
+    clearCount: 8,
+    difficulty: 3,
+    assetStyleId: 'low-poly',
+    assetStyleLabel: '低多边形',
+    assetStylePrompt:
+      '块面清晰、轮廓简洁、颜色分区明确的低多边形 3D 素材风格。',
+  },
+  draft: null,
+  messages: [
+    {
+      id: 'message-1',
+      role: 'assistant',
+      kind: 'chat',
+      text: '旧会话固定追问不再作为主入口。',
+      createdAt: '2026-05-10T10:00:00.000Z',
+    },
+  ],
+  lastAssistantReply: '旧会话固定追问不再作为主入口。',
+  publishedProfileId: null,
+  updatedAt: '2026-05-10T10:00:00.000Z',
+};
+
+test('match3d workspace submits derived entry form payload instead of agent chat', () => {
+  const onCreateFromForm = vi.fn();
+  const onExecuteAction = vi.fn();
+
+  render(
+    <Match3DAgentWorkspace
+      session={null}
+      onBack={() => {}}
+      onExecuteAction={onExecuteAction}
+      onCreateFromForm={onCreateFromForm}
+    />,
+  );
+
+  expect(screen.getByText('想做个什么玩法？')).toBeTruthy();
+  expect(screen.getByLabelText('想做一个什么题材的抓大鹅？')).toBeTruthy();
+  expect(screen.getByText('3D素材风格')).toBeTruthy();
+  expect(screen.getByRole('button', { name: '黏土手作' })).toBeTruthy();
+  expect(screen.getByRole('button', { name: '自定义' })).toBeTruthy();
+  expect(screen.getByText('消耗20光点')).toBeTruthy();
+  expect(screen.queryByText('参考图')).toBeNull();
+  expect(screen.queryByLabelText('上传抓大鹅参考图')).toBeNull();
+  expect(screen.queryByLabelText('需要消除次数')).toBeNull();
+  expect(screen.queryByLabelText('难度数值')).toBeNull();
+  expect(screen.queryByText('物品')).toBeNull();
+  expect(screen.queryByText('旧会话固定追问不再作为主入口。')).toBeNull();
+
+  fireEvent.change(screen.getByLabelText('想做一个什么题材的抓大鹅？'), {
+    target: { value: '赛博水果摊' },
+  });
+  fireEvent.click(screen.getByRole('button', { name: '进阶' }));
+  fireEvent.click(screen.getByRole('button', { name: /生成抓大鹅草稿/u }));
+
+  expect(onCreateFromForm).toHaveBeenCalledWith({
+    seedText: '赛博水果摊题材，消除16次，难度6',
+    themeText: '赛博水果摊',
+    referenceImageSrc: null,
+    clearCount: 16,
+    difficulty: 6,
+    assetStyleId: 'clay-toy',
+    assetStyleLabel: '黏土手作',
+    assetStylePrompt: '圆润、哑光、带轻微手捏痕迹的黏土手作 3D 素材风格。',
+  });
+  expect(onExecuteAction).not.toHaveBeenCalled();
+});
+
+test('match3d workspace supports custom 3d asset style prompt', () => {
+  const onCreateFromForm = vi.fn();
+
+  render(
+    <Match3DAgentWorkspace
+      session={null}
+      onBack={() => {}}
+      onExecuteAction={() => {}}
+      onCreateFromForm={onCreateFromForm}
+    />,
+  );
+
+  fireEvent.change(screen.getByLabelText('想做一个什么题材的抓大鹅？'), {
+    target: { value: '海底甜品店' },
+  });
+  fireEvent.click(screen.getByRole('button', { name: '自定义' }));
+
+  expect(screen.getByRole('dialog', { name: '自定义风格' })).toBeTruthy();
+  fireEvent.change(screen.getByLabelText('自定义3D素材风格描述'), {
+    target: { value: '透明果冻材质，边缘有柔和蓝色荧光' },
+  });
+  fireEvent.click(screen.getByRole('button', { name: '应用' }));
+  fireEvent.click(screen.getByRole('button', { name: /生成抓大鹅草稿/u }));
+
+  expect(onCreateFromForm).toHaveBeenCalledWith(
+    expect.objectContaining({
+      seedText: '海底甜品店题材，消除12次，难度4',
+      themeText: '海底甜品店',
+      clearCount: 12,
+      difficulty: 4,
+      assetStyleId: 'custom',
+      assetStyleLabel: '自定义风格',
+      assetStylePrompt: '透明果冻材质，边缘有柔和蓝色荧光',
+    }),
+  );
+});
+
+test('match3d workspace falls back to compile action when restored from the legacy route', () => {
+  const onExecuteAction = vi.fn();
+
+  render(
+    <Match3DAgentWorkspace
+      session={baseSession}
+      onBack={() => {}}
+      onExecuteAction={onExecuteAction}
+    />,
+  );
+
+  expect(
+    (screen.getByLabelText('想做一个什么题材的抓大鹅？') as HTMLTextAreaElement)
+      .value,
+  ).toBe('水果摊');
+  expect(
+    screen.getByRole('button', { name: '轻松' }).getAttribute('aria-pressed'),
+  ).toBe('true');
+  expect(
+    screen.getByRole('button', { name: '低多边形' }).getAttribute(
+      'aria-pressed',
+    ),
+  ).toBe('true');
+
+  fireEvent.click(screen.getByRole('button', { name: /生成抓大鹅草稿/u }));
+
+  expect(onExecuteAction).toHaveBeenCalledWith({
+    action: 'match3d_compile_draft',
+  });
+});
diff --git a/src/components/match3d-creation/Match3DAgentWorkspace.tsx b/src/components/match3d-creation/Match3DAgentWorkspace.tsx
index 0c97e905..a4a43e75 100644
--- a/src/components/match3d-creation/Match3DAgentWorkspace.tsx
+++ b/src/components/match3d-creation/Match3DAgentWorkspace.tsx
@@ -1,214 +1,531 @@
-import { useState } from 'react';
+import { Loader2, Sparkles, WandSparkles, X } from 'lucide-react';
+import { useEffect, useMemo, useRef, useState } from 'react';
 
 import type {
+  CreateMatch3DSessionRequest,
   ExecuteMatch3DActionRequest,
   Match3DAgentSessionSnapshot,
-  Match3DAnchorItemResponse,
   SendMatch3DMessageRequest,
 } from '../../../packages/shared/src/contracts/match3dAgent';
-import {
-  buildCreationAgentChatMessage,
-  createCreationAgentChatQuickActions,
-  createCreationAgentClientMessageId,
-  resolveCreationAgentQuickActionMessage,
-} from '../../services/creation-agent';
-import {
-  type CreationAgentAnchorView,
-  type CreationAgentSessionView,
-  type CreationAgentTheme,
-  CreationAgentWorkspace,
-} from '../creation-agent';
 
 type Match3DAgentWorkspaceProps = {
   session: Match3DAgentSessionSnapshot | null;
-  streamingReplyText?: string;
-  isStreamingReply?: boolean;
   isBusy?: boolean;
   error?: string | null;
   onBack: () => void;
-  onSubmitMessage: (payload: SendMatch3DMessageRequest) => void;
+  onSubmitMessage?: (payload: SendMatch3DMessageRequest) => void;
   onExecuteAction: (payload: ExecuteMatch3DActionRequest) => void;
+  onCreateFromForm?: (payload: CreateMatch3DSessionRequest) => void;
+  initialFormPayload?: CreateMatch3DSessionRequest | null;
+  showBackButton?: boolean;
+  title?: string | null;
 };
 
-type Match3DReferenceImageState = {
-  src: string;
-  label: string;
+type Match3DFormState = {
+  themeText: string;
+  difficultyOptionId: Match3DDifficultyOptionId;
+  assetStyleId: Match3DAssetStyleOptionId;
+  customAssetStylePrompt: string;
 };
 
-const MATCH3D_AGENT_THEME: CreationAgentTheme = {
-  accentTextClass: 'text-lime-100/86',
-  accentBgClass: 'bg-lime-200',
-  accentButtonClass: 'bg-lime-200 shadow-emerald-950/20',
-  userBubbleClass: 'bg-emerald-600 text-white',
-  heroClass:
-    'border border-lime-100/18 bg-[radial-gradient(circle_at_top_left,rgba(190,242,100,0.24),transparent_34%),radial-gradient(circle_at_bottom_right,rgba(251,146,60,0.2),transparent_32%),linear-gradient(135deg,rgba(20,83,45,0.96),rgba(39,39,42,0.96))]',
-  anchorGridClass: 'grid gap-2 sm:grid-cols-3',
+const EMPTY_FORM_STATE: Match3DFormState = {
+  themeText: '',
+  difficultyOptionId: 'standard',
+  assetStyleId: 'clay-toy',
+  customAssetStylePrompt: '',
 };
 
-const MATCH3D_QUICK_ACTIONS = [
-  ...createCreationAgentChatQuickActions(),
+// 中文注释：入口页只暴露难度选项，消除次数和难度数值由选项稳定派生给后端。
+const MATCH3D_DIFFICULTY_OPTIONS = [
+  { id: 'easy', label: '轻松', clearCount: 8, difficulty: 2 },
+  { id: 'standard', label: '标准', clearCount: 12, difficulty: 4 },
+  { id: 'advanced', label: '进阶', clearCount: 16, difficulty: 6 },
+  { id: 'hardcore', label: '硬核', clearCount: 20, difficulty: 8 },
+] as const;
+
+type Match3DDifficultyOptionId =
+  (typeof MATCH3D_DIFFICULTY_OPTIONS)[number]['id'];
+
+const MATCH3D_ASSET_STYLE_OPTIONS = [
   {
-    key: 'match3d-auto-config',
-    label: '自动配置',
+    id: 'clay-toy',
+    label: '黏土手作',
+    imageSrc: '/match3d-style-references/clay-toy.png',
+    prompt: '圆润、哑光、带轻微手捏痕迹的黏土手作 3D 素材风格。',
   },
-];
+  {
+    id: 'low-poly',
+    label: '低多边形',
+    imageSrc: '/match3d-style-references/low-poly.png',
+    prompt: '块面清晰、轮廓简洁、颜色分区明确的低多边形 3D 素材风格。',
+  },
+  {
+    id: 'toy-plastic',
+    label: '玩具塑料',
+    imageSrc: '/match3d-style-references/toy-plastic.png',
+    prompt: '亮面、光滑、有柔和高光的玩具塑料 3D 素材风格。',
+  },
+  {
+    id: 'wood-carved',
+    label: '木质雕刻',
+    imageSrc: '/match3d-style-references/wood-carved.png',
+    prompt: '保留木纹和手工雕刻感的温润木质 3D 素材风格。',
+  },
+  {
+    id: 'voxel-block',
+    label: '体素积木',
+    imageSrc: '/match3d-style-references/voxel-block.png',
+    prompt: '由小方块构成、边缘清晰、带游戏感的体素积木 3D 素材风格。',
+  },
+  {
+    id: 'metal-mecha',
+    label: '金属机甲',
+    imageSrc: '/match3d-style-references/metal-mecha.png',
+    prompt: '带金属拉丝、柔和高光和轻科幻感的金属机甲 3D 素材风格。',
+  },
+  {
+    id: 'custom',
+    label: '自定义',
+    imageSrc: null,
+    prompt: '',
+  },
+] as const;
 
-function readMatch3DReferenceImageAsDataUrl(file: File) {
-  return new Promise<string>((resolve, reject) => {
-    if (!file.type.startsWith('image/')) {
-      reject(new Error('请选择图片文件。'));
-      return;
-    }
+type Match3DAssetStyleOptionId =
+  (typeof MATCH3D_ASSET_STYLE_OPTIONS)[number]['id'];
 
-    const reader = new FileReader();
-    reader.onerror = () => reject(new Error('参考图读取失败，请重试。'));
-    reader.onload = () => resolve(String(reader.result || ''));
-    reader.readAsDataURL(file);
-  });
+function normalizeDifficulty(value: number) {
+  return Math.max(1, Math.min(10, Math.round(value)));
 }
 
-function mapMatch3DAnchor(
-  anchor: Match3DAnchorItemResponse,
-): CreationAgentAnchorView {
-  return {
-    key: anchor.key,
-    label: anchor.label,
-    value: anchor.value,
-    status: anchor.status,
-  };
-}
-
-function mapMatch3DSession(
-  session: Match3DAgentSessionSnapshot,
-): CreationAgentSessionView {
-  // 中文注释：抓大鹅 F1 只展示聊天与配置锚点，草稿结果交给后续结果页承接。
-  const chatMessages = session.messages.filter(
-    (message) =>
-      message.kind === 'chat' ||
-      message.kind === 'summary' ||
-      message.kind === 'warning',
+function resolveDifficultyOptionId(
+  difficulty: number | null | undefined,
+  clearCount: number | null | undefined,
+): Match3DDifficultyOptionId {
+  const clearCountMatchedOption = MATCH3D_DIFFICULTY_OPTIONS.find(
+    (option) => option.clearCount === clearCount,
   );
+  if (clearCountMatchedOption) {
+    return clearCountMatchedOption.id;
+  }
+
+  if (typeof difficulty !== 'number' || !Number.isFinite(difficulty)) {
+    return 'standard';
+  }
+
+  const normalizedDifficulty = normalizeDifficulty(Number(difficulty));
+  return MATCH3D_DIFFICULTY_OPTIONS.reduce(
+    (nearestOption, option) =>
+      Math.abs(option.difficulty - normalizedDifficulty) <
+      Math.abs(nearestOption.difficulty - normalizedDifficulty)
+        ? option
+        : nearestOption,
+    MATCH3D_DIFFICULTY_OPTIONS[1],
+  ).id;
+}
+
+function getDifficultyOption(optionId: Match3DDifficultyOptionId) {
+  return (
+    MATCH3D_DIFFICULTY_OPTIONS.find((option) => option.id === optionId) ??
+    MATCH3D_DIFFICULTY_OPTIONS[1]
+  );
+}
+
+function getAssetStyleOption(optionId: Match3DAssetStyleOptionId) {
+  return (
+    MATCH3D_ASSET_STYLE_OPTIONS.find((option) => option.id === optionId) ??
+    MATCH3D_ASSET_STYLE_OPTIONS[0]
+  );
+}
+
+function resolveAssetStyleOptionId(
+  assetStyleId: string | null | undefined,
+  assetStylePrompt: string | null | undefined,
+): Match3DAssetStyleOptionId {
+  const matchedOption = MATCH3D_ASSET_STYLE_OPTIONS.find(
+    (option) => option.id === assetStyleId,
+  );
+  if (matchedOption) {
+    return matchedOption.id;
+  }
+
+  return assetStylePrompt?.trim() ? 'custom' : 'clay-toy';
+}
+
+function resolveInitialFormState(
+  session: Match3DAgentSessionSnapshot | null,
+  initialFormPayload: CreateMatch3DSessionRequest | null = null,
+): Match3DFormState {
+  const config = session?.config;
+  const themeText =
+    initialFormPayload?.themeText?.trim() ||
+    config?.themeText?.trim() ||
+    session?.anchorPack.theme.value?.trim() ||
+    initialFormPayload?.seedText?.trim() ||
+    '';
+  const clearCount =
+    initialFormPayload?.clearCount ??
+    config?.clearCount ??
+    null;
+  const difficulty =
+    initialFormPayload?.difficulty ??
+    config?.difficulty ??
+    null;
+  const assetStyleId =
+    initialFormPayload?.assetStyleId ??
+    config?.assetStyleId ??
+    null;
+  const assetStylePrompt =
+    initialFormPayload?.assetStylePrompt ??
+    config?.assetStylePrompt ??
+    '';
 
   return {
-    sessionId: session.sessionId,
-    title: null,
-    assistantSummary: null,
-    currentTurn: session.currentTurn,
-    progressPercent: session.progressPercent,
-    anchors: [
-      session.anchorPack.theme,
-      session.anchorPack.clearCount,
-      session.anchorPack.difficulty,
-    ].map(mapMatch3DAnchor),
-    messages: chatMessages,
-    recommendedReplies: [],
+    ...EMPTY_FORM_STATE,
+    themeText,
+    difficultyOptionId: resolveDifficultyOptionId(difficulty, clearCount),
+    assetStyleId: resolveAssetStyleOptionId(assetStyleId, assetStylePrompt),
+    customAssetStylePrompt: assetStylePrompt,
   };
 }
 
-function buildMatch3DChatPayload({
-  text,
-  quickFillRequested = false,
-  referenceImageSrc,
-}: {
-  text: string;
-  quickFillRequested?: boolean;
-  referenceImageSrc?: string | null;
-}) {
-  return buildCreationAgentChatMessage<{
-    referenceImageSrc?: string | null;
-  }>({
-    clientMessageId: createCreationAgentClientMessageId('match3d'),
-    text,
-    quickFillRequested,
-    extraPayload: {
-      referenceImageSrc: referenceImageSrc || null,
-    },
-  });
-}
-
+/**
+ * 抓大鹅创作入口已从固定 Agent 追问改成表单式。
+ * 组件名保留为 Match3DAgentWorkspace，兼容现有路由、草稿恢复和父层分流。
+ */
 export function Match3DAgentWorkspace({
   session,
-  streamingReplyText = '',
-  isStreamingReply = false,
   isBusy = false,
   error = null,
   onBack,
-  onSubmitMessage,
   onExecuteAction,
+  onCreateFromForm,
+  initialFormPayload = null,
+  showBackButton = true,
+  title = '想做个什么玩法？',
 }: Match3DAgentWorkspaceProps) {
-  const [referenceImage, setReferenceImage] =
-    useState<Match3DReferenceImageState | null>(null);
-  const [referenceImageError, setReferenceImageError] = useState<string | null>(
-    null,
+  const [formState, setFormState] = useState<Match3DFormState>(() =>
+    resolveInitialFormState(session, initialFormPayload),
+  );
+  const [isCustomStylePanelOpen, setIsCustomStylePanelOpen] = useState(false);
+  const [draftCustomStylePrompt, setDraftCustomStylePrompt] = useState('');
+  const appliedInitialFormKeyRef = useRef<string | null>(null);
+
+  useEffect(() => {
+    const nextInitialFormKey =
+      session?.sessionId ?? JSON.stringify(initialFormPayload ?? null);
+    if (appliedInitialFormKeyRef.current === nextInitialFormKey) {
+      return;
+    }
+
+    appliedInitialFormKeyRef.current = nextInitialFormKey;
+    setFormState(resolveInitialFormState(session, initialFormPayload));
+    setIsCustomStylePanelOpen(false);
+    setDraftCustomStylePrompt('');
+  }, [initialFormPayload, session]);
+
+  const themeText = formState.themeText.trim();
+  const selectedDifficultyOption = getDifficultyOption(
+    formState.difficultyOptionId,
+  );
+  const selectedAssetStyleOption = getAssetStyleOption(formState.assetStyleId);
+  const assetStylePrompt =
+    formState.assetStyleId === 'custom'
+      ? formState.customAssetStylePrompt.trim()
+      : selectedAssetStyleOption.prompt;
+  const assetStyleLabel =
+    formState.assetStyleId === 'custom'
+      ? '自定义风格'
+      : selectedAssetStyleOption.label;
+  const canSubmit = Boolean(
+    themeText &&
+      !isBusy &&
+      (formState.assetStyleId !== 'custom' ||
+        formState.customAssetStylePrompt.trim()),
+  );
+  const formPayload = useMemo<CreateMatch3DSessionRequest>(
+    () => ({
+      seedText: themeText
+        ? `${themeText}题材，消除${selectedDifficultyOption.clearCount}次，难度${selectedDifficultyOption.difficulty}`
+        : themeText,
+      themeText,
+      referenceImageSrc: null,
+      clearCount: selectedDifficultyOption.clearCount,
+      difficulty: selectedDifficultyOption.difficulty,
+      assetStyleId: formState.assetStyleId,
+      assetStyleLabel,
+      assetStylePrompt,
+    }),
+    [
+      assetStyleLabel,
+      assetStylePrompt,
+      formState.assetStyleId,
+      selectedDifficultyOption,
+      themeText,
+    ],
   );
 
-  return (
-    <CreationAgentWorkspace
-      session={session ? mapMatch3DSession(session) : null}
-      theme={MATCH3D_AGENT_THEME}
-      loadingText="正在准备抓大鹅共创工作区..."
-      composerPlaceholder="题材、消除次数、难度..."
-      primaryActionLabel="生成结果页"
-      streamingReplyText={streamingReplyText}
-      isStreamingReply={isStreamingReply}
-      isBusy={isBusy}
-      error={error}
-      quickActions={MATCH3D_QUICK_ACTIONS}
-      referenceImagePreviewSrc={referenceImage?.src ?? null}
-      referenceImageLabel={referenceImage?.label ?? null}
-      referenceImageError={referenceImageError}
-      onBack={onBack}
-      onSubmitText={(text) => {
-        onSubmitMessage(
-          buildMatch3DChatPayload({
-            text,
-            referenceImageSrc: referenceImage?.src ?? null,
-          }),
-        );
-      }}
-      onPrimaryAction={() => {
-        onExecuteAction({ action: 'match3d_compile_draft' });
-      }}
-      onQuickAction={(action) => {
-        const quickActionMessage =
-          action.key === 'match3d-auto-config'
-            ? {
-                text: '自动配置',
-                quickFillRequested: true,
-              }
-            : resolveCreationAgentQuickActionMessage(
-                action.key,
-                '请总结一下当前抓大鹅设定。',
-              );
+  const openCustomStylePanel = () => {
+    setDraftCustomStylePrompt(formState.customAssetStylePrompt);
+    setIsCustomStylePanelOpen(true);
+  };
 
-        onSubmitMessage(
-          buildMatch3DChatPayload({
-            ...quickActionMessage,
-            referenceImageSrc: referenceImage?.src ?? null,
-          }),
-        );
-      }}
-      onReferenceImageChange={async (file) => {
-        try {
-          const dataUrl = await readMatch3DReferenceImageAsDataUrl(file);
-          setReferenceImage({
-            src: dataUrl,
-            label: file.name.trim() || '本地参考图',
-          });
-          setReferenceImageError(null);
-        } catch (caughtError) {
-          setReferenceImageError(
-            caughtError instanceof Error
-              ? caughtError.message
-              : '参考图读取失败，请重试。',
-          );
-        }
-      }}
-      onClearReferenceImage={() => {
-        setReferenceImage(null);
-        setReferenceImageError(null);
-      }}
-    />
+  const applyCustomStylePrompt = () => {
+    setFormState((current) => ({
+      ...current,
+      assetStyleId: 'custom',
+      customAssetStylePrompt: draftCustomStylePrompt.trim(),
+    }));
+    setIsCustomStylePanelOpen(false);
+  };
+
+  const submitForm = () => {
+    if (!canSubmit) {
+      return;
+    }
+
+    if (onCreateFromForm) {
+      onCreateFromForm(formPayload);
+      return;
+    }
+
+    if (session) {
+      onExecuteAction({ action: 'match3d_compile_draft' });
+    }
+  };
+
+  return (
+    <div className="platform-remap-surface mx-auto flex h-full min-h-0 w-full max-w-5xl flex-col overflow-hidden">
+      {showBackButton ? (
+        <div className="mb-3 flex shrink-0 items-center justify-between gap-3 sm:mb-4">
+          <button
+            type="button"
+            onClick={onBack}
+            disabled={isBusy}
+            className={`platform-button platform-button--ghost min-h-0 self-start px-3 py-1.5 text-[11px] ${isBusy ? 'opacity-45' : ''}`}
+          >
+            返回
+          </button>
+        </div>
+      ) : null}
+
+      <div className="flex min-h-0 flex-1 flex-col overflow-hidden pr-0">
+        {title ? (
+          <div className="mb-3 shrink-0 sm:mb-5">
+            <div className="flex flex-wrap items-center gap-2">
+              <h1 className="m-0 text-3xl font-black leading-none tracking-normal text-[var(--platform-text-strong)] sm:text-7xl">
+                {title}
+              </h1>
+              <span className="rounded-full border border-emerald-200 bg-emerald-50 px-3 py-1 text-[11px] font-black text-emerald-700">
+                BETA
+              </span>
+            </div>
+          </div>
+        ) : null}
+
+        <section className="flex min-h-0 flex-1 flex-col overflow-hidden">
+          <div
+            className={`grid min-h-0 flex-1 grid-rows-[minmax(0,1fr)_auto] gap-2 sm:gap-3 lg:grid-cols-[minmax(0,1.1fr)_minmax(16rem,0.9fr)] lg:grid-rows-1 ${isBusy ? 'opacity-55' : ''}`}
+          >
+            <label className="block min-h-0">
+              <span className="mb-2 block text-sm font-black text-[var(--platform-text-strong)]">
+                想做一个什么题材的抓大鹅？
+              </span>
+              <textarea
+                value={formState.themeText}
+                disabled={isBusy}
+                rows={5}
+                placeholder=""
+                onChange={(event) =>
+                  setFormState((current) => ({
+                    ...current,
+                    themeText: event.target.value,
+                  }))
+                }
+                className="h-full min-h-[7.75rem] w-full resize-none rounded-[1.15rem] border border-[var(--platform-subpanel-border)] bg-white/90 px-4 py-3 text-base leading-6 text-[var(--platform-text-strong)] outline-none sm:min-h-[9rem] lg:min-h-[14rem]"
+                aria-label="想做一个什么题材的抓大鹅？"
+              />
+            </label>
+
+            <div className="flex min-h-0 flex-col gap-2 overflow-hidden">
+              <div className="min-h-0">
+                <div className="mb-1.5 text-sm font-black text-[var(--platform-text-strong)]">
+                  3D素材风格
+                </div>
+                <div
+                  className="flex snap-x gap-2 overflow-x-auto overscroll-x-contain pb-1 scrollbar-hide touch-pan-x [-webkit-overflow-scrolling:touch]"
+                  aria-label="3D素材风格"
+                >
+                  {MATCH3D_ASSET_STYLE_OPTIONS.map((option) => {
+                    const selected = formState.assetStyleId === option.id;
+                    const isCustom = option.id === 'custom';
+                    return (
+                      <button
+                        key={option.id}
+                        type="button"
+                        disabled={isBusy}
+                        onClick={() => {
+                          if (isCustom) {
+                            openCustomStylePanel();
+                            return;
+                          }
+                          setFormState((current) => ({
+                            ...current,
+                            assetStyleId: option.id,
+                          }));
+                        }}
+                        className={`relative h-[4.45rem] w-[5.2rem] shrink-0 snap-start overflow-hidden rounded-[0.9rem] border p-0 text-left transition sm:h-[5.2rem] sm:w-[6.1rem] ${
+                          selected
+                            ? 'border-[#ff4056] ring-1 ring-inset ring-[#ff4056]'
+                            : 'border-[var(--platform-subpanel-border)]'
+                        } ${isBusy ? 'cursor-not-allowed opacity-55' : ''}`}
+                        aria-pressed={selected}
+                        aria-label={option.label}
+                      >
+                        {option.imageSrc ? (
+                          <img
+                            src={option.imageSrc}
+                            alt=""
+                            className="absolute inset-0 h-full w-full object-cover"
+                            loading="lazy"
+                          />
+                        ) : (
+                          <span className="absolute inset-0 bg-[linear-gradient(135deg,rgba(255,255,255,0.98),rgba(255,240,244,0.9))]" />
+                        )}
+                        <span className="absolute inset-0 bg-[linear-gradient(180deg,rgba(3,7,18,0.02)_0%,rgba(3,7,18,0.1)_42%,rgba(3,7,18,0.82)_100%)]" />
+                        {isCustom ? (
+                          <span className="absolute inset-0 flex items-center justify-center text-2xl font-black text-[var(--platform-text-strong)]">
+                            +
+                          </span>
+                        ) : null}
+                        <span className="absolute inset-x-2 bottom-1.5 truncate rounded-full bg-black/26 px-1.5 py-0.5 text-center text-[11px] font-black text-white [text-shadow:0_1px_6px_rgba(0,0,0,0.9)]">
+                          {option.label}
+                        </span>
+                      </button>
+                    );
+                  })}
+                </div>
+              </div>
+
+              <div className="shrink-0">
+                <div className="mb-1.5 text-sm font-black text-[var(--platform-text-strong)]">
+                  难度
+                </div>
+                <div className="grid grid-cols-4 gap-1.5 sm:gap-2 lg:grid-cols-2">
+                  {MATCH3D_DIFFICULTY_OPTIONS.map((option) => {
+                    const selected =
+                      formState.difficultyOptionId === option.id;
+                    return (
+                      <button
+                        key={option.id}
+                        type="button"
+                        disabled={isBusy}
+                        onClick={() =>
+                          setFormState((current) => ({
+                            ...current,
+                            difficultyOptionId: option.id,
+                          }))
+                        }
+                        className={`min-h-10 rounded-[0.85rem] border px-2 text-sm font-black transition sm:min-h-11 ${
+                          selected
+                            ? 'border-[#ff4056] bg-[#ff4056] text-white shadow-[0_8px_18px_rgba(255,64,86,0.18)]'
+                            : 'border-[var(--platform-subpanel-border)] bg-white/88 text-[var(--platform-text-strong)]'
+                        } ${isBusy ? 'cursor-not-allowed opacity-55' : ''}`}
+                        aria-pressed={selected}
+                      >
+                        {option.label}
+                      </button>
+                    );
+                  })}
+                </div>
+              </div>
+            </div>
+          </div>
+
+          <div className="mt-2 shrink-0 space-y-3">
+            {error ? (
+              <div className="platform-banner platform-banner--danger rounded-2xl text-sm leading-6">
+                {error}
+              </div>
+            ) : null}
+          </div>
+        </section>
+      </div>
+
+      <div className="mt-2 flex shrink-0 justify-center pb-[max(0.25rem,env(safe-area-inset-bottom))] sm:mt-3">
+        <button
+          type="button"
+          disabled={!canSubmit}
+          onClick={submitForm}
+          className={`platform-button platform-button--primary min-h-10 px-4 py-2 text-sm sm:min-h-11 sm:px-5 ${!canSubmit ? 'cursor-not-allowed opacity-55' : ''}`}
+        >
+          <span className="inline-flex flex-wrap items-center justify-center gap-1.5 sm:gap-2">
+            {isBusy ? <Loader2 className="h-4 w-4 animate-spin" /> : null}
+            {session ? (
+              <Sparkles className="h-4 w-4" />
+            ) : (
+              <WandSparkles className="h-4 w-4" />
+            )}
+            <span>生成抓大鹅草稿</span>
+            <span className="rounded-full bg-white/24 px-2 py-0.5 text-[11px] font-bold">
+              消耗20光点
+            </span>
+          </span>
+        </button>
+      </div>
+
+      {isCustomStylePanelOpen ? (
+        <div className="platform-modal-backdrop fixed inset-0 z-[80] flex items-center justify-center px-4 py-6">
+          <div
+            role="dialog"
+            aria-modal="true"
+            aria-labelledby="match3d-custom-style-title"
+            className="platform-modal-shell platform-remap-surface w-full max-w-sm rounded-[1.35rem] p-5 shadow-[0_24px_70px_rgba(15,23,42,0.22)]"
+          >
+            <div className="flex items-center justify-between gap-3">
+              <div
+                id="match3d-custom-style-title"
+                className="text-base font-black text-[var(--platform-text-strong)]"
+              >
+                自定义风格
+              </div>
+              <button
+                type="button"
+                aria-label="关闭自定义风格"
+                onClick={() => setIsCustomStylePanelOpen(false)}
+                className="platform-profile-icon-button flex h-8 w-8 items-center justify-center rounded-full"
+              >
+                <X className="h-4 w-4" />
+              </button>
+            </div>
+            <textarea
+              value={draftCustomStylePrompt}
+              onChange={(event) => setDraftCustomStylePrompt(event.target.value)}
+              rows={4}
+              className="mt-4 h-[7.5rem] w-full resize-none rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/90 px-4 py-3 text-base leading-6 text-[var(--platform-text-strong)] outline-none"
+              aria-label="自定义3D素材风格描述"
+            />
+            <div className="mt-5 grid grid-cols-2 gap-3">
+              <button
+                type="button"
+                onClick={() => setIsCustomStylePanelOpen(false)}
+                className="platform-button platform-button--secondary justify-center"
+              >
+                取消
+              </button>
+              <button
+                type="button"
+                disabled={!draftCustomStylePrompt.trim()}
+                onClick={applyCustomStylePrompt}
+                className={`platform-button platform-button--primary justify-center ${!draftCustomStylePrompt.trim() ? 'cursor-not-allowed opacity-55' : ''}`}
+              >
+                应用
+              </button>
+            </div>
+          </div>
+        </div>
+      ) : null}
+    </div>
   );
 }
 
diff --git a/src/components/match3d-result/Match3DResultView.test.tsx b/src/components/match3d-result/Match3DResultView.test.tsx
index ecaab07f..104a31a0 100644
--- a/src/components/match3d-result/Match3DResultView.test.tsx
+++ b/src/components/match3d-result/Match3DResultView.test.tsx
@@ -4,6 +4,8 @@ import { fireEvent, render, screen, waitFor } from '@testing-library/react';
 import { afterEach, describe, expect, test, vi } from 'vitest';
 
 import type { Match3DWorkProfile } from '../../../packages/shared/src/contracts/match3dWorks';
+import * as assetReadUrlService from '../../services/assetReadUrlService';
+import * as hyper3dService from '../../services/hyper3dModelGenerationService';
 import * as match3dWorksService from '../../services/match3d-works';
 import { Match3DResultView } from './Match3DResultView';
 
@@ -19,13 +21,44 @@ vi.mock('../ResolvedAssetImage', () => ({
   }) => (src ? <img src={src} alt={alt} className={className} /> : null),
 }));
 
+vi.mock('../../hooks/useResolvedAssetReadUrl', () => ({
+  useResolvedAssetReadUrl: (src?: string | null) => ({
+    resolvedUrl: src?.startsWith('/generated-')
+      ? `https://signed.example.com${src}`
+      : (src ?? ''),
+    isResolving: false,
+    shouldResolve: Boolean(src?.startsWith('/generated-')),
+  }),
+}));
+
+vi.mock('../../services/assetReadUrlService', () => ({
+  readAssetBytes: vi.fn(() =>
+    Promise.resolve(
+      new Response(new Uint8Array([104, 101, 108, 108, 111]), {
+        status: 200,
+        headers: {
+          'Content-Type': 'image/png',
+        },
+      }),
+    ),
+  ),
+}));
+
 vi.mock('../../services/match3d-works', () => ({
   publishMatch3DWork: vi.fn(),
   updateMatch3DWork: vi.fn(),
 }));
 
+vi.mock('../../services/hyper3dModelGenerationService', () => ({
+  getHyper3dDownloads: vi.fn(),
+  getHyper3dTaskStatus: vi.fn(),
+  submitHyper3dImageToModel: vi.fn(),
+  submitHyper3dTextToModel: vi.fn(),
+}));
+
 afterEach(() => {
   vi.clearAllMocks();
+  vi.unstubAllGlobals();
 });
 
 function createProfile(
@@ -100,4 +133,265 @@ describe('Match3DResultView', () => {
     fireEvent.click(publishButton);
     expect(match3dWorksService.publishMatch3DWork).not.toHaveBeenCalled();
   });
+
+  test('结果页提供多 Tab，并能进入 Rodin 3D 素材详情', () => {
+    render(
+      <Match3DResultView
+        profile={createProfile({ themeText: '水果' })}
+        onBack={() => {}}
+        onStartTestRun={() => {}}
+      />,
+    );
+
+    expect(screen.getByRole('button', { name: '作品信息' })).toBeTruthy();
+    expect(screen.getByRole('button', { name: '玩法配置' })).toBeTruthy();
+    fireEvent.click(screen.getByRole('button', { name: '3D素材' }));
+
+    fireEvent.click(screen.getByRole('button', { name: /水果核心物件/u }));
+
+    expect(screen.getByText('素材名称')).toBeTruthy();
+    expect(screen.getByRole('button', { name: '文生模型' })).toBeTruthy();
+    expect(screen.getByRole('button', { name: '图生模型' })).toBeTruthy();
+  });
+
+  test('Rodin 文生模型提交使用 Hyper3D 代理', async () => {
+    vi.mocked(hyper3dService.submitHyper3dTextToModel).mockResolvedValue({
+      ok: true,
+      provider: 'hyper3d-rodin',
+      mode: 'text-to-model',
+      taskUuid: 'task-1',
+      subscriptionKey: 'sub-1',
+      jobUuids: ['job-1'],
+      message: 'submitted',
+      tier: 'Gen-2',
+    });
+
+    render(
+      <Match3DResultView
+        profile={createProfile({ themeText: '水果' })}
+        onBack={() => {}}
+        onStartTestRun={() => {}}
+      />,
+    );
+
+    fireEvent.click(screen.getByRole('button', { name: '3D素材' }));
+    fireEvent.click(screen.getByRole('button', { name: /水果核心物件/u }));
+    fireEvent.click(screen.getByRole('button', { name: '生成' }));
+
+    await waitFor(() => {
+      expect(hyper3dService.submitHyper3dTextToModel).toHaveBeenCalledWith(
+        expect.objectContaining({
+          geometryFileFormat: 'glb',
+          material: 'PBR',
+          meshMode: 'Quad',
+          prompt: expect.stringContaining('水果核心物件'),
+        }),
+      );
+    });
+    await waitFor(() => {
+      expect(screen.getAllByText('排队中').length).toBeGreaterThan(0);
+    });
+  });
+
+  test('Rodin 图生模型没有参考图时阻止提交', async () => {
+    render(
+      <Match3DResultView
+        profile={createProfile({ themeText: '水果' })}
+        onBack={() => {}}
+        onStartTestRun={() => {}}
+      />,
+    );
+
+    fireEvent.click(screen.getByRole('button', { name: '3D素材' }));
+    fireEvent.click(screen.getByRole('button', { name: /水果核心物件/u }));
+    fireEvent.click(screen.getByRole('button', { name: '图生模型' }));
+
+    const generateButton = screen.getByRole('button', { name: '生成' });
+    expect(generateButton).toHaveProperty('disabled', true);
+    expect(hyper3dService.submitHyper3dImageToModel).not.toHaveBeenCalled();
+  });
+
+  test('结果页优先预览生成出来的物品图片和模型文件', () => {
+    render(
+      <Match3DResultView
+        profile={createProfile({
+          clearCount: 3,
+          generatedItemAssets: [
+            {
+              itemId: 'match3d-item-1',
+              itemName: '草莓',
+              imageSrc: '/generated-match3d-assets/session/profile/items/strawberry/image.png',
+              imageObjectKey:
+                'generated-match3d-assets/session/profile/items/strawberry/image.png',
+              modelSrc: '/generated-match3d-assets/session/profile/items/strawberry/model/model.glb',
+              modelObjectKey:
+                'generated-match3d-assets/session/profile/items/strawberry/model/model.glb',
+              modelFileName: 'strawberry.glb',
+              taskUuid: 'task-strawberry',
+              subscriptionKey: 'sub-strawberry',
+              status: 'model_ready',
+              error: null,
+            },
+          ],
+        })}
+        onBack={() => {}}
+        onStartTestRun={() => {}}
+      />,
+    );
+
+    fireEvent.click(screen.getByRole('button', { name: '3D素材' }));
+    fireEvent.click(screen.getByRole('button', { name: /草莓/u }));
+
+    expect(screen.getByDisplayValue('草莓')).toBeTruthy();
+    expect(screen.getAllByText('已完成').length).toBeGreaterThan(0);
+    const modelLink = screen.getByRole('link', { name: /strawberry\.glb/u });
+    expect(modelLink.getAttribute('href')).toBe(
+      'https://signed.example.com/generated-match3d-assets/session/profile/items/strawberry/model/model.glb',
+    );
+  });
+
+  test('草稿阶段仅有切割图片时展示图片已就绪，不要求模型文件', () => {
+    render(
+      <Match3DResultView
+        profile={createProfile({
+          clearCount: 3,
+          generatedItemAssets: [
+            {
+              itemId: 'match3d-item-1',
+              itemName: '草莓',
+              imageSrc: '/generated-match3d-assets/session/profile/items/strawberry/image.png',
+              imageObjectKey:
+                'generated-match3d-assets/session/profile/items/strawberry/image.png',
+              modelSrc: null,
+              modelObjectKey: null,
+              modelFileName: null,
+              taskUuid: null,
+              subscriptionKey: null,
+              status: 'image_ready',
+              error: null,
+            },
+          ],
+        })}
+        onBack={() => {}}
+        onStartTestRun={() => {}}
+      />,
+    );
+
+    fireEvent.click(screen.getByRole('button', { name: '3D素材' }));
+    fireEvent.click(screen.getByRole('button', { name: /草莓/u }));
+
+    expect(screen.getByDisplayValue('草莓')).toBeTruthy();
+    expect(screen.getAllByText('图片已就绪').length).toBeGreaterThan(0);
+    expect(screen.getByText('0 文件')).toBeTruthy();
+    expect(screen.queryByRole('link', { name: /\.glb/u })).toBeNull();
+  });
+
+  test('重进草稿页时从持久化 profile 素材恢复 3D 素材列表', () => {
+    render(
+      <Match3DResultView
+        profile={createProfile({
+          clearCount: 3,
+          generatedItemAssets: [
+            {
+              itemId: 'match3d-item-1',
+              itemName: '草莓',
+              imageSrc:
+                '/generated-match3d-assets/session/profile/items/match3d-item-1-item/image.png',
+              imageObjectKey:
+                'generated-match3d-assets/session/profile/items/match3d-item-1-item/image.png',
+              modelSrc: null,
+              modelObjectKey: null,
+              modelFileName: null,
+              taskUuid: null,
+              subscriptionKey: null,
+              status: 'image_ready',
+              error: null,
+            },
+            {
+              itemId: 'match3d-item-2',
+              itemName: '苹果',
+              imageSrc:
+                '/generated-match3d-assets/session/profile/items/match3d-item-2-item/image.png',
+              imageObjectKey:
+                'generated-match3d-assets/session/profile/items/match3d-item-2-item/image.png',
+              modelSrc: null,
+              modelObjectKey: null,
+              modelFileName: null,
+              taskUuid: null,
+              subscriptionKey: null,
+              status: 'image_ready',
+              error: null,
+            },
+          ],
+        })}
+        draft={null}
+        onBack={() => {}}
+        onStartTestRun={() => {}}
+      />,
+    );
+
+    fireEvent.click(screen.getByRole('button', { name: '3D素材' }));
+
+    expect(screen.getByRole('button', { name: /草莓/u })).toBeTruthy();
+    expect(screen.getByRole('button', { name: /苹果/u })).toBeTruthy();
+    expect(screen.queryByRole('button', { name: /水果核心物件/u })).toBeNull();
+  });
+
+  test('Rodin 图生模型提交前会把 generated 参考图转成 data URL', async () => {
+    vi.mocked(hyper3dService.submitHyper3dImageToModel).mockResolvedValue({
+      ok: true,
+      provider: 'hyper3d-rodin',
+      mode: 'image-to-model',
+      taskUuid: 'task-image',
+      subscriptionKey: 'sub-image',
+      jobUuids: ['job-image'],
+      message: 'submitted',
+      tier: 'Gen-2',
+    });
+    vi.stubGlobal('fetch', vi.fn());
+
+    render(
+      <Match3DResultView
+        profile={createProfile({
+          clearCount: 3,
+          generatedItemAssets: [
+            {
+              itemId: 'match3d-item-1',
+              itemName: '草莓',
+              imageSrc: '/generated-match3d-assets/session/profile/items/match3d-item-1-item/image.png',
+              imageObjectKey:
+                'generated-match3d-assets/session/profile/items/match3d-item-1-item/image.png',
+              modelSrc: null,
+              modelObjectKey: null,
+              modelFileName: null,
+              taskUuid: null,
+              subscriptionKey: null,
+              status: 'image_ready',
+              error: null,
+            },
+          ],
+        })}
+        onBack={() => {}}
+        onStartTestRun={() => {}}
+      />,
+    );
+
+    fireEvent.click(screen.getByRole('button', { name: '3D素材' }));
+    fireEvent.click(screen.getByRole('button', { name: /草莓/u }));
+    fireEvent.click(screen.getByRole('button', { name: '生成' }));
+
+    await waitFor(() => {
+      expect(assetReadUrlService.readAssetBytes).toHaveBeenCalledWith(
+        '/generated-match3d-assets/session/profile/items/match3d-item-1-item/image.png',
+        expect.objectContaining({ expireSeconds: 300 }),
+      );
+      expect(globalThis.fetch).not.toHaveBeenCalled();
+      expect(hyper3dService.submitHyper3dImageToModel).toHaveBeenCalledWith(
+        expect.objectContaining({
+          imageDataUrls: ['data:image/png;base64,aGVsbG8='],
+          prompt: expect.stringContaining('草莓'),
+        }),
+      );
+    });
+  });
 });
diff --git a/src/components/match3d-result/Match3DResultView.tsx b/src/components/match3d-result/Match3DResultView.tsx
index 91c5b80c..fa57d3b9 100644
--- a/src/components/match3d-result/Match3DResultView.tsx
+++ b/src/components/match3d-result/Match3DResultView.tsx
@@ -1,22 +1,42 @@
 import {
   ArrowLeft,
+  Box,
   CheckCircle2,
+  Download,
+  ExternalLink,
   ImagePlus,
+  ListChecks,
   Loader2,
   Play,
+  RefreshCw,
   Send,
+  Wand2,
+  X,
 } from 'lucide-react';
 import { type ChangeEvent, useEffect, useMemo, useState } from 'react';
 
+import type {
+  Hyper3dDownloadFilePayload,
+  Hyper3dGenerationMode,
+} from '../../../packages/shared/src/contracts/hyper3d';
 import type { Match3DResultDraft } from '../../../packages/shared/src/contracts/match3dAgent';
 import type {
+  Match3DGeneratedItemAsset,
   Match3DWorkProfile,
   PutMatch3DWorkRequest,
 } from '../../../packages/shared/src/contracts/match3dWorks';
+import {
+  getHyper3dDownloads,
+  getHyper3dTaskStatus,
+  submitHyper3dImageToModel,
+  submitHyper3dTextToModel,
+} from '../../services/hyper3dModelGenerationService';
 import {
   publishMatch3DWork,
   updateMatch3DWork,
 } from '../../services/match3d-works';
+import { readAssetBytes } from '../../services/assetReadUrlService';
+import { useResolvedAssetReadUrl } from '../../hooks/useResolvedAssetReadUrl';
 import { ResolvedAssetImage } from '../ResolvedAssetImage';
 
 type Match3DResultViewProps = {
@@ -31,6 +51,33 @@ type Match3DResultViewProps = {
 };
 
 type Match3DAutoSaveState = 'idle' | 'saving' | 'saved' | 'error';
+type Match3DResultTab = 'work' | 'config' | 'assets';
+type Match3DAssetGenerationMode = Hyper3dGenerationMode;
+type Match3DAssetTaskStatus =
+  | 'idle'
+  | 'submitting'
+  | 'waiting'
+  | 'generating'
+  | 'image_ready'
+  | 'done'
+  | 'failed'
+  | 'unknown';
+
+type Match3DRodinAssetDraft = {
+  id: string;
+  name: string;
+  usage: string;
+  prompt: string;
+  mode: Match3DAssetGenerationMode;
+  referenceImageSrc: string;
+  taskUuid: string | null;
+  subscriptionKey: string | null;
+  status: Match3DAssetTaskStatus;
+  progress: number | null;
+  downloads: Hyper3dDownloadFilePayload[];
+  error: string | null;
+  updatedAt: string | null;
+};
 
 type Match3DResultEditState = {
   gameName: string;
@@ -45,6 +92,13 @@ type Match3DResultEditState = {
 const MATCH3D_MIN_TAG_COUNT = 3;
 const MATCH3D_MAX_TAG_COUNT = 6;
 const MATCH3D_AUTOSAVE_DEBOUNCE_MS = 600;
+const MATCH3D_DEFAULT_ASSET_COUNT = 6;
+
+const MATCH3D_RESULT_TABS: Array<{ id: Match3DResultTab; label: string }> = [
+  { id: 'work', label: '作品信息' },
+  { id: 'config', label: '玩法配置' },
+  { id: 'assets', label: '3D素材' },
+];
 
 function normalizeTags(value: string) {
   return [
@@ -57,6 +111,196 @@ function normalizeTags(value: string) {
   ];
 }
 
+function formatMatch3DAssetTime(value: string | null) {
+  if (!value) {
+    return '未生成';
+  }
+
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    return '刚刚';
+  }
+
+  return date.toLocaleString('zh-CN', {
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+  });
+}
+
+function buildMatch3DAssetPrompt(
+  profile: Match3DWorkProfile,
+  assetName: string,
+  usage: string,
+) {
+  return [
+    `${profile.themeText}题材抓大鹅游戏内3D素材：${assetName}`,
+    usage,
+    '适合移动端游戏实时渲染，主体清晰，低面数，PBR材质，干净背景。',
+  ]
+    .filter(Boolean)
+    .join('，');
+}
+
+function createMatch3DAssetDrafts(
+  profile: Match3DWorkProfile,
+  draft: Match3DResultDraft | null = null,
+): Match3DRodinAssetDraft[] {
+  const generatedAssets =
+    draft?.generatedItemAssets?.length
+      ? draft.generatedItemAssets
+      : profile.generatedItemAssets;
+  if (generatedAssets?.length) {
+    return generatedAssets.map((asset) =>
+      createMatch3DAssetDraftFromGeneratedAsset(profile, asset),
+    );
+  }
+
+  const theme = profile.themeText.trim() || '主题';
+  const seeds = [
+    {
+      id: 'primary-item',
+      name: `${theme}核心物件`,
+      usage: '局内主要点击消除物件',
+    },
+    {
+      id: 'rare-item',
+      name: `${theme}稀有物件`,
+      usage: '用于增强辨识度的高价值物件',
+    },
+    {
+      id: 'bonus-item',
+      name: `${theme}奖励物件`,
+      usage: '通关或连消反馈奖励',
+    },
+    {
+      id: 'obstacle-item',
+      name: `${theme}干扰物件`,
+      usage: '堆叠层中的视觉遮挡物',
+    },
+    {
+      id: 'tray-prop',
+      name: `${theme}托盘道具`,
+      usage: '备选栏和结算展示道具',
+    },
+    {
+      id: 'scene-prop',
+      name: `${theme}场景小物`,
+      usage: '圆形空间周边装饰物',
+    },
+  ].slice(0, MATCH3D_DEFAULT_ASSET_COUNT);
+
+  return seeds.map((seed) => ({
+    ...seed,
+    prompt: buildMatch3DAssetPrompt(profile, seed.name, seed.usage),
+    mode: 'text-to-model',
+    referenceImageSrc: profile.referenceImageSrc ?? profile.coverImageSrc ?? '',
+    taskUuid: null,
+    subscriptionKey: null,
+    status: 'idle',
+    progress: null,
+    downloads: [],
+    error: null,
+    updatedAt: null,
+  }));
+}
+
+function createMatch3DAssetDraftFromGeneratedAsset(
+  profile: Match3DWorkProfile,
+  asset: Match3DGeneratedItemAsset,
+): Match3DRodinAssetDraft {
+  const downloads = asset.modelSrc
+    ? [
+        {
+          name: asset.modelFileName ?? `${asset.itemName}.glb`,
+          url: asset.modelSrc,
+        },
+      ]
+    : [];
+
+  return {
+    id: asset.itemId,
+    name: asset.itemName,
+    usage: '局内点击消除物件',
+    prompt: buildMatch3DAssetPrompt(profile, asset.itemName, '局内点击消除物件'),
+    mode: 'image-to-model',
+    referenceImageSrc:
+      asset.imageSrc ?? profile.referenceImageSrc ?? profile.coverImageSrc ?? '',
+    taskUuid: asset.taskUuid ?? null,
+    subscriptionKey: asset.subscriptionKey ?? null,
+    status:
+      asset.status === 'model_ready'
+        ? 'done'
+        : normalizeMatch3DAssetStatus(asset.status),
+    progress: asset.status === 'model_ready' ? 1 : null,
+    downloads,
+    error: asset.error ?? null,
+    updatedAt: profile.updatedAt,
+  };
+}
+
+function normalizeMatch3DAssetStatus(status: string): Match3DAssetTaskStatus {
+  const normalized = status.trim().toLowerCase();
+  if (
+    normalized === 'waiting' ||
+    normalized === 'pending' ||
+    normalized === 'queued'
+  ) {
+    return 'waiting';
+  }
+  if (
+    normalized === 'generating' ||
+    normalized === 'running' ||
+    normalized === 'processing'
+  ) {
+    return 'generating';
+  }
+  if (normalized === 'image_ready') {
+    return 'image_ready';
+  }
+  if (
+    normalized === 'done' ||
+    normalized === 'succeeded' ||
+    normalized === 'success' ||
+    normalized === 'completed'
+  ) {
+    return 'done';
+  }
+  if (
+    normalized === 'failed' ||
+    normalized === 'error' ||
+    normalized === 'canceled' ||
+    normalized === 'cancelled'
+  ) {
+    return 'failed';
+  }
+
+  return 'unknown';
+}
+
+function getMatch3DAssetStatusLabel(status: Match3DAssetTaskStatus) {
+  if (status === 'idle') return '未生成';
+  if (status === 'submitting') return '提交中';
+  if (status === 'waiting') return '排队中';
+  if (status === 'generating') return '生成中';
+  if (status === 'image_ready') return '图片已就绪';
+  if (status === 'done') return '已完成';
+  if (status === 'failed') return '失败';
+  return '待确认';
+}
+
+function getMatch3DAssetStatusPillClass(status: Match3DAssetTaskStatus) {
+  if (status === 'done') return 'platform-pill--success';
+  if (status === 'failed') return 'platform-pill--rose';
+  if (status === 'image_ready') return 'platform-pill--cool';
+  if (status === 'generating' || status === 'submitting') {
+    return 'platform-pill--warm';
+  }
+  if (status === 'waiting') return 'platform-pill--cool';
+  return 'platform-pill--neutral';
+}
+
 function normalizePositiveInteger(value: string) {
   const parsed = Number.parseInt(value.trim(), 10);
   return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
@@ -158,6 +402,60 @@ function readImageAsDataUrl(file: File) {
   });
 }
 
+function readRodinReferenceImageAsDataUrl(file: File) {
+  return new Promise<string>((resolve, reject) => {
+    if (!['image/png', 'image/jpeg', 'image/webp'].includes(file.type)) {
+      reject(new Error('请选择 PNG、JPG 或 WebP 图片。'));
+      return;
+    }
+
+    const reader = new FileReader();
+    reader.onerror = () => reject(new Error('参考图读取失败，请重试。'));
+    reader.onload = () => resolve(String(reader.result || ''));
+    reader.readAsDataURL(file);
+  });
+}
+
+function arrayBufferToBase64(buffer: ArrayBuffer) {
+  const bytes = new Uint8Array(buffer);
+  let binary = '';
+  const chunkSize = 0x8000;
+  for (let index = 0; index < bytes.length; index += chunkSize) {
+    const chunk = bytes.subarray(index, index + chunkSize);
+    binary += String.fromCharCode(...chunk);
+  }
+  return btoa(binary);
+}
+
+function normalizeRodinReferenceMimeType(value: string | null) {
+  const normalized = value?.split(';')[0]?.trim().toLowerCase() ?? '';
+  if (['image/png', 'image/jpeg', 'image/webp'].includes(normalized)) {
+    return normalized;
+  }
+  return 'image/png';
+}
+
+async function resolveRodinReferenceImageDataUrl(source: string) {
+  const normalizedSource = source.trim();
+  if (normalizedSource.startsWith('data:image/')) {
+    return normalizedSource;
+  }
+
+  const response = await readAssetBytes(normalizedSource, {
+    expireSeconds: 300,
+  });
+
+  const bytes = await response.arrayBuffer();
+  if (bytes.byteLength === 0) {
+    throw new Error('参考图读取失败，请重试。');
+  }
+
+  const mimeType = normalizeRodinReferenceMimeType(
+    response.headers.get('content-type'),
+  );
+  return `data:${mimeType};base64,${arrayBufferToBase64(bytes)}`;
+}
+
 function buildPlayableProfile(
   profile: Match3DWorkProfile,
   editState: Match3DResultEditState,
@@ -221,6 +519,632 @@ function Match3DResultHeader({
   );
 }
 
+function Match3DResultTabs({
+  activeTab,
+  onChange,
+}: {
+  activeTab: Match3DResultTab;
+  onChange: (tab: Match3DResultTab) => void;
+}) {
+  return (
+    <div className="mb-3 grid grid-cols-3 gap-2 rounded-[1.25rem] border border-[var(--platform-subpanel-border)] bg-white/62 p-1">
+      {MATCH3D_RESULT_TABS.map((tab) => (
+        <button
+          key={tab.id}
+          type="button"
+          onClick={() => onChange(tab.id)}
+          className={`min-h-10 rounded-[1rem] px-2 text-sm font-bold transition sm:px-3 ${
+            activeTab === tab.id
+              ? 'bg-white text-[var(--platform-text-strong)] shadow-sm'
+              : 'text-[var(--platform-text-base)] hover:bg-white/60'
+          }`}
+          aria-pressed={activeTab === tab.id}
+        >
+          {tab.label}
+        </button>
+      ))}
+    </div>
+  );
+}
+
+function Match3DWorkInfoTab({
+  editState,
+  isBusy,
+  onChange,
+  onCoverImageChange,
+}: {
+  editState: Match3DResultEditState;
+  isBusy: boolean;
+  onChange: (nextState: Match3DResultEditState) => void;
+  onCoverImageChange: (event: ChangeEvent<HTMLInputElement>) => void;
+}) {
+  return (
+    <div className="grid gap-3 lg:grid-cols-[minmax(17rem,0.72fr)_minmax(0,1fr)]">
+      <section className="platform-subpanel rounded-[1.5rem] p-4 sm:p-5">
+        <div className="aspect-[4/3] overflow-hidden rounded-[1.25rem] border border-[var(--platform-subpanel-border)] bg-[radial-gradient(circle_at_35%_24%,rgba(190,242,100,0.28),transparent_34%),linear-gradient(135deg,rgba(16,185,129,0.18),rgba(251,146,60,0.16))]">
+          {editState.coverImageSrc ? (
+            <ResolvedAssetImage
+              src={editState.coverImageSrc}
+              alt=""
+              aria-hidden="true"
+              className="h-full w-full object-cover"
+            />
+          ) : (
+            <div className="grid h-full w-full place-items-center text-emerald-700">
+              <ImagePlus className="h-10 w-10" />
+            </div>
+          )}
+        </div>
+        <label className="platform-button platform-button--ghost mt-3 flex min-h-10 cursor-pointer items-center justify-center gap-2 px-3 py-2 text-sm">
+          <ImagePlus className="h-4 w-4" />
+          封面图
+          <input
+            type="file"
+            accept="image/*"
+            className="sr-only"
+            disabled={isBusy}
+            onChange={onCoverImageChange}
+          />
+        </label>
+      </section>
+
+      <section className="platform-subpanel rounded-[1.5rem] p-4 sm:p-5">
+        <div className="grid gap-3 sm:grid-cols-2">
+          <label className="block sm:col-span-2">
+            <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
+              游戏名称
+            </span>
+            <input
+              value={editState.gameName}
+              disabled={isBusy}
+              onChange={(event) =>
+                onChange({ ...editState, gameName: event.target.value })
+              }
+              className="mt-2 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-base font-semibold text-[var(--platform-text-strong)] outline-none"
+            />
+          </label>
+
+          <label className="block sm:col-span-2">
+            <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
+              标签
+            </span>
+            <input
+              value={editState.tagsText}
+              disabled={isBusy}
+              onChange={(event) =>
+                onChange({ ...editState, tagsText: event.target.value })
+              }
+              className="mt-2 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm font-semibold text-[var(--platform-text-strong)] outline-none"
+            />
+          </label>
+
+          <label className="block sm:col-span-2">
+            <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
+              简介
+            </span>
+            <textarea
+              value={editState.summary}
+              disabled={isBusy}
+              onChange={(event) =>
+                onChange({ ...editState, summary: event.target.value })
+              }
+              rows={7}
+              className="mt-2 w-full resize-none rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm leading-6 text-[var(--platform-text-strong)] outline-none"
+            />
+          </label>
+        </div>
+      </section>
+    </div>
+  );
+}
+
+function Match3DConfigTab({
+  draft,
+  editState,
+  isBusy,
+  profile,
+  totalItemCount,
+  onChange,
+}: {
+  draft: Match3DResultDraft | null;
+  editState: Match3DResultEditState;
+  isBusy: boolean;
+  profile: Match3DWorkProfile;
+  totalItemCount: number;
+  onChange: (nextState: Match3DResultEditState) => void;
+}) {
+  return (
+    <div className="grid gap-3 lg:grid-cols-[minmax(16rem,0.7fr)_minmax(0,1fr)]">
+      <section className="platform-subpanel rounded-[1.5rem] p-4 sm:p-5">
+        <div className="grid grid-cols-3 gap-2 text-center text-xs font-bold text-[var(--platform-text-base)]">
+          <div className="rounded-[1rem] bg-white/68 px-2 py-3">
+            {totalItemCount} 件
+          </div>
+          <div className="rounded-[1rem] bg-white/68 px-2 py-3">
+            {editState.clearCountText || '-'} 组
+          </div>
+          <div className="rounded-[1rem] bg-white/68 px-2 py-3">
+            难度 {editState.difficultyText || '-'}
+          </div>
+        </div>
+
+        {draft?.referenceImageSrc || profile.referenceImageSrc ? (
+          <div className="mt-4 overflow-hidden rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/68 p-2">
+            <ResolvedAssetImage
+              src={draft?.referenceImageSrc ?? profile.referenceImageSrc ?? ''}
+              alt=""
+              aria-hidden="true"
+              className="h-48 w-full rounded-[0.8rem] object-cover"
+            />
+          </div>
+        ) : (
+          <div className="mt-4 grid h-48 place-items-center rounded-[1rem] border border-dashed border-[var(--platform-subpanel-border)] bg-white/52 text-sm text-[var(--platform-text-soft)]">
+            参考图
+          </div>
+        )}
+      </section>
+
+      <section className="platform-subpanel rounded-[1.5rem] p-4 sm:p-5">
+        <div className="grid gap-3 sm:grid-cols-2">
+          <label className="block sm:col-span-2">
+            <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
+              题材主题
+            </span>
+            <input
+              value={editState.themeText}
+              disabled={isBusy}
+              onChange={(event) =>
+                onChange({ ...editState, themeText: event.target.value })
+              }
+              className="mt-2 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm font-semibold text-[var(--platform-text-strong)] outline-none"
+            />
+          </label>
+
+          <label className="block">
+            <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
+              需要消除次数
+            </span>
+            <input
+              value={editState.clearCountText}
+              inputMode="numeric"
+              disabled={isBusy}
+              onChange={(event) =>
+                onChange({
+                  ...editState,
+                  clearCountText: event.target.value,
+                })
+              }
+              className="mt-2 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm font-semibold text-[var(--platform-text-strong)] outline-none"
+            />
+          </label>
+
+          <label className="block">
+            <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
+              难度
+            </span>
+            <input
+              value={editState.difficultyText}
+              inputMode="numeric"
+              disabled={isBusy}
+              onChange={(event) =>
+                onChange({
+                  ...editState,
+                  difficultyText: event.target.value,
+                })
+              }
+              className="mt-2 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm font-semibold text-[var(--platform-text-strong)] outline-none"
+            />
+          </label>
+        </div>
+      </section>
+    </div>
+  );
+}
+
+function Match3DRodinAssetListCard({
+  asset,
+  active,
+  onClick,
+}: {
+  asset: Match3DRodinAssetDraft;
+  active: boolean;
+  onClick: () => void;
+}) {
+  const pillClass = getMatch3DAssetStatusPillClass(asset.status);
+
+  return (
+    <button
+      type="button"
+      onClick={onClick}
+      className={`w-full rounded-[1.3rem] border p-2.5 text-left transition-colors ${
+        active ? 'border-emerald-300/55 bg-emerald-500/10' : 'platform-subpanel'
+      }`}
+    >
+      <div className="flex items-start gap-3">
+        <div className="platform-subpanel grid h-[4.75rem] w-[4.75rem] shrink-0 place-items-center overflow-hidden rounded-[1rem]">
+          {asset.referenceImageSrc ? (
+            <ResolvedAssetImage
+              src={asset.referenceImageSrc}
+              alt=""
+              aria-hidden="true"
+              className="h-full w-full object-cover"
+            />
+          ) : (
+            <Box className="h-7 w-7 text-[var(--platform-text-soft)]" />
+          )}
+        </div>
+        <div className="min-w-0 flex-1">
+          <div className="flex items-start justify-between gap-2">
+            <div className="min-w-0 text-[15px] font-semibold leading-5 text-[var(--platform-text-strong)]">
+              {asset.name}
+            </div>
+            <span className={`platform-pill ${pillClass} shrink-0 px-2.5 py-1 text-[10px]`}>
+              {getMatch3DAssetStatusLabel(asset.status)}
+            </span>
+          </div>
+          <div className="mt-1.5 line-clamp-2 text-sm leading-5 text-[var(--platform-text-base)]">
+            {asset.usage}
+          </div>
+          <div className="mt-2 flex flex-wrap gap-2">
+            <span className="platform-pill platform-pill--neutral px-2.5 py-1 text-[10px]">
+              {asset.mode === 'text-to-model' ? '文生模型' : '图生模型'}
+            </span>
+            <span className="platform-pill platform-pill--neutral px-2.5 py-1 text-[10px]">
+              {asset.downloads.length} 文件
+            </span>
+          </div>
+        </div>
+      </div>
+    </button>
+  );
+}
+
+function Match3DRodinAssetDetail({
+  asset,
+  busy,
+  onBackToList,
+  onChange,
+  onReferenceImageChange,
+  onRemoveReferenceImage,
+  onSubmit,
+  onCheckStatus,
+  onFetchDownloads,
+}: {
+  asset: Match3DRodinAssetDraft;
+  busy: boolean;
+  onBackToList: () => void;
+  onChange: (asset: Match3DRodinAssetDraft) => void;
+  onReferenceImageChange: (event: ChangeEvent<HTMLInputElement>) => void;
+  onRemoveReferenceImage: () => void;
+  onSubmit: () => void;
+  onCheckStatus: () => void;
+  onFetchDownloads: () => void;
+}) {
+  const isImageMode = asset.mode === 'image-to-model';
+  const canSubmit = asset.prompt.trim() && (!isImageMode || asset.referenceImageSrc);
+  const canCheckStatus = Boolean(asset.subscriptionKey) && !busy;
+  const canFetchDownloads = Boolean(asset.taskUuid) && !busy;
+
+  return (
+    <section className="platform-subpanel min-h-0 rounded-[1.5rem] p-4 sm:p-5">
+      <div className="mb-3 flex items-center justify-between gap-3">
+        <button
+          type="button"
+          onClick={onBackToList}
+          className="platform-button platform-button--ghost min-h-0 px-3 py-1.5 text-[11px] lg:hidden"
+        >
+          <ArrowLeft className="h-3.5 w-3.5" />
+          列表
+        </button>
+        <div className="min-w-0 flex-1 text-right lg:text-left">
+          <div className="truncate text-lg font-black text-[var(--platform-text-strong)]">
+            {asset.name}
+          </div>
+          <div className="mt-1 text-xs text-[var(--platform-text-soft)]">
+            {formatMatch3DAssetTime(asset.updatedAt)}
+          </div>
+        </div>
+      </div>
+
+      <div className="grid min-h-0 gap-3 lg:grid-cols-[minmax(15rem,0.86fr)_minmax(0,1.14fr)]">
+        <div className="min-h-0">
+          <div className="mb-2 text-sm font-black text-[var(--platform-text-strong)]">
+            参考图
+          </div>
+          <div className="relative aspect-square overflow-hidden rounded-[1.25rem] border border-[var(--platform-subpanel-border)] bg-white/90">
+            <input
+              id={`match3d-rodin-reference-${asset.id}`}
+              type="file"
+              accept="image/png,image/jpeg,image/webp"
+              disabled={busy}
+              onChange={onReferenceImageChange}
+              className="sr-only"
+            />
+            <label
+              htmlFor={`match3d-rodin-reference-${asset.id}`}
+              className={`absolute inset-0 z-0 ${busy ? 'cursor-not-allowed' : 'cursor-pointer'}`}
+              title={asset.referenceImageSrc ? '更换参考图' : '上传参考图'}
+            >
+              <span className="sr-only">
+                {asset.referenceImageSrc ? '更换参考图' : '上传参考图'}
+              </span>
+            </label>
+            {asset.referenceImageSrc ? (
+              <ResolvedAssetImage
+                src={asset.referenceImageSrc}
+                alt=""
+                aria-hidden="true"
+                className="pointer-events-none h-full w-full object-cover"
+              />
+            ) : (
+              <div className="grid h-full w-full place-items-center text-[var(--platform-text-soft)]">
+                <ImagePlus className="h-9 w-9" />
+              </div>
+            )}
+            {asset.referenceImageSrc ? (
+              <button
+                type="button"
+                disabled={busy}
+                onClick={onRemoveReferenceImage}
+                className="absolute right-3 top-3 z-10 inline-flex h-10 w-10 items-center justify-center rounded-full border border-white/80 bg-white/94 text-[var(--platform-text-strong)] shadow-sm transition hover:text-[#ff4056] disabled:cursor-not-allowed disabled:opacity-55"
+                aria-label="移除参考图"
+                title="移除参考图"
+              >
+                <X className="h-4 w-4" />
+              </button>
+            ) : null}
+          </div>
+        </div>
+
+        <div className="min-h-0 space-y-3">
+          <div className="grid grid-cols-2 gap-2 rounded-[1.15rem] border border-[var(--platform-subpanel-border)] bg-white/62 p-1">
+            {[
+              { id: 'text-to-model' as const, label: '文生模型' },
+              { id: 'image-to-model' as const, label: '图生模型' },
+            ].map((mode) => (
+              <button
+                key={mode.id}
+                type="button"
+                disabled={busy}
+                onClick={() => onChange({ ...asset, mode: mode.id })}
+                className={`min-h-10 rounded-[0.9rem] px-3 text-sm font-bold transition ${
+                  asset.mode === mode.id
+                    ? 'bg-white text-[var(--platform-text-strong)] shadow-sm'
+                    : 'text-[var(--platform-text-base)] hover:bg-white/60'
+                }`}
+                aria-pressed={asset.mode === mode.id}
+              >
+                {mode.label}
+              </button>
+            ))}
+          </div>
+
+          <label className="block">
+            <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
+              素材名称
+            </span>
+            <input
+              value={asset.name}
+              disabled={busy}
+              onChange={(event) =>
+                onChange({ ...asset, name: event.target.value })
+              }
+              className="mt-2 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm font-semibold text-[var(--platform-text-strong)] outline-none"
+            />
+          </label>
+
+          <label className="block">
+            <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
+              用途
+            </span>
+            <input
+              value={asset.usage}
+              disabled={busy}
+              onChange={(event) =>
+                onChange({ ...asset, usage: event.target.value })
+              }
+              className="mt-2 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm font-semibold text-[var(--platform-text-strong)] outline-none"
+            />
+          </label>
+
+          <label className="block">
+            <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
+              提示词
+            </span>
+            <textarea
+              value={asset.prompt}
+              disabled={busy}
+              rows={6}
+              onChange={(event) =>
+                onChange({ ...asset, prompt: event.target.value })
+              }
+              className="mt-2 w-full resize-none rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm leading-6 text-[var(--platform-text-strong)] outline-none"
+            />
+          </label>
+
+          <div className="flex flex-wrap gap-2">
+            <span className="platform-pill platform-pill--neutral px-2.5 py-1 text-[10px]">
+              GLB
+            </span>
+            <span className="platform-pill platform-pill--neutral px-2.5 py-1 text-[10px]">
+              PBR
+            </span>
+            <span className="platform-pill platform-pill--neutral px-2.5 py-1 text-[10px]">
+              Quad
+            </span>
+            <span className={`platform-pill ${getMatch3DAssetStatusPillClass(asset.status)} px-2.5 py-1 text-[10px]`}>
+              {getMatch3DAssetStatusLabel(asset.status)}
+            </span>
+          </div>
+
+          {asset.error ? (
+            <div className="platform-banner platform-banner--danger rounded-2xl text-sm leading-6">
+              {asset.error}
+            </div>
+          ) : null}
+
+          <div className="grid gap-2 sm:grid-cols-3">
+            <button
+              type="button"
+              disabled={!canSubmit || busy}
+              onClick={onSubmit}
+              className={`platform-button platform-button--primary min-h-11 justify-center gap-2 px-4 py-3 ${!canSubmit || busy ? 'cursor-not-allowed opacity-55' : ''}`}
+            >
+              {busy ? <Loader2 className="h-4 w-4 animate-spin" /> : <Wand2 className="h-4 w-4" />}
+              生成
+            </button>
+            <button
+              type="button"
+              disabled={!canCheckStatus}
+              onClick={onCheckStatus}
+              className={`platform-button platform-button--ghost min-h-11 justify-center gap-2 px-4 py-3 ${!canCheckStatus ? 'cursor-not-allowed opacity-55' : ''}`}
+            >
+              <RefreshCw className="h-4 w-4" />
+              状态
+            </button>
+            <button
+              type="button"
+              disabled={!canFetchDownloads}
+              onClick={onFetchDownloads}
+              className={`platform-button platform-button--ghost min-h-11 justify-center gap-2 px-4 py-3 ${!canFetchDownloads ? 'cursor-not-allowed opacity-55' : ''}`}
+            >
+              <Download className="h-4 w-4" />
+              下载
+            </button>
+          </div>
+
+          {asset.taskUuid || asset.subscriptionKey ? (
+            <div className="grid gap-2 text-xs text-[var(--platform-text-soft)] sm:grid-cols-2">
+              <div className="truncate rounded-[0.9rem] bg-white/58 px-3 py-2">
+                {asset.taskUuid ?? 'taskUuid'}
+              </div>
+              <div className="truncate rounded-[0.9rem] bg-white/58 px-3 py-2">
+                {asset.subscriptionKey ?? 'subscriptionKey'}
+              </div>
+            </div>
+          ) : null}
+
+          {asset.downloads.length > 0 ? (
+            <div className="space-y-2">
+              {asset.downloads.map((file) => (
+                <Match3DModelDownloadLink
+                  key={`${file.name}-${file.url}`}
+                  file={file}
+                />
+              ))}
+            </div>
+          ) : null}
+        </div>
+      </div>
+    </section>
+  );
+}
+
+function Match3DModelDownloadLink({
+  file,
+}: {
+  file: Hyper3dDownloadFilePayload;
+}) {
+  const { resolvedUrl, isResolving } = useResolvedAssetReadUrl(file.url, {
+    expireSeconds: 600,
+  });
+  const canOpen = Boolean(resolvedUrl);
+
+  return (
+    <a
+      href={canOpen ? resolvedUrl : undefined}
+      target="_blank"
+      rel="noreferrer"
+      aria-disabled={!canOpen}
+      onClick={(event) => {
+        if (!canOpen) {
+          event.preventDefault();
+        }
+      }}
+      className={`platform-subpanel flex items-center justify-between gap-3 rounded-[1rem] px-3 py-2 text-sm font-semibold text-[var(--platform-text-strong)] ${
+        canOpen ? '' : 'cursor-not-allowed opacity-60'
+      }`}
+    >
+      <span className="min-w-0 truncate">{file.name}</span>
+      {isResolving ? (
+        <Loader2 className="h-4 w-4 shrink-0 animate-spin" />
+      ) : (
+        <ExternalLink className="h-4 w-4 shrink-0" />
+      )}
+    </a>
+  );
+}
+
+function Match3DAssetsTab({
+  activeAssetId,
+  assets,
+  busyAssetId,
+  onActiveAssetChange,
+  onAssetChange,
+  onReferenceImageChange,
+  onRemoveReferenceImage,
+  onSubmitAsset,
+  onCheckAssetStatus,
+  onFetchAssetDownloads,
+}: {
+  activeAssetId: string | null;
+  assets: Match3DRodinAssetDraft[];
+  busyAssetId: string | null;
+  onActiveAssetChange: (assetId: string | null) => void;
+  onAssetChange: (asset: Match3DRodinAssetDraft) => void;
+  onReferenceImageChange: (
+    assetId: string,
+    event: ChangeEvent<HTMLInputElement>,
+  ) => void;
+  onRemoveReferenceImage: (assetId: string) => void;
+  onSubmitAsset: (assetId: string) => void;
+  onCheckAssetStatus: (assetId: string) => void;
+  onFetchAssetDownloads: (assetId: string) => void;
+}) {
+  const activeAsset = assets.find((asset) => asset.id === activeAssetId) ?? null;
+
+  return (
+    <div className="grid min-h-0 gap-3 lg:grid-cols-[minmax(17rem,0.78fr)_minmax(0,1.22fr)]">
+      <section
+        className={`space-y-3 ${activeAsset ? 'hidden lg:block' : 'block'}`}
+        aria-label="Rodin 3D 素材列表"
+      >
+        {assets.map((asset) => (
+          <Match3DRodinAssetListCard
+            key={asset.id}
+            asset={asset}
+            active={asset.id === activeAssetId}
+            onClick={() => onActiveAssetChange(asset.id)}
+          />
+        ))}
+      </section>
+
+      {activeAsset ? (
+        <Match3DRodinAssetDetail
+          asset={activeAsset}
+          busy={busyAssetId === activeAsset.id}
+          onBackToList={() => onActiveAssetChange(null)}
+          onChange={onAssetChange}
+          onReferenceImageChange={(event) =>
+            onReferenceImageChange(activeAsset.id, event)
+          }
+          onRemoveReferenceImage={() => onRemoveReferenceImage(activeAsset.id)}
+          onSubmit={() => onSubmitAsset(activeAsset.id)}
+          onCheckStatus={() => onCheckAssetStatus(activeAsset.id)}
+          onFetchDownloads={() => onFetchAssetDownloads(activeAsset.id)}
+        />
+      ) : (
+        <section className="platform-subpanel hidden min-h-[24rem] place-items-center rounded-[1.5rem] p-5 text-center text-sm text-[var(--platform-text-soft)] lg:grid">
+          <div>
+            <ListChecks className="mx-auto h-8 w-8" />
+            <div className="mt-3 font-semibold">选择一个素材槽位</div>
+          </div>
+        </section>
+      )}
+    </div>
+  );
+}
+
 export function Match3DResultView({
   profile,
   draft = null,
@@ -232,6 +1156,12 @@ export function Match3DResultView({
   onStartTestRun,
 }: Match3DResultViewProps) {
   const [editState, setEditState] = useState(() => createEditState(profile));
+  const [activeTab, setActiveTab] = useState<Match3DResultTab>('work');
+  const [assetDrafts, setAssetDrafts] = useState<Match3DRodinAssetDraft[]>(() =>
+    createMatch3DAssetDrafts(profile, draft),
+  );
+  const [activeAssetId, setActiveAssetId] = useState<string | null>(null);
+  const [busyAssetId, setBusyAssetId] = useState<string | null>(null);
   const [autoSaveState, setAutoSaveState] =
     useState<Match3DAutoSaveState>('idle');
   const [localError, setLocalError] = useState<string | null>(null);
@@ -254,6 +1184,12 @@ export function Match3DResultView({
     setLocalError(null);
   }, [profile.profileId, profile.updatedAt]);
 
+  useEffect(() => {
+    setAssetDrafts(createMatch3DAssetDrafts(profile, draft));
+    setActiveAssetId(null);
+    setBusyAssetId(null);
+  }, [draft?.generatedItemAssets, profile.generatedItemAssets, profile.profileId]);
+
   useEffect(() => {
     const payload = buildSavePayload(editState);
     if (!payload) {
@@ -341,6 +1277,202 @@ export function Match3DResultView({
     }
   };
 
+  const updateRodinAsset = (nextAsset: Match3DRodinAssetDraft) => {
+    setAssetDrafts((currentAssets) =>
+      currentAssets.map((asset) =>
+        asset.id === nextAsset.id ? nextAsset : asset,
+      ),
+    );
+  };
+
+  const patchRodinAsset = (
+    assetId: string,
+    patch:
+      | Partial<Match3DRodinAssetDraft>
+      | ((asset: Match3DRodinAssetDraft) => Partial<Match3DRodinAssetDraft>),
+  ) => {
+    setAssetDrafts((currentAssets) =>
+      currentAssets.map((asset) => {
+        if (asset.id !== assetId) {
+          return asset;
+        }
+        const patchValue = typeof patch === 'function' ? patch(asset) : patch;
+        return { ...asset, ...patchValue };
+      }),
+    );
+  };
+
+  const getRodinAsset = (assetId: string) =>
+    assetDrafts.find((asset) => asset.id === assetId) ?? null;
+
+  const handleRodinReferenceImageChange = async (
+    assetId: string,
+    event: ChangeEvent<HTMLInputElement>,
+  ) => {
+    const file = event.target.files?.[0] ?? null;
+    event.target.value = '';
+    if (!file) {
+      return;
+    }
+
+    try {
+      const dataUrl = await readRodinReferenceImageAsDataUrl(file);
+      patchRodinAsset(assetId, {
+        referenceImageSrc: dataUrl,
+        mode: 'image-to-model',
+        error: null,
+      });
+    } catch (caughtError) {
+      patchRodinAsset(assetId, {
+        error:
+          caughtError instanceof Error ? caughtError.message : '参考图读取失败。',
+      });
+    }
+  };
+
+  const handleSubmitRodinAsset = async (assetId: string) => {
+    const asset = getRodinAsset(assetId);
+    if (!asset || busyAssetId) {
+      return;
+    }
+
+    const prompt = asset.prompt.trim();
+    if (!prompt) {
+      patchRodinAsset(assetId, { error: '请先填写提示词。' });
+      return;
+    }
+    if (asset.mode === 'image-to-model' && !asset.referenceImageSrc.trim()) {
+      patchRodinAsset(assetId, { error: '图生模型需要先上传参考图。' });
+      return;
+    }
+
+    setBusyAssetId(assetId);
+    patchRodinAsset(assetId, {
+      status: 'submitting',
+      error: null,
+      progress: null,
+      downloads: [],
+    });
+    try {
+      const referenceImageDataUrl =
+        asset.mode === 'image-to-model'
+          ? await resolveRodinReferenceImageDataUrl(asset.referenceImageSrc)
+          : null;
+      const response =
+        asset.mode === 'image-to-model'
+          ? await submitHyper3dImageToModel({
+              imageDataUrls: referenceImageDataUrl ? [referenceImageDataUrl] : [],
+              prompt,
+              conditionMode: 'concat',
+              geometryFileFormat: 'glb',
+              material: 'PBR',
+              quality: 'medium',
+              meshMode: 'Quad',
+              previewRender: true,
+            })
+          : await submitHyper3dTextToModel({
+              prompt,
+              geometryFileFormat: 'glb',
+              material: 'PBR',
+              quality: 'medium',
+              meshMode: 'Quad',
+              previewRender: true,
+            });
+
+      patchRodinAsset(assetId, {
+        mode: response.mode,
+        taskUuid: response.taskUuid,
+        subscriptionKey: response.subscriptionKey,
+        status: 'waiting',
+        updatedAt: new Date().toISOString(),
+      });
+    } catch (caughtError) {
+      patchRodinAsset(assetId, {
+        status: 'failed',
+        error:
+          caughtError instanceof Error
+            ? caughtError.message
+            : '提交 Rodin 生成任务失败。',
+        updatedAt: new Date().toISOString(),
+      });
+    } finally {
+      setBusyAssetId(null);
+    }
+  };
+
+  const handleCheckRodinStatus = async (assetId: string) => {
+    const asset = getRodinAsset(assetId);
+    if (!asset?.subscriptionKey || busyAssetId) {
+      return;
+    }
+
+    setBusyAssetId(assetId);
+    patchRodinAsset(assetId, { error: null });
+    try {
+      const response = await getHyper3dTaskStatus({
+        subscriptionKey: asset.subscriptionKey,
+      });
+      const status = normalizeMatch3DAssetStatus(response.status);
+      const progress =
+        response.jobs
+          .map((job) => job.progress)
+          .find((progressValue): progressValue is number =>
+            typeof progressValue === 'number',
+          ) ?? null;
+      const failureMessage =
+        status === 'failed'
+          ? response.jobs
+              .map((job) => job.message?.trim() ?? '')
+              .find(Boolean) ?? 'Rodin 任务生成失败。'
+          : null;
+
+      patchRodinAsset(assetId, {
+        status,
+        progress,
+        error: failureMessage,
+        updatedAt: new Date().toISOString(),
+      });
+    } catch (caughtError) {
+      patchRodinAsset(assetId, {
+        error:
+          caughtError instanceof Error
+            ? caughtError.message
+            : '查询 Rodin 任务状态失败。',
+      });
+    } finally {
+      setBusyAssetId(null);
+    }
+  };
+
+  const handleFetchRodinDownloads = async (assetId: string) => {
+    const asset = getRodinAsset(assetId);
+    if (!asset?.taskUuid || busyAssetId) {
+      return;
+    }
+
+    setBusyAssetId(assetId);
+    patchRodinAsset(assetId, { error: null });
+    try {
+      const response = await getHyper3dDownloads({
+        taskUuid: asset.taskUuid,
+      });
+      patchRodinAsset(assetId, {
+        status: response.files.length > 0 ? 'done' : asset.status,
+        downloads: response.files,
+        updatedAt: new Date().toISOString(),
+      });
+    } catch (caughtError) {
+      patchRodinAsset(assetId, {
+        error:
+          caughtError instanceof Error
+            ? caughtError.message
+            : '获取 Rodin 下载列表失败。',
+      });
+    } finally {
+      setBusyAssetId(null);
+    }
+  };
+
   const handleStartTestRun = async () => {
     if (!canStartTestRun || isStartingTestRun) {
       setLocalError(testRunBlockers[0] ?? null);
@@ -383,7 +1515,7 @@ export function Match3DResultView({
     }
   };
 
-  const busy = isBusy || isPublishing || isStartingTestRun;
+  const busy = isBusy || isPublishing || isStartingTestRun || Boolean(busyAssetId);
   const displayError = error ?? localError;
 
   return (
@@ -394,155 +1526,49 @@ export function Match3DResultView({
         onBack={onBack}
       />
 
+      <Match3DResultTabs activeTab={activeTab} onChange={setActiveTab} />
+
       <div className="min-h-0 flex-1 overflow-y-auto pr-1">
-        <div className="grid gap-3 lg:grid-cols-[minmax(17rem,0.72fr)_minmax(0,1fr)]">
-          <section className="platform-subpanel rounded-[1.5rem] p-4 sm:p-5">
-            <div className="aspect-[4/3] overflow-hidden rounded-[1.25rem] border border-[var(--platform-subpanel-border)] bg-[radial-gradient(circle_at_35%_24%,rgba(190,242,100,0.28),transparent_34%),linear-gradient(135deg,rgba(16,185,129,0.18),rgba(251,146,60,0.16))]">
-              {editState.coverImageSrc ? (
-                <ResolvedAssetImage
-                  src={editState.coverImageSrc}
-                  alt=""
-                  aria-hidden="true"
-                  className="h-full w-full object-cover"
-                />
-              ) : (
-                <div className="grid h-full w-full place-items-center text-emerald-700">
-                  <ImagePlus className="h-10 w-10" />
-                </div>
-              )}
-            </div>
-            <label className="platform-button platform-button--ghost mt-3 flex min-h-10 cursor-pointer items-center justify-center gap-2 px-3 py-2 text-sm">
-              <ImagePlus className="h-4 w-4" />
-              封面图
-              <input
-                type="file"
-                accept="image/*"
-                className="sr-only"
-                disabled={busy}
-                onChange={handleCoverImageChange}
-              />
-            </label>
-            <div className="mt-3 grid grid-cols-3 gap-2 text-center text-xs font-bold text-[var(--platform-text-base)]">
-              <div className="rounded-[1rem] bg-white/68 px-2 py-2">
-                {totalItemCount} 件
-              </div>
-              <div className="rounded-[1rem] bg-white/68 px-2 py-2">
-                {editState.clearCountText || '-'} 组
-              </div>
-              <div className="rounded-[1rem] bg-white/68 px-2 py-2">
-                难度 {editState.difficultyText || '-'}
-              </div>
-            </div>
-          </section>
-
-          <section className="platform-subpanel rounded-[1.5rem] p-4 sm:p-5">
-            <div className="grid gap-3 sm:grid-cols-2">
-              <label className="block sm:col-span-2">
-                <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
-                  游戏名称
-                </span>
-                <input
-                  value={editState.gameName}
-                  disabled={busy}
-                  onChange={(event) =>
-                    setEditState({ ...editState, gameName: event.target.value })
-                  }
-                  className="mt-2 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-base font-semibold text-[var(--platform-text-strong)] outline-none"
-                />
-              </label>
-
-              <label className="block sm:col-span-2">
-                <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
-                  标签
-                </span>
-                <input
-                  value={editState.tagsText}
-                  disabled={busy}
-                  onChange={(event) =>
-                    setEditState({ ...editState, tagsText: event.target.value })
-                  }
-                  className="mt-2 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm font-semibold text-[var(--platform-text-strong)] outline-none"
-                />
-              </label>
-
-              <label className="block sm:col-span-2">
-                <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
-                  简介
-                </span>
-                <textarea
-                  value={editState.summary}
-                  disabled={busy}
-                  onChange={(event) =>
-                    setEditState({ ...editState, summary: event.target.value })
-                  }
-                  rows={3}
-                  className="mt-2 w-full resize-none rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm leading-6 text-[var(--platform-text-strong)] outline-none"
-                />
-              </label>
-
-              <label className="block sm:col-span-2">
-                <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
-                  题材主题
-                </span>
-                <input
-                  value={editState.themeText}
-                  disabled={busy}
-                  onChange={(event) =>
-                    setEditState({ ...editState, themeText: event.target.value })
-                  }
-                  className="mt-2 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm font-semibold text-[var(--platform-text-strong)] outline-none"
-                />
-              </label>
-
-              <label className="block">
-                <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
-                  需要消除次数
-                </span>
-                <input
-                  value={editState.clearCountText}
-                  inputMode="numeric"
-                  disabled={busy}
-                  onChange={(event) =>
-                    setEditState({
-                      ...editState,
-                      clearCountText: event.target.value,
-                    })
-                  }
-                  className="mt-2 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm font-semibold text-[var(--platform-text-strong)] outline-none"
-                />
-              </label>
-
-              <label className="block">
-                <span className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
-                  难度
-                </span>
-                <input
-                  value={editState.difficultyText}
-                  inputMode="numeric"
-                  disabled={busy}
-                  onChange={(event) =>
-                    setEditState({
-                      ...editState,
-                      difficultyText: event.target.value,
-                    })
-                  }
-                  className="mt-2 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/86 px-3 py-3 text-sm font-semibold text-[var(--platform-text-strong)] outline-none"
-                />
-              </label>
-            </div>
-
-            {draft?.referenceImageSrc || profile.referenceImageSrc ? (
-              <div className="mt-4 overflow-hidden rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/68 p-2">
-                <ResolvedAssetImage
-                  src={draft?.referenceImageSrc ?? profile.referenceImageSrc ?? ''}
-                  alt=""
-                  aria-hidden="true"
-                  className="h-24 w-full rounded-[0.8rem] object-cover"
-                />
-              </div>
-            ) : null}
-          </section>
-        </div>
+        {activeTab === 'work' ? (
+          <Match3DWorkInfoTab
+            editState={editState}
+            isBusy={busy}
+            onChange={setEditState}
+            onCoverImageChange={handleCoverImageChange}
+          />
+        ) : null}
+        {activeTab === 'config' ? (
+          <Match3DConfigTab
+            draft={draft}
+            editState={editState}
+            isBusy={busy}
+            profile={profile}
+            totalItemCount={totalItemCount}
+            onChange={setEditState}
+          />
+        ) : null}
+        {activeTab === 'assets' ? (
+          <Match3DAssetsTab
+            activeAssetId={activeAssetId}
+            assets={assetDrafts}
+            busyAssetId={busyAssetId}
+            onActiveAssetChange={setActiveAssetId}
+            onAssetChange={updateRodinAsset}
+            onReferenceImageChange={handleRodinReferenceImageChange}
+            onRemoveReferenceImage={(assetId) =>
+              patchRodinAsset(assetId, { referenceImageSrc: '' })
+            }
+            onSubmitAsset={(assetId) => {
+              void handleSubmitRodinAsset(assetId);
+            }}
+            onCheckAssetStatus={(assetId) => {
+              void handleCheckRodinStatus(assetId);
+            }}
+            onFetchAssetDownloads={(assetId) => {
+              void handleFetchRodinDownloads(assetId);
+            }}
+          />
+        ) : null}
       </div>
 
       {displayError ? (
diff --git a/src/components/match3d-runtime/Match3DPhysicsBoard.tsx b/src/components/match3d-runtime/Match3DPhysicsBoard.tsx
index 254fb79e..7b9b0ea6 100644
--- a/src/components/match3d-runtime/Match3DPhysicsBoard.tsx
+++ b/src/components/match3d-runtime/Match3DPhysicsBoard.tsx
@@ -1219,6 +1219,17 @@ function disposeTrayPreview(runtime: TrayPreviewRuntime | null) {
   runtime.renderer.domElement.remove();
 }
 
+export function applyMatch3DRendererCanvasLayout(
+  canvas: HTMLCanvasElement,
+) {
+  // 中文注释：WebGL 绘图缓冲区会乘设备 DPR，CSS 尺寸必须单独锁住，否则手机端画布会放大溢出。
+  canvas.style.display = 'block';
+  canvas.style.height = '100%';
+  canvas.style.inset = '0';
+  canvas.style.position = 'absolute';
+  canvas.style.width = '100%';
+}
+
 function positionTrayPreviewObject(
   runtime: TrayPreviewRuntime,
   object: ThreeObject3D,
@@ -1280,11 +1291,7 @@ export function Match3DTrayPreviewBoard({
         });
         renderer.setPixelRatio(Math.min(window.devicePixelRatio || 1, 1.8));
         renderer.outputColorSpace = three.SRGBColorSpace;
-        renderer.domElement.style.display = 'block';
-        renderer.domElement.style.height = '100%';
-        renderer.domElement.style.inset = '0';
-        renderer.domElement.style.position = 'absolute';
-        renderer.domElement.style.width = '100%';
+        applyMatch3DRendererCanvasLayout(renderer.domElement);
         container.appendChild(renderer.domElement);
         const handleContextLost = (event: Event) => {
           event.preventDefault();
@@ -1529,6 +1536,7 @@ export function Match3DPhysicsBoard({
         renderer.setPixelRatio(Math.min(window.devicePixelRatio || 1, 1.8));
         renderer.shadowMap.enabled = true;
         renderer.outputColorSpace = three.SRGBColorSpace;
+        applyMatch3DRendererCanvasLayout(renderer.domElement);
         container.appendChild(renderer.domElement);
         const handleContextLost = (event: Event) => {
           event.preventDefault();
diff --git a/src/components/match3d-runtime/Match3DRuntimeShell.test.tsx b/src/components/match3d-runtime/Match3DRuntimeShell.test.tsx
index 62b60a4e..4eab7c73 100644
--- a/src/components/match3d-runtime/Match3DRuntimeShell.test.tsx
+++ b/src/components/match3d-runtime/Match3DRuntimeShell.test.tsx
@@ -20,6 +20,7 @@ import {
   MATCH3D_EXTRUDED_READABLE_SHAPES,
   MATCH3D_TRAY_MODEL_MIN_RELATIVE_SIZE,
   MATCH3D_TRAY_MODEL_TARGET_SIZE,
+  applyMatch3DRendererCanvasLayout,
   buildMatch3DPhysicsEntrySignature,
   createMatch3DCannonShape,
   createMatch3DThreeGeometry,
@@ -190,6 +191,18 @@ test('3D 模式下备选栏使用共享模型预览层，避免挤占中心棋
   expect(screen.getByTestId('match3d-tray-model-board')).toBeTruthy();
 });
 
+test('3D WebGL 画布锁定 CSS 尺寸，避免高 DPR 手机上溢出中心棋盘', () => {
+  const canvas = document.createElement('canvas');
+
+  applyMatch3DRendererCanvasLayout(canvas);
+
+  expect(canvas.style.position).toBe('absolute');
+  expect(canvas.style.inset).toBe('0');
+  expect(canvas.style.width).toBe('100%');
+  expect(canvas.style.height).toBe('100%');
+  expect(canvas.style.display).toBe('block');
+});
+
 test('3D 物理条目签名随 run 和视觉资源变化，避免旧模型复用到新局', () => {
   const run = startLocalMatch3DRun(10);
   const item = run.items[0]!;
diff --git a/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx b/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx
index 535c7ae9..b86414fa 100644
--- a/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx
+++ b/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx
@@ -154,6 +154,7 @@ import {
 } from '../../services/match3d-works';
 import {
   buildBigFishGenerationAnchorEntries,
+  buildMatch3DGenerationAnchorEntries,
   buildMiniGameDraftGenerationProgress,
   buildPuzzleGenerationAnchorEntries,
   buildSquareHoleGenerationAnchorEntries,
@@ -284,9 +285,13 @@ import { useRpgCreationAgentOperationPolling } from '../rpg-entry/useRpgCreation
 import { useRpgCreationEnterWorld } from '../rpg-entry/useRpgCreationEnterWorld';
 import { useRpgCreationResultAutosave } from '../rpg-entry/useRpgCreationResultAutosave';
 import { useRpgCreationSessionController } from '../rpg-entry/useRpgCreationSessionController';
+import {
+  buildVisualNovelEntryGenerationAnchorEntries,
+  buildVisualNovelEntryGenerationProgress,
+  type VisualNovelEntryFormPayload,
+} from '../visual-novel-creation/VisualNovelAgentWorkspace';
 import { createMockVisualNovelRunFromDraft } from '../visual-novel-runtime/visualNovelMockData';
 import { PlatformEntryCreationTypeModal } from './PlatformEntryCreationTypeModal';
-import { PlatformFeedbackView } from './PlatformFeedbackView';
 import type { PlatformCreationTypeId } from './platformEntryCreationTypes';
 import {
   getVisiblePlatformCreationTypes,
@@ -302,6 +307,7 @@ import {
 } from './platformEntryShared';
 import type { PlatformEntryFlowShellProps } from './platformEntryTypes';
 import { PlatformEntryWorldDetailView } from './PlatformEntryWorldDetailView';
+import { PlatformFeedbackView } from './PlatformFeedbackView';
 import { PlatformWorkDetailView } from './PlatformWorkDetailView';
 import { usePlatformCreationAgentFlowController } from './usePlatformCreationAgentFlowController';
 import { usePlatformEntryBootstrap } from './usePlatformEntryBootstrap';
@@ -349,6 +355,7 @@ type VisualNovelRuntimeReturnStage =
   | 'visual-novel-gallery-detail'
   | 'work-detail'
   | 'platform';
+type VisualNovelEntryGenerationPhase = 'generating' | 'ready' | 'failed';
 
 type PuzzleSaveArchiveState = {
   runtimeKind?: unknown;
@@ -591,6 +598,7 @@ function buildMatch3DProfileFromSession(
     updatedAt: now,
     publishedAt: null,
     publishReady: Boolean(draft.publishReady),
+    generatedItemAssets: draft.generatedItemAssets,
   };
 }
 
@@ -1513,6 +1521,10 @@ export function PlatformEntryFlowShellImpl({
   const [match3dRuntimeReturnStage, setMatch3DRuntimeReturnStage] = useState<
     'match3d-result' | 'work-detail'
   >('match3d-result');
+  const [match3dFormDraftPayload, setMatch3DFormDraftPayload] =
+    useState<CreateMatch3DSessionRequest | null>(null);
+  const [match3dGenerationState, setMatch3DGenerationState] =
+    useState<MiniGameDraftGenerationState | null>(null);
   const [isMatch3DLoadingLibrary, setIsMatch3DLoadingLibrary] = useState(false);
   const [squareHoleWorks, setSquareHoleWorks] = useState<
     SquareHoleWorkSummary[]
@@ -1597,10 +1609,12 @@ export function PlatformEntryFlowShellImpl({
   );
   const [puzzleGenerationState, setPuzzleGenerationState] =
     useState<MiniGameDraftGenerationState | null>(null);
-  const [puzzleGenerationProgressNowMs, setPuzzleGenerationProgressNowMs] =
+  const [miniGameGenerationProgressNowMs, setMiniGameGenerationProgressNowMs] =
     useState(() => Date.now());
   const [puzzleFormDraftPayload, setPuzzleFormDraftPayload] =
     useState<CreatePuzzleAgentSessionRequest | null>(null);
+  const [activeCreationFormType, setActiveCreationFormType] =
+    useState<PlatformCreationTypeId>('puzzle');
   const [puzzleOnboardingPrompt, setPuzzleOnboardingPrompt] = useState('');
   const [puzzleOnboardingPhase, setPuzzleOnboardingPhase] =
     useState<PuzzleOnboardingPhase>('input');
@@ -1640,6 +1654,12 @@ export function PlatformEntryFlowShellImpl({
     useState<VisualNovelRunSnapshot | null>(null);
   const [visualNovelRuntimeReturnStage, setVisualNovelRuntimeReturnStage] =
     useState<VisualNovelRuntimeReturnStage>('visual-novel-result');
+  const [visualNovelFormDraftPayload, setVisualNovelFormDraftPayload] =
+    useState<VisualNovelEntryFormPayload | null>(null);
+  const [visualNovelGenerationStartedAtMs, setVisualNovelGenerationStartedAtMs] =
+    useState<number | null>(null);
+  const [visualNovelGenerationPhase, setVisualNovelGenerationPhase] =
+    useState<VisualNovelEntryGenerationPhase>('generating');
   const [isVisualNovelLoadingLibrary, setIsVisualNovelLoadingLibrary] =
     useState(false);
   const [isPuzzleNextLevelGenerating, setIsPuzzleNextLevelGenerating] =
@@ -2191,23 +2211,38 @@ export function PlatformEntryFlowShellImpl({
   ]);
 
   useEffect(() => {
-    const shouldTickPuzzleProgress =
-      selectionStage === 'puzzle-generating' &&
-      puzzleGenerationState != null &&
-      puzzleGenerationState.phase !== 'ready' &&
-      puzzleGenerationState.phase !== 'failed';
+    const activeGenerationState =
+      selectionStage === 'puzzle-generating'
+        ? puzzleGenerationState
+        : selectionStage === 'match3d-generating'
+          ? match3dGenerationState
+          : null;
+    const shouldTickProgress =
+      selectionStage === 'visual-novel-generating'
+        ? visualNovelGenerationStartedAtMs != null &&
+          visualNovelGenerationPhase !== 'ready' &&
+          visualNovelGenerationPhase !== 'failed'
+        : activeGenerationState != null &&
+          activeGenerationState.phase !== 'ready' &&
+          activeGenerationState.phase !== 'failed';
 
-    if (!shouldTickPuzzleProgress) {
+    if (!shouldTickProgress) {
       return undefined;
     }
 
-    setPuzzleGenerationProgressNowMs(Date.now());
+    setMiniGameGenerationProgressNowMs(Date.now());
     const timerId = window.setInterval(() => {
-      setPuzzleGenerationProgressNowMs(Date.now());
+      setMiniGameGenerationProgressNowMs(Date.now());
     }, 500);
 
     return () => window.clearInterval(timerId);
-  }, [puzzleGenerationState, selectionStage]);
+  }, [
+    match3dGenerationState,
+    puzzleGenerationState,
+    selectionStage,
+    visualNovelGenerationPhase,
+    visualNovelGenerationStartedAtMs,
+  ]);
 
   const runProtectedAction = useCallback(
     (action: () => void) => {
@@ -2514,6 +2549,7 @@ export function PlatformEntryFlowShellImpl({
     enterCreateTab,
     setSelectionStage,
     onSessionOpened: () => {
+      setActiveCreationFormType('match3d');
       setShowCreationTypeModal(false);
     },
     onActionComplete: async ({ payload, response, setSession }) => {
@@ -2521,6 +2557,18 @@ export function PlatformEntryFlowShellImpl({
       if (payload.action !== 'match3d_compile_draft') {
         return;
       }
+      setMatch3DGenerationState((current) =>
+        current
+          ? {
+              ...current,
+              phase: 'ready',
+              completedAssetCount:
+                response.session.draft?.generatedItemAssets?.length ?? 3,
+              totalAssetCount:
+                response.session.draft?.generatedItemAssets?.length ?? 3,
+            }
+          : current,
+      );
 
       const profileId = response.session.draft?.profileId;
       if (!profileId) {
@@ -2530,12 +2578,38 @@ export function PlatformEntryFlowShellImpl({
 
       try {
         const { item } = await getMatch3DWorkDetail(profileId);
-        setMatch3DProfile(item);
+        setMatch3DProfile({
+          ...item,
+          generatedItemAssets:
+            response.session.draft?.generatedItemAssets ??
+            item.generatedItemAssets,
+        });
         await refreshMatch3DShelf().catch(() => undefined);
       } catch {
         setMatch3DProfile(buildMatch3DProfileFromSession(response.session));
       }
     },
+    beforeExecuteAction: ({ payload }) => {
+      if (payload.action !== 'match3d_compile_draft') {
+        return;
+      }
+      setSelectionStage('match3d-generating');
+      setMatch3DGenerationState(createMiniGameDraftGenerationState('match3d'));
+    },
+    onActionError: ({ payload, errorMessage }) => {
+      if (payload.action !== 'match3d_compile_draft') {
+        return;
+      }
+      setMatch3DGenerationState((current) =>
+        current
+          ? {
+              ...current,
+              phase: 'failed',
+              error: errorMessage,
+            }
+          : current,
+      );
+    },
   });
 
   const squareHoleFlow = usePlatformCreationAgentFlowController<
@@ -2723,6 +2797,7 @@ export function PlatformEntryFlowShellImpl({
     enterCreateTab,
     setSelectionStage,
     onSessionOpened: () => {
+      setActiveCreationFormType('puzzle');
       sessionController.setCreationTypeError(null);
       setPuzzleCreationError(null);
       setShowCreationTypeModal(false);
@@ -2873,7 +2948,6 @@ export function PlatformEntryFlowShellImpl({
   const setMatch3DError = match3dFlow.setError;
   match3DErrorSetterRef.current = setMatch3DError;
   const isMatch3DBusy = match3dFlow.isBusy;
-  const streamingMatch3DReplyText = match3dFlow.streamingReplyText;
   const setStreamingMatch3DReplyText = match3dFlow.setStreamingReplyText;
   const isStreamingMatch3DReply = match3dFlow.isStreamingReply;
   const setIsStreamingMatch3DReply = match3dFlow.setIsStreamingReply;
@@ -2903,7 +2977,6 @@ export function PlatformEntryFlowShellImpl({
   visualNovelErrorSetterRef.current = setVisualNovelError;
   const isVisualNovelBusy = visualNovelFlow.isBusy;
   const setIsVisualNovelBusy = visualNovelFlow.setIsBusy;
-  const visualNovelStreamingReplyText = visualNovelFlow.streamingReplyText;
   const isVisualNovelStreamingReply = visualNovelFlow.isStreamingReply;
   const resetRpgSessionViewState = sessionController.resetSessionViewState;
   const setRpgGeneratedCustomWorldProfile =
@@ -2922,24 +2995,6 @@ export function PlatformEntryFlowShellImpl({
     await bigFishFlow.openWorkspace();
   }, [bigFishFlow]);
 
-  const openMatch3DAgentWorkspace = useCallback(async () => {
-    setMatch3DSession(null);
-    setMatch3DProfile(null);
-    setMatch3DRun(null);
-    setMatch3DError(null);
-    setStreamingMatch3DReplyText('');
-    setIsStreamingMatch3DReply(false);
-    await match3dFlow.openWorkspace();
-  }, [
-    match3dFlow,
-    setIsStreamingMatch3DReply,
-    setMatch3DError,
-    setMatch3DProfile,
-    setMatch3DRun,
-    setMatch3DSession,
-    setStreamingMatch3DReplyText,
-  ]);
-
   const openSquareHoleAgentWorkspace = useCallback(async () => {
     setSquareHoleSession(null);
     setSquareHoleProfile(null);
@@ -2960,30 +3015,6 @@ export function PlatformEntryFlowShellImpl({
     squareHoleFlow,
   ]);
 
-  const openPuzzleAgentWorkspace = useCallback(async () => {
-    setPuzzleRun(null);
-    setPuzzleRuntimeAuthMode('default');
-    setPuzzleOperation(null);
-    setPuzzleGenerationState(null);
-    setPuzzleFormDraftPayload(null);
-    sessionController.setCreationTypeError(null);
-    setPuzzleCreationError(null);
-    const nextSession = await puzzleFlow.openWorkspace({});
-    if (nextSession) {
-      void refreshPuzzleShelf();
-    }
-  }, [puzzleFlow, refreshPuzzleShelf, sessionController]);
-
-  const openVisualNovelAgentWorkspace = useCallback(() => {
-    setVisualNovelWork(null);
-    setVisualNovelRun(null);
-    setVisualNovelRuntimeReturnStage('visual-novel-result');
-    visualNovelFlow.resetTransientState();
-    enterCreateTab();
-    setShowCreationTypeModal(false);
-    setSelectionStage('visual-novel-agent-workspace');
-  }, [enterCreateTab, setSelectionStage, visualNovelFlow]);
-
   const leaveCreativeAgentWorkspace = useCallback(() => {
     const sessionId = creativeAgentSession?.sessionId?.trim();
     if (sessionId && creativeAgentSession?.stage !== 'target_ready') {
@@ -3058,6 +3089,85 @@ export function PlatformEntryFlowShellImpl({
     [puzzleFlow],
   );
 
+  const createMatch3DDraftFromForm = useCallback(
+    async (payload: CreateMatch3DSessionRequest) => {
+      setMatch3DFormDraftPayload(payload);
+      setMatch3DGenerationState(null);
+      setMatch3DSession(null);
+      setMatch3DProfile(null);
+      setMatch3DRun(null);
+      setMatch3DError(null);
+      setStreamingMatch3DReplyText('');
+      setIsStreamingMatch3DReply(false);
+
+      const nextSession = await match3dFlow.openWorkspace(payload);
+      if (!nextSession) {
+        return;
+      }
+
+      await match3dFlow.executeAction(
+        { action: 'match3d_compile_draft' },
+        nextSession,
+      );
+    },
+    [
+      match3dFlow,
+      setIsStreamingMatch3DReply,
+      setMatch3DError,
+      setMatch3DProfile,
+      setMatch3DRun,
+      setMatch3DSession,
+      setStreamingMatch3DReplyText,
+    ],
+  );
+
+  const createVisualNovelDraftFromForm = useCallback(
+    async (payload: VisualNovelEntryFormPayload) => {
+      setVisualNovelFormDraftPayload(payload);
+      setVisualNovelGenerationStartedAtMs(Date.now());
+      setVisualNovelGenerationPhase('generating');
+      setVisualNovelWork(null);
+      setVisualNovelRun(null);
+      setVisualNovelRuntimeReturnStage('visual-novel-result');
+      setVisualNovelError(null);
+      setIsVisualNovelBusy(true);
+      setSelectionStage('visual-novel-generating');
+
+      try {
+        const createResponse = await createVisualNovelSession({
+          sourceMode: payload.sourceMode,
+          seedText: payload.seedText,
+          sourceAssetIds: payload.sourceAssetIds,
+        });
+        setVisualNovelSession(createResponse.session);
+        const nextSession = await streamVisualNovelMessage(
+          createResponse.session.sessionId,
+          {
+            clientMessageId: `visual-novel-entry-${Date.now().toString(36)}`,
+            text: payload.seedText,
+          },
+        );
+        setVisualNovelSession(nextSession);
+        setVisualNovelGenerationPhase('ready');
+        setSelectionStage('visual-novel-result');
+      } catch (error) {
+        setVisualNovelGenerationPhase('failed');
+        setVisualNovelError(
+          resolvePuzzleErrorMessage(error, '生成视觉小说草稿失败。'),
+        );
+      } finally {
+        setIsVisualNovelBusy(false);
+      }
+    },
+    [
+      resolvePuzzleErrorMessage,
+      setIsVisualNovelBusy,
+      setSelectionStage,
+      setVisualNovelError,
+      setVisualNovelSession,
+    ],
+  );
+
   const savePuzzleFormDraft = useCallback(
     async (payload: CreatePuzzleAgentSessionRequest) => {
       const session = puzzleFlow.session;
@@ -3118,6 +3228,8 @@ export function PlatformEntryFlowShellImpl({
     setBigFishError(null);
     setMatch3DSession(null);
     setMatch3DProfile(null);
+    setMatch3DFormDraftPayload(null);
+    setActiveCreationFormType('puzzle');
     setMatch3DWorks([]);
     setMatch3DGalleryEntries([]);
     setMatch3DRun(null);
@@ -3160,6 +3272,9 @@ export function PlatformEntryFlowShellImpl({
     setVisualNovelGalleryEntries([]);
     setVisualNovelRun(null);
     setVisualNovelRuntimeReturnStage('visual-novel-result');
+    setVisualNovelFormDraftPayload(null);
+    setVisualNovelGenerationStartedAtMs(null);
+    setVisualNovelGenerationPhase('generating');
     setVisualNovelError(null);
     setDeletingCreationWorkId(null);
     setClaimingPuzzlePointIncentiveProfileId(null);
@@ -3189,6 +3304,7 @@ export function PlatformEntryFlowShellImpl({
     resetAutoSaveTrackingToIdle,
     resetRpgSessionViewState,
     selectionStage,
+    setActiveCreationFormType,
     setBigFishError,
     setIsStreamingMatch3DReply,
     setIsStreamingSquareHoleReply,
@@ -3231,9 +3347,10 @@ export function PlatformEntryFlowShellImpl({
       }
 
       if (type === 'match3d') {
-        runProtectedAction(() => {
-          void openMatch3DAgentWorkspace();
-        });
+        enterCreateTab();
+        setShowCreationTypeModal(false);
+        setActiveCreationFormType('match3d');
+        setMatch3DError(null);
         return;
       }
 
@@ -3245,28 +3362,34 @@ export function PlatformEntryFlowShellImpl({
       }
 
       if (type === 'puzzle') {
-        runProtectedAction(() => {
-          void openPuzzleAgentWorkspace();
-        });
+        enterCreateTab();
+        setShowCreationTypeModal(false);
+        setActiveCreationFormType('puzzle');
+        setPuzzleCreationError(null);
+        setPuzzleError(null);
         return;
       }
 
       if (type === 'visual-novel') {
-        runProtectedAction(() => {
-          openVisualNovelAgentWorkspace();
-        });
+        enterCreateTab();
+        setShowCreationTypeModal(false);
+        setActiveCreationFormType('visual-novel');
+        setVisualNovelError(null);
         return;
       }
     },
     [
       openBigFishAgentWorkspace,
-    openMatch3DAgentWorkspace,
-    openPuzzleAgentWorkspace,
-    openSquareHoleAgentWorkspace,
-      openVisualNovelAgentWorkspace,
+      enterCreateTab,
+      openSquareHoleAgentWorkspace,
       prepareCreationLaunch,
       runProtectedAction,
       sessionController,
+      setActiveCreationFormType,
+      setMatch3DError,
+      setPuzzleCreationError,
+      setPuzzleError,
+      setVisualNovelError,
     ],
   );
 
@@ -3281,9 +3404,11 @@ export function PlatformEntryFlowShellImpl({
 
   const leaveMatch3DFlow = useCallback(() => {
     setMatch3DRun(null);
+    setMatch3DFormDraftPayload(null);
+    setMatch3DGenerationState(null);
     setMatch3DRuntimeReturnStage('match3d-result');
     match3dFlow.leaveFlow();
-  }, [match3dFlow]);
+  }, [match3dFlow, setMatch3DFormDraftPayload]);
 
   const leaveSquareHoleFlow = useCallback(() => {
     setSquareHoleRun(null);
@@ -3307,20 +3432,12 @@ export function PlatformEntryFlowShellImpl({
     setVisualNovelWork(null);
     setVisualNovelRun(null);
     setVisualNovelRuntimeReturnStage('visual-novel-result');
+    setVisualNovelFormDraftPayload(null);
+    setVisualNovelGenerationStartedAtMs(null);
+    setVisualNovelGenerationPhase('generating');
     visualNovelFlow.leaveFlow();
   }, [visualNovelFlow]);
 
-  const openVisualNovelResult = useCallback(
-    (session: VisualNovelAgentSessionSnapshot) => {
-      setVisualNovelSession(session);
-      setVisualNovelWork(null);
-      setVisualNovelRun(null);
-      setVisualNovelRuntimeReturnStage('visual-novel-result');
-      setSelectionStage('visual-novel-result');
-    },
-    [setSelectionStage, setVisualNovelSession],
-  );
-
   const saveVisualNovelDraft = useCallback(
     async (draft: VisualNovelResultDraft) => {
       const currentSession = visualNovelSession;
@@ -3716,8 +3833,6 @@ export function PlatformEntryFlowShellImpl({
 
   const submitBigFishMessage = bigFishFlow.submitMessage;
 
-  const submitMatch3DMessage = match3dFlow.submitMessage;
-
   const submitSquareHoleMessage = squareHoleFlow.submitMessage;
 
   const submitPuzzleMessage = puzzleFlow.submitMessage;
@@ -3728,6 +3843,21 @@ export function PlatformEntryFlowShellImpl({
 
   const executeSquareHoleAction = squareHoleFlow.executeAction;
 
+  const retryMatch3DDraftGeneration = useCallback(() => {
+    if (match3dFormDraftPayload) {
+      void createMatch3DDraftFromForm(match3dFormDraftPayload);
+      return;
+    }
+
+    void executeMatch3DAction({
+      action: 'match3d_compile_draft',
+    });
+  }, [
+    createMatch3DDraftFromForm,
+    executeMatch3DAction,
+    match3dFormDraftPayload,
+  ]);
+
   const retrySquareHoleAssetGeneration = useCallback(() => {
     const session = squareHoleSession;
     if (!session?.draft?.profileId) {
@@ -3744,6 +3874,35 @@ export function PlatformEntryFlowShellImpl({
 
   const executePuzzleAction = puzzleFlow.executeAction;
 
+  const executePuzzleBackgroundAction = useCallback(
+    async (payload: PuzzleAgentActionRequest) => {
+      const targetSession = puzzleFlow.session;
+      if (!targetSession) {
+        return;
+      }
+
+      const formPayload = buildPuzzleFormPayloadFromAction(payload);
+      if (formPayload) {
+        setPuzzleFormDraftPayload(formPayload);
+      }
+
+      setPuzzleError(null);
+      try {
+        const response = await executePuzzleAgentAction(
+          targetSession.sessionId,
+          payload,
+        );
+        setPuzzleOperation(response.operation);
+        puzzleFlow.setSession(response.session);
+      } catch (error) {
+        setPuzzleError(
+          resolvePuzzleErrorMessage(error, '执行拼图操作失败。'),
+        );
+      }
+    },
+    [puzzleFlow, resolvePuzzleErrorMessage, setPuzzleError],
+  );
+
   const retryPuzzleDraftGeneration = useCallback(() => {
     if (puzzleFormDraftPayload) {
       void createPuzzleDraftFromForm(puzzleFormDraftPayload);
@@ -3755,6 +3914,19 @@ export function PlatformEntryFlowShellImpl({
     );
   }, [createPuzzleDraftFromForm, executePuzzleAction, puzzleFormDraftPayload]);
 
+  const retryVisualNovelDraftGeneration = useCallback(() => {
+    if (!visualNovelFormDraftPayload) {
+      setSelectionStage('visual-novel-agent-workspace');
+      return;
+    }
+
+    void createVisualNovelDraftFromForm(visualNovelFormDraftPayload);
+  }, [
+    createVisualNovelDraftFromForm,
+    setSelectionStage,
+    visualNovelFormDraftPayload,
+  ]);
+
   const executePuzzleWorkspaceAction = useCallback(
     (payload: PuzzleAgentActionRequest) => {
       if (
@@ -3768,9 +3940,19 @@ export function PlatformEntryFlowShellImpl({
         }
       }
 
+      if (payload.action === 'generate_puzzle_images') {
+        void executePuzzleBackgroundAction(payload);
+        return;
+      }
+
       void executePuzzleAction(payload);
     },
-    [createPuzzleDraftFromForm, executePuzzleAction, puzzleFlow.session],
+    [
+      createPuzzleDraftFromForm,
+      executePuzzleAction,
+      executePuzzleBackgroundAction,
+      puzzleFlow.session,
+    ],
   );
 
   const openCreativeAgentTarget = useCallback(async () => {
@@ -5098,6 +5280,7 @@ export function PlatformEntryFlowShellImpl({
             : '删除后会从你的作品列表中移除。',
         run: () => {
           setDeletingCreationWorkId(work.workId);
+          setMatch3DFormDraftPayload(null);
           setMatch3DError(null);
 
           void deleteMatch3DWork(work.profileId)
@@ -5121,6 +5304,7 @@ export function PlatformEntryFlowShellImpl({
       refreshMatch3DGallery,
       requestDeleteCreationWork,
       resolveMatch3DErrorMessage,
+      setMatch3DFormDraftPayload,
       setMatch3DError,
     ],
   );
@@ -5805,6 +5989,8 @@ export function PlatformEntryFlowShellImpl({
         return;
       }
 
+      setMatch3DFormDraftPayload(null);
+
       try {
         const { item: profile } = await getMatch3DWorkDetail(item.profileId);
         setMatch3DProfile(profile);
@@ -5820,6 +6006,7 @@ export function PlatformEntryFlowShellImpl({
       openPublicWorkDetail,
       refreshMatch3DShelf,
       resolveMatch3DErrorMessage,
+      setMatch3DFormDraftPayload,
       setMatch3DError,
     ],
   );
@@ -7424,7 +7611,7 @@ export function PlatformEntryFlowShellImpl({
             aria-label="选择模板"
           >
             {getVisiblePlatformCreationTypes().map((item) => {
-              const selected = item.id === 'puzzle';
+              const selected = item.id === activeCreationFormType;
               const disabled =
                 item.locked ||
                 sessionController.isCreatingAgentSession ||
@@ -7446,7 +7633,7 @@ export function PlatformEntryFlowShellImpl({
                   aria-selected={selected}
                   disabled={disabled}
                   onClick={() => {
-                    if (item.id === 'puzzle') {
+                    if (item.id === activeCreationFormType) {
                       return;
                     }
                     handleCreationHubCreateType(item.id);
@@ -7496,31 +7683,76 @@ export function PlatformEntryFlowShellImpl({
         </div>
 
         <div className="mt-3 min-h-0 flex-1 overflow-hidden">
-          <Suspense fallback={<LazyPanelFallback label="正在加载拼图创作..." />}>
-            <PuzzleAgentWorkspace
-              session={puzzleSession}
-              isBusy={isPuzzleBusy || isStreamingPuzzleReply}
-              error={puzzleError}
-              onBack={leavePuzzleFlow}
-              onSubmitMessage={(payload) => {
-                void submitPuzzleMessage(payload);
-              }}
-              onExecuteAction={(payload) => {
-                executePuzzleWorkspaceAction(payload);
-              }}
-              initialFormPayload={puzzleFormDraftPayload}
-              onCreateFromForm={(payload) => {
-                runProtectedAction(() => {
-                  void createPuzzleDraftFromForm(payload);
-                });
-              }}
-              onAutoSaveForm={(payload) => {
-                void savePuzzleFormDraft(payload);
-              }}
-              showBackButton={false}
-              title={null}
-            />
-          </Suspense>
+          {activeCreationFormType === 'match3d' ? (
+            <Suspense
+              fallback={
+                <LazyPanelFallback label="正在加载抓大鹅创作..." />
+              }
+            >
+              <Match3DAgentWorkspace
+                session={match3dSession}
+                isBusy={isMatch3DBusy || isStreamingMatch3DReply}
+                error={match3dError}
+                onBack={leaveMatch3DFlow}
+                onExecuteAction={(payload) => {
+                  void executeMatch3DAction(payload);
+                }}
+                initialFormPayload={match3dFormDraftPayload}
+                onCreateFromForm={(payload) => {
+                  runProtectedAction(() => {
+                    void createMatch3DDraftFromForm(payload);
+                  });
+                }}
+                showBackButton={false}
+                title={null}
+              />
+            </Suspense>
+          ) : activeCreationFormType === 'visual-novel' ? (
+            <Suspense
+              fallback={<LazyPanelFallback label="正在加载视觉小说创作..." />}
+            >
+              <VisualNovelAgentWorkspace
+                session={null}
+                isBusy={isVisualNovelBusy || isVisualNovelStreamingReply}
+                error={visualNovelError}
+                onBack={leaveVisualNovelFlow}
+                initialFormPayload={visualNovelFormDraftPayload}
+                onCreateFromForm={(payload) => {
+                  runProtectedAction(() => {
+                    void createVisualNovelDraftFromForm(payload);
+                  });
+                }}
+                showBackButton={false}
+                title={null}
+              />
+            </Suspense>
+          ) : (
+            <Suspense fallback={<LazyPanelFallback label="正在加载拼图创作..." />}>
+              <PuzzleAgentWorkspace
+                session={puzzleSession}
+                isBusy={isPuzzleBusy || isStreamingPuzzleReply}
+                error={puzzleError}
+                onBack={leavePuzzleFlow}
+                onSubmitMessage={(payload) => {
+                  void submitPuzzleMessage(payload);
+                }}
+                onExecuteAction={(payload) => {
+                  executePuzzleWorkspaceAction(payload);
+                }}
+                initialFormPayload={puzzleFormDraftPayload}
+                onCreateFromForm={(payload) => {
+                  runProtectedAction(() => {
+                    void createPuzzleDraftFromForm(payload);
+                  });
+                }}
+                onAutoSaveForm={(payload) => {
+                  void savePuzzleFormDraft(payload);
+                }}
+                showBackButton={false}
+                title={null}
+              />
+            </Suspense>
+          )}
         </div>
       </div>
     </div>
@@ -7601,6 +7833,12 @@ export function PlatformEntryFlowShellImpl({
               onSelectPreviousRecommendEntry={() =>
                 selectAdjacentRecommendRuntimeEntry(-1)
               }
+              onLikeRecommendEntry={(entry) => {
+                likePublicWork(entry);
+              }}
+              onRemixRecommendEntry={(entry) => {
+                remixPublicWork(entry);
+              }}
               onOpenLibraryDetail={(entry) => {
                 runProtectedAction(() => {
                   void detailNavigation.openLibraryDetail(entry);
@@ -7984,7 +8222,7 @@ export function PlatformEntryFlowShellImpl({
           </motion.div>
         )}
 
-        {selectionStage === 'match3d-agent-workspace' && (
+        {selectionStage === 'match3d-agent-workspace' && match3dSession && (
           <motion.div
             key="match3d-agent-workspace"
             initial={{ opacity: 0, y: 12 }}
@@ -7999,14 +8237,9 @@ export function PlatformEntryFlowShellImpl({
             >
               <Match3DAgentWorkspace
                 session={match3dSession}
-                streamingReplyText={streamingMatch3DReplyText}
-                isStreamingReply={isStreamingMatch3DReply}
                 isBusy={isMatch3DBusy || isStreamingMatch3DReply}
                 error={match3dError}
                 onBack={leaveMatch3DFlow}
-                onSubmitMessage={(payload) => {
-                  void submitMatch3DMessage(payload);
-                }}
                 onExecuteAction={(payload) => {
                   void executeMatch3DAction(payload);
                 }}
@@ -8015,6 +8248,52 @@ export function PlatformEntryFlowShellImpl({
           </motion.div>
         )}
 
+        {selectionStage === 'match3d-generating' && (
+          <motion.div
+            key="match3d-generating"
+            initial={{ opacity: 0, y: 12 }}
+            animate={{ opacity: 1, y: 0 }}
+            exit={{ opacity: 0, y: -12 }}
+            className="flex h-full min-h-0 flex-col"
+          >
+            <Suspense
+              fallback={<LazyPanelFallback label="正在加载抓大鹅生成面板..." />}
+            >
+              <CustomWorldGenerationView
+                settingText={
+                  match3dSession?.lastAssistantReply ??
+                  '正在生成本局抓大鹅物品素材。'
+                }
+                anchorEntries={buildMatch3DGenerationAnchorEntries(
+                  match3dSession,
+                  match3dFormDraftPayload,
+                )}
+                progress={buildMiniGameDraftGenerationProgress(
+                  match3dGenerationState,
+                  miniGameGenerationProgressNowMs,
+                )}
+                isGenerating={isMatch3DBusy}
+                error={match3dError}
+                onBack={leaveMatch3DFlow}
+                onEditSetting={() => {
+                  setSelectionStage('match3d-agent-workspace');
+                }}
+                onRetry={retryMatch3DDraftGeneration}
+                onInterrupt={undefined}
+                backLabel="返回创作中心"
+                settingActionLabel={null}
+                retryLabel="重新生成草稿"
+                settingTitle="当前抓大鹅信息"
+                settingDescription={null}
+                progressTitle="抓大鹅草稿生成进度"
+                activeBadgeLabel="素材生成中"
+                pausedBadgeLabel="素材生成已暂停"
+                idleBadgeLabel="等待返回工作区"
+              />
+            </Suspense>
+          </motion.div>
+        )}
+
         {selectionStage === 'match3d-result' && match3dSession?.draft && (
           <motion.div
             key="match3d-result"
@@ -8467,7 +8746,7 @@ export function PlatformEntryFlowShellImpl({
                 )}
                 progress={buildMiniGameDraftGenerationProgress(
                   puzzleGenerationState,
-                  puzzleGenerationProgressNowMs,
+                  miniGameGenerationProgressNowMs,
                 )}
                 isGenerating={isPuzzleBusy}
                 error={puzzleError}
@@ -8514,7 +8793,7 @@ export function PlatformEntryFlowShellImpl({
                   error={puzzleError}
                   onBack={leavePuzzleFlow}
                   onExecuteAction={(payload) => {
-                    void executePuzzleAction(payload);
+                    executePuzzleWorkspaceAction(payload);
                   }}
                   onStartTestRun={startPuzzleTestRunFromDraft}
                   creativeDraftEdit={
@@ -8546,25 +8825,67 @@ export function PlatformEntryFlowShellImpl({
                 session={visualNovelSession}
                 isBusy={isVisualNovelBusy || isVisualNovelStreamingReply}
                 error={visualNovelError}
-                streamingReplyText={visualNovelStreamingReplyText}
                 onBack={leaveVisualNovelFlow}
-                onCreateSession={(payload) => {
-                  void visualNovelFlow.openWorkspace(payload);
+                initialFormPayload={visualNovelFormDraftPayload}
+                onCreateFromForm={(payload) => {
+                  void createVisualNovelDraftFromForm(payload);
                 }}
-                onSubmitMessage={(payload) => {
-                  void visualNovelFlow.submitMessage(payload);
+              />
+            </Suspense>
+          </motion.div>
+        )}
+
+        {selectionStage === 'visual-novel-generating' && (
+          <motion.div
+            key="visual-novel-generating"
+            initial={{ opacity: 0, y: 12 }}
+            animate={{ opacity: 1, y: 0 }}
+            exit={{ opacity: 0, y: -12 }}
+            className="flex h-full min-h-0 flex-col"
+          >
+            <Suspense
+              fallback={<LazyPanelFallback label="正在加载视觉小说生成面板..." />}
+            >
+              <CustomWorldGenerationView
+                settingText={
+                  visualNovelFormDraftPayload?.seedText ??
+                  visualNovelSession?.messages.find(
+                    (message) => message.role === 'user',
+                  )?.text ??
+                  '正在整理当前视觉小说草稿。'
+                }
+                anchorEntries={buildVisualNovelEntryGenerationAnchorEntries(
+                  visualNovelFormDraftPayload,
+                )}
+                progress={buildVisualNovelEntryGenerationProgress(
+                  visualNovelGenerationStartedAtMs,
+                  visualNovelGenerationPhase,
+                  miniGameGenerationProgressNowMs,
+                )}
+                isGenerating={isVisualNovelBusy || isVisualNovelStreamingReply}
+                error={visualNovelError}
+                onBack={leaveVisualNovelFlow}
+                onEditSetting={() => {
+                  setSelectionStage('visual-novel-agent-workspace');
                 }}
-                onExecuteAction={(payload) => {
-                  void visualNovelFlow.executeAction(payload);
-                }}
-                onOpenResult={openVisualNovelResult}
+                onRetry={retryVisualNovelDraftGeneration}
+                onInterrupt={undefined}
+                backLabel="返回创作中心"
+                settingActionLabel={null}
+                retryLabel="重新生成草稿"
+                settingTitle="当前视觉小说信息"
+                settingDescription={null}
+                progressTitle="视觉小说草稿生成进度"
+                activeBadgeLabel="草稿生成中"
+                pausedBadgeLabel="草稿生成已暂停"
+                idleBadgeLabel="等待返回工作区"
               />
             </Suspense>
           </motion.div>
         )}
 
         {selectionStage === 'visual-novel-result' &&
-          visualNovelSession?.draft && (
+          (visualNovelSession?.draft || visualNovelWork?.draft) && (
             <motion.div
               key="visual-novel-result"
               initial={{ opacity: 0, y: 12 }}
@@ -8576,7 +8897,7 @@ export function PlatformEntryFlowShellImpl({
                 fallback={<LazyPanelFallback label="正在加载视觉小说结果..." />}
               >
                 <VisualNovelResultView
-                  draft={visualNovelWork?.draft ?? visualNovelSession.draft}
+                  draft={visualNovelWork?.draft ?? visualNovelSession?.draft}
                   isBusy={isVisualNovelBusy}
                   error={visualNovelError}
                   onBack={() => {
@@ -9049,9 +9370,7 @@ export function PlatformEntryFlowShellImpl({
           });
         }}
         onSelectMatch3D={() => {
-          runProtectedAction(() => {
-            void openMatch3DAgentWorkspace();
-          });
+          handleCreationHubCreateType('match3d');
         }}
         onSelectSquareHole={() => {
           runProtectedAction(() => {
@@ -9059,9 +9378,7 @@ export function PlatformEntryFlowShellImpl({
           });
         }}
         onSelectPuzzle={() => {
-          runProtectedAction(() => {
-            void openPuzzleAgentWorkspace();
-          });
+          handleCreationHubCreateType('puzzle');
         }}
         onSelectCreativeAgent={() => {
           runProtectedAction(() => {
@@ -9069,9 +9386,7 @@ export function PlatformEntryFlowShellImpl({
           });
         }}
         onSelectVisualNovel={() => {
-          runProtectedAction(() => {
-            openVisualNovelAgentWorkspace();
-          });
+          handleCreationHubCreateType('visual-novel');
         }}
       />
       <PublishShareModal
diff --git a/src/components/platform-entry/platformEntryTypes.ts b/src/components/platform-entry/platformEntryTypes.ts
index c68f6ff6..d01a573d 100644
--- a/src/components/platform-entry/platformEntryTypes.ts
+++ b/src/components/platform-entry/platformEntryTypes.ts
@@ -24,6 +24,7 @@ export type SelectionStage =
   | 'big-fish-result'
   | 'big-fish-runtime'
   | 'match3d-agent-workspace'
+  | 'match3d-generating'
   | 'match3d-result'
   | 'match3d-runtime'
   | 'square-hole-agent-workspace'
@@ -32,6 +33,7 @@ export type SelectionStage =
   | 'square-hole-runtime'
   | 'creative-agent-workspace'
   | 'visual-novel-agent-workspace'
+  | 'visual-novel-generating'
   | 'visual-novel-result'
   | 'visual-novel-gallery-detail'
   | 'visual-novel-runtime'
diff --git a/src/components/puzzle-agent/PuzzleAgentWorkspace.interaction.test.tsx b/src/components/puzzle-agent/PuzzleAgentWorkspace.interaction.test.tsx
index db9b2b58..b9e069e0 100644
--- a/src/components/puzzle-agent/PuzzleAgentWorkspace.interaction.test.tsx
+++ b/src/components/puzzle-agent/PuzzleAgentWorkspace.interaction.test.tsx
@@ -1,11 +1,37 @@
 /* @vitest-environment jsdom */
 
-import { act, fireEvent, render, screen, waitFor } from '@testing-library/react';
+import {
+  act,
+  fireEvent,
+  render,
+  screen,
+  waitFor,
+  within,
+} from '@testing-library/react';
 import { afterEach, beforeEach, expect, test, vi } from 'vitest';
 
 import type { PuzzleAgentSessionSnapshot } from '../../../packages/shared/src/contracts/puzzleAgentSession';
+import { puzzleAssetClient } from '../../services/puzzle-works/puzzleAssetClient';
 import { PuzzleAgentWorkspace } from './PuzzleAgentWorkspace';
 
+vi.mock('../ResolvedAssetImage', () => ({
+  ResolvedAssetImage: ({
+    src,
+    alt,
+    className,
+  }: {
+    src?: string | null;
+    alt?: string;
+    className?: string;
+  }) => (src ? <img src={src} alt={alt} className={className} /> : null),
+}));
+
+vi.mock('../../services/puzzle-works/puzzleAssetClient', () => ({
+  puzzleAssetClient: {
+    listHistoryAssets: vi.fn(),
+  },
+}));
+
 const baseSession: PuzzleAgentSessionSnapshot = {
   sessionId: 'puzzle-session-1',
   currentTurn: 3,
@@ -70,6 +96,7 @@ afterEach(() => {
   vi.useRealTimers();
   vi.unstubAllGlobals();
   vi.restoreAllMocks();
+  vi.clearAllMocks();
 });
 
 function stubReferenceImageUpload(dataUrl: string, width = 512, height = 512) {
@@ -221,6 +248,66 @@ test('puzzle workspace keeps the reference image upload as a primary panel', ()
   );
 });
 
+test('puzzle workspace selects a history image from the upload card', async () => {
+  const onCreateFromForm = vi.fn();
+  vi.mocked(puzzleAssetClient.listHistoryAssets).mockResolvedValue([
+    {
+      assetObjectId: 'asset-history-1',
+      assetKind: 'puzzle_cover_image',
+      imageSrc: '/generated-puzzle-assets/history/image.png',
+      ownerUserId: 'user-1',
+      ownerLabel: '账号 user-1',
+      profileId: null,
+      entityId: 'puzzle-session-1',
+      createdAt: '2026-04-27T10:00:00.000Z',
+      updatedAt: '2026-04-27T10:00:00.000Z',
+    },
+  ]);
+
+  render(
+    <PuzzleAgentWorkspace
+      session={null}
+      onBack={() => {}}
+      onSubmitMessage={() => {}}
+      onExecuteAction={() => {}}
+      onCreateFromForm={onCreateFromForm}
+    />,
+  );
+
+  const historyButton = screen.getByRole('button', { name: '选择历史图片' });
+  expect(historyButton.closest('.puzzle-image-upload-card')).toBeTruthy();
+  expect(screen.getByText('历史').closest('.puzzle-image-upload-card')).toBeTruthy();
+  fireEvent.click(historyButton);
+
+  const picker = await screen.findByRole('dialog', {
+    name: '选择历史图片',
+  });
+  fireEvent.click(
+    await within(picker).findByRole('button', { name: /账号 user-1/u }),
+  );
+
+  await waitFor(() => {
+    expect(screen.queryByRole('dialog', { name: '选择历史图片' })).toBeNull();
+  });
+  expect(screen.getByAltText('拼图图片')).toHaveProperty(
+    'src',
+    expect.stringContaining('/generated-puzzle-assets/history/image.png'),
+  );
+
+  fireEvent.change(screen.getByLabelText('画面AI重绘要求（提示词）'), {
+    target: { value: '保留历史图里的主体，改成晴天花园。' },
+  });
+  fireEvent.click(screen.getByRole('button', { name: /生成拼图游戏草稿/u }));
+
+  expect(onCreateFromForm).toHaveBeenCalledWith({
+    seedText: '保留历史图里的主体，改成晴天花园。',
+    pictureDescription: '保留历史图里的主体，改成晴天花园。',
+    referenceImageSrc: '/generated-puzzle-assets/history/image.png',
+    imageModel: 'gpt-image-2',
+    aiRedraw: true,
+  });
+});
+
 test('puzzle upload card stays light in light theme', () => {
   const onCreateFromForm = vi.fn();
   const { container } = render(
@@ -237,6 +324,9 @@ test('puzzle upload card stays light in light theme', () => {
   const uploadLabel = screen.getByText('点击上传拼图图片');
   expect(uploadLabel).toBeTruthy();
   expect(uploadLabel.closest('.puzzle-image-upload-card')).toBeTruthy();
+  expect(uploadLabel.className).not.toContain('rounded-full');
+  expect(uploadLabel.className).not.toContain('bg-white/94');
+  expect(uploadLabel.className).not.toContain('border');
   expect(screen.queryByText('AI重绘')).toBeNull();
   expect(container.querySelector('.puzzle-image-upload-card')?.className).toContain(
     'bg-white/90',
diff --git a/src/components/puzzle-agent/PuzzleAgentWorkspace.tsx b/src/components/puzzle-agent/PuzzleAgentWorkspace.tsx
index adaf2a46..c60d033a 100644
--- a/src/components/puzzle-agent/PuzzleAgentWorkspace.tsx
+++ b/src/components/puzzle-agent/PuzzleAgentWorkspace.tsx
@@ -1,4 +1,11 @@
-import { ArrowLeft, ImagePlus, Loader2, Sparkles, Trash2 } from 'lucide-react';
+import {
+  ArrowLeft,
+  History,
+  ImagePlus,
+  Loader2,
+  Sparkles,
+  Trash2,
+} from 'lucide-react';
 import {
   type ChangeEvent,
   type CSSProperties,
@@ -20,6 +27,7 @@ import {
   isPuzzleReferenceImageSquare,
   readPuzzleReferenceImageForUpload,
 } from '../../services/puzzleReferenceImage';
+import PuzzleHistoryAssetPickerDialog from './PuzzleHistoryAssetPickerDialog';
 import {
   normalizePuzzleImageModel,
   PUZZLE_IMAGE_MODEL_GPT_IMAGE_2,
@@ -535,6 +543,7 @@ export function PuzzleAgentWorkspace({
     null,
   );
   const [cropState, setCropState] = useState<PuzzleImageCropState | null>(null);
+  const [isHistoryPickerOpen, setIsHistoryPickerOpen] = useState(false);
   const [isRemoveImageConfirmOpen, setIsRemoveImageConfirmOpen] =
     useState(false);
   const previousSessionIdRef = useRef<string | null>(
@@ -565,6 +574,7 @@ export function PuzzleAgentWorkspace({
     setFormState(resolveInitialFormState(session, initialFormPayload));
     setReferenceImageError(null);
     setCropState(null);
+    setIsHistoryPickerOpen(false);
     setIsRemoveImageConfirmOpen(false);
   }, [initialFormPayload, session]);
 
@@ -865,6 +875,17 @@ export function PuzzleAgentWorkspace({
                     </span>
                   )}
                   <div className="absolute inset-0 z-[1] bg-[linear-gradient(180deg,rgba(255,255,255,0.12)_0%,rgba(255,255,255,0.04)_42%,rgba(255,255,255,0.18)_100%)] pointer-events-none" />
+                  <button
+                    type="button"
+                    disabled={isBusy}
+                    onClick={() => setIsHistoryPickerOpen(true)}
+                    className={`absolute bottom-3 right-3 z-10 inline-flex items-center gap-1.5 rounded-full border border-white/80 bg-white/94 px-3 py-2 text-[11px] font-black text-[var(--platform-text-strong)] shadow-sm backdrop-blur transition hover:text-[#ff4056] ${isBusy ? 'cursor-not-allowed opacity-55' : ''}`}
+                    aria-label="选择历史图片"
+                    title="选择历史图片"
+                  >
+                    <History className="h-3.5 w-3.5" />
+                    <span>历史</span>
+                  </button>
                   {formState.referenceImageSrc ? (
                     <label className="absolute bottom-3 left-3 z-10 inline-flex cursor-pointer items-center gap-2 rounded-full border border-white/80 bg-white/94 px-3 py-2 text-xs font-black text-[var(--platform-text-strong)] shadow-sm backdrop-blur">
                       <span>AI重绘</span>
@@ -910,7 +931,7 @@ export function PuzzleAgentWorkspace({
                   ) : (
                     <label
                       htmlFor="puzzle-image-upload-input"
-                      className={`absolute bottom-3 left-1/2 z-10 inline-flex min-h-10 -translate-x-1/2 items-center justify-center whitespace-nowrap rounded-full border border-white/80 bg-white/94 px-4 text-sm font-black text-[var(--platform-text-strong)] shadow-sm backdrop-blur transition hover:text-[#ff4056] ${isBusy ? 'cursor-not-allowed' : 'cursor-pointer'}`}
+                      className={`absolute bottom-9 left-1/2 z-10 -translate-x-1/2 whitespace-nowrap text-center text-sm font-black text-[var(--platform-text-strong)] drop-shadow-[0_1px_0_rgba(255,255,255,0.82)] transition hover:text-[#ff4056] sm:bottom-10 ${isBusy ? 'cursor-not-allowed opacity-55' : 'cursor-pointer'}`}
                     >
                       点击上传拼图图片
                     </label>
@@ -1003,6 +1024,22 @@ export function PuzzleAgentWorkspace({
           }}
         />
       ) : null}
+      {isHistoryPickerOpen ? (
+        <PuzzleHistoryAssetPickerDialog
+          isBusy={isBusy}
+          onClose={() => setIsHistoryPickerOpen(false)}
+          onSelect={(asset) => {
+            setFormState((current) => ({
+              ...current,
+              referenceImageSrc: asset.imageSrc,
+              referenceImageLabel: `历史素材 · ${asset.ownerLabel || '未记录账号'}`,
+            }));
+            setReferenceImageError(null);
+            setIsHistoryPickerOpen(false);
+            setIsRemoveImageConfirmOpen(false);
+          }}
+        />
+      ) : null}
       {isRemoveImageConfirmOpen ? (
         <div className="platform-modal-backdrop fixed inset-0 z-[80] flex items-center justify-center px-4 py-6">
           <div
diff --git a/src/components/puzzle-agent/PuzzleHistoryAssetPickerDialog.tsx b/src/components/puzzle-agent/PuzzleHistoryAssetPickerDialog.tsx
new file mode 100644
index 00000000..e2e238b0
--- /dev/null
+++ b/src/components/puzzle-agent/PuzzleHistoryAssetPickerDialog.tsx
@@ -0,0 +1,164 @@
+import { X } from 'lucide-react';
+import { useEffect, useState } from 'react';
+import { createPortal } from 'react-dom';
+
+import {
+  puzzleAssetClient,
+  type PuzzleHistoryAsset,
+} from '../../services/puzzle-works/puzzleAssetClient';
+import { useAuthUi } from '../auth/AuthUiContext';
+import { ResolvedAssetImage } from '../ResolvedAssetImage';
+
+type PuzzleHistoryAssetPickerDialogProps = {
+  isBusy: boolean;
+  onClose: () => void;
+  onSelect: (asset: PuzzleHistoryAsset) => void;
+};
+
+function formatHistoryAssetDate(value: string) {
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    return '未知时间';
+  }
+
+  return new Intl.DateTimeFormat('zh-CN', {
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    hour12: false,
+  }).format(date);
+}
+
+export function PuzzleHistoryAssetPickerDialog({
+  isBusy,
+  onClose,
+  onSelect,
+}: PuzzleHistoryAssetPickerDialogProps) {
+  const platformTheme = useAuthUi()?.platformTheme ?? 'light';
+  const [assets, setAssets] = useState<PuzzleHistoryAsset[]>([]);
+  const [isLoading, setIsLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    let cancelled = false;
+    setIsLoading(true);
+    setError(null);
+    puzzleAssetClient
+      .listHistoryAssets({ limit: 120 })
+      .then((nextAssets) => {
+        if (!cancelled) {
+          setAssets(nextAssets);
+        }
+      })
+      .catch((loadError) => {
+        if (!cancelled) {
+          setError(
+            loadError instanceof Error
+              ? loadError.message
+              : '历史拼图素材读取失败。',
+          );
+        }
+      })
+      .finally(() => {
+        if (!cancelled) {
+          setIsLoading(false);
+        }
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, []);
+
+  if (typeof document === 'undefined') {
+    return null;
+  }
+
+  return createPortal(
+    <div
+      className={`platform-theme platform-theme--${platformTheme} platform-overlay fixed inset-0 z-[145] flex items-end justify-center p-3 backdrop-blur-sm sm:items-center sm:p-4`}
+      onClick={(event) => {
+        if (event.target === event.currentTarget) {
+          onClose();
+        }
+      }}
+    >
+      <div
+        role="dialog"
+        aria-modal="true"
+        aria-label="选择历史图片"
+        className="platform-modal-shell platform-remap-surface flex max-h-[min(92vh,46rem)] w-full max-w-5xl flex-col overflow-hidden rounded-t-[1.75rem] shadow-[0_24px_80px_rgba(0,0,0,0.55)] sm:rounded-[1.75rem]"
+        onClick={(event) => event.stopPropagation()}
+      >
+        <div className="flex items-center justify-between gap-3 border-b border-[var(--platform-subpanel-border)] px-5 py-4">
+          <div className="text-base font-semibold text-[var(--platform-text-strong)]">
+            选择历史图片
+          </div>
+          <button
+            type="button"
+            onClick={onClose}
+            aria-label="关闭"
+            className="platform-icon-button"
+          >
+            <X className="h-4 w-4" />
+          </button>
+        </div>
+
+        <div className="min-h-0 flex-1 overflow-y-auto px-5 py-4">
+          {error ? (
+            <div className="platform-banner platform-banner--danger text-sm leading-6">
+              {error}
+            </div>
+          ) : null}
+
+          {isLoading ? (
+            <div className="flex min-h-[14rem] items-center justify-center rounded-[1.35rem] border border-dashed border-[var(--platform-subpanel-border)] bg-white/52 px-6 text-center text-sm text-[var(--platform-text-base)]">
+              读取中...
+            </div>
+          ) : null}
+
+          {!isLoading && !error && assets.length <= 0 ? (
+            <div className="flex min-h-[14rem] items-center justify-center rounded-[1.35rem] border border-dashed border-[var(--platform-subpanel-border)] bg-white/52 px-6 text-center text-sm text-[var(--platform-text-base)]">
+              暂无历史拼图素材
+            </div>
+          ) : null}
+
+          {!isLoading && assets.length > 0 ? (
+            <div className="grid grid-cols-2 gap-3 sm:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5">
+              {assets.map((asset) => (
+                <button
+                  key={asset.assetObjectId}
+                  type="button"
+                  disabled={isBusy}
+                  onClick={() => onSelect(asset)}
+                  className={`overflow-hidden rounded-[1.25rem] border bg-white/82 text-left transition hover:border-amber-300/70 hover:bg-white ${isBusy ? 'cursor-not-allowed opacity-55' : 'border-[var(--platform-subpanel-border)]'}`}
+                >
+                  <div className="aspect-square overflow-hidden bg-[var(--platform-subpanel-fill)]">
+                    <ResolvedAssetImage
+                      src={asset.imageSrc}
+                      alt={asset.ownerLabel || '历史拼图素材'}
+                      className="h-full w-full object-cover"
+                    />
+                  </div>
+                  <div className="space-y-1 px-4 py-4">
+                    <div className="truncate text-sm font-black text-[var(--platform-text-strong)]">
+                      {asset.ownerLabel || '未记录账号'}
+                    </div>
+                    <div className="text-xs leading-5 text-[var(--platform-text-base)]">
+                      {formatHistoryAssetDate(asset.createdAt)}
+                    </div>
+                  </div>
+                </button>
+              ))}
+            </div>
+          ) : null}
+        </div>
+      </div>
+    </div>,
+    document.body,
+  );
+}
+
+export default PuzzleHistoryAssetPickerDialog;
diff --git a/src/components/puzzle-result/PuzzleResultView.test.tsx b/src/components/puzzle-result/PuzzleResultView.test.tsx
index 71a56ad4..ca609fd8 100644
--- a/src/components/puzzle-result/PuzzleResultView.test.tsx
+++ b/src/components/puzzle-result/PuzzleResultView.test.tsx
@@ -249,6 +249,7 @@ describe('PuzzleResultView', () => {
       promptText: '一只猫在雨夜灯牌下回头。',
       referenceImageSrc: undefined,
       imageModel: 'gpt-image-2',
+      aiRedraw: true,
       candidateCount: 1,
       workTitle: '暖灯猫街作品',
       workDescription: '一套雨夜猫街主题拼图。',
@@ -263,8 +264,15 @@ describe('PuzzleResultView', () => {
         levelId: 'puzzle-level-1',
         levelName: '暖灯猫街',
         pictureDescription: '一只猫在雨夜灯牌下回头。',
+        generationStatus: 'generating',
       }),
     ]);
+    expect(within(dialog).getByText('预计剩余 90 秒')).toBeTruthy();
+    expect(
+      within(dialog).queryByPlaceholderText('参考图链接或资产ID'),
+    ).toBeNull();
+    const levelList = screen.getByLabelText('拼图关卡列表');
+    expect(within(levelList).getAllByText('生成中').length).toBeGreaterThan(0);
 
     const levelNameInput = within(dialog).getByLabelText('关卡名称');
     const formalImageTitle = within(dialog).getByText('画面图');
@@ -314,7 +322,10 @@ describe('PuzzleResultView', () => {
       within(dialog).getByRole('button', { name: /生成画面/u }),
     ).toBeTruthy();
     expect(within(dialog).getByText('消耗2光点')).toBeTruthy();
-    expect(within(dialog).queryByText('画面图')).toBeNull();
+    expect(
+      within(dialog).getByText('等待时间可以制作更多关卡哦~'),
+    ).toBeTruthy();
+    expect(within(dialog).getByText('画面图')).toBeTruthy();
     expect(
       within(dialog).queryByRole('button', { name: /关卡测试/u }),
     ).toBeNull();
@@ -385,6 +396,7 @@ describe('PuzzleResultView', () => {
       promptText: '新关卡里有一座发光钟楼。',
       referenceImageSrc: undefined,
       imageModel: 'gpt-image-2',
+      aiRedraw: true,
       candidateCount: 1,
       workTitle: '暖灯猫街作品',
       workDescription: '一套雨夜猫街主题拼图。',
@@ -400,10 +412,90 @@ describe('PuzzleResultView', () => {
         levelId: 'puzzle-level-1775000000000-2',
         levelName: '',
         pictureDescription: '新关卡里有一座发光钟楼。',
+        generationStatus: 'generating',
       }),
     ]);
   });
 
+  test('keeps generation progress visible after closing and reopening level dialog', () => {
+    const onExecuteAction = vi.fn();
+
+    render(
+      <PuzzleResultView
+        session={createSession()}
+        onBack={() => {}}
+        onExecuteAction={onExecuteAction}
+      />,
+    );
+
+    fireEvent.click(screen.getByText('雨夜猫街'));
+    fireEvent.click(screen.getByRole('button', { name: /重新生成画面/u }));
+    fireEvent.click(
+      within(screen.getByRole('dialog', { name: '确认消耗光点' })).getByRole(
+        'button',
+        { name: '确定' },
+      ),
+    );
+    fireEvent.click(screen.getByLabelText('关闭'));
+
+    expect(
+      within(screen.getByLabelText('拼图关卡列表')).getAllByText('生成中')
+        .length,
+    ).toBeGreaterThan(0);
+
+    fireEvent.click(screen.getByText('雨夜猫街'));
+    const reopenedDialog = screen.getByRole('dialog', { name: '关卡详情' });
+    expect(
+      within(reopenedDialog).getByRole('progressbar', { name: '画面生成进度' }),
+    ).toBeTruthy();
+    expect(within(reopenedDialog).getByText('预计剩余 90 秒')).toBeTruthy();
+  });
+
+  test('allows parallel draft editing while a level image is generating but blocks publish', () => {
+    const onExecuteAction = vi.fn();
+    const onStartTestRun = vi.fn();
+
+    render(
+      <PuzzleResultView
+        session={createSession()}
+        onBack={() => {}}
+        onExecuteAction={onExecuteAction}
+        onStartTestRun={onStartTestRun}
+      />,
+    );
+
+    fireEvent.click(screen.getByText('雨夜猫街'));
+    fireEvent.click(screen.getByRole('button', { name: /重新生成画面/u }));
+    fireEvent.click(
+      within(screen.getByRole('dialog', { name: '确认消耗光点' })).getByRole(
+        'button',
+        { name: '确定' },
+      ),
+    );
+    fireEvent.change(screen.getByLabelText('关卡名称'), {
+      target: { value: '继续编辑的猫街' },
+    });
+    fireEvent.click(screen.getByRole('button', { name: /关卡测试/u }));
+
+    expect(onStartTestRun).toHaveBeenCalledWith(
+      expect.objectContaining({
+        levelName: '继续编辑的猫街',
+      }),
+    );
+
+    fireEvent.click(screen.getByLabelText('关闭'));
+    fireEvent.click(screen.getByRole('button', { name: /新增关卡/u }));
+    expect(screen.getByRole('dialog', { name: '关卡详情' })).toBeTruthy();
+    fireEvent.click(screen.getByLabelText('关闭'));
+
+    fireEvent.click(screen.getByRole('button', { name: /发布/u }));
+    const publishDialog = screen.getByRole('dialog', { name: '发布拼图作品' });
+    expect(within(publishDialog).getByText('还有关卡画面正在生成。')).toBeTruthy();
+    expect(
+      within(publishDialog).getByRole('button', { name: '发布到广场' }),
+    ).toHaveProperty('disabled', true);
+  });
+
   test('publishes with work info and serialized levels', () => {
     const onExecuteAction = vi.fn();
 
@@ -552,19 +644,26 @@ describe('PuzzleResultView', () => {
     );
 
     fireEvent.click(screen.getByText('雨夜猫街'));
-    fireEvent.click(screen.getByLabelText('从历史拼图素材库选择'));
+    const dialog = screen.getByRole('dialog', { name: '关卡详情' });
+    const uploadInput = within(dialog).getByLabelText('上传参考图', {
+      selector: 'input',
+    });
+    expect(uploadInput.closest('.platform-subpanel')).toBeTruthy();
+    const historyButton = within(dialog).getByRole('button', {
+      name: '选择历史图片',
+    });
+    expect(within(historyButton).getByText('历史')).toBeTruthy();
+    fireEvent.click(historyButton);
 
     const picker = await screen.findByRole('dialog', {
-      name: '选择历史拼图素材',
+      name: '选择历史图片',
     });
     fireEvent.click(
       await within(picker).findByRole('button', { name: /账号 user-1/u }),
     );
 
     await waitFor(() => {
-      expect(
-        screen.queryByRole('dialog', { name: '选择历史拼图素材' }),
-      ).toBeNull();
+      expect(screen.queryByRole('dialog', { name: '选择历史图片' })).toBeNull();
     });
 
     fireEvent.click(screen.getByRole('button', { name: /重新生成画面/u }));
@@ -580,6 +679,7 @@ describe('PuzzleResultView', () => {
       promptText: '屋檐下的猫与暖灯街角。',
       referenceImageSrc: '/generated-puzzle-assets/history/image.png',
       imageModel: 'gpt-image-2',
+      aiRedraw: true,
       candidateCount: 1,
       workTitle: '暖灯猫街作品',
       workDescription: '一套雨夜猫街主题拼图。',
@@ -624,8 +724,10 @@ describe('PuzzleResultView', () => {
       expect.objectContaining({
         action: 'generate_puzzle_images',
         referenceImageSrc: '/generated-puzzle-assets/history/saved-reference.png',
+        aiRedraw: true,
       }),
     );
+    expect(screen.queryByPlaceholderText('参考图链接或资产ID')).toBeNull();
   });
 
   test('passes the selected image model when regenerating a level image', () => {
diff --git a/src/components/puzzle-result/PuzzleResultView.tsx b/src/components/puzzle-result/PuzzleResultView.tsx
index 7ccecaf9..11550238 100644
--- a/src/components/puzzle-result/PuzzleResultView.tsx
+++ b/src/components/puzzle-result/PuzzleResultView.tsx
@@ -1,8 +1,8 @@
 import {
   ArrowLeft,
   CheckCircle2,
+  History,
   ImagePlus,
-  Images,
   Loader2,
   MessageSquareText,
   Play,
@@ -22,12 +22,9 @@ import type {
 } from '../../../packages/shared/src/contracts/puzzleAgentDraft';
 import type { PuzzleAgentSessionSnapshot } from '../../../packages/shared/src/contracts/puzzleAgentSession';
 import { updatePuzzleWork } from '../../services/puzzle-works';
-import {
-  puzzleAssetClient,
-  type PuzzleHistoryAsset,
-} from '../../services/puzzle-works/puzzleAssetClient';
 import { readPuzzleReferenceImageAsDataUrl } from '../../services/puzzleReferenceImage';
 import { useAuthUi } from '../auth/AuthUiContext';
+import PuzzleHistoryAssetPickerDialog from '../puzzle-agent/PuzzleHistoryAssetPickerDialog';
 import {
   PUZZLE_IMAGE_MODEL_GPT_IMAGE_2,
   type PuzzleImageModelId,
@@ -67,7 +64,46 @@ const PUZZLE_MIN_THEME_TAG_COUNT = 3;
 const PUZZLE_MAX_THEME_TAG_COUNT = 6;
 const PUZZLE_AUTOSAVE_DEBOUNCE_MS = 600;
 const PUZZLE_IMAGE_GENERATION_POINT_COST = 2;
-const PUZZLE_IMAGE_GENERATION_ESTIMATE_SECONDS = 30;
+const PUZZLE_IMAGE_GENERATION_ESTIMATE_SECONDS = 90;
+
+type PuzzleLevelGenerationRuntime = {
+  startedAtMs: number;
+  estimateSeconds: number;
+};
+
+function resolvePuzzleLevelGenerationProgress(
+  level: PuzzleDraftLevel,
+  runtime: PuzzleLevelGenerationRuntime | null,
+  nowMs: number,
+) {
+  if (level.generationStatus !== 'generating') {
+    return {
+      isGenerating: false,
+      progressPercent: 0,
+      secondsLeft: 0,
+    };
+  }
+
+  const estimateSeconds =
+    runtime?.estimateSeconds ?? PUZZLE_IMAGE_GENERATION_ESTIMATE_SECONDS;
+  const elapsedSeconds = runtime
+    ? Math.max(0, Math.floor((nowMs - runtime.startedAtMs) / 1000))
+    : 0;
+  const secondsLeft = Math.max(0, estimateSeconds - elapsedSeconds);
+  const progressPercent = Math.min(
+    96,
+    Math.max(
+      6,
+      Math.round(((estimateSeconds - secondsLeft) / estimateSeconds) * 100),
+    ),
+  );
+
+  return {
+    isGenerating: true,
+    progressPercent,
+    secondsLeft,
+  };
+}
 
 function normalizeThemeTagInput(value: string) {
   return [
@@ -163,6 +199,61 @@ function createDraftEditState(draft: PuzzleResultDraft): DraftEditState {
   };
 }
 
+function mergeDraftEditStateWithIncomingState(
+  currentState: DraftEditState | null,
+  incomingState: DraftEditState,
+): DraftEditState {
+  if (!currentState) {
+    return incomingState;
+  }
+
+  const incomingLevelsById = new Map(
+    incomingState.levels.map((level) => [level.levelId, level]),
+  );
+  const shouldPreserveLocalEdits = currentState.levels.some((level) => {
+    const incomingLevel = incomingLevelsById.get(level.levelId);
+    return (
+      level.generationStatus === 'generating' &&
+      Boolean(incomingLevel) &&
+      incomingLevel?.generationStatus !== 'generating'
+    );
+  });
+
+  if (!shouldPreserveLocalEdits) {
+    return incomingState;
+  }
+
+  const mergedLevels = currentState.levels.map((level) => {
+    const incomingLevel = incomingLevelsById.get(level.levelId);
+    if (
+      !incomingLevel ||
+      level.generationStatus !== 'generating' ||
+      incomingLevel.generationStatus === 'generating'
+    ) {
+      return level;
+    }
+
+    return {
+      ...level,
+      candidates: incomingLevel.candidates,
+      selectedCandidateId: incomingLevel.selectedCandidateId,
+      coverImageSrc: incomingLevel.coverImageSrc,
+      coverAssetId: incomingLevel.coverAssetId,
+      pictureReference: incomingLevel.pictureReference ?? level.pictureReference,
+      generationStatus: incomingLevel.generationStatus || 'ready',
+    };
+  });
+  const mergedLevelIds = new Set(mergedLevels.map((level) => level.levelId));
+  const appendedIncomingLevels = incomingState.levels.filter(
+    (level) => !mergedLevelIds.has(level.levelId),
+  );
+
+  return {
+    ...currentState,
+    levels: [...mergedLevels, ...appendedIncomingLevels],
+  };
+}
+
 function createBlankPuzzleLevel(
   existingLevels: PuzzleDraftLevel[],
 ): PuzzleDraftLevel {
@@ -180,19 +271,6 @@ function createBlankPuzzleLevel(
   };
 }
 
-function formatHistoryAssetDate(value: string) {
-  const date = new Date(value);
-  if (Number.isNaN(date.getTime())) {
-    return value || '';
-  }
-  return date.toLocaleString('zh-CN', {
-    month: '2-digit',
-    day: '2-digit',
-    hour: '2-digit',
-    minute: '2-digit',
-  });
-}
-
 function buildPublishReady(
   session: PuzzleAgentSessionSnapshot,
   editState: DraftEditState,
@@ -209,6 +287,9 @@ function buildPublishReady(
       )
       .map((entry) => entry.message) ?? [];
   const levels = editState.levels;
+  const hasGeneratingLevel = levels.some(
+    (level) => level.generationStatus === 'generating',
+  );
   const blockers = [
     ...(session.resultPreview ? [] : ['等待结果页草稿完成后再发布。']),
     ...preservedBlockers,
@@ -226,7 +307,11 @@ function buildPublishReady(
       ...(resolveLevelFormalImageSrc(level)
         ? []
         : [`第${index + 1}关缺少正式图。`]),
+      ...(level.generationStatus === 'generating'
+        ? [`第${index + 1}关画面正在生成。`]
+        : []),
     ]),
+    ...(hasGeneratingLevel ? ['还有关卡画面正在生成。'] : []),
   ];
 
   return {
@@ -462,142 +547,10 @@ function PuzzleThemeTagEditor({
   );
 }
 
-function PuzzleHistoryAssetPickerDialog({
-  isBusy,
-  onClose,
-  onSelect,
-}: {
-  isBusy: boolean;
-  onClose: () => void;
-  onSelect: (asset: PuzzleHistoryAsset) => void;
-}) {
-  const platformTheme = useAuthUi()?.platformTheme ?? 'light';
-  const [assets, setAssets] = useState<PuzzleHistoryAsset[]>([]);
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState<string | null>(null);
-
-  useEffect(() => {
-    let cancelled = false;
-    setIsLoading(true);
-    setError(null);
-    puzzleAssetClient
-      .listHistoryAssets({ limit: 120 })
-      .then((nextAssets) => {
-        if (!cancelled) {
-          setAssets(nextAssets);
-        }
-      })
-      .catch((loadError) => {
-        if (!cancelled) {
-          setError(
-            loadError instanceof Error
-              ? loadError.message
-              : '历史拼图素材读取失败。',
-          );
-        }
-      })
-      .finally(() => {
-        if (!cancelled) {
-          setIsLoading(false);
-        }
-      });
-
-    return () => {
-      cancelled = true;
-    };
-  }, []);
-
-  if (typeof document === 'undefined') {
-    return null;
-  }
-
-  return createPortal(
-    <div
-      className={`platform-theme platform-theme--${platformTheme} platform-overlay fixed inset-0 z-[145] flex items-end justify-center p-3 backdrop-blur-sm sm:items-center sm:p-4`}
-      onClick={(event) => {
-        if (event.target === event.currentTarget) {
-          onClose();
-        }
-      }}
-    >
-      <div
-        role="dialog"
-        aria-modal="true"
-        aria-label="选择历史拼图素材"
-        className="platform-modal-shell platform-remap-surface flex max-h-[min(92vh,46rem)] w-full max-w-5xl flex-col overflow-hidden rounded-t-[1.75rem] shadow-[0_24px_80px_rgba(0,0,0,0.55)] sm:rounded-[1.75rem]"
-        onClick={(event) => event.stopPropagation()}
-      >
-        <div className="flex items-center justify-between gap-3 border-b border-[var(--platform-subpanel-border)] px-5 py-4">
-          <div className="text-base font-semibold text-[var(--platform-text-strong)]">
-            选择历史拼图素材
-          </div>
-          <button
-            type="button"
-            onClick={onClose}
-            aria-label="关闭"
-            className="platform-icon-button"
-          >
-            <X className="h-4 w-4" />
-          </button>
-        </div>
-
-        <div className="min-h-0 flex-1 overflow-y-auto px-5 py-4">
-          {error ? (
-            <div className="platform-banner platform-banner--danger text-sm leading-6">
-              {error}
-            </div>
-          ) : null}
-
-          {isLoading ? (
-            <div className="flex min-h-[14rem] items-center justify-center rounded-[1.35rem] border border-dashed border-[var(--platform-subpanel-border)] bg-white/52 px-6 text-center text-sm text-[var(--platform-text-base)]">
-              读取中...
-            </div>
-          ) : null}
-
-          {!isLoading && !error && assets.length <= 0 ? (
-            <div className="flex min-h-[14rem] items-center justify-center rounded-[1.35rem] border border-dashed border-[var(--platform-subpanel-border)] bg-white/52 px-6 text-center text-sm text-[var(--platform-text-base)]">
-              暂无历史拼图素材
-            </div>
-          ) : null}
-
-          {!isLoading && assets.length > 0 ? (
-            <div className="grid grid-cols-2 gap-3 sm:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5">
-              {assets.map((asset) => (
-                <button
-                  key={asset.assetObjectId}
-                  type="button"
-                  disabled={isBusy}
-                  onClick={() => onSelect(asset)}
-                  className={`overflow-hidden rounded-[1.25rem] border bg-white/82 text-left transition hover:border-amber-300/70 hover:bg-white ${isBusy ? 'cursor-not-allowed opacity-55' : 'border-[var(--platform-subpanel-border)]'}`}
-                >
-                  <div className="aspect-square overflow-hidden bg-[var(--platform-subpanel-fill)]">
-                    <ResolvedAssetImage
-                      src={asset.imageSrc}
-                      alt={asset.ownerLabel || '历史拼图素材'}
-                      className="h-full w-full object-cover"
-                    />
-                  </div>
-                  <div className="space-y-1 px-4 py-4">
-                    <div className="truncate text-sm font-black text-[var(--platform-text-strong)]">
-                      {asset.ownerLabel || '未记录账号'}
-                    </div>
-                    <div className="text-xs leading-5 text-[var(--platform-text-base)]">
-                      {formatHistoryAssetDate(asset.createdAt)}
-                    </div>
-                  </div>
-                </button>
-              ))}
-            </div>
-          ) : null}
-        </div>
-      </div>
-    </div>,
-    document.body,
-  );
-}
-
 function PuzzleLevelDetailDialog({
   draft,
+  generationNowMs,
+  generationRuntime,
   imageRefreshKey,
   isBusy,
   level,
@@ -607,12 +560,14 @@ function PuzzleLevelDetailDialog({
   onStartTestRun,
 }: {
   draft: PuzzleResultDraft;
+  generationNowMs: number;
+  generationRuntime: PuzzleLevelGenerationRuntime | null;
   imageRefreshKey: string;
   isBusy: boolean;
   level: PuzzleDraftLevel;
   onClose: () => void;
   onGenerate: (
-    levelId: string,
+    level: PuzzleDraftLevel,
     promptText?: string | null,
     referenceImageSrc?: string | null,
     imageModel?: PuzzleImageModelId | null,
@@ -628,10 +583,6 @@ function PuzzleLevelDetailDialog({
   );
   const [isHistoryPickerOpen, setIsHistoryPickerOpen] = useState(false);
   const [isCostConfirmOpen, setIsCostConfirmOpen] = useState(false);
-  const [isGenerationProgressActive, setIsGenerationProgressActive] =
-    useState(false);
-  const [generationCountdown, setGenerationCountdown] = useState(0);
-  const generationBusySeenRef = useRef(false);
   const [imageModel, setImageModel] = useState<PuzzleImageModelId>(
     PUZZLE_IMAGE_MODEL_GPT_IMAGE_2,
   );
@@ -639,18 +590,14 @@ function PuzzleLevelDetailDialog({
   const hasFormalImage = Boolean(formalImageSrc);
   const effectiveReferenceImageSrc =
     referenceImageSrc.trim() || level.pictureReference?.trim() || '';
-  const isGenerationProgressVisible = isGenerationProgressActive;
-  const generationSecondsLeft = isBusy
-    ? Math.max(generationCountdown, 1)
-    : generationCountdown;
-  const generationProgressPercent = Math.max(
-    6,
-    Math.round(
-      ((PUZZLE_IMAGE_GENERATION_ESTIMATE_SECONDS -
-        Math.max(generationSecondsLeft, 0)) /
-        PUZZLE_IMAGE_GENERATION_ESTIMATE_SECONDS) *
-        100,
-    ),
+  const displayImageSrc = formalImageSrc || effectiveReferenceImageSrc;
+  const displayImageAlt = formalImageSrc
+    ? level.levelName || draft.workTitle || '拼图关卡'
+    : '拼图参考图';
+  const generationProgress = resolvePuzzleLevelGenerationProgress(
+    level,
+    generationRuntime,
+    generationNowMs,
   );
 
   const handleReferenceImageChange = async (
@@ -676,54 +623,15 @@ function PuzzleLevelDetailDialog({
     }
   };
 
-  useEffect(() => {
-    if (!isGenerationProgressActive) {
-      return;
-    }
-
-    if (generationCountdown <= 0) {
-      if (!isBusy) {
-        setIsGenerationProgressActive(false);
-      }
-      return;
-    }
-
-    const timer = window.setTimeout(() => {
-      setGenerationCountdown((current) => Math.max(0, current - 1));
-    }, 1000);
-
-    return () => window.clearTimeout(timer);
-  }, [generationCountdown, isBusy, isGenerationProgressActive]);
-
-  useEffect(() => {
-    if (isGenerationProgressActive && isBusy) {
-      generationBusySeenRef.current = true;
-      return;
-    }
-
-    if (
-      isGenerationProgressActive &&
-      !isBusy &&
-      generationBusySeenRef.current
-    ) {
-      generationBusySeenRef.current = false;
-      setIsGenerationProgressActive(false);
-      setGenerationCountdown(0);
-    }
-
-    if (!isBusy) {
-      setIsCostConfirmOpen(false);
-    }
-  }, [isBusy, isGenerationProgressActive]);
-
   const executeGeneration = () => {
+    const nextLevel = {
+      ...level,
+      generationStatus: 'generating' as const,
+    };
     setIsCostConfirmOpen(false);
-    setIsGenerationProgressActive(true);
-    generationBusySeenRef.current = false;
-    setGenerationCountdown(PUZZLE_IMAGE_GENERATION_ESTIMATE_SECONDS);
     onGenerate(
-      level.levelId,
-      level.pictureDescription.trim() || undefined,
+      nextLevel,
+      nextLevel.pictureDescription.trim() || undefined,
       effectiveReferenceImageSrc || undefined,
       imageModel,
     );
@@ -780,127 +688,134 @@ function PuzzleLevelDetailDialog({
               />
             </section>
 
-            {hasFormalImage ? (
+            <div className="grid gap-4 lg:grid-cols-[minmax(13rem,0.9fr)_minmax(0,1.1fr)]">
               <section className="platform-subpanel rounded-[1.35rem] p-4">
-                <div className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
+                <div className="mb-3 text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
                   画面图
                 </div>
-                <div className="relative mt-3 aspect-square overflow-hidden rounded-[1.15rem] bg-[var(--platform-subpanel-fill)]">
-                  <ResolvedAssetImage
-                    src={formalImageSrc}
-                    refreshKey={`${imageRefreshKey}:${level.levelId}`}
-                    alt={level.levelName || draft.workTitle || '拼图关卡'}
-                    className="h-full w-full object-cover"
-                  />
-                  <button
-                    type="button"
-                    disabled={isBusy}
-                    onClick={() => setIsHistoryPickerOpen(true)}
-                    className={`absolute bottom-3 right-3 inline-flex h-10 w-10 items-center justify-center rounded-full border border-[var(--platform-subpanel-border)] bg-white/96 text-[var(--platform-text-strong)] shadow-sm transition hover:bg-[var(--platform-subpanel-fill)] ${isBusy ? 'cursor-not-allowed opacity-55' : ''}`}
-                    aria-label="从历史拼图素材库选择"
-                    title="从历史拼图素材库选择"
-                  >
-                    <Images className="h-4 w-4" />
-                  </button>
-                </div>
-              </section>
-            ) : null}
-
-            <section className="platform-subpanel rounded-[1.35rem] p-4">
-              <div className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
-                画面描述
-              </div>
-              <div className="relative mt-3">
-                <textarea
-                  value={level.pictureDescription}
-                  disabled={isBusy}
-                  rows={9}
-                  onChange={(event) =>
-                    onLevelChange({
-                      ...level,
-                      pictureDescription: event.target.value,
-                    })
-                  }
-                  className="w-full resize-none rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/90 px-4 py-3 pb-16 text-sm leading-6 text-[var(--platform-text-strong)] outline-none"
-                  aria-label="画面描述"
-                />
-                <PuzzleImageModelPicker
-                  value={imageModel}
-                  disabled={isBusy}
-                  onChange={setImageModel}
-                />
-                <label
-                  className={`absolute bottom-3 right-3 inline-flex h-10 w-10 cursor-pointer items-center justify-center rounded-full border border-amber-300/70 bg-white/96 text-amber-700 shadow-sm transition hover:bg-amber-50 ${isBusy ? 'cursor-not-allowed opacity-55' : ''}`}
-                  title={effectiveReferenceImageSrc ? '更换参考图' : '添加参考图'}
-                >
-                  <ImagePlus className="h-4 w-4" />
-                  <span className="sr-only">
-                    {effectiveReferenceImageSrc ? '更换参考图' : '添加参考图'}
-                  </span>
+                <div className="relative aspect-square overflow-hidden rounded-[1.15rem] border border-[var(--platform-subpanel-border)] bg-white/90 shadow-[0_12px_28px_rgba(15,23,42,0.08)]">
                   <input
+                    id={`puzzle-level-reference-upload-${level.levelId}`}
                     type="file"
                     accept="image/png,image/jpeg,image/webp"
                     disabled={isBusy}
+                    aria-label="上传参考图"
                     onChange={(event) => {
                       void handleReferenceImageChange(event);
                     }}
-                    className="hidden"
+                    className="sr-only"
                   />
-                </label>
-              </div>
-
-              <input
-                value={level.pictureReference ?? ''}
-                disabled={isBusy}
-                onChange={(event) =>
-                  onLevelChange({
-                    ...level,
-                    pictureReference: event.target.value,
-                  })
-                }
-                className="mt-3 w-full rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/90 px-4 py-3 text-sm text-[var(--platform-text-strong)] outline-none"
-                placeholder="参考图链接或资产ID"
-                aria-label="图面参考"
-              />
-
-              {effectiveReferenceImageSrc ? (
-                <div className="mt-3 flex items-center gap-3 rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/72 px-3 py-3">
-                  <div className="h-14 w-14 overflow-hidden rounded-[0.9rem] bg-[var(--platform-subpanel-fill)]">
-                    <ResolvedAssetImage
-                      src={effectiveReferenceImageSrc}
-                      alt="拼图参考图"
-                      className="h-full w-full object-cover"
-                    />
-                  </div>
-                  <div className="min-w-0 flex-1">
-                    <div className="truncate text-sm font-semibold text-[var(--platform-text-strong)]">
-                      {referenceImageLabel || '已选择参考图'}
-                    </div>
-                  </div>
-                  <button
-                    type="button"
-                    disabled={isBusy}
-                    onClick={() => {
-                      setReferenceImageSrc('');
-                      setReferenceImageLabel('');
-                      setReferenceImageError(null);
-                      onLevelChange({ ...level, pictureReference: null });
-                    }}
-                    className="platform-icon-button h-9 w-9"
-                    aria-label="移除参考图"
-                    title="移除参考图"
+                  <label
+                    htmlFor={`puzzle-level-reference-upload-${level.levelId}`}
+                    className={`absolute inset-0 z-0 cursor-pointer ${isBusy ? 'cursor-not-allowed' : ''}`}
+                    title={
+                      effectiveReferenceImageSrc ? '更换参考图' : '上传参考图'
+                    }
                   >
-                    <X className="h-4 w-4" />
-                  </button>
+                    <span className="sr-only">
+                      {effectiveReferenceImageSrc ? '更换参考图' : '上传参考图'}
+                    </span>
+                  </label>
+                  {displayImageSrc ? (
+                    <ResolvedAssetImage
+                      src={displayImageSrc}
+                      refreshKey={`${imageRefreshKey}:${level.levelId}`}
+                      alt={displayImageAlt}
+                      className="pointer-events-none h-full w-full object-cover"
+                    />
+                  ) : (
+                    <span className="pointer-events-none flex h-full items-center justify-center bg-[radial-gradient(circle_at_50%_28%,rgba(255,255,255,0.92),transparent_38%),linear-gradient(135deg,rgba(255,255,255,0.96),rgba(255,241,229,0.86))]">
+                      <span className="flex h-16 w-16 items-center justify-center rounded-full border border-[var(--platform-subpanel-border)] bg-white/92 text-[var(--platform-text-strong)] shadow-sm">
+                        <ImagePlus className="h-7 w-7" />
+                      </span>
+                    </span>
+                  )}
+                  {generationProgress.isGenerating ? (
+                    <div className="absolute inset-0 flex items-center justify-center bg-white/68 backdrop-blur-[2px]">
+                      <div className="flex items-center gap-2 rounded-full border border-white/80 bg-white/94 px-4 py-2 text-sm font-black text-[var(--platform-text-strong)] shadow-sm">
+                        <Loader2 className="h-4 w-4 animate-spin text-amber-600" />
+                        生成中
+                      </div>
+                    </div>
+                  ) : null}
+                  <div className="absolute bottom-3 right-3 z-10">
+                    <button
+                      type="button"
+                      disabled={isBusy}
+                      onClick={() => setIsHistoryPickerOpen(true)}
+                      className={`inline-flex items-center gap-1.5 rounded-full border border-white/80 bg-white/94 px-3 py-2 text-[11px] font-black text-[var(--platform-text-strong)] shadow-sm backdrop-blur transition hover:text-[#ff4056] ${isBusy ? 'cursor-not-allowed opacity-55' : ''}`}
+                      aria-label="选择历史图片"
+                      title="选择历史图片"
+                    >
+                      <History className="h-3.5 w-3.5" />
+                      <span>历史</span>
+                    </button>
+                  </div>
                 </div>
-              ) : null}
+                {effectiveReferenceImageSrc ? (
+                  <div className="mt-3 flex items-center gap-3 rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/72 px-3 py-3">
+                    <div className="h-12 w-12 overflow-hidden rounded-[0.85rem] bg-[var(--platform-subpanel-fill)]">
+                      <ResolvedAssetImage
+                        src={effectiveReferenceImageSrc}
+                        alt="拼图参考图"
+                        className="h-full w-full object-cover"
+                      />
+                    </div>
+                    <div className="min-w-0 flex-1">
+                      <div className="truncate text-sm font-semibold text-[var(--platform-text-strong)]">
+                        {referenceImageLabel || '已选择参考图'}
+                      </div>
+                    </div>
+                    <button
+                      type="button"
+                      disabled={isBusy}
+                      onClick={() => {
+                        setReferenceImageSrc('');
+                        setReferenceImageLabel('');
+                        setReferenceImageError(null);
+                        onLevelChange({ ...level, pictureReference: null });
+                      }}
+                      className="platform-icon-button h-9 w-9"
+                      aria-label="移除参考图"
+                      title="移除参考图"
+                    >
+                      <X className="h-4 w-4" />
+                    </button>
+                  </div>
+                ) : null}
+                {referenceImageError ? (
+                  <div className="mt-2 text-xs leading-5 text-red-600">
+                    {referenceImageError}
+                  </div>
+                ) : null}
+              </section>
 
-              {referenceImageError ? (
-                <div className="mt-2 text-xs leading-5 text-red-600">
-                  {referenceImageError}
+              <section className="platform-subpanel rounded-[1.35rem] p-4">
+                <div className="text-xs font-bold tracking-[0.18em] text-[var(--platform-text-soft)]">
+                  画面描述
                 </div>
-              ) : null}
-            </section>
+                <div className="relative mt-3">
+                  <textarea
+                    value={level.pictureDescription}
+                    disabled={isBusy}
+                    rows={7}
+                    onChange={(event) =>
+                      onLevelChange({
+                        ...level,
+                        pictureDescription: event.target.value,
+                      })
+                    }
+                    className="h-[12rem] min-h-[12rem] w-full resize-none rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/90 px-4 py-3 pb-16 text-sm leading-6 text-[var(--platform-text-strong)] outline-none sm:h-[14rem] sm:min-h-[14rem] lg:h-full lg:min-h-[18rem]"
+                    aria-label="画面描述"
+                  />
+                  <PuzzleImageModelPicker
+                    value={imageModel}
+                    disabled={isBusy}
+                    onChange={setImageModel}
+                  />
+                </div>
+              </section>
+            </div>
           </div>
         </div>
 
@@ -919,22 +834,22 @@ function PuzzleLevelDetailDialog({
             </button>
           ) : null}
 
-          {isGenerationProgressVisible ? (
+          {generationProgress.isGenerating ? (
             <div
               role="progressbar"
               aria-label="画面生成进度"
               aria-valuemin={0}
               aria-valuemax={100}
-              aria-valuenow={generationProgressPercent}
+              aria-valuenow={generationProgress.progressPercent}
               className="platform-progress-track relative h-12 overflow-hidden rounded-full"
             >
               <div
                 className="h-full rounded-full bg-amber-600 transition-[width] duration-300"
-                style={{ width: `${generationProgressPercent}%` }}
+                style={{ width: `${generationProgress.progressPercent}%` }}
               />
               <div className="absolute inset-0 flex items-center justify-center gap-2 px-4 text-sm font-bold text-white">
                 <Loader2 className="h-4 w-4 animate-spin" />
-                预计剩余 {generationSecondsLeft} 秒
+                预计剩余 {generationProgress.secondsLeft} 秒
               </div>
             </div>
           ) : (
@@ -942,12 +857,17 @@ function PuzzleLevelDetailDialog({
               type="button"
               disabled={isBusy}
               onClick={() => setIsCostConfirmOpen(true)}
-              className="inline-flex w-full items-center justify-center gap-2 rounded-full bg-amber-600 px-4 py-3 text-sm font-bold text-white disabled:opacity-45"
+              className="inline-flex w-full flex-col items-center justify-center gap-1 rounded-full bg-amber-600 px-4 py-3 text-sm font-bold text-white disabled:opacity-45"
             >
-              <Sparkles className="h-4 w-4" />
-              <span>{hasFormalImage ? '重新生成画面' : '生成画面'}</span>
-              <span className="rounded-full bg-white/24 px-2 py-0.5 text-[11px] font-bold">
-                消耗{PUZZLE_IMAGE_GENERATION_POINT_COST}光点
+              <span className="inline-flex items-center justify-center gap-2">
+                <Sparkles className="h-4 w-4" />
+                <span>{hasFormalImage ? '重新生成画面' : '生成画面'}</span>
+                <span className="rounded-full bg-white/24 px-2 py-0.5 text-[11px] font-bold">
+                  消耗{PUZZLE_IMAGE_GENERATION_POINT_COST}光点
+                </span>
+              </span>
+              <span className="text-[11px] font-semibold leading-none text-white/78">
+                等待时间可以制作更多关卡哦~
               </span>
             </button>
           )}
@@ -986,8 +906,9 @@ function PuzzleLevelDetailDialog({
                 </button>
                 <button
                   type="button"
+                  disabled={isBusy || generationProgress.isGenerating}
                   onClick={executeGeneration}
-                  className="platform-button platform-button--primary min-h-10 px-5 py-2 text-sm"
+                  className={`platform-button platform-button--primary min-h-10 px-5 py-2 text-sm ${isBusy || generationProgress.isGenerating ? 'opacity-55' : ''}`}
                 >
                   确定
                 </button>
@@ -1221,6 +1142,8 @@ function PuzzleCreativeDraftEditBar({
 
 function PuzzleLevelListTab({
   editState,
+  generationNowMs,
+  generationRuntimeByLevelId,
   imageRefreshKey,
   isBusy,
   onAddLevel,
@@ -1228,6 +1151,8 @@ function PuzzleLevelListTab({
   onOpenLevel,
 }: {
   editState: DraftEditState;
+  generationNowMs: number;
+  generationRuntimeByLevelId: Record<string, PuzzleLevelGenerationRuntime>;
   imageRefreshKey: string;
   isBusy: boolean;
   onAddLevel: () => void;
@@ -1236,10 +1161,18 @@ function PuzzleLevelListTab({
 }) {
   return (
     <div className="space-y-3">
-      <div className="grid grid-cols-1 gap-3 sm:grid-cols-2 xl:grid-cols-3">
+      <div
+        aria-label="拼图关卡列表"
+        className="grid grid-cols-1 gap-3 sm:grid-cols-2 xl:grid-cols-3"
+      >
         {editState.levels.map((level, index) => {
           const imageSrc = resolveLevelFormalImageSrc(level);
           const displayLevelName = level.levelName || `第${index + 1}关`;
+          const generationProgress = resolvePuzzleLevelGenerationProgress(
+            level,
+            generationRuntimeByLevelId[level.levelId] ?? null,
+            generationNowMs,
+          );
           return (
             <div
               key={level.levelId}
@@ -1250,7 +1183,7 @@ function PuzzleLevelListTab({
                 onClick={() => onOpenLevel(level.levelId)}
                 className="block w-full text-left"
               >
-                <div className="aspect-[4/3] overflow-hidden bg-[var(--platform-subpanel-fill)]">
+                <div className="relative aspect-[4/3] overflow-hidden bg-[var(--platform-subpanel-fill)]">
                   {imageSrc ? (
                     <ResolvedAssetImage
                       src={imageSrc}
@@ -1263,10 +1196,23 @@ function PuzzleLevelListTab({
                       暂无正式图
                     </div>
                   )}
+                  {generationProgress.isGenerating ? (
+                    <div className="absolute inset-0 flex items-center justify-center bg-white/68 backdrop-blur-[2px]">
+                      <div className="flex items-center gap-2 rounded-full border border-white/80 bg-white/94 px-3 py-1.5 text-xs font-black text-[var(--platform-text-strong)] shadow-sm">
+                        <Loader2 className="h-3.5 w-3.5 animate-spin text-amber-600" />
+                        生成中
+                      </div>
+                    </div>
+                  ) : null}
                 </div>
                 <div className="space-y-1 px-4 py-4">
-                  <div className="text-[11px] font-bold tracking-[0.16em] text-[var(--platform-text-soft)]">
-                    第{index + 1}关
+                  <div className="flex items-center justify-between gap-2 text-[11px] font-bold tracking-[0.16em] text-[var(--platform-text-soft)]">
+                    <span>第{index + 1}关</span>
+                    {generationProgress.isGenerating ? (
+                      <span className="rounded-full bg-amber-100 px-2 py-0.5 tracking-normal text-amber-700">
+                        生成中
+                      </span>
+                    ) : null}
                   </div>
                 </div>
               </button>
@@ -1452,6 +1398,10 @@ export function PuzzleResultView({
   const [tagGenerationError, setTagGenerationError] = useState<string | null>(
     null,
   );
+  const [generationRuntimeByLevelId, setGenerationRuntimeByLevelId] = useState<
+    Record<string, PuzzleLevelGenerationRuntime>
+  >({});
+  const [generationNowMs, setGenerationNowMs] = useState(() => Date.now());
   const savedEditStateRef = useRef<DraftEditState | null>(
     draft ? createDraftEditState(draft) : null,
   );
@@ -1466,8 +1416,27 @@ export function PuzzleResultView({
       return;
     }
     const nextState = createDraftEditState(draft);
-    savedEditStateRef.current = nextState;
-    setEditState(nextState);
+    setEditState((currentState) => {
+      const mergedState = mergeDraftEditStateWithIncomingState(
+        currentState,
+        nextState,
+      );
+      savedEditStateRef.current = nextState;
+      return mergedState;
+    });
+    setGenerationRuntimeByLevelId((current) => {
+      const nextRuntimes: Record<string, PuzzleLevelGenerationRuntime> = {};
+      nextState.levels.forEach((level) => {
+        if (level.generationStatus === 'generating') {
+          nextRuntimes[level.levelId] =
+            current[level.levelId] ?? {
+              startedAtMs: Date.now(),
+              estimateSeconds: PUZZLE_IMAGE_GENERATION_ESTIMATE_SECONDS,
+            };
+        }
+      });
+      return nextRuntimes;
+    });
     setActiveLevelId((currentLevelId) =>
       currentLevelId &&
       nextState.levels.some((level) => level.levelId === currentLevelId)
@@ -1492,6 +1461,45 @@ export function PuzzleResultView({
   const imageRefreshKey = `${session.updatedAt}:${primaryImageSrc}:${editState?.levels.length ?? 0}`;
   const activeLevel =
     editState?.levels.find((level) => level.levelId === activeLevelId) ?? null;
+  const hasGeneratingLevel = Boolean(
+    editState?.levels.some((level) => level.generationStatus === 'generating'),
+  );
+
+  useEffect(() => {
+    if (!hasGeneratingLevel) {
+      return;
+    }
+
+    const timer = window.setInterval(() => {
+      setGenerationNowMs(Date.now());
+    }, 1000);
+
+    return () => window.clearInterval(timer);
+  }, [hasGeneratingLevel]);
+
+  useEffect(() => {
+    if (!editState) {
+      return;
+    }
+
+    const activeGeneratingLevelIds = new Set(
+      editState.levels
+        .filter((level) => level.generationStatus === 'generating')
+        .map((level) => level.levelId),
+    );
+    setGenerationRuntimeByLevelId((current) => {
+      let changed = false;
+      const nextRuntime: Record<string, PuzzleLevelGenerationRuntime> = {};
+      Object.entries(current).forEach(([levelId, runtime]) => {
+        if (!activeGeneratingLevelIds.has(levelId)) {
+          changed = true;
+          return;
+        }
+        nextRuntime[levelId] = runtime;
+      });
+      return changed ? nextRuntime : current;
+    });
+  }, [editState]);
 
   useEffect(() => {
     if (!draft || !editState || !profileId) {
@@ -1507,6 +1515,8 @@ export function PuzzleResultView({
         ...level,
         levelName: level.levelName.trim(),
         pictureDescription: level.pictureDescription.trim(),
+        pictureReference: level.pictureReference?.trim() || null,
+        generationStatus: level.generationStatus || 'idle',
       })),
     };
     const originalState =
@@ -1580,6 +1590,26 @@ export function PuzzleResultView({
   }
 
   const updateLevel = (nextLevel: PuzzleDraftLevel) => {
+    setGenerationRuntimeByLevelId((current) => {
+      if (nextLevel.generationStatus === 'generating') {
+        return {
+          ...current,
+          [nextLevel.levelId]:
+            current[nextLevel.levelId] ?? {
+              startedAtMs: Date.now(),
+              estimateSeconds: PUZZLE_IMAGE_GENERATION_ESTIMATE_SECONDS,
+            },
+        };
+      }
+
+      if (!current[nextLevel.levelId]) {
+        return current;
+      }
+
+      const nextRuntime = { ...current };
+      delete nextRuntime[nextLevel.levelId];
+      return nextRuntime;
+    });
     setEditState((currentState) =>
       currentState
         ? {
@@ -1627,6 +1657,8 @@ export function PuzzleResultView({
         {activeTab === 'levels' ? (
           <PuzzleLevelListTab
             editState={editState}
+            generationNowMs={generationNowMs}
+            generationRuntimeByLevelId={generationRuntimeByLevelId}
             imageRefreshKey={imageRefreshKey}
             isBusy={isBusy}
             onAddLevel={() => {
@@ -1721,23 +1753,33 @@ export function PuzzleResultView({
       {activeLevel ? (
         <PuzzleLevelDetailDialog
           draft={syncedDraft}
+          generationNowMs={generationNowMs}
+          generationRuntime={
+            generationRuntimeByLevelId[activeLevel.levelId] ?? null
+          }
           imageRefreshKey={imageRefreshKey}
           isBusy={isBusy}
           level={activeLevel}
           onClose={() => setActiveLevelId(null)}
-          onGenerate={(levelId, promptText, referenceImageSrc, imageModel) => {
+          onGenerate={(nextLevel, promptText, referenceImageSrc, imageModel) => {
+            updateLevel(nextLevel);
             onExecuteAction({
               action: 'generate_puzzle_images',
-              levelId,
+              levelId: nextLevel.levelId,
               promptText,
               referenceImageSrc,
               imageModel: imageModel ?? PUZZLE_IMAGE_MODEL_GPT_IMAGE_2,
+              aiRedraw: true,
               candidateCount: 1,
               workTitle: editState.workTitle.trim(),
               workDescription: editState.workDescription.trim(),
               summary: editState.workDescription.trim(),
               themeTags: editState.themeTags,
-              levelsJson: JSON.stringify(editState.levels),
+              levelsJson: JSON.stringify(
+                editState.levels.map((level) =>
+                  level.levelId === nextLevel.levelId ? nextLevel : level,
+                ),
+              ),
             });
           }}
           onLevelChange={updateLevel}
diff --git a/src/components/puzzle-runtime/PuzzleRuntimeShell.test.tsx b/src/components/puzzle-runtime/PuzzleRuntimeShell.test.tsx
index 9030b32a..ccd65bbc 100644
--- a/src/components/puzzle-runtime/PuzzleRuntimeShell.test.tsx
+++ b/src/components/puzzle-runtime/PuzzleRuntimeShell.test.tsx
@@ -207,7 +207,8 @@ test('拼图界面在 mocap open_palm 时显示体感光标', () => {
 
   const cursor = screen.getByTestId('puzzle-mocap-cursor');
   expect(cursor).toBeTruthy();
-  expect(cursor).toHaveStyle({left: '42%', top: '58%'});
+  expect(cursor.style.left).toBe('42%');
+  expect(cursor.style.top).toBe('58%');
   mocapMock.state = 'grab';
 });
 
@@ -813,6 +814,7 @@ test('基础单块使用圆角裁剪图片', () => {
   ) as HTMLElement | null;
   expect(basePiece?.className).toContain('overflow-hidden');
   expect(basePiece?.className).toContain('rounded-[0.85rem]');
+  expect(basePiece?.querySelector('.puzzle-runtime-piece-overlay')).toBeNull();
 });
 
 test('移动端点击拼图片时立即触发一次震动反馈', () => {
diff --git a/src/components/puzzle-runtime/PuzzleRuntimeShell.tsx b/src/components/puzzle-runtime/PuzzleRuntimeShell.tsx
index 944d2a2c..1af82ea0 100644
--- a/src/components/puzzle-runtime/PuzzleRuntimeShell.tsx
+++ b/src/components/puzzle-runtime/PuzzleRuntimeShell.tsx
@@ -1347,7 +1347,6 @@ export function PuzzleRuntimeShell({
                         ) : (
                           <div className="absolute inset-0 bg-[linear-gradient(145deg,rgba(251,191,36,0.4),rgba(76,29,19,0.72))]" />
                         )}
-                        <div className="puzzle-runtime-piece-overlay absolute inset-0" />
                       </div>
                     ) : (
                       ''
@@ -2000,7 +1999,7 @@ export function PuzzleRuntimeShell({
                     排行榜
                   </div>
                   <div className="puzzle-runtime-dialog__line overflow-hidden rounded-[1rem] border">
-                    <div className="puzzle-runtime-leaderboard-head grid grid-cols-[3.5rem_minmax(0,1fr)_6rem] px-3 py-2 text-[11px] font-bold">
+                    <div className="puzzle-runtime-leaderboard-head grid grid-cols-[3rem_minmax(0,1fr)_5.75rem] px-3 py-2 text-[11px] font-bold">
                       <span>名次</span>
                       <span>昵称</span>
                       <span className="text-right">通关时间</span>
@@ -2010,7 +2009,7 @@ export function PuzzleRuntimeShell({
                         leaderboardEntries.map((entry) => (
                           <div
                             key={`${entry.rank}:${entry.nickname}:${entry.elapsedMs}`}
-                            className={`grid grid-cols-[3.5rem_minmax(0,1fr)_6rem] items-center px-3 py-2.5 text-sm ${
+                            className={`grid min-h-[3.25rem] grid-cols-[3rem_minmax(0,1fr)_5.75rem] items-center gap-x-2 px-3 py-2.5 text-sm ${
                               entry.isCurrentPlayer
                                 ? 'puzzle-runtime-leaderboard-row--active'
                                 : 'puzzle-runtime-leaderboard-row border-t'
@@ -2019,8 +2018,22 @@ export function PuzzleRuntimeShell({
                             <span className="font-mono font-black">
                               #{entry.rank}
                             </span>
-                            <span className="truncate font-semibold">
-                              {entry.nickname}
+                            <span className="min-w-0">
+                              <span className="block truncate font-semibold leading-tight">
+                                {entry.nickname}
+                              </span>
+                              {entry.visibleTags?.length ? (
+                                <span className="puzzle-runtime-leaderboard-tags">
+                                  {entry.visibleTags.map((tag) => (
+                                    <span
+                                      className="puzzle-runtime-leaderboard-tag"
+                                      key={tag}
+                                    >
+                                      {tag}
+                                    </span>
+                                  ))}
+                                </span>
+                              ) : null}
                             </span>
                             <span className="text-right font-mono text-xs font-bold">
                               {formatElapsedMs(entry.elapsedMs)}
@@ -2112,7 +2125,7 @@ function PuzzleNextWorkCard({
         ) : (
           <div className="h-full w-full bg-[linear-gradient(145deg,rgba(20,184,166,0.34),rgba(15,23,42,0.88))]" />
         )}
-        <div className="puzzle-runtime-piece-overlay absolute inset-0 transition group-hover:opacity-0" />
+        <div className="puzzle-runtime-next-card-overlay absolute inset-0 transition group-hover:opacity-0" />
       </div>
       <div className="min-w-0 px-3 py-2.5">
         <div className="truncate text-sm font-black">
diff --git a/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx b/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
index 14397ddd..c8934efb 100644
--- a/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
+++ b/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
@@ -67,6 +67,7 @@ import {
 } from '../../services/match3d-works';
 import {
   createPuzzleAgentSession,
+  executePuzzleAgentAction,
   getPuzzleAgentSession,
 } from '../../services/puzzle-agent';
 import {
@@ -463,9 +464,17 @@ vi.mock('../puzzle-agent/PuzzleAgentWorkspace', () => ({
 
 vi.mock('../puzzle-result/PuzzleResultView', () => ({
   PuzzleResultView: ({
+    isBusy,
+    onExecuteAction,
     session,
     onBack,
   }: {
+    isBusy?: boolean;
+    onExecuteAction: (payload: {
+      action: string;
+      levelId?: string;
+      promptText?: string;
+    }) => void;
     session: { draft?: { levelName: string } | null };
     onBack: () => void;
   }) => (
@@ -475,6 +484,21 @@ vi.mock('../puzzle-result/PuzzleResultView', () => ({
         关卡名
         <input readOnly value={session.draft?.levelName ?? ''} />
       </label>
+      <button
+        type="button"
+        onClick={() => {
+          onExecuteAction({
+            action: 'generate_puzzle_images',
+            levelId: 'puzzle-level-1',
+            promptText: '重新生成猫街',
+          });
+        }}
+      >
+        重新生成画面
+      </button>
+      <button type="button" disabled={isBusy}>
+        新增关卡
+      </button>
       <button type="button" onClick={onBack}>
         返回
       </button>
@@ -550,14 +574,36 @@ vi.mock('../big-fish-result/BigFishResultView', () => ({
 vi.mock('../match3d-creation/Match3DAgentWorkspace', () => ({
   Match3DAgentWorkspace: ({
     session,
+    onCreateFromForm,
   }: {
     session: { sessionId: string; messages: Array<{ text: string }> } | null;
+    onCreateFromForm?: (payload: {
+      seedText: string;
+      themeText: string;
+      referenceImageSrc: string | null;
+      clearCount: number;
+      difficulty: number;
+    }) => void;
   }) => (
     <div className="match3d-agent-workspace-mock">
       <div>抓大鹅工作区：{session?.sessionId ?? 'missing-session'}</div>
       {session?.messages.map((message) => (
         <div key={`${session.sessionId}-${message.text}`}>{message.text}</div>
       ))}
+      <button
+        type="button"
+        onClick={() => {
+          onCreateFromForm?.({
+            seedText: '赛博水果摊题材，消除9次，难度6',
+            themeText: '赛博水果摊',
+            referenceImageSrc: null,
+            clearCount: 9,
+            difficulty: 6,
+          });
+        }}
+      >
+        生成抓大鹅草稿
+      </button>
     </div>
   ),
 }));
@@ -2355,6 +2401,9 @@ test('create tab shows template tabs and embeds puzzle form by default', async (
   expect(
     screen.getByRole('tab', { name: 'AIRP' }).querySelector('img')?.src,
   ).toContain('/creation-type-references/airp.webp');
+  expect(
+    screen.getByRole('tab', { name: '抓大鹅' }).querySelector('img')?.src,
+  ).toContain('/creation-type-references/match3d.webp');
   expect(
     screen.getByRole('tab', { name: '拼图' }).querySelector('.text-white'),
   ).toBeTruthy();
@@ -2364,12 +2413,29 @@ test('create tab shows template tabs and embeds puzzle form by default', async (
   expect(screen.queryByRole('button', { name: /智能创作/u })).toBeNull();
   expect(screen.queryByPlaceholderText('问一问百梦')).toBeNull();
   expect(screen.queryByRole('button', { name: /角色扮演/u })).toBeNull();
-  expect(screen.queryByRole('tab', { name: /抓大鹅/u })).toBeNull();
   expect(createRpgCreationSession).not.toHaveBeenCalled();
   expect(match3dCreationClient.createSession).not.toHaveBeenCalled();
   expect(createPuzzleAgentSession).not.toHaveBeenCalled();
 });
 
+test('create tab switches match3d into the embedded entry form', async () => {
+  const user = userEvent.setup();
+
+  render(<TestWrapper withAuth />);
+
+  await openCreateTemplateHub(user);
+  await user.click(screen.getByRole('tab', { name: '抓大鹅' }));
+
+  expect(
+    screen.getByRole('tab', { name: '抓大鹅' }).getAttribute('aria-selected'),
+  ).toBe('true');
+  expect(
+    await screen.findByText('抓大鹅工作区：missing-session'),
+  ).toBeTruthy();
+  expect(createPuzzleAgentSession).not.toHaveBeenCalled();
+  expect(match3dCreationClient.createSession).not.toHaveBeenCalled();
+});
+
 test('embedded puzzle form routes through requireAuth while logged out', async () => {
   const user = userEvent.setup();
   const requireAuth = vi.fn();
@@ -2826,6 +2892,159 @@ test('owned public puzzle detail edits original draft instead of remixing', asyn
   expect(getPuzzleAgentSession).toHaveBeenCalledWith('puzzle-session-1');
   expect(remixPuzzleGalleryWork).not.toHaveBeenCalled();
   expect(await screen.findByText('拼图结果页')).toBeTruthy();
+
+  vi.mocked(executePuzzleAgentAction).mockResolvedValueOnce({
+    operation: {
+      operationId: 'puzzle-image-generation-1',
+      type: 'generate_puzzle_images',
+      status: 'running',
+      phaseLabel: '生成中',
+      phaseDetail: '正在生成拼图画面',
+      progress: 0.3,
+    },
+    session: {
+      sessionId: 'puzzle-session-1',
+      currentTurn: 3,
+      progressPercent: 88,
+      stage: 'ready_to_publish',
+      anchorPack: {
+        themePromise: {
+          key: 'theme_promise',
+          label: '主题承诺',
+          value: '雨夜猫街',
+          status: 'confirmed',
+        },
+        visualSubject: {
+          key: 'visual_subject',
+          label: '视觉主体',
+          value: '屋檐下的猫',
+          status: 'confirmed',
+        },
+        visualMood: {
+          key: 'visual_mood',
+          label: '视觉气质',
+          value: '温暖',
+          status: 'confirmed',
+        },
+        compositionHooks: {
+          key: 'composition_hooks',
+          label: '构图钩子',
+          value: '雨滴与灯牌',
+          status: 'confirmed',
+        },
+        tagsAndForbidden: {
+          key: 'tags_and_forbidden',
+          label: '标签与禁区',
+          value: '猫咪、雨夜',
+          status: 'confirmed',
+        },
+      },
+      draft: {
+        workTitle: '暖灯猫街作品',
+        workDescription: '一套雨夜猫街主题拼图。',
+        levelName: '雨夜猫街',
+        summary: '屋檐下的猫与暖灯街角。',
+        themeTags: ['猫咪', '雨夜', '暖灯'],
+        forbiddenDirectives: [],
+        creatorIntent: null,
+        anchorPack: {
+          themePromise: {
+            key: 'theme_promise',
+            label: '主题承诺',
+            value: '雨夜猫街',
+            status: 'confirmed',
+          },
+          visualSubject: {
+            key: 'visual_subject',
+            label: '视觉主体',
+            value: '屋檐下的猫',
+            status: 'confirmed',
+          },
+          visualMood: {
+            key: 'visual_mood',
+            label: '视觉气质',
+            value: '温暖',
+            status: 'confirmed',
+          },
+          compositionHooks: {
+            key: 'composition_hooks',
+            label: '构图钩子',
+            value: '雨滴与灯牌',
+            status: 'confirmed',
+          },
+          tagsAndForbidden: {
+            key: 'tags_and_forbidden',
+            label: '标签与禁区',
+            value: '猫咪、雨夜',
+            status: 'confirmed',
+          },
+        },
+        candidates: [
+          {
+            candidateId: 'candidate-1',
+            imageSrc: '/puzzle/candidate-1.png',
+            assetId: 'asset-1',
+            prompt: '雨夜猫咪',
+            actualPrompt: null,
+            sourceType: 'generated',
+            selected: true,
+          },
+        ],
+        selectedCandidateId: 'candidate-1',
+        coverImageSrc: '/puzzle/candidate-1.png',
+        coverAssetId: 'asset-1',
+        generationStatus: 'generating',
+        levels: [
+          {
+            levelId: 'puzzle-level-1',
+            levelName: '雨夜猫街',
+            pictureDescription: '屋檐下的猫与暖灯街角。',
+            pictureReference: null,
+            candidates: [
+              {
+                candidateId: 'candidate-1',
+                imageSrc: '/puzzle/candidate-1.png',
+                assetId: 'asset-1',
+                prompt: '雨夜猫咪',
+                actualPrompt: null,
+                sourceType: 'generated',
+                selected: true,
+              },
+            ],
+            selectedCandidateId: 'candidate-1',
+            coverImageSrc: '/puzzle/candidate-1.png',
+            coverAssetId: 'asset-1',
+            generationStatus: 'generating',
+          },
+        ],
+        metadata: null,
+      },
+      messages: [],
+      lastAssistantReply: '大鱼结果页草稿已经生成，可以补正式资产。',
+      publishedProfileId: null,
+      suggestedActions: [],
+      resultPreview: {
+        draft: null,
+        publishReady: false,
+        blockers: [],
+        qualityFindings: [],
+      },
+      updatedAt: '2026-04-26T10:10:00.000Z',
+    },
+  });
+
+  await user.click(screen.getByRole('button', { name: '重新生成画面' }));
+
+  expect(executePuzzleAgentAction).toHaveBeenCalledWith(
+    'puzzle-session-1',
+    expect.objectContaining({
+      action: 'generate_puzzle_images',
+    }),
+  );
+  expect(screen.getByRole('button', { name: '新增关卡' })).toHaveProperty(
+    'disabled',
+    false,
+  );
 });
 
 test('logged out public detail gates big fish start before local runtime', async () => {
@@ -3027,7 +3246,6 @@ test('published puzzle works appear on home and mobile game category channel', a
 });
 
 test('home recommendation starts embedded puzzle without global auth reset on local failure', async () => {
-  const user = userEvent.setup();
   const publishedPuzzleWork = {
     workId: 'puzzle-work-public-1',
     profileId: 'puzzle-profile-public-1',
@@ -3396,7 +3614,7 @@ test('embedded puzzle form timeout exits busy state and shows a readable error',
   expect(streamCreativeAgentMessage).not.toHaveBeenCalled();
 });
 
-test('hidden match3d creation card stays closed even when public galleries fail', async () => {
+test('match3d creation tab stays usable even when public galleries fail', async () => {
   const user = userEvent.setup();
 
   vi.mocked(listRpgEntryWorldGallery).mockRejectedValueOnce(
@@ -3411,9 +3629,7 @@ test('hidden match3d creation card stays closed even when public galleries fail'
   await openCreateTemplateHub(user);
   expect(screen.queryByText('读取作品广场失败')).toBeNull();
   expect(screen.queryByText('读取抓大鹅广场失败')).toBeNull();
-  expect(
-    screen.queryByRole('tab', { name: /抓大鹅.*经典消除玩法/u }),
-  ).toBeNull();
+  expect(screen.getByRole('tab', { name: '抓大鹅' })).toBeTruthy();
   expect(match3dCreationClient.createSession).not.toHaveBeenCalled();
 });
 
diff --git a/src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx b/src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx
index c4c7d118..5a67bbfe 100644
--- a/src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx
+++ b/src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx
@@ -1312,6 +1312,8 @@ test('logged in recommend runtime preloads adjacent work previews and drag switc
   vi.useFakeTimers();
   const onSelectNextRecommendEntry = vi.fn();
   const onSelectPreviousRecommendEntry = vi.fn();
+  const onLikeRecommendEntry = vi.fn();
+  const onRemixRecommendEntry = vi.fn();
   const firstEntry = {
     ...puzzlePublicEntry,
     workId: 'puzzle-work-feed-1',
@@ -1397,6 +1399,8 @@ test('logged in recommend runtime preloads adjacent work previews and drag switc
         activeRecommendEntryKey="puzzle:user-feed-1:puzzle-profile-feed-1"
         onSelectNextRecommendEntry={onSelectNextRecommendEntry}
         onSelectPreviousRecommendEntry={onSelectPreviousRecommendEntry}
+        onLikeRecommendEntry={onLikeRecommendEntry}
+        onRemixRecommendEntry={onRemixRecommendEntry}
         onOpenLibraryDetail={vi.fn()}
         onSearchPublicCode={vi.fn()}
       />
@@ -1412,8 +1416,38 @@ test('logged in recommend runtime preloads adjacent work previews and drag switc
   ).toHaveLength(3);
   expect(screen.getAllByText('下一拼图').length).toBeGreaterThanOrEqual(2);
   expect(screen.getAllByText('上一拼图').length).toBeGreaterThanOrEqual(2);
+  expect(screen.queryByText('评论')).toBeNull();
+  expect(screen.queryByLabelText(/游玩/u)).toBeNull();
+  const clipboardWriteText = vi.fn().mockResolvedValue(undefined);
+  Object.defineProperty(navigator, 'clipboard', {
+    configurable: true,
+    value: { writeText: clipboardWriteText },
+  });
 
   const meta = screen.getByLabelText('当前拼图 作品信息') as HTMLElement;
+  const activeRecommendCard = within(meta);
+  const likeButton = activeRecommendCard.getByRole('button', {
+    name: '点赞 12',
+  });
+  expect(likeButton).toBeTruthy();
+  expect(activeRecommendCard.getByLabelText('12 个赞')).toBeTruthy();
+  const shareButton = activeRecommendCard.getByRole('button', { name: '分享' });
+  const remixButton = activeRecommendCard.getByRole('button', {
+    name: '改造 5',
+  });
+  expect(shareButton).toBeTruthy();
+  expect(remixButton).toBeTruthy();
+
+  fireEvent.click(likeButton);
+  fireEvent.click(shareButton);
+  fireEvent.click(remixButton);
+
+  expect(onLikeRecommendEntry).toHaveBeenCalledWith(firstEntry);
+  expect(onRemixRecommendEntry).toHaveBeenCalledWith(firstEntry);
+  expect(clipboardWriteText).toHaveBeenCalledWith(
+    expect.stringContaining('作品号：PZ-FEED1'),
+  );
+
   act(() => {
     dispatchPointerEvent(meta, 'pointerdown', { pointerId: 1, clientY: 300 });
     dispatchPointerEvent(meta, 'pointermove', { pointerId: 1, clientY: 210 });
diff --git a/src/components/rpg-entry/RpgEntryHomeView.tsx b/src/components/rpg-entry/RpgEntryHomeView.tsx
index 92f55331..00703710 100644
--- a/src/components/rpg-entry/RpgEntryHomeView.tsx
+++ b/src/components/rpg-entry/RpgEntryHomeView.tsx
@@ -9,6 +9,7 @@ import {
   Coins,
   Compass,
   Copy,
+  GitFork,
   Gamepad2,
   Heart,
   LogIn,
@@ -16,10 +17,12 @@ import {
   Pencil,
   Plus,
   Search,
+  Share2,
   Settings,
   SlidersHorizontal,
   Sparkles,
   Star,
+  ThumbsUp,
   Ticket,
   UserPlus,
   UserRound,
@@ -54,6 +57,7 @@ import type {
   RedeemProfileRewardCodeResponse,
 } from '../../../packages/shared/src/contracts/runtime';
 import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
+import { buildPublicWorkDetailUrl } from '../../routing/appPageRoutes';
 import type { AuthUser } from '../../services/authService';
 import {
   getPublicAuthUserByCode,
@@ -86,6 +90,7 @@ import {
   isVisualNovelGalleryEntry,
   type PlatformPublicGalleryCard,
   type PlatformWorldCardLike,
+  resolvePlatformPublicWorkCode,
   resolvePlatformWorldCoverImage,
   resolvePlatformWorldCoverSlides,
   resolvePlatformWorldLeadPortrait,
@@ -126,6 +131,8 @@ export interface RpgEntryHomeViewProps {
   recommendRuntimeError?: string | null;
   onSelectNextRecommendEntry?: () => void;
   onSelectPreviousRecommendEntry?: () => void;
+  onLikeRecommendEntry?: (entry: PlatformPublicGalleryCard) => void;
+  onRemixRecommendEntry?: (entry: PlatformPublicGalleryCard) => void;
   onOpenLibraryDetail: (
     entry: CustomWorldLibraryEntry<CustomWorldProfile>,
   ) => void;
@@ -772,19 +779,27 @@ function RecommendSwipeCard({
   authorAvatarUrl,
   isActive,
   visual,
+  shareState,
   onDragPointerDown,
   onDragPointerMove,
   onDragPointerUp,
   onDragPointerCancel,
+  onLike,
+  onShare,
+  onRemix,
 }: {
   entry: PlatformPublicGalleryCard;
   authorAvatarUrl?: string | null;
   isActive: boolean;
   visual: ReactNode;
+  shareState?: 'idle' | 'copied' | 'failed';
   onDragPointerDown?: (event: PointerEvent<HTMLElement>) => void;
   onDragPointerMove?: (event: PointerEvent<HTMLElement>) => void;
   onDragPointerUp?: (event: PointerEvent<HTMLElement>) => void;
   onDragPointerCancel?: (event: PointerEvent<HTMLElement>) => void;
+  onLike?: () => void;
+  onShare?: () => void;
+  onRemix?: () => void;
 }) {
   return (
     <div
@@ -797,10 +812,14 @@ function RecommendSwipeCard({
           entry={entry}
           authorAvatarUrl={authorAvatarUrl}
           isActive={isActive}
+          shareState={shareState}
           onDragPointerDown={onDragPointerDown}
           onDragPointerMove={onDragPointerMove}
           onDragPointerUp={onDragPointerUp}
           onDragPointerCancel={onDragPointerCancel}
+          onLike={onLike}
+          onShare={onShare}
+          onRemix={onRemix}
         />
       </div>
     </div>
@@ -814,6 +833,10 @@ function RecommendRuntimeMeta({
   onDragPointerMove,
   onDragPointerUp,
   onDragPointerCancel,
+  shareState = 'idle',
+  onLike,
+  onShare,
+  onRemix,
   isActive = true,
 }: {
   entry: PlatformPublicGalleryCard;
@@ -822,20 +845,21 @@ function RecommendRuntimeMeta({
   onDragPointerMove?: (event: PointerEvent<HTMLElement>) => void;
   onDragPointerUp?: (event: PointerEvent<HTMLElement>) => void;
   onDragPointerCancel?: (event: PointerEvent<HTMLElement>) => void;
+  shareState?: 'idle' | 'copied' | 'failed';
+  onLike?: () => void;
+  onShare?: () => void;
+  onRemix?: () => void;
   isActive?: boolean;
 }) {
-  const playCount = getPlatformWorldPlayCount(entry);
-  const remixCount = getPlatformWorldRemixCount(entry);
   const likeCount = getPlatformWorldLikeCount(entry);
+  const remixCount = getPlatformWorldRemixCount(entry);
   const authorName = entry.authorDisplayName.trim() || '玩家';
   const authorAvatarLabel = getPublicAuthorAvatarLabel(authorName);
   const normalizedAuthorAvatarUrl = authorAvatarUrl?.trim() ?? '';
   const displayName = formatPlatformWorkDisplayName(entry.worldName);
-  const statItems = [
-    { label: '游玩', value: playCount, icon: Gamepad2 },
-    { label: '点赞', value: likeCount, icon: Heart },
-    { label: '改造', value: remixCount, icon: MessageCircle },
-  ];
+  const stopActionPointer = (event: PointerEvent<HTMLButtonElement>) => {
+    event.stopPropagation();
+  };
 
   return (
     <section
@@ -854,19 +878,6 @@ function RecommendRuntimeMeta({
       onPointerUp={onDragPointerUp}
       onPointerCancel={onDragPointerCancel}
     >
-      <div className="platform-recommend-work-meta__stats">
-        {statItems.map(({ label, value, icon: Icon }) => (
-          <span
-            key={label}
-            className="platform-recommend-work-meta__stat"
-            aria-label={`${label} ${formatCompactCount(value)}`}
-          >
-            <Icon className="h-4 w-4" aria-hidden="true" />
-            <span>{formatCompactCount(value)}</span>
-          </span>
-        ))}
-      </div>
-
       <div className="platform-recommend-work-meta__row">
         <div
           className="platform-recommend-work-meta__identity"
@@ -894,6 +905,62 @@ function RecommendRuntimeMeta({
             </span>
           </span>
         </div>
+        <div className="platform-recommend-work-meta__actions">
+          <button
+            type="button"
+            className="platform-recommend-work-meta__action platform-recommend-work-meta__action--icon platform-recommend-work-meta__action--like"
+            onPointerDown={stopActionPointer}
+            onClick={(event) => {
+              event.stopPropagation();
+              onLike?.();
+            }}
+            disabled={!isActive || !onLike}
+            aria-label={`点赞 ${formatCompactCount(likeCount)}`}
+            title="点赞"
+          >
+            <ThumbsUp className="h-5 w-5" aria-hidden="true" />
+          </button>
+          <span
+            className="platform-recommend-work-meta__like-count"
+            aria-label={`${formatCompactCount(likeCount)} 个赞`}
+          >
+            {formatCompactCount(likeCount)}
+          </span>
+          <button
+            type="button"
+            className="platform-recommend-work-meta__action platform-recommend-work-meta__action--icon"
+            onPointerDown={stopActionPointer}
+            onClick={(event) => {
+              event.stopPropagation();
+              onShare?.();
+            }}
+            disabled={!isActive || !onShare}
+            aria-label={
+              shareState === 'copied'
+                ? '分享内容已复制'
+                : shareState === 'failed'
+                  ? '分享内容复制失败'
+                  : '分享'
+            }
+            title="分享"
+          >
+            <Share2 className="h-5 w-5" aria-hidden="true" />
+          </button>
+          <button
+            type="button"
+            className="platform-recommend-work-meta__action platform-recommend-work-meta__action--icon platform-recommend-work-meta__action--remix"
+            onPointerDown={stopActionPointer}
+            onClick={(event) => {
+              event.stopPropagation();
+              onRemix?.();
+            }}
+            disabled={!isActive || !onRemix}
+            aria-label={`改造 ${formatCompactCount(remixCount)}`}
+            title="改造"
+          >
+            <GitFork className="h-5 w-5" aria-hidden="true" />
+          </button>
+        </div>
       </div>
     </section>
   );
@@ -2977,6 +3044,8 @@ export function RpgEntryHomeView({
   recommendRuntimeError = null,
   onSelectNextRecommendEntry,
   onSelectPreviousRecommendEntry,
+  onLikeRecommendEntry,
+  onRemixRecommendEntry,
   onOpenLibraryDetail,
   onDeleteLibraryEntry,
   deletingLibraryEntryId = null,
@@ -3863,6 +3932,10 @@ export function RpgEntryHomeView({
   const [recommendDragOffsetY, setRecommendDragOffsetY] = useState(0);
   const [recommendDragCommitDirection, setRecommendDragCommitDirection] =
     useState<1 | -1 | null>(null);
+  const [recommendShareState, setRecommendShareState] = useState<
+    'idle' | 'copied' | 'failed'
+  >('idle');
+  const recommendShareResetTimerRef = useRef<number | null>(null);
   const recommendCardStageRef = useRef<HTMLDivElement | null>(null);
   const recommendDragStartRef = useRef<{
     pointerId: number;
@@ -4005,6 +4078,36 @@ export function RpgEntryHomeView({
     onSelectNextRecommendEntry,
     recommendedFeedEntries.length,
   ]);
+  useEffect(
+    () => () => {
+      if (recommendShareResetTimerRef.current !== null) {
+        window.clearTimeout(recommendShareResetTimerRef.current);
+      }
+    },
+    [],
+  );
+  useEffect(() => {
+    setRecommendShareState('idle');
+  }, [activeRecommendEntryKey]);
+  const shareRecommendEntry = useCallback((entry: PlatformPublicGalleryCard) => {
+    const publicWorkCode = resolvePlatformPublicWorkCode(entry)?.trim();
+    if (!publicWorkCode) {
+      setRecommendShareState('failed');
+      return;
+    }
+
+    const shareText = `邀请你来玩《${entry.worldName}》\n作品号：${publicWorkCode}\n${buildPublicWorkDetailUrl(publicWorkCode)}`;
+    void copyTextToClipboard(shareText).then((copied) => {
+      setRecommendShareState(copied ? 'copied' : 'failed');
+      if (recommendShareResetTimerRef.current !== null) {
+        window.clearTimeout(recommendShareResetTimerRef.current);
+      }
+      recommendShareResetTimerRef.current = window.setTimeout(() => {
+        recommendShareResetTimerRef.current = null;
+        setRecommendShareState('idle');
+      }, 1400);
+    });
+  }, []);
   const openActiveRecommendEntry = useCallback(() => {
     if (!activeRecommendEntry) {
       return;
@@ -4168,6 +4271,10 @@ export function RpgEntryHomeView({
                 onDragPointerMove={moveRecommendDrag}
                 onDragPointerUp={endRecommendDrag}
                 onDragPointerCancel={cancelRecommendDrag}
+                shareState={recommendShareState}
+                onLike={() => onLikeRecommendEntry?.(activeRecommendEntry)}
+                onShare={() => shareRecommendEntry(activeRecommendEntry)}
+                onRemix={() => onRemixRecommendEntry?.(activeRecommendEntry)}
               />
             </div>
 
diff --git a/src/components/visual-novel-creation/VisualNovelAgentWorkspace.test.tsx b/src/components/visual-novel-creation/VisualNovelAgentWorkspace.test.tsx
index 31034e9a..ec9c1282 100644
--- a/src/components/visual-novel-creation/VisualNovelAgentWorkspace.test.tsx
+++ b/src/components/visual-novel-creation/VisualNovelAgentWorkspace.test.tsx
@@ -1,123 +1,101 @@
 /* @vitest-environment jsdom */
 
 import type { ComponentProps } from 'react';
-import { render, screen } from '@testing-library/react';
-import userEvent from '@testing-library/user-event';
+import { fireEvent, render, screen } from '@testing-library/react';
 import { expect, test, vi } from 'vitest';
 
 import { buildVisualNovelForbiddenCopyPattern } from '../visual-novel-runtime/visualNovelForbiddenCopy';
 import { mockVisualNovelSession } from '../visual-novel-runtime/visualNovelMockData';
-import { VisualNovelAgentWorkspace } from './VisualNovelAgentWorkspace';
-import { AuthUiContext } from '../auth/AuthUiContext';
+import {
+  buildVisualNovelEntryGenerationAnchorEntries,
+  buildVisualNovelEntryGenerationProgress,
+  VisualNovelAgentWorkspace,
+} from './VisualNovelAgentWorkspace';
 
-vi.mock('../../services/creation-agent/creationAgentDocumentInput', () => ({
-  parseCreationAgentDocumentInput: vi.fn(),
-}));
-
-vi.mock('../../services/visual-novel-creation', () => ({
-  uploadVisualNovelAsset: vi.fn(),
-}));
-
-const mockedParseCreationAgentDocumentInput = vi.mocked(
-  await import('../../services/creation-agent/creationAgentDocumentInput'),
-);
-const mockedVisualNovelAssetClient = vi.mocked(
-  await import('../../services/visual-novel-creation'),
-);
-
-function renderWorkspace(ui?: Partial<ComponentProps<typeof VisualNovelAgentWorkspace>>) {
+function renderWorkspace(
+  ui?: Partial<ComponentProps<typeof VisualNovelAgentWorkspace>>,
+) {
   return render(
-    <AuthUiContext.Provider
-      value={
-        {
-          user: { id: 'user-1' },
-          platformTheme: 'light',
-        } as never
-      }
-    >
-      <VisualNovelAgentWorkspace
-        session={mockVisualNovelSession}
-        onBack={() => {}}
-        {...ui}
-      />
-    </AuthUiContext.Provider>,
+    <VisualNovelAgentWorkspace onBack={() => {}} session={null} {...ui} />,
   );
 }
 
-test('visual novel workspace renders mock creation shell without forbidden entry', async () => {
-  const user = userEvent.setup();
-  const onOpenResult = vi.fn();
+test('visual novel workspace only exposes one-line input and visual style entry', () => {
+  const onCreateFromForm = vi.fn();
 
-  renderWorkspace({ onOpenResult });
+  renderWorkspace({ onCreateFromForm });
 
-  expect(screen.getByRole('heading', { name: '视觉小说' })).toBeTruthy();
-  expect(screen.getByRole('button', { name: '一句话' })).toBeTruthy();
+  expect(screen.getByLabelText('一句话创作')).toBeTruthy();
+  expect(screen.getByText('视觉画风')).toBeTruthy();
+  expect(screen.getByRole('button', { name: '映画动画' })).toBeTruthy();
+  expect(screen.getByRole('button', { name: '水彩绘本' })).toBeTruthy();
+  expect(screen.getByText('消耗20光点')).toBeTruthy();
   expect(screen.queryByText(buildVisualNovelForbiddenCopyPattern())).toBeNull();
-
-  await user.click(screen.getByRole('button', { name: '进入结果页' }));
-
-  expect(onOpenResult).toHaveBeenCalledWith(mockVisualNovelSession);
+  expect(screen.queryByRole('button', { name: '文档' })).toBeNull();
+  expect(screen.queryByRole('button', { name: '空白' })).toBeNull();
+  expect(screen.queryByLabelText('上传文档')).toBeNull();
+  expect(screen.queryByText('进入结果页')).toBeNull();
+  expect(screen.queryByText('Agent')).toBeNull();
 });
 
-test('visual novel workspace opens editable blank draft from blank source', async () => {
-  const user = userEvent.setup();
-  const onOpenResult = vi.fn();
+test('visual novel workspace submits idea and selected visual style as seed text', () => {
+  const onCreateFromForm = vi.fn();
 
-  renderWorkspace({ session: null, onOpenResult });
+  renderWorkspace({ onCreateFromForm });
 
-  await user.click(screen.getByRole('button', { name: '空白' }));
-  const openResultButtons = screen.getAllByRole('button', {
-    name: '进入结果页',
+  fireEvent.change(screen.getByLabelText('一句话创作'), {
+    target: { value: '失忆画师在雨夜剧场寻找旧胶片。' },
   });
-  await user.click(openResultButtons[0]!);
+  fireEvent.click(screen.getByRole('button', { name: '像素霓虹' }));
+  fireEvent.click(
+    screen.getByRole('button', { name: /生成视觉小说草稿/u }),
+  );
 
-  expect(onOpenResult).toHaveBeenCalledTimes(1);
-  const session = onOpenResult.mock.calls[0]?.[0];
-  expect(session?.sourceMode).toBe('blank');
-  expect(session?.draft?.sourceMode).toBe('blank');
-  expect(session?.draft?.runtimeConfig.textModeEnabled).toBe(true);
+  expect(onCreateFromForm).toHaveBeenCalledWith({
+    sourceMode: 'idea',
+    sourceAssetIds: [],
+    ideaText: '失忆画师在雨夜剧场寻找旧胶片。',
+    visualStyleId: 'pixel-noir',
+    visualStyleLabel: '像素霓虹',
+    visualStylePrompt:
+      '高可读像素视觉小说画风，霓虹反差、硬朗轮廓和复古界面气质。',
+    seedText:
+      '失忆画师在雨夜剧场寻找旧胶片。\n视觉画风：像素霓虹\n画风要求：高可读像素视觉小说画风，霓虹反差、硬朗轮廓和复古界面气质。',
+  });
 });
 
-test('visual novel workspace uploads document asset and passes asset id to session', async () => {
-  const user = userEvent.setup();
-  const onCreateSession = vi.fn();
-  const parseMock = mockedParseCreationAgentDocumentInput.parseCreationAgentDocumentInput;
-  const uploadMock = mockedVisualNovelAssetClient.uploadVisualNovelAsset;
+test('visual novel workspace restores idea text from existing session', () => {
+  renderWorkspace({ session: mockVisualNovelSession });
 
-  parseMock.mockResolvedValue({
-    document: {
-      fileName: '世界设定.docx',
-      contentType: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
-      sizeBytes: 128,
-      text: '第一章\n雨夜书店\n第二章\n失踪乘客',
-      sourceAssetId: 'asset-doc-source',
-    },
-  });
-  uploadMock.mockResolvedValue({
-    assetObjectId: 'asset-doc-1',
-    assetKind: 'visual_novel_document',
-    objectKey: 'generated-character-drafts/visual-novel/draft/document/1.docx',
-    imageSrc: '/generated-character-drafts/visual-novel/draft/document/1.docx',
-  });
-
-  renderWorkspace({ session: null, onCreateSession });
-
-  await user.click(screen.getByRole('button', { name: '文档' }));
-  const fileInput = screen.getByLabelText('上传文档') as HTMLInputElement;
-  const file = new File(['first chapter'], '世界设定.docx', {
-    type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
-  });
-  await user.upload(fileInput, file);
-
-  await user.click(screen.getByRole('button', { name: '生成底稿' }));
-
-  expect(parseMock).toHaveBeenCalledTimes(1);
-  expect(uploadMock).toHaveBeenCalledTimes(1);
-  expect(onCreateSession).toHaveBeenCalledWith(
-    expect.objectContaining({
-      sourceMode: 'document',
-      sourceAssetIds: ['asset-doc-1'],
-      seedText: expect.stringContaining('第一章'),
-    }),
+  expect((screen.getByLabelText('一句话创作') as HTMLTextAreaElement).value).toBe(
+    '想做一个雪夜列车和旧电台有关的悬疑视觉小说。',
   );
 });
+
+test('visual novel generation helpers build process page data', () => {
+  const payload = {
+    sourceMode: 'idea' as const,
+    seedText:
+      '雨夜书店\n视觉画风：水彩绘本\n画风要求：透明水彩与绘本质感。',
+    sourceAssetIds: [],
+    ideaText: '雨夜书店',
+    visualStyleId: 'watercolor' as const,
+    visualStyleLabel: '水彩绘本',
+    visualStylePrompt: '透明水彩与绘本质感。',
+  };
+
+  expect(buildVisualNovelEntryGenerationAnchorEntries(payload)).toEqual([
+    { id: 'visual-novel-idea', label: '一句话', value: '雨夜书店' },
+    { id: 'visual-novel-style', label: '视觉画风', value: '水彩绘本' },
+  ]);
+
+  const progress = buildVisualNovelEntryGenerationProgress(
+    1_000,
+    'generating',
+    8_000,
+  );
+
+  expect(progress.phaseId).toBe('generating');
+  expect(progress.overallProgress).toBeGreaterThan(0);
+  expect(progress.steps.some((step) => step.status === 'active')).toBe(true);
+});
diff --git a/src/components/visual-novel-creation/VisualNovelAgentWorkspace.tsx b/src/components/visual-novel-creation/VisualNovelAgentWorkspace.tsx
index 132e2a88..854bbca6 100644
--- a/src/components/visual-novel-creation/VisualNovelAgentWorkspace.tsx
+++ b/src/components/visual-novel-creation/VisualNovelAgentWorkspace.tsx
@@ -1,70 +1,146 @@
-import {
-  ArrowLeft,
-  FileText,
-  Loader2,
-  PenLine,
-  Upload,
-  Send,
-  Sparkles,
-} from 'lucide-react';
-import { type ChangeEvent, useMemo, useRef, useState } from 'react';
+import { ArrowLeft, Loader2, Sparkles, WandSparkles } from 'lucide-react';
+import { useEffect, useMemo, useRef, useState } from 'react';
 
+import type { CustomWorldGenerationProgress } from '../../../packages/shared/src/contracts/runtime';
 import type {
   CreateVisualNovelSessionRequest,
-  ExecuteVisualNovelAgentActionRequest,
-  SendVisualNovelMessageRequest,
   VisualNovelAgentSessionSnapshot,
-  VisualNovelSourceMode,
 } from '../../../packages/shared/src/contracts/visualNovel';
-import { useAuthUi } from '../auth/AuthUiContext';
-import { parseCreationAgentDocumentInput } from '../../services/creation-agent/creationAgentDocumentInput';
-import { uploadVisualNovelAsset } from '../../services/visual-novel-creation';
-import {
-  createBlankVisualNovelDraft,
-  createMockVisualNovelSessionFromDraft,
-  mockVisualNovelSession,
-} from '../visual-novel-runtime/visualNovelMockData';
+import type { CustomWorldStructuredAnchorEntry } from '../../services/customWorldAgentGenerationProgress';
 
 type VisualNovelAgentWorkspaceProps = {
   session?: VisualNovelAgentSessionSnapshot | null;
   isBusy?: boolean;
   error?: string | null;
-  streamingReplyText?: string;
   onBack: () => void;
-  onCreateSession?: (payload: CreateVisualNovelSessionRequest) => void;
-  onSubmitMessage?: (payload: SendVisualNovelMessageRequest) => void;
-  onExecuteAction?: (payload: ExecuteVisualNovelAgentActionRequest) => void;
-  onOpenResult?: (session: VisualNovelAgentSessionSnapshot) => void;
+  onCreateFromForm?: (payload: VisualNovelEntryFormPayload) => void;
+  initialFormPayload?: VisualNovelEntryFormPayload | null;
+  showBackButton?: boolean;
+  title?: string | null;
 };
 
-const SOURCE_OPTIONS: Array<{
-  id: VisualNovelSourceMode;
-  label: string;
-  icon: typeof PenLine;
-}> = [
-  { id: 'idea', label: '一句话', icon: Sparkles },
-  { id: 'document', label: '文档', icon: FileText },
-  { id: 'blank', label: '空白', icon: PenLine },
-];
+export type VisualNovelEntryFormPayload = Omit<
+  CreateVisualNovelSessionRequest,
+  'seedText' | 'sourceMode' | 'sourceAssetIds'
+> & {
+  sourceMode: 'idea';
+  seedText: string;
+  sourceAssetIds: string[];
+  ideaText: string;
+  visualStyleId: VisualNovelStyleOptionId;
+  visualStyleLabel: string;
+  visualStylePrompt: string;
+};
 
-function buildClientMessageId() {
-  return `vn-message-${Date.now()}-${Math.round(Math.random() * 1_000_000)}`;
+type VisualNovelFormState = {
+  ideaText: string;
+  visualStyleId: VisualNovelStyleOptionId;
+};
+
+const VISUAL_NOVEL_STYLE_OPTIONS = [
+  {
+    id: 'cinematic-anime',
+    label: '映画动画',
+    prompt: '电影感动画视觉小说画风，光影层次清晰，角色立绘精致，背景有景深。',
+  },
+  {
+    id: 'watercolor',
+    label: '水彩绘本',
+    prompt: '透明水彩与绘本质感，色彩柔和，边缘带手绘晕染，适合温柔叙事。',
+  },
+  {
+    id: 'pixel-noir',
+    label: '像素霓虹',
+    prompt: '高可读像素视觉小说画风，霓虹反差、硬朗轮廓和复古界面气质。',
+  },
+  {
+    id: 'ink-fantasy',
+    label: '水墨幻想',
+    prompt: '东方水墨幻想画风，留白、墨色层次和淡彩点染并重。',
+  },
+  {
+    id: 'soft-pastel',
+    label: '柔彩校园',
+    prompt: '柔和粉彩校园画风，干净明亮，角色表情细腻，日常氛围轻盈。',
+  },
+  {
+    id: 'dark-gothic',
+    label: '暗色哥特',
+    prompt: '暗色哥特视觉小说画风，深色场景、烛光高光和华丽服装细节。',
+  },
+] as const;
+
+type VisualNovelStyleOptionId =
+  (typeof VISUAL_NOVEL_STYLE_OPTIONS)[number]['id'];
+
+const EMPTY_FORM_STATE: VisualNovelFormState = {
+  ideaText: '',
+  visualStyleId: 'cinematic-anime',
+};
+
+function getVisualNovelStyleOption(optionId: VisualNovelStyleOptionId) {
+  return (
+    VISUAL_NOVEL_STYLE_OPTIONS.find((option) => option.id === optionId) ??
+    VISUAL_NOVEL_STYLE_OPTIONS[0]
+  );
 }
 
-function clampDocumentSeedText(value: string) {
-  return value.trim().replace(/\s+/gu, ' ').slice(0, 4000);
+function resolveStyleOptionId(
+  value: string | null | undefined,
+): VisualNovelStyleOptionId {
+  return (
+    VISUAL_NOVEL_STYLE_OPTIONS.find((option) => option.id === value)?.id ??
+    'cinematic-anime'
+  );
 }
 
-function VisualNovelSourceButton({
+function resolveIdeaTextFromSession(
+  session: VisualNovelAgentSessionSnapshot | null | undefined,
+) {
+  const userText =
+    session?.messages.find((message) => message.role === 'user')?.text ?? '';
+  return userText
+    .replace(/视觉画风[:：][^\n]*(\n|$)/u, '')
+    .replace(/画风要求[:：][^\n]*(\n|$)/u, '')
+    .trim();
+}
+
+function resolveInitialFormState(
+  session: VisualNovelAgentSessionSnapshot | null | undefined,
+  initialFormPayload: VisualNovelEntryFormPayload | null = null,
+): VisualNovelFormState {
+  return {
+    ...EMPTY_FORM_STATE,
+    ideaText:
+      initialFormPayload?.ideaText?.trim() ||
+      resolveIdeaTextFromSession(session) ||
+      '',
+    visualStyleId: resolveStyleOptionId(initialFormPayload?.visualStyleId),
+  };
+}
+
+function buildVisualNovelSeedText(
+  ideaText: string,
+  visualStyleLabel: string,
+  visualStylePrompt: string,
+) {
+  return [
+    ideaText.trim(),
+    `视觉画风：${visualStyleLabel}`,
+    `画风要求：${visualStylePrompt}`,
+  ]
+    .filter(Boolean)
+    .join('\n');
+}
+
+function VisualNovelStyleButton({
   active,
   disabled,
-  icon: Icon,
   label,
   onClick,
 }: {
   active: boolean;
   disabled: boolean;
-  icon: typeof PenLine;
   label: string;
   onClick: () => void;
 }) {
@@ -73,353 +149,349 @@ function VisualNovelSourceButton({
       type="button"
       disabled={disabled}
       aria-pressed={active}
+      aria-label={label}
       onClick={onClick}
-      className={`flex min-h-16 min-w-0 items-center gap-3 rounded-[1.1rem] border px-3 text-left transition ${
+      className={`relative h-[4.45rem] w-[5.2rem] shrink-0 snap-start overflow-hidden rounded-[0.9rem] border p-0 text-left transition sm:h-[5.2rem] sm:w-[6.1rem] ${
         active
-          ? 'border-[var(--platform-button-primary-border)] bg-[var(--platform-nav-active-fill)] text-[var(--platform-text-strong)]'
-          : 'border-[var(--platform-subpanel-border)] bg-white/72 text-[var(--platform-text-base)] hover:bg-white'
+          ? 'border-[#ff4056] ring-1 ring-inset ring-[#ff4056]'
+          : 'border-[var(--platform-subpanel-border)]'
       } ${disabled ? 'cursor-not-allowed opacity-55' : ''}`}
     >
-      <span className="grid h-10 w-10 shrink-0 place-items-center rounded-full bg-white/80">
-        <Icon className="h-4 w-4" />
+      <span className="absolute inset-0 bg-[linear-gradient(135deg,rgba(255,255,255,0.98),rgba(244,247,255,0.9))]" />
+      <span className="absolute inset-0 bg-[radial-gradient(circle_at_30%_20%,rgba(255,255,255,0.95),transparent_28%),linear-gradient(135deg,rgba(255,64,86,0.18),rgba(56,189,248,0.18))]" />
+      <span className="absolute inset-0 bg-[linear-gradient(180deg,rgba(3,7,18,0.02)_0%,rgba(3,7,18,0.1)_42%,rgba(3,7,18,0.82)_100%)]" />
+      <span className="absolute inset-x-2 bottom-1.5 truncate rounded-full bg-black/26 px-1.5 py-0.5 text-center text-[11px] font-black text-white [text-shadow:0_1px_6px_rgba(0,0,0,0.9)]">
+        {label}
       </span>
-      <span className="min-w-0 truncate text-sm font-black">{label}</span>
     </button>
   );
 }
 
 export function VisualNovelAgentWorkspace({
-  session = mockVisualNovelSession,
+  session = null,
   isBusy = false,
   error = null,
-  streamingReplyText = '',
   onBack,
-  onCreateSession,
-  onSubmitMessage,
-  onExecuteAction,
-  onOpenResult,
+  onCreateFromForm,
+  initialFormPayload = null,
+  showBackButton = true,
+  title = null,
 }: VisualNovelAgentWorkspaceProps) {
-  const [sourceMode, setSourceMode] = useState<VisualNovelSourceMode>(
-    session?.sourceMode ?? 'idea',
+  const [formState, setFormState] = useState<VisualNovelFormState>(() =>
+    resolveInitialFormState(session, initialFormPayload),
   );
-  const [seedText, setSeedText] = useState(
-    session?.messages.find((message) => message.role === 'user')?.text ?? '',
+  const appliedInitialFormKeyRef = useRef<string | null>(null);
+
+  useEffect(() => {
+    const nextInitialFormKey =
+      session?.sessionId ?? JSON.stringify(initialFormPayload ?? null);
+    if (appliedInitialFormKeyRef.current === nextInitialFormKey) {
+      return;
+    }
+
+    appliedInitialFormKeyRef.current = nextInitialFormKey;
+    setFormState(resolveInitialFormState(session, initialFormPayload));
+  }, [initialFormPayload, session]);
+
+  const ideaText = formState.ideaText.trim();
+  const selectedStyleOption = getVisualNovelStyleOption(
+    formState.visualStyleId,
   );
-  const [documentAssetId, setDocumentAssetId] = useState(
-    session?.draft?.sourceAssetIds[0] ?? '',
-  );
-  const [documentAssetLabel, setDocumentAssetLabel] = useState('');
-  const [documentUploadError, setDocumentUploadError] = useState<string | null>(
-    null,
-  );
-  const [isDocumentUploading, setIsDocumentUploading] = useState(false);
-  const [messageText, setMessageText] = useState('');
-  const displaySession = session ?? mockVisualNovelSession;
-  const draft = displaySession.draft;
-  const authUi = useAuthUi();
-  const documentFileInputRef = useRef<HTMLInputElement | null>(null);
-  const canStart =
-    !isBusy &&
-    ((sourceMode === 'blank') ||
-      (sourceMode === 'idea' && Boolean(seedText.trim())) ||
-      (sourceMode === 'document' && Boolean(documentAssetId.trim())));
-  const canSend = !isBusy && messageText.trim();
-  const pendingAction = displaySession.pendingAction;
-  const progressItems = useMemo(
-    () => [
-      { label: '世界观', value: draft?.world.title || '-' },
-      { label: '角色', value: `${draft?.characters.length ?? 0}` },
-      { label: '场景', value: `${draft?.scenes.length ?? 0}` },
-      { label: '阶段', value: `${draft?.storyPhases.length ?? 0}` },
-    ],
-    [draft],
+  const formPayload = useMemo<VisualNovelEntryFormPayload>(
+    () => ({
+      sourceMode: 'idea',
+      seedText: buildVisualNovelSeedText(
+        ideaText,
+        selectedStyleOption.label,
+        selectedStyleOption.prompt,
+      ),
+      sourceAssetIds: [],
+      ideaText,
+      visualStyleId: selectedStyleOption.id,
+      visualStyleLabel: selectedStyleOption.label,
+      visualStylePrompt: selectedStyleOption.prompt,
+    }),
+    [ideaText, selectedStyleOption],
   );
+  const canSubmit = Boolean(ideaText && !isBusy);
 
   const startDraft = () => {
-    if (!canStart) {
+    if (!canSubmit) {
       return;
     }
 
-    if (sourceMode === 'blank') {
-      const blankSession = createMockVisualNovelSessionFromDraft(
-        createBlankVisualNovelDraft('blank'),
-      );
-      onOpenResult?.(blankSession);
-      return;
-    }
-
-    onCreateSession?.({
-      sourceMode,
-      seedText: seedText.trim() || null,
-      sourceAssetIds:
-        sourceMode === 'document' && documentAssetId.trim()
-          ? [documentAssetId.trim()]
-          : [],
-    });
-  };
-
-  const handleDocumentFileChange = async (event: ChangeEvent<HTMLInputElement>) => {
-    const file = event.target.files?.[0];
-    event.currentTarget.value = '';
-    if (!file) {
-      return;
-    }
-
-    setIsDocumentUploading(true);
-    setDocumentUploadError(null);
-    try {
-      const parsed = await parseCreationAgentDocumentInput(file);
-      const uploadedAsset = await uploadVisualNovelAsset({
-        kind: 'document',
-        file,
-        ownerUserId: authUi?.user?.id ?? null,
-      });
-      setDocumentAssetId(uploadedAsset.assetObjectId);
-      setDocumentAssetLabel(file.name.trim() || parsed.document.fileName);
-      setSeedText(clampDocumentSeedText(parsed.document.text));
-    } catch (uploadError) {
-      setDocumentUploadError(
-        uploadError instanceof Error
-          ? uploadError.message
-          : '文档上传失败，请稍后重试。',
-      );
-    } finally {
-      setIsDocumentUploading(false);
-    }
-  };
-
-  const submitMessage = () => {
-    const text = messageText.trim();
-    if (!text || isBusy) {
-      return;
-    }
-    onSubmitMessage?.({
-      clientMessageId: buildClientMessageId(),
-      text,
-    });
-    setMessageText('');
+    onCreateFromForm?.(formPayload);
   };
 
   return (
-    <div className="platform-remap-surface mx-auto flex h-full min-h-0 w-full max-w-6xl flex-col">
-      <div className="mb-4 flex items-center justify-between gap-3">
-        <button
-          type="button"
-          onClick={onBack}
-          disabled={isBusy}
-          className="platform-button platform-button--ghost min-h-0 self-start px-3 py-1.5 text-[11px]"
-        >
-          <ArrowLeft className="h-3.5 w-3.5" />
-          返回
-        </button>
-      </div>
+    <div className="platform-remap-surface mx-auto flex h-full min-h-0 w-full max-w-5xl flex-col overflow-hidden">
+      {showBackButton ? (
+        <div className="mb-3 flex shrink-0 items-center justify-between gap-3 sm:mb-4">
+          <button
+            type="button"
+            onClick={onBack}
+            disabled={isBusy}
+            className={`platform-button platform-button--ghost min-h-0 self-start px-3 py-1.5 text-[11px] ${isBusy ? 'opacity-45' : ''}`}
+          >
+            <ArrowLeft className="h-3.5 w-3.5" />
+            返回
+          </button>
+        </div>
+      ) : null}
 
-      <div className="min-h-0 flex-1 overflow-y-auto pr-1">
-        <div className="grid gap-4 lg:grid-cols-[minmax(0,0.9fr)_minmax(20rem,0.55fr)]">
-          <section className="platform-subpanel rounded-[1.45rem] p-4 sm:p-5">
-            <div className="mb-4">
-              <h1 className="m-0 text-3xl font-black leading-tight text-[var(--platform-text-strong)] sm:text-5xl">
-                视觉小说
+      <div className="flex min-h-0 flex-1 flex-col overflow-hidden pr-0">
+        {title ? (
+          <div className="mb-3 shrink-0 sm:mb-5">
+            <div className="flex flex-wrap items-center gap-2">
+              <h1 className="m-0 text-3xl font-black leading-none tracking-normal text-[var(--platform-text-strong)] sm:text-7xl">
+                {title}
               </h1>
+              <span className="rounded-full border border-rose-200 bg-rose-50 px-3 py-1 text-[11px] font-black text-rose-700">
+                BETA
+              </span>
             </div>
+          </div>
+        ) : null}
 
-            <div className="grid grid-cols-1 gap-2 sm:grid-cols-3">
-              {SOURCE_OPTIONS.map((option) => (
-                <VisualNovelSourceButton
-                  key={option.id}
-                  active={sourceMode === option.id}
-                  disabled={isBusy}
-                  icon={option.icon}
-                  label={option.label}
-                  onClick={() => setSourceMode(option.id)}
-                />
-              ))}
-            </div>
-
-            {sourceMode === 'document' ? (
-              <div className="mt-3 space-y-2">
-                <div className="flex flex-wrap items-center gap-2">
-                  <button
-                    type="button"
-                    disabled={isBusy || isDocumentUploading}
-                    onClick={() => documentFileInputRef.current?.click()}
-                    className="platform-button platform-button--secondary min-h-10 px-4 py-2 text-sm"
-                  >
-                    {isDocumentUploading ? (
-                      <Loader2 className="h-4 w-4 animate-spin" />
-                    ) : (
-                      <Upload className="h-4 w-4" />
-                    )}
-                    {documentAssetId ? '重新上传文档' : '上传平台文档'}
-                  </button>
-                  {documentAssetId ? (
-                    <span className="rounded-full border border-[var(--platform-subpanel-border)] bg-white/72 px-3 py-2 text-xs font-semibold text-[var(--platform-text-base)]">
-                      {documentAssetLabel || '已绑定平台文档'}
-                    </span>
-                  ) : null}
-                  <input
-                    ref={documentFileInputRef}
-                    type="file"
-                    accept=".txt,.md,.markdown,.docx,.csv,.json"
-                    disabled={isBusy || isDocumentUploading}
-                    onChange={(event) => {
-                      void handleDocumentFileChange(event);
-                    }}
-                    className="hidden"
-                    aria-label="上传文档"
-                  />
-                </div>
-                {documentAssetId ? (
-                  <div className="truncate rounded-[1rem] border border-[var(--platform-subpanel-border)] bg-white/72 px-4 py-2 text-xs font-semibold text-[var(--platform-text-soft)]">
-                    资产 ID：{documentAssetId}
-                  </div>
-                ) : null}
-                {documentUploadError ? (
-                  <div className="rounded-[1rem] border border-rose-200/50 bg-rose-500/10 px-4 py-2 text-sm leading-6 text-rose-700">
-                    {documentUploadError}
-                  </div>
-                ) : null}
-              </div>
-            ) : null}
-
-            <label className="mt-4 block">
-              <span className="sr-only">创作想法</span>
+        <section className="flex min-h-0 flex-1 flex-col overflow-hidden">
+          <div
+            className={`grid min-h-0 flex-1 grid-rows-[minmax(0,1fr)_auto] gap-2 sm:gap-3 lg:grid-cols-[minmax(0,1.1fr)_minmax(16rem,0.9fr)] lg:grid-rows-1 ${isBusy ? 'opacity-55' : ''}`}
+          >
+            <label className="block min-h-0">
+              <span className="mb-2 block text-sm font-black text-[var(--platform-text-strong)]">
+                一句话创作
+              </span>
               <textarea
-                value={seedText}
-                disabled={isBusy || sourceMode === 'blank'}
-                rows={8}
-                onChange={(event) => setSeedText(event.target.value)}
-                placeholder={
-                  sourceMode === 'document'
-                    ? '粘贴文档摘要或选择平台文档资产'
-                    : sourceMode === 'blank'
-                      ? '空白创建将直接进入结果页'
-                      : '雪夜列车、旧电台、失踪乘客'
+                value={formState.ideaText}
+                disabled={isBusy}
+                rows={5}
+                placeholder=""
+                onChange={(event) =>
+                  setFormState((current) => ({
+                    ...current,
+                    ideaText: event.target.value,
+                  }))
                 }
-                className="w-full resize-none rounded-[1.15rem] border border-[var(--platform-subpanel-border)] bg-white/88 px-4 py-4 text-base leading-7 text-[var(--platform-text-strong)] outline-none placeholder:text-zinc-400 disabled:opacity-60"
-                aria-label="创作想法"
+                className="h-full min-h-[7.75rem] w-full resize-none rounded-[1.15rem] border border-[var(--platform-subpanel-border)] bg-white/90 px-4 py-3 text-base leading-6 text-[var(--platform-text-strong)] outline-none sm:min-h-[9rem] lg:min-h-[14rem]"
+                aria-label="一句话创作"
               />
             </label>
 
+            <div className="flex min-h-0 flex-col gap-2 overflow-hidden">
+              <div className="min-h-0">
+                <div className="mb-1.5 text-sm font-black text-[var(--platform-text-strong)]">
+                  视觉画风
+                </div>
+                <div
+                  className="flex snap-x gap-2 overflow-x-auto overscroll-x-contain pb-1 scrollbar-hide touch-pan-x [-webkit-overflow-scrolling:touch]"
+                  aria-label="视觉画风"
+                >
+                  {VISUAL_NOVEL_STYLE_OPTIONS.map((option) => (
+                    <VisualNovelStyleButton
+                      key={option.id}
+                      active={formState.visualStyleId === option.id}
+                      disabled={isBusy}
+                      label={option.label}
+                      onClick={() =>
+                        setFormState((current) => ({
+                          ...current,
+                          visualStyleId: option.id,
+                        }))
+                      }
+                    />
+                  ))}
+                </div>
+              </div>
+            </div>
+          </div>
+
+          <div className="mt-2 shrink-0 space-y-3">
             {error ? (
-              <div className="platform-banner platform-banner--danger mt-3 rounded-2xl text-sm leading-6">
+              <div className="platform-banner platform-banner--danger rounded-2xl text-sm leading-6">
                 {error}
               </div>
             ) : null}
-
-            <div className="mt-4 flex justify-end">
-              <button
-                type="button"
-                disabled={!canStart}
-                onClick={startDraft}
-                className="platform-button platform-button--primary min-h-11 px-5 py-3"
-              >
-                {isBusy ? <Loader2 className="h-4 w-4 animate-spin" /> : null}
-                <Sparkles className="h-4 w-4" />
-                {sourceMode === 'blank' ? '进入结果页' : '生成底稿'}
-              </button>
-            </div>
-          </section>
-
-          <aside className="platform-subpanel flex min-h-[22rem] flex-col rounded-[1.45rem] p-4 sm:p-5">
-            <div className="grid grid-cols-4 gap-2">
-              {progressItems.map((item) => (
-                <div
-                  key={item.label}
-                  className="min-w-0 rounded-[0.9rem] bg-white/72 px-2 py-2 text-center"
-                >
-                  <div className="truncate text-[11px] font-bold text-[var(--platform-text-soft)]">
-                    {item.label}
-                  </div>
-                  <div className="mt-1 truncate text-sm font-black text-[var(--platform-text-strong)]">
-                    {item.value}
-                  </div>
-                </div>
-              ))}
-            </div>
-
-            <div className="mt-4 min-h-0 flex-1 space-y-3 overflow-y-auto pr-1">
-              {displaySession.messages.map((message) => (
-                <div
-                  key={message.id}
-                  className={`max-w-[88%] rounded-[1.1rem] px-3 py-2 text-sm leading-6 ${
-                    message.role === 'user'
-                      ? 'ml-auto bg-[var(--platform-button-primary-fill)] text-[var(--platform-button-primary-text)]'
-                      : 'bg-white/78 text-[var(--platform-text-strong)]'
-                  }`}
-                >
-                  {message.text}
-                </div>
-              ))}
-              {streamingReplyText ? (
-                <div className="max-w-[88%] rounded-[1.1rem] bg-white/78 px-3 py-2 text-sm leading-6 text-[var(--platform-text-strong)]">
-                  {streamingReplyText}
-                </div>
-              ) : null}
-            </div>
-
-            {pendingAction ? (
-              <button
-                type="button"
-                disabled={isBusy}
-                onClick={() =>
-                  onExecuteAction?.({
-                    actionId: pendingAction.actionId,
-                    kind: pendingAction.kind,
-                    targetId: pendingAction.targetId ?? null,
-                    payload: pendingAction.payload,
-                  })
-                }
-                className="platform-button platform-button--secondary mt-4 min-h-11 justify-center px-4 py-3"
-              >
-                {isBusy ? <Loader2 className="h-4 w-4 animate-spin" /> : null}
-                <Sparkles className="h-4 w-4" />
-                {pendingAction.label || '执行操作'}
-              </button>
-            ) : null}
-
-            <div className="mt-4 flex gap-2">
-              <input
-                value={messageText}
-                disabled={isBusy}
-                onChange={(event) => setMessageText(event.target.value)}
-                onKeyDown={(event) => {
-                  if (event.key === 'Enter' && !event.shiftKey) {
-                    event.preventDefault();
-                    submitMessage();
-                  }
-                }}
-                className="min-h-11 min-w-0 flex-1 rounded-full border border-[var(--platform-subpanel-border)] bg-white/88 px-4 text-sm text-[var(--platform-text-strong)] outline-none"
-                placeholder="补充设定"
-                aria-label="补充设定"
-              />
-              <button
-                type="button"
-                disabled={!canSend}
-                onClick={submitMessage}
-                className="platform-icon-button h-11 w-11"
-                aria-label="发送"
-                title="发送"
-              >
-                <Send className="h-4 w-4" />
-              </button>
-            </div>
-          </aside>
-        </div>
+          </div>
+        </section>
       </div>
 
-      <div className="mt-4 flex justify-end pb-[max(0.25rem,env(safe-area-inset-bottom))]">
+      <div className="mt-2 flex shrink-0 justify-center pb-[max(0.25rem,env(safe-area-inset-bottom))] sm:mt-3">
         <button
           type="button"
-          disabled={isBusy || !displaySession.draft}
-          onClick={() => onOpenResult?.(displaySession)}
-          className="platform-button platform-button--primary min-h-11 px-5 py-3"
+          disabled={!canSubmit}
+          onClick={startDraft}
+          className={`platform-button platform-button--primary min-h-10 px-4 py-2 text-sm sm:min-h-11 sm:px-5 ${!canSubmit ? 'cursor-not-allowed opacity-55' : ''}`}
         >
-          进入结果页
+          <span className="inline-flex flex-wrap items-center justify-center gap-1.5 sm:gap-2">
+            {isBusy ? <Loader2 className="h-4 w-4 animate-spin" /> : null}
+            {session ? (
+              <Sparkles className="h-4 w-4" />
+            ) : (
+              <WandSparkles className="h-4 w-4" />
+            )}
+            <span>生成视觉小说草稿</span>
+            <span className="rounded-full bg-white/24 px-2 py-0.5 text-[11px] font-bold">
+              消耗20光点
+            </span>
+          </span>
         </button>
       </div>
     </div>
   );
 }
 
+export function buildVisualNovelEntryGenerationAnchorEntries(
+  payload: VisualNovelEntryFormPayload | null | undefined,
+): CustomWorldStructuredAnchorEntry[] {
+  if (!payload) {
+    return [];
+  }
+
+  return [
+    {
+      id: 'visual-novel-idea',
+      label: '一句话',
+      value: payload.ideaText,
+    },
+    {
+      id: 'visual-novel-style',
+      label: '视觉画风',
+      value: payload.visualStyleLabel,
+    },
+  ].filter((entry) => entry.value.trim());
+}
+
+export function buildVisualNovelEntryGenerationProgress(
+  startedAtMs: number | null,
+  phase: 'generating' | 'ready' | 'failed',
+  nowMs = Date.now(),
+): CustomWorldGenerationProgress {
+  const elapsedMs = startedAtMs ? Math.max(0, nowMs - startedAtMs) : 0;
+  const timeline: [
+    {
+      id: string;
+      label: string;
+      detail: string;
+      weight: number;
+      durationMs: number;
+    },
+    {
+      id: string;
+      label: string;
+      detail: string;
+      weight: number;
+      durationMs: number;
+    },
+    {
+      id: string;
+      label: string;
+      detail: string;
+      weight: number;
+      durationMs: number;
+    },
+  ] = [
+    {
+      id: 'visual-novel-session',
+      label: '创建创作会话',
+      detail: '写入一句话与视觉画风，准备生成视觉小说底稿。',
+      weight: 24,
+      durationMs: 5_000,
+    },
+    {
+      id: 'visual-novel-draft',
+      label: '生成故事底稿',
+      detail: '整理世界观、角色、场景和剧情阶段。',
+      weight: 56,
+      durationMs: 22_000,
+    },
+    {
+      id: 'visual-novel-ready',
+      label: '准备草稿页',
+      detail: '校验可编辑字段并进入草稿页。',
+      weight: 20,
+      durationMs: 4_000,
+    },
+  ];
+  let elapsedBeforeStep = 0;
+  const activeStepIndex =
+    phase === 'ready'
+      ? timeline.length - 1
+      : timeline.findIndex((step) => {
+          const elapsedInStep = elapsedMs - elapsedBeforeStep;
+          const isActive = elapsedInStep < step.durationMs;
+          if (!isActive) {
+            elapsedBeforeStep += step.durationMs;
+          }
+          return isActive;
+        });
+  const normalizedActiveStepIndex =
+    activeStepIndex >= 0 ? activeStepIndex : timeline.length - 1;
+  const activeStep = timeline[normalizedActiveStepIndex] ?? timeline[0];
+  const activeElapsed =
+    elapsedMs -
+    timeline
+      .slice(0, normalizedActiveStepIndex)
+      .reduce((sum, step) => sum + step.durationMs, 0);
+  const activeRatio =
+    phase === 'ready'
+      ? 1
+      : phase === 'failed'
+        ? 0
+        : Math.max(0, Math.min(1, activeElapsed / activeStep.durationMs));
+  const completedWeight = timeline
+    .slice(0, phase === 'ready' ? timeline.length : normalizedActiveStepIndex)
+    .reduce((sum, step) => sum + step.weight, 0);
+  const overallProgress =
+    phase === 'ready'
+      ? 100
+      : phase === 'failed'
+        ? Math.max(1, completedWeight)
+        : Math.min(98, completedWeight + activeStep.weight * activeRatio);
+
+  return {
+    phaseId: phase,
+    phaseLabel:
+      phase === 'ready'
+        ? '生成完成'
+        : phase === 'failed'
+          ? '生成失败'
+          : activeStep.label,
+    phaseDetail:
+      phase === 'ready'
+        ? '视觉小说草稿已准备完成。'
+        : phase === 'failed'
+          ? '草稿生成失败，请返回入口页调整后重试。'
+          : activeStep.detail,
+    batchLabel: activeStep.label,
+    overallProgress: Math.max(0, Math.min(100, Math.round(overallProgress))),
+    completedWeight: Math.max(0, Math.min(100, Math.round(overallProgress))),
+    totalWeight: 100,
+    elapsedMs,
+    estimatedRemainingMs:
+      phase === 'ready' ? 0 : Math.max(0, 31_000 - elapsedMs),
+    activeStepIndex: normalizedActiveStepIndex,
+    steps: timeline.map((step, index) => {
+      const isCompleted =
+        phase === 'ready' || index < normalizedActiveStepIndex;
+      const isActive =
+        phase !== 'failed' &&
+        !isCompleted &&
+        index === normalizedActiveStepIndex;
+      const status: 'completed' | 'active' | 'pending' = isCompleted
+        ? 'completed'
+        : isActive
+          ? 'active'
+          : 'pending';
+      return {
+        id: step.id,
+        label: step.label,
+        detail: step.detail,
+        completed: isCompleted ? 1 : isActive ? activeRatio : 0,
+        total: 1,
+        status,
+      };
+    }),
+  };
+}
+
 export default VisualNovelAgentWorkspace;
diff --git a/src/index.css b/src/index.css
index 5f9eccee..b1ac1de5 100644
--- a/src/index.css
+++ b/src/index.css
@@ -541,7 +541,7 @@ body {
   --puzzle-runtime-piece-selected-fill: linear-gradient(135deg, #ff4f8b, #ff8a73);
   --puzzle-runtime-piece-selected-text: #fff7fb;
   --puzzle-runtime-piece-selected-border: rgba(255, 79, 139, 0.68);
-  --puzzle-runtime-piece-overlay: rgba(61, 24, 38, 0.06);
+  --puzzle-runtime-next-card-overlay: rgba(61, 24, 38, 0.06);
   --puzzle-runtime-control-fill: rgba(255, 255, 255, 0.72);
   --puzzle-runtime-control-hover-fill: rgba(255, 91, 132, 0.1);
   --puzzle-runtime-primary-fill: var(--platform-button-primary-fill);
@@ -768,7 +768,7 @@ body {
   --puzzle-runtime-piece-selected-fill: rgba(251, 191, 36, 0.84);
   --puzzle-runtime-piece-selected-text: #020617;
   --puzzle-runtime-piece-selected-border: rgba(253, 230, 138, 1);
-  --puzzle-runtime-piece-overlay: rgba(0, 0, 0, 0.1);
+  --puzzle-runtime-next-card-overlay: rgba(0, 0, 0, 0.1);
   --puzzle-runtime-control-fill: rgba(0, 0, 0, 0.36);
   --puzzle-runtime-control-hover-fill: rgba(255, 255, 255, 0.1);
   --puzzle-runtime-primary-fill: #fde68a;
@@ -2095,8 +2095,31 @@ body {
   color: var(--puzzle-runtime-piece-empty-text);
 }
 
-.puzzle-runtime-piece-overlay {
-  background: var(--puzzle-runtime-piece-overlay);
+.puzzle-runtime-next-card-overlay {
+  background: var(--puzzle-runtime-next-card-overlay);
+}
+
+.puzzle-runtime-leaderboard-tags {
+  display: flex;
+  min-width: 0;
+  flex-wrap: wrap;
+  gap: 0.25rem;
+  padding-top: 0.28rem;
+}
+
+.puzzle-runtime-leaderboard-tag {
+  display: inline-flex;
+  max-width: 100%;
+  align-items: center;
+  border: 1px solid var(--puzzle-runtime-control-border);
+  border-radius: 9999px;
+  background: var(--puzzle-runtime-control-fill);
+  color: var(--puzzle-runtime-accent-text);
+  padding: 0.12rem 0.42rem;
+  font-size: 0.68rem;
+  font-weight: 850;
+  line-height: 1.2;
+  overflow-wrap: anywhere;
 }
 
 .puzzle-runtime-primary-button {
@@ -2603,32 +2626,81 @@ body {
     user-select: none;
   }
 
-  .platform-recommend-work-meta__stats {
+  .platform-recommend-work-meta__actions {
     display: flex;
     min-width: 0;
     align-items: center;
-    gap: 1.05rem;
-    padding: 0 0.28rem;
+    gap: 0.55rem;
+    padding: 0;
   }
 
-  .platform-recommend-work-meta__stat {
+  .platform-recommend-work-meta__action {
+    display: inline-flex;
+    min-width: 0;
+    min-height: 2.4rem;
+    align-items: center;
+    justify-content: center;
+    border: 1px solid rgba(121, 82, 109, 0.12);
+    border-radius: 9999px;
+    background: rgba(255, 255, 255, 0.72);
+    color: var(--platform-text-strong);
+    font-weight: 950;
+    line-height: 1;
+    box-shadow: 0 8px 18px rgba(15, 23, 42, 0.08);
+    transition:
+      transform 140ms ease,
+      background 140ms ease,
+      border-color 140ms ease;
+  }
+
+  .platform-recommend-work-meta__action:not(:disabled):active {
+    transform: scale(0.96);
+  }
+
+  .platform-recommend-work-meta__action:disabled {
+    opacity: 0.55;
+  }
+
+  .platform-recommend-work-meta__action--icon {
+    width: 2.4rem;
+    flex: 0 0 2.4rem;
+  }
+
+  .platform-recommend-work-meta__action--like {
+    border-color: rgba(255, 85, 126, 0.3);
+    background: rgba(255, 85, 126, 0.12);
+    color: #ff4f7d;
+  }
+
+  .platform-recommend-work-meta__action--remix {
+    border-color: rgba(121, 82, 109, 0.14);
+    background: rgba(255, 255, 255, 0.82);
+    color: var(--platform-text-strong);
+  }
+
+  .platform-recommend-work-meta__like-count {
     display: inline-flex;
     min-width: 0;
     align-items: center;
-    gap: 0.28rem;
-    font-size: 1rem;
-    font-weight: 850;
+    gap: 0.22rem;
+    font-size: 0.84rem;
+    font-weight: 800;
     line-height: 1;
     color: var(--platform-text-strong);
   }
 
+  .platform-recommend-work-meta__like-count {
+    flex: 0 0 auto;
+    min-width: 1rem;
+  }
+
   .platform-recommend-work-meta__row {
-    margin-top: 0.36rem;
+    margin-top: 0.12rem;
     display: flex;
     min-width: 0;
     align-items: center;
     justify-content: space-between;
-    gap: 0.7rem;
+    gap: 0.6rem;
   }
 
   .platform-recommend-work-meta__identity {
diff --git a/src/services/assetReadUrlService.test.ts b/src/services/assetReadUrlService.test.ts
index 81756c54..8569a1d5 100644
--- a/src/services/assetReadUrlService.test.ts
+++ b/src/services/assetReadUrlService.test.ts
@@ -8,6 +8,7 @@ import {
 import {
   clearSignedAssetReadUrlCache,
   getSignedAssetReadUrl,
+  readAssetBytes,
   resolveAssetReadUrl,
 } from './assetReadUrlService';
 
@@ -301,4 +302,30 @@ describe('assetReadUrlService', () => {
     expect(getStoredAccessToken()).toBe('test-access-token');
     expect(window.dispatchEvent).not.toHaveBeenCalled();
   });
+
+  test('readAssetBytes reads generated resources through same-origin bytes endpoint', async () => {
+    vi.spyOn(globalThis, 'fetch').mockResolvedValue(
+      new Response(new Uint8Array([104, 101, 108, 108, 111]), {
+        status: 200,
+        headers: {
+          'Content-Type': 'image/png',
+        },
+      }),
+    );
+
+    const response = await readAssetBytes(
+      '/generated-match3d-assets/session/profile/items/match3d-item-1-item/image.png',
+      { expireSeconds: 300 },
+    );
+    const bytes = new Uint8Array(await response.arrayBuffer());
+
+    expect(Array.from(bytes)).toEqual([104, 101, 108, 108, 111]);
+    expect(response.headers.get('content-type')).toBe('image/png');
+    expect(String(vi.mocked(globalThis.fetch).mock.calls[0]?.[0])).toContain(
+      '/api/assets/read-bytes?',
+    );
+    expect(String(vi.mocked(globalThis.fetch).mock.calls[0]?.[0])).toContain(
+      'legacyPublicPath=%2Fgenerated-match3d-assets%2Fsession%2Fprofile%2Fitems%2Fmatch3d-item-1-item%2Fimage.png',
+    );
+  });
 });
diff --git a/src/services/assetReadUrlService.ts b/src/services/assetReadUrlService.ts
index 15225b47..4a6e57a3 100644
--- a/src/services/assetReadUrlService.ts
+++ b/src/services/assetReadUrlService.ts
@@ -1,7 +1,9 @@
+import { parseApiErrorMessage } from '../../packages/shared/src/http';
 import {
   ApiClientError,
   BACKGROUND_AUTH_REQUEST_OPTIONS,
   type ApiRequestOptions,
+  fetchWithApiAuth,
   requestJson,
 } from './apiClient';
 
@@ -23,6 +25,11 @@ type AssetReadUrlResolveOptions = {
   refreshKey?: string | number | null;
 };
 
+type AssetReadBytesOptions = {
+  signal?: AbortSignal;
+  expireSeconds?: number;
+};
+
 export type AssetReadUrlResponse = {
   read?: {
     objectKey?: string;
@@ -44,6 +51,7 @@ type CachedReadUrlFailureEntry = {
 };
 
 const ASSET_READ_URL_API_PATH = '/api/assets/read-url';
+const ASSET_READ_BYTES_API_PATH = '/api/assets/read-bytes';
 const DEFAULT_CACHE_SAFETY_WINDOW_MS = 30 * 1000;
 const DEFAULT_FAILURE_CACHE_WINDOW_MS = 60 * 1000;
 const ASSET_READ_URL_BACKGROUND_OPTIONS =
@@ -72,6 +80,27 @@ function buildCacheKey(request: AssetReadUrlRequest) {
   return '';
 }
 
+function buildAssetReadSearchParams(request: AssetReadUrlRequest) {
+  const searchParams = new URLSearchParams();
+  if (request.objectKey?.trim()) {
+    searchParams.set('objectKey', request.objectKey.trim().replace(/^\/+/u, ''));
+  }
+  if (request.legacyPublicPath?.trim()) {
+    searchParams.set(
+      'legacyPublicPath',
+      normalizeLegacyPublicPath(request.legacyPublicPath),
+    );
+  }
+  if (
+    typeof request.expireSeconds === 'number' &&
+    Number.isFinite(request.expireSeconds) &&
+    request.expireSeconds > 0
+  ) {
+    searchParams.set('expireSeconds', String(Math.floor(request.expireSeconds)));
+  }
+  return searchParams;
+}
+
 function resolveSignedReadPayload(response: AssetReadUrlResponse) {
   const read = response.read ?? response;
   const signedUrl = typeof read.signedUrl === 'string' ? read.signedUrl.trim() : '';
@@ -146,23 +175,7 @@ export async function getSignedAssetReadUrl(
   }
 
   const requestPromise = (async () => {
-    const searchParams = new URLSearchParams();
-    if (request.objectKey?.trim()) {
-      searchParams.set('objectKey', request.objectKey.trim().replace(/^\/+/u, ''));
-    }
-    if (request.legacyPublicPath?.trim()) {
-      searchParams.set(
-        'legacyPublicPath',
-        normalizeLegacyPublicPath(request.legacyPublicPath),
-      );
-    }
-    if (
-      typeof request.expireSeconds === 'number' &&
-      Number.isFinite(request.expireSeconds) &&
-      request.expireSeconds > 0
-    ) {
-      searchParams.set('expireSeconds', String(Math.floor(request.expireSeconds)));
-    }
+    const searchParams = buildAssetReadSearchParams(request);
 
     try {
       const response = await requestJson<AssetReadUrlResponse>(
@@ -289,6 +302,49 @@ export async function resolveAssetReadUrl(
   return appendCacheBustParam(value, options.refreshKey);
 }
 
+export async function readAssetBytes(
+  source: string | null | undefined,
+  options: AssetReadBytesOptions = {},
+) {
+  const value = source?.trim() ?? '';
+  if (!value) {
+    throw new Error('资源路径不能为空');
+  }
+
+  if (!isGeneratedLegacyPath(value)) {
+    const response = await fetch(value, { signal: options.signal });
+    if (!response.ok) {
+      throw new Error('读取资源内容失败');
+    }
+    return response;
+  }
+
+  // 中文注释：这里要拿图片字节转 Data URL，不能直接 fetch OSS 签名 URL，否则浏览器会受 bucket CORS 限制。
+  const searchParams = buildAssetReadSearchParams({
+    legacyPublicPath: value,
+    expireSeconds: options.expireSeconds,
+  });
+  const response = await fetchWithApiAuth(
+    `${ASSET_READ_BYTES_API_PATH}?${searchParams.toString()}`,
+    {
+      method: 'GET',
+      signal: options.signal,
+    },
+    {
+      ...ASSET_READ_URL_BACKGROUND_OPTIONS,
+      omitEnvelopeHeader: true,
+    },
+  );
+  if (!response.ok) {
+    const message = await response
+      .text()
+      .then((text) => parseApiErrorMessage(text, '读取资源内容失败'))
+      .catch(() => '');
+    throw new Error(message || '读取资源内容失败');
+  }
+  return response;
+}
+
 export function clearSignedAssetReadUrlCache() {
   signedReadUrlCache.clear();
   signedReadUrlFailureCache.clear();
diff --git a/src/services/miniGameDraftGenerationProgress.test.ts b/src/services/miniGameDraftGenerationProgress.test.ts
index dc071876..79290a3c 100644
--- a/src/services/miniGameDraftGenerationProgress.test.ts
+++ b/src/services/miniGameDraftGenerationProgress.test.ts
@@ -1,8 +1,10 @@
 import { describe, expect, test } from 'vitest';
 
 import {
+  buildMatch3DGenerationAnchorEntries,
   buildMiniGameDraftGenerationProgress,
   buildPuzzleGenerationAnchorEntries,
+  createMiniGameDraftGenerationState,
   type MiniGameDraftGenerationState,
 } from './miniGameDraftGenerationProgress';
 
@@ -150,6 +152,47 @@ describe('miniGameDraftGenerationProgress', () => {
     );
   });
 
+  test('match3d draft generation exposes item sheet and image asset steps', () => {
+    const state = createMiniGameDraftGenerationState('match3d');
+
+    const progress = buildMiniGameDraftGenerationProgress(
+      state,
+      state.startedAtMs + 17_000,
+    );
+
+    expect(progress?.steps.map((step) => step.id)).toEqual([
+      'match3d-item-names',
+      'match3d-material-sheet',
+      'match3d-slice-images',
+      'match3d-upload-images',
+    ]);
+    expect(progress?.phaseId).toBe('match3d-material-sheet');
+    expect(progress?.phaseLabel).toBe('生成素材图');
+    expect(progress?.estimatedRemainingMs).toBe(103_000);
+  });
+
+  test('match3d generation anchors show theme and fixed three items', () => {
+    const entries = buildMatch3DGenerationAnchorEntries(null, {
+      themeText: '水果',
+      clearCount: 20,
+      difficulty: 8,
+      referenceImageSrc: null,
+    });
+
+    expect(entries).toEqual([
+      {
+        id: 'match3d-theme',
+        label: '题材',
+        value: '水果',
+      },
+      {
+        id: 'match3d-items',
+        label: '物品数量',
+        value: '3 件',
+      },
+    ]);
+  });
+
   test('puzzle generation anchors expose form payload as the display source', () => {
     const entries = buildPuzzleGenerationAnchorEntries({
       sessionId: 'puzzle-session-1',
diff --git a/src/services/miniGameDraftGenerationProgress.ts b/src/services/miniGameDraftGenerationProgress.ts
index df371626..6f57b6fd 100644
--- a/src/services/miniGameDraftGenerationProgress.ts
+++ b/src/services/miniGameDraftGenerationProgress.ts
@@ -3,6 +3,10 @@ import type {
   CreatePuzzleAgentSessionRequest,
   PuzzleAgentSessionSnapshot,
 } from '../../packages/shared/src/contracts/puzzleAgentSession';
+import type {
+  CreateMatch3DSessionRequest,
+  Match3DAgentSessionSnapshot,
+} from '../../packages/shared/src/contracts/match3dAgent';
 import type {
   CustomWorldGenerationProgress,
   CustomWorldGenerationStep,
@@ -10,7 +14,11 @@ import type {
 import type { SquareHoleSessionSnapshot } from '../../packages/shared/src/contracts/squareHoleAgent';
 import type { CustomWorldStructuredAnchorEntry } from './customWorldAgentGenerationProgress';
 
-export type MiniGameDraftGenerationKind = 'puzzle' | 'big-fish' | 'square-hole';
+export type MiniGameDraftGenerationKind =
+  | 'puzzle'
+  | 'big-fish'
+  | 'square-hole'
+  | 'match3d';
 
 export type MiniGameDraftGenerationPhase =
   | 'idle'
@@ -22,6 +30,11 @@ export type MiniGameDraftGenerationPhase =
   | 'square-hole-cover'
   | 'square-hole-shapes'
   | 'square-hole-ready'
+  | 'match3d-item-names'
+  | 'match3d-material-sheet'
+  | 'match3d-slice-images'
+  | 'match3d-upload-images'
+  | 'match3d-ready'
   | 'puzzle-images'
   | 'puzzle-select-image'
   | 'ready'
@@ -126,6 +139,33 @@ const SQUARE_HOLE_STEPS = [
   },
 ] as const satisfies ReadonlyArray<MiniGameStepDefinition>;
 
+const MATCH3D_STEPS = [
+  {
+    id: 'match3d-item-names',
+    label: '生成物品名称',
+    detail: '根据题材生成本局的 3 个物品名称。',
+    weight: 16,
+  },
+  {
+    id: 'match3d-material-sheet',
+    label: '生成素材图',
+    detail: '生成一张 1:1 的网格素材图。',
+    weight: 30,
+  },
+  {
+    id: 'match3d-slice-images',
+    label: '切割独立图片',
+    detail: '把素材图切成独立物品参考图。',
+    weight: 14,
+  },
+  {
+    id: 'match3d-upload-images',
+    label: '上传图片资产',
+    detail: '写入切割图片并准备进入草稿页。',
+    weight: 40,
+  },
+] as const satisfies ReadonlyArray<MiniGameStepDefinition>;
+
 function clampProgress(value: number) {
   return Math.max(0, Math.min(100, Math.round(value)));
 }
@@ -137,6 +177,9 @@ function getStepDefinitions(kind: MiniGameDraftGenerationKind) {
   if (kind === 'square-hole') {
     return SQUARE_HOLE_STEPS;
   }
+  if (kind === 'match3d') {
+    return MATCH3D_STEPS;
+  }
   return BIG_FISH_STEPS;
 }
 
@@ -190,7 +233,9 @@ export function createMiniGameDraftGenerationState(
         ? 'big-fish-draft'
         : kind === 'square-hole'
           ? 'square-hole-draft'
-          : 'compile',
+          : kind === 'match3d'
+            ? 'match3d-item-names'
+            : 'compile',
     startedAtMs: Date.now(),
     completedAssetCount: 0,
     totalAssetCount: 0,
@@ -222,6 +267,21 @@ function resolveSquareHolePhaseByElapsedMs(
   return 'square-hole-draft';
 }
 
+function resolveMatch3DPhaseByElapsedMs(
+  elapsedMs: number,
+): MiniGameDraftGenerationPhase {
+  if (elapsedMs >= 72_000) {
+    return 'match3d-upload-images';
+  }
+  if (elapsedMs >= 58_000) {
+    return 'match3d-slice-images';
+  }
+  if (elapsedMs >= 16_000) {
+    return 'match3d-material-sheet';
+  }
+  return 'match3d-item-names';
+}
+
 function resolvePuzzleTimelineByElapsedMs(elapsedMs: number) {
   let elapsedBeforePhase = 0;
 
@@ -282,6 +342,13 @@ export function buildMiniGameDraftGenerationProgress(
             ...state,
             phase: resolveSquareHolePhaseByElapsedMs(elapsedMs),
           }
+        : state.kind === 'match3d' &&
+            state.phase !== 'failed' &&
+            state.phase !== 'ready'
+          ? {
+              ...state,
+              phase: resolveMatch3DPhaseByElapsedMs(elapsedMs),
+            }
         : state;
 
   const steps = getStepDefinitions(normalizedState.kind);
@@ -307,6 +374,8 @@ export function buildMiniGameDraftGenerationProgress(
           ? 0.55
           : normalizedState.kind === 'square-hole'
             ? 0.42
+            : normalizedState.kind === 'match3d'
+              ? 0.5
             : 0;
   const overallProgress =
     normalizedState.phase === 'failed'
@@ -334,7 +403,9 @@ export function buildMiniGameDraftGenerationProgress(
       (normalizedState.phase === 'ready'
         ? normalizedState.kind === 'big-fish'
           ? '玩法草稿已准备完成，可进入结果页继续生成主图、动作和背景。'
-          : '首关草稿与正式图已准备完成，可进入结果页补作品信息。'
+          : normalizedState.kind === 'match3d'
+            ? '抓大鹅素材与草稿已准备完成，可进入结果页继续编辑。'
+            : '首关草稿与正式图已准备完成，可进入结果页补作品信息。'
         : activeStep.detail),
     batchLabel: activeStep.label,
     overallProgress: clampProgress(cappedOverallProgress),
@@ -350,7 +421,9 @@ export function buildMiniGameDraftGenerationProgress(
           ? Math.max(0, 7_000 - elapsedMs)
           : normalizedState.kind === 'square-hole'
             ? Math.max(0, 12_000 - elapsedMs)
-            : null,
+            : normalizedState.kind === 'match3d'
+              ? Math.max(0, 120_000 - elapsedMs)
+              : null,
     activeStepIndex,
     steps: buildMiniGameProgressSteps(
       steps,
@@ -439,6 +512,43 @@ export function buildBigFishGenerationAnchorEntries(
     .filter((entry) => entry.value.trim());
 }
 
+export function buildMatch3DGenerationAnchorEntries(
+  session: Match3DAgentSessionSnapshot | null | undefined,
+  formPayload: CreateMatch3DSessionRequest | null | undefined = null,
+): CustomWorldStructuredAnchorEntry[] {
+  if (!session && !formPayload) {
+    return [];
+  }
+
+  const config = session?.config;
+  const itemCount = 3;
+  const entries: Array<MiniGameAnchorSource | null> = [
+    {
+      key: 'match3d-theme',
+      label: '题材',
+      value:
+        formPayload?.themeText?.trim() ||
+        config?.themeText?.trim() ||
+        session?.anchorPack.theme.value ||
+        '',
+    },
+    {
+      key: 'match3d-items',
+      label: '物品数量',
+      value: `${itemCount} 件`,
+    },
+  ];
+
+  return entries
+    .filter((entry): entry is MiniGameAnchorSource => Boolean(entry))
+    .map((entry) => ({
+      id: entry.key,
+      label: entry.label,
+      value: entry.value,
+    }))
+    .filter((entry) => entry.value.trim());
+}
+
 export function buildSquareHoleGenerationAnchorEntries(
   session: SquareHoleSessionSnapshot | null | undefined,
 ): CustomWorldStructuredAnchorEntry[] {
diff --git a/src/services/puzzle-runtime/puzzleLocalRuntime.ts b/src/services/puzzle-runtime/puzzleLocalRuntime.ts
index 47ba3ec4..9a390ca1 100644
--- a/src/services/puzzle-runtime/puzzleLocalRuntime.ts
+++ b/src/services/puzzle-runtime/puzzleLocalRuntime.ts
@@ -710,6 +710,7 @@ function buildLocalLeaderboardEntries(
       rank: 1,
       nickname,
       elapsedMs,
+      visibleTags: [],
       isCurrentPlayer: true,
     },
   ];
diff --git a/src/services/puzzleReferenceImage.ts b/src/services/puzzleReferenceImage.ts
index 3dc41080..4cb66ca4 100644
--- a/src/services/puzzleReferenceImage.ts
+++ b/src/services/puzzleReferenceImage.ts
@@ -1,4 +1,4 @@
-const PUZZLE_REFERENCE_IMAGE_MAX_EDGE = 1536;
+const PUZZLE_REFERENCE_IMAGE_MAX_EDGE = 1024;
 const PUZZLE_REFERENCE_IMAGE_COMPRESS_TRIGGER_BYTES = 1536 * 1024;
 export const PUZZLE_REFERENCE_IMAGE_MAX_DATA_URL_LENGTH = 10 * 1024 * 1024;
 const PUZZLE_REFERENCE_IMAGE_SQUARE_TOLERANCE = 1;
@@ -114,7 +114,7 @@ async function compressReferenceImageDataUrl(file: File, dataUrl: string) {
     return dataUrl;
   }
 
-  // 中文注释：参考图只作为生成提示，不需要保留手机原图体积；压到单边 1536 内给 JSON body 留余量。
+  // 中文注释：参考图只作为生成提示，不需要保留手机原图体积；压到单边 1024 内更容易稳定进入 VectorEngine 参考图分支。
   context.imageSmoothingEnabled = true;
   context.imageSmoothingQuality = 'high';
   context.fillStyle = '#ffffff';