From 5f1128540e038002ab2149b4fbfdd1a1af68ae54 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E4=BA=94=E9=A6=99=E4=B8=B8=E5=AD=90?= <15518898337@163.com>
Date: Fri, 22 May 2026 03:49:35 +0800
Subject: [PATCH] feat: refine wooden fish runtime generation

---
 .hermes/shared-memory/decision-log.md         |   8 +
 .hermes/shared-memory/pitfalls.md             |   8 +
 CONTEXT.md                                    |   4 +
 ...€�玩法创作】敲木鱼玩法模æ�¿PRD-2026-05-20.md |  96 +++--
 ...„】server-rs与SpacetimeDBæ•°æ�®å¥‘约-2026-05-15.md |   2 +
 ...��维】本地开�验�与生产�维-2026-05-15.md |   1 +
 ...�玩法创作】平�入�与玩法链路-2026-05-15.md |   4 +-
 packages/shared/src/contracts/woodenFish.ts   |   4 +
 scripts/dev.mjs                               |  92 ++++-
 scripts/dev.test.ts                           |  58 +++
 .../api-server/src/openai_image_generation.rs |  93 ++++-
 .../crates/api-server/src/wooden_fish.rs      | 331 ++++++++++++++----
 .../shared-contracts/src/wooden_fish.rs       |  22 ++
 .../src/mapper/wooden_fish.rs                 |   3 +
 .../wooden_fish_draft_compile_input_type.rs   |   1 +
 .../wooden_fish_draft_snapshot_type.rs        |   1 +
 .../wooden_fish_gallery_view_row_type.rs      |   4 +
 .../wooden_fish_work_profile_row_type.rs      |   7 +
 .../wooden_fish_work_snapshot_type.rs         |   1 +
 .../wooden_fish_work_update_input_type.rs     |   1 +
 .../spacetime-client/src/wooden_fish.rs       |  74 ++++
 .../crates/spacetime-module/src/migration.rs  |   8 +
 .../spacetime-module/src/wooden_fish.rs       |  31 ++
 .../src/wooden_fish/tables.rs                 |   2 +
 .../spacetime-module/src/wooden_fish/types.rs |   4 +
 .../WoodenFishResultView.tsx                  |  29 +-
 .../WoodenFishRuntimeShell.tsx                |  14 +
 .../miniGameDraftGenerationProgress.test.ts   |   3 +-
 .../miniGameDraftGenerationProgress.ts        |  22 +-
 src/services/wooden-fish/woodenFishClient.ts  |   2 +
 30 files changed, 804 insertions(+), 126 deletions(-)

diff --git a/.hermes/shared-memory/decision-log.md b/.hermes/shared-memory/decision-log.md
index 3fa96f2a..303282aa 100644
--- a/.hermes/shared-memory/decision-log.md
+++ b/.hermes/shared-memory/decision-log.md
@@ -16,6 +16,14 @@
 
 ---
 
+## 2026-05-22 敲木鱼图片创作采用�图 image2 链路
+
+- 背景：敲木鱼自定义题��生�中央敲击物时，�行�缺少与新主题匹�的竖�背景；若直接让背景 prompt 自由�挥，�容易把敲击物或木槌画进背景里。
+- 决策：敲木鱼 `compile-draft` / `regenerate-hit-object` 图片链路固定为两步 image2 edits。第一步调用 VectorEngine `/v1/images/edits` + `gpt-image-2`，以默认木鱼图作为结构和画风�考，用户上传�考图�作为�次请求的新主题�考，结�用户题�关键�或�考图主题生� `1:1` �明底新敲击物并写回 `hitObjectAsset`；第二步以新敲击物图作为主题和画风�考，结�用户原始题�生� `9:16` 背景环境图并写回 `backgroundAsset`。两步 prompt 使用 PRD 中固定��关键�，�追加�外 negative prompt；背景图�得包�敲击物本体或木槌互动物�。
+- 影�范围：`api-server` 木鱼图片生�编排�`wooden_fish_work_profile.background_asset_json`�shared contracts��端结果页 / �行�背景展示�敲木鱼 PRD 和平�链路文档。
+- 验�方�：执行 `cargo test -p api-server wooden_fish --manifest-path server-rs/Cargo.toml`�`cargo test -p spacetime-client wooden_fish --manifest-path server-rs/Cargo.toml`�`npm run spacetime:generate`�`npm run check:spacetime-schema`�`npm run typecheck`。
+- 关�文档：`docs/prd/�玩法创作】敲木鱼玩法模�PRD-2026-05-20.md`�`docs/�玩法创作】平�入�与玩法链路-2026-05-15.md`。
+
 ## 2026-05-21 外部 API 失败必须 OTLP 上报并�库
 
 - 背景：图片生�等外部供应商调用失败时，仅返回 502/504 或普通日志无法支��续按 provider�阶段和�试属性��排障。
diff --git a/.hermes/shared-memory/pitfalls.md b/.hermes/shared-memory/pitfalls.md
index e1f5ff2d..f2a48a48 100644
--- a/.hermes/shared-memory/pitfalls.md
+++ b/.hermes/shared-memory/pitfalls.md
@@ -478,6 +478,14 @@
 - 验�：`spacetime server list` 默认目标为 local；�新登录��布��返回 `401` / `403`；`npm run dev` �以完� SpacetimeDB publish 并继续�动 `api-server`。
 - 关�：`docs/technical/SPACETIMEDB_START_SH_PUBLISH_403_IDENTITY_FIX_2026-04-26.md`�`scripts/dev.mjs`。
 
+## 本地 api-server �动订阅 401 先查 Web identity token 注入
+
+- 现象：`npm run dev` �动到 api-server ��认�快照时，日志出现 `Failed to initiate WebSocket connection ... /v1/database/<db>/subscribe?compression=Brotli: HTTP error: 401 Unauthorized`。
+- 原因：SpacetimeDB SDK 订阅需� Web API identity token；本地 `.env.local` 常把 `GENARRATIVE_SPACETIME_TOKEN` 留空，�� CLI 登录� publish �功并�能让 api-server 的 WebSocket subscribe 获得��。
+- 处�：`scripts/dev.mjs` 在 SpacetimeDB 就绪�调用 `/v1/identity` 创建当�进程专用 Web API identity token，并�注入本次 `api-server` 环境；��把临时 token 写进 `.env.local` 或日志。若�报 401，先确认是�使用了项目脚本�动�日志是�出现 `已创建本地 Web identity`，以� `GENARRATIVE_SPACETIME_SERVER_URL` / 数�库�是�指�本次�动的实例。
+- 验�：`npm run test -- scripts/dev.test.ts`；�新�行 `npm run dev` � api-server �动日志��出现上述 subscribe 401，`/healthz` 返回 200。
+- 关�：`scripts/dev.mjs`�`scripts/dev.test.ts`�`docs/�开��维】本地开�验�与生产�维-2026-05-15.md`。
+
 ## 本地 SpacetimeDB �调�按阶段跳过宿主或�布
 
 - 现象：本地 `npm run dev` 因 `3101` 已�用����布 SpacetimeDB wasm 编译太慢，或�想检查 `spacetime-module` 语法而被完整�调链路拖慢。
diff --git a/CONTEXT.md b/CONTEXT.md
index c431cb69..160d1edd 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -28,6 +28,10 @@ _Avoid_: 长期功德账本�排行榜玩法�全局账户累计
 敲木鱼作�中被玩家点击敲击的�张物�图案；默认模�使用内置�明 PNG `/wooden-fish/default-hit-object.png`，用户自定义关键�或上传图时�使用 image2 生�最终资产，上传图�作为 image2 �考。
 _Avoid_: 直接把上传图作为�行�素��系列素�图集
 
+**敲木鱼背景环境图**:
+敲木鱼作�中的竖� 9:16 背景资产；由�端在敲击物图案生��，以新敲击物图案作为主题和画风�考，�结�用户原始题�关键�或�考图主题调用 image2 生�。背景�适�敲击物主题和画风，�包�敲击物本体或木槌互动物�。
+_Avoid_: 把背景当��图�在背景里��绘制敲击物�让�端临时拼背景
+
 **敲击音效**:
 敲木鱼作�中�次有效敲击播放的短音频资产，�由�述生��文件上传或麦克风录制产生，最终统一写回作�的敲击音效资产槽�。
 _Avoid_: 背景音��长音频轨���行�实时录音
diff --git a/docs/prd/�玩法创作】敲木鱼玩法模�PRD-2026-05-20.md b/docs/prd/�玩法创作】敲木鱼玩法模�PRD-2026-05-20.md
index fa7c4535..a660755c 100644
--- a/docs/prd/�玩法创作】敲木鱼玩法模�PRD-2026-05-20.md
+++ b/docs/prd/�玩法创作】敲木鱼玩法模�PRD-2026-05-20.md
@@ -74,7 +74,14 @@ WF-*
   - 写回字段：`hitObjectAsset`
   - 是��许历�图：�许
   - 是��许 AI �绘：�许；上传图�作为 image2 �考，最终�行��消费 image2 生�图
-- 系列素�槽�：无；首版�有�图敲击物，�生�图集
+  - `slotId=background`
+  - `slotType=background-image`
+  - `slotName=背景环境图`
+  - �示���：第一步生�的敲击物图案与用户原始题�关键� / �考图主题
+  - 写回字段：`backgroundAsset`
+  - 是��许历�图：��独选择；由敲击物图案生�链路派生
+  - 是��许 AI �绘：�许；�敲击物图案一起�生�
+- 系列素�槽�：无；首版�有敲击物图案与背景环境图两个�图资产，�生�图集
 - 音频资产槽�：
   - `slotId=hit-sound`
   - `slotType=hit-sound-audio`
@@ -135,13 +142,39 @@ WF-*
 
 ## 6. 生�规则
 
-### 6.1 敲击物图案
+### 6.1 敲击物图案与背景环境图
 
-默认模�在用户未自定义关键�且未上传�考图时，`compile-draft` 使用内置�明 PNG `/wooden-fish/default-hit-object.png` 写回 `hitObjectAsset`，`generationProvider="bundled-default"`。这张图�自 image2 对原始�考图的�通风格化�绘，固定为模�默认资�，��默认关键�在�次生�时改�造型。
+默认模�在用户未自定义关键�且未上传�考图时，`compile-draft` 使用内置�明 PNG `/wooden-fish/default-hit-object.png` 写回 `hitObjectAsset`，`generationProvider="bundled-default"`。这张图�自 image2 对原始�考图的�通风格化�绘，固定为模�默认资�，��默认关键�在�次生�时改�造型。�使使用内置默认敲击物，首版�需�生� `backgroundAsset`，背景环境图使用默认敲击物作为主题和画风�考。
 
-用户输入自定义关键��上传�考图，或在结果页主动�生�敲击物时，`compile-draft` 与 `regenerate-hit-object` 必须为敲击物图案生� image2 �图资产，并由 `api-server` 注入写回 `hitObjectAsset`。�端 action 请求�得自带 `hitObjectAsset` 短路生�。如果用户上传�考图，�端�能把该图作为 image2 �考图或编辑输入；�行��得直接使用上传图。
+用户输入自定义关键��上传�考图，或在结果页主动�生�敲击物时，`compile-draft` 与 `regenerate-hit-object` 必须先为敲击物图案生� image2 �图资产，�基于新敲击物图案生�背景环境图，并由 `api-server` 注入写回 `hitObjectAsset` 与 `backgroundAsset`。�端 action 请求�得自带 `hitObjectAsset` 或 `backgroundAsset` 短路生�。如果用户上传�考图，�端�能把该图作为 image2 �考图或主题�考；�行��得直接使用上传图。
 
-�库链路固定为：`api-server` 调用 VectorEngine `gpt-image-2-all` -> �务端上传 OSS �有对象 -> `confirm_asset_object` 登记资产对象 -> `bind_asset_object_to_entity` 绑定到 `entityKind='wooden_fish_work'`�`slot='hit_object'`�`assetKind='wooden_fish_hit_object'` -> 把 `legacyPublicPath` 写入 `hitObjectAsset.imageSrc`。�得�拼 `/generated-wooden-fish-assets/...` ��路径；�端会对 generated legacy path 走 `/api/assets/read-url` �签，OSS 中没有真实对象时图片无法显示。
+敲击物图案生��程固定为：
+
+1. 调用 VectorEngine `/v1/images/edits`，模型固定为 `gpt-image-2`；
+2. multipart �考图固定包�默认木鱼图 `/wooden-fish/default-hit-object.png`，作为基础结构和画风�考；
+3. 若用户上传�考图，该图�作为新主题�考追加到�一次 image2 edits 请求，�直接进入�行�；
+4. 尺寸固定 `1:1`，�明底；
+5. �示�严格使用：
+
+```text
+生�敲木鱼新样�，�求结构，画风与�考图��高度一致，新样�颜色��使用新主题对应的颜色。
+新主题为：（用户�供�考图或用户输入关键�）
+```
+
+背景环境图生��程固定为：
+
+1. 调用 VectorEngine `/v1/images/edits`，模型固定为 `gpt-image-2`；
+2. multipart �考图固定为第一步新生�的敲击物图案；默认未生�新敲击物时使用内置默认敲击物图案；
+3. 尺寸固定竖� `9:16`；
+4. 背景环境图�适�新敲击物主题和画风，背景中�得包�新敲击物本体，也�得增加木槌互动物�；
+5. �示�严格使用：
+
+```text
+生�敲木鱼背景，�求主题，画风与�考图��高度一致，背景元素和颜色��与主题对应，木鱼预设在�幕中央�置，木鱼主体周围元素��干净，背景氛围围绕外围设计，背景环境图中�包�新木鱼物�，背景氛围中�增加木槌互动物�。
+主题为：（用户�供�考图或用户输入关键�）
+```
+
+�库链路固定为：`api-server` 调用 VectorEngine `/v1/images/edits` -> �务端上传 OSS �有对象 -> `confirm_asset_object` 登记资产对象 -> `bind_asset_object_to_entity` 绑定到 `entityKind='wooden_fish_work'`。敲击物绑定 `slot='hit_object'`�`assetKind='wooden_fish_hit_object'`，背景绑定 `slot='background'`�`assetKind='wooden_fish_background'`。写回时把 `legacyPublicPath` 分别写入 `hitObjectAsset.imageSrc` 与 `backgroundAsset.imageSrc`。�得�拼 `/generated-wooden-fish-assets/...` ��路径；�端会对 generated legacy path 走 `/api/assets/read-url` �签，OSS 中没有真实对象时图片无法显示。
 
 默认图案�求：
 
@@ -166,7 +199,7 @@ WF-*
 
 ### 6.3 ��
 
-首版��使用 `hitObjectAsset.imageSrc` 作为 `coverImageSrc`。��独新增第三次图片生�。
+首版��使用 `hitObjectAsset.imageSrc` 作为 `coverImageSrc`。背景环境图�作为��图，��独新增第三次图片生�。
 
 ## 7. 契约�案
 
@@ -183,9 +216,10 @@ WF-*
 9. `hitSoundPrompt`ï¼›
 10. `floatingWords[]`ï¼›
 11. `hitObjectAsset`ï¼›
-12. `hitSoundAsset`ï¼›
-13. `coverImageSrc`ï¼›
-14. `generationStatus`。
+12. `backgroundAsset`ï¼›
+13. `hitSoundAsset`ï¼›
+14. `coverImageSrc`ï¼›
+15. `generationStatus`。
 
 `WoodenFishImageAsset` 至少包�：
 
@@ -260,7 +294,7 @@ finish
 新增表：
 
 1. `wooden_fish_agent_session`ï¼›
-2. `wooden_fish_work_profile`ï¼›
+2. `wooden_fish_work_profile`，其中 `background_asset_json` �存背景环境图资产快照；
 3. `wooden_fish_runtime_run`ï¼›
 4. `wooden_fish_event`。
 
@@ -276,13 +310,14 @@ finish
 结果页必须展示：
 
 1. 作�标题和简介；
-2. 敲击物图案；
-3. 敲击音效试�；
-4. ����置；
-5. 标签；
-6. 试玩；
-7. �布；
-8. 返回编辑。
+2. 竖�背景环境图预览；
+3. 敲击物图案；
+4. 敲击音效试�；
+5. ����置；
+6. 标签；
+7. 试玩；
+8. �布；
+9. 返回编辑。
 
 结果页必须支�：
 
@@ -333,16 +368,17 @@ finish
 
 1. 创作入�能看到 `敲木鱼` 模�；
 2. 工作��以填写敲击物�述�上传�考图��置音效和���；
-3. �交�生� image2 敲击物图案；
-4. 上传图�会直接进入�行�；
-5. 用户上传或录制音效时跳过音效生�并�久化该资产；
-6. 结果页能看到图案�试�音效�编辑���并试玩；
-7. �行�功能区点击�触�敲击；
-8. �功能区点击会计数�播放音效�播放敲击动画并飘字；
-9. 顶部计数器�在��首次出现时创建；
-10. 连点�丢计数；
-11. `checkpoint` 和 `finish` ��存�次 run 摘�；
-12. 作��以�布�进入公开列表和公开详情；
-13. `WF-*` 公开作��能进入分享和�行�；
-14. `npm run check:encoding` 通过；
-15. schema �更� `npm run check:spacetime-schema` 通过。
+3. �交�按默认木鱼�考图生� image2 敲击物图案；
+4. �交�按新敲击物图案�考图生� 9:16 背景环境图；
+5. 上传图�会直接进入�行�；
+6. 用户上传或录制音效时跳过音效生�并�久化该资产；
+7. 结果页能看到背景�图案�试�音效�编辑���并试玩；
+8. �行�功能区点击�触�敲击；
+9. �功能区点击会计数�播放音效�播放敲击动画并飘字；
+10. 顶部计数器�在��首次出现时创建；
+11. 连点�丢计数；
+12. `checkpoint` 和 `finish` ��存�次 run 摘�；
+13. 作��以�布�进入公开列表和公开详情；
+14. `WF-*` 公开作��能进入分享和�行�；
+15. `npm run check:encoding` 通过；
+16. schema �更� `npm run check:spacetime-schema` 通过。
diff --git a/docs/��端架构】server-rs与SpacetimeDB数�契约-2026-05-15.md b/docs/��端架构】server-rs与SpacetimeDB数�契约-2026-05-15.md
index 981e1e07..5319448a 100644
--- a/docs/��端架构】server-rs与SpacetimeDB数�契约-2026-05-15.md
+++ b/docs/��端架构】server-rs与SpacetimeDB数�契约-2026-05-15.md
@@ -160,6 +160,7 @@ npm run check:server-rs-ddd
 - Match3D 物� sheet：VectorEngine Gemini `gemini-3-pro-image-preview` 原生 `generateContent`；图集 prompt�切图��明化和切片�久化走 `generated_asset_sheets` 通用模�，Match3D �补题� / 风格 / 五视角设定和字段映射。
 - Match3D ��和 9:16 纯背景：VectorEngine `/v1/images/generations`。
 - Match3D 1:1 容器 UI：VectorEngine `/v1/images/edits` multipart �考图。该容器�考图是�端生图�议输入，必须通过 `include_bytes!` � `api-server` 编译进二进制，�� API �独�布或�行目录缺少 `public/` 时生�失败。
+- 敲木鱼敲击物和背景环境图：VectorEngine `/v1/images/edits`，模型固定 `gpt-image-2`。敲击物支� multipart 多�考图，第一张固定为�端内嵌默认木鱼图，用户上传图�作为新主题�考；背景环境图�使用新敲击物图作为�考。
 - Hyper3D / Rodin：��留�端安全代�和旧数�兼容；新 Match3D �稿和批�新增��生� GLB。
 - 音频：视觉�说专用音频路由�留；拼图和抓大鹅生�入�暂时关闭，通用 `/api/creation/audio/*` 对相关目标返回 `410 Gone`；敲木鱼 `hit_sound` 目标例外开放，�用 VectorEngine Vidu 音效生��OSS �有对象�`asset_object` 和 entity binding 链路，目标字段固定为 `entityKind='wooden_fish_work'`�`slot='hit_sound'`�`assetKind='wooden_fish_hit_sound'`�`storagePrefix='wooden_fish_assets'`。
 - OSS：�有 generated legacy path 进入�览器�必须通过 `/api/assets/read-url` �签；��裸请求 `/generated-*`。
@@ -421,6 +422,7 @@ npm run check:server-rs-ddd
 
 - Rust 结构体：`WoodenFishWorkProfileRow`
 - ��：`server-rs/crates/spacetime-module/src/wooden_fish/tables.rs`
+- 说明：敲木鱼作� profile 真相，包�敲击物图案�背景环境图�敲击音效�飘字�置��布状�和公开计数；`background_asset_json` 是�加入字段，�存 image2 生�的 9:16 背景环境图资产快照，旧�移数�按 `None` 兼容。
 
 ### SpacetimeDB view：`wooden_fish_gallery_card_view`
 
diff --git a/docs/�开��维】本地开�验�与生产�维-2026-05-15.md b/docs/�开��维】本地开�验�与生产�维-2026-05-15.md
index c7e144df..0f9df588 100644
--- a/docs/�开��维】本地开�验�与生产�维-2026-05-15.md
+++ b/docs/�开��维】本地开�验�与生产�维-2026-05-15.md
@@ -169,6 +169,7 @@ UI 相关修改��点验�：
 4. 身份问题先查 `spacetime login show`�`spacetime server list` 和目标库��，�通过切回旧 Node / PostgreSQL 绕过。
 5. 旧库�移或 private 表数��留走 `migration.rs` 的 JSON 导入导出和分片导入�路。
 6. Jenkins 数�库导入 / 导出�水线会先加载 `scripts/jenkins-prepare-toolchain-env.sh`，显�补� Jenkins 用户的 Node�Cargo�SpacetimeDB 工具链目录；如果目标机器安装路径��，用 `GENARRATIVE_JENKINS_TOOL_PATHS` 传入�外 `bin` 目录。
+7. 本地 `npm run dev` / `npm run dev:api-server` 若没有显� `GENARRATIVE_SPACETIME_TOKEN`，会在 SpacetimeDB 就绪�调用 `/v1/identity` 创建当�进程专用 Web API identity token，并�注入本次 `api-server` 环境，�写回 `.env.local`。�动日志�打� identity �缀，�止打� token 明文；若�出现 `subscribe ... 401 Unauthorized`，先确认是�绕过了项目 dev 脚本或是�连接到�本次�动的 SpacetimeDB server。
 
 ## 生产�维
 
diff --git a/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md b/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
index 0ace52cb..c0982b00 100644
--- a/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
+++ b/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
@@ -99,10 +99,12 @@
 
 创作输入固定为：
 
-1. `敲什么`：�图资产槽�。默认模�使用内置�明 PNG `/wooden-fish/default-hit-object.png` 作为 `bundled-default` 敲击物资产，��默认关键�被�新语义化改形；用户输入自定义关键�或上传�考图时，�端必须使用 image2 生�最终敲击物图案，上传图�作为�考，�直接进入�行�。自定义 `compile-draft` / `regenerate-hit-object` 必须完� image2 -> OSS �有对象 -> asset object 登记和绑定�，�由 `api-server` 注入真实 `hitObjectAsset.imageSrc`，�能�写 `/generated-wooden-fish-assets/...` ��路径，也�能接��端请求自带的 `hitObjectAsset` 短路生�。
+1. `敲什么`：敲击物�图资产槽�。默认模�使用内置�明 PNG `/wooden-fish/default-hit-object.png` 作为 `bundled-default` 敲击物资产，��默认关键�被�新语义化改形；用户输入自定义关键�或上传�考图时，�端必须以默认木鱼图作为基础结构和画风�考，使用 image2 生�最终敲击物图案，上传图�作为新主题�考，�直接进入�行�。自定义 `compile-draft` / `regenerate-hit-object` 必须完� image2 -> OSS �有对象 -> asset object 登记和绑定�，�由 `api-server` 注入真实 `hitObjectAsset.imageSrc`，�能�写 `/generated-wooden-fish-assets/...` ��路径，也�能接��端请求自带的 `hitObjectAsset` 短路生�。
 2. `敲击音效`：音频资产槽�，支��述生��上传和麦克风录制，统一写回 `hitSoundAsset`。�述生��用通用 `/api/creation/audio/sound-effect` 的 VectorEngine Vidu 音效生��下载�OSS �有对象�asset object 登记和 entity binding 链路；木鱼目标固定为 `entityKind='wooden_fish_work'`�`slot='hit_sound'`�`assetKind='wooden_fish_hit_sound'`�`storagePrefix='wooden_fish_assets'`，�得�返回 `410 Gone`，也�得由 `spacetime-client` ���音频路径。
 3. `功德有什么`：最多 8 �飘字，默认 `幸���康�财富�姻缘�幸��事业��功�功德`；创作���存���，�行�飘字展示时�追加 `+1`。
 
+图片生�链路固定为�图 image2 �程：第一步用默认木鱼图作为结构和画风�考，按用户题�关键�或�考图主题生� `1:1` �明底新敲击物；第二步用新敲击物作为主题和画风�考生� `9:16` 背景环境图，背景图�适�主题和画风，�能包�新敲击物本体，也�能增加木槌互动物�。两个资产分别写回 `hitObjectAsset` 与 `backgroundAsset`，并绑定到 `wooden_fish_work` 的 `hit_object` / `background` 槽�。�行�和结果页消费 `backgroundAsset` �竖�背景，中央��加 `hitObjectAsset`。
+
 �行�规则真相以�端 run 摘�为准，�端��点击低延迟表现�敲击动画�音频播放和飘字渲染。�次�功能区点击在当� run 内累计 `totalTapCount` 和 `wordCounters`；计数�进入账�长期账本，��排行榜。顶部计数器仅在��首次出现时创建，�续���继续累加。
 
 平�首页推��精选�最新�公开详情��索�已玩作�和公开试玩统一按 `sourceType='wooden-fish'` 与 `WF-*` 公开作��识别敲木鱼作�；公开列表应走 `wooden_fish_gallery_card_view` 订阅缓存，公开详情或�行��动时�片摘��足则补读完整 work profile。
diff --git a/packages/shared/src/contracts/woodenFish.ts b/packages/shared/src/contracts/woodenFish.ts
index e1026579..ae035f8f 100644
--- a/packages/shared/src/contracts/woodenFish.ts
+++ b/packages/shared/src/contracts/woodenFish.ts
@@ -55,6 +55,8 @@ export interface WoodenFishActionRequest {
   themeTags?: string[] | null;
   hitObjectPrompt?: string | null;
   hitObjectReferenceImageSrc?: string | null;
+  hitObjectAsset?: WoodenFishImageAsset | null;
+  backgroundAsset?: WoodenFishImageAsset | null;
   hitSoundPrompt?: string | null;
   hitSoundAsset?: WoodenFishAudioAsset | null;
   floatingWords?: string[] | null;
@@ -77,6 +79,7 @@ export interface WoodenFishDraftResponse {
   hitSoundPrompt: string | null;
   floatingWords: string[];
   hitObjectAsset: WoodenFishImageAsset | null;
+  backgroundAsset: WoodenFishImageAsset | null;
   hitSoundAsset: WoodenFishAudioAsset | null;
   coverImageSrc: string | null;
   generationStatus: WoodenFishGenerationStatus;
@@ -123,6 +126,7 @@ export interface WoodenFishWorkProfileResponse {
   summary: WoodenFishWorkSummaryResponse;
   draft: WoodenFishDraftResponse;
   hitObjectAsset: WoodenFishImageAsset;
+  backgroundAsset: WoodenFishImageAsset | null;
   hitSoundAsset: WoodenFishAudioAsset;
   floatingWords: string[];
 }
diff --git a/scripts/dev.mjs b/scripts/dev.mjs
index 363998a1..ef4fe055 100644
--- a/scripts/dev.mjs
+++ b/scripts/dev.mjs
@@ -816,7 +816,28 @@ class DevRunner {
     console.log(`[dev:spacetime] �移引导密钥: ${this.options.migrationBootstrapSecret}`);
   }
 
-  startApiServer(service) {
+  async ensureApiServerSpacetimeToken() {
+    const existingToken = String(this.baseEnv.GENARRATIVE_SPACETIME_TOKEN ?? '').trim();
+    if (existingToken && shouldTrustExistingSpacetimeToken(existingToken, this.state.spacetimeServer)) {
+      return;
+    }
+
+    const identityUrl = buildUrl(this.state.spacetimeServer, '/v1/identity');
+    if (!identityUrl) {
+      throw new Error(`无法构造 SpacetimeDB identity 地�: ${this.state.spacetimeServer}`);
+    }
+
+    const response = await fetchSpacetimeIdentity(identityUrl);
+    this.baseEnv.GENARRATIVE_SPACETIME_TOKEN = response.token;
+    this.state.spacetimeIdentity = response.identity;
+    console.log(
+      `[dev:spacetime] 已创建本地 Web identity: ${response.identity.slice(0, 12)}...`,
+    );
+  }
+
+  async startApiServer(service) {
+    await this.ensureApiServerSpacetimeToken();
+
     const mergedEnv = {
       ...this.baseEnv,
       GENARRATIVE_API_HOST: this.options.apiHost,
@@ -1413,6 +1434,75 @@ async function isHttpReady(url, timeoutMs = 1000) {
   }
 }
 
+async function fetchSpacetimeIdentity(url) {
+  let response;
+  try {
+    response = await fetch(url, {
+      method: 'POST',
+      headers: {
+        Accept: 'application/json',
+        'Content-Type': 'application/json',
+      },
+    });
+  } catch (error) {
+    throw new Error(
+      `SpacetimeDB identity 请求失败: ${url}; ${
+        error instanceof Error ? error.message : String(error)
+      }`,
+    );
+  }
+
+  const text = await response.text();
+  if (!response.ok) {
+    throw new Error(`SpacetimeDB identity HTTP ${response.status}: ${trimPreview(text)}`);
+  }
+
+  let payload;
+  try {
+    payload = JSON.parse(text);
+  } catch (error) {
+    throw new Error(
+      `SpacetimeDB identity �应�是�法 JSON: ${
+        error instanceof Error ? error.message : String(error)
+      }`,
+    );
+  }
+
+  const identity =
+    payload.identity ?? payload.Identity ?? payload.identity_hex ?? payload.identityHex;
+  const token = payload.token ?? payload.Token;
+  if (typeof identity !== 'string' || typeof token !== 'string') {
+    throw new Error(`SpacetimeDB identity �应缺少 identity/token: ${trimPreview(text)}`);
+  }
+
+  return {identity, token};
+}
+
+function shouldTrustExistingSpacetimeToken(existingToken, serverUrl) {
+  const shellToken = String(process.env.GENARRATIVE_SPACETIME_TOKEN ?? '').trim();
+  if (shellToken && shellToken === existingToken) {
+    return true;
+  }
+
+  return !isLoopbackSpacetimeServer(serverUrl);
+}
+
+function isLoopbackSpacetimeServer(serverUrl) {
+  try {
+    const url = new URL(serverUrl);
+    return ['127.0.0.1', 'localhost', '::1'].includes(url.hostname);
+  } catch {
+    return false;
+  }
+}
+
+function trimPreview(text, maxLength = 300) {
+  const normalized = String(text ?? '').replace(/\s+/gu, ' ').trim();
+  return normalized.length > maxLength
+    ? `${normalized.slice(0, maxLength)}...`
+    : normalized;
+}
+
 function runForeground(command, args, {cwd, env, label}) {
   return new Promise((resolveRun, rejectRun) => {
     const child = spawn(command, args, {
diff --git a/scripts/dev.test.ts b/scripts/dev.test.ts
index 643ff209..06015c59 100644
--- a/scripts/dev.test.ts
+++ b/scripts/dev.test.ts
@@ -271,4 +271,62 @@ describe('dev scheduler spacetime refresh', () => {
     expect(runner.waitForSpacetime).not.toHaveBeenCalled();
     expect(runner.publishSpacetimeModule).not.toHaveBeenCalled();
   });
+
+  test('�动 api-server �为空 token 自动创建本地 Web identity', async () => {
+    const {explicitOptions, options} = parseArgs([], {
+      GENARRATIVE_SPACETIME_TOKEN: '',
+    });
+    const runner = new DevRunner(options, {}, explicitOptions);
+    runner.state.spacetimeServer = 'http://127.0.0.1:3101';
+    globalThis.fetch = vi.fn(async () => ({
+      ok: true,
+      status: 200,
+      text: async () =>
+        JSON.stringify({
+          identity: 'c200localidentity',
+          token: 'local-web-token',
+        }),
+    })) as unknown as typeof fetch;
+
+    await runner.ensureApiServerSpacetimeToken();
+
+    expect(runner.baseEnv.GENARRATIVE_SPACETIME_TOKEN).toBe('local-web-token');
+    expect(globalThis.fetch).toHaveBeenCalledWith(
+      'http://127.0.0.1:3101/v1/identity',
+      expect.objectContaining({
+        method: 'POST',
+      }),
+    );
+  });
+
+  test('本地 SpacetimeDB �信任 env 文件中的陈旧 token', async () => {
+    const originalToken = process.env.GENARRATIVE_SPACETIME_TOKEN;
+    delete process.env.GENARRATIVE_SPACETIME_TOKEN;
+    try {
+      const {explicitOptions, options} = parseArgs([], {
+        GENARRATIVE_SPACETIME_TOKEN: 'stale-env-file-token',
+      });
+      const runner = new DevRunner(options, {GENARRATIVE_SPACETIME_TOKEN: 'stale-env-file-token'}, explicitOptions);
+      runner.state.spacetimeServer = 'http://127.0.0.1:3101';
+      globalThis.fetch = vi.fn(async () => ({
+        ok: true,
+        status: 200,
+        text: async () =>
+          JSON.stringify({
+            identity: 'c200freshidentity',
+            token: 'fresh-web-token',
+          }),
+      })) as unknown as typeof fetch;
+
+      await runner.ensureApiServerSpacetimeToken();
+
+      expect(runner.baseEnv.GENARRATIVE_SPACETIME_TOKEN).toBe('fresh-web-token');
+    } finally {
+      if (originalToken === undefined) {
+        delete process.env.GENARRATIVE_SPACETIME_TOKEN;
+      } else {
+        process.env.GENARRATIVE_SPACETIME_TOKEN = originalToken;
+      }
+    }
+  });
 });
diff --git a/server-rs/crates/api-server/src/openai_image_generation.rs b/server-rs/crates/api-server/src/openai_image_generation.rs
index ebf6e8a8..6689365a 100644
--- a/server-rs/crates/api-server/src/openai_image_generation.rs
+++ b/server-rs/crates/api-server/src/openai_image_generation.rs
@@ -380,17 +380,41 @@ pub(crate) async fn create_openai_image_edit(
     reference_image: &OpenAiReferenceImage,
     failure_context: &str,
 ) -> Result<OpenAiGeneratedImages, AppError> {
+    create_openai_image_edit_with_references(
+        http_client,
+        settings,
+        prompt,
+        negative_prompt,
+        size,
+        std::slice::from_ref(reference_image),
+        failure_context,
+    )
+    .await
+}
+
+pub(crate) async fn create_openai_image_edit_with_references(
+    http_client: &reqwest::Client,
+    settings: &OpenAiImageSettings,
+    prompt: &str,
+    negative_prompt: Option<&str>,
+    size: &str,
+    reference_images: &[OpenAiReferenceImage],
+    failure_context: &str,
+) -> Result<OpenAiGeneratedImages, AppError> {
+    if reference_images.is_empty() {
+        return Err(
+            AppError::from_status(StatusCode::BAD_REQUEST).with_details(json!({
+                "provider": VECTOR_ENGINE_PROVIDER,
+                "message": format!("{failure_context}：缺少�考图"),
+            })),
+        );
+    }
+
     let task_id = format!("vector-engine-edit-{}", current_utc_micros());
     let request_url = vector_engine_images_edit_url(settings);
     let normalized_size = normalize_image_size(size);
-    let image_part = reqwest::multipart::Part::bytes(reference_image.bytes.clone())
-        .file_name(reference_image.file_name.clone())
-        .mime_str(reference_image.mime_type.as_str())
-        .map_err(|error| {
-            map_openai_image_request_error(format!("{failure_context}：构造�考图失败：{error}"))
-        })?;
-    let form = reqwest::multipart::Form::new()
-        .part("image", image_part)
+
+    let mut form = reqwest::multipart::Form::new()
         .text("model", GPT_IMAGE_2_MODEL.to_string())
         .text(
             "prompt",
@@ -398,7 +422,20 @@ pub(crate) async fn create_openai_image_edit(
         )
         .text("n", "1")
         .text("size", normalized_size.clone());
+    for reference_image in reference_images {
+        let image_part = reqwest::multipart::Part::bytes(reference_image.bytes.clone())
+            .file_name(reference_image.file_name.clone())
+            .mime_str(reference_image.mime_type.as_str())
+            .map_err(|error| {
+                map_openai_image_request_error(format!(
+                    "{failure_context}：构造�考图失败：{error}"
+                ))
+            })?;
+        form = form.part("image", image_part);
+    }
+
     let started_at = std::time::Instant::now();
+    let reference_image_count = reference_images.len();
     let response = match http_client
         .post(request_url.as_str())
         .header(
@@ -432,7 +469,7 @@ pub(crate) async fn create_openai_image_edit(
                     None,
                     Some(latency_ms),
                     Some(prompt.chars().count()),
-                    Some(1),
+                    Some(reference_image_count),
                 ),
             )
             .await;
@@ -450,7 +487,7 @@ pub(crate) async fn create_openai_image_edit(
         status = response_status.as_u16(),
         prompt_chars = prompt.chars().count(),
         size = %normalized_size,
-        reference_image_count = 1usize,
+        reference_image_count,
         elapsed_ms = started_at.elapsed().as_millis() as u64,
         failure_context,
         "VectorEngine 图片编辑 HTTP 返回"
@@ -478,7 +515,7 @@ pub(crate) async fn create_openai_image_edit(
                     None,
                     Some(latency_ms),
                     Some(prompt.chars().count()),
-                    Some(1),
+                    Some(reference_image_count),
                 ),
             )
             .await;
@@ -505,7 +542,7 @@ pub(crate) async fn create_openai_image_edit(
                 Some(truncate_raw(response_text.as_str())),
                 Some(started_at.elapsed().as_millis() as u64),
                 Some(prompt.chars().count()),
-                Some(1),
+                Some(reference_image_count),
             ),
         )
         .await;
@@ -534,7 +571,7 @@ pub(crate) async fn create_openai_image_edit(
                     Some(truncate_raw(response_text.as_str())),
                     Some(started_at.elapsed().as_millis() as u64),
                     Some(prompt.chars().count()),
-                    Some(1),
+                    Some(reference_image_count),
                 ),
             )
             .await;
@@ -565,7 +602,7 @@ pub(crate) async fn create_openai_image_edit(
                             None,
                             Some(download_started_at.elapsed().as_millis() as u64),
                             Some(prompt.chars().count()),
-                            Some(1),
+                            Some(reference_image_count),
                         ),
                     )
                     .await;
@@ -597,7 +634,7 @@ pub(crate) async fn create_openai_image_edit(
             Some(truncate_raw(response_text.as_str())),
             Some(started_at.elapsed().as_millis() as u64),
             Some(prompt.chars().count()),
-            Some(1),
+            Some(reference_image_count),
         ),
     )
     .await;
@@ -1100,6 +1137,32 @@ mod tests {
         );
     }
 
+    #[tokio::test]
+    async fn vector_engine_multi_reference_edit_rejects_empty_references() {
+        let settings = OpenAiImageSettings {
+            base_url: "https://vector.example".to_string(),
+            api_key: "test-key".to_string(),
+            request_timeout_ms: 1_000_000,
+            external_api_audit_state: None,
+        };
+        let http_client = reqwest::Client::new();
+
+        let result = create_openai_image_edit_with_references(
+            &http_client,
+            &settings,
+            "�示�",
+            None,
+            "1:1",
+            &[],
+            "测试图片编辑失败",
+        )
+        .await;
+
+        let error = result.expect_err("empty references should be rejected locally");
+        assert_eq!(error.status_code(), StatusCode::BAD_REQUEST);
+        assert!(error.body_text().contains("缺少�考图"));
+    }
+
     #[test]
     fn b64_json_response_decodes_png_image() {
         let images = images_from_base64(
diff --git a/server-rs/crates/api-server/src/wooden_fish.rs b/server-rs/crates/api-server/src/wooden_fish.rs
index b0072a5b..43ffe1f3 100644
--- a/server-rs/crates/api-server/src/wooden_fish.rs
+++ b/server-rs/crates/api-server/src/wooden_fish.rs
@@ -28,14 +28,15 @@ use spacetime_client::SpacetimeClientError;
 use crate::generated_image_assets::{
     GeneratedImageAssetAdapter, GeneratedImageAssetDataUrl,
     adapter::GeneratedImageAssetAdapterMetadata, adapter::GeneratedImageAssetPersistInput,
-    normalize_generated_image_asset_mime,
+    decode_generated_image_asset_data_url, normalize_generated_image_asset_mime,
 };
 use crate::{
     api_response::json_success_body,
     auth::AuthenticatedAccessToken,
     http_error::AppError,
     openai_image_generation::{
-        DownloadedOpenAiImage, build_openai_image_http_client, create_openai_image_generation,
+        DownloadedOpenAiImage, OpenAiReferenceImage, build_openai_image_http_client,
+        create_openai_image_edit, create_openai_image_edit_with_references,
         require_openai_image_settings,
     },
     platform_errors::map_oss_error,
@@ -58,9 +59,15 @@ const DEFAULT_HIT_OBJECT_IMAGE_SRC: &str = "/wooden-fish/default-hit-object.png"
 const WOODEN_FISH_ENTITY_KIND: &str = "wooden_fish_work";
 const WOODEN_FISH_HIT_OBJECT_SLOT: &str = "hit_object";
 const WOODEN_FISH_HIT_OBJECT_ASSET_KIND: &str = "wooden_fish_hit_object";
+const WOODEN_FISH_BACKGROUND_SLOT: &str = "background";
+const WOODEN_FISH_BACKGROUND_ASSET_KIND: &str = "wooden_fish_background";
 const WOODEN_FISH_HIT_SOUND_SLOT: &str = "hit_sound";
 const WOODEN_FISH_HIT_SOUND_ASSET_KIND: &str = "wooden_fish_hit_sound";
 const WOODEN_FISH_HIT_SOUND_DURATION_SECONDS: u8 = 3;
+const DEFAULT_HIT_OBJECT_REFERENCE_BYTES: &[u8] = include_bytes!(concat!(
+    env!("CARGO_MANIFEST_DIR"),
+    "/../../../public/wooden-fish/default-hit-object.png"
+));
 
 pub async fn create_wooden_fish_session(
     State(state): State<AppState>,
@@ -372,6 +379,7 @@ fn build_wooden_fish_draft(payload: &WoodenFishWorkspaceCreateRequest) -> Wooden
             .or_else(|| Some(DEFAULT_HIT_SOUND_PROMPT.to_string())),
         floating_words: normalize_floating_words(payload.floating_words.clone()),
         hit_object_asset: None,
+        background_asset: None,
         hit_sound_asset: payload.hit_sound_asset.clone(),
         cover_image_src: None,
         generation_status: WoodenFishGenerationStatus::Draft,
@@ -410,7 +418,7 @@ async fn maybe_generate_hit_object_asset(
     ) {
         return Ok(());
     }
-    if payload.hit_object_asset.is_some() {
+    if payload.hit_object_asset.is_some() && payload.background_asset.is_some() {
         return Ok(());
     }
 
@@ -424,32 +432,21 @@ async fn maybe_generate_hit_object_asset(
         .map(|value| clean_string(value, DEFAULT_HIT_OBJECT_PROMPT))
         .filter(|value| !value.trim().is_empty())
         .unwrap_or_else(|| DEFAULT_HIT_OBJECT_PROMPT.to_string());
-    let reference_images = payload
-        .hit_object_reference_image_src
-        .as_deref()
-        .map(str::trim)
-        .filter(|value| !value.is_empty())
-        .map(|value| vec![value.to_string()])
-        .unwrap_or_default();
 
-    if reference_images.is_empty() && is_default_hit_object_prompt(prompt.as_str()) {
-        payload.hit_object_asset = Some(default_wooden_fish_hit_object_asset());
-        return Ok(());
-    }
-
-    let asset = generate_wooden_fish_hit_object_asset(
+    let generated = generate_wooden_fish_image_assets(
         state,
         owner_user_id,
         session_id,
         profile_id.as_str(),
         prompt.as_str(),
-        reference_images.as_slice(),
+        payload.hit_object_reference_image_src.as_deref(),
     )
     .await
     .map_err(|error| {
         wooden_fish_error_response(request_context, WOODEN_FISH_CREATION_PROVIDER, error)
     })?;
-    payload.hit_object_asset = Some(asset);
+    payload.hit_object_asset = Some(generated.hit_object_asset);
+    payload.background_asset = Some(generated.background_asset);
     Ok(())
 }
 
@@ -469,8 +466,7 @@ fn default_wooden_fish_hit_object_asset() -> WoodenFishImageAsset {
 fn is_default_hit_object_prompt(prompt: &str) -> bool {
     let normalized = normalize_hit_object_prompt_for_default_match(prompt);
     normalized.is_empty()
-        || normalized
-            == normalize_hit_object_prompt_for_default_match(DEFAULT_HIT_OBJECT_PROMPT)
+        || normalized == normalize_hit_object_prompt_for_default_match(DEFAULT_HIT_OBJECT_PROMPT)
         || normalized
             == normalize_hit_object_prompt_for_default_match("�通木鱼，圆润�爱，�明背景")
         || normalized
@@ -655,64 +651,229 @@ fn map_generated_creation_audio_to_wooden_fish_asset(
     })
 }
 
-async fn generate_wooden_fish_hit_object_asset(
+struct WoodenFishGeneratedImageAssets {
+    hit_object_asset: WoodenFishImageAsset,
+    background_asset: WoodenFishImageAsset,
+}
+
+async fn generate_wooden_fish_image_assets(
     state: &AppState,
     owner_user_id: &str,
     session_id: &str,
     profile_id: &str,
     prompt: &str,
-    reference_images: &[String],
-) -> Result<WoodenFishImageAsset, AppError> {
+    hit_object_reference_image_src: Option<&str>,
+) -> Result<WoodenFishGeneratedImageAssets, AppError> {
     let settings = require_openai_image_settings(state)?;
     let http_client = build_openai_image_http_client(&settings)?;
-    let final_prompt = build_wooden_fish_hit_object_prompt(prompt);
-    let generated = create_openai_image_generation(
+    let clean_reference_image_src = hit_object_reference_image_src
+        .map(str::trim)
+        .filter(|value| !value.is_empty());
+    let theme = resolve_wooden_fish_generation_theme(prompt, clean_reference_image_src);
+    let default_reference_image = default_wooden_fish_reference_image()?;
+    let theme_reference_image =
+        resolve_wooden_fish_theme_reference_image(clean_reference_image_src)?;
+
+    let (hit_object_asset, background_reference_image) =
+        if should_generate_wooden_fish_hit_object(prompt, clean_reference_image_src) {
+            let hit_object_prompt = build_wooden_fish_hit_object_prompt(theme.as_str());
+            let mut reference_images = vec![default_reference_image.clone()];
+            if let Some(reference_image) = theme_reference_image {
+                reference_images.push(reference_image);
+            }
+            let generated = create_openai_image_edit_with_references(
+                &http_client,
+                &settings,
+                hit_object_prompt.as_str(),
+                None,
+                "1:1",
+                reference_images.as_slice(),
+                "生�敲木鱼敲击物图案失败",
+            )
+            .await?;
+            let task_id = generated.task_id.clone();
+            let image = generated.images.into_iter().next().ok_or_else(|| {
+                AppError::from_status(StatusCode::BAD_GATEWAY).with_details(json!({
+                    "provider": "vector-engine",
+                    "message": "生�敲木鱼敲击物图案失败：上游未返回图片",
+                }))
+            })?;
+            let background_reference_image =
+                downloaded_wooden_fish_reference_image(&image, "wooden-fish-generated-hit-object");
+            let hit_object_asset = persist_wooden_fish_image_asset(
+                state,
+                owner_user_id,
+                session_id,
+                profile_id,
+                task_id.as_str(),
+                hit_object_prompt.as_str(),
+                image,
+                current_utc_micros(),
+                WoodenFishImageSlotPersistSpec {
+                    slot: WOODEN_FISH_HIT_OBJECT_SLOT,
+                    asset_kind: WOODEN_FISH_HIT_OBJECT_ASSET_KIND,
+                    asset_id_part: "hit-object",
+                    width: 1024,
+                    height: 1024,
+                },
+            )
+            .await?;
+            (hit_object_asset, background_reference_image)
+        } else {
+            (
+                default_wooden_fish_hit_object_asset(),
+                default_reference_image,
+            )
+        };
+
+    let background_prompt = build_wooden_fish_background_prompt(theme.as_str());
+    let background_generated = create_openai_image_edit(
         &http_client,
         &settings,
-        final_prompt.as_str(),
-        Some(build_wooden_fish_hit_object_negative_prompt().as_str()),
-        "1024x1024",
-        1,
-        reference_images,
-        "生�敲木鱼敲击物图案失败",
+        background_prompt.as_str(),
+        None,
+        "9:16",
+        &background_reference_image,
+        "生�敲木鱼背景环境图失败",
     )
     .await?;
-    let task_id = generated.task_id.clone();
-    let image = generated.images.into_iter().next().ok_or_else(|| {
-        AppError::from_status(StatusCode::BAD_GATEWAY).with_details(json!({
-            "provider": "vector-engine",
-            "message": "生�敲木鱼敲击物图案失败：上游未返回图片",
-        }))
-    })?;
-    let generated_at_micros = current_utc_micros();
-    let persisted = persist_wooden_fish_hit_object_asset(
+    let background_task_id = background_generated.task_id.clone();
+    let background_image = background_generated
+        .images
+        .into_iter()
+        .next()
+        .ok_or_else(|| {
+            AppError::from_status(StatusCode::BAD_GATEWAY).with_details(json!({
+                "provider": "vector-engine",
+                "message": "生�敲木鱼背景环境图失败：上游未返回图片",
+            }))
+        })?;
+    let background_asset = persist_wooden_fish_image_asset(
         state,
         owner_user_id,
         session_id,
         profile_id,
-        task_id.as_str(),
-        &final_prompt,
-        image,
-        generated_at_micros,
+        background_task_id.as_str(),
+        background_prompt.as_str(),
+        background_image,
+        current_utc_micros(),
+        WoodenFishImageSlotPersistSpec {
+            slot: WOODEN_FISH_BACKGROUND_SLOT,
+            asset_kind: WOODEN_FISH_BACKGROUND_ASSET_KIND,
+            asset_id_part: "background",
+            width: 1024,
+            height: 1536,
+        },
     )
     .await?;
 
-    Ok(persisted)
+    Ok(WoodenFishGeneratedImageAssets {
+        hit_object_asset,
+        background_asset,
+    })
 }
 
 fn build_wooden_fish_hit_object_prompt(prompt: &str) -> String {
     format!(
-        "请使用 gpt-image-2 生�一个适�点击敲击玩法的�个物�图案：{}。画��求：�个主体，�通�画风格，�明或纯净浅色背景，居中构图，圆润�爱，边缘清晰，适�移动端�幕中央展示和点击动画缩放。��包�文字�按钮�UI�边框�水���牌标识或人物手部。",
+        "生�敲木鱼新样�，�求结构，画风与�考图��高度一致，新样�颜色��使用新主题对应的颜色。\n新主题为：{}",
         clean_string(prompt, DEFAULT_HIT_OBJECT_PROMPT)
     )
 }
 
-fn build_wooden_fish_hit_object_negative_prompt() -> String {
-    "��生�文字�Logo�水��按钮�界�截图���背景�多个主体�真实摄影质感��怖或血腥元素。"
-        .to_string()
+fn build_wooden_fish_background_prompt(prompt: &str) -> String {
+    format!(
+        "生�敲木鱼背景，�求主题，画风与�考图��高度一致，背景元素和颜色��与主题对应，木鱼预设在�幕中央�置，木鱼主体周围元素��干净，背景氛围围绕外围设计，背景环境图中�包�新木鱼物�，背景氛围中�增加木槌互动物�。\n主题为：{}",
+        clean_string(prompt, DEFAULT_HIT_OBJECT_PROMPT)
+    )
 }
 
-async fn persist_wooden_fish_hit_object_asset(
+fn should_generate_wooden_fish_hit_object(
+    prompt: &str,
+    hit_object_reference_image_src: Option<&str>,
+) -> bool {
+    hit_object_reference_image_src.is_some() || !is_default_hit_object_prompt(prompt)
+}
+
+fn resolve_wooden_fish_generation_theme(
+    prompt: &str,
+    hit_object_reference_image_src: Option<&str>,
+) -> String {
+    let prompt = clean_string(prompt, DEFAULT_HIT_OBJECT_PROMPT);
+    if !is_default_hit_object_prompt(prompt.as_str()) {
+        return prompt;
+    }
+    if hit_object_reference_image_src.is_some() {
+        return "用户�供�考图".to_string();
+    }
+    prompt
+}
+
+fn default_wooden_fish_reference_image() -> Result<OpenAiReferenceImage, AppError> {
+    let bytes = DEFAULT_HIT_OBJECT_REFERENCE_BYTES.to_vec();
+    if bytes.is_empty() {
+        return Err(
+            AppError::from_status(StatusCode::INTERNAL_SERVER_ERROR).with_details(json!({
+                "provider": WOODEN_FISH_CREATION_PROVIDER,
+                "message": "敲木鱼默认�考图为空",
+            })),
+        );
+    }
+    Ok(OpenAiReferenceImage {
+        bytes,
+        mime_type: "image/png".to_string(),
+        file_name: "wooden-fish-default-hit-object-reference.png".to_string(),
+    })
+}
+
+fn resolve_wooden_fish_theme_reference_image(
+    source: Option<&str>,
+) -> Result<Option<OpenAiReferenceImage>, AppError> {
+    let Some(source) = source.map(str::trim).filter(|value| !value.is_empty()) else {
+        return Ok(None);
+    };
+    if !source.to_ascii_lowercase().starts_with("data:image/") {
+        return Err(
+            AppError::from_status(StatusCode::BAD_REQUEST).with_details(json!({
+                "provider": WOODEN_FISH_CREATION_PROVIDER,
+                "field": "hitObjectReferenceImageSrc",
+                "message": "敲木鱼�考图必须是 base64 图片 Data URL。",
+            })),
+        );
+    }
+    let decoded = decode_generated_image_asset_data_url(source).map_err(|_| {
+        AppError::from_status(StatusCode::BAD_REQUEST).with_details(json!({
+            "provider": WOODEN_FISH_CREATION_PROVIDER,
+            "field": "hitObjectReferenceImageSrc",
+            "message": "敲木鱼�考图必须是 base64 图片 Data URL。",
+        }))
+    })?;
+    Ok(Some(OpenAiReferenceImage {
+        file_name: format!("wooden-fish-theme-reference.{}", decoded.format.extension),
+        mime_type: decoded.format.mime_type,
+        bytes: decoded.bytes,
+    }))
+}
+
+fn downloaded_wooden_fish_reference_image(
+    image: &DownloadedOpenAiImage,
+    file_name_stem: &str,
+) -> OpenAiReferenceImage {
+    OpenAiReferenceImage {
+        bytes: image.bytes.clone(),
+        mime_type: image.mime_type.clone(),
+        file_name: format!("{file_name_stem}.{}", image.extension),
+    }
+}
+
+struct WoodenFishImageSlotPersistSpec {
+    slot: &'static str,
+    asset_kind: &'static str,
+    asset_id_part: &'static str,
+    width: u32,
+    height: u32,
+}
+
+async fn persist_wooden_fish_image_asset(
     state: &AppState,
     owner_user_id: &str,
     session_id: &str,
@@ -721,6 +882,7 @@ async fn persist_wooden_fish_hit_object_asset(
     prompt: &str,
     image: DownloadedOpenAiImage,
     generated_at_micros: i64,
+    spec: WoodenFishImageSlotPersistSpec,
 ) -> Result<WoodenFishImageAsset, AppError> {
     let oss_client = state.oss_client().ok_or_else(|| {
         AppError::from_status(StatusCode::SERVICE_UNAVAILABLE).with_details(json!({
@@ -735,7 +897,7 @@ async fn persist_wooden_fish_hit_object_asset(
             path_segments: vec![
                 sanitize_wooden_fish_asset_segment(session_id, "session"),
                 sanitize_wooden_fish_asset_segment(profile_id, "profile"),
-                WOODEN_FISH_HIT_OBJECT_SLOT.to_string(),
+                spec.slot.to_string(),
                 format!("asset-{generated_at_micros}"),
             ],
             file_stem: "image".to_string(),
@@ -745,11 +907,11 @@ async fn persist_wooden_fish_hit_object_asset(
             },
             access: OssObjectAccess::Private,
             metadata: GeneratedImageAssetAdapterMetadata {
-                asset_kind: Some(WOODEN_FISH_HIT_OBJECT_ASSET_KIND.to_string()),
+                asset_kind: Some(spec.asset_kind.to_string()),
                 owner_user_id: Some(owner_user_id.to_string()),
                 entity_kind: Some(WOODEN_FISH_ENTITY_KIND.to_string()),
                 entity_id: Some(profile_id.to_string()),
-                slot: Some(WOODEN_FISH_HIT_OBJECT_SLOT.to_string()),
+                slot: Some(spec.slot.to_string()),
                 provider: Some("image2".to_string()),
                 task_id: Some(task_id.to_string()),
             },
@@ -784,7 +946,7 @@ async fn persist_wooden_fish_hit_object_asset(
                 head.content_type.or(Some(persisted_mime_type)),
                 head.content_length,
                 head.etag,
-                WOODEN_FISH_HIT_OBJECT_ASSET_KIND.to_string(),
+                spec.asset_kind.to_string(),
                 Some(task_id.to_string()),
                 Some(owner_user_id.to_string()),
                 Some(profile_id.to_string()),
@@ -808,8 +970,8 @@ async fn persist_wooden_fish_hit_object_asset(
                 asset_object.asset_object_id.clone(),
                 WOODEN_FISH_ENTITY_KIND.to_string(),
                 profile_id.to_string(),
-                WOODEN_FISH_HIT_OBJECT_SLOT.to_string(),
-                WOODEN_FISH_HIT_OBJECT_ASSET_KIND.to_string(),
+                spec.slot.to_string(),
+                spec.asset_kind.to_string(),
                 Some(owner_user_id.to_string()),
                 Some(profile_id.to_string()),
                 generated_at_micros,
@@ -823,20 +985,21 @@ async fn persist_wooden_fish_hit_object_asset(
             owner_user_id,
             session_id,
             profile_id,
+            slot = spec.slot,
             error = %error,
             "敲木鱼图片资产绑定失败，历�素�索引�能缺少绑定记录"
         );
     }
 
     Ok(WoodenFishImageAsset {
-        asset_id: format!("{profile_id}-hit-object-{generated_at_micros}"),
+        asset_id: format!("{profile_id}-{}-{generated_at_micros}", spec.asset_id_part),
         image_src: put_result.legacy_public_path,
         image_object_key: head.object_key,
         asset_object_id: asset_object.asset_object_id,
         generation_provider: "image2".to_string(),
         prompt: prompt.to_string(),
-        width: 1024,
-        height: 1024,
+        width: spec.width,
+        height: spec.height,
     })
 }
 
@@ -1027,15 +1190,51 @@ fn current_utc_micros() -> i64 {
 #[cfg(test)]
 mod tests {
     use super::*;
+    use base64::{Engine as _, engine::general_purpose::STANDARD as BASE64_STANDARD};
 
     #[test]
-    fn wooden_fish_hit_object_prompt_keeps_user_object_and_image2_constraints() {
+    fn wooden_fish_hit_object_prompt_uses_hidden_image2_flow() {
         let prompt = build_wooden_fish_hit_object_prompt("赛�莲花木鱼");
 
-        assert!(prompt.contains("赛�莲花木鱼"));
-        assert!(prompt.contains("gpt-image-2"));
-        assert!(prompt.contains("�个主体"));
-        assert!(prompt.contains("��包�文字"));
+        assert_eq!(
+            prompt,
+            "生�敲木鱼新样�，�求结构，画风与�考图��高度一致，新样�颜色��使用新主题对应的颜色。\n新主题为：赛�莲花木鱼"
+        );
+    }
+
+    #[test]
+    fn wooden_fish_background_prompt_uses_hidden_image2_flow() {
+        let prompt = build_wooden_fish_background_prompt("赛�莲花木鱼");
+
+        assert_eq!(
+            prompt,
+            "生�敲木鱼背景，�求主题，画风与�考图��高度一致，背景元素和颜色��与主题对应，木鱼预设在�幕中央�置，木鱼主体周围元素��干净，背景氛围围绕外围设计，背景环境图中�包�新木鱼物�，背景氛围中�增加木槌互动物�。\n主题为：赛�莲花木鱼"
+        );
+    }
+
+    #[test]
+    fn wooden_fish_theme_reference_image_decodes_data_url_for_image2() {
+        let source = format!(
+            "data:image/png;base64,{}",
+            BASE64_STANDARD.encode(b"\x89PNG\r\n\x1A\nreference")
+        );
+
+        let image = resolve_wooden_fish_theme_reference_image(Some(source.as_str()))
+            .expect("data url should parse")
+            .expect("reference image should exist");
+
+        assert_eq!(image.mime_type, "image/png");
+        assert_eq!(image.file_name, "wooden-fish-theme-reference.png");
+        assert!(image.bytes.starts_with(b"\x89PNG\r\n\x1A\n"));
+    }
+
+    #[test]
+    fn wooden_fish_theme_reference_image_rejects_non_data_url() {
+        let error = resolve_wooden_fish_theme_reference_image(Some("/generated/example.png"))
+            .expect_err("legacy path should not be accepted as direct image2 reference");
+
+        assert_eq!(error.status_code(), StatusCode::BAD_REQUEST);
+        assert!(error.body_text().contains("Data URL"));
     }
 
     #[test]
@@ -1053,7 +1252,9 @@ mod tests {
     fn wooden_fish_default_prompt_matches_legacy_defaults() {
         assert!(is_default_hit_object_prompt(DEFAULT_HIT_OBJECT_PROMPT));
         assert!(is_default_hit_object_prompt("�通木鱼，圆润�爱，�明背景"));
-        assert!(is_default_hit_object_prompt("�通木鱼，�明背景，居中，圆润�爱"));
+        assert!(is_default_hit_object_prompt(
+            "�通木鱼，�明背景，居中，圆润�爱"
+        ));
         assert!(is_default_hit_object_prompt("�通木鱼"));
         assert!(!is_default_hit_object_prompt("赛�莲花木鱼"));
     }
diff --git a/server-rs/crates/shared-contracts/src/wooden_fish.rs b/server-rs/crates/shared-contracts/src/wooden_fish.rs
index 105d11b1..18cc81d5 100644
--- a/server-rs/crates/shared-contracts/src/wooden_fish.rs
+++ b/server-rs/crates/shared-contracts/src/wooden_fish.rs
@@ -90,6 +90,9 @@ pub struct WoodenFishActionRequest {
     #[serde(default, skip_deserializing)]
     pub hit_object_asset: Option<WoodenFishImageAsset>,
     #[serde(default)]
+    #[serde(skip_deserializing)]
+    pub background_asset: Option<WoodenFishImageAsset>,
+    #[serde(default)]
     pub hit_sound_prompt: Option<String>,
     #[serde(default)]
     pub hit_sound_asset: Option<WoodenFishAudioAsset>,
@@ -123,6 +126,8 @@ pub struct WoodenFishDraftResponse {
     #[serde(default)]
     pub hit_object_asset: Option<WoodenFishImageAsset>,
     #[serde(default)]
+    pub background_asset: Option<WoodenFishImageAsset>,
+    #[serde(default)]
     pub hit_sound_asset: Option<WoodenFishAudioAsset>,
     #[serde(default)]
     pub cover_image_src: Option<String>,
@@ -185,6 +190,8 @@ pub struct WoodenFishWorkProfileResponse {
     pub summary: WoodenFishWorkSummaryResponse,
     pub draft: WoodenFishDraftResponse,
     pub hit_object_asset: WoodenFishImageAsset,
+    #[serde(default)]
+    pub background_asset: Option<WoodenFishImageAsset>,
     pub hit_sound_asset: WoodenFishAudioAsset,
     pub floating_words: Vec<String>,
 }
@@ -365,6 +372,18 @@ mod tests {
                 width: 1024,
                 height: 1024,
             }),
+            background_asset: Some(WoodenFishImageAsset {
+                asset_id: "background-1".to_string(),
+                image_src: "/generated-wooden-fish-assets/profile/background/image.png"
+                    .to_string(),
+                image_object_key: "generated-wooden-fish-assets/profile/background/image.png"
+                    .to_string(),
+                asset_object_id: "background-object-1".to_string(),
+                generation_provider: "image2".to_string(),
+                prompt: "赛�莲花背景".to_string(),
+                width: 1024,
+                height: 1536,
+            }),
             hit_sound_prompt: Some("短促木鱼声".to_string()),
             hit_sound_asset: Some(WoodenFishAudioAsset {
                 asset_id: "sound-1".to_string(),
@@ -386,6 +405,7 @@ mod tests {
             payload["hitObjectAsset"]["imageObjectKey"],
             json!("generated-wooden-fish-assets/profile/hit-object/image.png")
         );
+        assert_eq!(payload["backgroundAsset"]["height"], json!(1536));
         assert_eq!(payload["hitSoundAsset"]["source"], json!("upload"));
         assert_eq!(payload["hitSoundAsset"]["durationMs"], json!(800));
     }
@@ -464,11 +484,13 @@ mod tests {
                 hit_sound_prompt: Some("清脆木鱼".to_string()),
                 floating_words: vec!["功德".to_string()],
                 hit_object_asset: Some(image.clone()),
+                background_asset: None,
                 hit_sound_asset: Some(audio.clone()),
                 cover_image_src: Some(image.image_src.clone()),
                 generation_status: WoodenFishGenerationStatus::Ready,
             },
             hit_object_asset: image,
+            background_asset: None,
             hit_sound_asset: audio,
             floating_words: vec!["功德".to_string()],
         };
diff --git a/server-rs/crates/spacetime-client/src/mapper/wooden_fish.rs b/server-rs/crates/spacetime-client/src/mapper/wooden_fish.rs
index 80beca4c..b4edf32f 100644
--- a/server-rs/crates/spacetime-client/src/mapper/wooden_fish.rs
+++ b/server-rs/crates/spacetime-client/src/mapper/wooden_fish.rs
@@ -112,6 +112,7 @@ fn map_wooden_fish_work_snapshot(
         hit_sound_prompt: snapshot.hit_sound_prompt.clone(),
         floating_words: snapshot.floating_words.clone(),
         hit_object_asset: snapshot.hit_object_asset.clone().map(map_image_asset),
+        background_asset: snapshot.background_asset.clone().map(map_image_asset),
         hit_sound_asset: snapshot.hit_sound_asset.clone().map(map_audio_asset),
         cover_image_src: empty_string_to_none(snapshot.cover_image_src.clone()),
         generation_status: parse_generation_status(&snapshot.generation_status),
@@ -145,6 +146,7 @@ fn map_wooden_fish_work_snapshot(
         },
         draft,
         hit_object_asset,
+        background_asset: snapshot.background_asset.map(map_image_asset),
         hit_sound_asset,
         floating_words: snapshot.floating_words,
     })
@@ -163,6 +165,7 @@ fn map_wooden_fish_draft_snapshot(snapshot: WoodenFishDraftSnapshot) -> WoodenFi
         hit_sound_prompt: snapshot.hit_sound_prompt,
         floating_words: snapshot.floating_words,
         hit_object_asset: snapshot.hit_object_asset.map(map_image_asset),
+        background_asset: snapshot.background_asset.map(map_image_asset),
         hit_sound_asset: snapshot.hit_sound_asset.map(map_audio_asset),
         cover_image_src: snapshot.cover_image_src,
         generation_status: parse_generation_status(&snapshot.generation_status),
diff --git a/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_draft_compile_input_type.rs b/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_draft_compile_input_type.rs
index d88914d6..402f40ab 100644
--- a/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_draft_compile_input_type.rs
+++ b/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_draft_compile_input_type.rs
@@ -18,6 +18,7 @@ pub struct WoodenFishDraftCompileInput {
     pub hit_object_reference_image_src: Option<String>,
     pub hit_sound_prompt: Option<String>,
     pub hit_object_asset_json: Option<String>,
+    pub background_asset_json: Option<String>,
     pub hit_sound_asset_json: Option<String>,
     pub floating_words_json: Option<String>,
     pub cover_image_src: Option<String>,
diff --git a/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_draft_snapshot_type.rs b/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_draft_snapshot_type.rs
index f5f93b09..17c4e2b9 100644
--- a/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_draft_snapshot_type.rs
+++ b/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_draft_snapshot_type.rs
@@ -21,6 +21,7 @@ pub struct WoodenFishDraftSnapshot {
     pub hit_sound_prompt: Option<String>,
     pub floating_words: Vec<String>,
     pub hit_object_asset: Option<WoodenFishImageAssetSnapshot>,
+    pub background_asset: Option<WoodenFishImageAssetSnapshot>,
     pub hit_sound_asset: Option<WoodenFishAudioAssetSnapshot>,
     pub cover_image_src: Option<String>,
     pub generation_status: String,
diff --git a/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_gallery_view_row_type.rs b/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_gallery_view_row_type.rs
index d3d7b30f..ac17e2de 100644
--- a/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_gallery_view_row_type.rs
+++ b/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_gallery_view_row_type.rs
@@ -23,6 +23,7 @@ pub struct WoodenFishGalleryViewRow {
     pub hit_object_reference_image_src: Option<String>,
     pub hit_sound_prompt: Option<String>,
     pub hit_object_asset: Option<WoodenFishImageAssetSnapshot>,
+    pub background_asset: Option<WoodenFishImageAssetSnapshot>,
     pub hit_sound_asset: Option<WoodenFishAudioAssetSnapshot>,
     pub floating_words: Vec<String>,
     pub cover_image_src: String,
@@ -57,6 +58,8 @@ pub struct WoodenFishGalleryViewRowCols {
     pub hit_sound_prompt: __sdk::__query_builder::Col<WoodenFishGalleryViewRow, Option<String>>,
     pub hit_object_asset:
         __sdk::__query_builder::Col<WoodenFishGalleryViewRow, Option<WoodenFishImageAssetSnapshot>>,
+    pub background_asset:
+        __sdk::__query_builder::Col<WoodenFishGalleryViewRow, Option<WoodenFishImageAssetSnapshot>>,
     pub hit_sound_asset:
         __sdk::__query_builder::Col<WoodenFishGalleryViewRow, Option<WoodenFishAudioAssetSnapshot>>,
     pub floating_words: __sdk::__query_builder::Col<WoodenFishGalleryViewRow, Vec<String>>,
@@ -92,6 +95,7 @@ impl __sdk::__query_builder::HasCols for WoodenFishGalleryViewRow {
             ),
             hit_sound_prompt: __sdk::__query_builder::Col::new(table_name, "hit_sound_prompt"),
             hit_object_asset: __sdk::__query_builder::Col::new(table_name, "hit_object_asset"),
+            background_asset: __sdk::__query_builder::Col::new(table_name, "background_asset"),
             hit_sound_asset: __sdk::__query_builder::Col::new(table_name, "hit_sound_asset"),
             floating_words: __sdk::__query_builder::Col::new(table_name, "floating_words"),
             cover_image_src: __sdk::__query_builder::Col::new(table_name, "cover_image_src"),
diff --git a/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_work_profile_row_type.rs b/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_work_profile_row_type.rs
index 5e692843..c82a9c6c 100644
--- a/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_work_profile_row_type.rs
+++ b/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_work_profile_row_type.rs
@@ -27,6 +27,7 @@ pub struct WoodenFishWorkProfileRow {
     pub play_count: u32,
     pub updated_at: __sdk::Timestamp,
     pub published_at: Option<__sdk::Timestamp>,
+    pub background_asset_json: Option<String>,
 }
 
 impl __sdk::InModule for WoodenFishWorkProfileRow {
@@ -59,6 +60,8 @@ pub struct WoodenFishWorkProfileRowCols {
     pub updated_at: __sdk::__query_builder::Col<WoodenFishWorkProfileRow, __sdk::Timestamp>,
     pub published_at:
         __sdk::__query_builder::Col<WoodenFishWorkProfileRow, Option<__sdk::Timestamp>>,
+    pub background_asset_json:
+        __sdk::__query_builder::Col<WoodenFishWorkProfileRow, Option<String>>,
 }
 
 impl __sdk::__query_builder::HasCols for WoodenFishWorkProfileRow {
@@ -100,6 +103,10 @@ impl __sdk::__query_builder::HasCols for WoodenFishWorkProfileRow {
             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"),
+            background_asset_json: __sdk::__query_builder::Col::new(
+                table_name,
+                "background_asset_json",
+            ),
         }
     }
 }
diff --git a/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_work_snapshot_type.rs b/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_work_snapshot_type.rs
index 7c173133..fdaf3116 100644
--- a/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_work_snapshot_type.rs
+++ b/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_work_snapshot_type.rs
@@ -22,6 +22,7 @@ pub struct WoodenFishWorkSnapshot {
     pub hit_object_reference_image_src: Option<String>,
     pub hit_sound_prompt: Option<String>,
     pub hit_object_asset: Option<WoodenFishImageAssetSnapshot>,
+    pub background_asset: Option<WoodenFishImageAssetSnapshot>,
     pub hit_sound_asset: Option<WoodenFishAudioAssetSnapshot>,
     pub floating_words: Vec<String>,
     pub cover_image_src: String,
diff --git a/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_work_update_input_type.rs b/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_work_update_input_type.rs
index 2981f8e3..cd7c3547 100644
--- a/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_work_update_input_type.rs
+++ b/server-rs/crates/spacetime-client/src/module_bindings/wooden_fish_work_update_input_type.rs
@@ -16,6 +16,7 @@ pub struct WoodenFishWorkUpdateInput {
     pub hit_object_reference_image_src: Option<String>,
     pub hit_sound_prompt: Option<String>,
     pub hit_object_asset_json: Option<String>,
+    pub background_asset_json: Option<String>,
     pub hit_sound_asset_json: Option<String>,
     pub floating_words_json: Option<String>,
     pub cover_image_src: Option<String>,
diff --git a/server-rs/crates/spacetime-client/src/wooden_fish.rs b/server-rs/crates/spacetime-client/src/wooden_fish.rs
index 9297a163..edcfd312 100644
--- a/server-rs/crates/spacetime-client/src/wooden_fish.rs
+++ b/server-rs/crates/spacetime-client/src/wooden_fish.rs
@@ -529,6 +529,9 @@ fn merge_action_into_draft(
         if let Some(asset) = payload.hit_object_asset.clone() {
             draft.hit_object_asset = Some(asset);
         }
+        if let Some(asset) = payload.background_asset.clone() {
+            draft.background_asset = Some(asset);
+        }
     }
     if matches!(
         scope,
@@ -573,6 +576,7 @@ fn merge_action_into_draft(
         && payload.hit_object_asset.is_none()
     {
         draft.hit_object_asset = None;
+        draft.background_asset = None;
     }
     if draft.floating_words.is_empty() {
         draft.floating_words = default_floating_words();
@@ -606,6 +610,9 @@ fn build_compile_input(
     let hit_sound_asset = draft.hit_sound_asset.clone().ok_or_else(|| {
         SpacetimeClientError::validation_failed("wooden fish hit sound asset 缺少真实生�资产")
     })?;
+    let background_asset = draft.background_asset.clone().ok_or_else(|| {
+        SpacetimeClientError::validation_failed("wooden fish background asset 缺少真实生�资产")
+    })?;
 
     Ok(WoodenFishDraftCompileInput {
         session_id: current.session_id.clone(),
@@ -619,6 +626,7 @@ fn build_compile_input(
         hit_object_reference_image_src: draft.hit_object_reference_image_src.clone(),
         hit_sound_prompt: draft.hit_sound_prompt.clone(),
         hit_object_asset_json: Some(json_string(&hit_object_asset)?),
+        background_asset_json: Some(json_string(&background_asset)?),
         hit_sound_asset_json: Some(json_string(&hit_sound_asset)?),
         floating_words_json: Some(json_string(&draft.floating_words)?),
         cover_image_src: draft.cover_image_src.clone(),
@@ -644,6 +652,7 @@ fn build_update_input(
         hit_object_reference_image_src: draft.hit_object_reference_image_src.clone(),
         hit_sound_prompt: draft.hit_sound_prompt.clone(),
         hit_object_asset_json: None,
+        background_asset_json: None,
         hit_sound_asset_json: if include_hit_sound_asset {
             draft
                 .hit_sound_asset
@@ -710,6 +719,7 @@ fn default_draft() -> WoodenFishDraftResponse {
         hit_sound_prompt: Some(DEFAULT_HIT_SOUND_PROMPT.to_string()),
         floating_words: default_floating_words(),
         hit_object_asset: None,
+        background_asset: None,
         hit_sound_asset: None,
         cover_image_src: None,
         generation_status: WoodenFishGenerationStatus::Draft,
@@ -796,6 +806,7 @@ mod tests {
         let session = session_with_draft(draft_without_assets());
         let mut payload = action(WoodenFishActionType::CompileDraft);
         payload.hit_object_asset = Some(generated_hit_object_asset("generated-compile-object"));
+        payload.background_asset = Some(generated_background_asset("generated-compile-background"));
         payload.hit_sound_asset = Some(generated_hit_sound_asset("generated-compile-sound"));
 
         let (plan, draft) =
@@ -822,6 +833,13 @@ mod tests {
                 .unwrap_or("")
                 .contains("generated-compile-sound")
         );
+        assert!(
+            input
+                .background_asset_json
+                .as_deref()
+                .unwrap_or("")
+                .contains("generated-compile-background")
+        );
         assert_eq!(draft.generation_status, WoodenFishGenerationStatus::Ready);
     }
 
@@ -830,6 +848,7 @@ mod tests {
         let session = session_with_draft(draft_without_assets());
         let mut payload = action(WoodenFishActionType::CompileDraft);
         payload.hit_object_asset = Some(generated_hit_object_asset("generated-compile-object"));
+        payload.background_asset = Some(generated_background_asset("generated-compile-background"));
 
         let error =
             match build_wooden_fish_action_plan(&session, OWNER_USER_ID, &payload, NOW_MICROS) {
@@ -844,12 +863,33 @@ mod tests {
         );
     }
 
+    #[test]
+    fn wooden_fish_compile_requires_real_background_asset_from_api_server() {
+        let session = session_with_draft(draft_without_assets());
+        let mut payload = action(WoodenFishActionType::CompileDraft);
+        payload.hit_object_asset = Some(generated_hit_object_asset("generated-compile-object"));
+        payload.hit_sound_asset = Some(generated_hit_sound_asset("generated-compile-sound"));
+
+        let error =
+            match build_wooden_fish_action_plan(&session, OWNER_USER_ID, &payload, NOW_MICROS) {
+                Ok(_) => panic!("compile-draft should not publish without background asset"),
+                Err(error) => error,
+            };
+
+        assert!(
+            error
+                .to_string()
+                .contains("background asset 缺少真实生�资产")
+        );
+    }
+
     #[test]
     fn wooden_fish_action_regenerate_hit_object_replaces_only_object_asset() {
         let session = session_with_draft(draft_with_assets());
         let mut payload = action(WoodenFishActionType::RegenerateHitObject);
         payload.hit_object_prompt = Some("新的敲击物".to_string());
         payload.hit_object_asset = Some(generated_hit_object_asset("generated-object"));
+        payload.background_asset = Some(generated_background_asset("generated-background"));
 
         let (plan, _draft) =
             build_wooden_fish_action_plan(&session, OWNER_USER_ID, &payload, NOW_MICROS)
@@ -886,6 +926,13 @@ mod tests {
                 .unwrap_or("")
                 .contains("old-sound")
         );
+        assert!(
+            input
+                .background_asset_json
+                .as_deref()
+                .unwrap_or("")
+                .contains("generated-background")
+        );
     }
 
     #[test]
@@ -930,6 +977,7 @@ mod tests {
             hit_object_prompt: None,
             hit_object_reference_image_src: None,
             hit_object_asset: None,
+            background_asset: None,
             hit_sound_prompt: None,
             hit_sound_asset: None,
             floating_words: None,
@@ -969,6 +1017,21 @@ mod tests {
         }
     }
 
+    fn generated_background_asset(asset_id: &str) -> WoodenFishImageAsset {
+        WoodenFishImageAsset {
+            asset_id: asset_id.to_string(),
+            image_src: "/generated-wooden-fish-assets/real-profile/background/image.png"
+                .to_string(),
+            image_object_key: "generated-wooden-fish-assets/real-profile/background/image.png"
+                .to_string(),
+            asset_object_id: format!("{asset_id}-asset"),
+            generation_provider: "image2".to_string(),
+            prompt: "新的敲击背景".to_string(),
+            width: 1024,
+            height: 1536,
+        }
+    }
+
     fn generated_hit_sound_asset(asset_id: &str) -> WoodenFishAudioAsset {
         WoodenFishAudioAsset {
             asset_id: asset_id.to_string(),
@@ -995,6 +1058,16 @@ mod tests {
                 width: 1024,
                 height: 1024,
             }),
+            background_asset: Some(WoodenFishImageAsset {
+                asset_id: "old-background".to_string(),
+                image_src: "/generated-wooden-fish-assets/old-background.png".to_string(),
+                image_object_key: "generated-wooden-fish-assets/old-background.png".to_string(),
+                asset_object_id: "old-background-asset".to_string(),
+                generation_provider: "image2".to_string(),
+                prompt: "旧背景".to_string(),
+                width: 1024,
+                height: 1536,
+            }),
             hit_sound_asset: Some(WoodenFishAudioAsset {
                 asset_id: "old-sound".to_string(),
                 audio_src: "/generated-wooden-fish-assets/old-sound.mp3".to_string(),
@@ -1023,6 +1096,7 @@ mod tests {
             hit_sound_prompt: Some("旧音效".to_string()),
             floating_words: default_floating_words(),
             hit_object_asset: None,
+            background_asset: None,
             hit_sound_asset: None,
             cover_image_src: None,
             generation_status: WoodenFishGenerationStatus::Draft,
diff --git a/server-rs/crates/spacetime-module/src/migration.rs b/server-rs/crates/spacetime-module/src/migration.rs
index 4b630149..c2b2bc4b 100644
--- a/server-rs/crates/spacetime-module/src/migration.rs
+++ b/server-rs/crates/spacetime-module/src/migration.rs
@@ -1265,6 +1265,14 @@ fn normalize_migration_row(table_name: &str, value: &serde_json::Value) -> serde
                 .or_insert(serde_json::Value::Null);
         }
     }
+    if table_name == "wooden_fish_work_profile" {
+        if let Some(object) = next_value.as_object_mut() {
+            // 中文注释：敲木鱼背景环境图晚于首版作�表加入，旧�移包按未生�背景兼容。
+            object
+                .entry("background_asset_json".to_string())
+                .or_insert(serde_json::Value::Null);
+        }
+    }
     next_value
 }
 
diff --git a/server-rs/crates/spacetime-module/src/wooden_fish.rs b/server-rs/crates/spacetime-module/src/wooden_fish.rs
index 7808ce6a..3b3982b2 100644
--- a/server-rs/crates/spacetime-module/src/wooden_fish.rs
+++ b/server-rs/crates/spacetime-module/src/wooden_fish.rs
@@ -81,6 +81,7 @@ pub struct WoodenFishGalleryViewRow {
     pub hit_object_reference_image_src: Option<String>,
     pub hit_sound_prompt: Option<String>,
     pub hit_object_asset: Option<WoodenFishImageAssetSnapshot>,
+    pub background_asset: Option<WoodenFishImageAssetSnapshot>,
     pub hit_sound_asset: Option<WoodenFishAudioAssetSnapshot>,
     pub floating_words: Vec<String>,
     pub cover_image_src: String,
@@ -327,6 +328,11 @@ fn compile_wooden_fish_draft_tx(
         .as_deref()
         .map(parse_json)
         .transpose()?;
+    let background_asset = input
+        .background_asset_json
+        .as_deref()
+        .map(parse_json)
+        .transpose()?;
     let cover_image_src = input
         .cover_image_src
         .as_deref()
@@ -354,6 +360,7 @@ fn compile_wooden_fish_draft_tx(
         hit_sound_prompt: input.hit_sound_prompt.as_deref().and_then(clean_optional),
         floating_words: floating_words.clone(),
         hit_object_asset: hit_object_asset.clone(),
+        background_asset: background_asset.clone(),
         hit_sound_asset: hit_sound_asset.clone(),
         cover_image_src: cover_image_src.clone(),
         generation_status: input
@@ -392,6 +399,7 @@ fn compile_wooden_fish_draft_tx(
         play_count: 0,
         updated_at: compiled_at,
         published_at: None,
+        background_asset_json: background_asset.as_ref().map(to_json_string),
     };
     upsert_work(ctx, row);
     let config = config_from_draft(&draft);
@@ -469,6 +477,14 @@ fn update_wooden_fish_work_tx(
         let asset = parse_json::<WoodenFishAudioAssetSnapshot>(&value)?;
         next.hit_sound_asset_json = to_json_string(&asset);
     }
+    if let Some(value) = input
+        .background_asset_json
+        .as_deref()
+        .and_then(clean_optional)
+    {
+        let asset = parse_json::<WoodenFishImageAssetSnapshot>(&value)?;
+        next.background_asset_json = Some(to_json_string(&asset));
+    }
     if let Some(value) = input
         .floating_words_json
         .as_deref()
@@ -674,6 +690,7 @@ fn build_gallery_view_row(
         hit_object_reference_image_src: work.hit_object_reference_image_src,
         hit_sound_prompt: work.hit_sound_prompt,
         hit_object_asset: work.hit_object_asset,
+        background_asset: work.background_asset,
         hit_sound_asset: work.hit_sound_asset,
         floating_words: work.floating_words,
         cover_image_src: work.cover_image_src,
@@ -721,6 +738,12 @@ fn build_work_snapshot(row: &WoodenFishWorkProfileRow) -> Result<WoodenFishWorkS
         hit_object_asset: clean_optional(&row.hit_object_asset_json)
             .map(|value| parse_json(&value))
             .transpose()?,
+        background_asset: row
+            .background_asset_json
+            .as_deref()
+            .and_then(clean_optional)
+            .map(|value| parse_json(&value))
+            .transpose()?,
         hit_sound_asset: clean_optional(&row.hit_sound_asset_json)
             .map(|value| parse_json(&value))
             .transpose()?,
@@ -965,6 +988,11 @@ fn insert_event(
 fn is_publish_ready(row: &WoodenFishWorkProfileRow) -> bool {
     !row.work_title.trim().is_empty()
         && !row.hit_object_asset_json.trim().is_empty()
+        && row
+            .background_asset_json
+            .as_deref()
+            .and_then(clean_optional)
+            .is_some()
         && !row.hit_sound_asset_json.trim().is_empty()
         && !row.floating_words_json.trim().is_empty()
         && row.generation_status == WOODEN_FISH_GENERATION_READY
@@ -1002,6 +1030,7 @@ fn draft_from_config(
         hit_sound_prompt: config.hit_sound_prompt.clone(),
         floating_words: normalize_floating_words(&config.floating_words),
         hit_object_asset: None,
+        background_asset: None,
         hit_sound_asset: None,
         cover_image_src: None,
         generation_status: generation_status.to_string(),
@@ -1021,6 +1050,7 @@ fn draft_from_work_snapshot(work: &WoodenFishWorkSnapshot) -> WoodenFishDraftSna
         hit_sound_prompt: work.hit_sound_prompt.clone(),
         floating_words: work.floating_words.clone(),
         hit_object_asset: work.hit_object_asset.clone(),
+        background_asset: work.background_asset.clone(),
         hit_sound_asset: work.hit_sound_asset.clone(),
         cover_image_src: clean_optional(&work.cover_image_src),
         generation_status: work.generation_status.clone(),
@@ -1199,6 +1229,7 @@ fn clone_work(row: &WoodenFishWorkProfileRow) -> WoodenFishWorkProfileRow {
         hit_object_reference_image_src: row.hit_object_reference_image_src.clone(),
         hit_sound_prompt: row.hit_sound_prompt.clone(),
         hit_object_asset_json: row.hit_object_asset_json.clone(),
+        background_asset_json: row.background_asset_json.clone(),
         hit_sound_asset_json: row.hit_sound_asset_json.clone(),
         floating_words_json: row.floating_words_json.clone(),
         cover_image_src: row.cover_image_src.clone(),
diff --git a/server-rs/crates/spacetime-module/src/wooden_fish/tables.rs b/server-rs/crates/spacetime-module/src/wooden_fish/tables.rs
index e7f84193..27899c15 100644
--- a/server-rs/crates/spacetime-module/src/wooden_fish/tables.rs
+++ b/server-rs/crates/spacetime-module/src/wooden_fish/tables.rs
@@ -45,6 +45,8 @@ pub struct WoodenFishWorkProfileRow {
     pub(crate) play_count: u32,
     pub(crate) updated_at: Timestamp,
     pub(crate) published_at: Option<Timestamp>,
+    #[default(None::<String>)]
+    pub(crate) background_asset_json: Option<String>,
 }
 
 #[spacetimedb::table(
diff --git a/server-rs/crates/spacetime-module/src/wooden_fish/types.rs b/server-rs/crates/spacetime-module/src/wooden_fish/types.rs
index 8b8ea2ea..0bbeef03 100644
--- a/server-rs/crates/spacetime-module/src/wooden_fish/types.rs
+++ b/server-rs/crates/spacetime-module/src/wooden_fish/types.rs
@@ -45,6 +45,7 @@ pub struct WoodenFishDraftCompileInput {
     pub hit_object_reference_image_src: Option<String>,
     pub hit_sound_prompt: Option<String>,
     pub hit_object_asset_json: Option<String>,
+    pub background_asset_json: Option<String>,
     pub hit_sound_asset_json: Option<String>,
     pub floating_words_json: Option<String>,
     pub cover_image_src: Option<String>,
@@ -63,6 +64,7 @@ pub struct WoodenFishWorkUpdateInput {
     pub hit_object_reference_image_src: Option<String>,
     pub hit_sound_prompt: Option<String>,
     pub hit_object_asset_json: Option<String>,
+    pub background_asset_json: Option<String>,
     pub hit_sound_asset_json: Option<String>,
     pub floating_words_json: Option<String>,
     pub cover_image_src: Option<String>,
@@ -207,6 +209,7 @@ pub struct WoodenFishDraftSnapshot {
     pub hit_sound_prompt: Option<String>,
     pub floating_words: Vec<String>,
     pub hit_object_asset: Option<WoodenFishImageAssetSnapshot>,
+    pub background_asset: Option<WoodenFishImageAssetSnapshot>,
     pub hit_sound_asset: Option<WoodenFishAudioAssetSnapshot>,
     pub cover_image_src: Option<String>,
     pub generation_status: String,
@@ -242,6 +245,7 @@ pub struct WoodenFishWorkSnapshot {
     pub hit_object_reference_image_src: Option<String>,
     pub hit_sound_prompt: Option<String>,
     pub hit_object_asset: Option<WoodenFishImageAssetSnapshot>,
+    pub background_asset: Option<WoodenFishImageAssetSnapshot>,
     pub hit_sound_asset: Option<WoodenFishAudioAssetSnapshot>,
     pub floating_words: Vec<String>,
     pub cover_image_src: String,
diff --git a/src/components/wooden-fish-result/WoodenFishResultView.tsx b/src/components/wooden-fish-result/WoodenFishResultView.tsx
index f4118fe5..33402a90 100644
--- a/src/components/wooden-fish-result/WoodenFishResultView.tsx
+++ b/src/components/wooden-fish-result/WoodenFishResultView.tsx
@@ -54,6 +54,10 @@ export function WoodenFishResultView({
     : draft.hitObjectAsset;
   const hitObjectSrc =
     hitObjectAsset?.imageSrc?.trim() || WOODEN_FISH_DEFAULT_HIT_OBJECT_SRC;
+  const backgroundAsset = isWorkProfile
+    ? profile.backgroundAsset ?? draft.backgroundAsset
+    : draft.backgroundAsset;
+  const backgroundSrc = backgroundAsset?.imageSrc?.trim() || '';
   const hitSoundAsset = isWorkProfile
     ? profile.hitSoundAsset
     : draft.hitSoundAsset;
@@ -118,13 +122,24 @@ export function WoodenFishResultView({
               {description}
             </div>
           ) : null}
-          <div className="mt-4 grid min-h-0 flex-1 place-items-center rounded-[1.1rem] border border-[var(--platform-subpanel-border)] bg-white/78 p-5">
-            <ResolvedAssetImage
-              src={hitObjectSrc}
-              fallbackSrc={WOODEN_FISH_DEFAULT_HIT_OBJECT_SRC}
-              alt="敲击物图案"
-              className="max-h-[min(46vh,22rem)] w-full object-contain drop-shadow-[0_18px_28px_rgba(15,23,42,0.18)]"
-            />
+          <div className="mt-4 grid min-h-0 flex-1 place-items-center">
+            <div className="relative grid aspect-[9/16] h-full max-h-[min(58vh,34rem)] w-full max-w-[20rem] place-items-center overflow-hidden rounded-[1.1rem] border border-[var(--platform-subpanel-border)] bg-white/78">
+              {backgroundSrc ? (
+                <ResolvedAssetImage
+                  src={backgroundSrc}
+                  alt=""
+                  aria-hidden="true"
+                  className="absolute inset-0 h-full w-full object-cover"
+                />
+              ) : null}
+              <div className="absolute inset-0 bg-white/10" />
+              <ResolvedAssetImage
+                src={hitObjectSrc}
+                fallbackSrc={WOODEN_FISH_DEFAULT_HIT_OBJECT_SRC}
+                alt="敲击物图案"
+                className="relative z-10 w-[68%] object-contain drop-shadow-[0_18px_28px_rgba(15,23,42,0.18)]"
+              />
+            </div>
           </div>
         </section>
 
diff --git a/src/components/wooden-fish-runtime/WoodenFishRuntimeShell.tsx b/src/components/wooden-fish-runtime/WoodenFishRuntimeShell.tsx
index 4bcb2417..d8b230da 100644
--- a/src/components/wooden-fish-runtime/WoodenFishRuntimeShell.tsx
+++ b/src/components/wooden-fish-runtime/WoodenFishRuntimeShell.tsx
@@ -95,6 +95,10 @@ export function WoodenFishRuntimeShell({
     profile?.hitObjectAsset?.imageSrc?.trim() ||
     profile?.draft.hitObjectAsset?.imageSrc?.trim() ||
     WOODEN_FISH_DEFAULT_HIT_OBJECT_SRC;
+  const backgroundSrc =
+    profile?.backgroundAsset?.imageSrc?.trim() ||
+    profile?.draft.backgroundAsset?.imageSrc?.trim() ||
+    '';
   const hitSoundSrc =
     profile?.hitSoundAsset?.audioSrc ?? profile?.draft.hitSoundAsset?.audioSrc;
   const { resolvedUrl: resolvedAudioUrl } = useResolvedAssetReadUrl(hitSoundSrc);
@@ -217,6 +221,16 @@ export function WoodenFishRuntimeShell({
       onPointerDown={registerTap}
     >
       <div className="pointer-events-none absolute inset-0 bg-[radial-gradient(circle_at_50%_18%,rgba(255,255,255,0.92),transparent_26%),linear-gradient(180deg,#fff8e8_0%,#eef7ed_55%,#e5f2f7_100%)]" />
+      {backgroundSrc ? (
+        <ResolvedAssetImage
+          src={backgroundSrc}
+          alt=""
+          aria-hidden="true"
+          draggable={false}
+          className="pointer-events-none absolute inset-0 h-full w-full object-cover"
+        />
+      ) : null}
+      <div className="pointer-events-none absolute inset-0 bg-white/10" />
 
       <header
         data-wooden-fish-functional="true"
diff --git a/src/services/miniGameDraftGenerationProgress.test.ts b/src/services/miniGameDraftGenerationProgress.test.ts
index 9ee2265b..d9777c60 100644
--- a/src/services/miniGameDraftGenerationProgress.test.ts
+++ b/src/services/miniGameDraftGenerationProgress.test.ts
@@ -356,7 +356,7 @@ describe('miniGameDraftGenerationProgress', () => {
     ]);
   });
 
-  test('wooden fish draft generation exposes hit object and sound pipeline', () => {
+  test('wooden fish draft generation exposes hit object, background and sound pipeline', () => {
     const state = createMiniGameDraftGenerationState('wooden-fish');
 
     const progress = buildMiniGameDraftGenerationProgress(
@@ -367,6 +367,7 @@ describe('miniGameDraftGenerationProgress', () => {
     expect(progress?.steps.map((step) => step.id)).toEqual([
       'wooden-fish-draft',
       'wooden-fish-hit-object',
+      'wooden-fish-background',
       'wooden-fish-hit-sound',
       'wooden-fish-write-draft',
     ]);
diff --git a/src/services/miniGameDraftGenerationProgress.ts b/src/services/miniGameDraftGenerationProgress.ts
index f2085ce4..043d887f 100644
--- a/src/services/miniGameDraftGenerationProgress.ts
+++ b/src/services/miniGameDraftGenerationProgress.ts
@@ -66,6 +66,7 @@ export type MiniGameDraftGenerationPhase =
   | 'jump-hop-write-draft'
   | 'wooden-fish-draft'
   | 'wooden-fish-hit-object'
+  | 'wooden-fish-background'
   | 'wooden-fish-hit-sound'
   | 'wooden-fish-write-draft'
   | 'puzzle-images'
@@ -327,25 +328,31 @@ const WOODEN_FISH_STEPS = [
     id: 'wooden-fish-draft',
     label: '整�玩法�稿',
     detail: '�存作�信��敲击物�音效和飘字�置。',
-    weight: 10,
+    weight: 8,
   },
   {
     id: 'wooden-fish-hit-object',
     label: '生�敲击物图案',
     detail: '使用 image2 生�最终�行�敲击物图案。',
-    weight: 48,
+    weight: 34,
+  },
+  {
+    id: 'wooden-fish-background',
+    label: '生�背景环境图',
+    detail: '使用 image2 生�敲击背景环境图。',
+    weight: 34,
   },
   {
     id: 'wooden-fish-hit-sound',
     label: '准备敲击音效',
     detail: '生�或写回短促敲击音效资产。',
-    weight: 30,
+    weight: 16,
   },
   {
     id: 'wooden-fish-write-draft',
     label: '写入正��稿',
-    detail: '�存图案�音效�飘字和��摘�。',
-    weight: 12,
+    detail: '�存图案�背景�音效�飘字和��摘�。',
+    weight: 8,
   },
 ] as const satisfies ReadonlyArray<MiniGameStepDefinition>;
 
@@ -530,9 +537,12 @@ function resolveWoodenFishPhaseByElapsedMs(
   if (elapsedMs >= 270_000) {
     return 'wooden-fish-write-draft';
   }
-  if (elapsedMs >= 185_000) {
+  if (elapsedMs >= 240_000) {
     return 'wooden-fish-hit-sound';
   }
+  if (elapsedMs >= 120_000) {
+    return 'wooden-fish-background';
+  }
   if (elapsedMs >= 12_000) {
     return 'wooden-fish-hit-object';
   }
diff --git a/src/services/wooden-fish/woodenFishClient.ts b/src/services/wooden-fish/woodenFishClient.ts
index 17716bf1..d2a0fc4e 100644
--- a/src/services/wooden-fish/woodenFishClient.ts
+++ b/src/services/wooden-fish/woodenFishClient.ts
@@ -106,6 +106,8 @@ function normalizeWoodenFishWorkProfile(
     summary,
     draft: flattened.draft,
     hitObjectAsset: flattened.hitObjectAsset,
+    backgroundAsset:
+      flattened.backgroundAsset ?? flattened.draft?.backgroundAsset ?? null,
     hitSoundAsset: flattened.hitSoundAsset,
     floatingWords: flattened.floatingWords,
   };