From 894d64766bf58294030d18ab9999e61924fc6649 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 27 Sep 2026 15:15:02 +0800 Subject: [PATCH] =?UTF-8?q?docs(ux):=20GP=20=E5=BD=92=E5=B1=9E=E6=8B=8D?= =?UTF-8?q?=E6=9D=BF=E5=AF=B9=E9=BD=90=E6=89=B9=E2=80=94=E2=80=94=E7=94=A8?= =?UTF-8?q?=E6=88=B7=E5=8F=A3=E5=BE=84=E6=88=98=E6=96=97=E8=83=9C=E5=88=A9?= =?UTF-8?q?=E6=80=BB=E7=BB=93=E7=BB=93=E7=AE=97=E6=89=BF=E8=BD=BD=20GP=20?= =?UTF-8?q?=E6=80=BB=E9=87=8F+=E5=A2=9E=E9=87=8F(battle.md=20OQ14=20?= =?UTF-8?q?=E4=B8=BA=E5=87=86,06=20=E5=BD=92=E5=B1=9E=E8=A1=8C=E7=99=BB?= =?UTF-8?q?=E8=AE=B0=E5=81=8F=E5=B7=AE=E4=BF=AE=E6=AD=A3)+=E5=A4=B1?= =?UTF-8?q?=E8=B4=A5=E6=B5=81=E5=86=92=E9=99=A9=E6=80=BB=E7=BB=93=E7=BB=93?= =?UTF-8?q?=E7=AE=97=E5=9B=9E=E5=AD=98=E6=A1=A3=E9=A6=96=E9=A1=B5=E7=A1=AE?= =?UTF-8?q?=E8=AE=A4;level-clear.md=20OQ1/OQ3=20=E6=94=B6=E5=8F=A3(GP=20?= =?UTF-8?q?=E7=A6=81=E5=85=A5/=E7=BB=93=E7=AE=97=E7=94=BB=E9=9D=A2?= =?UTF-8?q?=E6=8C=87=E8=AE=A4=3D=E5=86=92=E9=99=A9=E6=80=BB=E7=BB=93?= =?UTF-8?q?=E7=BB=93=E7=AE=97,=E9=92=A5=E7=9F=B3=E4=B8=89=E5=A4=84?= =?UTF-8?q?=E6=89=BF=E8=BD=BD=E7=BB=B4=E6=8C=81);06=20=E6=9D=A1=E7=9B=AE?= =?UTF-8?q?=E6=94=B9=E9=83=A8=E5=88=86=E6=94=B6=E5=8F=A3(=E5=89=A9=3D?= =?UTF-8?q?=E8=83=9C=E5=88=A9=E7=BB=93=E7=AE=97=20GP=20=E6=8E=A5=E7=BA=BF+?= =?UTF-8?q?=E5=85=B3=E5=8D=A1=E7=94=BB=E9=9D=A2=E5=B8=B8=E9=A9=BB)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/gdd/06-待办清单.md | 12 +++++++----- design/gdd/ux/level-clear.md | 11 ++++++----- 2 files changed, 13 insertions(+), 10 deletions(-) diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index 3ac30328..1ab2546c 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -355,15 +355,17 @@ #### GP/钥石迁出战斗屏后的展示面接线（2026-09-26 登记） -**现状**：信息归属批（台账 165）将 GP（中循环资源）/钥石（大循环资源）自战斗屏 C 区退役（用户二轮拍板去向）：**GP = 关卡画面常驻总量 + 战斗结算画面总量+增量；钥石 = 结算画面 + 营地**。当前各去向展示面均未实现（原 C 区钱包行为唯一展示面，已删）——数据源完好（runner.gp / MetaProgression 账本），纯呈现接线。 +**现状**：信息归属批（台账 165）将 GP（中循环资源）/钥石（大循环资源）自战斗屏 C 区退役（用户二轮拍板去向）：**GP = 关卡画面常驻总量 + 战斗结算画面总量+增量；钥石 = 结算画面 + 营地**。原 C 区钱包行为唯一展示面已删——数据源完好（runner.gp / MetaProgression 账本），纯呈现接线。 -具体呈现形态归对应 UX spec 批次——结算屏 spec 已建 [level-clear](ux/level-clear.md)，2026-09-27 义务锁定版，**GP 增量归属两处登记不一致待拍板**：battle.md OQ14「战斗结算画面总量+增量」vs 本条归属行「结算画面批 GP 增量+钥石」；关卡画面/营地 UX spec 未建。 +**归属冲突已收口——2026-09-27 用户拍板**：战斗胜利出现战斗总结结算、展示获得的资源（目前 = GP）；战斗失败出现冒险总结结算、确认后回存档首页。battle.md OQ14「战斗结算画面」口径为准，GP 总量+增量归**战斗胜利总结结算**；本条原归属行「结算画面批 GP 增量」系登记偏差已修正。 -钥石呈现现行已有两处占位承载——大奖励屏（big_reward_text 钥石增量+累计）与冒险结算屏（keystone_settle_text 入账明细），与拍板措辞「结算画面」的对应关系在 level-clear.md OQ3 对齐。 +**接线缺口**：战斗胜利结算现行文案（battle_end_text「战斗胜利！敌人全灭。」）无 GP 呈现——增量+总量上胜利结算为本条剩余实装面；关卡画面常驻总量归关卡画面批。 -**归属**：关卡画面 UX 批（GP 常驻）/ 结算画面 UX 批（GP 增量+钥石）/ 营地 UX 批（钥石） +钥石呈现现行承载即拍板口径——大奖励屏（big_reward_text 钥石增量+累计 = Boss 层进账）、冒险总结结算（keystone_settle_text 入账明细 = 「结算画面」指认）、营地（存量）；三处并存系「进账时刻 / 收束明细 / 存量可用」不同义，不构成重复展示（level-clear.md OQ3 已收口维持）。 -**状态**：待办（2026-09-26 用户拍板去向；战斗屏侧已清账）——结算屏 spec 已建档 2026-09-27 +**归属**：战斗屏胜利结算批（GP 增量+总量呈现接线——battle.md 域）/ 关卡画面 UX 批（GP 常驻总量）/ 钥石侧已全部承载（大奖励屏 + 冒险总结结算 + 营地，无剩余） + +**状态**：部分收口——2026-09-27 用户拍板归属冲突收口 + 钥石三处承载确认；剩 = 战斗胜利结算 GP 呈现实装 + 关卡画面 GP 常驻，均纯呈现接线 #### 节点奖励屏 UX spec（随魔法道具内容重定批交付，2026-09-27 登记） diff --git a/design/gdd/ux/level-clear.md b/design/gdd/ux/level-clear.md index 6e67862b..26ca715f 100644 --- a/design/gdd/ux/level-clear.md +++ b/design/gdd/ux/level-clear.md @@ -55,10 +55,10 @@ 按 2026-09-26 信息归属两铁律（循环口径 + 单一展示面）过闸后的准入清单： 1. **大奖励三件套**（第一注视点）：生命上限提升（含新上限读数）、生命回满、钥石入账（增量 + 累计）——中循环边界事件的兑付账，本屏是它唯一消费口。钥石入账与营地的钥石存量不同义（进账瞬间 vs 存量可用），不构成重复展示 -2. **GP 结算呈现**（**归属待拍板，见 OQ1**）：battle.md OQ14 = 战斗结算画面总量+增量；06 待办归属行 = 结算画面批 GP 增量+钥石——两处登记不一致。拍板前本屏不新增 GP 呈现义务（现行大奖励文案无 GP，维持） +2. **GP 结算呈现——归属已收口（2026-09-27 用户拍板）**：GP 不进本屏。战斗胜利总结结算展示获得的资源（目前 = GP），GP 增量+总量归战斗胜利总结结算承载（battle.md OQ14 口径为准，呈现接线登记 06）；关卡画面另设常驻总量。本屏维持现行大奖励文案无 GP 3. **清库反馈**（预留，随魔法道具 P0）：关卡收束清库义务载体 = 魔法道具背包；现行切片无库存容器，义务挂账、本批不设计呈现（battle.md Exit 表同源） -**禁入清单**（两铁律推导）：战斗小循环数据（结算明细、状态效果——留在战斗屏）；营地柜台全量（解锁清单/定价——不陈列）；冒险摘要五件事（末关时由相邻域冒险结算屏承载，本屏不重复）。 +**禁入清单**（两铁律推导）：战斗小循环数据（结算明细、状态效果——留在战斗屏）；GP（呈现位已拍板 = 战斗胜利总结结算 + 关卡画面常驻，见 06）；营地柜台全量（解锁清单/定价——不陈列）；冒险摘要五件事（末关时由相邻域冒险结算屏承载，本屏不重复）。 ## States & Variants @@ -83,7 +83,7 @@ |---|---|---|---| | 大奖励兑付快照（hp_bonus / new_max_hp / keystone_gained / keystone_total） | 冒险结构 big_reward_paid 载荷 | Read | 载荷自包含、despawn 前捕获（战斗结算 快照纪律同族） | | 冒险摘要（五件事） | 冒险结构 adventure_finished 载荷 | Read | 末关分支数据锚（相邻域冒险结算屏消费） | -| GP 账本 | 冒险结构 GP 冒险账本 | Read | 账本跨关延续、冒险收束清零；本屏呈现与否待 OQ1 拍板后接线 | +| GP 账本 | 冒险结构 GP 冒险账本 | — | 不进本屏（2026-09-27 拍板：GP 呈现归战斗胜利总结结算〔增量+总量〕与关卡画面〔常驻总量〕，接线登记 06）；账本本身跨关延续、冒险收束清零 | | 钥石入账 | 元进度 settle_adventure | Write（相邻域） | 唯一写档点不变（冒险收束时结算，main.gd `_on_adventure_finished`）——本屏只呈现进账读数，不写账 | | 清库反馈 | 魔法道具（P0 后） | Read | 预留——载体 = 魔法道具背包，随 P0 落地补设计 | @@ -102,9 +102,9 @@ ## Open Questions -1. **GP 增量展示面归属（拍板前置）**：battle.md OQ14 = 「战斗结算画面总量+增量」；06 待办归属行 = 「结算画面批（GP 增量+钥石）」——两处不一致。拍板前本屏不新增 GP 呈现义务（现行大奖励文案无 GP，维持） +1. **GP 增量展示面归属——已收口（2026-09-27 用户拍板）**：战斗胜利出现战斗总结结算、展示获得的资源（目前只有 GP）；战斗失败出现冒险总结结算、确认后回存档首页——GP 总量+增量归战斗胜利总结结算（battle.md OQ14 口径为准）；06 归属行「结算画面批 GP 增量」系登记偏差已同批修正。本屏不承载 GP，无遗留 2. **末关分支形态**：末关通关时本屏收缩为过场确认 vs 直通冒险结算（现行 = 直通）——随完整屏形态实装批一并定 -3. **「结算画面」口径对齐**：2026-09-26 拍板「钥石 = 结算画面 + 营地」中「结算画面」的指认——大奖励屏已现行承载钥石增量+累计（big_reward_text），冒险结算屏承载入账明细（keystone_settle_text）；两处与拍板措辞的对应关系随 OQ1 一并拍板，正文随之定稿 +3. **「结算画面」口径——已收口（2026-09-27，随 GP 拍板一并落定）**：「钥石 = 结算画面 + 营地」中「结算画面」= 冒险总结结算（冒险摘要 + 钥石入账明细）；大奖励屏的钥石增量+累计 = Boss 层进账呈现——两处并存系「进账时刻 vs 收束明细」不同义，不构成重复展示，维持现状 4. **视觉终稿**：以表现层样张过审为前置（06 待办登记）；本 spec 的 AC 为功能性判据，不含视觉终稿判据 5. **清库反馈呈现**：载体 = 魔法道具背包，随魔法道具 P0 落地设计（义务挂账，本批不设计） @@ -115,3 +115,4 @@ | 日期 | 改动 | |---|---| | 2026-09-27 | 初稿（UX 文档欠账处置批，用户拍板建档）：义务锁定版——大奖励三件套/钥石入账/清库反馈预留成文；现行载体（_inter_overlay 与 BattleEndOverlay 复用）与代码锚如实登记；GP 归属两处登记不一致挂 OQ1，拍板前不新增 GP 呈现义务 | +| 2026-09-27 | GP 归属拍板对齐批（用户口径：战斗胜利→战斗总结结算展示获得资源〔目前 GP〕；战斗失败→冒险总结结算→确认回存档首页）：OQ1 收口——GP 总量+增量归战斗胜利总结结算（battle.md OQ14 为准），本屏不承载 GP；OQ3 收口——「结算画面」指认 = 冒险总结结算，大奖励屏钥石进账 + 冒险总结结算明细两处并存维持；信息归属 GP 移入禁入清单；Data Requirements GP 行改零访问；06 归属行同步修正 |