From 9556539a1fc10ade150684542a38a04aa1e3ab45 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Wed, 7 Oct 2026 06:03:11 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20P1-P3=20=E5=85=A8=E8=A3=81=E5=BD=92?= =?UTF-8?q?=E6=A1=A3+=E5=85=89=E6=9F=B1=E5=8C=BA=E8=A1=A8=E8=BF=B0?= =?UTF-8?q?=E8=A7=A3=E8=80=A6+06=20=E6=96=B0=E7=99=BB=E3=80=8C=E6=88=98?= =?UTF-8?q?=E6=96=97=E5=8C=BA=E8=83=8C=E6=99=AF=E5=9B=BE=E6=9B=BF=E6=8D=A2?= =?UTF-8?q?=E3=80=8D=EF=BC=88P1=20=E7=94=B2=3D=E6=BA=A2=E5=87=BA=E7=9B=92?= =?UTF-8?q?=E9=A1=B6=20N=20px=20=E4=B8=8D=E8=A3=81=E5=88=87=EF=BC=8C?= =?UTF-8?q?=E5=88=A4=E5=AE=9A=E4=B8=8E=E5=85=89=E6=9F=B1=E8=84=B1=E9=92=A9?= =?UTF-8?q?=E2=80=94=E2=80=94=E5=85=89=E6=9F=B1=E7=B3=BB=E4=B8=B4=E6=97=B6?= =?UTF-8?q?=E6=B0=9B=E5=9B=B4=E5=B1=82=EF=BC=8C=E8=83=8C=E6=99=AF=E6=8F=92?= =?UTF-8?q?=E7=94=BB=E5=88=B0=E4=BD=8D=E5=90=8E=E9=80=80=E5=BD=B9=EF=BC=9B?= =?UTF-8?q?P2=20=E7=94=B2=3D=E6=98=8E=E7=BB=86=E5=B8=A6=E6=94=B9=E8=A6=86?= =?UTF-8?q?=E7=9B=96=E5=B1=82=EF=BC=9BP3=20=E7=94=B2=3D=E6=A3=8B=E7=9B=98?= =?UTF-8?q?=E5=B0=8F=E4=BA=BA=E4=B8=8D=E9=9A=8F=E6=89=B9=EF=BC=9Bart-bible?= =?UTF-8?q?=20=C2=A78.2/battle.md=20=E6=8E=AA=E8=BE=9E=E9=9A=8F=E6=94=B9?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/art/art-bible.md | 2 +- design/gdd/06-待办清单.md | 8 ++++++ design/gdd/ux/battle.md | 2 +- ...务书-立绘定档与站桩重排实装批-2026-10-07.md | 28 +++++++++++-------- 4 files changed, 27 insertions(+), 13 deletions(-) diff --git a/design/art/art-bible.md b/design/art/art-bible.md index b79c11ac..acc3a53a 100644 --- a/design/art/art-bible.md +++ b/design/art/art-bible.md @@ -460,7 +460,7 @@ - **主角战斗状态图(含 B 区站桩侧向)= 48×72**(同上暂定;v1.9 待决注记「主角立绘档空缺」由此收口); - **棋盘小人 = 32×32 二头身派生版(暂定,允许更小)**——独立资产,自人设定稿压缩派生(人物设计档 §5.4),不吞数字位、占位 ≤ 0.75× 格边长;36px 板 × 32px 源的占比摩擦(v1.9 待决注记①)沿「独立小源档」路线随格边长终值在样张批定终值; - **站桩立绘源档 = 八敌逐键定档(2026-10-06 定档批,用户确认定档总图;原三档 48/64/96 候选与 v3.0 档位上调方向候选一并收口)**:主角 48 不变;八敌源档高 = goblin 36 / giant_spider 38 / duergar 46 / hook_horror 58 / bugbear 62 / ogre_chief 74 / drider 90 / duergar_king 94,显示一律 **×2 整数档(NEAREST)** = 72–188。定档依据 = 生物体型三约束(用户拍板:钩爪恐魔>灰矮人、灰矮人<熊地精、食人魔>熊地精——体量=物种体型,非强度线性映射,人物设计档 §5.2 随批修订);可读性实测门槛 = 源高 ≥32(24 糊/32 可读/48 清楚/64 细节完整),全阶梯 36–94 达标;派生管线 = pixel-1.png 紧裁 → 等比缩至档高 → dom_block_resize 块内众数降采样(tools/pixelize_candidates.py `STANDEE_TIER_H`,`SIZES` 降格为管线上游中间分辨率表);存在感问题(v3.0 病根 6)经方案二整屏对比(B 区 270/立绘显示上限 188)解决。 - - **站桩立绘排版 = 方案二(2026-10-06 用户拍板)**:① 区高 B 区 270(≈1/3)/C 区 530(≈2/3),**扫雷盘 438×438 原尺寸不缩、格子不变**(区高事实源 battle.md 区表;压缩由 C 区面板空档吸收);② 站桩内部重排——立绘双脚落石台上缘(弃盒内居中)、**血条+状态/名字行落底排**(立绘→血条→状态 顺序,全场血条对齐一线;血条嵌石板位、台缘线留作地面线、落影保留接地感),状态空时该行退化为名字行;③ 大体档(显示 >150px 级:drider/duergar_king)头部探出盒顶压进光柱区,血条仍落底;意图徽标悬浮头顶上方(探顶档压胸);④ 原「血条悬浮头顶+立绘盒内居中」排式退役——盒顶固定 y 与盒内居中在高盒下拉开血条-立绘空洞(2026-10-06 用户点名否决)。 + - **站桩立绘排版 = 方案二(2026-10-06 用户拍板)**:① 区高 B 区 270(≈1/3)/C 区 530(≈2/3),**扫雷盘 438×438 原尺寸不缩、格子不变**(区高事实源 battle.md 区表;压缩由 C 区面板空档吸收);② 站桩内部重排——立绘双脚落石台上缘(弃盒内居中)、**血条+状态/名字行落底排**(立绘→血条→状态 顺序,全场血条对齐一线;血条嵌石板位、台缘线留作地面线、落影保留接地感),状态空时该行退化为名字行;③ 大体档(显示 >150px 级:drider/duergar_king)**允许向上溢出盒顶 N px**(2026-10-07 用户裁甲案;N 由实装批 C0 按实测尺寸算定,**与背景/光柱无关**——现行溢出区恰为临时光柱氛围层〔§6.1 方向稿四柱,x 基准 110/900/1055/1210@1280,`battle_stage_view.gd:55-63`〕,正式舞台背景插画 `stage/stage_bg.png` 到位后该层退役/吸收进背景绘制,**溢出判定不随之变更**;横向不得压到顶部中央轮次·阶段指示,溢出上限由 C0 用真图复算 x 区间定),血条仍落底(落底排的第二个收益=头部探顶不带出血条);意图徽标悬浮头顶上方(探顶档压胸);④ 原「血条悬浮头顶+立绘盒内居中」排式退役——盒顶固定 y 与盒内居中在高盒下拉开血条-立绘空洞(2026-10-06 用户点名否决)。 ### 8.3 导出格式与命名规范 diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index a06a4141..b4e203ee 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -386,6 +386,14 @@ **状态**：挂账（随整屏样张闸前整备批启动；分章推进，每章一个章节，格式已定） +#### 战斗区背景图替换——B 区舞台插画 + 临时光柱退役（2026-10-07 用户点名登记） + +**现状**：B 区舞台现行 = 程序化平色底（`UiKit.STAGE_BG`，`battle_stage_view.gd:47`）+ **顶光柱氛围层**（`:55-63` 四柱，x 基准 110/900/1055/1210@1280，60 段叠层矩形自顶向下渐宽窄渐隐〔顶 α26→0〕，层序 = bg < 光柱 < 世界）——二者均系 §6.1 方向稿的**临时占位**，用户口径「光柱只是临时方案，换正式战斗背景后效果更好」。正式件已立资产契约：`stage/stage_bg.png`（源 1280×270，B 区全高含明细带底；三关换挡走 §4.3 `wall_ambient` tint 槽，不按板出三张），属审计 P1-2 查得的「B 区舞台背景插画 0 张」缺口。**光柱在背景到位后随批退役或吸收进背景绘制**（不再作为独立程序层）。**与立绘探顶解耦**：大体档「允许向上溢出盒顶 N px」的判定（2026-10-07 用户裁甲案）**不依赖光柱是否存在**，换背景零返工。 + +**归属**：[art-bible](../art/art-bible.md) §6.1（资产契约）+ §8.3 归档纪律 · 资产管线批；出图工单归 [art-assets-checklist](../art/art-assets-checklist.md) / 实装批任务书 + +**状态**：待办（**开工 = 用户点名**；**前置建议** = 立绘定档与站桩重排实装批的 **C0 盒高账定案后再出图**，避免 B 区高度/构图二次返工；交付后 art-status-checklist 随批 ✅） + ### 教学引导 > **节头注记（2026-10-04 用户拍板）**：教学引导定稿批整体改排 **Beta 阶段**——当前 Alpha 版不做教学相关工作，本节五条全部随之改排（2026-09-19 的 Alpha 排期拍板被本拍板取代）。同日五问讨论已形成初裁与设计提案，提案已归档 `../../archive/提案-教学引导定稿-2026-10-04.md`（Beta 批立项底稿，引用以其「归档状态与初裁记录」节为准）。初裁摘要：①教学形态=丙1 混合（首次冒险编排式首遇提示〔挂 first_script 锚、不锁操作〕+其余全程情景触发）；②「因果教学顺序」问题**注销**——只教扫雷操作，结算读法不设教学（用户裁：结算只是表达、展现、演出，无策略内容；展示层每行带来源标注已自带归因；教学引导.md 旧前提〔设计目的句/P0 候选归因提示/验收第 2 条〕随 Beta 批文档定稿清除）；③图例面板按循环段落分组、无结算段；④不做「再教一次」——改走独立「帮助」手册面（全部内容放一个文档）；⑤教学文案内容权归设置与本地化（两文档负责表对齐随 Beta 批）。**未裁三疑点**（Beta 立项时先裁）：增益叠层节奏条目去留／帮助入口位置（设置面为推荐）／图例面板与帮助手册的内容分工。 diff --git a/design/gdd/ux/battle.md b/design/gdd/ux/battle.md index 40b146db..d57f2d78 100644 --- a/design/gdd/ux/battle.md +++ b/design/gdd/ux/battle.md @@ -141,7 +141,7 @@ | 区 | 组件 | 类型 | 内容 | 交互 | 现有 demo 组件 | |---|---|---|---|---|---| | B | 主角站桩立绘 | 站桩（无框立绘+落影） | HP 条落底盘（2026-10-06 方案二拍板：站桩排式 = **立绘→血条→状态**，全场血条对齐一线；血条嵌石板位、台缘线留作地面线；原「悬浮头顶」退役——高盒下血条-立绘空洞，用户点名否决）、状态效果小图标一排挂血条正下方（形状+色相双通道、层数角标；空态不占位退化为空行）——**HP 与状态效果的唯一展示面（2026-09-26 信息归属拍板，原 C 区状态槽职责〔悬停 tooltip 来源+语义+剩余结算次数〕并入本组件）**；攻击值等规划数据仍归 C 区数据框（2026-09-20 全站桩拍板，英雄卡退役） | 悬停状态小图标看 tooltip | HUDView 拆分改造 | -| B | 敌人站桩立绘 ×1–3 | 站桩（无框立绘+落影） | 血条+顺位徽标落底盘（同主角排式，2026-10-06 方案二；**大体档〔显示 >150px 级：drider/duergar_king〕头部探出盒顶压进光柱区，血条仍落底**）、状态小图标挂血条正下方（敌方 side-wide 增益各立绘同值呈现——蓄力/硬化/削弱/暴走/警觉；伏击层数通道随 2026-09-20 八型批退役——数据源 = 战斗结算流水经增益状态投影，敌人系统×4④；2026-09-16 敌人技能池批改型：行为环点拆除〔proposal §2.4〕，意图占位 = 本拍摇定结果的动画占位——普通攻击零表示 / 特殊技类型级提示，**意图徽标悬浮头顶上方，探顶档压胸**，敌方增益〔蓄力/硬化〕入状态图标行）；死亡灰化加碎裂退场直接演在立绘上（2026-09-20 全站桩拍板，敌人卡退役）；血条下名字行 = 纯名字 + 护甲类型图标（形状+色相双通道，与状态图标同行共存，状态空时为纯名字；原「底座下」随石板退位改落底排），AC 数值不展示——2026-09-26 终裁（用户口径：HP 信息已足够，攻防数值不直接写上；护甲类型图标保留克制对策可读性——类型可读、数值隐藏） | 只读 | 新建 | +| B | 敌人站桩立绘 ×1–3 | 站桩（无框立绘+落影） | 血条+顺位徽标落底盘（同主角排式，2026-10-06 方案二；**大体档〔显示 >150px 级：drider/duergar_king〕允许向上溢出盒顶 N px（N 由实装批 C0 实算，与背景/光柱无关——现行溢出区为临时光柱氛围层，正式舞台背景插画到位后该层退役，判定不变），血条仍落底**）、状态小图标挂血条正下方（敌方 side-wide 增益各立绘同值呈现——蓄力/硬化/削弱/暴走/警觉；伏击层数通道随 2026-09-20 八型批退役——数据源 = 战斗结算流水经增益状态投影，敌人系统×4④；2026-09-16 敌人技能池批改型：行为环点拆除〔proposal §2.4〕，意图占位 = 本拍摇定结果的动画占位——普通攻击零表示 / 特殊技类型级提示，**意图徽标悬浮头顶上方，探顶档压胸**，敌方增益〔蓄力/硬化〕入状态图标行）；死亡灰化加碎裂退场直接演在立绘上（2026-09-20 全站桩拍板，敌人卡退役）；血条下名字行 = 纯名字 + 护甲类型图标（形状+色相双通道，与状态图标同行共存，状态空时为纯名字；原「底座下」随石板退位改落底排），AC 数值不展示——2026-09-26 终裁（用户口径：HP 信息已足够，攻防数值不直接写上；护甲类型图标保留克制对策可读性——类型可读、数值隐藏） | 只读 | 新建 | | B | 轮次·阶段指示 | 标签 | "第 N 轮 · 挖掘中/结算中"（终局定格「战斗结束」；Boss 变体附 Boss 名） | 只读 | 新建 | | B | 结算明细带 | 滚动列表 | 结算期逐行流水（[战斗结算](../systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋) 9 类行协议）；挖掘期收起为上轮摘要 1 行 | 点击展开明细回看 overlay（2026-10-04 P-C7 退役——带保留单行摘要，回看归「生涯」） | battle_log_view.gd 改造 | | B | 结算明细回看 | 模态 overlay | 完整流水逐行（现行 9 类行协议；未生效类行聚合计数） | 关闭 | battle_log_view.gd 改造 | diff --git a/design/research/任务书-立绘定档与站桩重排实装批-2026-10-07.md b/design/research/任务书-立绘定档与站桩重排实装批-2026-10-07.md index 6402042d..fdf33b5d 100644 --- a/design/research/任务书-立绘定档与站桩重排实装批-2026-10-07.md +++ b/design/research/任务书-立绘定档与站桩重排实装批-2026-10-07.md @@ -52,7 +52,7 @@ 1. **盒高账（硬约束）**：新档最大显示高 = 94×2 = **188px**，而立绘盒净高只有 96px。B 区抬到 270 后，可用 = 270 − 顶部轮次指示行 − 底部结算明细带（24 摘要 / 84 结算期）− 血条状态名行（约 30）。**188 + 30 是否塞得下、84 结算期态要不要改覆盖层**——这笔账没算清之前不动代码。 2. **84px 明细带账**：`BattleLogView` 的 24/84 两态与 176 的盒如何共存（现 252 − 176 = 76，装不下 84）——需实查是压缩盒还是覆盖层。 -3. **探顶 clip 账**：大体档「头部探出盒顶压进光柱区」是真裁切还是允许溢出绘制（SubViewport 世界层能否溢出到光柱层）——决定 `standee_body.gd` 是加 `ClipChildren` 还是改盒。 +3. **探顶账（P1 已裁甲，只剩量值待算）**：已考证 `_svp_container` 为 FULL_RECT + 1:1 + **无 clip** → 溢出即可渲染，**无需 clip 逻辑**。C0 只需算清 **N = 溢出上限**：受顶部中央轮次·阶段指示的横向遮挡约束（大体档在右侧敌位，须用真图复算 x 区间），暂按 ≤32px 量级，并复算最高档 94×2=188 与盒净高的差值。 --- @@ -107,7 +107,7 @@ | C1 | `ui_assembler` B 252→270、C/D 548→530 | C0 | | C2 | `standee_body` 立绘盒抬高 + 居中改底锚落台 | C0 | | C3 | 血条 + 状态/名字行落底排、全场血条对齐一线 | C2 | -| C4 | 大体档探顶（clip 或溢出绘制）+ 意图徽标改位（探顶档压胸） | C2 | +| C4 | 大体档**允许向上溢出盒顶 N px**（不裁切；N 由 C0 实算，与光柱无关）+ 意图徽标改位（探顶档压胸） | C2 | | C5 | 探针断言族：`ui_struct_probe` 252→270、⑥standee 扩展（血条一线 / 名行不压盒 / 探顶不出血条 / 意图峰值不溢出） | C1-C4 | ### 批 D · 样张人闸（唯一必经人审） @@ -127,22 +127,27 @@ --- -## 7. 待用户裁决点（P1–P3；全列备选案 + 淘汰依据） +## 7. 裁决归档（P1–P3 已全裁 · 2026-10-07 用户拍板） -**P1 · 大体档探顶怎么落** -- 甲（推荐）：**盒按最高档抬**，超出部分允许溢出绘制到光柱区（不裁切）——视觉最自然，符合「头部探出盒顶压进光柱区」原文。 -- 乙：真 `clip` 裁掉头部——省事但会切掉石君王的王冠，破坏识别。**淘汰：剪影完整性是 §5.1 硬规则。** +**P1 · 大体档探顶怎么落 ✅ 裁甲** +- **甲（采纳）**：盒按最高档抬，**允许向上溢出盒顶 N px**，不裁切。 + - **口径修正（同批定）**：溢出判定**不得绑定光柱**——表述改为「允许向上溢出盒顶 N px，N 由 C0 实算，与背景/光柱无关」。现行溢出区恰为临时光柱氛围层（`battle_stage_view.gd:55-63`），正式舞台背景插画到位后该层退役/吸收，**判定不变、换背景零返工**。 + - **技术面（已考证）**：`_svp_container` 为 FULL_RECT + `stretch=true` 1:1 + **无 clip**，世界坐标系铺满舞台高度 → 甲案实现即「不裁切」，无需任何 clip 逻辑；光柱为世界层之下的兄弟 Control，立绘自然盖住它。 + - **约束**：横向不得压到顶部中央轮次·阶段指示；溢出上限由 C0 用真图复算 x 区间定（暂按 ≤32px 量级）。 +- 乙：真 `clip` 裁掉头部——**淘汰：会切掉石君王王冠，违反 §5.1 剪影完整**。 - 丙：大体档降倍率（×1.5）——**淘汰：非整数倍违反契约 1。** -**P2 · 结算期 84px 明细带与 188px 立绘共存** -- 甲（推荐）：明细带结算期态改**覆盖层**，不挤压站桩盒。 +**P2 · 结算期 84px 明细带与 188px 立绘共存 ✅ 裁甲** +- **甲（采纳）**：明细带结算期态改**覆盖层**，不挤压站桩盒。 - 乙：结算期态压缩立绘盒——**淘汰：会造成站桩跳动（减动效纪律）**。 - 丙：84 → 改小——需用户另裁数值，越权本批。 -**P3 · 棋盘小人是否顺带重出** -- 甲（推荐）：**不随本批**，保持 32×32，重出另行立项（依赖 = 本批派生管线先验证）。 +**P3 · 棋盘小人是否顺带重出 ✅ 裁甲** +- **甲（采纳）**：**不随本批**，保持 32×32，重出另行立项（依赖 = 本批派生管线先验证）。 - 乙：顺带重出——本批体积超软时间盒，且混料不利于归因。 +> **P1–P3 已全裁 ⇒ U0 开工令已具备**（用户 2026-10-07 逐项确认）。A 段可发令。 + --- ## 8. 批次工作流十三条对照（合规自证） @@ -176,4 +181,5 @@ L1 自救（一次重试）→ L2 记录继续（连续 3 次同红灯升级） 1. **盒高账可能推翻方案二的 270**：若 188 + 血条 + 明细带算下来 > 270，需回到用户重裁（要么再抬 B 区、要么把最高档从 94 降到 ~84）。这是本批最大的单点风险，故排在 C0。 2. **worktree 素材丢失风险**：A3 拷贝回主区是硬步骤（素材不入 git），漏做即丢。 3. **并行会话冲突**：主区有在飞会话（iter17-enemy / uialign），合并采取「分支内先并入 master、再 ff 主区」，不直动主区脏件。 -4. **遗留**：站桩帧动画、3349 草稿整理、口号条款机检化、三个「0 张」缺口（19 徽章 / 6 纹带 / 舞台背景）各自有闸，不并入本批。 +4. **遗留**：站桩帧动画、3349 草稿整理、口号条款机检化、另两个「0 张」缺口（19 徽章 / 6 纹带）各自有闸，不并入本批。 +5. **关联新登记（2026-10-07 用户点名）**：**战斗区背景图替换**（B 区舞台插画 `stage/stage_bg.png` + 临时光柱退役）已作为独立待办登记进 `06-待办清单`。**建议开工顺序 = 本批 C0 盒高账定案后再出背景图**，避免 B 区高度/构图二次返工；本批 P1 甲案的溢出判定已与光柱解耦，二者互不阻塞。