game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

iter47-卡1：卡⑥(迭代47·营地模态句柄子容器批): UiCampModals子容器+camp_overlay句柄迁移modals.camp.overlay二层——43处改指零行为变化,--code闸all_green

Browse Source
This commit is contained in:
DKChan committed 2026-11-01 23:44:29 +08:00
1 parent eff87256b6
commit 0761071b37
28 files changed
+181 -624
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

reports/复核-双审-grilling与godot-master-立绘显示档批-2026-11-01.md
-50
View File
@@ -1,50 +0,0 @@
# 双审复核 · 立绘显示档批（grilling ＋ godot-master，2026-11-01）
> **性质**：卡片 v1.0 的独立复核产出物（req-card 纪律「grilling 复核门」＋迭代 47 双审先例）。两个未参与撰写的会话各自只读复核，本报告记发现与处置去向。
> **被审对象**：`reports/需求卡片-立绘显示档批-2026-11-01.md` v1.0。
> **总判**：方案本体成立（引擎语义、乙类条款、闸纪律全部咬合），卡片**改后可开工**——两条阻断均为「补执行步骤」级，不动设计。
---
## 一、阻断（两条，双审同指）
| # | 发现 | 证据 | 处置 |
|---|---|---|---|
| B1 | **原稿输入面在实现 worktree 必然缺位，且管线对缺件静默零产出**：`artwork/` 整目录不入 git，`sync_worktree_assets.sh` 只同步 `game/assets/art`＋`.import`，不同步 artwork；`pixelize_candidates.py` 缺件走 `isfile` 跳过，exit 0、零文件、零报错 | `tools/sync_worktree_assets.sh:26-34`；`tools/pixelize_candidates.py:474-478,507-508` | 卡 v1.1 T1 补「显式传主区原稿根路径」＋「产物计数自证 = 9 件，不足即停」 |
| B2 | **素材落递主工作区无收口步，合回后验收有洞**：素材不入 git、worktree 合回即删；本地 CI 在主区跑，主区仍是旧 46×48 稿，只有 V16「主角源高 ≥92」会报警，敌侧「原稿分辨率落位」在册闸件 `standee_asset_check` 不在闸清单，等于无人看守 | `game/tests/run_all.gd:191`；`tools/run_all_gates.sh`（grep 无 standee_asset_check）；盘上主区素材实测 | 卡 v1.1 ①V13 逐件加钉源高＝原稿表值（旧降采样稿必红）；②T3 补「9 件落递主区再触发 CI」收口步 |
---
## 二、建议（已并入卡 v1.1）
| # | 发现 | 出处 | 卡片处置 |
|---|---|---|---|
| S1 | 样张脚本 A4 硬锁 `PORTRAIT_SRC.size==(46,48)`，T1 换代必红；另有 `:1501` 强制 96×96 方框 mockup | `tools/render_sample_sheet_v3.py:1135-1139,1501` | 列入 F11 现状与 T3 随动步（显式解冻重校） |
| S2 | T1 未明写主角源从 `*_1x.png` 切 `*_2x.png` | `tools/pixelize_candidates.py:476,481` | T1 补独立步 |
| S3 | `PORTRAIT_DISPLAY_H.get(key, 96.0)` 兜底字面量 = 档值第二处散落，与契约 2/6 自相矛盾 | 卡 v1.0 §7.3 | 改「查表必中＋键集覆盖自检」，禁静默兜底 |
| S4 | 灰矮人 126→96 是全批唯一 <0.8 档（0.76× 真降档，NEAREST 抽行约每 4 行断 1px 描边），不在已接受清单 | 双审同指 | 补进契约 5 已接受项＋目检①点名（头号回退候选） |
| S5 | 关卡地图头像由 ≈1× 变 0.52× 降采样，是全消费面降级最狠一处 | `level_map_screen.gd:176-190` | §4 不做面点名＋目检③专列 |
| S6 | 主角三态宽度不一（88/92/88）且 `apply_hero_state` 换纹理不重摆，态切换有约 3–6px 横跳（现行 2px 的放大版） | `standee_motion.gd:85-86` | §4 明列不做（重摆＝行为改动，禁实现批顺手加）＋目检清单登记 |
| S7 | T1/T3 闸件口径切换时点三处互斥（T1 说「T2 未就绪允许红」、闸件排在 T3、§15 说已提前到 T1） | 卡 v1.0 §7.2/§7.4/§15 | 统一：闸件口径改造并入 T1（素材与闸件同批），删矛盾句 |
| S8 | 注释随动面漏 `standee_motion.gd:38-39,59,65`（反向引用已不存在的「禁非整数缩放」禁令）与 `level_map_screen.gd:176` | 双审同指 | T2 补点名 |
| S9 | 「两表同值」观测面局限申报说重了：grilling 判 Godot editor 版 `FileAccess` 可读 `../tools/`，godot-master 判无稳定通路——两审相左 | 双审 §6/§O5 | 卡 v1.1 改「尝试真断言（读 `../tools/pixelize_candidates.py` 逐键对账），读不到走 L2 记录退回双端字面钉值＋审计对账」，禁把争议当定论 |
| S10 | §14 所核 `gdstyle_baseline.txt` 无该测试键，且 gdstyle 扫描面只含 `game/core|data|presentation`（tests 不在面） | `tools/gdstyle_gate.py:49` | §14 改口径：测试文件不在扫描面，只核 `standee_motion.gd` 在面件 |
| S11 | 卡片头行引用待办状态「待写卡」已过时；§7 交叉引用「见 §9 行 V1–V4」应为 §8 | 卡 v1.0 | 就地修正 |
## 三、观察（不改卡，记录在案）
- **几何实测**：立绘落位只在换纹理拍执行、按缺省盒高 96 算——大档顶 y=−2、中档 20、小档 44；溢出 2px < VBox 间距 4px，**恒不碰顶部轮次指示**（卡 L3#3 的「碰邻位」实际难触发，仍留作停机条款）；立绘链上无 ClipControl，不被裁；意图徽标 y=86 在中/大档为「压胸」，符合圣经③；大档脚底越盒底由明细带面板遮住（现行卓尔/石君王已如此，本批食人魔加深 40px）。
- **1920 档**：三档是 1280 基准壳坐标绝对高，`stretch=canvas_items`＋aspect keep 下整壳 ×1.35 等比，构图恒等，无需新条款。附带发现：`project.godot` 未显式声明 `window/stretch/aspect`，依赖引擎缺省——**与本批无关，建议另立工程批钉死**。
- **未登记 enemy_id**（如 hobgoblin 缺口行）无立绘 → `load_tex` 返回 null → 字形回退，不进 `_place_portrait`，显示档不涉，非待裁点。
- **素材侧健康度**：九件原稿色数 30–32、alpha 二值、底缘不透明、敌侧暖白描边 68.4–98.9%（阈值 40% 全过）——T3「其余四断言不变」可保绿。
- **事实核对**：F1–F15 逐条复核通过（F3 的 :197 实为 :198、F10 断言②止于 :100，属微差）；F7 降采样等值由 grilling 独立重跑四件字节级复现。
- **浮点判据**：0.99/1.57 档回程有 ULP 级残差，V13/V15 须 `is_equal_approx`，禁裸 `==`。
---
## 四、呈用户裁决项（卡片不动，等发令）
1. **是否把 `standee_asset_check` 编进代码域闸**（`run_all_gates.sh` 闸件增减属工程改动，另批走）。
2. **灰矮人 0.76× 与关卡地图头像 0.52× 两处降采样**：本卡按「已接受＋目检」处理；若实机判不可受，回退路径只有「灰矮人改归中档」或「地图头像出 48 专件」，均须另裁。
3. **主角态切换横跳**（S6）：本卡不做重摆；若要修，另立小批。
4. **`project.godot` 显式声明 stretch/aspect**（观察项）：另立工程批。
reports/需求卡片-状态合并累加制批-2026-11-01.md
-151
View File
@@ -1,151 +0,0 @@
# 需求卡片：状态合并累加制——同名状态重复授予改加时长
> 日期：2026-11-01
> 性质：需求改动实现批卡片；零待裁点，开工门＝U0。
> 来源：待办清单「状态合并改累加制——同名状态重复授予改加时长」条（2026-10-31 用户立案并四点裁决闭合；登记批 git 提交 d216ae04，设计闭合批 870b2f2b）。
> 唯一事实源：[增益状态](../design/gdd/systems/战斗循环/增益状态.md) v1.3（2026-10-31）——§同名状态再拿到（合并策略表：叠加／累加／并存）· §剩余次数怎么倒数 · 「幅度与量纲」节盾牌加护行与字段表。本卡只实现上述设计，不改设计。
> 估时：T0–T2 ≈ **1.0～1.25 个工作日**（中值 ≈1.125）。
## 一、目标与完成定义
本批把状态表六行（attack_up／ac_up／weaken／empower／fortify／defensive_stance）的合并策略由「refresh＝重复授予重置剩余次数」改为「accumulate＝重复授予在剩余次数上累加本次授予的时长」，状态容器 refresh 臂同步换为累加臂。
完成定义：
1. 表行：六行 `stack_policy` 值 refresh→accumulate；四行 stack 行与其余全部字段值零改动。
2. 容器：同名重复授予 → 剩余结算次数加上本次授予的生效时长（`duration_override` ≥1 时加覆盖值）；层数恒 1；时长不封顶；空授予面消除（每次授予必有剩余次数变化）。
3. 叠加（stack）与并存（independent）两臂语义零变化；快照纪律不变（首授快照恒定）。
4. 词表换代：schema 词表改 `["stack", "accumulate", "independent"]`，加载期枚举校验随词表生效（fail-fast 不变）。
5. 既有断言数值换代两处＋断言标签/注释文字换代两处（第十一节申报共四条）＋新增累加断言三条，全部真实入口、当轮执行并通过。
6. 独立验收审计通过（报告落 `reports/iter<N>-验收审计-<日期>.md`，未过不得合并）；反哺点两条落反哺点清单；README 能力行批末只核对名字与实际落地一致；本批不写 `design/` 与根规则文件。
## 二、设计事实源
1. 增益状态.md v1.3 §同名状态再拿到·合并策略表「累加」行：剩余结算次数加上本次授予的时长——技能施放行带覆盖时长时按覆盖值加；层数不变；现行内容行六行用累加。
2. 同文档 §剩余次数怎么倒数：累加语义下重复拿一次就按本次授予时长多攒一段，同一轮拿几份攒几段。
3. 同文档「幅度与量纲」节例表（盾牌加护行）：层数恒 1、剩余结算次数累加；掷点判定阈值＝主角基准＋层数——该句为现状描述，AC 读取路径本无「上限 2 层叠读取法」代码（见第三节 8），AC 侧零改动。
4. 四点裁决（待办清单条目在案）：六行 refresh 全改累加／时长不封顶／只加时长、层数与强度不变／累加量＝本次授予的生效时长（带覆盖时长时按覆盖值）。
5. [地图战斗资源](../design/gdd/systems/战斗循环/地图战斗资源.md) 削弱行引用句（:130，2026-10-31 设计闭合批随改、累加语义已落）——待办清单条目闭合凭据的第二件，与条目实况对齐；无实现缺口。
## 三、现状事实（代码级，开工自行复核）
1. 表行：`game/data/tables/status_effects.tres` 十行；六行 `stack_policy: "refresh"`——attack_up :14、ac_up :23、weaken :32、empower :68、fortify :77、defensive_stance :86；四行 `"stack"`——enrage :41、off_guard :50、sapped :59、alert :95；无 independent 行。相关表值：attack_up/ac_up duration 1·max_stack 2；weaken duration 2·max_stack 16；empower/fortify/defensive_stance duration 2·max_stack 1。
2. 词表：`game/data/schemas/status_effect_table.gd:11` `STACK_POLICIES := ["stack", "refresh", "independent"]`；:55–56 加载期枚举校验（出域致命——fail-fast）。
3. 容器：`game/core/status_container.gd:28` `apply_effect(effect_id, source, duration_override=-1)` 唯一授予入口（:37 override <1 → 行值 duration_settlements）；:40–49 策略 match；:44–45 refresh 臂转发 `_apply_refresh` :61–67——命中 `inst.remaining = dur`（重置）、未命中追加（层数 1）、恒返回 true。
4. 叠加臂 :72–80（满层拒零写入、未满加层、不触碰 remaining）与并存臂 :41–43（新建独立实例）——本批零改动。
5. 快照：`_grant_snapshot` :52–57 授予时快照；refresh 臂重授不换快照——本批沿用该口径（第 13 节代拍板 2）。
6. 衰减：`decay_round` :122–134 每实例 −1、归 0 移除（先兑付后衰减的编排信任在战斗结算）——累加制零改动。
7. 授予链三路（真实入口全走 `apply_effect` 同口）：`game/core/reward_grant.gd:239`（安全格 percent 奖励 → attack_up/ac_up）· `game/core/damage_controller.gd:451`（效果引擎 fx_apply_status）· `game/core/settlement/combat_segment.gd:89`（敌方增益/妨害技施放——:88 `dur = srow.buff_duration`，覆盖时长的真实入口）。
8. AC 读取：`game/core/damage_controller.gd:616–631` `defender_ac` = 基线（hero 表或合流入参）＋Σ ac 型 `effective_value`（层数×快照幅度）——无上限钳制；ac_up 层数恒 1 → 阈值＝基准＋1。v1.3「上限 2 层叠读取法退役」为现状描述句，代码无该读取路径——AC 侧零改动。
9. AC11 采样：`game/tests/unit/battle_settlement/roll_multiplier_test.gd:241` 起 `_ac11_tier_samples` 每轮衰减后重授——实例已移除、重授为新建，不触合并臂——累加制下行为与断言不变。
10. 断言换代点：`roll_multiplier_test.gd:158–161`（削弱重复授予 remaining==2 重置语义断言与 :157–158 注释）＋ :221–236 `_weaken_refresh_probe`（:230 重授注释「remaining ← 2」；:159 调用点与 :342 注释引用该探针名——改名随批换代）；`game/tests/unit/data_config/table_structure_guard_test.gd:273–275`（ac_up 行断言 `stack_policy == "refresh"`）；`game/tests/unit/battle_settlement/damage_controller_test.gd:376`（断言标签「refresh 政策重复授予受理且层数恒 1」——行为面累加制下仍绿〔层数恒 1、池值不变〕，仅标签文字换代）。
11. 不受影响断言：`damage_controller_test.gd:391`（stack 行过滤）· `seal_polarity_test.gd:684`（sapped=="stack"）· `system_contracts_test.gd:_test_status_boolean_acceptance`（布尔受理——attack_up 行，refresh→accumulate 行；单次授予不触合并臂）。
12. sim/probe 零消费：`stack_policy`／`apply_effect` 于 `game/sim`、`game/probe` grep 零命中；状态实例不落存档断点（战斗域生命周期——`notify_battle_start` 清空，`game/core/breakpoint_store.gd` 无状态片段）。
13. EV 锚：战斗结算域 EV 抽样对锚（goblin 锚）读战斗真实结算——合并语义改变重复授予的削弱/增益存续时长，EV 有漂移可能（先例：触发器批 git 提交 4868e11b 触发重锚 ba5105aa 归绿）。
14. S13 基线：status_container／status_effect_table／damage_controller 均不在 `tools/gdstyle_baseline.txt`（默认阈值内）；tests 不在 S13 扫描面。
15. 表批注：status_effects.tres :99–141 为逐批变更叙事批注（含 :129–141 叙述 refresh 语义的历史——本批换代后成陈旧叙事）。批注保留是用户明令现状（git 提交 4a2ed961，2026-11-01：数值表 `; ` 批注全量恢复）——本批零触碰，处置归用户另裁，实现报告留遗留观察记录。
16. 文档漂移（考证发现，非本批造成）：增益状态.md「现在有哪些状态」节记「现行九行」且行表缺 defensive_stance（护身）行——该行 2026-10-27 触发器批落表（git 提交 4868e11b），文档行清单未跟；合并策略表「六行用累加」计数与表实况一致。
## 四、设计契约
- 🔴 **C1 累加语义单点**：重复授予的合并只发生在状态容器策略臂（match 分派后累加实现）——任何调用方不得自算 remaining 或二次实现合并。
- 🔴 **C2 表驱动**：累加行集合以 `stack_policy` 字段为唯一依据——禁按 effect_id 白名单另立硬编码集合。
- 🔴 **C3 只加时长**：累加臂只改 remaining；层数、快照（m/unit/display）、source_class、origin_cell 首授后恒定；时长不封顶（运行期 remaining 无上限，禁自造 clamp）。
- 🔴 **C4 覆盖时长口径**：`duration_override` ≥1 时累加量＝override 值；<1 时＝行值 duration_settlements。
- 🔴 **C5 两臂不动**：stack 臂满层拒零写入与 independent 臂新建实例语义零变化——触碰即 L3。
- 🔴 **C6 词表唯一**：`stack_policy` 取值集合只在 schema 词表一处定义；tres 六行与词表同批换代，禁留双值兼容（旧值 "refresh" 出词表即加载期致命，同批清干净）。
## 五、范围边界
不做：衰减节拍改动（先兑付后衰减不变）；单体寻址扩展位实现（接口定稿在案、随首个单体效果内容批）；叠加/并存行为调整；status_effects.tres 其余字段与四行 stack 行值改动；表批注处置（:99–141 含本批换代后的陈旧叙事——用户 2026-11-01 恢复令 git 提交 4a2ed961 在案，本批零触碰，另裁另批）；「增益叠层／衰减／清除结算链」覆盖缺口的其余断言补齐（归待办清单「能力清单覆盖缺口补齐」条）；EV 锚重锚（红则停机呈报，重锚归用户档位发起）。
反哺去向：第六节两条 → `reports/iter<N>-反哺点-<日期>.md`，用户裁决后归文档批落文。
## 六、关联文档同步面
| 文档 | 关联点（本批实现会改变它的哪条陈述） | 同步义务 |
|---|---|---|
| design/gdd/systems/战斗循环/增益状态.md | 字段表 `stack_policy` 取值行记「stack / refresh / independent」——词表换代后 refresh 值不复存在 | 反哺点（iterN 反哺点清单）：取值改「stack / accumulate / independent」，用户裁决后文档批落文 |
| design/gdd/systems/战斗循环/增益状态.md | 「现在有哪些状态」节记「现行九行」且行表缺 defensive_stance（护身）行——本批考证发现的存量漂移，非本批造成 | 反哺点（iterN 反哺点清单）：九行→十行＋补护身行（敌方输出减益 −25 percent、duration 2、累加、max_stack 1、来源敌方技能「孤注守势」），文档批落文 |
| game/tests/README.md | 能力行新增＋覆盖域表「增益状态」行更新 | 写卡段随本卡已入表（实现批禁写该文件红线不变；批末收尾只核对表上名字与实际落地一致） |
## 七、文件结构图
| 文件 | 职责 | 改动性质 |
|---|---|---|
| game/data/tables/status_effects.tres | 状态表十行 | 行为改动：六行 stack_policy 值换代（对照表 R1）；表批注零触碰（范围边界在案） |
| game/data/schemas/status_effect_table.gd | 表 schema 与词表加载期校验 | 行为改动：词表换代（对照表 R1） |
| game/core/status_container.gd | 状态容器（授予/合并/衰减唯一落点） | 行为改动：refresh 臂→累加臂（对照表 R2/R3/R4） |
| game/tests/unit/battle_settlement/roll_multiplier_test.gd | 掷点/削弱/AC11 套件 | 行为改动（测试面）：削弱累加探针换代＋新增三条断言（对照表 R2–R4；申报见第十一节） |
| game/tests/unit/data_config/table_structure_guard_test.gd | 表结构守卫 | 行为改动（测试面）：ac_up 行断言换代（对照表 R1；申报见第十一节） |
| game/tests/README.md | 能力清单与覆盖域表 | 写卡段维护件——本卡落位时已入表，实现批零改动 |
## 八、落位与可复用性预检
- **复用面**：零新增文件、零新增函数、零新增数据件——累加臂就地替换 refresh 臂（`_apply_refresh` 改名 `_apply_accumulate`），词表与表行就地换代；合并逻辑唯一落点＝容器策略 match（C1/C6），无第二处可复用或需新建的合并实现。
- **唯一面**：`stack_policy` 词表唯一出处＝schema :11；取值**定义面**全仓 grep 仅存于 tres 六行＋schema 词表＋容器臂＋三处断言（第三节 1/2/3/10）——叙事批注与测试注释例外（第三节 15/10 在案），不属定义面。
- **分层与交互面**：表行（data/tables）→ schema 校验（data/schemas，加载期致命）→ 容器臂（core）→ 消费面（defender_ac 与池乘区——零改动）。Core 零 UI、数值单点经 ConfigDB、RNG 零新增——既有红线零触碰。
## 九、实现规范预算
- 新增文件：零——新件三查不适用；迁移函数：零（累加臂就地改写，无自存量文件迁入的函数）。
- 存量触面一查：触碰产品码两件（status_effect_table.gd、status_container.gd）均不在 gdstyle 基线（默认阈值内）；预期 S13 键较现状零新增。tests 不在 S13 扫描面。
## 十、任务卡
**T0 开工门＋基线读数（0.25 天）**
- [ ] worktree 建区＋`git status` 归属核对（并行遗留只登记不触碰）
- [ ] S13 触面读数：两产品文件现行键数记录进实现报告（预期零键——不在基线）
- [ ] EV 锚改前读数留底：从最近 CI 回执抄录战斗结算域 EV 锚读数（goblin 现值）进实现报告，作批末对拍锚
**T1 累加制单点实装（0.5～0.75 天）**
- [ ] status_effects.tres：六行 `stack_policy` "refresh"→"accumulate"（:14/:23/:32/:68/:77/:86；保持既有 CRLF 行尾）——可核查：grep '"stack_policy": "refresh"' 零命中（值行限定写法——:129/:139 恢复批注含同词、不属值行，禁触碰）、"accumulate" 恰六处
- [ ] status_effect_table.gd:11：`STACK_POLICIES` 换代 `["stack", "accumulate", "independent"]`——可核查：加载链全表装载零红（枚举校验随词表生效）
- [ ] status_container.gd：:44–45 match 臂 "refresh"→"accumulate"；`_apply_refresh` 改名 `_apply_accumulate`——命中 `inst.remaining = int(inst.remaining) + dur`、未命中追加、恒 true；:60 注释换代（累加语义——R += D；L 不变；快照沿首授）——可核查：容器内 stack_policy 语境 "refresh" 零残留
- [ ] roll_multiplier_test.gd：③段 :157–158 注释与 :160–161 断言换代（重置 2 → 累加 3）；`_weaken_refresh_probe` 改名 `_weaken_accumulate_probe`（:159 调用点与 :342 引用注释随改），探针改五段式——授予(2)→衰减(1)→重授(1+2=3，V1)→覆盖值重授(3+3=6，V3)→同轮再授(6+2=8，V2)；返回 {layers, pool, after_regrant, after_override, after_extra, snap_magnitude} 六读数（pool 键保留——:163 池读数断言零改动在位）
- [ ] 新增断言三条（尾缀〔状态累加 V1/V2/V3〕）：V1＝重授后 remaining==3、layers==1、snap_magnitude==−65（首授快照恒定）；V3＝覆盖值累加后 remaining==6；V2＝同轮再授后 remaining==8
- [ ] table_structure_guard_test.gd:273–275：ac_up 行断言 `stack_policy == "accumulate"`＋消息换代（累加语义句）——可核查：断言尾缀〔状态累加 V4〕可 grep、套件绿
- [ ] 孤立验证：六套件最窄复跑（roll_multiplier／table_structure_guard／system_contracts／damage_controller／seal_polarity／round_flow_skill_pool——EV 锚套件提前曝红）全绿或按 L3②停机、断言尾缀可 grep
**T2 产出物落位（0.25 天）**
- [ ] 实现报告：各卡状态＋改动—验收对照表结果列＋EV 锚改前改后读数对拍＋实机目检总清单（同名状态重复授予后状态存续时长延长——登记不阻塞）＋遗留观察记录（tres :129–141 refresh 陈旧叙事批注——处置归用户另裁）
- [ ] 反哺点清单：第六节反哺两条逐条落点
- [ ] 独立验收审计：未参与实现的会话/子代理按 test-conventions §8.7 审计，报告落 `reports/iter<N>-验收审计-<日期>.md`——未过不得合并
- [ ] 批末按改动域跑闸（代码域）全绿；合回后本地 CI 复验
## 十一、验证闸（改动—验收对照表）
| # | 需求点 | 改动（文件:行/行为） | 验收测试（名称＋落点＋尾缀） | 层级 | 真实入口 | 判据绑定面 | 能力行 |
|---|---|---|---|---|---|---|---|
| R1 | 六行合并策略换代＋词表加载期校验 | status_effects.tres :14/:23/:32/:68/:77/:86；status_effect_table.gd :11 | table_structure_guard_test ac_up 行断言换代〔状态累加 V4〕（值=="accumulate"）＋全表装载零红 | 接口 | ConfigDB 加载链 → `StatusEffectTable.row_by_id()` | stack_policy 字段取值（加载期枚举校验随行生效） | 新增：同名状态合并策略（叠加/累加/并存）与剩余次数语义 |
| R2 | 同名重复授予累加时长＋层数恒 1 | status_container.gd :44–45/:60–67 累加臂 | roll_multiplier_test._smoke_armor_roll 削弱累加断言〔状态累加 V1〕（重授 remaining==3、layers==1、snap_magnitude==−65） | 单元 | `StatusContainer.apply_effect()` 经真实编排宿主 begin_battle | remaining/layers 只读投影（query_active） | 新增：同名状态合并策略（叠加/累加/并存）与剩余次数语义 |
| R3 | 同轮双授予累加两段 | 同上 | 〔状态累加 V2〕（同轮再授 remaining==8） | 单元 | 同上 | remaining 累计 | 新增：同名状态合并策略（叠加/累加/并存）与剩余次数语义 |
| R4 | 覆盖时长按覆盖值累加 | apply_effect :37 override 入累加臂 | 〔状态累加 V3〕（覆盖值 3 重授 remaining==6） | 单元 | 同上（真实施放链 combat_segment :89 走同口） | remaining 累加覆盖值 | 新增：同名状态合并策略（叠加/累加/并存）与剩余次数语义 |
| R5 | 快照纪律不变（首授快照恒定） | 非行为改动——累加臂沿用既有重授不换快照口径，零代码变化 | 〔状态累加 V1〕快照断言（snap_magnitude==−65） | 单元 | 同 R2 | 快照域取值（snap_magnitude） | 新增：同名状态合并策略（叠加/累加/并存）与剩余次数语义 |
| R6 | 叠加/并存两臂零变化 | 非行为改动——两臂零代码变化 | damage_controller_test :391＋seal_polarity_test :684＋system_contracts_test 布尔受理——既有断言零改动复跑即回归证词 | 单元 | 各既有真实入口 | 既有断言零改动 | 既有：系统间契约词表与受理口径：五配方互异／掷点标签成员性／增益布尔受理 |
**测试削弱申报**（允许的旧断言改动，全部为语义换代非削弱）：
1. roll_multiplier_test.gd:160–161 削弱续时断言——refresh 重置语义（remaining==2）作废，换代为累加语义（remaining==3）——被测行为就是本批改动本体。
2. roll_multiplier_test.gd:157–158 注释、:230 探针注释与 :342 探针名引用注释换代（「续时：remaining ← 2」→累加口径；旧函数名 `_weaken_refresh_probe` 全仓清零）。
3. table_structure_guard_test.gd:274–275 ac_up 行断言值与消息换代（refresh→accumulate）——同上。
4. damage_controller_test.gd:376 断言标签「refresh 政策重复授予受理且层数恒 1（叠层改续时裁决）——池值不变」——行为面累加制下仍绿（层数恒 1、池值不变，断言数值零改动），仅标签文字换代为累加口径。
## 十二、异常分级
- **L1 自救**：一次重试（表装载/套件瞬时红）。
- **L2 记录继续**：同红灯连续 3 次升级。
- **L3 停机呈报**：①C1–C6 任一触碰；②战斗结算域 EV 锚套件红（累加制有意行为改动的期望值漂移）——锚内子集判红即停，重锚归用户档位发起（先例＝触发器批 2026-10-27：EV 0.9148 出带 → 重锚 ba5105aa 归绿）；③S13 新增红键＝上游缺陷停卡退回写卡段（机检预算互斥）。
## 十三、代拍板白名单
1. 词表值命名 `accumulate`（实现标识符——语义已由 v1.3 全定；反哺点随批登记文档字段表行换代）。
2. 合并授予不改快照（沿用既有 refresh 臂口径——首授快照恒定、幅度 override 只作用首授）。
3. 测试函数改名 `_weaken_refresh_probe`→`_weaken_accumulate_probe` 与新增断言措辞（V 尾缀〔状态累加 Vn〕编号在案）。
## 十四、待裁点
零待裁点，开工门＝U0。（四点裁决 2026-10-31 用户裁闭合——待办清单条目在案；本卡全部实现项与代拍板 1–3 均为该裁决的实现面，无新增设计分叉。）
reports/需求卡片-立绘显示档批-2026-11-01.md
-244
View File
@@ -1,244 +0,0 @@
# 需求卡片 · 立绘显示档批（v1.1）
> **用途**：迭代实现批的实施合同（卡①单卡批）。v1.1＝双审（grilling＋godot-master）后执行级订正，设计面零改动（复核记录＝`reports/复核-双审-grilling与godot-master-立绘显示档批-2026-11-01.md`）。
> **来源**：待办清单「立绘清晰度回退评估——原稿分辨率＋三档显示」条目（状态＝美术设计已闭合＋已写卡）。
> **唯一事实源**：`design/art/art-bible.md` §8.2「站桩立绘显示档 = 三档绝对高」条（v3.32）＋ `design/art/character-design.md` §5.2/§5.5 指路行。
> **改动面**：美术素材＋游戏代码。 **估时**：≈0.85 个工作日。
---
## 1. 目标与完成定义
**做什么**：把 9 件站桩立绘（八敌 + 主角三态）从「原稿降采样到 48–94 再 ×2 显示」改成「原稿分辨率入包 + 显示按三档绝对高缩放」。
| 档 | 绝对显示高 | 归档 |
|---|---|---|
| 小型 | 96 | 地精 goblin、巨蜘蛛 giant_spider、灰矮人 duergar |
| 中型 | 144 | 主角 hero、钩爪恐魔 hook_horror、熊地精 bugbear |
| 大型 | 188 | 食人魔酋长 ogre_chief、蛛化卓尔 drider、灰矮人石君王 duergar_king |
宽度一律随源图比例（高定宽随），缩放过滤 NEAREST。
**什么状态算完**：
1. 9 件素材 = 原稿紧裁原样落 `game/assets/art/character/`，盘上无任何降采样痕迹；
2. `standee_motion.gd` 硬编码 ×2 退役，显示倍率由逐件档高算出；
3. `tools/standee_asset_check.py` 与 `tools/pixelize_candidates.py` 改按显示档与原稿高校验，全绿；
4. 真实入口断言钉住逐件显示档高、纵横倍率恒等、两表同值；
5. 样张脚本站桩段与探针文案随动；
6. 代码域闸全绿 ＋ 改前/改后并排对照图落盘 ＋ 产出物三份齐。
---
## 2. 现状事实（代码级，开工复核）
| # | 事实 | 出处 |
|---|---|---|
| F1 | 显示倍率硬编码：`w/h = tex.get_width/height() * 2.0`、`scale = Vector2(2.0, 2.0)` | [standee_motion.gd:63](game/presentation/views/standee_motion.gd#L63) |
| F2 | 立绘盒几何：`box := Vector2(150, 176)`；立绘盒矩形 `(0,44)-(box.x, box.y-80)` → 立绘区 150×96，高于 96 者按 `(box_h-h)*0.5` 向上溢出 | [standee_body.gd:24](game/presentation/views/standee_body.gd#L24)、[:309](game/presentation/views/standee_body.gd#L309)、[standee_motion.gd:62](game/presentation/views/standee_motion.gd#L62) |
| F3 | 盒宽常量与盒高注入：`_STANDEE_W := 150.0`；`hero_standee.box = Vector2(_STANDEE_W, box_h)`（盒高＝行高） | [battle_stage_view.gd:10](game/presentation/views/battle_stage_view.gd#L10)、[:197](game/presentation/views/battle_stage_view.gd#L197) |
| F4 | 主角立绘装载与三态注册（含「48px 档」注释）；敌侧 `_enemy_portrait_tex(enemy_id)` 查表后 `set_portrait_texture` | [battle_stage_view.gd:132-140](game/presentation/views/battle_stage_view.gd#L132)、[:252-267](game/presentation/views/battle_stage_view.gd#L252) |
| F5 | 纹理路径常量单点在 UiKit（八敌 + 主角三态） | [ui_kit.gd:233-247](game/presentation/views/ui_kit.gd#L233) |
| F6 | 现行入包稿尺寸：主角三态 46×48 / 48×48 / 46×48；八敌 36×36、48×38、34×46、46×58、51×62、62×74、67×90、66×94 | 盘上 `game/assets/art/character/`（素材不入 git） |
| F7 | **现行入包稿 = 原稿降采样，逐像素相同**：`dom_block_resize(pixel-1, 74/90/94)` 与 ogre_chief/drider/duergar_king 三件 diff 框为空（2026-11-01 会话实测） | 管线 [pixelize_candidates.py:430-457](tools/pixelize_candidates.py#L430) |
| F8 | 原稿在盘：八敌 `pixel-1.png` 高 81–189（地精 89×90／巨蜘蛛 102×81／灰矮人 93×126／钩爪 74×94／熊地精 102×123／酋长 158×189／卓尔 140×189／石君王 133×189）；主角手修 2× 三态稿内容 88×92 / 92×92 / 88×92 | `artwork/remote-gen-2026-09-26/`（不入 git） |
| F9 | 派生管线末步即降采样：`build_standee48` 紧裁 → 等比缩至 `STANDEE_TIER_H` → `dom_block_resize` | [pixelize_candidates.py:28](tools/pixelize_candidates.py#L28)、[:38-43](tools/pixelize_candidates.py#L38)、[:459-504](tools/pixelize_candidates.py#L459) |
| F10 | 闸件按源档高校验：`DISPLAY_SCALE=2`、`SRC_W_MAX=75`、断言①档高、断言②源宽×2≤150 | [standee_asset_check.py:50-53](tools/standee_asset_check.py#L50)、[:75-98](tools/standee_asset_check.py#L75) |
| F11 | 样张脚本站桩段硬编码「立绘盒 96px(48 源 ×2)」；另有 A4 尺寸基线硬锁 `PORTRAIT_SRC.size==(46,48)` 与战斗语境 96×96 方框 mockup（脚本自述「换代须显式解冻重校」） | [render_sample_sheet_v3.py:775-791](tools/render_sample_sheet_v3.py#L775)、[:1135-1139](tools/render_sample_sheet_v3.py#L1135)、[:1501](tools/render_sample_sheet_v3.py#L1501) |
| F12 | 探针文案「48px 档」（判据只查 `has_tex`，非尺寸断言） | [ui_probe.gd:139-144](game/probe/ui_probe.gd#L139) |
| F13 | 另两消费面按固定框装载同一素材：标题屏 138×144／46×96／80×96（`STRETCH_KEEP_ASPECT_CENTERED`＋NEAREST）；关卡地图头像定高 48、宽随源比 | [ui_assembler.gd:170](game/presentation/ui_assembler.gd#L170)、[level_map_screen.gd:176-190](game/presentation/views/level_map_screen.gd#L176) |
| F14 | 能力清单现行行「站桩呈现定值与素材绑定」→ `standee_present_values_test.gd`（V5–V12 在此套件） | [README:136](game/tests/README.md#L136) |
| F15 | 舞台高 252（溢出上限的物理边界） | `game/data/tables/battle_layout.tres` |
---
## 3. 设计契约（违反即返工；标 🔴 触碰＝L3 停机呈报）
1. 🔴 **禁改形象**：9 件素材 = 原稿紧裁原样，禁重画、禁生成、禁 `dom_block_resize` 降档（art-bible §8.2 v3.32）。
2. 🔴 **显示档定值单点** = art-bible §8.2；GDScript 侧 `PORTRAIT_DISPLAY_H` 与 Python 侧 `STANDEE_DISPLAY_H` 逐键同值、两侧各自钉死字面值，跨语言对账由 V17 承担（读不到文件走 L2，见 §8/§9）；禁第三处复写，**禁查表兜底字面量**。
3. 🔴 **纵横倍率恒等**（高定宽随），禁方框强拉（art-bible §8.2 槽位条）。
4. 🔴 **体量顺序由显示档承载**：小 < 中 < 大；禁按强度重排（character-design §5.2）。
5. 🔴 **已接受项不得当缺陷回炉**：①五件源高低于档高属放大显示（主角 92／钩爪 94／熊地精 123／地精 90／巨蜘蛛 81，倍率 1.07–1.57）；②灰矮人 126→96 是全批唯一 <0.8 档（0.76× 抽行，NEAREST 描边约每 4 行断点），列目检①头号回退候选；③食人魔酋长显示宽 157 超桩盒 150；④关卡地图头像由 ≈1× 变 0.52× 降采样，列目检③。
6. 🔴 显示档数值只落显示档表，绘制点与检查器一律读表，禁字面量散落（数值单点纪律）。
7. 🔴 素材不入 git（art-bible §8.3）；本批入 git 的只有代码/工具/测试/文档件，素材落盘由实现批执行并在实现报告逐件留读数。
---
## 4. 范围边界
**做**：9 件素材按档派生落盘；`standee_motion.gd` 显示倍率改造；`pixelize_candidates.py`／`standee_asset_check.py` 改显示档；样张脚本站桩段随动；探针与装载点注释随动；`standee_present_values_test.gd` 增显示档断言。
**不做（去向明示）**：
- 不重画、不生成任何图像（现有形象即终稿）。
- 不动棋盘小人（`character_hero_idle/walk.png` 32×32 独立资产）——另属棋盘面。
- 不改标题屏与关卡地图头像的框尺寸（两面只随素材分辨率自动变化；若目检判需专件，另批）。
- 不动色板与 `#A79CB8`（保留在板、本批不消费；色板额度议题另批讨论）。
- 不做站桩帧动画（待办清单「站桩帧动画」条）。
- 不做主角态切换重摆（`standee_motion.gd:85-86` `apply_hero_state` 换纹理不重算 position，三态源宽 88/92/88 → 切换有约 3–6px 横跳，系现行 2px 的放大版；重摆＝行为改动，禁实现批顺手加，要修另批）。
- 不做关卡地图 48px 头像专件（新源在该面为 0.52× 降采样；目检判不可受则另批出专件）。
- 不做桩盒宽 150 与 >150 溢出档的布局重排（食人魔超宽 8px 按已接受项走；实机若碰邻位则 L3 停机，布局另批）。
---
## 5. 关联文档同步面
| 文档 | 关联点（本批实现会改变它的哪条陈述） | 同步义务 |
|---|---|---|
| `design/art/art-bible.md` §8.2 | 显示档条与排版条 >150 举例 | **已落**（前置文档批 v3.32，本区已改）——实现批禁写 `design/`，本批零义务 |
| `design/art/art-bible.md` §8.2 槽位条 | 「高度的整数倍档」与绝对档高＋非整数倍率字面冲突 | **已落**（双审后随设计批改「高度的绝对档（档高取整数像素值）」） |
| `design/art/art-assets-checklist.md` §0 分辨率档位行 | 旧口径「站桩源高 48／敌种逐键源档 36–94／整数倍缩放纪律」 | **已落**（改指 §8.2 显示档条） |
| `design/art/character-design.md` §5.5 | 指路行 | 同上，已落 v3.32 配套 |
| `design/gdd/08-Alpha版本标准.md` 覆盖行 | 出口从「重产完成」改「9 件按档落位＋目检」 | 已落 v1.22；实现完成后「待做→在役」列**反哺点**呈裁 |
| `待办清单.md` 本条 | 状态推进（已写卡→已编迭代→完成删条） | 各段按状态机推进，非实现批直改 → 列**反哺点** |
| `design/art/art-prompts.md` §5.4 产出状态 | 「待实装批落位」→「已落位」 | 实现完成后 → 列**反哺点** |
| `design/art/art-status-checklist.md`／`art-assets-checklist.md` 站桩行 | 「按档派生落位归本条实装批」→ ✅ 已交付 | 实现完成后 → 列**反哺点** |
| `game/tests/README.md` 能力清单 | 新能力行「站桩显示档与素材分辨率绑定」 | **写卡段已同批补行**（本卡 §9 能力行与之一致）；实现批禁写该文件 |
| `design/gdd/术语表.md` | 「显示档」是否立条 | 列**反哺点**呈裁 |
| `体验验证清单.md` | 实机目检项（9 件清晰度、同屏体量顺序、标题屏/地图头像消费面） | 实现批禁写 → 列**反哺点**，目检清单先落实现报告 |
---
## 6. 卡前文件结构图
| 文件 | 职责 | 改动性质 | 验收行 |
|---|---|---|---|
| `game/presentation/views/standee_motion.gd` | 显示档表 `PORTRAIT_DISPLAY_H` ＋ `_place_portrait` 按档算倍率 | **行为改动** | V1 V2 V3 |
| `game/presentation/views/standee_body.gd` | 探针 `portrait_probe()` 扩显示读数（几何出口单点） | **行为改动**（观测面扩展，绘制零改） | V3 V4 |
| `game/presentation/views/battle_stage_view.gd` | 「48px 档」注释随动 | 非行为 | — |
| `game/probe/ui_probe.gd` | 文案随动（判据不变） | 非行为 | — |
| `game/tests/unit/presentation/standee_present_values_test.gd` | 增 V13–V16 显示档断言（复用既有套件，禁新增文件） | 新增测试 | V1–V4 |
| `tools/pixelize_candidates.py` | `STANDEE_TIER_H` → `STANDEE_DISPLAY_H`；`build_standee48` 改紧裁不降档 | 工具（非行为） | V5 |
| `tools/standee_asset_check.py` | 断言①改源高＝原稿表＋显示宽；断言②宽上限按显示宽；表名随动 | 闸件（非行为） | V5 |
| `tools/render_sample_sheet_v3.py` | 站桩 mockup 按显示档取数 | 工具（非行为） | V7 |
| `game/assets/art/character/`（9 件，不入 git） | 原稿紧裁落盘 | 资产 | V5 |
| `artwork/candidates/立绘显示档批-<日期>/`（不入 git） | 改前/改后并排对照图 | 取证 | V6 |
---
## 7. 任务卡 T0..T3
### 7.1 T0——改前读数与基线（估时 0.1 个工作日）
- [ ] 跑 `python tools/standee_asset_check.py` 记录现行 9 件读数（尺寸/档高/色数/描边占比），存实现报告改前基线表。
- [ ] 跑 `python tools/pixelize_candidates.py --standee48 --standee-out /tmp/precheck` 确认现行管线产物与盘上素材逐件同尺寸（证明 F7 降采样链在位）。
- [ ] 跑代码域闸确认改前全绿（确切命令见 §9 末注）。
**取用**：无。**产出**：改前基线读数表（T3 对照用）。
### 7.2 T1——素材按档派生落盘＋闸件同批改口径（估时 0.25 个工作日）
- [ ] `tools/pixelize_candidates.py`：`STANDEE_TIER_H` 改名 `STANDEE_DISPLAY_H`，值改显示档 `{goblin:96, giant_spider:96, duergar:96, hook_horror:144, bugbear:144, ogre_chief:188, drider:188, duergar_king:188}`，主角侧 `STANDEE_SLOT_H` 改 `144`；新增原稿高表 `STANDEE_SRC_H = {goblin:90, giant_spider:81, duergar:126, hook_horror:94, bugbear:123, ogre_chief:189, drider:189, duergar_king:189, hero:92}`。
- [ ] `build_standee48` 改紧裁不降档：内容紧裁 → 底中锚 → 原样存盘；**删除 `dom_block_resize` 调用路径**（函数与 CLI 旗标改名按档派生）；主角源由 `hero-ref/edit/*_1x.png` 改指 `*_2x.png`（canvas 94×112/96×112，紧裁后 88×92/92×92/88×92）。
- [ ] **原稿输入面显式定径**：`python tools/pixelize_candidates.py D:/code/g-plan2/artwork/remote-gen-2026-09-26 --standee-out game/assets/art/character`——worktree 的 `artwork/` 不含原稿（`sync_worktree_assets.sh:26-34` 只同步 `game/assets/art` 与 `.import`），缺省根路径在本区必**静默空跑**（缺件逐键 `isfile` 跳过、exit 0）。
- [ ] 产物计数自证：九件逐件尺寸 == `STANDEE_SRC_H` 表值，**计数 ≠ 9 即停（L3#2）**，禁回退用旧降采样稿顶替。
- [ ] `tools/standee_asset_check.py` 同批改口径（素材与闸件同批，禁中间态报红）：import 改 `STANDEE_DISPLAY_H/STANDEE_SRC_H`；断言①「源高 == 原稿表值（禁降档）」；断言②「显示宽 = round(源宽×档高/源高) ≤ 150，食人魔酋长 157 登记例外」；其余四断言（底中锚/色数≤32/alpha 二值/描边占比）不变。跑至九件全 PASS。
- [ ] 跑 `D:\code\godot\Godot_v4.7.2-stable_win64_console.exe --headless --editor --quit --path game` 刷 `.godot` 导入缓存，确认九件 `.ctex` 在位。
**取用**：T0 基线表。**产出**：九件原稿分辨率素材（盘上）＋ `STANDEE_DISPLAY_H`／`STANDEE_SRC_H` 两张 Python 表＋新口径闸。
### 7.3 T2——代码显示倍率改造（估时 0.25 个工作日）
- [ ] `standee_motion.gd` 增常量表 `PORTRAIT_DISPLAY_H`（九键字面值钉死；**禁 `.get(key, 96.0)` 类兜底字面量**——档值第二处散落即违契约 2/6）。
- [ ] `_place_portrait` 改：`key` 主角取 `"hero"`、敌取 `_owner.enemy_id()`；查无键 → `push_error` 并按 1× 落位（不崩、不静默兜档），由 V18 键集自检在测试期报警；命中 → `s = disp_h / 源高`、`scale = Vector2(s, s)`、`w/h = 源尺寸 × s`，`position` 式沿用 F2 居中溢出机制。
- [ ] `standee_body.gd` `portrait_probe()` 扩两读数：`display_size`（Vector2）、`display_scale`（float）。
- [ ] `standee_present_values_test.gd` 增私有函数 `_check_display_tier()` 承载 V13–V18（断言内写死规格值；**浮点判等一律 `is_equal_approx` 或 `absf(...)<0.01`**——0.99/1.57 档回程有 ULP 级残差，裸 `==` 会假红）。
- [ ] 注释随动：`standee_motion.gd:38-39,59,65`（旧「盒高 96=48 源整数 2×／§8.2 禁非整数缩放」已反向引用注销条款）、`battle_stage_view.gd:134`、`ui_probe.gd:140,144`、`level_map_screen.gd:176`（「定高 48px=1×」）。
- [ ] 跑 `standee_present_values_test.gd` 单件至 exit 0。
**取用**：T1 素材与 Python 表。**产出**：`PORTRAIT_DISPLAY_H`、`portrait_probe()` 两读数、V13–V18 断言。
### 7.4 T3——样张随动、对照取证、素材落递与批末收口（估时 0.25 个工作日）
- [ ] `render_sample_sheet_v3.py`：站桩段按显示档取数；A4 尺寸基线冻结断言（`:1135-1139` 锁 `PORTRAIT_SRC.size==(46,48)`）与战斗语境 96×96 方框（`:1501`）**显式解冻重校到新档**，禁放宽阈值凑绿。
- [ ] 出改前/改后并排对照图（同屏站桩区＋标题屏看台＋关卡地图头像三面）落 `artwork/candidates/立绘显示档批-<日期>/`，路径写进实现报告。
- [ ] **素材落递主工作区**：合回落地后、删区前，把九件新稿拷回 `D:/code/g-plan2/game/assets/art/character/` 并逐件复核尺寸 == 表值——素材不入 git、worktree→主区无同步通道，漏这步则主区 CI 只有 V16 一处报警、敌侧无人看守。
- [ ] 跑代码域闸全绿（§9 末注），读数与闸况写进实现报告。
- [ ] **产出物落位卡**：`reports/iter<N>-实现报告-<日期>.md`（各卡状态＋实机目检总清单：①九件清晰度含灰矮人 0.76× 判读、②同屏体量顺序、③标题屏看台与地图头像 0.52×、④酋长超宽不碰邻位、⑤主角态切换横跳读数＋遗留读数义务）／`reports/iter<N>-代拍板追认-<日期>.md`／`reports/iter<N>-反哺点-<日期>.md`（§5 每条都有落点）。
- [ ] 独立验收审计入口与报告：`reports/iter<N>-验收审计-<日期>.md`（未过不得合并）。
**取用**：T1 素材＋T2 表与探针。**产出**：闸全绿回执＋主区素材追平＋三份产出物。
---
## 8. 验证闸（改动—验收对照表）
| 需求点 | 改动（文件:行/行为） | 验收测试（名称＋落点＋尾缀） | 层级 | 真实入口 | 判据绑定面 | 能力行 |
|---|---|---|---|---|---|---|
| 逐件显示档高 | `standee_motion.gd` 新增 `PORTRAIT_DISPLAY_H` + `_place_portrait` | 「九键显示档实读 = 96/144/188 逐键钉值，且源高 == 原稿表值（旧降采样稿必红）」`standee_present_values_test.gd:_check_display_tier`〔立绘显示档 V13〕 | 单元 | `StandeeBody.new("enemy")` → `set_data(enemy_id)` → `set_portrait_texture(真纹理)` → `portrait_probe()` | `display_size.y` 与 `display_scale × 源高` 双读数 ≈ 档高（`is_equal_approx`）；九键逐一 | 新增：站桩显示档与素材分辨率绑定 |
| 硬编码 ×2 退役 | `standee_motion.gd:63-65` | 「`_place_portrait` 体内引用 `PORTRAIT_DISPLAY_H` 且零 `Vector2(2.0, 2.0)`」〔V14〕 | 单元（静态判据） | `FileAccess` 读 `res://presentation/views/standee_motion.gd` | 源锚正证（读表）＋反证（无字面 2× 倍率） | 新增：站桩显示档与素材分辨率绑定 |
| 纵横倍率恒等 | 同上 | 「`scale.x == scale.y` 且 `display_size.x == round(源宽×档高/源高)`」〔V15〕 | 单元 | 同 V13 入口 | 探针 `display_scale`/`display_size` 实读 | 新增：站桩显示档与素材分辨率绑定 |
| 主角中档 144（三态） | 素材 = 手修 2× 稿；`register_hero_state` 面 | 「主角三态纹理源高 ≥92 且显示高 = 144」〔V16〕 | 单元 | `BattleStageView` 组合根装载后 `hero_standee.portrait_probe()`，再逐态 `apply_hero_state` 复读 | 探针显示高逐态实读 | 新增：站桩显示档与素材分辨率绑定 |
| 素材不降采样 | 9 件 = 原稿紧裁；`standee_asset_check.py` 新口径 | 「源高 == 原稿表值 ＋显示宽 ≤150（酋长例外）＋色数 ≤32＋底中锚＋alpha 二值＋描边占比」 | 闸（工具） | `python tools/standee_asset_check.py` | 逐件源高/显示宽读数 == 表值 | 既有：站桩呈现定值与素材绑定 |
| 两表同值不漂移 | Python `STANDEE_DISPLAY_H` ↔ GDScript `PORTRAIT_DISPLAY_H` | 「读 `../tools/pixelize_candidates.py` 源文本逐键对账」〔V17〕 | 单元（静态判据） | `FileAccess` 读仓库内 `tools/` 件（双审对此点结论相左，见复核报告 S9） | 两表逐键相等；**读不到文件 → L2 记录、退回双端字面钉值＋独立审计对账，禁当红亦禁当绿** | 新增：站桩显示档与素材分辨率绑定 |
| 显示档表键集完整 | 同上 | 「表键集 ⊇ 八敌 ∪ hero 且无多余键」〔V18〕 | 单元 | 读 `PORTRAIT_DISPLAY_H` | 键集对账（防新敌种漏登记被 `push_error` 静默） | 新增：站桩显示档与素材分辨率绑定 |
| 样张口径随动 | `render_sample_sheet_v3.py` 站桩段 | 样张脚本自跑断言（脚本内 CHECKS 全绿）＋改前改后并排图 | 工具 | `python tools/render_sample_sheet_v3.py` | 脚本内站桩档高读数 | 既有：站桩呈现定值与素材绑定 |
| 实机观感 | 9 件显示档 + 两消费面 | 用户目检：①9 件清晰度可接受；②同屏体量顺序小<中<大；③标题屏看台与关卡地图头像无可感劣化；④酋长超宽不碰邻位 | 目检（登记不阻塞） | 实机战斗屏／标题屏／地图屏 | 目检总清单落实现报告 | 新增：站桩显示档与素材分辨率绑定 |
**测试削弱申报**：本批不删不改任何既有断言；`ui_probe` 只改文案（判据 `has_tex` 不变）；样张脚本改取数方式，其机检项断言不减。
**判据口径**：全批无变异类／撤销类取证；每行从真实入口进入、绑被测改动特有的可观测读数。
**代码域闸命令（里程碑步出口跑一次全套，波内修复只做出红件最窄确认）**：`bash tools/run_all_gates.sh --code`。
---
## 9. 异常分级
- **L1 自救**：`.import`/`.ctex` 缺位 → 重跑 `--editor --quit` 刷缓存；对照图目录不存在 → 建目录。
- **L2 记录继续**：样张脚本整屏读数偏移但四项机检仍绿 → 读数写实现报告，不返工；V17 读 `../tools/` 路径不通 → 记录后退回「双端字面钉值＋独立审计对账」，禁判红。
- **L3 停机写报告等用户**：
1. V13–V16 任一断言在真实跑批中做不出（判据绑不上）→ 停卡呈报，禁放宽阈值或换下层直调；
2. 原稿缺件（任一 `pixel-1`/手修 2× 稿不在盘）→ 停机呈报，**禁回退用旧降采样稿顶替**；
3. 食人魔酋长实机碰邻位／压到顶部轮次指示 → 停机呈报（布局重排另批）；
4. 机检预算互斥＝上游缺陷停卡退回写卡段（新增件契约与闸键冲突时禁自造第三条路）。
---
## 10. 代拍板白名单（超清单必呈报）
1. `portrait_probe()` 新读数键名（`display_size`/`display_scale` 之外的等价命名）。
2. `pixelize_candidates.py` 函数与 CLI 旗标改名措辞（`--standee48` → 按档派生类命名）。
3. 测试尾缀用词〔立绘显示档 V13〕的括注格式。
4. 对照图目录名与文件名（保持 `artwork/candidates/立绘显示档批-<日期>/` 形态）。
5. 主角取 key 的实现写法（`_owner.enemy_id()` 空值判 hero，或经 kind 判定），只要最终表键集为九键。
---
## 11. 待裁点
**零待裁点，开工门 = U0。** 三档绝对高、逐件归档、放大与超宽两项已接受，均由用户在写卡前的设计会话中裁定（凭据见 §2 与待办清单本条实况）。
---
## 12. 落位与可复用性预检
| 新增件 | 复用面（盘上是否已有同职责件） | 唯一面 | 分层与交互面 |
|---|---|---|---|
| `PORTRAIT_DISPLAY_H`（`standee_motion.gd` const） | 无同类——现行倍率是 `_place_portrait` 内字面量（F1），本表是把它从「隐式 ×2」变「显式逐件档高」；不新增文件 | 显示档在 GDScript 侧只落这一张表；绘制点只此一处读表 | 呈现层内部件，不跨层；取 key 走宿主 `StandeeBody.enemy_id()` 既有出口，禁 Core 依赖 |
| `portrait_probe()` 两读数 | 复用既有探针出口（`standee_body.gd:283`），不新建探针件 | 显示尺寸读数唯一出口 | 测试侧只读，不反向驱动绘制 |
| 测试 V13–V16 | **复用既有套件** `standee_present_values_test.gd`（能力＝站桩呈现定值与素材绑定，先例＝迭代 46 卡B 在同文件加 V10–V12）——不新增测试文件 | 一套件一能力域 | headless 无渲染面，像素采样以探针几何＋源锚承载（沿该套件既有口径） |
| `STANDEE_DISPLAY_H`／`STANDEE_SRC_H`（Python） | 改名/扩表，不新增脚本；`dom_block_resize` 保留为管线其他用途件（禁删函数本体） | Python 侧显示档只此一处，`standee_asset_check.py` 经 import 读（沿 F10 现例） | 工具侧，不进游戏运行时 |
| 9 件素材 | 复用原稿（F8），零新增绘制 | 一素材一路径，键名不变（F5 常量单点不动） | 素材不入 git（契约 7） |
---
## 13. 禁为机检文本保留无效成员
本批为呈现改造，仍立条款：若 `standee_asset_check.py` 或测试的消息文本要求保留旧键名（`STANDEE_TIER_H`／`STANDEE_SLOT_H`）凑计数或凑正则，一律停卡呈报；闸键与卡片契约互斥时禁自造第三条路，禁为过闸保留无消费方的别名。
---
## 14. 实现规范预算
- **新件三查**：本批**无新增 .gd 文件**（§12 复用面已定），三查不适用；新增常量表 1 个、探针读数 2 个，不触公开方法/var 阈值。
- **扫描面事实（双审核正）**：gdstyle 只扫 `game/core|data|presentation`（`tools/gdstyle_gate.py:49`），**tests 不在面**，`tools/gdstyle_baseline.txt` 内亦无该测试键——v1.0 所写「核该测试键登记值」属空操作，注销。
- **存量触面一查（S13 键只降不升，适用在面件）**：`standee_motion.gd`（在面）——只增一个常量表并改 `_place_portrait` 换算式，branches 不变、不产新键；`standee_body.gd:portrait_probe()`（在面）——返回字典扩两键，branches 不变。
- **测试侧纪律**：V13–V18 提私有函数 `_check_display_tier()` 承载（拆分不改语义，非凑机检）；新写测试码按 test-conventions §7 带全类型标注。
- **指标例外申报**：无。
---
## 15. 估时与切分预案
≈0.85 个工作日（T0 0.1／T1 0.25／T2 0.25／T3 0.25）。
切分预案：素材与闸件已在 T1 同批改口径（不留中间态报红窗口）；若 T3 三面对照图＋主区素材追平压超软盒，切分点＝把 T3 的「样张随动」独立成卡②，两卡同迭代合回，不拆迭代；若实机判酋长超宽碰邻位或灰矮人 0.76× 不可受，本卡止于 L3 停机／回设计段裁档，另立新条。