merge: master 同步（迭代 30/31 收尾批）——06 末尾两条目并存，冲突逐条保留

2026-10-20 18:57:42 +08:00
commit d42c8f1a7e
@@ -311,6 +311,14 @@

 **状态**：待写卡

+#### 阔视野带效果表述与类型微光口径冲突（2026-10-20 登记，来源=批次移交，设计面=工程直入）
+
+**现状**：迭代 30 卡①实现报告登记的存量冲突（报告已在这次收尾中退役，git 历史可考）：[秘宝](systems/跨局循环/秘宝.md) 普通档表「阔视野带」行一句话写作「类型微光范围 8 格→12 格」，`game/data/tables/treasure_items.tres` 该行 `desc` 同口径；但 [HUD框架](systems/表现与支撑/HUD框架.md) 迷雾节配套拍板已定「类型微光不随视野扩大（贴身 8 格、微光锚=可挖域）」，实现面微光作用集恒为 `_diggable` 子集，该件实际效果是 `light_radius_bonus` 扩灯光区（迷雾视野 8→12），不扩类型微光。两处表述属提灯功能承接时期的遗留措辞。
+
+**归属**：秘宝.md 普通档表该行 + treasure_items.tres 该行 desc（数据文本订正批；只改文字、不改机制）
+
+**状态**：待写卡（备选）
+
 #### 第二 / 三关棋盘观感——亮度与对比度（2026-10-13 登记，来源=playnote，设计面=双轨）

 **现状**：来源＝playnote 用户试玩记录「UI 优化，第二第三关的棋盘看着太累了；不知道是因为亮度还是对比度的原因，看着非常费劲，非常不舒服」。2026-10-13 用户裁定：**这是需要做的**，且本就属版本标准的覆盖范围——[08-Alpha版本标准](08-Alpha版本标准.md)「五 · 表现」已新增「棋盘观感（第二 / 三关亮度与对比度）」行，标待做。**开工前须先定性（沿用既有裁决）**：是**素材轴**问题（棋盘瓦片与格面图标本身的明度与色相），还是 **UI 轴**问题（舞台底色与叠加层的对比关系）——两轴修法完全不同，定性错了等于白改一轮；该定性要求（原备忘 (e) 项）是本条的开工前置。2026-10-16 曾编入迭代 30 卡③（UI 呈现三卡批序位③），2026-10-17 用户裁定剔除回待设计（自身挂「素材轴/UI 轴」定性人闸＋甲/乙〔recolor/远程生图重产〕素材裁点；若裁乙，其瓦片规格依赖战斗一屏样张批的目标规格清单产出）。v1.4 旧卡留 reports/需求卡片-二三关棋盘观感批-2026-10-16.md 作素材，非已写卡状态。与已完成注销的「呈现层残余 <4.5:1 文字位」分工：本条管**棋盘区域整体的观感**（亮度/对比度/费劲感，体感问题），彼条管**具体文字位的对比度读数**（机检可判硬指标），两条不同面不互相替代。
@@ -547,17 +555,6 @@

 **状态**：文档设计已闭合（design/research/需求澄清-营地交互重做-2026-10-18.md v1.0）＋待美术设计＋已写卡（reports/需求卡片-存档制数据层改造批-2026-10-18.md）＋已写卡（reports/需求卡片-主菜单三入口化批-2026-10-18.md）＋已写卡（reports/需求卡片-选档界面新建批-2026-10-18.md）＋已写卡（reports/需求卡片-营地场景图新建批-2026-10-18.md）＋已写卡（reports/需求卡片-ESC浮窗与营地顶栏批-2026-10-18.md）

-#### 代码术语刷新批——禁用词全库清扫＋flag→seal 标识符重命名（2026-10-18 登记，来源=会话提及，设计面=工程直入）
-
-**现状**：2026-10-18 用户裁定三组术语刷新（记忆 `project-terminology-rulings-20261018.md`）：①GP 是唯一正式命名，「金币」系 AI 噪音全库禁用；②「插旗」全库禁用，正式动作名=封印，「旗」概念不存在；③代码英文标识符 flag_* 全换 seal_*。另「雷格」「惩罚格」2026-10-11 已裁退役→危险格，代码域尚未执行。审计报告（`design/research/代码术语审计报告-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/ 代码域。
-
-**归属**：全工程（排雷循环/战斗循环/冒险循环/呈现层/数据表/冒烟测试均触及；主责=术语表裁定执行）
-
-**状态**：已写卡（reports/需求卡片-代码术语刷新批-2026-10-18.md）＋已编迭代 31
-
-
---
-
 #### 需求卡片入库纪律未登记——502 批遗留的悬空待办（2026-10-18 登记，来源=批次移交，设计面=反哺点）

 **现状**：2026-10-16 迭代 29 编入批（提交 `21c83f5`）认定「需求卡片写进了 roadmap 却没在 06 登记」属流程漏洞，需要补一条卡片入库纪律。该条至今在 06 清单内查无（2026-10-17 与 2026-10-18 两次全文检索零命中）。唯一记过它的地方是根目录状态文件未决面第 31 行，该文件已于 2026-10-18 用户裁废除，故改记本条防遗忘。
@@ -634,22 +631,14 @@

 **现状**：2026-10-19 用户裁定推翻「寿命域统一口径」方向（原方案五档/四档枚举、`domain` 键扩词表整体作废——作废因由=该方案隐含前提「引擎持有状态、需要字段说明它活多久」被推翻，见提案 §8），改走**效果引擎无状态化重构**：引擎零运行时状态，计数器按 round/battle/level/adventure 四桶外置、由各生命周期宿主对象持有（寿命由宿主生灭决定，不再需要寿命字段），归属用 counter_id 前缀表达（`round_`/`lvl_`/`adv_`/无前缀=battle，`meta_` 非法）＋加载期强校验。设计定值与实现设计缺口已全部闭合（提案=design/research/提案-效果引擎无状态化-2026-10-19.md，§7 定值＋§7.10 闭合）。本条目原指认的三套机制并存问题由该重构一并消解：①`domain`/`reset_at` 两字段随重构删除；②「按关重置」硬编码名单（`adventure_runner.gd:838-841`）随 level 桶宿主化消失；③`run_ledger.gd:42` 空容器早退自锁缺陷随搬运链删除自动消解（代价＝行为变更：adventure 域计数器变真跨战持久、天赋树锋/守变真每关限 2 次——削弱方向已定性，提案 §7.7/§7.8）。副产定值：`pain_layers` 名实不符归 battle、`dig_combo` 死读数随重构顺带删除（提案 §7.10.14）。

+**证据面缺口（迭代 31 卡② 移交）**：`domain=battle` 每战清零与 `domain=adventure` 跨战持久这一对判据，现无法由单元测试 rig 变异证红（`feat_vouchers_test` 的变异②只钉住事件发射时机，未覆盖寿命域）。闭合此项时须在 runner／MC 面补一次「adventure 域计数器跨战持久 vs battle 域清零」的对照读数，或在文档批确认该判据只由代码注释与装载面约束、不设机检。
+
 **归属**：architecture.md 与 game/core/effect_engine.gd（待立独立批）

 **状态**：待裁决（是否统一寿命域口径——2026-10-19 已裁：统一口径方案作废，改走无状态化重构）＋文档设计已闭合（design/research/提案-效果引擎无状态化-2026-10-19.md v1.2——2026-10-20 §7.10 闭合）＋待写卡＋已写卡（reports/需求卡片-效果引擎无状态化批-2026-10-20.md）

 ---

-#### 凭证件裁削批·代码侧迁移（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 已作废，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）＋已写卡（reports/需求卡片-凭证件裁削批-2026-10-18.md）＋已编迭代 31
-
---
-
 #### 2026-10-19 定名传导遗留二项（2026-10-19 登记，来源=会话提及，设计面=文档轨）

 **现状**：2026-10-19「系统资源／补给」定名批（`42d64ec2`／`17ef0180`）遗留两件文档面未结——①`design/gdd/systems/战斗循环/增益状态.md` 用「账／账本」指战斗内状态容器（:10「增益状态就是这本账」、:44「增益减益同账本」、:14「容器只记账」）。经用户确认它与「系统资源」**不是同一个东西**（前者是战斗内状态实例容器，后者是玩家可增减的数值容器），但用词冲突；是否改名（候选方向：容器／状态池）与连带指路句范围待用户裁。②`design/art/art-bible.md:198`（奖励金配色行「金币/宝箱/蜡封」）、`:211`（语义物件「金币=收益金」）与 `design/art/art-assets-checklist.md:105`（九家族图标名）应换代 GP，`design/registry/entities.yaml:623/:629/:637` 三处「金币」同批——均已在分支 `gpsweep-20261019`（`c5d50192`）改完但**未合回 master**，主区现值仍是旧文；合并动作归用户另会话，本批不代做。
@@ -693,3 +682,13 @@
 **归属**：design/engineering/architecture/architecture.md（架构原则节）

 **状态**：待文档设计
+
+---
+
+#### 玩家面残留禁字清扫——图例/明细/日志/字形五处（2026-10-20 登记，来源=批次移交，设计面=工程直入）
+
+**现状**：迭代 31 卡① 已把 `game/` 的金币／插旗／雷格／惩罚格／`flag` 清零，但玩家可见文本仍残留「雷／排雷／插」五处（v3.15 命名纪律：玩家面禁「雷」，危险格对外风味＝地下城陷阱／怪物巢穴）：①`legend_overlay.gd:11` 图例行「插错可左键直接挖开…危险格吃**挖雷**惩罚」；②`status_slot_row.gd:42` 与 `settlement.tres:14` 明细来源名 `"mine_hit": "踩雷"`；③`battle_log_view.gd:194` 战斗日志「本板**完美排雷**已破——归因此封印」；④`board_fx_view.gd:102` 横幅「**完美排雷** ×2」；⑤`board_view.gd:737` 已开危险格单字字形 `glyph = "雷"`。①-④ 纯文案零风险；⑤ 改字形会动 golden 基线，须同步重制 C 档基准。开发注记面（`ui_kit.gd:37` 常量名 `RED_MINE` 与其注释）属内部语，按纪律保留。
+
+**归属**：`game/presentation/` 与 `game/data/tables/settlement.tres`（走独立 worktree 批；⑤ 连带渲染基线）
+
+**状态**：待写卡
@@ -302,3 +302,19 @@
 | 3 | 出圈灭、入圈复亮 | 角色走远出 8 格圈→微光灭；走回→复亮；换图随旧图全重置 |
 | 4 | 整屏不脏 | 满圈微光同屏时棋盘不显脏、不抢焦点（焦点预算观感的人眼侧） |
 | 5 | 群伤暗档观感 | 绯红暗档 #A61D37（V=0.65 provisional）与其余四组同屏时的区分度、以及与危险红不误读的观感——读数归样张批复核 |
+
+---
+
+## ㉙ 代码术语刷新与凭证件裁削批——玩家面目检（迭代 31 卡①/卡②；能力验证半=冒烟 1151 项 0 失败＋单元 34 套全绿＋对拍 120 局真差异 0 行＋`feat_vouchers` 39 项全绿＋变异六条五红）
+
+> 卡① 是纯重命名批（行为零变化），卡② 删两件凭证、把完美保险改为专长订阅式。机检能证明词面清零、数值零漂移与验收组全绿，但玩家面「旧词是否真的不见了、贴图是否还在、豁免的实际观感」仍要人眼看。登记不阻塞（2026-10-12 真人检测立规）。
+
+| # | 目检项 | 判据 |
+|---|---|---|
+| 1 | 商店货币显示 | 商店界面货币显示「GP」，不再出现「金币」 |
+| 2 | 图例/HUD 封印文案 | 图例与 HUD 显示「封印／封印印记」，不再出现「插旗／旗」；板面单字字形现为「封」 |
+| 3 | 结算明细来源 | 结算明细来源显示「封印命中／封印未中」 |
+| 4 | 封印印记贴图三关加载 | `seal_mark.png` 在 L1/L2/L3 三关均正常加载，非字形回退态 |
+| 5 | 完美保险卡面文案 | 专长卡面文案读作「本场首次封印落空，不计入完美封印判定」，零「雷」字 |
+| 6 | 稀有档三选一 | 三选一带不再出现同调电池／完美保险；稀有档仅剩 ap／rap／time_sand 三种 |
+| 7 | 豁免后的完美第二份 | 带完美保险专长时，首次标错后清图仍能拿到「完美第二份」（订阅式豁免的实际观感） |
@@ -104,7 +104,7 @@

 惊巢反制=退役进素材库（不迁入）。

-**资源类迁出件（2026-10-18 用户裁）**：完美保险自资源类迁入专长——理由：它给的是**规则豁免**而非可调动的余量（§1.1 判据「给规则的是专长」），效果=本场首次封印落空不计入完美封印判定。旧「资源类成员」归类系 2026-10-08 框架批写入、无用户裁断支撑，随本次改判注销。专长行的触发器规格与代码实现（含效果引擎词表扩签）归独立批，见 06 登记。
+**资源类迁出件（2026-10-18 用户裁）**：完美保险自资源类迁入专长——理由：它给的是**规则豁免**而非可调动的余量（§1.1 判据「给规则的是专长」），效果=本场首次封印落空不计入完美封印判定。旧「资源类成员」归类系 2026-10-08 框架批写入、无用户裁断支撑，随本次改判注销。专长行已于迭代 31 卡② 落表（合并 `3e076e22`）：`feats.tres` 单行 `when counter(insurance_used) lt 1` 承载「本场首次」，效果类型 `forgive_seal_miss` 随引擎扩签；配额按净删重裁（rare 9→7、总量 104→102）。

 ### 扩签登记（迭代 20 实装已承载——2026-10-12 追认④写入文档换代）

@@ -231,6 +231,7 @@
 **补给类内部的异质性（统一表述）**：凭证全部即时消尽——不存在「持有凭证」这种状态；异质性不在凭证上，而在**被写入的系统资源的寿命**上：GP 钱包 / 生命 / 刷新存量 = 冒险级，储备池 = 节点级，时沙暂记 = 至下一战首轮兑付（系统资源清单对齐「凭证件表（新 3+留任 2）」节；「AP 上限」已归属性值提升轴，见 1.2）。

 - 原在册的「秘宝充能」「完美资格」两笔随 2026-10-18 两件裁削注销——`attune_charges` 账本本身仍为秘宝基础设施保留（迭代 11，主动件充能每冒险重置），本次只删奇物侧写它的入口。
+- 完美资格的豁免走**订阅式自有累加账**：授予段在 `seal_missed` 命中时累加豁免数，判定取「误标总数 − 豁免数」得有效数；**不改写误标账本身、不拦截事件**（迭代 31 卡② 契约 2/3）。
 - 登记此节防止把凭证当成会持续生效的东西去结算。

 #### 1.4 分类判据
@@ -87,7 +87,7 @@ MVP 未使用标准控件（不入库）：toggle / dropdown / input field / tab
 - 数据源：[战斗结算](../systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋)步骤流（9 类行封闭协议（现行）；公共字段 `type/source_class/origin_cell/round_index/display_name/value/highlight?`）；**无来源行 = 断言失败**
 - 行模板：「{行为} {值} → {目标}（来源）」——来源标注（第 N 轮 · 安全格式）；行文案最长 token = 来源标签（4 汉字封闭枚举），模板预留 40% 膨胀宽度
 - 聚合纪律：未生效类行（奖励未生效——现行 9 类行协议唯一未生效型，2026-09-20 收敛）按聚合计数呈现（防逐行惩罚轰炸）；衰减行聚合计数；效果行 value=单次贡献值、禁与 pool_value（池合成值）相加呈现；零值行可见不吞（免伤轮归因不断点）
- 高亮：highlight 字段 {flag_hit, clear_reward_h2, perfect_broken} → 金框强调；完美排雷 = 独立高光行 + 全屏喝彩级反馈
+- 高亮：highlight 字段 {flag_hit, clear_reward_h2, perfect_broken} → 金框强调；完美排雷 = 独立高光行 + 全屏喝彩级反馈。`perfect_broken` 的判据句读作「本板首次标错受检」，不等于完美资格已失——专长「完美保险」可在本场首次标错时豁免，实际资格按有效误标（误标总数 − 豁免数）判定
 - 布局：固定槽高 + clip_contents；正文 ≥14px；数值暗底高对比；未生效类行带 icon/划线形状冗余
 - 击杀标记呈现（H3 数据源 = 战斗结算流水击杀结果字段）

@@ -11,7 +11,7 @@
 | 安全格 | 没有惩罚的格子——挖开安全并获得其上信息与收益 |
 | 整图 | 单张棋盘（的整个范围）——原「整图」退役（2026-10-11 用户裁）。例：整图叠加层、整图作用域 |
 | 叠加层（整图叠加层） | 秘宝产生的信息的自持容器：按效果分类的格集，随图消亡、不回写棋盘（见[秘宝](systems/跨局循环/秘宝.md)） |
-| 封印 / 控制 | 封印动作的机制名/玩家名：封印印记落在危险格上为「标中」（危险格被控制、化险为利），封错为「标空」（原「旗 / 控制」，2026-10-18 用户裁：「旗」概念不存在——动作=封印、印记=封印印记） |
+| 封印 / 控制 | 封印动作的机制名/玩家名：封印印记落在危险格上为「标中」（危险格被控制、化险为利），封错为「标空」（原「旗 / 控制」，2026-10-18 用户裁：「旗」概念不存在——动作=封印、印记=封印印记）；代码契约键与标识符统一用 `seal_*`（原 `flag_*` 全族换代），板面单字字形=「封」 |
 | 真视 | 直接告诉玩家某范围内哪些格是危险格的效果（秘宝承重契约：一次最多 3×3，见[秘宝](systems/跨局循环/秘宝.md)核心规则） |
 | 类型微光 | 棋盘上按格子类型显示的提示光效（视野参数控制其显示范围） |
 | 换图 / 弃图刷新 | 清完一图进入下一图 / 花储备放弃当前图重开一张（代价见[行动经济](systems/排雷循环/行动经济.md)） |
@@ -81,6 +81,13 @@

 两类的判定与道具定义卡必答见[核心循环](01-核心循环.md)「结算目标分两类：总线与抽屉」节。

+## 战斗与效果
+
+| 术语 | 定义 |
+|---|---|
+| `seal_missed` | 封印落空事件（原 `flag_missed` 换代）：封印动作落在安全格上时发出，订阅面据此做限次与豁免判定（迭代 31 卡② 落地） |
+| `forgive_seal_miss` | 本场首次封印落空豁免——专长「完美保险」的效果类型，`domain=battle` 首例；有效误标＝误标总数 − 豁免数，豁免不改写误标账（迭代 31 卡② 落地） |
+
 ## 开发流程

 | 术语 | 定义 |
@@ -113,11 +120,12 @@

 注：「注销」仅用于清单条目办结义（销号/销账的替换词）；「结束登录状态」义仍按 STC 用「退出登录」。

-### B. 豁免条款（三类文本不改写）
+### B. 豁免条款（四类文本不改写）

 1. **历史文本**：git 提交说明、裁决记录中引用用户原话的句子——保留原用词，不按 A 表追改。
 2. **对照性文本**：「退役词对照」表本身、「原 ××」式更名记载、禁令引举句——旧词在这些位置是内容本身，不是残留。
 3. **玩家可见专名与机制词**：按「对外命名纪律」节与各系统文档现行用语使用（标中/踩雷等机制词在文档内部照常用）。
+4. **被检查的禁字不算使用**：守卫代码里作为检查对象的禁字字面量——`game/smoke/smoke_all.gd` 的 `contains("旗")` 检查项、`game/tests/unit/presentation/ui_font_asset_test.gd` 的字形集负探针、`game/data/tables/feats.tres` 头注的「desc 禁『雷/旗』字面」、`tools/doc_term_audit.py` 的退役词表定义行——不属换代范围：被检查的字不是对该字的使用，改写等于自毁守卫。术语清扫的复扫口径按 **game/ 全部文件类型、不排除任何扩展名**执行（迭代 31 卡① 实测：金币／插旗／雷格／惩罚格／`flag` 均 0 命中，残留仅为上述保留面）。

 存量口径：A 表生效前已入库的正文不做强制清扫；文件后续被批次触碰时，顺带按 A 表换代。

@@ -135,6 +143,7 @@
 | 金币 | GP（2026-10-18 用户裁：GP 是唯一正式命名，「金币」系 AI 噪音全库禁用） |
 | 插旗 | 封印（2026-10-18 用户裁：封印=正式动作名，全库统一，非比喻非「对外表达」别名） |
 | 旗（游戏概念语境） | 封印印记（2026-10-18 用户裁：「旗」概念不存在——封印动作落下的印记称封印印记） |
+| flag_*（代码契约键/标识符） | seal_*（2026-10-18 用户裁全族换代；迭代 31 卡① 已清零） |

 ## 对外命名纪律（玩家可见命名，2026-10-11 用户令）