docs(迭代25收口): 文档同步面四件+实现报告+active.md 快照/489-490 记录

- 06: 「UI 全局主题资源缺失」条移除（事项解决即移除，git 留痕）；
  「UI 元素细节修」①销号（两段对比度重配=BG_ROOT 对暖石 5.49:1），余②③④保留
- 08 v1.3: 三·界面「UI 全局主题资源」行→在役；五·表现「UI 元素细节修」行
  注①销号；余五条 06 指向行逐行核对零触碰（roadmap「六行回填」口径对账）
- 07 v0.8: ㉔ UI 全局主题批全屏巡检目检节（含 v1.2 两专项观察点）
- roadmap: 迭代 25 行换代+迭代进度行
- 实现报告=design/qa/iter25-实现报告-2026-10-13.md（代拍板追认单八项+
  GDD 反哺点五条+引擎事实三证+位图不入 git 政策口径呈报）
- active.md: 快照换代+489 开工条+490 收口条

active.md

@@ -17,19 +17,19 @@
 
 
 ## 当前状态快照（收口批先更新本节，再追加状态记录；≤10 行）
-- **更新于**：2026-10-13（迭代 24 敌人表内容修批总收口——单会话 /goal+iter U0 交付）。
-- **批末闸全绿**：冒烟 949/0（基线 938+本批 11 断言）+run_all 25 套+probe --click/--full+render_gate golden 0.00%+doc 三闸/熵增对基线零新增；MC 同种子配对 40 局×both（seed0=9000）三组读数在带（perfect L2 +25pp/全通 +20pp 低于二档判读带，L2 记录不回调）。
-- **迭代 24 交付**：N1 (1,2) 降档 hp22/ac2（敌种 bugbear 保留）+N2 毒吐/盾击两行六池（首遇位 (2,4) 不动）+N3 敌方 attack_type 轴 20 行全填 normal+敌方结算克制消费点（卡片 §2 漏项补点待追认=报告 §四#6）；06 三条销号+08 v1.2+07 ㉓+registry 三处；实现报告=design/qa/iter24-实现报告-2026-10-13.md。
-- **迭代 24 待用户**：实机目检三观测（07 ㉓，登记不阻塞）+代拍板追认单三项+GDD 反哺点五条（06 专条）——迭代位仍预留后续追加卡。
-- **现行文档事实源**：秘宝.md v2.9+奇物.md v3.16+天赋树.md v0.10+锻造工坊.md v0.8+元进度.md v1.20+术语表 v1.10+**08-Alpha版本标准 v1.2（本批随批入库转正）**。
-- **各批残留人闸不变**：迭代 20 实机目检五件+V20/V21/V22 人工核对半；21 营地四柜台〔07 ⑳〕+22 秘宝解锁装配〔07 ㉑〕+23 锻造工作间〔07 ㉒〕+**24 敌人表三观测〔07 ㉓〕**。
-- **已裁在册**：M4 数值批顺延迭代 25+ 未排期（本批与锻造批 provisional 终值归其统一标定）。
-- **界面美化三层已登记**（85e2d2a/08 v1.1）：先动第一层，待 U0 发令后写需求卡片。
+- **更新于**：2026-10-13（迭代 25 UI 全局主题批总收口——单会话 /goal+iter U0 交付）。
+- **批末闸全绿**：冒烟 987/0（基线 949+本批 38 断言）+run_all 25 套+probe --click/--full+render_gate golden 0.00%+doc 三闸/熵增对基线零新增；MC 零跑（零数值零行为=纯呈现）。
+- **迭代 25 交付**：全局主题 `game/assets/theme/main_theme.tres` 挂 `gui/theme/custom`（15 类型全覆盖+预盖 CheckBox/CheckButton/OptionButton/PopupMenu 弹层+`default_font` 中文字形防御）；`tooltip_theme()`/`styled_slider()` 两处局部做法同批退役（settings_overlay 几何内联+debug_overlay 双轨消隐）；冒烟 V1-V6 断言 38 条；06「UI 全局主题资源缺失」条移除+「UI 元素细节修」①销号；08 v1.3；07 ㉔；roadmap 行换代；实现报告=design/qa/iter25-实现报告-2026-10-13.md。
+- **迭代 25 待用户**：实机目检全屏巡检+专项观察点二（07 ㉔，登记不阻塞）+代拍板追认单八项（位图不入 git 政策口径/CheckButton 词条名订正/Slider 无 pressed 槽等=报告 §四）+GDD 反哺点五条（报告 §五）。
+- **现行文档事实源**：秘宝.md v2.9+奇物.md v3.16+天赋树.md v0.10+锻造工坊.md v0.8+元进度.md v1.20+术语表 v1.10+**08-Alpha版本标准 v1.3**。
+- **各批残留人闸不变**：迭代 20 实机目检五件+V20/V21/V22 人工核对半；21 营地四柜台〔07 ⑳〕+22 秘宝解锁装配〔07 ㉑〕+23 锻造工作间〔07 ㉒〕+24 敌人表三观测〔07 ㉓〕+**25 全屏巡检〔07 ㉔〕**。
+- **已裁在册**：M4 数值批顺延迭代 26+ 未排期（各批 provisional 终值归其统一标定）。
+- **界面美化三层已登记**（85e2d2a/08 v1.1）：第一层第一条（全局主题）已交付；余二条（按钮状态矩阵/全局纹理过滤）待立项。
 
 ## 项目当前位置（2026-10-12 刷新；实时细节以根目录 `roadmap.md` 与 06-待办清单 为准）
 - **里程碑**：M3=Alpha 版本的完整实现（2026-10-09 立规：用户未明令宣布 M3 完成前停留 M3，迭代只排 M3 需求，M4 一律不排期）
-- **迭代**：迭代 19 五卡已入库（2026-10-08）；迭代 20 专长实装批已入库（2026-10-11 总收口）；迭代 21 天赋树实装批已入库（2026-10-12）；迭代 22 秘宝体系实现重构落地批已入库（2026-10-12）；迭代 23 锻造工坊实装批已入库（2026-10-12）；**迭代 24 敌人表内容修批已入库（2026-10-13，单会话交付；迭代位预留追加卡）**；M4=迭代 25+ 未排期
-- **近期主战场**：迭代 20/21/22/23 四批残留人闸（实机目检：专长五件 / 营地四柜台〔07 ⑳〕/ 秘宝解锁-装配〔07 ㉑〕/ 锻造工坊工作间〔07 ㉒〕）——各批追认单与反哺点全部出清；**下一前沿=M4 数值批，待 U0 发令**
+- **迭代**：迭代 19 五卡已入库（2026-10-08）；迭代 20 专长实装批已入库（2026-10-11 总收口）；迭代 21 天赋树实装批已入库（2026-10-12）；迭代 22 秘宝体系实现重构落地批已入库（2026-10-12）；迭代 23 锻造工坊实装批已入库（2026-10-12）；迭代 24 敌人表内容修批已入库（2026-10-13，单会话交付；迭代位预留追加卡）；**迭代 25 UI 全局主题批已入库（2026-10-13，单会话交付）**；M4=迭代 26+ 未排期
+- **近期主战场**：迭代 20/21/22/23/24 五批残留人闸（实机目检：专长五件 / 营地四柜台〔07 ⑳〕/ 秘宝解锁-装配〔07 ㉑〕/ 锻造工坊工作间〔07 ㉒〕/ 敌人表三观测〔07 ㉓〕/ **UI 全屏巡检〔07 ㉔〕**）——各批追认单与反哺点全部出清；**下一前沿=M4 数值批，待 U0 发令**
 
 ## 未决面（进行中/待人闸/待裁点指针；现行事实源登记处=`design/gdd/06-待办清单.md`）
 - 待用户裁决：美术审计两项 P0（art-bible 死样张指涉+主角像素管线重产；06 在册）；去毒残留词扫否（魔法道具约 30 处/罕见约 18 处，呈报在案）；喂雷流 R5 甲重启条件回落文（一句话件）；「通关 vs 通过第 N 关」全库口径统一 273 处（待裁是否补登记 06）；迭代 20 实机目检五件+V20/V21/V22 人工核对半（07 在册）
@@ -85,3 +85,7 @@
 - **487（2026-10-13，迭代 24 敌人表内容修批（三关）开工——U0 单会话交付）**：定义入库 0c083bb（主区守卫拦 commit 坑再证——b89c3fe worktree 提交 --no-ff 合回舞步）；开工门=需求卡片 v1.1 零待裁点（Q1-Q9 全裁用户令「按推荐方式」）。基线复读：冒烟 938/0 + run_all **25 套**（卡片/roadmap 记 24 系 485 R1 批加套前旧基线，随批换代呈报）+ probe --click 全绿；改前 MC 锚落盘 sim-data/runsum_iter24_pre_n40both_20261013.jsonl（二档 N=20×both·seed0=9000 沿用迭代 23 配对种子：normal L1 通关 3/20·taken 中位 29.5；perfect L1 19/20·L2 8/20·全通 6/20·taken 中位 76.5）。T1 N1 落地=enemy.tres (1,2) hp 50→22·ac 3→2+表尾批注（阶名化解方案实机未达预期重裁沿革）+V1 两断言（降档锚定+相邻总量比≤2.5 护栏）；T2 N2 落地=skills.tres 12→14 行（venom_spit 毒吐 ×1.6/CD2·shield_bash 盾击 ×1.7/CD3 均无 rider）+六池投放（蜘蛛 (2,5)-(2,7)+毒吐 2、灰矮人 (3,0)/(3,5)/(3,7)+盾击 2、首遇位 (2,4) 不动）+expect_pools 六键同步+旧「技能表十二行」断言换代十四行+V3/V4 五断言（两行字段域/两投放面/逐池增益妨害纪律）。冒烟 945/0+probe 全绿。T3 N3 进行中。（worktree g-plan2-iter24-enemy）
 
 - **488（2026-10-13，迭代 24 敌人表内容修批（三关）总收口——单会话 /goal+iter U0 全量交付）**：三提交全量入库（worktree g-plan2-iter24-enemy；26d669f N1+N2 / ab3ba4f N3 / 5f2ef77 文档同步面+收口笔）。**N1**：enemy.tres (1,2) hp 50→22·ac 3→2（敌种 bugbear/池/数量/atk 零动；表尾批注载 2026-09-24 阶名化解方案实机未达预期重裁沿革）+V1 两断言（锚定+相邻总量比≤2.5 护栏）。**N2**：skills.tres 12→14 行（venom_spit 毒吐 ×1.6/CD2、shield_bash 盾击 ×1.7/CD3 均无 rider——damage_floor 兜底与 0.75 档等效）+六池投放（蜘蛛 (2,5)-(2,7)/灰矮人 (3,0)(3,5)(3,7)；首遇位 (2,4) 不动）+expect_pools 六键同步+旧「十二行」断言换代+V3/V4 五断言。**N3**：20 行 attack_type 全填 normal+enemy_table ATTACK_TYPES 枚举校验（缺省 normal 向后兼容）+unit_container 敌方快照+battle_orchestrator 开单第 9 参传值+**damage_controller._resolve_enemy_skill 克制消费点补一行**（卡片 §2 事实漏项——敌方兑付路径原硬编码 delta 0，2026-09-24 批注释在案；不改则 V5 矩阵命中证词物理不可达，属验收闸强制最小补点待用户追认=报告 §四#6）+单据载荷 attack_type 键+V5 四断言（矩阵证词同种子三甲型实测 heavy 2==light 3−1·ward 4==light 3+1）。**读数**：MC 同种子配对 seed0=9000 N=20×both 改前/改后各 40 局（锚落 sim-data/runsum_iter24_{pre,post}_n40both_20261013.jsonl）；三组读数=N1 perfect L1 19→20/20、N2 perfect L2 8→13/20 全通 6→10/20（方向符合预期低于二档判读带，L2 记录不回调，倍率归 M4）、N3 单发恒 ±1（V5 钉死）全局中位位移系构成效应；二档会话累计 ~8 分钟。**文档同步面**：06 三条销号（第一关遭遇表数值异常/第二关技能池与投放/锻造迁移面⑥）+卡片条收口+反哺点五条专条；08 敌种池行注摘除升 v1.2（untracked 件随批转正入库）；07 ㉓ 三目检登记；registry 三处（enemy.attack_type 字段/skill 十四行/hero 甲轴休眠注退役）；Alpha未完成事项梳理三注订正（A2 已修+附.3 缺行疑云解销=L2/L3 缺 2/3/8 系奖励/休整/商店节正常缺省）。**闸**：冒烟 949/0+run_all 25 套+probe click/full+render_gate golden 0.00%（首跑 SKIP 抓出 worktree 漏拷 art 实体——初拷链因 .godot 路径错误短路，补拷后全绿）+doc 三闸/熵增对基线零新增（死链3/拔旗1/雾格1/lint 3件FAIL 均存量）。**待用户**：实机目检三观测（07 ㉓，登记不阻塞）+追认单三项（消费点补行/旧断言换代/两 untracked 件转正）+GDD 反哺五条。基线漂移记档=run_all 24→25（485 批）。合并=321e6c9（roadmap 与并行迭代 25 编入批 7e0f519d union 解——迭代 24 行已入库门列+迭代 25 UI 批行+26+ M4 行并存）；合并后主区 --import 重刷+冒烟 949/0+run_all 25 套+probe --click 兜底绿。（worktree g-plan2-iter24-enemy；编号顺延 488——487 系本会话开工条）
+
+- **489（2026-10-13，迭代 25 UI 全局主题批开工——/goal+iter U0）**：开工检查全过：需求卡片 v1.2 零待裁点（三范围裁点+三 grilling 裁点+同日审核六点全落文）；验收清单 V1-V6 三要素齐（V1-V6 自动闸机+V6 中文字体防御 v1.2 新增）。自洽扫描事实抽查全符（project.godot 仅 custom_font 无 gui/theme/custom/ui_kit:735 styled_slider 与 :753 tooltip_theme 在役/ui_assembler:105 挂载行/consumers=settings_overlay:59+debug_overlay:277 裸 HSlider 双轨/HSeparator 15 处/tooltip_text 11 文件/theme 目录不存在/art/ui 无滚动条滑轨勾选贴图）；一处事实 drift 记录继续（有利方向）=卡片 §5 称 08-Alpha版本标准 系 git 未跟踪文件，实际已于 5f2ef77（迭代 24 文档批）转正入库——手工搬运条款 moot，worktree 直接可见。定义面四件（roadmap 迭代 25 行/需求卡片/06/08）均已跟踪且干净（迭代 24 收口批 7e0f519d union 解带入），T0 无需新定义入库提交；主区脏件全属他批遗产零碰（.gitignore/.zcode/02/playnote/四 untracked/三 .uid）。基线复读全绿=冒烟 949/0（V5 基线按卡片「开工日实测为准」口径订正为 949/0，卡片记 938/0 系迭代 23 时代数）+run_all 25 套+probe --click 全绿残留 0（ui_input 17 断言/ui_struct/ui_contrast 38 对/click 行为走查问题 0）。worktree g-plan2-iter25-theme（分支 iter25-theme-20261013，基点 5f8acd0）已建，冷检出三件套（art 主区绝对路径拷贝+字体 .import 拷贝+--import 刷导入件）完毕，T0 主题资源起。
+
+- **490（2026-10-13，迭代 25 UI 全局主题批总收口——单会话 /goal+iter U0 全量交付）**：T0-T2 三卡全落（worktree g-plan2-iter25-theme，两提交）。**T0 主题资源**：`game/assets/theme/main_theme.tres`（15 类型=V/HScrollBar·ScrollContainer·H/VSlider·TooltipPanel/Label·LineEdit·SpinBox·H/VSeparator+预盖 CheckBox/CheckButton/OptionButton/PopupMenu）挂 project.godot `gui/theme/custom`；位图生成脚本 `tools/gen_theme_icons.py`（PIL，幂等）产 9 张纯色/几何小位图落 `game/assets/art/ui/gen/`；色值溯源表 `game/assets/theme/README.md`；`default_font` 显式指现役同字体文件（V6 中文字形防御）。**T1 换代退役**：ui_kit.gd 删 `tooltip_theme()`/`_tip_theme` 与 `styled_slider()` 整函数、ui_assembler.gd 删挂载行（旧实现同批删除）；settings_overlay 音量滑轨几何内联（裸 HSlider+200×24）、debug_overlay `_slider_row` 补注释（双轨消隐=两处均走全局主题）。**T2 断言与文档闸**：冒烟新增 `_smoke_global_theme()` 38 断言（V1 类型覆盖+Button/focus 双红线+V2 冻结值锚定+5.49:1+V3 预盖证词+V4 退役零残留+V6 字体防御双断言）；06「UI 全局主题资源缺失」条移除+「UI 元素细节修」①销号；08 v1.3（三·界面主题行→在役+五·表现细节修行注；余五行本批零触碰已逐行核对）；07 ㉔ 全屏巡检登记；roadmap 迭代 25 行换代。**引擎事实三证**（4.7.2 源码+默认主题链双查，探针实证）：①CheckButton 与 CheckBox 同套 checked/unchecked 图标名（卡片 v1.2 注③「on/off」不成立——按引擎事实落位否则预盖静默空转，订正随报告呈报）；②Slider 无 grabber_pressed 图标槽（冻结表「柄·按」GOLD_DEEP 留档未落位）；③ScrollBar 柄=StyleBox 非 Icon（滚动条无位图，increment/decrement 箭头默认主题未定义=无箭头按钮）；另证 4.7 导入参数无逐贴图 filter 标志（位图原生尺寸消费无滤波伪影，全局设置红线未触）。**位图不入 git**：.gitignore:52 `game/assets/art/**`（注释明文「运行时资源本地生成不入库」）——卡片 T0「.import 侧车随批入库」与政策冲突，按政策执行（脚本入库可再生+README 溯源+主区随批拷贝 gen/），例外强制入库与否呈报追认。**闸**：冒烟 987/0（基线 949+38）+run_all 25 套+probe click/full+render_gate golden 0.00%（3 屏）+doc 三闸/熵增对基线零新增（死链 3/词命中 2/lint 3 FAIL 均存量）；MC 零跑（零数值零行为=纯呈现）。**待用户**：实机目检全屏巡检+专项观察点二（07 ㉔）+代拍板追认单八项+GDD 反哺点五条（design/qa/iter25-实现报告-2026-10-13.md §四/§五）。合并=见 git（主区 merge --no-ff；合并后 --import 重刷+gen/ 位图拷贝+全量复跑留痕）。