From 01a68bcf3dde8f8963adf4ba377a08c886c71551 Mon Sep 17 00:00:00 2001
From: kdletters <kdletters@qq.com>
Date: Wed, 3 Jun 2026 19:54:27 +0800
Subject: [PATCH] fix: route creation wallet chip to top-up entry

---
 .hermes/shared-memory/decision-log.md         |  1 +
 ...�玩法创作】平�入�与玩法链路-2026-05-15.md |  2 ++
 .../RpgEntryHomeView.recharge.test.tsx        | 35 +++++++++++++++++++
 src/components/rpg-entry/RpgEntryHomeView.tsx |  4 +--
 4 files changed, 40 insertions(+), 2 deletions(-)

diff --git a/.hermes/shared-memory/decision-log.md b/.hermes/shared-memory/decision-log.md
index 2a616fff..6f798308 100644
--- a/.hermes/shared-memory/decision-log.md
+++ b/.hermes/shared-memory/decision-log.md
@@ -216,6 +216,7 @@
 
 - 背景：创作页顶部�banner 奖池和玩法�消耗�径曾�混在一起，容易把活动奖池误认�账�余�，也让横�空间被外部边框和过大的�片高度挤�。
 - 决策：移动端创作 Tab 顶�与 `陶泥儿` �牌�一行�显示真实账户泥点数，数�直接� `profileDashboard.walletBalance`；banner 内�展示赛事奖池，新增拼图主题创作赛和抓大鹅主题创作赛，两个主题奖池� `1000` 泥点数；玩法����下角固定展示 `10-20泥点数`，列表外框�消，�片高度和横�间�一起收紧。
+- 追加决策：创作页和�稿页顶��上泥点余�胶囊是补足泥点入�；当�环境开�充值入�时直接打开账户充值弹窗，�则打开��兑��弹窗，��跳到账户��或泥点账�。
 - 影�范围：`src/components/custom-world-home/CustomWorldCreationStartCard.tsx`�`src/components/rpg-entry/RpgEntryHomeView.tsx`�创作页相关测试和玩法链路文档。
 - 验�方�：移动端�览器检查应看到创作顶�余���内分页点�内嵌横� banner 和更紧凑的玩法�；`CustomWorldCreationHub.test.tsx` 与 `RpgEntryHomeView.recharge.test.tsx` 的定�断言应��通过。
 - 关�文档：`docs/�玩法创作】平�入�与玩法链路-2026-05-15.md`。
diff --git a/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md b/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
index 479c91c2..561b7133 100644
--- a/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
+++ b/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
@@ -8,6 +8,8 @@
 
 当�点击底部加�进入的创作入�页承载��公告��创作入�页签和两列模��；页签中�有真实�端作�架摘�存在时�展示“最近创作�，其余为玩法模�分类。点击模���直接进入对应玩法已有的入�创作表� stage，���过空白��页，也�把旧表�嵌进创作入�页。移动端创作入�页顶�在 `陶泥儿` �牌�一行显示真实账户泥点数，数��自 `profileDashboard.walletBalance`，�得�把公告内容或活动奖池当作账�余�展示。创作入�页公告�数�优先读� `GET /api/creation-entry/config` 的 `eventBanners` 数组，多��置时�端自动轮播，旧 `eventBanner` 仅作为��兼容兜底。��公告�置��表�：��公告包�标题和 HTML 内容，���存时�列化为�端 `eventBannersJson` 传输字段，由�端空��沙箱 iframe 展示；旧结构化 banner 字段仅�留回显兼容，��作为��公告�置主格�；�得执行 JSX 或把��代�直接注入 DOM。玩法列表��套外部边框�片，移动端需�压缩横�边�和两列间�；玩法�统一按“上图�左上状�标签（仅�开放�显示）����下 `10-20泥点数`�下方白底标题/�述�结构展示，�片高度��紧凑但标题��述和预估消耗点数都必须��。创作入�页根容器��使用 `platform-page-stage` 这类全局内容�片壳，但继续�留 `platform-remap-surface` 作为主题和输入框样�命中钩�。创作入�页字�需�对�平�普通 UI 档�：顶�泥点组件�公告正文�分类 Tab 和玩法�标题 / 副标题 / 消耗说明优先使用 `11px` 到 `14px`，�使用 `text-lg`�`text-xl` 或更大的展示级字�。�稿 Tab 继续承接作�架；底部加�入�页的“最近创作��用 7 天内的真实�端作�架摘�判断是�展示，并从摘�里推导最近使用过的模� ID，页�必须展示“仅显示最近7天内使用过的模���示，列表内容必须�用其它页签里的模��样��文案和点击行为，�展示具体作��称�摘�或生�状�，也�新增独立最近创作�组件。RPG�RPG 之外的�玩法入�分别�到既有的 `agent-workspace`�`big-fish-agent-workspace`�`match3d-agent-workspace`�`square-hole-agent-workspace`�`jump-hop-workspace`�`wooden-fish-workspace`�`puzzle-agent-workspace`�`bark-battle-workspace`�`visual-novel-agent-workspace`�`baby-object-match-workspace`，这些入�继续承接�玩法自己的表���稿��和�续编排，�作为创作入�页内容。
 
+创作页和�稿页顶��上角的泥点余�胶囊是补足泥点入�：如果当��行环境开�充值入�，点击�直接打开账户充值弹窗；�则直接打开��兑��弹窗。该入���跳到账户��或泥点账�，头� / 设置等账�入�继续�留�自语义。
+
 创作���数��留 `sessionId`�`profileId`�`draftId`�`workId` 这四个�有 query。它们��许在�一�创作链路的结果页�生�页�工作�之间�留；切到首页�公开作�详情�runtime 或�一�玩法链路时必须清掉。生�页等待时间统一以生�状�里的 `startedAtMs` 为准；创建该状�时优先使用�端 session 下�的时间戳，作�摘�里的 `updatedAt` ��用于排�与摘�展示，�作为�端自行推导业务状�的真相。
 
 统一创作入�覆盖当��进入创作链路的已有模�：`rpg`�`big-fish`�`puzzle`�`match3d`�`jump-hop`�`wooden-fish`�`square-hole`�`bark-battle`�`visual-novel`�`baby-object-match` 和 `creative-agent`；`airp` �是未开放��，�作为当�统一创作链路目标。拼图�抓大鹅�跳一跳和敲木鱼在�端继续�过 `UnifiedCreationWorkspace` 和 `UnifiedGenerationPage`：`UnifiedCreationWorkspace` 作为平�壳�赖的统一创作编排层，�内部调用 `src/components/unified-creation/workspaces/` 下的 `PuzzleCreationWorkspace`�`Match3DCreationWorkspace`�`JumpHopCreationWorkspace` 和 `WoodenFishCreationWorkspace`。其它已有模�由平�壳用 `UnifiedCreationPage` 包�既有工作�，�用统一标题��返回入��页�级纵�滚动和��字段契约，�时�留�玩法自己的表���稿��和�续编排。创作页字段清�由�端在 `GET /api/creation-entry/config` 的 `creationTypes[].unifiedCreationSpec` 下�，�端仅在该扩展�缺失时回退到本地默认 spec；字段类型��留 `text`�`select`�`image`�`audio`。`UnifiedCreationPage` �在 UI 中�外展示字段说明 chip，也�在�上角显示内部 `playId`�模� ID 或工作�阶段�；竖�移动端必须能从标题�表�一路滑到�交按钮。�玩法工作�负责渲染真实输入控件�上传�历�素��校验和�交，但返回按钮��留在统一页头，工作�内部����渲染。暗色创作进度�片�于 `platform-remap-surface` 内时，必须用组件专属 class 覆盖浅色主题 remap，确�白字�浅色边框和进度�底色�会被全局规则改�深色；����赖通用 `text-white*` 类。敲木鱼的音效和功德�����得放进独立内部滚动容器，移动端应跟�页�自然滚动展开。生�页统一展示阶段�当�步骤�总进度�错误和�试动作。
diff --git a/src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx b/src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx
index 989b581e..07f39d36 100644
--- a/src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx
+++ b/src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx
@@ -3137,6 +3137,41 @@ test('logged in create tab shows real wallet balance beside the brand', () => {
   expect(topbar?.textContent).toContain('1,234泥点');
 });
 
+test('create tab wallet chip opens reward code when recharge entry is hidden', async () => {
+  const user = userEvent.setup();
+  mockNarrowMobileLayout();
+
+  render(
+    <ProfileHomeViewHarness
+      activeTab="create"
+      profileDashboardOverrides={{ walletBalance: 70 }}
+    />,
+  );
+
+  await user.click(screen.getByRole('button', { name: /^70泥点$/u }));
+
+  expect(await screen.findByPlaceholderText('输入兑��')).toBeTruthy();
+  expect(mockGetRpgProfileRechargeCenter).not.toHaveBeenCalled();
+});
+
+test('create tab wallet chip opens recharge when recharge entry is enabled', async () => {
+  const user = userEvent.setup();
+  mockWechatDesktopLayout();
+
+  render(
+    <ProfileHomeViewHarness
+      activeTab="create"
+      profileDashboardOverrides={{ walletBalance: 70 }}
+    />,
+  );
+
+  await user.click(screen.getByRole('button', { name: /^70泥点$/u }));
+
+  expect(await screen.findByText('账户充值')).toBeTruthy();
+  expect(mockGetRpgProfileRechargeCenter).toHaveBeenCalledTimes(1);
+  expect(screen.queryByPlaceholderText('输入兑��')).toBeNull();
+});
+
 test('mobile discover search submits public work code', async () => {
   const user = userEvent.setup();
   const onSearchPublicCode = vi.fn();
diff --git a/src/components/rpg-entry/RpgEntryHomeView.tsx b/src/components/rpg-entry/RpgEntryHomeView.tsx
index 6d5a5a8d..9d2a37d9 100644
--- a/src/components/rpg-entry/RpgEntryHomeView.tsx
+++ b/src/components/rpg-entry/RpgEntryHomeView.tsx
@@ -7063,7 +7063,7 @@ export function RpgEntryHomeView({
                 (activeTab === 'create' || activeTab === 'saves') ? (
                 <button
                   type="button"
-                  onClick={openUserSurface}
+                  onClick={openRechargeOrRewardCodeModal}
                   className="platform-mobile-create-wallet-chip inline-flex shrink-0 items-center gap-1.5 rounded-full border border-[#f0cfae] bg-[#fff5eb] px-2.5 py-1.5 text-xs font-black text-[#b65f2c] shadow-[0_10px_22px_rgba(174,111,73,0.12)]"
                   aria-label={`${formatDashboardCount(remainingNarrativeCoins)}泥点`}
                 >
@@ -7229,7 +7229,7 @@ export function RpgEntryHomeView({
                 (activeTab === 'create' || activeTab === 'saves') ? (
                   <button
                     type="button"
-                    onClick={openUserSurface}
+                    onClick={openRechargeOrRewardCodeModal}
                     className="platform-desktop-create-wallet-chip platform-desktop-search inline-flex items-center gap-2 px-3 py-2.5 text-xs font-black text-[#b65f2c]"
                     aria-label={`${formatDashboardCount(remainingNarrativeCoins)}泥点`}
                   >