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

秘宝批T9-T10收口：出口报告落design/qa+07清单⑬两条人工项（秘宝UI目检+渲染五闸补跑挂账）+roadmap卡③✅落地标注

Browse Source
This commit is contained in:
DKChan committed 2026-10-05 08:53:07 +08:00
1 parent 8c272130fb
commit d2ab5073d7
3 files changed
+87 -1
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

design/gdd/07-体验验证清单.md
+5
View File
@@ -127,6 +127,11 @@
- **红灯信号**：标旗 rush 复发（首轮全标旗不挖——δ 与完美排雷 ×2 叠加通胀是既有联动面：旗溢价三件套 δ↔p_perfect↔ap_per_round 同窗检算，难度曲线与Boss 调参联动表在册）。
- **结论回流**：体感 → 本条目记录；数值终值（δ 值与 ×1.5 档留后手）归调参批，不在试玩现场改数。**判式换代文本（行动经济 F1 条款3/战斗结算 验收标准/难度曲线与Boss 联动表三处修订稿）随批呈用户人闸**——追认单随出口报告。
### ⑬ 秘宝词族换词全 UI 面目检 + 渲染像素闸补跑（2026-10-05 秘宝代码词族对齐批随批登记——迭代15③号卡）
- **实机目检（「秘宝」字样全 UI 面，约 3 分钟）**：①C 区槽位标题应显示「秘宝」（原「魔法道具」，hero_info_panel_view 槽位组）；②空槽悬停提示应显示「秘宝槽（空）」；③战斗总结三选一叙述行应显示「秘宝 / …」或「秘宝 / 随机获得一件」（原「魔法道具」开头）；④换关 toast 应显示「上关剩余 N 件秘宝已随关卡结束清空」。**红灯信号**：任何界面残留「魔法道具」字样。
- **渲染像素类闸补跑挂账**：本批屏蔽五件（golden_compare / shot_probe / fx_probe / ui_layout_probe / board_shot——组 A 文案变更使像素断言合法失效，按 goal 令弃断）；**补跑时点=迭代 14 全落籍后的表现批周期闸一次性补跑**，与本批无独立补跑义务；届时若 golden 基线因文案换代失效，按换代流程重锚而非当缺陷修。
## 验收读数重测义务（履行留痕 + 现行义务）
**已履行**（按序换代，旧读数各随其批作废留痕不入本单）：①验收读数重测批（2026-09-19——Boss 单独出列/承伤带/通关率基线全量重测，硬化翻倍期·乏力死效果期·充能期旧读数作废）；②迭代 5 基线重测（统一随机流后 MC+verifier 双窗）；③**数值修复批新尺重测（2026-10-01）**——模拟档位重构后全量重测，新锚 `sim-data/runsum_numfix_final_n200_20261001.jsonl`，全旧带作废只测不判（[numfix 报告](../qa/numfix-newruler-readings-2026-10-01.md)）；④**迭代 10 奖励重构批重锚（2026-10-01）**——四代锚 77000/78000/79000/80000（改前/重构后/共享池后/掷定前置后，各 400 局），普通 L1 41.8%/L2 10.2% 带内（[读数报告](../qa/m3-iter10-clear-rate-readings-2026-10-01.md)）；⑤**T19 真人标定局收口（2026-10-03 用户裁）**——有效局 2（1 通关 1 死于 L3 首战，[读数报告](../qa/t19-real-playtest-readings-2026-10-02.md)），用户裁定**佐证级收口不再补局**；k 预期带同日立（**正常 >0.5、预警 <0.3**），字段随 81000 重锚入库后补算终值。
design/qa/iter15-3-mibao-exit-report-2026-10-05.md
+81
View File
@@ -0,0 +1,81 @@
# 出口报告：迭代 15 卡③ 秘宝代码词族对齐批（2026-10-05）
> 任务书 = `design/research/任务书-秘宝代码词族对齐批-2026-10-05.md` v1.2（§1.2 基线已回填）。
> 设计事实源 = `design/gdd/systems/排雷循环/秘宝.md` v0.9。worktree = `g-plan2-m4iter15-mibao`，分支 `m4iter15-mibao-20261005`。
## 一、提交链（worktree 八笔）
| # | 提交 | 内容 |
|---|---|---|
| 1 | b4b8bb3 | T1 组A+D：玩家可见文案 5 处 + 注释层「魔法道具」→「秘宝」全清（敌方语汇/道具工坊分色保全） |
| 2 | dfd5fdd | T2 组C：architecture.md 两处既有断链清偿 |
| 3 | 5294b12 | T3 组F：`"aux_item"` 域串 16 处 → `"treasure_item"` + `TREASURE_ITEM_TYPE` 常量族 + `reward_dangling_treasure` 诊断码 |
| 4 | 2532c8f | T4 组B-1：四文件改名（treasure_items.gd / treasure_item_table.gd / treasure_items.tres / treasure_interact_controller.gd）+ 类名 + .uid 稳定 + .tres ext_resource 同步 + --import 重刷 |
| 5 | 7e5b6d9 | T5 组B-2：ConfigDB 注册键/持有变量/五访问器 + 调用方 + 单测桩表 + loaded 取键 |
| 6 | f8c6db4 | T6 组E-1：三测试文件改名 + run_all 登记 + test_kit 注释同步 |
| 7 | cd73e62 | T7 组E-2：内部标识符全族换词（60+ token）+ 存档键零触碰专项核 + 任务书 §1.2 基线回填 |
| 8 | 8c27213 | T8：tests 文档两处清零 + 奇物.md 换名断链补修 + 批末闸认证 |
主区合并提交与全量复跑读数见台账（active.md 快照行）。
## 二、批末读数（批末树态 8c27213 实跑）
| 闸 | 基线（3c4291d 实跑） | 批末 | 判定 |
|---|---|---|---|
| 冒烟 smoke_all | 755 项 / 0 失败 | **755 项 / 0 失败** | ✅ 零漂移 |
| run_all 15 套件 | 14/15（唯一红 reward_overlay_test = **②批遗留基线红**，主区 3c4291d 同样红，非本批引入） | **14/15，唯一红同款** | ✅ 对照零新增 |
| 行为探针 ui_probe / ui_click / ui_input / ui_tune | 全绿 | **全绿**（click done=true 问题=0 / input 十六断言 / tune 全链） | ✅ |
| doc 三闸（lint/term/link） | lint 8 文件 2 不通过（既有）/ term 218 命中 3 疑似 / link 死链 0（主区带脏件口径） | 同基线 | ✅ 零新增 |
| 熵增闸 repo_structure_audit | PASS | PASS | ✅ |
| MC 逐位对拍 | —— | **未跑（goal 令：纯改名零数值面禁跑 MC，静态零漂移证明代之，见 §四-12）** | ✅ 按令豁免 |
**渲染像素类闸本批屏蔽**（golden_compare / shot_probe / fx_probe / ui_layout_probe / board_shot）——组 A 文案变更使像素断言合法失效，按 goal 令弃断；**补跑挂账 07 清单**（迭代 14 全落籍后表现批周期闸一次性补跑）。
## 三、批末验收断言（12 条）
1. **词族换尽**：`aux_`/`AuxItem*`/`AUX_ITEM*` 批末全仓 game/ 残留 43 处，**逐处归例外**（§五清单），零在族欠改。
2. **玩家可见清零**：`grep 魔法道具 game/` = 1 处（`game/README.md:538`，§4.4 禁改项·历史 changelog 留痕，非玩家可见面）——代码与 UI 面零命中。tests/README.md 与 critical-paths.md 两处已随批清零。
3. **重闸全绿**：冒烟 755/0（§二）；run_all 零新增；四探针全绿；doc 三闸+熵增闸零新增。
4. **存档兼容零破坏（R1）**：本批 diff 全部 37 文件、六存档键（`bonus_aux_carry`/`aux_items`/`aux_detail`/`aux_cleared`/`aux_cleared_last`/`attunement_charges`）引号字面量 HEAD↔批末**逐键普查零差异**；点号访问形式全仓代码行**零存在**（仅注释提及）；`_node_bonus_pending` 持久化嵌套键全部引号形态未动。
5. **数值零漂移（R2）**：静态证明——批 diff `game/data/tables/` 数值行零改动（断言空）；`magnitude`/`weight`/`power`/`charge_n` 零触碰；reward.tres 零改动。
6. **schema 契约面零变更（R3）**：`CELL_TYPES.size()==10` 保持（改字面量不改项数）；`smoke_all.gd:3932` 断言同步为 `has("treasure_item")` 后全绿；校验行为不变，错误消息文案可变（`reward_dangling_treasure` 诊断码随族改，测试双端同步）。
7. **零字段更名（R4）**：`item_id`/`effect_kinds`/`form`/`slot_cost` 原样；treasure_items.tres 仅改 `script_class` 与 `ext_resource` 路径。
8. **零 await（R5）**：批 diff core/ 新增 await 行数 = 0。
9. **冒烟夹具零触碰**：smoke_all.gd 断点夹具区（:4473/:4495 `"aux_items"`/`"aux_scout"`）diff 零改动。
10. **敌方语汇保全**：`魔法矢`/`魔法反噬`/`魔法族`/`魔法护甲` 12 处未动；`道具工坊` 8 处未动；`arch_names["magic"]` 未动。
11. **.uid/.tscn 纪律**：四个改名 .gd 的 .uid 随文件改名且内容零变（git R100）；全仓 .tscn 对改名目标零引用（改前已核）；--import 批内重刷两次（T0 基线 + T4 改名后），类名解析实证=冒烟加载 TreasureItemTable 零报错。
12. **registry 条目键不动**：`design/registry/entities.yaml` 零改动（条目键 `aux_items` 数据契约键沿用）。
## 四、缺陷与自修记录（全 L1 级，均当轮闭环）
1. **T3**：任务书 §4.3 的 16 处清单漏计 `AUX_ITEM_TYPE` 常量消费方 4 处（cross_validator×2 / reward_economy / smoke:2578）——冒烟 SCRIPT ERROR 抓到，自查补齐，一次重试绿。
2. **T4→T5**：`treasure_items.gd:117` 桩回退行 `_db.aux_items.` 漏随族改 → run_all `treasure_items_test` 红 → 补修转绿。
3. **T8**：`grep 魔法道具 game/` 在 .gd/.tres 口径外余 3 处文档件——tests/ 两处随批清零；README.md 一处按 §4.4 保留（见 §五-4）。
## 五、例外清单（批末仍在族字面量穷举，共 43+2 处）
| 类 | 量 | 明细 |
|---|---|---|
| 存档键引号字面量 | 43 | `aux_detail`×30 · `aux_items`×11（断点快照键+冒烟夹具键）· `aux_cleared`×10·`aux_cleared_last`×1（含信号文档注释提及）· `bonus_aux_carry`×3 · `attunement_charges`×2 |
| 冒烟夹具数据值 | 2 | smoke_all.gd `:4473/:4496` `"aux_scout"`（断点快照夹具 item_id，整块零触碰） |
| game/README.md §4.4 禁改项 | 1 | `:538` 历史 changelog 行文（§1.2 判定 2 唯一余量，非玩家可见） |
| registry 条目键 | 库外 | `design/registry/entities.yaml` `aux_items` 条目键沿用（数据契约） |
| 裸词 `aux`/`attunement_*` | 库外 | 裸 `aux` 局部变量与注释词（无 `aux_` 族 token 形态，出口 grep 族外）；`attunement_*` 系同调位 DND 机制名（秘宝.md v0.9 明令保留） |
## 六、代拍板追认单（白名单内 5 项，请追认）
1. **词根选型 `treasure_*` 全族**：`treasure_item`（域串）/`treasure_items`（表+注册键+变量）/`TreasureItemTable`/`TreasureItems`/`treasure_items.tres`/`treasure_item_table.gd`/`treasure_items.gd`/`treasure_interact_controller.gd`。依据：任务书组 B 预设建议词根 + 全仓 `treasure` 零冲突（局内奇物 `curio_*`/`feat_*` 无碰撞）。
2. **诊断码 `reward_dangling_aux` → `reward_dangling_treasure`**（config_db_cross_validator + 测试双端）。依据：§4.0 判据（指向秘宝概念）、R3 文案可变行为不变。
3. **`aux_unlocked` params 键族改 `treasure_unlocked`**（main/adventure_runner/smoke/breakpoint_resume_test 四端同步）。依据：已核实该键=main.gd 现场构造的进程内 params 键，**不入任何存档**（§4.1 判据只锁跨局持久化键）。
4. **呈现与结算 token 全族**：`aux_inventory→treasure_inventory`、`aux_mark→treasure_mark`、`_aux_reveal/_aux_preview→_treasure_*`、`aux_slot_clicked→treasure_slot_clicked`、`set_aux_inventory/set_aux_overlays→set_treasure_*`、`use_aux→use_treasure`、`aux_replace_presented→treasure_replace_presented`、`aux_replace`（autoplay 事件日志键）→`treasure_replace`、`_aux→_treasure_ui`、`AuxInteractController→TreasureInteractController` 等。依据：§4.0 判据+白名单词形自由。
5. **三处注释/错误文案换词**：meta_table.gd:88 校验错误消息（「出域秘宝六件词表」）、treasure_items.gd/treasure_item_table.gd 头注 registry 键提及换「秘宝条目（键 aux_items 沿用）」、treasure_interact_controller:11 注释类名引用同步。依据：R3 文案可变。
**非代拍、按硬边界执行**：`game/README.md:538` 未改（§4.4 明令 + 换名先例「历史留痕原样保留」）——若你要它也清零，一句话即补。
## 七、挂账与移交
1. **渲染像素类闸补跑**（已挂 07 清单）：迭代 14 全落籍后表现批周期闸一次性补跑五件。
2. **实机目检**（已挂 07 清单）：「秘宝」字样全 UI 面——C 区槽位标题+悬停 tooltip+战斗总结叙述行+上关清空 toast。
3. **reward_overlay_test 基线红**：②批遗留（选择态三卡 btns=0），本批未触碰其域，**归属 ②批收口方处置**；读数已录本报告 §二。
4. **存档键正式迁移**（②批待裁点）：本批未动任何键名，②批若启动迁移与本批无冲突（键字面量=本批保护面）。
5. 并行协调：merge 前停机点履行情况见台账。