docs: UI全局主题批需求卡片v1.1成立——grilling三裁点落定+自审事实修正+改名批换代重验

grilling三裁点(用户裁按推荐)：focus族词条全零定义(红线升格,弃LineEdit focus豁免,统一归按钮状态矩阵批)/PopupMenu弹层并入预盖(下拉框不盖弹层=预盖半残)/色值卡审即冻结(L2通道兜微调)。自审修正：V5基线834/0过期改开工日实测(最近记录864/0)/新增PNG导入流程补写(.import侧车随批入库)/LineEdit占位文字色补入(STONE_DEEP对PANEL_DATA约6:1)/.tres溯源表改同目录README(不赌内联注释语法)/滑轨margin技巧标注随词条携带。换代重验：master 7d1e9cb状态面板改名批后全部file:line逐一复验存活，pause_overlay.gd→status_panel.gd一处换代(HSeparator计数15处不变)；probe_ui_util CheckButton实查=按文字寻址工具零视觉断言，预盖零冒烟风险；复扫TextureProgressBar/PopupMenu/MenuBar/FileDialog零使用，控件清单完备。06指针行换代v1.1成立。

design/gdd/06-待办清单.md

@@ -10,7 +10,7 @@
 
 **归属**：呈现层表现批（纯工程改动，不动任何美术素材，也不改动 [美术圣经](../art/art-bible.md) §7 的定稿规格）
 
-**状态**：待办（**Alpha 阶段需完成**）——UI 美化三层诊断分三层推进，本条属第一层「系统性缺口」；**用户 2026-10-13 已指定最先动这一层**。**需求卡片已写**：[需求卡片-UI全局主题批-2026-10-13](../research/需求卡片-UI全局主题批-2026-10-13.md) v1.0（2026-10-13 三裁点用户已落定：载体＝.tres 主题文件 / 未在役控件预盖 / 滑轨两段对比度顺手修；待 grilling 复核＋用户卡审，零待裁点，开工门＝U0）。
+**状态**：待办（**Alpha 阶段需完成**）——UI 美化三层诊断分三层推进，本条属第一层「系统性缺口」；**用户 2026-10-13 已指定最先动这一层**。**需求卡片已写**：[需求卡片-UI全局主题批-2026-10-13](../research/需求卡片-UI全局主题批-2026-10-13.md) **v1.1 成立**（2026-10-13 三裁点＋grilling 三裁点全落：载体＝.tres 主题文件 / 未在役控件预盖（含 PopupMenu 弹层）/ 滑轨对比度顺手修 / focus 族词条零定义 / 色值冻结；零待裁点，开工门＝U0）。
 
 #### UI 按钮状态矩阵缺档——悬停没有反馈、危险钮按下没有反馈、键盘焦点全站空白（2026-10-13 登记，UI 美化三层诊断 · 第一层）
 

design/research/需求卡片-UI全局主题批-2026-10-13.md

@@ -1,6 +1,7 @@
 # 需求卡片：UI 全局主题批（引擎原生控件接管皮肤）
 
-- 版本：v1.0（2026-10-13 成文，三裁点已由用户同日落定，待 grilling 复核 + 用户卡审）
+- 版本：v1.1（2026-10-13 grilling 复核三裁点落定＋自审事实修正＋并行改名批换代重验；**卡片成立**，零待裁点，开工门＝U0）
+- v1.1 记录：grilling 三裁点＝①focus 族词条全不定义（弃 LineEdit focus 豁免案）②PopupMenu 并入预盖③色值卡审即冻结；自审修正＝V5 基线数过期、新增 PNG 导入流程补写、LineEdit 占位文字色词条补入、.tres 溯源改 README；换代重验＝状态面板改名批（master 7d1e9cb）后全部 file:line 逐一复验存活，pause_overlay.gd → status_panel.gd 一处文件名换代
 - 来源：[06-待办清单](../gdd/06-待办清单.md)「UI 全局主题资源缺失——引擎原生控件没有接管皮肤」（2026-10-13 登记，UI 美化三层诊断 · 第一层）；[08-Alpha版本标准](../gdd/08-Alpha版本标准.md) 三·界面表同名行
 - 归属：呈现层表现批（纯工程改动，零美术素材，不动美术圣经 §7 定稿规格）
 - 排期：待编入迭代（卡片状态＝待编入）
@@ -11,32 +12,32 @@
 
 **完成定义**：工程内不再存在引擎默认皮肤的可见控件（本批范围清单内）；冒烟＋单元＋探针全绿；新增主题词条断言入冒烟；目检项登记 07（用户自排，登记不阻塞）；06 两条销号、08 表行回填。
 
-## 2. 现状事实（2026-10-13 代码级实查）
+## 2. 现状事实（2026-10-13 代码级实查；行号复核于 master 7d1e9cb）
 
 - `game/project.godot:30` 界面样式相关仅一行 `theme/custom_font`（全局字体）；**无 `gui/theme/custom`，全库零 Theme 资源文件**。引擎版本 4.7（`project.godot:15`）。
 - `game/presentation/main.gd:32` main extends Control，是全部覆盖层的祖先；全局主题走 project 设置，不依赖挂载点代码。
-- **tooltip 主题只覆盖标题屏**：`ui_kit.gd:753` `tooltip_theme()`（深底气泡＋暖白字 14px 程序化 Theme），唯一挂载点 `ui_assembler.gd:105`（标题屏 overlay）。主题沿树向下传播，其余各屏（营地/商店/设置/暂停/生涯/图例/结算/调试）均不生效，气泡为引擎默认灰。全站 10+ 文件挂 `tooltip_text`。
+- **tooltip 主题只覆盖标题屏**：`ui_kit.gd:753` `tooltip_theme()`（深底气泡＋暖白字 14px 程序化 Theme），唯一挂载点 `ui_assembler.gd:105`（标题屏 overlay）。主题沿树向下传播，其余各屏（营地/商店/设置/状态面板/生涯/图例/结算/调试）均不生效，气泡为引擎默认灰。全站 10+ 文件挂 `tooltip_text`。
 - **滑轨两处做法不一致**：`ui_kit.gd:735` `styled_slider()` 盖了 HSlider 的 `slider`（槽轨暖石 #B8A582）与 `grabber_area`（填充深棕 #7A5232）两个词条（`ui_kit.gd:743-746`），**滑柄未盖＝引擎默认灰圆**；`debug_overlay.gd:277` `_slider_row` 未走该工厂，裸 `HSlider.new()` 整条默认。
 - **滚动条裸奔清单**：营地 3 处滚动容器（`camp_overlay_view.gd:101` camp_scroll 横滚兜底、`:114` tree_scroll、`:152` ws_scroll）、调试浮窗 2 处 ScrollContainer（`debug_overlay.gd`）、战斗日志与结算回看 RichTextLabel 的自动滚动条（`battle_log_view.gd:50` scroll_active、`settlement_review_overlay.gd:18`）。营地右侧浅灰圆角滚动条＝登记条目的实机例证。
-- **分隔线**：HSeparator 全站 15 处（ui_assembler 1、battle_end 1、settings 2、legend 3、confirm_dialog 1、pause 2、debug_overlay 5），引擎默认灰线；VSeparator 零使用。
+- **分隔线**：HSeparator 全站 15 处（ui_assembler 1、battle_end 1、settings 2、legend 3、confirm_dialog 1、debug_overlay 5、status_panel 2），引擎默认灰线；VSeparator 零使用。（原 pause_overlay.gd 已由状态面板改名批换代为 status_panel.gd，计数不变。）
 - **调试面输入件**：LineEdit 种子框（`debug_overlay.gd:215`）、SpinBox 批量模拟数（`:246`）、RichTextLabel 输出（`:257`）全部默认皮肤。
-- **未在役控件**：OptionButton / CheckBox / CheckButton / TextEdit / ProgressBar / ItemList / Tree 游戏代码零使用（ProgressBar 已退役，`standee_body.gd:80` 仅存注释）；CheckButton 仅冒烟探针 `probe_ui_util.gd` 使用（非玩家面）。
+- **未在役控件**：OptionButton / CheckBox / CheckButton / TextEdit / ProgressBar / ItemList / Tree 游戏代码零使用（ProgressBar 已退役，`standee_body.gd:80` 仅存注释）；CheckButton 仅冒烟探针 `probe_ui_util.gd` 使用——该处是按文字寻址节点的工具函数（`probe_ui_util.gd:32`），**零视觉断言，预盖对冒烟零风险**。2026-10-13 复扫 TextureProgressBar / PopupMenu / MenuBar / FileDialog / VideoStream 亦全库零使用，控件清单完备。
 - **素材库无滚动条/滑轨/勾选类贴图**（`game/assets/art/ui/` 仅按钮/面板/背景/图标），皮肤只能纯色程序化生成。
 - **冒烟探针零主题断言**（smoke 全目录 grep 零命中），无撞红风险；`ui_tune_probe.gd:213` 有一处 VScrollBar/HScrollBar 引擎滚动机构豁免注释（行为探针，非皮肤断言，不受影响）。
-- **按钮全部逐实例盖皮**（`ui_kit.gd:541` `_apply_button_skin` / `:575` primary / `:591` danger），`add_theme_stylebox_override` 优先级高于全局主题——本批不碰 Button 类型词条则按钮观感零变化。
+- **按钮全部逐实例盖皮**（`ui_kit.gd:541` `_apply_button_skin` / `:575` primary / `:591` danger），`add_theme_stylebox_override` 优先级高于全局主题——本批不碰 Button 类型词条则按钮观感零变化。ui_kit 之外无对滑轨/滚动条/分隔线/SpinBox 的散装 override，T1 退役范围闭合。
 - **第三层①疑点披露**：诊断称音量滑轨「已填段与未填段同一个深棕色」，但代码面两段分别为暖石 #B8A582 与深棕 #7A5232（`ui_kit.gd:743-746`），差异明显；且默认值 100（`settings_overlay.gd:59`）时无未填段。诊断描述与代码面不符，需实机复核——本批不依赖该结论：滑轨词条迁主题时直接重配两段对比度，以「拖到中点一眼可辨」为准绳，重构即修复。
 
 ## 3. 设计契约（红线，违反＝L3 停机呈报）
 
 - 🔴 **Button 类型词条零接触**：全局主题不得定义 `Button` 类型的任何词条。按钮五态矩阵（含悬停做法、键盘焦点）是 06 第一层第二条待办的地盘，其悬停态有未裁点（甲重产贴图/乙常态提亮），本批先行设默认必踩车。OptionButton 为独立主题类型，不受此条约束（预盖件）。
-- 🔴 **不新增美术素材、不改美术圣经 §7**：全部皮肤用纯色 StyleBoxFlat＋脚本生成的纯色/几何小位图，色值一律取自 [ui_kit.gd](../../game/presentation/views/ui_kit.gd) 既有常量（色值表见 §6/T0）；组件规格是否立条款入 §7 走反哺点（§5）。
+- 🔴 **focus 族词条一律零定义**：凡名字带 focus 的词条（`LineEdit` 的 focus、滚动条的 `scroll_focus`、滑轨的 focus 等）一律不写，键盘焦点视觉维持引擎默认描边。焦点态整体纪律归按钮状态矩阵批＋「棋盘战斗键盘/手柄输入」连带裁决点③，本批零预支（grilling Q1 裁：弃 LineEdit focus 豁免案，口径统一）。
+- 🔴 **不新增美术素材、不改美术圣经 §7**：全部皮肤用纯色 StyleBoxFlat＋脚本生成的纯色/几何小位图，色值一律取自 [ui_kit.gd](../../game/presentation/views/ui_kit.gd) 既有常量（色值表见 §6/T0，已冻结）；组件规格是否立条款入 §7 走反哺点（§5）。
 - 🔴 **全局纹理过滤不动**：本批不设置 `rendering/textures/canvas_textures/default_texture_filter`，那是 06 第一层第三条待办的地盘。生成的小位图各自单点设邻近采样（沿用 `ui_kit.gd:214` load_tex 同款做法），不等全局批。
 - 🔴 **旧实现同批删除**（2026-10-11 用户明令）：`tooltip_theme()` 函数与 `ui_assembler.gd:105` 挂载行、`styled_slider()` 的样式词条段必须随批退役，禁止新旧并存。
-- 键盘焦点视觉零定义：主题不写 `focus` 词条（维持引擎默认描边），焦点态整体纪律归按钮状态矩阵批＋「棋盘战斗键盘/手柄输入」连带裁决点③，本批不预支。
 
 ## 4. 范围边界
 
-**做**：VScrollBar / HScrollBar / ScrollContainer(panel) / HSlider / VSlider / TooltipPanel / TooltipLabel / LineEdit / SpinBox / HSeparator / VSeparator 的默认词条；CheckBox / CheckButton / OptionButton 预盖（用户 2026-10-13 裁：预盖，未来新控件自动继承正确皮肤）；音量滑轨两段对比度重配（销号第三层①）。
+**做**：VScrollBar / HScrollBar / ScrollContainer(panel) / HSlider / VSlider / TooltipPanel / TooltipLabel / LineEdit / SpinBox / HSeparator / VSeparator 的默认词条；CheckBox / CheckButton / OptionButton **及其弹层 PopupMenu** 预盖（用户 2026-10-13 裁预盖＋grilling Q2 裁弹层并入——下拉框不盖弹层＝展开后仍默认灰，预盖目的落空）；音量滑轨两段对比度重配（销号第三层①）。
 
 **不做**（去向）：
 - 按钮五态/焦点态 → 06 第一层第二条「UI 按钮状态矩阵缺档」（未裁点随其卡片）。
@@ -59,23 +60,24 @@
 
 ### T0 主题资源与词条（≈0.5d）
 
-1. 新建 `game/assets/theme/main_theme.tres`（路径进 §9 白名单），头注释写色值溯源表（每个字面量 ↔ ui_kit 常量名）。
-2. 一次性生成脚本产出小位图（滚动条柄 3 态、滑轨柄 3 态、SpinBox 箭头、勾选框空框/选中）至 `game/assets/art/ui/gen/`，纯色/几何、各自邻近采样，头注释注明生成脚本出处；脚本入 `tools/` 留档可重跑。
-3. 词条落位（色值提案表，卡审逐值可否）：
+1. 新建 `game/assets/theme/main_theme.tres`；**色值溯源表放同目录 `game/assets/theme/README.md`**（每个字面量 ↔ ui_kit 常量名；.tres 内联注释语法不赌，不写在资源文件里）。
+2. 一次性生成脚本（Python，落 `tools/`，与既有生成脚本同惯例）产出小位图（滚动条柄 3 态、滑轨柄 3 态、SpinBox 箭头、勾选框空框/选中）至 `game/assets/art/ui/gen/`，纯色/几何、各自邻近采样，头注释注明生成脚本出处、可重跑。**新增 PNG 须触发一次资源导入（headless `--import` 或随冒烟首跑自导），`.import` 侧车随批入库**（worktree 缓存坑在册）。
+3. 词条落位（**色值已冻结**，grilling Q3 裁；后续观感微调走 §8 L2 通道）：
 
-| 词条 | 提案值 | 出处 |
+| 词条 | 冻结值 | 出处 |
 |---|---|---|
 | 滚动条槽 scroll | BG_OVERLAY #362B20 α0.35，直角 | BG_OVERLAY |
 | 滚动条柄（常/悬/按） | PANEL_BORDER #786E58 / STONE_FAINT #8C7C64 / STONE_DEEP #554D41，约 8×8 方形 | 三常量 |
-| 滑轨槽 slider | 暖石 #B8A582＋PANEL_BORDER 边（承现值） | styled_slider 现值 |
-| 已填段 grabber_area(+highlight) | **BG_ROOT #3A2E22（换色——对槽 ≈5.4:1，顺手修③层①）** | BG_ROOT |
+| 滑轨槽 slider | 暖石 #B8A582＋PANEL_BORDER 边（承现值）；**携带 (0,6,0,6) content margins**（槽轨 12px 实高引擎检查点，`ui_kit.gd:741` 在案） | styled_slider 现值 |
+| 已填段 grabber_area(+highlight) | **BG_ROOT #3A2E22（换色——对槽 ≈5.5:1，顺手修③层①）**，同 margins | BG_ROOT |
 | 滑轨柄（常/悬/按） | **CANDLE #F6C667 方柄＋PANEL_BORDER 描边（换——弃引擎灰圆）**/ 提亮档 / GOLD_DEEP #B07A14 | CANDLE 等 |
 | TooltipPanel / TooltipLabel | 承 `tooltip_theme()` 现值原样迁入（深底 0.96＋边 #5A5044＋WARM 字 14） | ui_kit.gd:757-760 |
-| LineEdit normal/focus | PANEL_DATA #E9D9B8 底＋PANEL_BORDER 边＋INK 字；focus=金深边 | PANEL_DATA 等 |
+| LineEdit normal | PANEL_DATA #E9D9B8 底＋PANEL_BORDER 边＋INK 字；**占位文字色=STONE_DEEP #554D41**（对底 ≈6:1；种子框用 placeholder，漏配会显示引擎灰） | PANEL_DATA 等 |
 | SpinBox | 底同 LineEdit；箭头=生成 INK 色三角 | 同上 |
 | HSeparator/VSeparator | PANEL_BORDER α0.6 单线 | PANEL_BORDER |
 | CheckBox/CheckButton | 空框=PANEL_DATA＋PANEL_BORDER 14×14；选中=INK 实心/对勾（生成图） | 同上 |
-| OptionButton | normal/hover/pressed=button_stone 九宫格（与手盖按钮同观感，`_tex_sb` 8px 同参）＋INK 字；弹层 popup=PANEL_DATA 面板词条＋INK 字 | 既有贴图与常量 |
+| OptionButton | normal/hover/pressed=button_stone 九宫格（与手盖按钮同观感，8px 边距同参）＋INK 字 | 既有贴图与常量 |
+| PopupMenu（OptionButton 弹层） | panel=PANEL_DATA＋PANEL_BORDER；条目 hover=GOLD_LIT #E6BE5A 底＋INK_ON_GOLD #3C2C14 字；字色 INK、字号 16 | 四常量（候选高亮语义沿用 GOLD_LIT 既有分工） |
 
 4. `project.godot` 挂 `gui/theme/custom="res://assets/theme/main_theme.tres"`。
 
@@ -91,35 +93,38 @@
 2. 文档同步闸：§5 机械面四件更新完毕＋反哺点两条列明。
 3. 批末四闸全绿合并。
 
-**估时合计 0.5–1d**。切分预案：若生成脚本在 headless 受阻（.godot 缓存坑在册），预案＝手写最小 PNG（工具脚本本机跑一次），不动估时软盒。
+**估时合计 0.5–1d**。切分预案：若生成脚本依赖受阻，预案＝手写最小 PNG（工具脚本本机跑一次），不动估时软盒。
 
 ## 7. 验证闸（逐需求点验收清单）
 
-**能力验证（自动化，随批）**——冒烟新增断言：
-- V1 挂载：`ThemeDB.get_project_theme()` 非空且类型集覆盖 §4「做」清单全部类型（`has_stylebox/has_color/has_font_size` 抽查关键词条）。
-- V2 滑轨修复：grabber_area 与 slider 词条色值断言（对 ≈5.4:1 的两常量）。
-- V3 预盖件：临时实例化 CheckBox 读 `get_theme_icon("checked")` 非空（无实役控件的运行时证词）。
+**能力验证（自动化；谁验＝批末四闸闸机，全绿才合并）**——冒烟新增断言：
+- V1 挂载：`ThemeDB.get_project_theme()` 非空且类型集覆盖 §4「做」清单全部类型**（含 PopupMenu）**（`has_stylebox/has_color/has_icon/has_font_size` 抽查关键词条）。
+- V2 滑轨修复：grabber_area 与 slider 词条色值断言（冻结值 BG_ROOT 对 #B8A582 ≈5.5:1）。
+- V3 预盖件：临时实例化 CheckBox 读 `get_theme_icon("checked")` 非空＋PopupMenu 词条存在（无实役控件的运行时证词）。
 - V4 换代退役：`UiKit.styled_slider` / `tooltip_theme` 引用全库零残留（删函数后编译期即闸）＋ `ui_assembler` 无 `overlay.theme` 残留。
-- V5 回归：冒烟全绿（基线 834/0）——按钮/面板逐实例 override 优先级保证存量观感零变化，存量断言即回归网。
+- V5 回归：冒烟全绿（**基线以开工日 run_all 实测为准**；最近记录 864/0）——按钮/面板逐实例 override 优先级保证存量观感零变化，存量断言即回归网。
 
-**正常流程体验（用户目检，登记 07 不阻塞）**：营地滚动条、战斗日志滚动条、设置音量滑轨拖动全程、全屏悬停气泡、调试浮窗输入件、分隔线——巡检无引擎默认灰残留；音量滑轨拖到中点两段一眼可辨。
+**正常流程体验（用户目检；谁验＝用户自排，登记 07 不阻塞）**：营地滚动条、战斗日志滚动条、设置音量滑轨拖动全程、全屏悬停气泡、调试浮窗输入件、分隔线——巡检无引擎默认灰残留；音量滑轨拖到中点两段一眼可辨。
 
 ## 8. 异常分级
 
 - L1（自救）：手写 .tres 语法错导致加载失败/词条名拼错（Godot 4 词条名以引擎文档为准，拼写错=静默回退默认）——冒烟 V1 立红即修。
-- L2（记录继续）：生成位图观感不佳（边缘锯齿/尺寸手感）——登记 07 目检项，值微调随批内迭代。
+- L2（记录继续）：生成位图或冻结色值实机观感不佳（边缘锯齿/尺寸手感/对比不适）——登记 07 目检项，值微调随批内迭代或后批微调。
 - L3（停机呈报）：触碰 §3 任一红线；或改全局设置后发现存量界面观感意外变化（说明有未盘点到的默认皮肤依赖面）——先停，实机截图呈报再动。
 
 ## 9. 代拍板白名单（超清单必呈报）
 
-1. 主题文件路径＝`game/assets/theme/main_theme.tres`；生成位图目录＝`game/assets/art/ui/gen/`。
-2. 生成位图的尺寸/圆角细节（8×8 柄、14×14 勾选框等微观值）。
+1. 主题文件路径＝`game/assets/theme/main_theme.tres`；溯源表＝同目录 `README.md`；生成位图目录＝`game/assets/art/ui/gen/`。
+2. 生成位图的尺寸/圆角细节（8×8 柄、14×14 勾选框等微观值）与生成脚本（Python，落 `tools/`）的文件名与参数形态。
 3. `styled_slider` 退役形态（删函数、几何内联两消费方）——两处消费方为上限，超出的新消费方走主题默认。
-4. 词条内字号沿用既有档位（tooltip 14 / 输入件 16），不新设字号档。
-5. 生成脚本落 `tools/` 的文件名与参数形态。
+4. 词条内字号沿用既有档位（tooltip 14 / 输入件与弹层 16），不新设字号档。
+5. focus 族词条零定义已升 §3 红线，不在白名单内；其余未列尽的同族微观词条（如 SpinBox 内嵌 LineEdit 继承面）按「值取 §6 冻结表同源常量」处理。
 
 ## 10. 待裁点
 
-**零待裁点，开工门＝U0**。三个范围裁点已由用户 2026-10-13 落定：①载体＝.tres 主题文件（乙案，弃程序化甲案——代价＝色值字面量与 ui_kit 常量双处存在，缓解＝.tres 头注释溯源表＋§6 色值表）；②未在役控件预盖；③滑轨两段对比度顺手修（并销号第三层细节修①）。
+**零待裁点，卡片成立，开工门＝U0**。裁点全部闭合：
+- 三个范围裁点（2026-10-13 用户裁）：载体＝.tres 主题文件（乙案，代价＝色值字面量与 ui_kit 常量双处存在，缓解＝README 溯源表）；未在役控件预盖；滑轨两段对比度顺手修（并销号第三层细节修①）。
+- 三个 grilling 裁点（2026-10-13 用户裁「按推荐」）：①focus 族词条全不定义（统一归按钮批，弃 LineEdit focus 豁免）；②PopupMenu 弹层并入预盖；③色值卡审即冻结（L2 通道兜微调）。
+- 自审事实修正（无涉裁决，已随 v1.1 落文）：V5 基线数过期、PNG 导入流程补写、LineEdit 占位文字色补入、.tres 溯源表改 README、status_panel.gd 改名换代重验。
 
-卡片成立前置：grilling 复核门（含验收清单三问）＋用户卡审。§6 色值提案表随卡审逐值可否，否决不改批结构。
+后续流程：编入迭代（用户点名）→ U0 开工（/iter 四检）→ 实现批（worktree＋四闸）→ 收口（§5 同步闸＋06 销号＋反哺点）。