写卡(站桩名字行提档与地台色合并批): 需求卡片v1.1定稿零待裁点——名字行五取值点FS_CAPTION→FS_HINT+基线0.35h重算(牌顶+18)+probe增name_font_size键/STAND_STONE_RIM·EDGE两常量退役改指(受光线与口沿高光→BRICK,描边→新PLAZA_EDGE承载#4C4038)/golden板面三张申报重锚(§3申报制);断言面V10-V12三锚三件(probe实读+源码锚+FS_CAPTION计数锚==1+常量表经load().get_script_constant_map——类引用直调parse error grilling实测)/V6基线149→150申报+run_all.gd注释换代;grilling复核三阻断两建议全落(V11写法parse error/三测量点缺判据/三绘制点改指缺正证/对照表对应句/结构图漏行);能力清单补行落表(迭代43移交小件①了结——站桩呈现定值与素材绑定行+覆盖域表战斗表现行,README工作树同批含并行会话换图系卡能力行五行顺带落地);待办清单两点条目+已写卡·移交小件①落位;估时0.5工作日
This commit is contained in:
DKChan committed
1 parent
789b15f34f
commit
d478cf70ea
4 files changed
+221
-10
No files matched your search
@@ -0,0 +1,21 @@
|
||||
# grilling 复核——站桩名字行提档与地台色合并批需求卡片（2026-10-31）
|
||||
|
||||
> 接收方：reports/需求卡片-站桩名字行提档与地台色合并批-2026-10-31.md（v1.0→v1.1）。复核方＝独立子代理对抗审查（未参与写卡；Godot 4.7.2 console 版实测断言写法）。本件属中间文档，随批退役。
|
||||
|
||||
## Findings 与处置（五条全落 v1.1）
|
||||
|
||||
| # | 级别 | 发现 | 处置（落卡位置） |
|
||||
|---|---|---|---|
|
||||
| 1 | 阻断 | V11 断言 `UiKit.get_script().get_script_constant_map()` 实测 parse error（类引用直调非静态函数不合法）；机制本身可靠（实测枚举 186 键含目标常量） | T2 断言载体改 `load("res://presentation/views/ui_kit.gd").get_script_constant_map()`，依据随句注明（§7.3） |
|
||||
| 2 | 阻断 | 五取值点中三处宽度测量点零断言——漏改测量点时牌宽按 12px 计、文字溢素底牌，全断言仍绿 | V10 增第三断言＝计数锚 `body_src.count("UiKit.FS_CAPTION") == 1`（改后仅剩 :114 消散提示一处），三测量点强制换代（§7.2／§8 行 1） |
|
||||
| 3 | 阻断 | 绘制点改指只有 grep 反证（旧名消失）无正证（落成错值也绿，golden 重锚还会冻结错值） | V11/V12 补三处绘制点源码锚正证：顶缘线 `ped.size.x, 2.0), UiKit.BRICK, true`、口沿 `FACADE_HIGHLIGHT_PX), UiKit.BRICK, true`、描边 `UiKit.PLAZA_EDGE`（§7.3／§8 行 3/4）；grep 降为反证补充 |
|
||||
| 4 | 建议 | §8 首句「6 行对应完成定义第 1–6 条」对应关系不成立（第 5 条无行） | 首句改「第 1–4、6 条；第 5 条经 T3 核对步承载」（§8 首句） |
|
||||
| 5 | 建议 | `run_all.gd:191` 套件注释「V5–V9」增 V10–V12 后成死注，但该文件不在结构图 | §6 文件结构图补 run_all.gd 行（注释换代，非行为改动）＋T2 增注释换代步（§7.3） |
|
||||
|
||||
## 无发现审点
|
||||
|
||||
步骤扫描（每步一动作一可核查结果）／名字一致性（PLAZA_EDGE、name_font_size、V10–V12 逐字一致且与盘面无冲突；V10 锚串与顺位徽标行无碰撞）／落位与复用（`Color8(76` 全仓零命中、`#4C4038` 仅探针注释非 token——新常量论证成立）／预算与契约（probe 增字典键非成员，gdstyle 三触面零基线键，S13 零新增预期成立；golden 重锚工具缺省只动板面三张，与禁触清单兼容）／估时（0.5 天与触面相称）。
|
||||
|
||||
## 结论
|
||||
|
||||
三阻断两建议全部落卡后 **PASS**——卡片 v1.1 成立，可交迭代编排段。
|
||||
@@ -0,0 +1,188 @@
|
||||
# 需求卡片——站桩名字行提档与地台色合并批（名字行字号 12→14 ＋ 受光线/描边两常量退役改指）
|
||||
|
||||
状态行：v1.1 定稿——零待裁点（grilling 复核过：reports/复核-grilling-站桩名字行提档与地台色合并批-2026-10-31.md，三阻断两建议全落；两点裁决已于 2026-10-31 闭合落文 art-bible v3.29，见 §11）
|
||||
|
||||
接收方：待办清单条目「迭代 43 批后待裁两点——名字行字号档位／换色常量退役」（状态=文档设计已闭合，本卡写完推进「已写卡」）
|
||||
|
||||
来源：**设计事实源**＝`design/art/art-bible.md` v3.29——§7.4 小字号豁免条款「站桩名字行同理提档」句（名字行提档 `FS_HINT` 14 归六档、不增列②装饰 caption 在册面、几何随档联动）＋§4.1 换色合并登记三处①②（`#C4AC84`→并入掩尘 `#C9AF83`；`#5A4C3A`→并入 `#4C4038`）。验收底线（2026-10-31 用户裁）＝名字行清晰可读、长名不截字。
|
||||
|
||||
## 1. 目标与完成定义
|
||||
|
||||
这批做什么：把 art-bible v3.29 两处新裁决落进代码——①站桩名字行（敌人名＋护甲字形＋全部宽度测量与基线）从 `FS_CAPTION`（12px）提到 `FS_HINT`（14px），名字行几何随档联动；②`STAND_STONE_RIM`／`STAND_STONE_EDGE` 两枚旧色常量删除，两个绘制点改指合并目标色（站桩石板顶缘受光线与棋盘墙格口沿高光共用枚→掩尘 `BRICK`；石板描边→新常量承载 `#4C4038`），使贴图缺位时的程序化回退绘制与已落合并值的贴图一致。顺带了结迭代 43 移交小件①（能力清单补行——写卡段随本卡同批入表）。
|
||||
|
||||
完成定义（全部满足才算完）：
|
||||
1. 名字行五处取值点全取 `UiKit.FS_HINT`，基线偏移按 14px 档重算（0.35h 规则→牌顶+18），素底牌几何单点 `_name_plate_rect`/`_name_baseline` 仍是唯一算式落点。
|
||||
2. `STAND_STONE_RIM`／`STAND_STONE_EDGE` 在 `ui_kit.gd` 删除且全仓零引用；`UiKit` 脚本常量表断言两枚不在册。
|
||||
3. 两枚绘制点改指：`cell_base_layer.gd` 口沿高光与 `standee_body.gd` 顶缘受光线→`UiKit.BRICK`；`standee_body.gd` 回退描边→新常量 `UiKit.PLAZA_EDGE`（=Color8(76,64,56)）。
|
||||
4. 渲染 golden 三张板面基线与口沿高光换值一致（改后跑 render_gate，红则重锚三张、重锚后 0.00% 留痕；level_map／menu_boot 不触不重锚）。
|
||||
5. 能力清单补行落表（`game/tests/README.md` 能力行＋覆盖域表战斗表现.md 行，本卡成文同批完成）。
|
||||
6. 代码域闸全绿；产出物三份落 `reports/`，独立验收审计未过不合并。
|
||||
|
||||
## 2. 现状事实
|
||||
|
||||
全部行号为 **2026-10-31 实查**——编入后 T0 按 T0 时点 master 重测重锚。
|
||||
|
||||
1. 名字行字号取值点五处，全在 `game/presentation/views/standee_body.gd`：`:334-335` 护甲字形宽测量（贴图缺位时）、`:336` 名字宽测量（`_name_plate_rect` 内）、`:467` 护甲字形宽测量（绘制侧）、`:474` 护甲字形绘制、`:476` 名字绘制——全取 `UiKit.FS_CAPTION`。
|
||||
2. 同文件另有 `FS_CAPTION` 合法在役一处：`:114` 站桩消散提示（§7.4 ②在册面「站桩消散提示」）——本批不动，禁误改。
|
||||
3. 名字行几何单点：`_name_plate_rect`（`:331-338`，牌高 26 固定＝护甲图标 24px＋上下各 1px；牌宽＝行宽＋8 水平居中；牌底沿＝地台顶）＋`_name_baseline`（`:342-343`，返回 `plate.position + Vector2(4.0, 17.0)`；注释 `:341` 「12px 字形基线=中心+4」）。基线偏移遵循本文件既有 0.35h 规则（立绘字形 `:434` 用 `ts.y * 0.35`；12×0.35≈4.2→4，与 `+4` 吻合）→14×0.35≈4.9→**5**，新基线＝牌顶+13+5＝**牌顶+18**。
|
||||
4. 名字行探针 `name_line_probe()`（`standee_body.gd:63`）返回 Dictionary：`baseline_y`／`plinth_top_y`／`plate`／`plate_color`／`armor_icon`／`armor_tex_bound`——消费面＝`ui_struct_probe` 与 `standee_present_values_test`。
|
||||
5. 地台程序化回退（`standee_body.gd:380-383`）：`TEX_STAGE_PLAZA` 缺位时三段绘制——板身 `UiKit.STAND_STONE`、描边 `UiKit.STAND_STONE_EDGE`（`:382`）、顶缘受光线 2px `UiKit.STAND_STONE_RIM`（`:383`）。贴图在位时不走此路径（九宫格拉伸域 `:388-393`，贴图已落合并值 `#C9AF83`／`#4C4038`）。
|
||||
6. 口沿高光：`game/presentation/views/cell_base_layer.gd:176` `canvas.draw_rect(..., UiKit.STAND_STONE_RIM, true)`（墙格南立面受光亮线，线厚常量 `FACADE_HIGHLIGHT_PX := 2.0` 于 `:9`；与地台顶缘线共用同枚常量，行内注释「同值单点」）。设计出处＝art-bible §8.2 高墙瓦片体系条（南临空墙格＝立面口沿高光 2px `Color8(196,172,132)`）。
|
||||
7. `ui_kit.gd`：`:188` `STAND_STONE_EDGE := Color8(90, 76, 58)`、`:189` `STAND_STONE_RIM := Color8(196, 172, 132)`；合并目标①＝`BRICK := Color8(201, 175, 131)`（`:165` 掩尘，在役）；合并目标②＝`#4C4038`＝Color8(76,64,56)——**全仓无既有 token**（2026-10-31 grep `Color8(76` 零命中），需新常量承载。
|
||||
8. 全仓 `STAND_STONE_RIM`/`STAND_STONE_EDGE` 引用面＝定义 1 处＋消费 2 文件 3 行（`:382`/`:383`/`cell_base_layer:176`）——tests/probe/sim 零引用（grep 实查），删除无隐性断裂。
|
||||
9. 既有断言面 `game/tests/unit/presentation/standee_present_values_test.gd`：V6 硬编码几何读数 `baseline_y=149.0`／`plinth_top_y=158.0`（±0.51）；V7 源码锚 `contains("HORIZONTAL_ALIGNMENT_LEFT, -1, UiKit.FS_HINT")`（contains 语义——名字行改 `FS_HINT` 后仍绿，零破坏）；V5 先例＝「绘制点取某常量」用源码锚承载。
|
||||
10. golden 触面：`game/tests/golden/` 板面三张（board_L1_dungeon／L2_underdark／L3_deep_underdark）渲染含墙格口沿高光像素——换值后逐像素比对必红；载体＝`tools/render_gate.sh`（闸 05，窗口化）＋重锚工具 `tools/golden_baseline_refresh.sh`。level_map／menu_boot 与站桩名字行均不在 golden 像素域。
|
||||
11. 能力清单：`game/tests/README.md` 无 `standee_present_values_test` 代表用例行（迭代 43 移交小件①在册待补，登记规格＝能力「站桩呈现定值与素材绑定」／真实入口 `UiKit.load_tex()`／`StandeeBody.name_line_probe()`／代表用例 `standee_present_values_test.gd:_init`）。本会话即写卡会话，随本卡同批补行（§5）。
|
||||
12. gdstyle：`standee_body.gd` 无基线登记键（迭代 44 收尾 refresh 已清偿）；本批零新增成员/函数，S13 预期零新增键。
|
||||
|
||||
## 3. 设计契约（违反即返工，标 🔴 触碰＝L3 停机呈报）
|
||||
|
||||
- 🔴 **两个 12px 位不得混**：`FS_HINT` 只进名字行五取值点；`:114` 站桩消散提示的 `FS_CAPTION` 是 §7.4 ②在册面合法位，禁顺手改。
|
||||
- 🔴 **合并目标逐位**：受光线绘制点→`UiKit.BRICK`（`#C9AF83`），描边绘制点→`UiKit.PLAZA_EDGE`（=Color8(76,64,56)）；禁改 `BRICK` 值、禁引入任何近似替代值。
|
||||
- 🔴 **`STAGE_BG` 零触碰**：§4.1 ③已裁随舞台背景插画批处置——本批不改 `STAGE_BG` 值、不改 `battle_stage_view`、不动 `theme_projection_test.gd:669` 与 `ui_contrast_probe.gd:30`。
|
||||
- 🔴 **几何单点**：字号与基线联动只落在 `_name_plate_rect`／`_name_baseline` 两个既有单点内；探针、测试、任何调用方不得复写算式。
|
||||
- 🔴 **常量退役＝真删**：`STAND_STONE_RIM`/`STAND_STONE_EDGE` 删除后禁留别名、转发常量或空注释占位（禁为机检保留无效成员）。
|
||||
- 🔴 **golden 重锚申报制**：三张板面基线重锚仅限口沿高光换值所致，重锚前后读数留实现报告；禁借重锚夹带其他像素变化。
|
||||
- 🔴 **测试削弱申报制**：允许改动的旧断言全集见 §8 申报节，未申报的删改由独立验收审计判红。
|
||||
- 🔴 **禁变异类测试与撤销类取证**：不得靠回退 hunk 或注入破坏证明断言有效。
|
||||
|
||||
## 4. 范围边界
|
||||
|
||||
做：名字行五取值点提档＋基线重算＋探针增 `name_font_size` 键；`ui_kit.gd` 删两常量＋增 `PLAZA_EDGE`；三处绘制点改指；golden 三张板面重锚；既有 V6 读数换代；能力清单补行（写卡段，本卡成文同批）。
|
||||
|
||||
不做（明示去向）：
|
||||
1. **`STAGE_BG` 改值**——随「战斗区背景图替换」批（art-bible §4.1 ③改注在案）。
|
||||
2. **`:114` 消散提示与②在册面其他位**——合法 caption 档，零触碰。
|
||||
3. **口沿高光独立语义 token 化**——拆枚是命名扩张，值同源且 art-bible 已裁「统一为同一枚」，禁另立。
|
||||
4. **battle.md／art-bible 直改**——实现批禁写 `design/`；§4.1 源常量名退役后的指称换代走 §5 反哺点通道。
|
||||
5. **长名截字的主动钳制逻辑**——现行无钳制，本批不新增行为；若目检发现截字＝产品面问题走 L3 停卡呈报。
|
||||
6. **MC／数值验证**——无数值改动零跑。
|
||||
|
||||
## 5. 关联文档同步面
|
||||
|
||||
| 文档 | 关联点（本批实现会改变它的哪条陈述） | 同步义务 |
|
||||
|---|---|---|
|
||||
| design/art/art-bible.md（设计权威——实现批禁直改） | §4.1 换色合并登记①②句中「代码 `STAND_STONE_RIM`／`STAND_STONE_EDGE`」指称随退役失指；②合并目标 `#4C4038` 需补代码名 `PLAZA_EDGE`；§8.2 口沿高光行「`Color8(196,172,132)`」值随换值换代 | 反哺点通道：逐条列进 `reports/iter<N>-反哺点-<日期>.md`（改哪一节、改成什么、依据＝本卡与实测读数），用户裁决后归文档批落文 |
|
||||
| design/art/art-bible.md §7.4 | 无（提档句 v3.29 已落文，实现后即为合规态） | 无（本行占位——按规约查不出也要写明） |
|
||||
| game/tests/README.md（机械面——归写卡段维护） | 能力行补行「站桩呈现定值与素材绑定」（迭代 43 移交小件①）＋覆盖域表战斗表现.md 行补名 | 写卡段于本卡成文同批入表（已完成），实现批零增删零改行；批末核对表上名字与实况一致 |
|
||||
| design/gdd/ux/battle.md | 无——`:155` 名字行陈述（纯名字＋护甲类型图标）不涉字号与色值 | 无（本行占位） |
|
||||
|
||||
## 6. 卡前文件结构图
|
||||
|
||||
| 文件 | 职责 | 新增/复用 | 行为改动? |
|
||||
|---|---|---|---|
|
||||
| game/presentation/views/ui_kit.gd | 删 `STAND_STONE_EDGE`/`STAND_STONE_RIM` 两常量；原位新增 `PLAZA_EDGE := Color8(76, 64, 56)`（注释＝art-bible §4.1 ②合并目标·小石台描边回退用色） | 修改 | 是（色值换——对照表行 3/4） |
|
||||
| game/presentation/views/standee_body.gd | 名字行五取值点 `FS_CAPTION`→`FS_HINT`；`_name_baseline` 偏移 17.0→18.0＋注释换代；回退描边 `:382`→`PLAZA_EDGE`、顶缘线 `:383`→`BRICK`；`name_line_probe` 增 `name_font_size` 键 | 修改 | 是（行 1/2/3/4） |
|
||||
| game/presentation/views/cell_base_layer.gd | 口沿高光 `:176`→`UiKit.BRICK`＋行内注释换代 | 修改 | 是（行 3） |
|
||||
| game/tests/unit/presentation/standee_present_values_test.gd | 增 V10–V12 断言（提档/退役/新 token）；V6 基线读数 149→150（申报） | 修改 | 是（测试面——行 1/2/3/4） |
|
||||
| game/tests/README.md | 能力行补行＋覆盖域表战斗表现.md 行补名 | 修改 | 否（机械面文档，写卡段同批完成） |
|
||||
| game/tests/run_all.gd | 套件登记注释「V5–V9」→「V5–V12」换代 | 修改 | 否（注释换代，非行为改动） |
|
||||
|
||||
不触碰：`battle_stage_view.gd`、`board_view.gd`、`theme_projection_test.gd`、`ui_contrast_probe.gd`、`data/tables/` 全部、`core/` 全部。
|
||||
|
||||
## 7. 任务卡 T0..T3
|
||||
|
||||
### 7.1 T0——读数重锚与改前基线（估时 0.1 个工作日）
|
||||
|
||||
- [ ] 重锚 §2 全部行号（standee_body/cell_base_layer/ui_kit/test 五文件）；复核实查结论第 7 条（`#4C4038` 无既有 token）与第 8 条（引用面仅三行）——不符＝L3 停卡退回写卡段。
|
||||
- [ ] 改前读数（孤立验证）：单件跑 `standee_present_values_test`（绿）＋`python tools/gdstyle_gate.py`（三触面文件零新增键、既有键持平）＋窗口化跑 `tools/render_gate.sh`（板面三张绿＝改前基线确认，读数进实现报告 T0 节）。
|
||||
- [ ] 字体度量校验：`f.get_string_size("名", HORIZONTAL_ALIGNMENT_LEFT, -1, 14)` 实测 Fusion Pixel 14px 高度，核对 0.35h 推导（≈5）；若实测推导出不同偏移，按实测定值并记实现报告「实现决定记录」。
|
||||
- 取用：本卡 §2。产出：重锚行号＋三份改前读数＋基线偏移定值（T1/T2 对拍基准）。
|
||||
|
||||
### 7.2 T1——名字行提档（估时 0.15 个工作日）
|
||||
|
||||
- [ ] `standee_body.gd` 五取值点（`:334-335`/`:336`/`:467`/`:474`/`:476`）`UiKit.FS_CAPTION`→`UiKit.FS_HINT`；`:114` 消散提示零触碰。
|
||||
- [ ] `_name_baseline` 返回 `plate.position + Vector2(4.0, 18.0)`；`:341` 注释改「14px 字形基线=中心+5（0.35h 规则，T0 实测校验）」。
|
||||
- [ ] `name_line_probe()`（`:63`）返回字典增键 `"name_font_size": UiKit.FS_HINT`（值出自几何单点所用字号常量）。
|
||||
- [ ] `standee_present_values_test.gd` 增三断言（尾缀〔名字行 V10〕）：①probe 面——`int(nl.name_font_size) == UiKit.FS_HINT`（几何单点实读）；②源码锚——`body_src.contains("HORIZONTAL_ALIGNMENT_LEFT, -1, UiKit.FS_HINT, UiKit.WARM")` 且 `body_src.contains("HORIZONTAL_ALIGNMENT_LEFT, -1, UiKit.FS_HINT, col")`（名字/护甲两绘制点，沿 V7 先例）；③计数锚——`body_src.count("UiKit.FS_CAPTION") == 1`（改后全文件仅剩 `:114` 消散提示一处——三处宽度测量点随此锚强制换代）。
|
||||
- [ ] V6 基线读数 149.0→150.0、判据句「地台顶上方 9px 档」→「8px 档」（§8 申报第 1 条）。
|
||||
- [ ] 孤立验证：单件跑 `standee_present_values_test`（V5–V10 全绿）＋`python tools/gdstyle_gate.py`（standee_body 键只降不升）。
|
||||
- 取用：T0 重锚行号与偏移定值。产出：`name_font_size` 探针出口（T3 对照表行 1 判据面）＋绿的单件日志。
|
||||
|
||||
### 7.3 T2——地台色合并（估时 0.15 个工作日）
|
||||
|
||||
- [ ] `ui_kit.gd` 删 `:188`/`:189` 两常量；原位新增 `const PLAZA_EDGE := Color8(76, 64, 56)`，注释「小石台描边（art-bible §4.1 换色合并②合并目标——贴图已落此值，缺位回退同值）」。
|
||||
- [ ] `standee_body.gd:382` `STAND_STONE_EDGE`→`PLAZA_EDGE`；`:383` `STAND_STONE_RIM`→`BRICK`；`:365` 附近回退注释「STAND_STONE 族」句随改。
|
||||
- [ ] `cell_base_layer.gd:176` `STAND_STONE_RIM`→`BRICK`，行内注释「同值单点」句改「合并归掩尘枚（art-bible §4.1 ①）」。
|
||||
- [ ] `standee_present_values_test.gd` 增两断言（尾缀〔名字行 V11〕〔名字行 V12〕；常量面载体＝`load("res://presentation/views/ui_kit.gd").get_script_constant_map()`——经 Script 对象取常量表，`UiKit` 类引用直调 `get_script()` 不合法〔grilling 实测 parse error〕）：V11＝常量表无 `STAND_STONE_RIM`/`STAND_STONE_EDGE` 两键、`BRICK` 值＝Color8(201,175,131)、源码锚 `body_src.contains("ped.size.x, 2.0), UiKit.BRICK, true")`（顶缘受光线）与 `cell_src.contains("FACADE_HIGHLIGHT_PX), UiKit.BRICK, true")`（口沿高光——`cell_src`＝同法读 `res://presentation/views/cell_base_layer.gd`）；V12＝`PLAZA_EDGE` 值＝Color8(76,64,56)（§4.1 ②合并目标逐位）＋源码锚 `body_src.contains("UiKit.PLAZA_EDGE")`（回退描边）。
|
||||
- [ ] `standee_present_values_test.gd` 文件头注释「V5–V9 断言面」句与 `game/tests/run_all.gd` 套件注释同步换代「V5–V12」（非行为改动）。
|
||||
- [ ] 批内静态取证：`grep -rn "STAND_STONE_RIM\|STAND_STONE_EDGE" game/ tools/ --include="*.gd" --include="*.py" --include="*.sh"` 零命中，输出原文落实现报告（绘制点改指的观测面局限申报见 §8——色值进 draw 命令无运行期读出面，由「常量不在册断言＋grep 零引用＋PLAZA_EDGE 值断言」三件合成承载）。
|
||||
- [ ] golden 改后比对：窗口化跑 `tools/render_gate.sh`——板面三张红（口沿高光换值所致）＝预期证据，读数落实现报告。
|
||||
- [ ] golden 重锚：跑 `tools/golden_baseline_refresh.sh` 重锚板面三张基线；复跑 `tools/render_gate.sh` 三张 0.00% 留痕；`level_map`/`menu_boot` 禁触（§3 重锚申报制）。
|
||||
- [ ] 孤立验证：单件跑 `standee_present_values_test`（V5–V12 全绿）＋`python tools/gdstyle_gate.py`（零新增键）。
|
||||
- 取用：T1 产出与 T0 读数。产出：退役常量断言面＋重锚后 golden 三张＋grep 取证原文。
|
||||
|
||||
### 7.4 T3——批末收口与产出物落位（估时 0.1 个工作日）
|
||||
|
||||
- [ ] 批末代码域闸：`tools/run_all_gates.sh --code` 全绿（本批改动含 `game/` 下非 `.md` 行为载体）；里程碑步出口跑一次全套；波内修复只做出红最小单元的最窄确认。
|
||||
- [ ] 能力行核对：`game/tests/README.md` 能力行「站桩呈现定值与素材绑定」与覆盖域表战斗表现.md 行名字与实况一致（本卡成文时已落，实现批禁改）。
|
||||
- [ ] **产出物落位卡**（轻闸全绿后、合并前写齐，方算收口）：
|
||||
- `reports/iter<N>-实现报告-<日期>.md`——各卡状态＋T0 三份改前读数与改后对拍＋grep 取证原文＋golden 重锚前后读数＋实机目检总清单（登记不阻塞三项：名字行清晰可读且长名不截字／墙格口沿亮线观感无异／贴图缺位回退描边与顶缘线观感无异）＋实现决定记录。
|
||||
- `reports/iter<N>-反哺点-<日期>.md`——§5 同步面 art-bible 两行逐条有落点。
|
||||
- `reports/iter<N>-验收审计-<日期>.md`——独立验收审计（未参与实现的会话或子代理执行，未过不得合并）。
|
||||
- 取用：T1–T2 全部产出。产出：代码域闸回执＋三份 reports/ 产出物。
|
||||
|
||||
## 8. 验证闸（改动—验收对照表）
|
||||
|
||||
本批两处行为改动（名字行字号与几何、两枚色值换）＋一节常量面退役；无新玩法验收。对照表 6 行对应 §1 完成定义第 1–4、6 条；第 5 条（能力行落表）经 T3 核对步承载（本卡成文时已落表）。能力行＝**新增：站桩呈现定值与素材绑定**（本卡成文同批入表，见 §5）。
|
||||
|
||||
| # | 需求点 | 改动（文件:行/行为） | 验收测试（名称＋落点＋尾缀） | 层级 | 真实入口 | 判据绑定面 | 能力行 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 1 | 名字行字号提档 FS_HINT 14 | `standee_body.gd` 五取值点＋`name_line_probe` 增 `name_font_size` | 「名字行绘制与几何取 FS_HINT」`standee_present_values_test.gd:_init`（〔名字行 V10〕） | 单元 | `godot --headless --path game --script res://tests/unit/presentation/standee_present_values_test.gd` | probe 几何单点实读 `name_font_size==UiKit.FS_HINT`＋两绘制点源码锚＋`FS_CAPTION` 计数锚==1（三处测量点强制换代，沿 V7 先例） | 新增：站桩呈现定值与素材绑定 |
|
||||
| 2 | 名字行几何随档联动 | `_name_baseline` 偏移 17→18；V6 读数换代 | V6 既有断言更新值（〔样张批 V6〕，申报第 1 条） | 单元 | 同上 | `baseline_y=150±0.51`（牌顶+18）且 `< plinth_top_y`（文字不压地台判据不变） | 新增：站桩呈现定值与素材绑定 |
|
||||
| 3 | 受光线常量退役改指 BRICK | `ui_kit.gd` 删 `STAND_STONE_RIM`；`standee_body.gd:383`＋`cell_base_layer.gd:176` 改指 | 「退役常量不在册＋掩尘值逐位」同套件（〔名字行 V11〕） | 单元 | 同上 | 常量表无该键＋`BRICK==Color8(201,175,131)`＋顶缘线/口沿高光两处源码锚（正证改指目标色）；grep 零引用作反证补充（观测面局限申报：色值进 draw 命令无运行期读出面，正证由源码锚承载） | 新增：站桩呈现定值与素材绑定 |
|
||||
| 4 | 描边常量退役改指新 token | `ui_kit.gd` 删 `STAND_STONE_EDGE`＋增 `PLAZA_EDGE`；`standee_body.gd:382` 改指 | 「描边合并目标逐位」同套件（〔名字行 V12〕） | 单元 | 同上 | `PLAZA_EDGE==Color8(76,64,56)`（§4.1 ②目标逐位）＋常量表无旧键＋描边行源码锚；grep 零引用反证补充 | 新增：站桩呈现定值与素材绑定 |
|
||||
| 5 | 板面 golden 与口沿高光换值一致 | golden 三张板面基线重锚 | `tools/render_gate.sh` 三张 0.00% | golden | 窗口化 `tools/render_gate.sh` | 重锚后逐像素零差留痕；level_map/menu_boot 零触 | 新增：站桩呈现定值与素材绑定 |
|
||||
| 6 | 批末收口 | 全批 | 代码域闸 `tools/run_all_gates.sh --code` | 全量闸 | `tools/run_all_gates.sh --code` | 所选域全绿回执（`game/tests/.gates/receipt.json`） | 新增：站桩呈现定值与素材绑定 |
|
||||
|
||||
**测试削弱申报**（实现期允许的旧断言改动全集，超出即审计判红）：
|
||||
1. V6 基线读数 `149.0→150.0` 与判据句「9px 档→8px 档」——规格换代（字号 12→14，0.35h 规则推导），非放宽；文字不压地台判据（`baseline_y < plinth_top_y`）零改动。
|
||||
2. 新增断言＝纯增量；V5/V7/V8/V9 判据零改动（V7 源码锚 contains 语义，名字行改档后自动覆盖，零破坏）。
|
||||
3. golden 三张板面重锚＝有意色值换代的基线换代（§3 申报制），重锚前后读数留实现报告。
|
||||
4. 显式禁止：删任何旧断言、改 `BRICK` 值、把探针/测试的字号读取换成别的入口。
|
||||
|
||||
**独立验收审计**：入口与报告＝`reports/iter<N>-验收审计-<日期>.md`；审计方＝未参与实现的会话或子代理，逐行核对对照表两端、抽查判据绑定面（`name_font_size`/常量表/`PLAZA_EDGE` 值）、核对削弱申报与 golden 重锚申报、确认全文无变异/撤销类取证；未过不得合并。
|
||||
|
||||
## 9. 异常分级
|
||||
|
||||
- **L1 自救**：单件跑红→定位该件最小单元修后重跑；`--only` 选跑零命中→修正选词重跑。
|
||||
- **L2 记录继续**：同一红连续 3 次同因→在实现报告「实现决定记录」记因后继续最窄确认。
|
||||
- **L3 停机写报告等用户**：
|
||||
1. **机检预算互斥＝上游缺陷停卡退回写卡段**——`gdstyle_gate` 出 NEW 键或既有键恶化；本批零新增成员/函数，任何键恶化都不许改基线换绿，禁开豁免。
|
||||
2. **实机可读面本身不达标**——目检发现名字行截字、叠压血条或 14px 观感劣化；产品面问题停卡呈报，禁缩字号、禁加钳制逻辑凑绿（钳制＝行为扩张，归新裁决）。
|
||||
3. **改前实查与 §2 不符**——引用面超第 8 条清单、`#4C4038` 已有 token、或 V6 读数与实装几何不匹配且非字号所致。
|
||||
4. **golden 重锚夹带**——重锚后 diff 域超出口沿高光像素带（含名字行字号变化渗入板面基线的可能——板面不含站桩，预期零渗入；若渗入＝停卡呈报）。
|
||||
|
||||
## 10. 代拍板白名单（逐条列，超清单记实现报告「实现决定记录」）
|
||||
|
||||
1. 注释与断言消息文案措辞（判据、数值不变）。
|
||||
2. `name_line_probe` 新键名（`name_font_size`）与其在返回字典中的位置。
|
||||
3. 尾缀〔名字行 V10〕–〔名字行 V12〕字样编排（含义不变）。
|
||||
4. T0 字体度量实测偏移与 0.35h 推导不一致时的定值（按实测，记录依据）。
|
||||
5. `PLAZA_EDGE` 常量在 `ui_kit.gd` 的落位行与注释句。
|
||||
|
||||
## 11. 待裁点
|
||||
|
||||
**零待裁点，开工门＝U0。** 两点裁决已于 2026-10-31 用户裁闭合并落文 art-bible v3.29（§7.4 名字行提档句、§4.1 换色合并登记句换代；舞台底 `STAGE_BG` 对已裁随背景插画批，不在本卡）。编批由迭代编排段定。
|
||||
|
||||
## 12. 落位与可复用性预检
|
||||
|
||||
**复用面**：本批零新增文件、零新增函数/类。既有复用——字号档位取 `UiKit.FS_*` 既有单点（§7.4 六档）；受光线合并目标复用既有 `BRICK` token；断言承载复用 `standee_present_values_test` 既有套件与源码锚先例（V5/V7）；golden 重锚复用既有工具 `golden_baseline_refresh.sh`；能力行补行沿迭代 43 移交小件登记规格，不另立能力名。
|
||||
|
||||
**唯一面**：新增常量 `PLAZA_EDGE` 唯一落点＝`ui_kit.gd`（色板 token 单点——`#4C4038` 全仓无既有 token，2026-10-31 grep 证实；禁在 `standee_body` 内联字面值）；`name_font_size` 探针键唯一落点＝`name_line_probe`（探针共用面单点）；名字行几何唯一算式落点＝`_name_plate_rect`/`_name_baseline`（本批不改此结构）。2026-10-31 实查无同名/同义标识符冲突（`grep PLAZA` 仅 `TEX_STAGE_PLAZA` 纹理路径族）。
|
||||
|
||||
**分层与交互面**：全部改动在 presentation 层与单元测试层——零跨层新依赖、零 Core 触碰、零 ConfigDB/RNG 触碰（无随机、无表值变化）；探针消费方向不变（`ui_struct_probe`/测试→`name_line_probe` 只读）。
|
||||
|
||||
## 13. 禁为机检文本保留无效成员
|
||||
|
||||
本批含常量退役——`STAND_STONE_RIM`/`STAND_STONE_EDGE` 删除后禁留别名常量、转发成员或注释占位凑「零引用」判据；机检键与卡片契约互斥时实现段停卡呈报，禁自造第三条路（code-conventions §1.1 同款）。
|
||||
|
||||
## 14. 实现规范预算
|
||||
|
||||
**新件三查**：本批零新增文件——三查不适用（写「无新增件」）。
|
||||
|
||||
**存量触面一查**：`standee_body.gd`（S13 扫描面内，无基线登记键）——零新增成员/函数，`name_line_probe` 返回字典增键非成员，预期 S13 零新增、既有键持平；`ui_kit.gd` 常量净 −1（删 2 增 1）；`cell_base_layer.gd` 零成员变化（引用换值）。达成手段：全部改动为常量引用替换与既有函数体内取值/偏移改写。
|
||||
|
||||
**指标例外申报**：无。
|
||||
|
||||
**估时合计**：T0 0.1＋T1 0.15＋T2 0.15＋T3 0.1＝**0.5 个工作日**（区间 0.4–0.6；切分预案＝若 T0 字体度量或 golden 重锚节外生枝超软盒，T2 拆出独立卡，T1 先行不阻塞）。
|
||||
Reference in new issue
Block a user