docs(iter30-fb): 迭代 30 卡① 文档批——代拍板七项追认＋反哺点七条回写

用户令「追认没有问题;反哺点可以都进行回写」两项一波走完（文档批，
不占迭代号，分支 iter30-fb-20261017，基于 master 0a164958）。

追认：
- reports/iter30-代拍板追认单-2026-10-17.md 文末加追认结果行——§9
  白名单 7 项全部同意。

反哺点七条全部回写：
- 06-待办清单：徽章条状态待办→已完成（入库 7ffd1dc0、冒烟 1151/0、
  单测 34 套、探针 case⑰、07 ㉘ 人闸五项）；色相措辞修正为「样张
  v2 冻结既裁值，本批只动明度」；2026-10-05 实查读数刷新
  （bonus_pick_overlay.gd 已改名 curio_pick_overlay.gd:97、TG_* 五族
  在役 ui_kit.gd:49-53、裸 Color8 读数作废）；新增「卡顶色带与格面
  微光两带统一」待办条（Q3 甲案）。
- HUD框架：实装状态行转「已实装（迭代 30 卡① 2026-10-17 入库，
  合并 7ffd1dc0）」；验收行转正式验收；版本历史 v0.19；口径史注记
  后补两带分工注记（卡顶带=条目级静态色带／格面微光=棋盘格内动态
  微光，禁互为引用）。
- 08-Alpha版本标准：「五 · 表现」表新增「未开格类型微光（五组色相＋
  明度档）」行（在役；明度档 provisional 值，样张批复核转正）；
  版本历史 v1.9；文头状态行 v1.8→v1.9。
- art-bible：五组明度档 provisional 值（芥末黄 #F7DF43／黄绿 #68D042／
  青 #30A6A6／紫罗兰 #7B5BD6／绯红 #A61D37＝冻结 #FF2D55 的 V=0.65
  档，五组 ΔH ≤0.13° 色相零移动）＋生成口径（渲染合成空间伽马阶梯、
  相邻组模型 CR 1.245/1.234/1.239/1.270、判据线 1.20、实测最弱对
  1.232、群伤暗档停机呈报留痕）落版本历史 v3.15；§4.2/§4.6.3 权威面
  零改动、§2.1 未追加（Q5 甲案静态）；头注「现行为」v3.11→v3.15
  漏更订正。
- roadmap：迭代进度行、近期主战场行与迭代 30 表行状态列同步卡①已
  入库（②③待 /iter 发令）。
- 07-体验验证清单：新增 ㉘ 节五项人闸（五组一眼可分／不遮数字
  〔环不外溢〕／出圈灭入圈复亮／整屏不脏／群伤暗档 #A61D37 观感
  〔provisional，读数归样张批〕）；版本历史 v1.5。
- reports/iter30-反哺点-2026-10-17.md 加「回写结果」节逐条标已回写。
- active.md：快照「更新于」行追加文档批从句；未决面待用户追认行补
  iter30 七项已同意；追加状态记录 511。

验收：文档域闸 tools/run_all_gates.sh --docs 五闸（06 gdd_lint／07
doc_link／08 doc_term／08b active.md 体量／10 熵增）全绿，闸况与
基线一致无新增红，回执 commit=分支尖。

遗留：卡②③待 /iter 发令；07 ㉘ 实机目检五项待用户过目；群伤暗档
provisional 待样张批转正；g-plan2-iter30-fb 工作区待合回后清理。

active.md

@@ -16,7 +16,7 @@
 - **工程路线图**：根目录 `roadmap.md`（里程碑时间线的权威；实时状态看下方快照节）
 
 ## 当前状态快照（收口批先更新本节，再追加状态记录；≤10 行）
-- **更新于**：2026-10-17（**迭代 30 卡① 未开格类型徽章批已合并**——代码实现批走 worktree `g-plan2-iter30-glow`／分支 `iter30-glow-20261017`，五提交合并 `7ffd1dc0`：五组微光实装（shader 主路径＋ui_kit 色板单点）＋断言三件（冒烟 1127→1151、单测 33→34 套件、探针 case⑰）＋渲染双帧取证＋`reports/` 三份产出物；群伤组色值经契约 5 停机呈报用户裁「换更暗档 #A61D37」（冻结绯红 V=0.65 档、色相零移动）；代码域重闸零新增红（09 由基线红转绿）。此前同日已合并迭代 29 批 `fff4f120`、闸按域分跑批 `60c25ca3`、GDD 反哺写入批 `bd6ab32e`，M4 数值批已废归 06 待裁）。
+- **更新于**：2026-10-17（**迭代 30 卡① 未开格类型徽章批已合并**——代码实现批走 worktree `g-plan2-iter30-glow`／分支 `iter30-glow-20261017`，五提交合并 `7ffd1dc0`：五组微光实装（shader 主路径＋ui_kit 色板单点）＋断言三件（冒烟 1127→1151、单测 33→34 套件、探针 case⑰）＋渲染双帧取证＋`reports/` 三份产出物；群伤组色值经契约 5 停机呈报用户裁「换更暗档 #A61D37」（冻结绯红 V=0.65 档、色相零移动）；代码域重闸零新增红（09 由基线红转绿）。此前同日已合并迭代 29 批 `fff4f120`、闸按域分跑批 `60c25ca3`、GDD 反哺写入批 `bd6ab32e`，M4 数值批已废归 06 待裁）。**同日文档批**（`iter30-fb-20261017`）：卡①代拍板七项追认通过（用户令「追认没有问题」）、反哺点七条全部回写（06/HUD框架/08/art-bible/roadmap/07 六文件＋两份 reports 批注），`--docs` 域闸零新增红。
 - **最新闸态**：重闸唯一入口 `tools/run_all_gates.sh` 按改动域分跑（代码域 01 冒烟／02 单元／03-04 探针／05 渲染／09 静态扫描／10 熵增／11 对拍，文档域 06 gdd_lint／07 doc_link／08 doc_term／08b active.md 体量／10 熵增；**域划分只在该脚本定义一处，文档禁止另列闸清单**）。文档域末次回执 commit=`3f9ec7c5`，五闸全绿零存量红。代码域末次实测读数（2026-10-17 迭代 30 卡①合并态，回执 commit=`7ffd1dc0`）：冒烟 1151/0、单元 34 套件（type_glow_test 51 检查）、探针十八断言、渲染 golden 棋盘×3（0.13/0.11/0.10%）与菜单（0.14%）均在容差内、static_scan 相对基线「改善」（基线红→现绿）；**11 号闸 parity 是条件闸件，本批判未触面（diff 未触数值/存档/RNG/结算面）SKIP**，迭代 29 批判为触面、须 `PARITY_APPROVED=1` 才发起，MC 未跑。
 - **迭代 28 交付**：修好启动时菜单被冒险层盖住的装配顺序，层序收敛为唯一装配合同（散落的两处 `move_child` 删除）；boot 链路、九阶段生命周期、启动态菜单 golden 三组验收补全；本批新立硬规则「验收函数无变异红记录不算验收成立」，三处规约落文。
 - **迭代 27 交付**：三屏壳场景与局态物化、结算五段拆分、RunLedger 单类持四账、模态编排类、类型闸、死代码退役，编排器由 1725 行降到 1325 行。
@@ -29,7 +29,7 @@
 ## 未决面（进行中/待人闸/待裁点指针；现行事实源登记处=`design/gdd/06-待办清单.md`）
 - 待用户裁决（06 在册）：美术审计两项 P0（art-bible 死样张指涉、主角像素管线重产）；去毒残留词是否清扫（「魔法道具」约 30 处、「罕见」约 18 处）；喂雷流 R5 甲重启条件回落文；「通关」与「通过第 N 关」全库口径统一（约 273 处）；**贫矿脉屏蔽的设计语义面反哺五处**（地形变异.md §全局作用域型／HUD 框架三层预告／教学引导手册行／难度曲线与Boss 两行／art-bible §4.6.3 括注——均描述已撤回功能，待裁是否改写，机械面已同步）。
 - 待登记 06：需求卡片入库纪律一条（502 批遗留，2026-10-17 在 06 清单内查无该条，属悬空待办）。
-- 待用户追认：仅剩 req-card 技能的 WorkBuddy 与 ZCode 两份副本是否取齐一项。迭代 27 代拍板十五项、迭代 28 十三项（含四条白名单外）、迭代 29 十二项已于 2026-10-17 用户令「追认单的所有我都是同意的」全部同意，三份实现报告（2026-10-17 文档批已迁位 `reports/`）的追认单节已就地标注追认结果；迭代 29 第四节「经你裁决的四项」不在追认范围（当时已问过已答）。
+- 待用户追认：仅剩 req-card 技能的 WorkBuddy 与 ZCode 两份副本是否取齐一项。迭代 27 代拍板十五项、迭代 28 十三项（含四条白名单外）、迭代 29 十二项、迭代 30 卡① 七项已于 2026-10-17 用户令全部同意（iter30 追认令原文「追认没有问题」，追认结果行已加在该批追认单），四份实现报告（2026-10-17 文档批已迁位 `reports/`）的追认单节已就地标注追认结果；迭代 29 第四节「经你裁决的四项」不在追认范围（当时已问过已答）。
 - 待发令：**迭代 30 UI 呈现三卡批·卡②战斗一屏样张批与卡③二三关棋盘观感批**（卡①已合并 `7ffd1dc0`；②③卡片=`design/research/需求卡片-战斗一屏样张批-2026-10-16.md`／`design/research/需求卡片-二三关棋盘观感批-2026-10-16.md`，v1.2 零待裁残留，②不适用卡①的 U1 预授权并留分类结论注，③有 Q2 判据自动裁/目标带批内自定/L3 分类预授权；两批合计 ≈7.5–10.5d，逐个 `/iter` 发令）；迭代 27/28 预留追加卡；黑话清扫第二波（GDD 正文流程动词族约三千处）；规则文件编写 skill（按规则文件审计与目录划分批的工作流提炼，见提交 `81c0ee2b`）。
 - 待批准发起：**11 号闸 parity 回放确定性对拍**（迭代 29 把它收编为重闸里的条件闸件，每次跑批只做触面判定、不自动跑；迭代 29 批已判触面并挂 NEED-APPROVAL，批准方式＝带 `PARITY_APPROVED=1` 发起，MC 须用户批准才跑）。
 - 在途分支未合并 master（读现状时勿当已入库）：`art-standee-20261006`（worktree `g-plan2-standee-tier`，领先 5 笔——artwork 独立仓 dry-run 报告＋立绘定档）、`doc-adr-fixes-20261014`（worktree `g-plan2-doc-adr-fixes`，领先 5 笔，**方向已废**——ADR 四节重建/修订注记与用户「ADR 不需要保存」裁定相反，分支与 worktree 去留待裁）。已合并的 worktree/分支清理（2026-10-17 用户令执行）：`g-plan2-iter29-testlayers`、`g-plan2-menusub-20261016` 两工作区与分支 `adr-purge-20261015`、`adr-leak-fix-20261016` 已删；`ci-removal-20261015` 已按 2026-10-16 既裁重做（只删 `.github/workflows/tests.yml`、撤 ADR 两条）合并 `db032fb5` 后工作区与分支同删；**在盘待删**：`g-plan2-carddoc-20261017`（分支 `carddoc-20261017` 已合并 `480d8118`）、`g-plan2-iter30-glow`（分支 `iter30-glow-20261017` 已合并 `7ffd1dc0`）两工作区，删除待令。
@@ -55,3 +55,5 @@
 - **509（2026-10-17，GDD 反哺点写入批——迭代 27/28/29 八条＋一条建议逐点裁决）**：用户裁「全部按推荐案执行」（文档批，不占迭代号，worktree `g-plan2-gddfb-20261017`）。写入面：①**architecture.md v1.7→v1.8**——新增「战斗域装配现状」（结算五段 授予→增益/减益→战斗→衰减→判定，段序骨架冻结于 `SettlementTable.segment_order`；RunLedger 单类四账所有权 AdventureRunner 独占）与「呈现层装配与会话生命周期」（三屏壳+组合根句柄面／视觉层装配合同立条款、合同表不摘录——唯一事实源=`main.gd` `LAYER_CONTRACT` 现行 17 项五类 kind，登记时 16 层按代码实态订正／RunScope `_begin_session` 换会话整节点释放、无独立收束函数／九阶段×五引用面存活性矩阵认账入册／ModalFlow 互斥域 tags）两节；「初始化顺序」补启动后置条件六条（登记时「十断言」现为六组 11 条——2026-10-16 角标令 V2f 拆两条）；呈现层 D1 行与实现实证读数换代。②**code-conventions.md §4 第 7–12 条**——S9 类型闸三规则与扫描面口径／`:= {}` 推断形态不算债／`# type-hint: ignore` 行级白名单／`# rng-seed-exempt` 豁免通道／--script 模式禁裸 autoload 标识符／Variant 参数化现行口径（元素精化不入硬纪律）。③④⑨**test-conventions.md 新增 §7 判定三硬闸**（闸承载三闸齐备义务＋负面套件仅豁免错误扫描一闸＋新写测试件全类型标注写法纪律，暂不机器闸——S9 扫描面产品码）与 **§8 判定可靠性优先于覆盖率**（§六第 4 项建议随此反映：脚本错误静默中断所在函数剩余断言的机制事实＋三处实证＋写验收函数自证断言全数执行义务；覆盖率度量是否引入仍 06 在册待裁）。⑤**07 v1.4**——㉖① 全流程走查保留不注销，节首加 `screen_flow_probe` 机检承接注记。三笔旧账清零：iter27/28/29 三份实现报告 `git mv` 往 `reports/`（06 条③迁位账清零，全库引用改指新路径、死链复验零死链；roadmap 九处 iter21–26 已删报告死指针改「已退役（git 历史可考）」、iter27/28/29 改指新位）；iter29 报告 §六第 0 项按合并现实改写（`fff4f120` 已合回，两红各自结案：菜单 golden 重采 `dac9a94b`、01 篇 R5 流程图 `fcb8c3f8`＋`8c18b52b`）；06 补登迭代 29 反哺专条（该批漏登）且 27/28 反哺条按「吸收即死」退役为已写入。06 :687 死引用「code-conventions.md §3.6」顺带订正（该内容现独立成文于 test-conventions.md §6）。本批并把 508 批自述「等下一次动 active.md 的批一起入库」的主区未提交行改动随本批提交入库；主区其他并行未提交件（`game/project.godot`／M4 卡片删除／五份未跟踪文档／`layout_probe.gd.uid`）仍零触碰。文档域 --docs 零新增红（回执 commit=分支尖，见合并说明）。
 
 - **510（2026-10-17，迭代 30 卡① 未开格类型徽章批总收口）**：用户「完成迭代30的开发」——三卡串行只做卡①（代码实现批，worktree `g-plan2-iter30-glow`，分支 `iter30-glow-20261017`，合回前 merge master `2aa7e8fd` 后重闸，快进合并 `7ffd1dc0`）。**实现**：Q1 丙案主路径 shader 距离场（`cell_type_glow.gdshader`＋`cell_type_glow_layer.gd` 承载件，与 `_desat_mat` 共存实测未撞墙、a 案程序绘制兜底未启用）；五组微光色板与九型归组单点 `ui_kit.gd`（TG_GLOW_*＋`glow_group_for_cell_type`，呈现参数 α170／带宽 cell÷8）；board_view 作用集＝`_diggable` ∩ 身份可查 ∩ 灯光区 − r0，相位门控与接触带同源，Q4 丙案默认开。**唯一停机呈报**：群伤组初版 #FF1A31 与冻结绯红 #FF2D55 的 ΔH 5.40°（触 art-bible §4.2 既裁冻结面）→ 用户裁「换更暗档 #A61D37」（冻结值 V=0.65 档、色相零移动）；五组现全数「只动明度不动色相」（ΔH ≤0.13°）。**断言三件**：冒烟八相 24 项（1127→1151，含契约 1 同板同序列 on/off 双实例 12 步 digest 对照）／单测 type_glow_test 五段 51 检查（33→34 套件）／ui_input_probe case⑰ 活板面（十八断言）。**渲染取证**：board_shot 双帧（motion_scale=0.5 停格隔离）三关 glow=2/4/4、带外零变化、生效格实绘非空；判据源探针（夹具面五组齐现）相邻组 CR 最弱对 1.232；off 帧对 2026-09-30 代 golden 三基线漂移 0.13/0.11/0.10%（≤2%，基线未重制）。**变异验证 M1–M5 五组反例实证**（归组错映／清单外静默／相位切换不重算／α=0 不绘／派生路径误触玩法 API，红输出与还原实录见实现报告 §四）。**验收**：`--code` 重闸零新增红（09 由基线红转绿判「改善」；11 号 parity 判未触面 SKIP），回执 commit=`7ffd1dc0`＝分支尖。**坑档两条入注释**：探针裸视图必须接生产同源身份解析（否则作用集恒空、PASS 假绿——实跑两次 glow=0）；`Callable.bind()` 动态派发对类型化参数做 Object 硬校验，回调传参改成员现值＋直接方法引用。**产出物**：`reports/iter30-实现报告-2026-10-17.md`（含实机目检总清单 V10 人闸五项，登记不阻塞）／`iter30-代拍板追认单-2026-10-17.md`（§9 白名单 7 项待追认）／`iter30-反哺点-2026-10-17.md`（§5 七条待用户裁决归文档批）。**遗留**：反哺点七条待裁（06 条目状态＋措辞、HUD框架 :140/:269、08 表现表、art-bible 明度档修订条目、roadmap 批内状态、Q3 两带分工＋06 新待办、07 目检人闸条）；实机目检人闸待用户过目（「很丑」终审位）；群伤暗档 provisional 待样张批转正；阔视野带 desc「微光范围 8→12 格」与卡 §4「不扩微光」冲突属数据文本批（treasure_items.tres:47，实现报告 §六登记，不占反哺点条数）；`g-plan2-iter30-glow` 工作区在盘待删（同 carddoc）。
+
+- **511（2026-10-17，迭代 30 卡① 文档批——代拍板七项追认＋反哺点七条回写）**：用户令「追认没有问题;反哺点可以都进行回写」两项一波走完（文档批，不占迭代号，worktree `g-plan2-iter30-fb`，分支 `iter30-fb-20261017`，基于 master `0a164958`）。**追认**：卡①代拍板白名单 7 项全部同意，追认结果行加在 `reports/iter30-代拍板追认单-2026-10-17.md` 文末（用户令原文「追认没有问题」）。**反哺点七条全部回写**：①06-待办清单——条目状态待办→已完成（入库 7ffd1dc0、冒烟 1151/0、单测 34 套、探针 case⑰、07 ㉘ 人闸五项）＋色相措辞修正为「样张 v2 冻结既裁值」＋2026-10-05 实查读数刷新（bonus_pick_overlay.gd 已改名 curio_pick_overlay.gd:97、TG_* 五族在役 ui_kit.gd:49-53）＋新增「卡顶色带与格面微光两带统一」待办条（Q3 甲案）；②HUD框架——实装状态行转「已实装（迭代 30 卡① 2026-10-17 入库，合并 `7ffd1dc0`）」、验收行转正式验收（去「待实施批落地后验收」括注）、版本历史 v0.19、口径史注记后补两带分工注记；③08-Alpha版本标准——「五 · 表现」表新增「未开格类型微光（五组色相＋明度档）」行（在役；明度档 provisional 值，样张批复核转正）＋版本历史 v1.9＋文头状态行 v1.8→v1.9；④art-bible——五组明度档 provisional 值（芥末黄 #F7DF43／黄绿 #68D042／青 #30A6A6／紫罗兰 #7B5BD6／绯红 **#A61D37**＝冻结 #FF2D55 的 V=0.65 档；五组 ΔH ≤0.13° 色相零移动）＋生成口径（渲染合成空间伽马阶梯、相邻组模型 CR 1.245/1.234/1.239/1.270、判据线 1.20、实测最弱对 1.232、群伤暗档停机呈报留痕）落版本历史 v3.15；§4.2/§4.6.3 权威面零改动、§2.1 未追加（Q5 甲案静态）；头注「现行为」v3.11→v3.15 漏更订正；⑤roadmap——迭代进度行、近期主战场行与迭代 30 表行状态列同步卡①已入库（②③待 `/iter` 发令）；⑥Q3 甲案两带分工——注记落 HUD框架 微光节、06 新待办条（见①）；⑦07-体验验证清单——新增 ㉘ 节五项人闸（五组一眼可分／不遮数字〔环不外溢〕／出圈灭入圈复亮／整屏不脏／群伤暗档 #A61D37 观感〔provisional，读数归样张批〕）＋版本历史 v1.5。**反哺点清单批注**：`reports/iter30-反哺点-2026-10-17.md` 加「回写结果」节逐条标已回写。**验收**：文档域闸 `tools/run_all_gates.sh --docs` 零新增红（回执 commit=分支尖，见合并说明）。**遗留**：卡②③待 `/iter` 发令（未决面在册）；实机目检人闸五项（07 ㉘）待用户过目；群伤暗档 provisional 待样张批转正；`g-plan2-iter30-fb` 工作区待合回后清理。