docs(迭代31): 两卡记载改为可复现实测读数+06 凭证件条状态与设计面口径闭合

用户令:本会话不做开发,只把需求卡片与迭代 31 相关文档改对。逐条对现行代码复核后的订正:

卡① v1.4(代码术语刷新批)
- §2 总量改为可复现实测:game/ 含 flag 的文件 57 个共 617 处,剔除 size_flags_* 70 处(19 个文件,v1.3 只记 ui_assembler 一个)与 _fatal_flag 4 处后净待改 543 处/42 个文件;原记 ~314 处/29 文件低估约一倍、文件数少记 24 个,并附复现命令
- §2 逐文件表按净命中重排 13 行;N2 中文表改实测(金币 39/插旗 62/雷格 75/惩罚格 1/旗含复合 376 处——原记 ~15 严重低估);插旗 top3 文件误记订正
- 补三处真实漏项:FACTS 两键全链(flags_count→seals_count 三处、dug_under_flag→dug_under_seal 十一处,含 effect_words_t1_test 断言)入 §3 新契约与 T3.1;ui_click_probe 净 21 处(原只记注释 3 处);T5.20–T5.24 补五个卡片完全未列的文件(screen_flow_probe 8 处等)
- ui_assembler.gd:203 注释「min/flags」改判为须改写(非豁免项),否则 V1 零命中判据永远红一项;估时 ≈3.75d 未自改,标注按旧读数定、上调与否归编排段/用户

卡② v1.1 补订:EFFECT_KINDS 现 31 项(原记 30,本卡 T4 扩签后 32);其余 §2 全部行号与 rare 配额构成(ap3+rap2+battery1+时沙2+保险1=9→7)逐条实测核对无误

06-待办清单
- 「凭证件裁削批·代码侧迁移」:设计面 工程直入→文档轨;状态 待写卡→文档设计已闭合(奇物.md v3.18)+已写卡(卡片路径)+已编迭代 31;现状句「候选名 forgive_flag_miss,命名待用户定」改为已裁 forgive_seal_miss
- 「代码术语刷新批」:现状句 game/ 读数改实测值,并注明审计报告读数属全库/代码域混记、两种口径均不可复现

验证:流水线闸 PASS(06 条目 60·总表 31 行·交叉核 1→2 链·卡片口径 21 张);文档域全闸与基线一致、无新增红。
This commit is contained in:
DKChan committed 2026-10-18 20:18:33 +08:00
1 parent 76868d7228
commit 929b74ac43
3 files changed
+47 -31

No files matched your search

+4 -4
View File
@@ -543,7 +543,7 @@
#### 代码术语刷新批——禁用词全库清扫+flag→seal 标识符重命名(2026-10-18 登记,来源=会话提及,设计面=工程直入)
**现状**:2026-10-18 用户裁定三组术语刷新(记忆 `project-terminology-rulings-20261018.md`):①GP 是唯一正式命名,「金币」系 AI 噪音全库禁用;②「插旗」全库禁用,正式动作名=封印,「旗」概念不存在;③代码英文标识符 flag_* 全换 seal_*。另「雷格」「惩罚格」2026-10-11 已裁退役→危险格,代码域尚未执行。审计报告(`design/qa/代码术语审计报告-2026-10-18.md`)实查:game/ 目录命中约 757 处(flag_ 标识符 314 处/29 个 .gd+4 个 .tres;中文禁用词 金币 116 处/插旗 210 处/雷格 109 处),涉及核心逻辑(minesweeper_rules.gd、battle_orchestrator.gd、grant_segment.gd)、数据表(feats.tres、settlement.tres、action_economy.tres、reward.tres)、呈现层(board_view.gd、shop_overlay_view.gd、legend_overlay.gd)与冒烟测试(smoke_all.gd 单文件 105 处 flag_)。文档面(design/)由另批处理,本条只覆盖 game/ 代码域。
**现状**:2026-10-18 用户裁定三组术语刷新(记忆 `project-terminology-rulings-20261018.md`):①GP 是唯一正式命名,「金币」系 AI 噪音全库禁用;②「插旗」全库禁用,正式动作名=封印,「旗」概念不存在;③代码英文标识符 flag_* 全换 seal_*。另「雷格」「惩罚格」2026-10-11 已裁退役→危险格,代码域尚未执行。审计报告(`design/qa/代码术语审计报告-2026-10-18.md`)实查:game/ 代码域实测读数(2026-10-18 需求卡片 v1.4 复核;口径=区分大小写逐处计数,命令见卡片 §2):含 `flag` 的文件 57 个(.gd 53 + .tres 4)共 617 处,剔除 `size_flags_*` 70 处(19 个文件)与 `_fatal_flag` 4 处后**净待改 543 处/42 个文件**;中文禁用词 金币 39 处、插旗 62 处、雷格 75 处、惩罚格 1 处、「旗」含复合词共 376 处。涉及核心逻辑(minesweeper_rules.gd 净 59、battle_orchestrator.gd 33、grant_segment.gd 38)、数据表(feats.tres 15、settlement.tres、action_economy.tres、reward.tres、treasure_items.tres)、呈现层(board_view.gd 23、battle_end_overlay.gd 11、shop_overlay_view.gd、legend_overlay.gd)与冒烟测试(smoke_all.gd 单文件净 156 处=全集 29%)。订正说明:审计报告原记「game/ 约 757 处(flag_ 314 处/29 个 .gd;金币 116/插旗 210/雷格 109)」在现行代码上两种口径都复现不出:中文三词的读数属全库面(全库实测 金币 381/插旗 600/雷格 394 处),与本条的 game/ 范围混记;flag 侧则低估约一倍。逐文件读数以需求卡片 §2 为准。文档面(design/)由另批处理,本条只覆盖 game/ 代码域。
**归属**:全工程(排雷循环/战斗循环/冒险循环/呈现层/数据表/冒烟测试均触及;主责=术语表裁定执行)
@@ -622,13 +622,13 @@
---
#### 凭证件裁削批·代码侧迁移(2026-10-18 登记,来源=会话提及,设计面=工程直入)
#### 凭证件裁削批·代码侧迁移(2026-10-18 登记,来源=会话提及,设计面=文档轨)
**现状**:GDD 侧已随 2026-10-18 文档批定稿(见 `奇物.md` v3.18),**代码零改动**。待做五件事——①`CURIO_KINDS` 移除 attune_battery/perfect_insurance 两枚及配套配额字段、件值字段、分发表分支;②`TIER_QUOTAS` rare 9→7、总量 104→102(**结构锚须重裁**——用户已裁「净删」,不接受转给别件;连带 rare 档品种 5→3,仅剩 ap/rap/time_sand);③`adventure_runner.gd` 清 `_pending_insurance`/`_battery_pending`/`choose_battery_target`/`battery_pending()`/断点存档键(🔴 `run_ledger.attune_charges` 账本与 `_seed_attune_charges` **禁删**——迭代 11 秘宝基础设施);④`feats.tres` 增完美保险行(rarity 取 rare、desc=「本场首次封印落空,不计入完美封印判定」、triggers 走 on=flag_missed + 每战限次),前置依赖**效果引擎 `EFFECT_KINDS` 扩签一种**(该行将成为 feats.tres 首例 `domain=battle`;候选名 forgive_flag_miss,命名待用户定);⑤`grant_segment.gd` 硬编码 `_fx_insurance` 改订阅式——**按用户指定做法**:新增自有累加计数,判定时取「误标总数 − 豁免数」得有效数,**不改写既有 `_perfect_hit_false`、不拦截事件**(原方案的回退式与拦截式均已否决)。测试面 `feat_vouchers_test.gd` V9/V16 同步。玩家面术语统一用「完美封印」、不用「完美排雷」(命名纪律见奇物.md v3.15)。
**现状**:GDD 侧已随 2026-10-18 文档批定稿(见 `奇物.md` v3.18),**代码零改动**。待做五件事——①`CURIO_KINDS` 移除 attune_battery/perfect_insurance 两枚及配套配额字段、件值字段、分发表分支;②`TIER_QUOTAS` rare 9→7、总量 104→102(**结构锚须重裁**——用户已裁「净删」,不接受转给别件;连带 rare 档品种 5→3,仅剩 ap/rap/time_sand);③`adventure_runner.gd` 清 `_pending_insurance`/`_battery_pending`/`choose_battery_target`/`battery_pending()`/断点存档键(🔴 `run_ledger.attune_charges` 账本与 `_seed_attune_charges` **禁删**——迭代 11 秘宝基础设施);④`feats.tres` 增完美保险行(rarity 取 rare、desc=「本场首次封印落空,不计入完美封印判定」、triggers 走 on=flag_missed + 每战限次),前置依赖**效果引擎 `EFFECT_KINDS` 扩签一种**(该行将成为 feats.tres 首例 `domain=battle`;候选名 forgive_flag_miss 已作废,2026-10-18 用户补裁效果类型名=**forgive_seal_miss**(随卡① flag→seal 命名接续,见需求卡片 v1.1 顶部通则);⑤`grant_segment.gd` 硬编码 `_fx_insurance` 改订阅式——**按用户指定做法**:新增自有累加计数,判定时取「误标总数 − 豁免数」得有效数,**不改写既有 `_perfect_hit_false`、不拦截事件**(原方案的回退式与拦截式均已否决)。测试面 `feat_vouchers_test.gd` V9/V16 同步。玩家面术语统一用「完美封印」、不用「完美排雷」(命名纪律见奇物.md v3.15)。
**归属**:game/ 代码与数据表(走独立 worktree 批)
**状态**:待写卡
**状态**:文档设计已闭合(design/gdd/systems/冒险循环/奇物.md v3.18)+已写卡(design/research/需求卡片-凭证件裁削批-2026-10-18.md)+已编迭代 31
---