diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index 27f79370..63a69954 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -128,7 +128,7 @@ **归属**：随[关卡节点地图](systems/冒险循环/关卡节点地图.md)定稿改键一并裁决 -**状态**：部分收口（2026-09-17）——同层多遭遇问题已由关卡节点地图 v1.0 的**节点编号升级**消解（`node_depth` 语义 = 关卡内唯一节点编号，同层不同节点各查各行，键结构零改动）；**不设精英 / Boss 编码位**（Boss = 最大编号节点，精英 P2 内容承载）。剩余面继续待办并改归属：同场多敌种（同一编号行集多行）的行集校验放开 ——归属**敌人表行集多行批（战斗侧，排技能池实施批落地后）**（混编伏击上限取值口径面已随 2026-09-20 单轮上限删除消解）。**已编入 roadmap 迭代 16 卡①（2026-10-05——任务书已成文待 U0：design/research/任务书-敌人表行集多行批-2026-10-05.md；前置「技能池实施批落地」已于 2026-10-05 满足〔d3fa887〕，开工门已解，余 4 项待用户裁点）** +**状态**：部分收口（2026-09-17）——同层多遭遇问题已由关卡节点地图 v1.0 的**节点编号升级**消解（`node_depth` 语义 = 关卡内唯一节点编号，同层不同节点各查各行，键结构零改动）；**不设精英 / Boss 编码位**（Boss = 最大编号节点，精英 P2 内容承载）。剩余面继续待办并改归属：同场多敌种（同一编号行集多行）的行集校验放开 ——归属**敌人表行集多行批（战斗侧，排技能池实施批落地后）**（混编伏击上限取值口径面已随 2026-09-20 单轮上限删除消解）。**已编入 roadmap 迭代 17 卡①（2026-10-05——任务书已成文待 U0：design/research/任务书-敌人表行集多行批-2026-10-05.md；前置「技能池实施批落地」已于 2026-10-05 满足〔d3fa887〕，开工门已解，余 4 项待用户裁点）** #### 技能池情境条件触发器 @@ -177,7 +177,7 @@ **归属**：战斗结算与地图战斗资源共裁（数值终值归状态层重设计批） -**状态**：待办（语义已定案，数值未闭合）——**已编入 roadmap 迭代 16 卡② M4 数值批（2026-10-05——任务书已成文待 U0：design/research/任务书-M4数值批-2026-10-05.md；duration 终值与当量锚复算 = 件①，跑批发起前须用户批准）** +**状态**：待办（语义已定案，数值未闭合）——**已编入 roadmap 迭代 17 卡② M4 数值批（2026-10-05——任务书已成文待 U0：design/research/任务书-M4数值批-2026-10-05.md；duration 终值与当量锚复算 = 件①，跑批发起前须用户批准）** #### 单体寻址的接口扩展位 @@ -223,7 +223,7 @@ **归属**：①元进度设计批 + 曲线调参批 ②曲线调参批（现行窗） ③~~秘宝同调实施批~~（已清偿 2026-10-03） -**状态**：已登记（2026-10-01，迭代 10 批随批）——**①②已编入 roadmap 迭代 16 卡② M4 数值批（2026-10-05——任务书已成文待 U0：design/research/任务书-M4数值批-2026-10-05.md；钥石产出重标 + 通关率带重扫 = 件③，跑批发起前须用户批准）** +**状态**：已登记（2026-10-01，迭代 10 批随批）——**①②已编入 roadmap 迭代 17 卡② M4 数值批（2026-10-05——任务书已成文待 U0：design/research/任务书-M4数值批-2026-10-05.md；钥石产出重标 + 通关率带重扫 = 件③，跑批发起前须用户批准）** #### 调参批数值点评登记（八型批随批登记） @@ -231,7 +231,7 @@ **归属**：[难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md)难度曲线调参批 -**状态**：待办（随调参批一并裁决）——**已编入 roadmap 迭代 16 卡② M4 数值批（2026-10-05——任务书已成文待 U0：design/research/任务书-M4数值批-2026-10-05.md；五条点评逐条裁决 = 件②）** +**状态**：待办（随调参批一并裁决）——**已编入 roadmap 迭代 17 卡② M4 数值批（2026-10-05——任务书已成文待 U0：design/research/任务书-M4数值批-2026-10-05.md；五条点评逐条裁决 = 件②）** #### 基线通关率越带，加难杠杆扫描未执行 @@ -247,7 +247,7 @@ **归属**：元进度设计批 -**状态**：部分收口（2026-09-21 元进度实现批再收窄；2026-09-23 换算率标定批再收窄）——**三柜台结构与 provisional 定价已落地**（属性锻造三档血+3/攻+1/甲+1、base 10 公比 150；Boss 两档 L1 5/1·L2 8/2·L3 12/3；工坊六件阈值 1/1/2/2/3/3 按总通关次数——全部读 `data/tables/meta.tres`）；换算率三行已投值 6/9/1（同批，冒险条件口径实测，护甲行强条目重测履行）；剩余面 = 定价数字与 Boss 两档——**已编入 roadmap 迭代 16 卡② M4 数值批（2026-10-05——任务书已成文待 U0：design/research/任务书-M4数值批-2026-10-05.md；定价数字与 Boss 两档终值 = 件④。注：本条「base 10 公比 150」文本滞后——meta.tres 现行 forge base_price=20（2026-09-22 数值设计批对齿 10→20），随件④收口时刷新）** +**状态**：部分收口（2026-09-21 元进度实现批再收窄；2026-09-23 换算率标定批再收窄）——**三柜台结构与 provisional 定价已落地**（属性锻造三档血+3/攻+1/甲+1、base 10 公比 150；Boss 两档 L1 5/1·L2 8/2·L3 12/3；工坊六件阈值 1/1/2/2/3/3 按总通关次数——全部读 `data/tables/meta.tres`）；换算率三行已投值 6/9/1（同批，冒险条件口径实测，护甲行强条目重测履行）；剩余面 = 定价数字与 Boss 两档——**已编入 roadmap 迭代 17 卡② M4 数值批（2026-10-05——任务书已成文待 U0：design/research/任务书-M4数值批-2026-10-05.md；定价数字与 Boss 两档终值 = 件④。注：本条「base 10 公比 150」文本滞后——meta.tres 现行 forge base_price=20（2026-09-22 数值设计批对齿 10→20），随件④收口时刷新）** #### 解锁界面与钥石呈现的交互形态（残余：暂停层只读入口） @@ -255,14 +255,14 @@ **归属**：HUD 批（M-4，批未立项） -**状态**：待办（2026-10-03 06 清账批瘦身——视觉终稿半兑现销号，本条仅存暂停层残余）——**已编入 roadmap 迭代 16 卡③（2026-10-05——任务书已成文待 U0：design/research/任务书-暂停层只读入口批-2026-10-05.md；4 项待用户裁点〔入口位置/与既有弹窗层关系/展示范围/减动效联动〕，美术红线=复用现行公共件零新素材）** +**状态**：待办（2026-10-03 06 清账批瘦身——视觉终稿半兑现销号，本条仅存暂停层残余）——**已编入 roadmap 迭代 17 卡③（2026-10-05——任务书已成文待 U0：design/research/任务书-暂停层只读入口批-2026-10-05.md；4 项待用户裁点〔入口位置/与既有弹窗层关系/展示范围/减动效联动〕，美术红线=复用现行公共件零新素材）** #### 第一关亮墨数字直画观感优化（2026-10-01 T17 目检体感登记） **现状**：迭代 9 T4 数字承载切换后第一关=亮墨三档直画（白亮字直接印棕色地板、无色牌垫底），机制可读性过闸（用户实机确认三档冷暖可分、凑近与离屏均可读）；同日 T17 目检体感「表现和描述一样，但非常难看」——直画字与地板的组合观感待优化。第二/三关米色小牌形态未获同类反馈。 **归属**：呈现优化批（与高墙墙底阴线观感同批裁量；排 M-4 后排，不卡迭代 9 出口） -**状态**：待办（2026-10-01 登记；机制/可读轴零触碰，纯观感轴） +**状态**：待办（2026-10-01 登记；机制/可读轴零触碰，纯观感轴）。**2026-10-05 注**：迭代 16「UI 设计对齐批」任务书已起草（`design/research/任务书-UI设计对齐批-2026-10-05.md`）——棋盘数字墨三档与色牌垫底属本批 §3-N1 对比度收项面（实查 `board_cell_unit.gd:238/262` 字号公式已合规、`:229-234` 垫牌在位），裁点裁决后随批一并呈报。本条维持待办。 #### 高墙墙底细阴线观感优化（2026-10-01 T17 目检体感登记） @@ -270,7 +270,7 @@ **归属**：呈现优化批（与数字直画观感同批；排 M-4 后排，不卡迭代 9 出口） -**状态**：待办（2026-10-01 登记；机制轴零触碰，纯观感轴） +**状态**：待办（2026-10-01 登记；机制轴零触碰，纯观感轴）。**2026-10-05 注**：墙脚阴线色 `E_FACADE_FOOT_COL #342A20` 已列为迭代 16「UI 设计对齐批」§3-N4a 五处漏网裸色之一（`board_cell_unit.gd:79`），收进 `ui_kit.gd` 时原值搬运、零观感变化；任务书=`design/research/任务书-UI设计对齐批-2026-10-05.md`。本条维持待办。 #### 未开格类型徽章呈现时机（2026-09-18 方向已拍板，待实施批） @@ -278,6 +278,22 @@ **归属**：[地图战斗资源](systems/战斗循环/地图战斗资源.md)极性提案实施批与HUD框架共裁 +**状态**：待办。**2026-10-05 注**：类型色五族已由迭代 16「UI 设计对齐批」§3-N4c 立项 `TG_*` 常量（实查 `ui_kit.gd` 现无 tg 常量，五族以裸 `Color8` 内联于 `bonus_pick_overlay.gd:96-102` / `shop_overlay_view.gd:189`，且缺第五族 aoe `#E25676`）；本条（**格面**未开格类型徽章）与卡顶色带同族不同落点，**不并入本批**，维持待办。 + +#### 棋盘格边长三方取值不一致——待扩板定档处置（2026-10-06 登记） + +**现状**：迭代 16「UI 设计对齐批」P2 已裁「棋盘格边长零改动」（本次不动棋盘游戏画面），由此三方取值不一致作为**已知偏差**登记：①代码 = `board_view.gd:251` 动态公式 `clampi(cell, 26, 46)` + `:114` 默认 46.0；②art-bible §8.1(:433) 冻结锚点 = 45px（10×10）/ 36px（12×12）；③demo 原型 = 44px（`src/ui-prototype.html:288`）；另有 HUD框架:72 装板校验区间 [30,45]。**当前未被任何断言触发**（属潜在不一致，不是缺陷）。按任务书契约 R7「禁单侧改完留漂移」，本批**代码与文档均不改**；处置时机 = 扩板（13×13/14×14）定档时随格边长专项一并处理（§8.1 亦注明扩板换算值未定稿）。来源=`design/research/任务书-UI设计对齐批-2026-10-05.md` §2.1「已知偏差」行。 + +**归属**：格边长专项（或 UI 设计对齐批后续专项）；开工 = 用户点名 + +**状态**：待办 + +#### UI 原型 demo 结构级差异三项——待立项（2026-10-06 登记） + +**现状**：迭代 16「UI 设计对齐批」按「以 demo 为视觉方向标准」逐项核对后，三条 demo 与实机的**结构级**差异判定**不入本批**（风险与估时量级远高于样式对齐，另立专项或独立呈现批）：①**卡片尺寸**——demo `232×352`（`artwork/ui-redesign-2026-10-04/src/ui-prototype.html:204`；UI 重设计原型 v2 落码计划 §7.2 勘误已记此为 demo 现行值），实机 `ui_kit.gd:404` `custom_minimum_size = Vector2(216, 300)`；②**商店屏形态**——demo = bg-bright 全屏底 + 56px 顶栏（v2 差异表 5.2 🔴「可裁：保持模态但换卡面」，**未裁**），实机 `shop_overlay_view.gd:32` 仍 `modal_shell` dim 0.6 模态；③**关卡地图底栏**——demo = 合并单条 88px 亮条（头像+HP 轨+属性+本关加成+道具槽+放弃；差异表 4.4 🔴），实机 `level_map_screen.gd:141/151/160` 仍 `life_box`/`attr_box`/`bonus_box` 三个独立框（**M5 底栏重构未落**）。来源=`design/research/任务书-UI设计对齐批-2026-10-05.md` §8.3-E。 + +**归属**：UI 设计对齐批后续专项（或独立呈现批）；开工 = 用户点名 + **状态**：待办 #### 资产升档重产批（art-bible v3.0 中修挂账③，2026-09-29 登记） @@ -343,7 +359,7 @@ **归属**：新界面立项（用户发令后排批）；退役落码随 UI 落码批 M8/M9 -**状态**：待办（生涯未做前，冒险中无任何历史回看入口——已知代价，用户知情裁决）——**已编入 roadmap 迭代 16 卡④（2026-10-05——设计提纲版任务书已成文待 U0：design/research/任务书-生涯界面设计立项-2026-10-05.md；只做设计不做实装，6 项待用户裁点，实装批另行立项）** +**状态**：待办（生涯未做前，冒险中无任何历史回看入口——已知代价，用户知情裁决）——**已编入 roadmap 迭代 17 卡④（2026-10-05——设计提纲版任务书已成文待 U0：design/research/任务书-生涯界面设计立项-2026-10-05.md；只做设计不做实装，6 项待用户裁点，实装批另行立项）** ### GP 经济 diff --git a/design/research/任务书-M4数值批-2026-10-05.md b/design/research/任务书-M4数值批-2026-10-05.md index 433eee4b..51f90d57 100644 --- a/design/research/任务书-M4数值批-2026-10-05.md +++ b/design/research/任务书-M4数值批-2026-10-05.md @@ -1,7 +1,7 @@ # 任务书：M4 数值批（v1.0 定稿，待发令开工） > 成文 2026-10-05。**性质**：四件数值收口合一批 + 两件读数义务随批跑 + 一件既有探针红灯顺路修复。 -> 归属迭代：**迭代 16 · 卡②**（迭代 16 四卡：①敌人表行集多行批 ②本批 ③暂停层只读入口批 ④生涯界面设计立项）。 +> 归属迭代：**迭代 17 · 卡②**（迭代 17 四卡：①敌人表行集多行批 ②本批 ③暂停层只读入口批 ④生涯界面设计立项）。 > 满足 loop engineering 八件（见 §9 逐条对照）。 > 🔴 **铁规前置（违反即返工）**：①本批一切 MC / verifier 跑批**发起前须用户批准**（先推算后重跑铁规 + MC 触发细则：数值验证场景才触发，四档硬闸在册）；②**调参联动禁独立调参网络**——行动经济 F1 条款3 v0.8 已立 β 带 [1.2,2.5] 逐 u 检算口径，任何数值调整须按调参联动表同窗检算，禁单参数孤立改。 diff --git a/design/research/任务书-UI设计对齐批-2026-10-05.md b/design/research/任务书-UI设计对齐批-2026-10-05.md new file mode 100644 index 00000000..71c7cbc7 --- /dev/null +++ b/design/research/任务书-UI设计对齐批-2026-10-05.md @@ -0,0 +1,472 @@ +# 任务书：UI 设计对齐批（迭代 16）· v1.0 定稿（P1-P11 裁决已齐，随开工令实施） + +> 成文 2026-10-05。**性质**：纯呈现层 UI 设计代码对齐批——把三路改进方案（A 落码差异对照 / B OPT-A 机检 / C WB 像素纪律）的**代码侧可收项**落到 `game/presentation/**`，并在用户裁决后统一六个互相打架的取值。 +> **事实源（必读全文）**：[UI预览demo三路改进整合对照-2026-10-04.md](UI预览demo三路改进整合对照-2026-10-04.md)（§二六大改进轴 / §三六分歧 / §四无分歧收项 / §五开放项）。 +> **佐证**：[UI重设计原型v2落码-差异对照与改动计划-2026-10-04.md](UI重设计原型v2落码-差异对照与改动计划-2026-10-04.md)（原型 v2 落码 M0+M1+M10 已全落籍 master，§七 为用户终裁口径，本批是 v2.1 之上的**第二轮** UI 设计对齐）。 +> **基线**：原型 = `artwork/ui-redesign-2026-10-04/src/ui-prototype.html`（v2.1，8 屏 1280×800，2026-10-05 实测 md5 `78ebbee0…`）；实机 = `game/presentation/views/ui_kit.gd` 及各 `*_view` / `*_overlay` / `*_screen`。 +> **归属迭代**：迭代 16（迭代 16 四卡已顺延迭代 17，本批为改编入册的 UI 优化需求）。 +> **美术红线（2026-10-05 用户立规）**：`game/assets/art/**` 与 `artwork/**` **均不动**——不新增素材、不重烘/重采样/重 quantize 贴图、不改 PNG 一字节。本批只改 UI 设计代码（ui_kit 色板 token / 字号档 / 布局与圆角纪律 / 对比度垫底 / 抖动呈现 / panel_skinned 消费接线等）。凡结论指向「改素材才能解决」的一律转 06 登记，不自产。 +> **本文件性质**：任务书正文 + 裁点归档。P1-P11 已全部裁决（✅ 见 §8），随迭代 16 开工令实施。 +> **裁决进度**：✅ P1 = 甲（维持暖化）· ✅ P2 = 丁（棋盘格边长**零改动**，本次不动棋盘游戏画面）——2026-10-05 已决；✅ 其余 8 项**取向已定**（2026-10-06 用户采纳推荐）：**P4 / P7 / P10 跟 demo**，**P3 / P6 / P8 / P11 按条款解**，**P5 两路同结论**（P9 为已决注销清单，不算裁点）。 +> **「以 demo 为准」的适用范围（三层优先级栈）+ 三条不入本批的结构级差异 = §8.3。** + +--- + +## 1. 目标与完成定义 + +### 1.1 一句话目标 + +在不碰任何美术资源的前提下，把三路改进方案里**可确定性收口的部分**（7 处对比度 FAIL / 站桩垂直溢出 / 4 处漏网裸色 / status 图标 preload 红线 / 类型色五族单点 / 面板皮消费面 / 圆角一致性）落到实机代码，并把**六个互相打架的取值**（底色冷暖 / 棋盘格边长 / 字号档位 / 九宫格切片 / 圆角去留 / 图标尺寸解法）与 §五 开放项（抖动范围、色板唯一来源等）一次性呈给用户裁决后统一实装。 + +### 1.2 完成定义（出口判定清单） + +| # | 判定项 | 量化标准 | +|---|---|---| +| 1 | 对比度全绿 | 实机机检（含 §3.1 七处测点）对直背景 ≥4.5:1（art-bible §7.2 无区域例外）；demo 侧 7 处读数由 T0 实机复测回填后失效 | +| 2 | preload 红线清零 | `status_slot_row.gd` 九枚图标改 `load_tex` 守卫路径；全仓呈现层素材 `preload` 计数 = 0 | +| 3 | 色板单点 | `ui_kit.gd` 为全站唯一取色出口；呈现层裸 `Color8(` 计数 ≤ N4a 白名单放行后的剩余数（目标 0） | +| 4 | 站桩不裁 | B 区站桩（battle.md 252px 舞台）纵向内容排满后仍留 ≥8px 余量；名行/血条/底座零裁切（探针 + 目检双证据） | +| 5 | 类型色单点 + 五族齐全 | `TG_*` 五族常量入 `ui_kit.gd`，`bonus_pick_overlay` / `shop_overlay_view` 改消费常量，零裸字面量；第五族（群伤）补齐并接线 | +| 6 | 既有纪律零回退 | `UiKit.button(min_w=216)` 宽度基准 + SIZE_FILL 不动；`ui_struct_probe` 全屏五族断言零红并保持 probe_gate 默认必跑段；MC 四代锚不重锚 | +| 7 | 六分歧全部收干 | 用户裁决的每一项都在代码 + 文档（art-bible / HUD框架）双侧同口径落文，零「代码一套文档一套」残留 | +| 8 | 重闸全绿 + 人闸 | 冒烟全量（基线 T0 重测回填）· run_all 十五套件 · ui_struct/ui_click/ui_input 三探针全绿 · doc 三闸零新增 · 熵增闸 PASS；实机目检清单过 | + +> ⚠️ **基线纪律**：起草时点 master 头 = **446d5f9**，冒烟 **772/0**，run_all **14/15**（唯一红 = `reward_overlay_test`，master 既有在册红，本批守零新增）。以上均为**起草读数**，**T0 必须自行重测回填**；本任务书 §2 全部 `file:line` 与 §3 全部收项，一律以 T0 复核后的实况为准再落笔。 + +--- + +## 2. 现状事实（代码级考证；起草时点 master 446d5f9） + +> 本表已对整合对照 / OPT-A / WB 三份文档引用的行号逐条**实查**。凡漂移处均在「注」列标注旧值→现值。 + +| # | 事实 | 读数（file:line） | +|---|---|---| +| **F1** | **底色冷暖已在 master 落地（暖化侧）** | `ui_kit.gd:65` `BG_ROOT #3A2E22` · `:66` `BG_OVERLAY #362B20` · `:67` `BG_BRIGHT #453723`（M0 新增）· `:68` `CANDLE #F6C667`（M0 新增）· `:48` `WARM_SOFT #E8D5A8` · `:49` `WARM_FAINT #CDB88C`；依据落 `art-bible.md:410` 琥珀双岗注记。**OPT-A §6③「改代码还是改 demo」已被 2026-10-04 M0 批解决——代码已改暖，OPT-A 的「回归近黑 #1E1914/#1C1612」提案与现行 master 反向** | +| **F2** | **9 处色板漂移：实测 4 已收 / 5 未收** | 已收：`--warm-soft`(:10)↔`WARM_SOFT`(:48)、`--warm-faint`(:10)↔`WARM_FAINT`(:49)、`--bg-root`(:16)↔`BG_ROOT`(:65)、`--bg-overlay`(:16)↔`BG_OVERLAY`(:66)。未收：`--panel #E9D9B8`(:12) vs `PANEL_DATA #E2D2B6`(`ui_kit.gd:24`)、`--panel-edge #786E58`(:12) vs `PANEL_BORDER #786A58`(`:25`)、`--slot-back #3E362C`(:18) vs `SLOT_BACKDROP #342C24`(`:63`)、`--hp-back #282220`(:18) vs `HP_BAR_BACK #28221C`(`:83`)、`--wood-deep #6E4526`(:11) vs `CAMP_HEADER_BAND #7A5232`(`:80`)。**「9 处」待随 M0 降记为「5 处」** | +| **F3** | **类型色五族 `tg-*` 在 ui_kit 并不存在（整合对照 §四该条为过期记载）** | 全仓 `grep -i "tg" game/` **零命中**；OPT-A §3⑦与整合对照 §四「`tg-*` 常量已在 ui_kit 但未用于呈现」不成立。实际形态 = 内联裸 `Color8`：`bonus_pick_overlay.gd:96` 默认 `#C2B264`、`:98` heal `#66A457`、`:100` magic/blast `#8A72C4`、`:102` pierce `#57A0A0`；`shop_overlay_view.gd:189` 货架卡固定取默认值 `#C2B264`（未按类型分族）。**第五族（demo `--tg-aoe #E25676`，demo :19）在实机完全缺位** | +| **F4** | **九宫格切片实机恒 8** | `ui_kit.gd:286` panel `_tex_sb(tex, 8.0)`；`:327/328/330/331` button 常态/hover/pressed/disabled 均 `8.0`；`:299` `frame_skinned` `12.0`。素材实测 `panel_stone.png` = **48×48**、`button_stone.png` = **48×48**。demo 侧 `.plate9` border 12 / slice **16**（html:59）、`.btn9` border 11 / slice **16**（html:61） | +| **F5** | **panel_skinned 消费面实测 8 处 + 工厂 1 处（WB「仅 4 处」已过期）** | `ui_assembler.gd:202` · `battle_end_overlay.gd:33` · `battle_stage_view.gd:93` · `confirm_dialog.gd:19` · `hero_info_panel_view.gd:34` · `legend_overlay.gd:31` · `node_overlay.gd:17` · `settings_overlay.gd:39`；+ `ui_kit.gd:401`（BCard 工厂内部）。未消费皮的剩余面 T0 造册呈报 | +| **F6** | **棋盘格边长 = 动态公式 + clamp[26,46]，不是常量 44** | `board_view.gd:114` `var _cell := 46.0`；`:246-251` `set_cell_area()` 按可用面积重算后 `clampi(cell, 26, 46)`；`board_cell_unit.gd:13` `edge := 46.0`。demo 定位 44px（html:288 `repeat(10,44px)` / gap 2px）。**冻结条款是 art-bible §8.1(:433) 锚点 45(10×10)/36(12×12) 与 HUD框架.md:67/72 定值档 + 装板校验区间 [30,45]——三方取值互不相等**（代码上限 46 / demo 44 / 条款 45）。**✅ 2026-10-05 用户裁 P2=丁：本批棋盘格边长零改动**（不调 clamp、不调定值档、不动棋盘游戏画面）。由此产生的已知偏差（代码上限 46 vs 条款 45 vs demo 44）**本批也不单侧改文档**——按 R7「禁单侧改完留漂移」，改为在本文档 §2.1 与 06 登记为已知偏差，等扩板（13×13/14×14）定档时随格边长专项一并处置 | +| **F7** | **地形瓦片源 32×32，缩放到格边必然非整数** | 实测 `game/assets/art/board/terrain_wall_center_dungeon.png` = 32×32、`terrain_floor_dungeon_1.png` = 32×32、`flag_seal.png` = 32×32；`board_cell_unit.gd:132` `draw_texture_rect(tex_base, rect, false)` 直接拉伸至 edge → 倍率 = edge/32（edge 取clamp后值，非整数即违规 §8.2 甲类） | +| **F8** | **字号无档位表，实测量 15 档，且低于 §7.4 下限** | `UiKit.label()` 调用档位统计（起草时点）：11×5 / 12×9 / 13×12 / 14×11 / 15×13 / 16×13 / 17×2 / 18×2 / 20×2 / 22×2 / 24×3 / 26×3 / 40×1；另有 `status_slot_row.gd:67` tooltip 13、`:148` 10。§7.4(:417) 下限 = 正文/明细 ≥16、tooltip ≥14、棋盘数字 ≥18 → **11/12/13 档共 26 处在下限以下**。棋盘数字 `board_cell_unit.gd:238/262` `maxi(18, int(ceil(edge*0.5)))` 已合规 | +| **F9** | **7 处对比度 FAIL 的实机对应点（demo 读数须 T0 实机复测）** | ①站桩血数 `standee_body.gd:438-439`（11px 白字 α.95 + 深描边，直压 `:432` fill `Color(0.41,0.61,0.91)`=`#699CE8`；**实机敌我同色，demo 的敌方红 `#B0503F` 分支实机不存在**）②意图徽标 `standee_body.gd:172-178` 取色 + `:460-461` 绘制（atk=`RED_MINE #96362C` / buf=`HERO_BLUE #2E86DE` / debuff=`DEBUFF_PURPLE` / charge=`GOLD_DEEP`）③C 区槽占位字 `hero_info_panel_view.gd:196-207`（used=`STONE_FAINT` / 不可用=`STONE` / 字形 20px）④RAP 标签 `ap_bar_view.gd:74`（`UiKit.label("RAP 0", 14, true)` **无 color 参数 → 回落 `INK_LABEL #2E2218`**，`ui_kit.gd:212`） | +| **F10** | **站桩溢出在实机存在同构风险（非纯 demo 缺陷）** | demo 根因 = `nmrow` 13px 未锁 line-height（OPT-A §2.4，溢出 3.2px）。实机同型写法：`standee_body.gd:26` `var box := Vector2(150, 176)`（注记「实际高随壳层 row 布局注入」）+ `:476` **名行基线 = `box.y - 1.0`（离盒底仅 1px 余量）** + `:417-419` 底座贴 `box.y - 18.0` → 与 demo「声明值刚好=容器值」同款高危写法 | +| **F11** | **status 图标 preload 违规（可单独切分）** | `status_slot_row.gd:21-29` 九枚 `preload("res://assets/ui/icons/status_*.png")`；违反 `ui_kit.gd:121` 注释红线「禁 preload（素材缺位树上直接断言炸脚本）」。素材实测在位且均 **32×32** | +| **F12** | **图标/头像缩放违规全套核实** | 手绘十枚 20×20 已入库（`game/assets/art/ui/icon_*.png` 实测，M1 已落）；**柜台四枚 `icon_forge/workshop/atlas/keystone` 仍 64×64**，显示 20px → 0.3125×；状态九枚 32×32 → 显示 24px(`status_slot_row.gd:123`)/16px(compact) → 0.75×/0.5×；BCard 图标槽 `ui_kit.gd:421` `Vector2(56,56)` 吃 20×20 源 → **2.8×**；地图头像 `level_map_screen.gd:136` `Vector2(50,52)` 吃 `character_hero_portrait.png` **46×48** → 1.087×/1.083× **纵横异倍**（违反 §8.2 乙类「免非整数但禁纵横异倍」） | +| **F13** | **既有宽度纪律与探针闸不得回退** | `ui_kit.gd:258` `button(text, min_w=216)` + SIZE_FILL；行板/角标/图标钮豁免 9 处（camp 5 + shop 2 + ap_bar 2 + 调试角标/诊断 2）；`ui_struct_probe` 五族断言已入 probe_gate 默认必跑段（出口报告`:45-46`）。**R5 营地 1632px 爆宽事故先例在册** | +| **F14** | **Modal 登记纪律（背景约束）** | `main.gd:345-351` `_register_modal`（必 `set_anchors_and_offsets_preset` 非 `set_anchors_preset`）· `:353` `_open_modal` 单口 · `:373` `_input_locked`（`modal_stack.has_open()` 单一来源）。本批若不新增层则零触碰；若新增任何层必须走登记册 | +| **F15** | **demo 基线已再次漂移（三路文档的 demo 读数不可直接引用）** | `artwork/ui-redesign-2026-10-04/src/ui-prototype.html` 2026-10-05 实测 md5 `78ebbee0…`，**既不等于整合对照 §六记录的「当前 `4cc45cf3…`」，也不等于 OPT-A 记录的 `d2addb67…`**。→ demo 侧任何对比度/缩放/色板机检读数，落到实机前一律由 T0 重跑，禁止直接引用旧表 | + +### 2.1 事实校正汇总（整合对照 / OPT-A 过期项，本批按此执行） + +| 原记载 | 校正后事实 | 影响 | +|---|---|---| +| 「9 处色板漂移」 | 实测 **4 已收（随 M0）/ 5 未收** | §四「直接收」的量级下调；**2026-10-06 取向 = 取 demo 侧**（§8.2-P7 乙案），5 处改代码向 demo 值 | +| 「`tg-*` 常量已在 ui_kit 但未用于呈现」 | ui_kit **无** tg 常量；五族以裸 Color8 内联在 2 文件，且缺第五族 aoe（群伤） | 从「接线」改为「立项 TG_* + 补族 + 替换内联」 | +| 「实测仅 4 处消费 `panel_skinned`，需补到 9 处」 | 实测 **8 处 + 工厂 1 处** | 补面工作量≈0，改消费面清点 + 一致性校验 | +| 「棋盘格 44px 冻结不动」 | 代码无固定常量；= 动态公式 clamp[26,46]，与 §8.1 锚点 45 冲突 | P2 实为「三方取值互不等」的三选一，不是「动/不动」 | +| 「站桩溢出 3.2px」 | demo CSS 缺陷，**但实机存在 1px 余量同型写法**（F10） | 收项改为「纵向余量纪律 + 探针断言」，不是直接改一行数值 | +| 「缺 10 枚手绘图标」 | 已入库（20×20） | C 亚组「图标入库」部分注销；真问题转为 64×64 柜台四枚的显示倍率（P6） | +| OPT-A §6①「`--candle` 归属待裁」 | `CANDLE` 已新增（`ui_kit.gd:68`）+ art-bible §7.2 双岗注记 | 已决（甲案），注销 | +| 「棋盘格 44px 冻结不动 / 32 / 45 三选一」 | **已裁（2026-10-05）= 丁案零改动**：`board_view.gd:251` `clampi(cell,26,46)` 与全部棋盘绘制一字不改 | ①T7 卡删除格边长子项；②**新增已知偏差**：代码上限 46 / §8.1 锚点 45 / demo 44 三者不一致，本批不单侧改条款（R7），登记 06 待扩板定档时随格边长专项一并处置 | + +--- + +### 2.2 demo（原型 v2.1）取值抄录表 —— 本批唯一引用源 + +> **Q9 丙案（2026-10-06）**：demo 文件已被保存多次（整合对照记 `4cc45cf3` / OPT-A 记 `d2addb67` / 2026-10-05 实测 **`78ebbee0…`**）。本批**不再回读 demo 文件**——所需取值一律以本表为准；**T0 只核一次 md5 留痕**（若又变，登记注记即可，**不停机**）。 + +| demo 源 | 值 | demo 行号 | 本批用途 | +|---|---|---|---| +| `--bg-root` | `#3A2E22` | :16 | P1 已裁（代码同值，零改动） | +| `--bg-overlay` | `#362B20` | :16 | P1 已裁（同上） | +| `--warm-soft` / `--warm-faint` | `#E8D5A8` / `#CDB88C` | :10 | 已收（M0） | +| `--panel` | `#E9D9B8` | :12 | **P7 乙**：`PANEL_DATA` 改向此值 | +| `--panel-edge` | `#786E58` | :12 | **P7 乙**：`PANEL_BORDER` 改向此值 | +| `--slot-back` | `#3E362C` | :18 | **P7 乙**：`SLOT_BACKDROP` 改向此值 | +| `--hp-back` | `#282220` | :18 | **P7 乙**：`HP_BAR_BACK` 改向此值 | +| `--wood-deep` | `#6E4526` | :11 | **P7 乙**：`CAMP_HEADER_BAND` 改向此值 | +| `--candle` | `#F6C667` | :11 | 已落 `CANDLE`（M0） | +| `--tg-buff/heal/magic/pierce/aoe` | `#C2B264` / `#66A457` / `#8A72C4` / `#57A0A0` / `#E25676` | :19 | **N4c**：立 `TG_*` 五族（前四族 = 实机现值） | +| `.plate9` | border 12 / slice **16** | :59 | **P4 乙**：`texture_margin` 8 → 16 | +| `.btn9` | border 11 / slice **16** | :61 | button 维持 8/8（**不跟**） | +| `.bcard` | 232×352 | :204 | **§8.3-E D1**，不入本批 | +| 棋盘网格 | 44px / gap 2 | :288 | **P2 已裁零改动**（不跟） | +| 字号分布 | 10×2 / 11×6 / 12×15 / 13×11 / 14×12 / 15×8 / 16×6 / 17×8 / 18×3 / 19×3 / 20×2 / 21×2 / 22×2 / 24 / 28 / 44 | — | **P3 不跟**（34 处 <14、54 处 <16） | + +--- + +## 3. 收项清单（无分歧、可直接收的部分） + +> 全部为「数值中性」或「单点收口」，不依赖 §8 待裁点；除 N4b 受 P7 影响。逐项 file:line 已核证。 + +### N1 · 7 处对比度 FAIL 修法（已复算，据整合对照 §四 + OPT-A §2.2） + +| # | 位置 | demo 读数 | 实机落点 | 修法 | 复算 | +|---|---|---|---|---|---| +| 1 | 站桩血数 | 2.09:1 | `standee_body.gd:438-439`（压 `:432` fill） | 数字**改压深底色牌**（在条中央按字宽 +6px 画 `HP_BAR_BACK #28221C` 素牌，再写字；牌宽随 `get_string_size`）；**字号维持 11px**（条高仅 10px，放不下 16px）——按 **Q5 甲案**在 §7.4 登记「条带内读数」豁免，**与 P11 装饰 caption 豁免写成同一条款** | → 12.29 | +| 2 | 敌血数 | 4.04:1 | 同上同分支（实机敌我同色，T0 确认） | 随 N1-1 一并成立；若 T0 发现敌方独立分支则同法 | → ≥4.5 | +| 3 | 意图 atk | 3.96:1 | `standee_body.gd:172` `RED_MINE #96362C` | 底色降一档 → `RED_DEEP #963C30` | → 5.50 | +| 4 | 意图 buf | 2.94:1 | `standee_body.gd:175` `HERO_BLUE #2E86DE` | 底色降一档 → `#1E5A96`（作为 `HERO_BLUE` 的同族深档新增入 `ui_kit.gd`，命名规则同 `CONTACT_GLOW_DEEP`） | → 5.55 | +| 5 | 槽「已用」 | 1.90:1 | `hero_info_panel_view.gd:200` `STONE_FAINT` | 提档 → `WARM_FAINT` | → 4.95 | +| 6 | 槽「空」 | 1.34:1 | `hero_info_panel_view.gd:202` `STONE` | 提档 → `WARM_FAINT`（与 #5 同档）。**Q6 乙案：不新增通道**——沿用现行语义（空 = 虚位无字形 / 已用 = 暗字占位），只提墨色 | → 4.95 | +| 7 | RAP 标签 | 4.10:1 | `ap_bar_view.gd:74` | 显式传色 → `CONTACT_GLOW_DEEP`（`ui_kit.gd:59`） | → 5.63 | + +**依据**：art-bible §7.2(:404)「一切文字（无区域例外）对直背景 ≥4.5:1」+「文字禁直接压纹理底」；§4.1 数字色牌原则（数字一律垫牌，可读不依赖底）。**零口味成分。** + +### N2 · 站桩垂直余量纪律（3.2px 等价物） + +- 实机「声明值刚好=容器值」高危写法：`standee_body.gd:26`（box 高 176 且随壳层注入）+ `:476`（名行基线 = 盒底 −1px）+ `:417-419`（底座贴盒底 18px 内）。 +- 落法：名行 / 底座的整体纵向预算加 **≥8px 余量**（`:476` 名行基线上移，或 box 高略增），余量写成具名常量 `STANDEE_FOOT_MARGIN`（放在 `standee_body.gd` 常量区，取值不属色板，不进 `ui_kit.gd`）。 +- 断言：`ui_struct_probe` 增一族「B 区站桩内容矩形 ⊆ 252px 舞台矩形，且下边距 ≥8px」。 + +### N3 · status 图标 preload → load_tex（单独可切分） + +- `status_slot_row.gd:21-29` 九枚 `preload` → 改 `EFFECT_ICON` 存**路径串**，`_icon_tex()` 现调 `UiKit.load_tex(path)`（`ui_kit.gd:171`）。 +- 保持 `_icon_tex` 立即断言面不变（`:195-196` 未知键 push_error + assert）；保持 `res://assets/ui/icons/` 路径不变、**不搬运素材、不改动素材文件**（美术红线）。 +- **可独立成 micro-loop**，不混入本批主体。 + +### N4 · 色板单点收口 + +| 子项 | 内容 | 依赖 | +|---|---|---| +| N4a | **4 处漏网裸色收进 `ui_kit.gd`**：`board_cell_unit.gd:79` `E_FACADE_FOOT_COL #342A20`、`:114` `FOG_MEMORY_PLATE #3A3A3A`、`:115` `FOG_MEMORY_INK #C4C4C4`、`:138` `oc #1E1812` 轮廓墨；另有 `level_map_screen.gd:36` `ICON_TINT_ON_GOLD`（以 `INK_ROUTE` 分量除法写成的乘法调制色，形态上仍是裸取色）——共 5 处（原整合对照记「4 处」，实查为 4+1）。**取值原样搬运，零观感变化** | 无 | +| N4b | **5 处未收漂移**（F2 表）——**取向已定：取 demo 侧**，5 个 token 改向 demo 值（Δ≤6/255，目视不可辨） | ✅ P7 = 乙 | +| N4c | **类型色五族立项 `TG_*`**：新增 `TG_BUFF #C2B264` / `TG_HEAL #66A457` / `TG_MAGIC #8A72C4` / `TG_PIERCE #57A0A0` / `TG_AOE #E25676`（第五族取 demo `--tg-aoe`，`:19`），替换 `bonus_pick_overlay.gd:96-102` 与 `shop_overlay_view.gd:189` 内联裸色；`bcard` 色带消费面同步。**Q4 甲案**：`shop_overlay_view.gd:189` 现行全用固定 `#C2B264`、**不分族**——同步补分族判定（与三选一同款 `idl.contains(...)` 匹配），使**五族都有消费面**（否则违 R1「先立常量再消费」） | 无（四族 = 实机现值、第五族 = demo 冻结值，取值零争议） | + +### N5 · 面板皮消费面清点 + 圆角率自检（不改值） + +- 对 F5 的 8 处消费点 + 未消费面逐一造册（哪面板该穿戏服、哪数据框该素面），依据 art-bible §7.1 判据「圆角=可触摸的物件，直角=须精确的信息」。 +- 圆角值实测量（起草时点 `panel_flat` 第三参）：**0 / 2 / 3 / 4 / 5 / 6 / 17 / 200** 八种；其中 17（标题屏底座椭圆）/ 200（结算金印，即 §7.1 的「圆形蜡封」）属条款明示的例外；真正的问题是余下 0/2/3/4/5/6 六档并存，与 §7.1「全 UI 恒定圆角率」本身就不一致。**是否收敛待 P5**。 + +### N6 · 既有纪律零回退（验收项，非改动项） + +`ui_kit.gd:258` min_w=216 + SIZE_FILL、9 处豁免、`ui_struct_probe` 五族断言、模态登记纪律（F14）全部原样保持；本批任何结构改动后必须复跑全绿。 + +--- + +## 4. 范围边界（🔴 不可越界） + +| 禁项 | 理由 | +|---|---| +| 🔴 **零美术资源改动** | 用户 2026-10-05 立规。`game/assets/art/**`、`game/assets/ui/**`、`artwork/**` 三个目录内一切文件只读：禁改名、禁重烘/重采样/重 quantize、禁新增删除、禁重新导出。允许的只有 Godot `--import` 重刷类名缓存（已在 .import 目录，不属素材文件） | +| 🔴 **不改核心层** | 禁碰 `game/core/**`、`game/data/**`（`ui_kit.gd` 追加单点常量不属此列）；本批为零逻辑变更的纯呈现批 | +| 🔴 **不改游戏数值** | 棋盘格边长若裁一个新值，只能是呈现层 `set_cell_area` 的 clamp/定值档调整，不得反馈到排雷玩法、装板校验以外的任何逻辑，也不重跑任何验收读数闸（MC 零跑） | +| 🔴 **不新开键盘/输入通道** | 排期 Beta（06「棋盘战斗键盘/手柄输入」条在册） | +| 🔴 **不动冻结条款而不双侧落文** | 若裁决要求改 art-bible §7.1/§7.2/§7.4/§8.1/§8.2 或 HUD框架格边长条款的冻结值，必须**代码与文档同批双侧落文**，禁单侧改完留下「两边说法不一致」的漂移 | +| **不触碰迭代 15② 在飞文件** | 奇物批实施段仍在迭代 15；T0 复核文件交集，命中即停机呈报 | +| **不做原型侧的交互形态改动** | C 区两段、战报形态、商店刷新/库存、失败结算奖励行均已由 v2 落码 §七 终裁（见 §8-P9 注销清单），本批不重开 | + +--- + +## 5. 设计契约（🔴 触碰 = L3 停机） + +| # | 契约 | 验证方式 | +|---|---|---| +| 🔴 R1 | **色板单点**：一切取色经 `UiKit` 常量；新增取色先立常量再消费；呈现层裸 `Color8(` 目标清零（过渡期只允许 §3-N4a 白名单内的在册处） | 静态计数 + review | +| 🔴 R2 | **资源红线**：素材一律 `UiKit.load_tex`（exists 守卫 + null 回退）；呈现层 `preload` 素材 = 0；**素材文件零改动** | 静态 grep + 冒烟 | +| 🔴 R3 | **对比度硬指标**：一切文字对直背景 ≥4.5:1（§7.2 无区域例外）；文字禁直压纹理底——须垫容器/色牌 | §7.2 T0/T2 机检脚本实跑 | +| 🔴 R4 | **宽度与探针闸零回退**：`UiKit.button(min_w=216)` 语义不动；新增布局改动后 `ui_struct_probe` 五族断言零红（含 modal 屏 `queue_sort` 强制手法） | probe_gate 默认段 | +| 🔴 R5 | **模态登记纪律**：若本批新增任何层，必须走 `_register_modal` + `_open_modal` 单口（禁绕栈直开，迭代 6 卡⑨事故先例） | ui_click_probe | +| 🔴 R6 | **减动效遵守**：本批落的一切动效/呈现补间经 `UiKit.motion()` 包装（`ui_kit.gd:115`）；新增的呼吸/浮动/抖动面一律是无时长书写的静态表现，不新增第二个动效开关 | settings_store 双态断言 | +| 🔴 R7 | **文档双侧同步**：任何触及 art-bible §7.1/§7.2/§7.4/§8.1/§8.2 或 HUD框架格边长条款的裁决，同批落文，零「代码一套文档一套」 | doc 三闸 + 人工复核 | + +--- + +## 6. 任务卡（逐卡一个 loop 轮次） + +> 估时按「裁决要求实装」计；若某裁点裁决为「维持现状」，对应卡退化为一行注记（≈0.1d）。 +> 依赖列：`—` = 无阻断（可直接发令）；`P#` = 依赖 §8 对应裁点。 + +| 卡 | 内容 | 依赖 | 估时 | 轻闸 | 完成判据 | +|---|---|---|---|---|---| +| **T0** | 开工：worktree + **基线重测回填**（冒烟/run_all/三探针/doc 三闸/熵增）+ §2 事实表 15 项复核（重点 F2/F3/F6/F7/F9/F10/F15）+ 与迭代 15② 文件交集核对 + **demo md5 重核（留痕一次，此后不回读 demo 文件——Q9 丙）+ 7 处对比度实机重跑（替换 demo 读数）** | — | 0.25d | 冒烟基线 | 基线回填表；demo md5 与行号漂移注记；交集零命中或停机呈报 | +| **T1** | N3 preload 红线批（`status_slot_row.gd:21-29` → 路径串 + `load_tex`）；**可单独切分 micro-loop** | — | 0.25d | 冒烟 + ui_struct | §1.2-2 | +| **T2** | N1 对比度七处修法落码（含 T0 实机读数回填校验）+ 新增 UI 文字对比度机检脚本入轻闸 | — | 0.75d | 冒烟 + 机检 + ui_struct | §1.2-1 | +| **T3** | N2 站桩纵向余量纪律（`:26`/`:417-419`/`:476`）+ 站桩不出框断言入探针 | — | 0.25d | 冒烟 + ui_struct | §1.2-4 | +| **T4a** | N4a 五处漏网裸色收 `ui_kit`（原值搬运，零观感）+ N4c `TG_*` 五族立项并替换两处内联 + **商店补分族判定**（Q4 甲） | ✅ | 0.65d | 冒烟 + ui_struct | §1.2-3/5 前半 | +| **T4b** | N4b 五处漂移**按 P7 乙案改代码向 demo**（`PANEL_DATA`→`#E9D9B8`、`PANEL_BORDER`→`#786E58`、`SLOT_BACKDROP`→`#3E362C`、`HP_BAR_BACK`→`#282220`、`CAMP_HEADER_BAND`→`#6E4526`）+ art-bible §7.2 同步注记 | ✅ P7=乙 | 0.5d | 冒烟 + ui_struct | §1.2-3 | +| **T5** | N5 面板皮消费面清点 + **P4 乙案：`ui_kit.gd:286` `texture_margin` 8 → 16**（button 维持 8）+ **Q1 丙案 `panel_skinned()` content margin clamp（工厂单点，调用点零改）** + P5 甲案圆角收敛为单一 `RADIUS_OBJECT` + 文案双侧落文 | ✅ P4=乙 / P5=甲 | 0.75d | 冒烟 + ui_click | §1.2-7 前半 | +| **T6** | 字号档位表 `FS_*` 立项 + 全库裸字号替换 + 低于 §7.4 下限的 26 处提档（含 decorations caption 豁免与否） | ✅ P3=甲 | 1.0d | 冒烟 + ui_struct/ui_layout | §1.2-7 中 | +| **T7** | ①**P6 甲案缩放纪律**（64×64 柜台四枚→**统一 32px**、50×52 地图头像→高定宽随、56×56 BCard 槽→40px、32×32 状态与瓦片）②**P10 乙案记忆态**：`board_cell_unit.gd` `_draw` 新增「地板纹理 + 灰罩 α.66」合成层 + 复跑记忆墨对比 ≥4.5:1 ——**棋盘格边长已裁零改动，不在本卡**；§8.2 例外登记随批落文 | ✅ P6=甲 / P10=乙 | 1.0d | 冒烟 + ui_struct + board_shot | §1.2-7 后半 | +| **T8** | **P8 甲案：只做卡顶类型色带试点**——`bcard` 的 `band` 随各 `TG_*` 逐卡生成 Bayer 有序抖动带（α 由深至 0）。**不跟 demo 的 CSS 渐变/blur**；B 区光柱与全站抖动留作后批 | ✅ P8=甲 | 0.5d | 冒烟 + ui_struct + board_shot | §1.2-7 末 | +| **T9** | 重闸：全量轻闸（含 ui_struct/ui_click/ui_layout/ui_input）+ doc 三闸零新增 + 熵增闸 | — | 0.25d | 重闸全绿 | §1.2-8 前半 | +| **T10** | 人闸：实机目检清单（**§1.4 整屏样张闸四项并入——Q2 乙** + 八屏对比 QA + 站桩不裁 + 对比度机检抽测 + 棋盘清晰度 + 1920 档复验 + 减动效双态）+ 代拍板追认 | — | 0.5d | 目检过 | §1.2-8 | +| **T11** | 收口五步 + 06/roadmap 状态行收口 | — | 0.25d | — | 收口齐 | + +> **估时合计 ≈ 6.9d**（T0-T11；2026-10-06 定取向后重算：T4a 0.5→**0.65d**〔Q4 甲商店补分族〕、T7 0.75→**1.0d**〔并入 P10 记忆态〕、T8 1.25→**0.5d**〔P8 取甲仅卡顶试点〕）。知情预挂：**超软盒 3 日上限**，必须拆段。 +> **三段切分预案**： +> - **段一（无阻断）** = T0 + T1 + T2 + T3 + T4a ≈ **2.15d** —— 自然切分点 **T4a 末**（此时已收完全部无分歧项，可交付一版「合规达标 + 单点收口、但视觉几乎未变」的中间态，用户可先行目检确认方向）。**全部裁点已定取向，段一可随时发令。** +> - **段二（取向依赖）** = T4b + T5 + T6 + T7 + T8 ≈ **3.75d** —— 自然切分点 **T6 末**。 +> - **段三（收口）** = T9 + T10 + T11 ≈ **1.0d**。 +> **不入本批**：§8.3-C 三条结构级差异（卡片 232×352 / 商店全屏化 / 地图底栏合并）已登记 06 待立项，不占本批估时。 +> **合并方式（Q7 甲案）**：三段 = **同一迭代内的三个任务卡组，只在段三末合并一次**（段间不合并、不占额外迭代位），符合 roadmap「一迭代一 loop、一次合并登记」纪律。 + +--- + +## 7. 验证闸 + +- **轻闸**（每轮）：run_smoke 全量 + ui_input_probe + **ui_struct_probe**（本批触 presentation，加跑 ui_click_probe + ui_layout_probe）。 +- **新增机检段**（T2 起入轻闸）：①UI 文字对比度机检（无区域例外 ≥4.5:1）②呈现层裸 `Color8(` 计数与白名单比对 ③呈现层素材 `preload` 计数 = 0。 +- **整屏样张闸（§1.4）处置 = Q2 乙案**：**不走独立样张闸**——demo v2.1 八屏本身即方向稿且已获用户验收，「方向稿目检先行」这一环在 demo 阶段已完成；改为把 §1.4 四项（文字对比 ≥4.5:1 / 明度分层三档带 / 整屏焦点预算首焦唯一 / 文字禁压纹理底）**原样并进 T10 人闸目检清单**，机检冻结随 T9 重闸一起做。 +- **重闸**（T9）：全量轻闸 + doc 三闸零新增 + 熵增闸。 +- **MC**：纯呈现批，零数值零 RNG 消费变化 → **零 MC**（两入口铁规 + 无数值改动禁跑 MC）。若 T7 落 32px 导致装板校验/ `set_cell_area` 公式范围变更，仍不适用 MC（不改游戏逻辑），但须补「同一 seed 逐位一致」的结构类断言。 + +--- + +## 8. 代拍板白名单与裁点（P1/P2 已裁 · 其余八项取向已定） + +### 8.1 白名单内（实现层无争议项） + +- 新常量命名前缀与摆放顺序（`FS_*` / `TG_*` / 色板族内按语义族分组） +- 探针 case 编号与断言文案 +- 对比度垫牌的确切几何（宽 = 字宽 + N px，N 由 6/8 二选一） +- 未消费 `panel_skinned` 的面板补面顺序（按 §7.1 判据逐面判定即可） +- 抖动引擎的 Bayer 矩阵阶数（4×4 / 8×8）——**范围已由 P8 裁决**，矩阵阶数属实现细节 +- **`RADIUS_OBJECT` 取值 = 5**（2026-10-06 代拍板，**可推翻**）：与 `primary_button` / `danger_button` 现用 5px 同值（`ui_kit.gd:358` / `:374`），面板与按钮同圆角率即满足 §7.1「全 UI 恒定圆角率」；若 T5 目检嫌大改 4 +- **未消费 `panel_skinned` 的面板不强制补皮**（2026-10-06 代拍板）：按 §7.1 判据逐面判定——容器/分组框穿戏服，数据框/准线/进度条保持直角素面；判定结果随 T5 造册留痕，**不追求「全部补皮」**（WB 的「补到 9 处」是数量目标，不是判据） +- **新增机检脚本落点** = 新建 `game/smoke/ui_contrast_probe.gd`，并入 probe_gate 默认必跑段（与 `ui_struct_probe` 并列，不合并） +- **R7 文档双侧清单（本批要改的文档）**：P3 字号档位 + P11 装饰 caption 豁免 + 站桩血数「条带内读数」豁免 → **§7.4(:417)**；P7 五处色板 → **§7.2(:404)**；P10 记忆态 → **§6.5(:378)**；P6 例外登记 → **§8.2(:438)**；P4 九宫格切片 → art-bible 无既有条款，**新增注记** + +### 8.2 裁点归档 ✅（全备选案 + 淘汰依据；P1-P11 已全裁） + +> **进度（2026-10-06 更新）**：P1 / P2 **已裁**；其余 8 项**取向均已定**（用户采纳推荐，见各小节首行）——**P4 / P7 / P10 跟 demo**，**P3 / P6 / P8 / P11 按条款解**，**P5 两路同结论**。**适用范围、例外与三条不入本批的结构级差异 = §8.3。** + +#### P1 · 底色冷暖（对照 §三①）—— ✅ 已裁，取甲案 + +> ✅ **用户裁决（2026-10-05）**：取**甲案**——维持现行 master 暖化三件套（`BG_ROOT #3A2E22` / `BG_OVERLAY #362B20` / `BG_BRIGHT #453723`）+ `CANDLE` + `WARM_*` 全套，demo 与 OPT-A 的近黑案作废。本项代码**零改动**；下表留档备查。 + +| 案 | 内容 | 依据 | +|---|---|---| +| **甲（推荐）** | **维持现行 master 暖化**三件套 `BG_ROOT #3A2E22` / `BG_OVERLAY #362B20` / `BG_BRIGHT #453723`（`ui_kit.gd:65-67`）+ `CANDLE` 与 `WARM_*` 全套；demo 与 OPT-A 的近黑案作废 | ①已是 2026-10-04 M0 批落码结果，art-bible §7.2(:410) 已立「琥珀双岗注记」写明系主动取舍防回改；②这正是 OPT-A §6③ 自注的答案（「若认为暖化方向对，则应改代码而非改 demo」），M0 照此执行；③回退 = 推翻一个已合并批 + 改冻结注记，成本最高收益负 | +| 乙 | 回退近黑 `BG_ROOT #1E1914` / `BG_OVERLAY #1C1612`（OPT-A §5 P1-T1「以代码为唯一来源」） | OPT-A 该提法成文于 M0 **之前**，其前提（代码未改）已不成立；且 OPT-A 自承此案需「重开一个色板批」——若用户真要近黑，应作独立色板批重商，不塞在本批 | +| 丙 | 中间档折衷（如 `#2C2419` 级） | 两侧都不讨好：既推翻 M0 冻结值，又不回到 OPT-A 提案值，属于凭空造第三个未评审值，两侧都不讨好，评估成本最高。**淘汰** | + +#### P2 · 棋盘格边长（对照 §三②）—— ✅ 已裁，取丁案（零改动） + +> ✅ **用户裁决（2026-10-05）**：取**丁案**——`board_view.gd:251` 的 `clampi(cell, 26, 46)`、`:114` 默认 46.0、`board_cell_unit.gd:13` 与全部棋盘绘制**一字不改**；本次不动棋盘游戏画面。 +> 随之确定三件事：①T7 卡删除「棋盘格边长」子项（缩为纯缩放纪律）；②三方取值不一致（46/45/44）作为**已知偏差**登记（§2.1 + 06），本批不单侧改 HUD框架条款；③P6 若裁出「显示尺寸变化」，仍不得反向改动格边长。下表留档备查。 + +> 事实前提（F6/F7）：三方取值互不等 —— 代码 = 动态公式 `clampi(cell, 26, 46)`（`board_view.gd:251`）；demo = 44px（html:288）；冻结条款 = art-bible §8.1(:433) 锚点 45(10×10)/36(12×12) + HUD框架:72 装板校验区间 [30,45]。 + +| 案 | 内容 | 依据 | +|---|---|---| +| **甲（推荐）** | **保留动态公式，把 clamp 上限 46 → 45**（对齐冻结条款的定值档），T0 实测登记 10×10 / 12×12 两板的实际落值；demo 的 44px 在文档中标注为「原型参考值，非条款」 | 唯一同时满足三方约束的写法：HUD 定值 45 与校验区间 [30,45] 都守住，动态公式仍能在扩板（13×13/14×14，§8.1 注明换算值未定稿）时兜底。代价：32×32 瓦片在 45px 格为 **1.406×**，属甲类非整数，须在 §8.2 追加一条与「1920 档 1.35× 例外」同级的接受代价注记 | +| 乙 | 定值 **32px**（OPT-A §6②甲）——32×32 瓦片 1× 整数倍，甲类缩放硬规则全绿 | 32 落在装板区间 [30,45] 内**合法**，是唯一能让甲类纪律零违规的取值；但推翻 §8.1 两个冻结锚点（45/36），棋盘可视面积较 45px 缩约 29%，且 12×12 板能否塞进须重跑装板校验。**收益（纪律合规）明确、代价（版面缩水）也明确，请用户按优先级排序裁决** | +| 丙 | 定值 **45px / 36px** 两档、**取消动态公式**（整合对照 C 侧 §8.1 锚点意旨） | 严格贴条款，但与甲的区别只在「是否保留公式」：一旦扩板定档，没有公式兜底就得再改一次，反而多一轮改动。建议并入甲一并考虑（保留公式 + 上限 45，观感与丙等价，且留了兜底） | +| 丁 | 维持 clamp[26,46] 一字不改 | 现行上限 46 **已越出** HUD 定值 45，是实机与条款之间的一条既存不一致（只是当前未被断言触发）。选丁本身不是问题，但**必须同时在 HUD框架:72 把 46 写进条款**，否则这条不一致会一直挂着 | + +#### P3 · 字号档位（对照 §三③） + +> ✅ **取向已定（2026-10-06 用户采纳推荐）**：取**甲案**——立 `FS_*` 档位表（12/14/16/18/24/34）。**不跟 demo**：demo 字号实测 10×2 / 11×6 / 12×15 / 13×11 / 14×12 / 15×8，**34 处低于 §7.4 tooltip 下限 14、54 处低于正文下限 16**，跟了即批量引入条款违规。P11 已裁给豁免 ⇒ 12 档保留。 + +> 事实前提（F8）：实机实测 15 个裸字号档，其中 **26 处低于 §7.4 下限**（正文/明细 ≥16、tooltip ≥14、棋盘数字 ≥18）。两案各自的六档里**都含**低于 §7.4 下限的档位，须先在 P11 取得豁免才能成立。 + +| 案 | 内容 | 依据 | +|---|---|---| +| **甲（推荐）** | **混合案**：`FS_CAPTION 12` / `FS_HINT 14` / `FS_BODY 16` / `FS_SUB 18` / `FS_TITLE 24` / `FS_H1 34`（WB G1 六档）；若 P11 不给豁免，则降为从 14 起的五档 | 档数最少、语义名可读；12/14 两档正好对应装饰位与 tooltip 下限，16/18 两档对应正文与棋盘数字下限，改动面集中在「低于下限」的那 26 处而非全库 | +| 乙 | OPT-A 六档 `12/16/24/32/40/48` | 缺 14/18/20/22 档，现有 13/15/17/20/22/26 六档会被迫就近上跳/下坠，**实际改动面比甲更大**；且同样依赖 P11 给 12 档豁免。保留为备选 | +| 丙 | 保守下限档 `14/16/23`（整合对照 C 侧口径） | 23 是棋盘数字在 45px 格的下限值（`ceil(45×0.5)`），但它是**一个画面某一处的下限值、不是全站 type scale**，单独成案会漏掉绝大多数文字位。降级为甲内部的一档取值 | +| 丁 | 不立档位表，只在现有 15 档上逐处「低于下限者提档」 | 能达标但不治根：下一次新界面仍会漂出第十六档。**淘汰**，除非用户只想做最小改动作为过渡 | + +#### P4 · 九宫格切片值（对照 §三④） + +> ✅ **取向已定（2026-10-06 用户采纳推荐）**：取**乙案**——`ui_kit.gd:286` panel `texture_margin` 8 → **16**，与 demo `.plate9` slice 16 对齐；button 维持 8/8。属 §8.3 判定「**跟 demo**」。代价：面板边角占比变大，已目检通过的面板观感会变，须随 T5 一并目检。**连带（Q1 丙案）**：`panel_skinned()` 工厂内加 **content margin clamp**——content margin < `texture_margin` 时自动抬到 `texture_margin`。依据：实查 9 处消费点中 **7 处 content margin < 16**（`hero_info_panel_view.gd:34` `(8,6,8,6)`、`battle_stage_view.gd:93` `(12,4,12,4)`、`ui_kit.gd:401` `(12,10,12,10)` 等），不处理则内容压到石框纹理上。调用点零改。 + +> 事实前提（F4）：实机 `texture_margin` 恒 8（panel `:286` / button `:327-331` / frame `:299` = 12）；素材 `panel_stone.png` 与 `button_stone.png` 实测均 **48×48**；demo `.plate9` border 12 / slice 16（html:59）、`.btn9` border 11 / slice 16（html:61）。 + +| 案 | 内容 | 依据 | +|---|---|---| +| **甲（推荐）** | **维持实机 8 不动**，把 demo 的 slice 16 判定为原型侧偏差 | ①48×48 源在 margin 8 下，四角 8×8 足以承载石块纹样，中间拉伸区 32px，宽裕；②改 16 会把中间拉伸区压到 16px，大面板（如营地 372px 三柜台列）拉伸时纹理中心带被压缩；③WB 变体自己第 1 行的结论就是「实机 8 是对的 → 原型向实机对齐」，与本案同指 | +| 乙 | panel `texture_margin` 8 → **16**（WB 变体 §四.1），button 维持 8 | demo 侧选 16 的动机是「边缘 1:1 不插值」；Godot `StyleBoxTexture` 在 margin 8 下同样是边角原位、中段拉伸，不存在 demo 那种浏览器 border-image 的缩放插值问题。属纯口味差异，且会不可逆地改变现行已目检通过的外观。**保留备选** | +| 丙 | panel 与 button 全部改 16 | 同乙且波及面更大——按钮是全站最高频件。**淘汰** | + +#### P5 · 圆角去留（对照 §三⑤） + +> ✅ **取向已定（2026-10-06 用户采纳推荐）**：取**甲案**——语义不动、数值收敛为单一 `RADIUS_OBJECT`（4 或 5，T5 目检定）；数据类保持 0；底座 17 / 金印 200 属 §7.1 例外保留。本项**跟不跟 demo 结论一致**（demo 容器走石板皮、主/危钮 5px，实机已等价）。 + +> 事实前提（N5）：实机圆角值实测并存 **0/2/3/4/5/6/17/200** 八种；art-bible §7.1(:395) 判据 =「圆角 = 可触摸的物件，直角 = 须精确的信息」，面板 = 石板圆角矩形（**全 UI 恒定圆角率**），数字框/准线/进度条一律直角细线。**B 侧与 C 侧引的是同一条款的不同半句**，不是两条互相冲突的条款。 + +| 案 | 内容 | 依据 | +|---|---|---| +| **甲（推荐）** | **语义不动、取值收敛**：容器/按钮 = 单一 `RADIUS_OBJECT`（4 或 5，由 T5 目检定）；数据框/数字牌/AP 点阵/准线/血条 = 0（直角）保持；底座椭圆 17 / 结算金印 200 属 §7.1 明示例外，保留 | 双方要的东西实机**各自都已成立**：B 侧要的「精确信息直角」在实机已是 0，C 侧要的「圆角为世」在容器面已是圆角。真实遗留问题是六个不同数值并存，与「全 UI 恒定」不自洽——这一步的工作是**把数值收敛成一个**，不是改谁的语义 | +| 乙 | 按 B 侧扩展到开关/滑杆/血条/数字牌去圆角 | 实机这些件本就是 0/2（`switch_toggle` 轨道 3 / `styled_slider` 0 / 血条 `_draw` 矩形 0），可落空间极小；**降级为甲内部的子项**，不单列 | +| 丙 | 全站统一单一圆角（连数据框也倒圆角） | 直接违反 §7.1「数字框、准线、进度条一律直角细线、无纹理」。**淘汰** | + +#### P6 · 图标尺寸解法（对照 §三⑥） + +> ✅ **取向已定（2026-10-06 用户采纳推荐）**：取**甲案**——分族定显示档（纯代码、零素材改动）。**demo 不能当标准**：demo 自身同样是 64→20（0.3125×）与 32→16（0.5×）非整数倍违规，跟它等于继承违规。 + +> 事实前提（F12）：手绘十枚 **20×20 已入库**；柜台四枚 `icon_forge/workshop/atlas/keystone` **仍 64×64** 而显示 20px（0.3125×）；状态九枚 32×32 → 显示 24px / 16px（0.75× / 0.5×）；BCard 图标槽 56×56 吃 20×20（2.8×）；地图头像 50×52 吃 46×48（纵横异倍）。**红线：素材一字节都不能改** ⇒ 唯一可调的是「显示尺寸」。 + +| 案 | 内容 | 依据 | +|---|---|---| +| **甲（推荐）** | **分族定显示档（纯代码，零素材改动）**：①手绘十枚 → 20px(1×) / 40px(2×) 双档，全部消费点二选一；②柜台四枚 64×64 → **统一 32px（0.5×）**，在 §8.2 登记一条例外（「64 源在 32 位 0.5×，待美术批出 32 源后消除」）——**Q3 甲案已关掉「32 / 64」二选一**；③状态九枚 32×32 → 常规档显示 **32px(1×)**；**mini（站桩）档维持 16px**，与 ② 共用同一条 0.5× 例外登记——实算：站桩宽 150px（`standee_body.gd:26`），4 槽 ×32px + separation 6×3 = 146px，**几乎无余量**，故 mini 档不动；④BCard 槽 56 → 40px(2×)；⑤地图头像改「高定宽随」：定高 48px(1×)，宽随源图比自适应（46×48 → 46×48，纵横异倍消除） | 唯一不破红线的路径。代价是若干位置的体积变化会带来连带布局微调（营地头带、BCard 卡面、B 区状态槽），需要 T7 一并目检确认不挤压既有结构（由 `ui_struct_probe` 兜底） | +| 乙 | 素材重烘 32/20 两族（OPT-A §2.3 修法） | 甲类纪律最干净的解，但**直接撞美术红线**（`game/assets/art/**` 不动）。本批不可选；改登 06「图标素材族重烘」条目，交用户自理的美术批 | +| 丙 | 64px 源 ÷2 显示 32px（WB G10） | 与甲②同解，但 WB 原文同时要求「资产批同步出 32px 变体」——去掉那半句后即等于甲②。**并入甲，不单列** | +| 丁 | 维持现状 + 在 §8.2 登记容留 | 现状四处均属甲类硬规则违规（0.3125× / 0.75× / 0.5× / 纵横异倍），容留等于承认条款破口。**淘汰** | + +#### P7 · 色板唯一来源（对照 §五） + +> ✅ **取向已定（2026-10-06 用户采纳推荐）**：取**乙案**——**demo = 唯一来源**，5 处改代码向 demo。属 §8.3 判定「**跟 demo**」。**demo 文件一个字节不动**（artwork 只读红线）；五处 Δ 值均 ≤6/255，目视不可辨。 + +| 案 | 内容 | 依据 | +|---|---|---| +| **甲（推荐）** | **代码 = 唯一来源**；demo 侧 5 处未收漂移值（F2）**一律作废**。demo 的处理方式有两种落法：①**不动 demo 文件**（本任务书 §2.1 已记明这 5 处作废）；②在 demo 顶部加一行注记说明「此 5 值实机取值为准，demo 值作废」。**推荐①**——不动 demo 文件更符合「artwork 只读」红线 | 「单点」纪律本身已冻结（`ui_kit.gd:3` 头注）；demo 是方向稿，不能反向约束实现；且 M0 已经示范过一趟：当时向 demo 对齐的那些 token，落地方式也是**改代码**而不是改 demo | +| 乙 | demo = 唯一来源；5 处改代码向 demo（`PANEL_DATA`→`#E9D9B8`、`PANEL_BORDER`→`#786E58`、`SLOT_BACKDROP`→`#3E362C`、`HP_BAR_BACK`→`#282220`、`CAMP_HEADER_BAND`→`#6E4526`） | 与 M0 已经走通的方向相反，会造成「同一份 UI 里两套追求并存」；且五处 Δ 值均 ≤6/255、**目视几乎不可辨**，为此改 5 个消费面很广的 token 性价比极低 | +| 丙 | 逐个议：5 处各按明度差大小分别取向 | 无原则可依，下一次还会再漂一次。**淘汰** | + +#### P8 · 抖动呈现范围（对照 §五） + +> ✅ **取向已定（2026-10-06 用户采纳推荐）**：取**甲案**——只做卡顶类型色带试点（≈0.5d），与 `TG_*` 五族耦合一次落到 `bcard`。**不跟 demo**：demo 的 CSS 平滑渐变（5 处）+ `drop-shadow` blur（3 处）违反像素纪律，改走 Bayer 有序抖动/硬边。全站与战斗屏两种更大范围留作后批登记。 + +> 事实前提：实机**无** CSS 平滑渐变，只有 Godot `_draw` 里的 alpha 渐隐——最典型的是 B 区光柱 60 段 α26→0 渐隐（`battle_stage_view.gd:143`）与若干 `Color()` 罩层。抖动=把渐变换成 Bayer 有序抖动的色阶台阶，属纯绘制代码改动，不碰素材。 + +| 案 | 内容 | 依据 | +|---|---|---| +| **甲（推荐）** | **只做卡顶类型色带试点**：`bcard` 的 `band` 随各 `TG_*` 逐卡生成抖动带（α 由深至 0）——OPT-A §5 P2-T3 自己推荐的「最低风险 + 复用已有常量 + 收益直观」组合 | 与 T4a 的 `TG_*` 五族天然耦合，一次就能落到 `bcard` 一个件上；改动面在 `_draw` 但面积极小；万一观感不佳，回滚只是去掉一个参数位 | +| 乙 | 只在战斗屏铺（B 区光柱 + 暗角 + 棋盘压暗 + 落影） | 观感收益最大的一块，但也正是 `_draw` 里最敏感的面——站桩叠层序与棋盘焦点分配都已冻结（样张 v2 / board_shot 断言在册），一动就可能牵动既有渲染像素类断言与派样张基准。**建议作为独立后批，不混入本批** | +| 丙 | 全站铺（OPT-A 原案） | OPT-A 自评「纯增美而非修缺陷，风险高于 P0/P1」；全站铺需要先做一个完整的 Godot 侧有序抖动工具（低分辨率渲染 + NEAREST 放大 + Bayer 矩阵），估时会越过软盒。**保留为长期方向，本批不接** | + +#### P9 · §五 其余开放项的处置（已决 / 注销清单） + +> 以下均已在 [UI重设计原型v2落码-差异对照与改动计划-2026-10-04.md §七](UI重设计原型v2落码-差异对照与改动计划-2026-10-04.md) 由用户终裁，本批**不重开**；若用户要翻案须明示。 + +| 原开放项 | 终裁 | 出处 | +|---|---|---| +| C 区「本关强化 / 流派件」两段撤留 | **不撤**（保留 + 紧凑化，口径细节收悬停） | 落码计划 §7.1 P-C1 | +| 战报：就地抽屉 vs 模态回看 | **两者都不做**——冒险中不提供数据回看，战报带只留单行；`settlement_review_overlay` 与结算框「明细回看」钮退役；历史查看归「生涯」界面（迭代 17 卡④） | 落码计划 §7.1 P-C7 + §7.4 | +| 商店刷新钮 / 库存余量 | 刷新**做**（核心小批 SR-1，共享池与三选一同账本）；库存余量**退役**（仅呈现层退役，数据层 `stock_left` 不动） | 落码计划 §7.1 P-C2 + §7.3 + §7.3-a | +| 失败结算奖励行 | 维持**整行隐藏**（OQ14 不推翻） | 落码计划 §7.1 P-C4 | +| 胜利演出两套取一 | 两套并存 + 开关（`UiKit.victory_fx_style` 已实装于 `ui_kit.gd:112`） | 落码计划 §7.1 P-C5 | +| `--candle` 归属 | **新增 CANDLE 常量**（OPT-A §6① 甲案）已落 `ui_kit.gd:68` | OPT-A §6① + F1 | + +#### P10 · 记忆态（迷雾）呈现口径（对照 §五）—— ✅ 取向已定 + +> ✅ **取向已定（2026-10-06 用户采纳推荐）**：取**乙案**——改 demo 口径「地板纹理 + 灰罩 α.66」，在 `board_cell_unit.gd` `_draw` 新增一层合成（允许：新增绘制路径**不属**改素材）。属 §8.3 判定「**跟 demo**」。⚠ **不可让的底线**：改后须复跑记忆墨 `#C4C4C4` 对**加纹理后**的底是否仍 ≥4.5:1（§7.2 属优先级栈②，demo 在此让位于条款）。 + +| 案 | 内容 | 依据 | +|---|---|---| +| **甲（推荐）** | 维持实机「记忆板 `#3A3A3A` 平涂 + `#C4C4C4` 记忆墨」（`board_cell_unit.gd:114-115`；art-bible §6.5(:378) 已立条款：记忆墨对记忆板 ≈6.3:1，过 §7.2 硬指标） | 已有 provisional 自检锚、对比度达标，且这条呈现口径已在迭代 11④ 迷雾批按「迷雾目检指引七步」做过目检确认；demo 侧「地板纹理 + 灰罩 α.66」叠上去反而会在实机瓦片态多一层合成、数字更难读 | +| 乙 | 改 demo 侧口径「地板纹理 + 灰罩 α.66」 | 需在 `_draw` 新增一层纹理合成路径；本批虽禁改素材，但**新增绘制路径是允许的**，所以技术上可行——分歧只在观感。倾向甲，请用户拍板 | + +#### P11 · 装饰性 overline caption（11–12px）是否在 §7.4 给正式豁免（对照 §五）—— ✅ 取向已定 + +> ✅ **取向已定（2026-10-06 用户采纳推荐）**：取**甲案**——在 §7.4 明文给装饰性 caption **12px 豁免** + 附逐处清单（实机在册 11px×5 + 12px×9 须逐处判定是否真属装饰位）。**不跟 demo**（demo 的 10–13px 直接低于下限）。**合并条款（Q5 甲案）**：本豁免与站桩血数 11px 的「条带内读数」豁免**写成同一条款**，不开两个口子。 + +| 案 | 内容 | 依据 | +|---|---|---| +| **甲（推荐）** | **给正式豁免**——在 §7.4 明文写入「装饰性 overline / caption（不承载需精确读取的信息，仅作分区标题或氛围小字）可至 12px」，并附**逐处豁免清单**（实机在册 11px×5 处 + 12px×9 处，须逐处判定是否真属装饰位，不是装饰位的照 §7.4 提档） | 现实中确实需要比正文小一档的辅助层；有条款 + 有清单，下次就不会再漂回去（WB 变体 G16 同指） | +| 乙 | **不给豁免**——全部提至 ≥14px | 严格遵守现有条款，零解释成本；代价是营地/商店/地图的辅助小字变大，卡面信息密度上升，可能挤压既有布局（须 `ui_struct_probe` 复跑确认不出屏、不互压） | + +--- + +### 8.3 「以 demo 为准」的适用范围（2026-10-06 用户采纳：三层优先级栈） + +> 用户提出「全部以 demo 为准」。逐项核证后定为**三层优先级栈**，**不是一刀切**——demo 是 2026-10-04 的方向稿，它在四类地方自己就不合格（见 C 段）。 + +| 层 | 内容 | 效力 | +|---|---|---| +| **① 最高** | 用户既往终裁：v2 落码计划 §七 P-C1 / P-C2 / P-C4 / P-C5 / P-C6 / P-C7；本批 P1 / P2 裁决 | demo 与 ① 冲突时**一律不跟 demo** | +| **② 合规底线** | art-bible §7.2（一切文字对直背景 ≥4.5:1，无区域例外）· §7.4（字号下限）· §8.2（甲类禁非整数 / 乙类禁纵横异倍）· HUD框架格边长条款 | demo 与 ② 冲突时**一律不跟 demo** | +| **③ 视觉方向** | demo 原型 v2.1 的取值 | 只在 ①② 都没说话处生效 | + +#### A · 跟 demo（3 项） + +| 项目 | 落地 | +|---|---| +| P4 九宫格切片 | `ui_kit.gd:286` `texture_margin` 8 → **16**（button 维持 8/8） | +| P7 色板唯一来源 | 5 个 token 改向 demo 值（F2 表，Δ≤6/255） | +| P10 记忆态 | 改「地板纹理 + 灰罩 α.66」，新增 `_draw` 合成层（不改素材） | + +#### B · 不跟 demo，按条款解（4 项） + +| 项目 | 为什么不跟 | +|---|---| +| P3 字号档位 | demo 字号 34 处 < tooltip 下限 14、54 处 < 正文下限 16（§7.4） | +| P6 图标尺寸 | demo 自身就是 64→20（0.3125×）/ 32→16（0.5×）非整数倍违规（§8.2 甲类） | +| P8 抖动呈现 | demo 用 CSS 平滑渐变（5 处）+ `drop-shadow` blur（3 处），**违反像素纪律**——WB 变体第 6/7 项已判 demo 违规；改走 Bayer 有序抖动 / 硬边 | +| P11 小字豁免 | demo 的 10–13px 直接低于下限；按 §7.4 另立豁免条款 + 清单 | + +#### C · 不跟 demo，按 ① 用户终裁（见 §8.2-P9 注销清单） + +| demo 主张 | 终裁（优先级高于 demo） | +|---|---| +| C 区「本关强化 / 流派件」两段撤出主画面 | **不撤**（P-C1） | +| 战报就地抽屉 / 明细回看 | **都不做**，归生涯界面（P-C7） | +| 失败结算奖励行灰显 | **维持整行隐藏**（P-C4，OQ14） | +| 设置屏「音效音量」行 | **不做**（P-C6） | +| 商店刷新钮 / 库存余量 | 刷新**做**（SR-1）；库存余量**退役**（P-C2 + §7.3-a） | + +#### D · demo 无标准可依（回条款 / 回迭代 17） + +图例屏 · 调试浮窗 · 暂停层（迭代 17③）· 生涯界面（迭代 17④）· 1920×1080 档 —— demo 八屏不含这些面。 + +#### E · demo 结构级差异三条 —— **不入本批**，已登记 06 + +| # | 差异 | demo | 实机（实查） | 判定 | +|---|---|---|---|---| +| **D1** | 卡片尺寸 | **232×352**（css:204；v2 落码计划 §7.2 勘误已记此为 demo 现行值） | `ui_kit.gd:404` `custom_minimum_size = Vector2(216, 300)` | 卡面整体放大，商店 / 三选一布局须重排 | +| **D2** | 商店屏形态 | bg-bright 全屏底 + 56px 顶栏（差异表 5.2 🔴「可裁：保持模态但换卡面」，**未裁**） | `shop_overlay_view.gd:32` 仍 `modal_shell` dim 0.6 模态 | 模态 → 全屏属结构级，须重审 R5 模态登记纪律 | +| **D3** | 地图底栏 | 合并单条 88px 亮条（头像+HP 轨+属性+加成+道具槽+放弃；差异表 4.4 🔴） | `level_map_screen.gd:141/151/160` 仍 `life_box`/`attr_box`/`bonus_box` 三独立框（**M5 底栏重构未落**） | 底栏重构，取舍面大 | + +三条均**另立专项或独立呈现批**，本批不接、不占本批估时（风险与估时量级远高于样式对齐）。 + +--- + +## 9. loop engineering 八件对照（合规自证） + +| # | 八件要求 | 本文对应 | +|---|---|---| +| 1 | 计划书八节 | §1 目标与完成定义 · §2 现状事实 · §5 设计契约 · §4 范围边界 · §6 任务卡 · §7 验证闸 · §10 异常分级 · §8 白名单与裁点 | +| 2 | T0 开工 | §6 T0（基线重测回填 + 事实表复核 + demo md5 重核 + 实机对比度重跑） | +| 3 | 循环骨架 | §6 各卡（读卡 → 对事实源 → 实装 → 轻闸全绿 → 提交 → 台账 → 下一轮） | +| 4 | 轻闸 | §7 轻闸段（触 presentation，加跑 ui_click + ui_layout + ui_struct + 新增三段机检） | +| 5 | 重闸 | §7 重闸段 + §6 T9 | +| 6 | 人闸 | §6 T10 | +| 7 | 异常分级 | §10 | +| 8 | 收口五步 | §6 T11 + §12（含 §8.3-E 三条结构级差异的 06 登记） | + +--- + +## 10. 异常分级 + +| 级 | 触发 | 处置 | +|---|---|---| +| **L1** | 单轮轻闸/机检红 | 一次重试自查（先查是否在册已知坑：modal 屏容器排序须强制 `queue_sort`，见 ui-struct-probe 出口报告 §六.6；营地 ScrollContainer 内容系坐标出屏系合法豁免； Godot 类名缓存须 `--import` 重刷） | +| **L2** | 同类红连续 3 轮；或某卡面/面板因尺寸调整出现内容挤压、局部出屏 | 记录进任务书与工作日志，报备后调整该处取值/申请豁免（**禁反向修改全局宽度基准 216**） | +| **L3** | 任一 🔴 R1–R7 破；或发现「此条非改素材不可达成」；或与迭代 15② 在飞面出现文件交集；或 §8 任一裁点在执行中发现需要推翻已冻结条款而未获用户裁决 | **停机写报告等用户发令** | + +--- + +## 11. 现状留痕（供执行会话读序） + +``` +1. design/research/UI预览demo三路改进整合对照-2026-10-04.md（事实源；§二/§三/§四/§五） +2. design/research/UI重设计原型v2落码-差异对照与改动计划-2026-10-04.md §七（既有终裁口径，§8-P9 注销依据） +3. artwork/ui-redesign-2026-10-04-optA/优化方案-OPT-A.md（§2 四张机检表 / §4 结构性技术债 / §5 分批 / §6 拍板点） +4. artwork/ui-redesign-2026-10-04/variants/wb-20261004/改动计划-wb-20261004.md（§四 16 项改动 / G1-G16 分组 / P-1…P-4） +5. game/presentation/views/ui_kit.gd（色板单点 :9-103 / 呈现杂色档 :74-83 / HEX :86-103 / StyleBox 工厂 :190-304 / M10 公共件 :343-512） +6. game/presentation/views/standee_body.gd:26/:417-419/:432/:438-439/:476（站桩盒、底座、血条、血数、名行） +7. game/presentation/views/board_view.gd:114/:246-251 + board_cell_unit.gd:13/:79/:114-115/:132/:138/:238（格边长公式与棋盘绘制） +8. game/presentation/views/status_slot_row.gd:21-29（preload 红线）· ap_bar_view.gd:74（RAP 标签）· hero_info_panel_view.gd:196-207（槽位字） +9. game/presentation/views/level_map_screen.gd:36/:127/:136/:143/:153（裸色 / 头像非等比 / 说明文） +10. design/qa/ui-struct-probe-exit-report-2026-10-05.md（宽度基准 216 / 9 处豁免 / 五族断言 / queue_sort 坑） +11. design/art/art-bible.md §7.1(:395) §7.2(:404) §7.4(:417) §8.1(:433) §8.2(:438) · design/gdd/systems/表现与支撑/HUD框架.md:67/72（格边长定值档与校验区间） +12. demo 侧实查锚点：`src/ui-prototype.html:59` `.plate9` border12/slice16 · `:61` `.btn9` border11/slice16 · `:204` `.bcard` 232×352 · `:288` 棋盘 44px · `:10-19` CSS 变量族（含 `--tg-*` 五族 `:19`） +13. `design/art/art-bible.md` §1.4(:48) **整屏样张闸四项**——Q2 乙案：不走独立闸，四项并进 T10 人闸目检清单 +``` + +--- + +## 12. 收口五步（完成后执行） + +1. **active.md 快照**：追加本批条目（迭代 16 · UI 设计对齐批 · worktree 名 · 起止提交 · 闸读数）。 +2. **台账条目**：查撞号后追加，含「变更文件清单 + 裁决面逐项 + 估时对照（**6.9d 预算** vs 实际）」。 +3. **roadmap 迭代 16 行更新**：补任务书路径 + 估时 + 裁定状态（任务书成文时已同步补记本行）；若拆批执行结论推翻了本文任一冻结条款，同批改该行。 +4. **stage.txt**：本批不涉及阶段变更（阶段=M-4），不动。 +5. **闸序列留痕**：T9 重闸全绿读数 + T10 人闸目检清单结论，写入台账（并同步 active.md 快照）。 +6. **06-待办清单**：本批**无精确对应条目**（「资产升档重产批」06:283 属素材升档，恰为本批美术红线明令禁止的事项，不重复登记）；实装完成后按要求移除/收口的条目若出现，届时另行补注记。 +7. **结构级差异三条（§8.3-E）**：卡片 232×352 / 商店全屏化 / 地图底栏合并——**已登记 06 待立项**（「UI 原型 demo 结构级差异三项——待立项」条），本批不接。 +8. **已知偏差（Q8 甲）**：棋盘格边长三方取值不一致（代码上限 46 / §8.1 锚点 45 / demo 44）——**已登记 06「棋盘格边长三方取值不一致——待扩板定档处置」条**；本批代码与文档均不改（R7 禁单侧改）。 +9. **合并方式（Q7 甲）**：三段同属一个迭代，**只在段三末合并一次**，段间不单独合并。 diff --git a/design/research/任务书-敌人表行集多行批-2026-10-05.md b/design/research/任务书-敌人表行集多行批-2026-10-05.md index 31ff2bdc..2ab5802e 100644 --- a/design/research/任务书-敌人表行集多行批-2026-10-05.md +++ b/design/research/任务书-敌人表行集多行批-2026-10-05.md @@ -2,7 +2,7 @@ > 成文 2026-10-05。**性质**：数据表校验与生成机制放开 + 配套呈现适配，允许同一场遭遇混编多种敌人。 > 事实源 = [06-待办清单](../gdd/06-待办清单.md)「同深度第二敌种与精英 / Boss 编码位」条剩余面（该条前半「同层多遭遇」已由关卡节点地图 v1.0 节点编号升级消解，剩余即本卡）；设计权威 = [敌人系统](../gdd/systems/战斗循环/敌人系统.md) v0.13（技能池执行批已落籍，Boss 半血解锁技已入表）。 -> 归属迭代：**迭代 16 · 卡①**（迭代 16 四卡：①本批 ②M4 数值批 ③暂停层只读入口批 ④生涯界面设计立项）。 +> 归属迭代：**迭代 17 · 卡①**（迭代 17 四卡：①本批 ②M4 数值批 ③暂停层只读入口批 ④生涯界面设计立项）。 > 满足 loop engineering 八件（见 §9 逐条对照）。 > 开工门：**已解**——前置「技能池实施批落地」已于 2026-10-05 完成（技能池执行批合并进 master，提交 d3fa887，冒烟 772/0）。 @@ -110,7 +110,7 @@ | **T5** | （条件卡，P3 裁投放才执行）首个混编遭遇行投放 + 行值 provisional 登记 | 0.5d | 冒烟 + MC（先报批） | 混编遭遇开战/结算/胜利全链断言过 | | **T6** | 重闸：全量轻闸 + doc 三闸 + 熵增闸 + MC 逐项比对（零内容期） | 0.5d | 重闸全绿 | §1.2 判定 3/4 | | **T7** | 人闸：目检清单（T5 执行时含混编遭遇实机目检）+ 代拍板追认 | 0.5d | 目检过 | §1.2 判定 5 | -| **T8** | 收口五步（active.md 快照 → 工作日志 → roadmap 迭代 16 行标注 → 06 收口 → 闸序列留痕） | 0.25d | — | 收口五步齐 | +| **T8** | 收口五步（active.md 快照 → 工作日志 → roadmap 迭代 17 行标注 → 06 收口 → 闸序列留痕） | 0.25d | — | 收口五步齐 | > 估时合计 ≈ **4.25d**（含 T5）/ **3.75d**（不含 T5），超 roadmap 软时间盒 3 日上限——知情预挂：T4 后按 L3 呈报切点，不擅切（沿迭代 9/秘宝批先例）。 diff --git a/design/research/任务书-暂停层只读入口批-2026-10-05.md b/design/research/任务书-暂停层只读入口批-2026-10-05.md index 317c9a01..1f506d70 100644 --- a/design/research/任务书-暂停层只读入口批-2026-10-05.md +++ b/design/research/任务书-暂停层只读入口批-2026-10-05.md @@ -2,7 +2,7 @@ > 成文 2026-10-05。**性质**：功能性 UI 交互新增——局内暂停层，承载钥石余额与营地柜台解锁进度的**只读**查看。 > 事实源 = [06-待办清单](../gdd/06-待办清单.md)「解锁界面与钥石呈现的交互形态（残余：暂停层只读入口）」条。 -> 归属迭代：**迭代 16 · 卡③**（迭代 16 四卡：①敌人表行集多行批 ②M4 数值批 ③本批 ④生涯界面设计立项）。 +> 归属迭代：**迭代 17 · 卡③**（迭代 17 四卡：①敌人表行集多行批 ②M4 数值批 ③本批 ④生涯界面设计立项）。 > 满足 loop engineering 八件（见 §9 逐条对照）。 > **美术红线（2026-10-05 用户立规）**：本批不得包含观感类、素材类内容；呈现必须复用现行公共件（UiKit 工厂件）与 ui_kit 色板 token，**不新画任何素材、不新建任何色值**。功能性 UI 交互不算美术。 @@ -66,7 +66,7 @@ | **只读，零写操作** | 暂停层不接任何购买/切换/设置写通路；设置修改仍走设置面 | | **核心层零改动** | 只消费 `MetaProgression` 既有只读访问器；不改 meta_progression.gd、不改存档、不改数值 | | **不冻结游戏逻辑** | 自动战斗逻辑确定性、无实时压力；暂停层 = 纯查看层，不做「时间停止」机制（逻辑本无自走时钟，无需冻结——若 P2 裁出排播暂停需求，单独呈报） | -| **不做生涯/历史回看** | 跨局汇总与历史冒险回看归迭代 16 卡④（生涯界面设计立项），本批不越界承接 | +| **不做生涯/历史回看** | 跨局汇总与历史冒险回看归迭代 17 卡④（生涯界面设计立项），本批不越界承接 | | **不触碰迭代 15② 在飞文件** | 奇物批渠道分离实施段在迭代 15 继续，本批与其零文件交集（若 T0 复核发现交集，停机呈报） | ## 5. 设计契约（🔴 触碰 = L3 停机） diff --git a/design/research/任务书-生涯界面设计立项-2026-10-05.md b/design/research/任务书-生涯界面设计立项-2026-10-05.md index bbca760f..420d206c 100644 --- a/design/research/任务书-生涯界面设计立项-2026-10-05.md +++ b/design/research/任务书-生涯界面设计立项-2026-10-05.md @@ -2,7 +2,7 @@ > 成文 2026-10-05。**性质**：纯设计批——产出「生涯」界面的设计提纲（信息架构 + 承载内容清单 + 与既有界面的关系 + 分期实装建议 + 待裁点），**本批零实装、零代码、零数据面改动**。 > 事实源 = [06-待办清单](../gdd/06-待办清单.md)「『生涯』界面——冒险中数据回看的唯一承接处」条（2026-10-04 用户裁决 P-C7：冒险中不给数据回看，历史战报/结算明细的查看去向 = 新「生涯」界面；生涯未做前冒险中无历史回看入口 = 已知代价，用户知情裁决）。 -> 归属迭代：**迭代 16 · 卡④**（迭代 16 四卡：①敌人表行集多行批 ②M4 数值批 ③暂停层只读入口批 ④本批）。 +> 归属迭代：**迭代 17 · 卡④**（迭代 17 四卡：①敌人表行集多行批 ②M4 数值批 ③暂停层只读入口批 ④本批）。 > **实装批另行立项**：本任务书只交付设计提纲文档与裁点呈报；任何实装（数据面/界面/存档域）须用户审毕提纲后另行发令立项。 > 满足 loop engineering 八件（按设计批形态适配，见 §9 逐条对照）。 @@ -35,7 +35,7 @@ | F5 | 当局结算呈现仍在 | 冒险收束时结算屏入账明细（钥石 +N、新解锁）现行保留——退役的只是「局后任意时刻回看」，不是收束当下 | | F6 | 跨局汇总数据源现成 | 总通关次数（level_clear_counts 按关）、Boss 首杀/总击杀、钥石余额与累计流（余额在，累计收支无流水）、锻造/工坊/天赋树解锁态——「跨局汇总」页大部分字段可直接读访问器，零新数据面 | | F7 | 图鉴承接的候选内容 | 06 在册相关条目：「敌方技能图鉴 / 学习呈现」（P2，见过→认得→记谱）；奖励格图鉴柜台空置（2026-10-04 配比预设批裁决该柜台承接配比容量，后随配比预设整体挂起——柜台仍空）；秘宝/奇物均无图鉴面 | -| F8 | 相邻界面分工现状 | 营地 = 跨局成长**操作**面（花钥石买强化）；主菜单 = 入口面（新冒险/继续上局/营地/设置/调试）；设置面 = 环境开关；教学「帮助」手册（Beta 批初裁：全部内容放一个文档，未实装）；暂停层（迭代 16 卡③）= 局内只读查看钥石与解锁进度 | +| F8 | 相邻界面分工现状 | 营地 = 跨局成长**操作**面（花钥石买强化）；主菜单 = 入口面（新冒险/继续上局/营地/设置/调试）；设置面 = 环境开关；教学「帮助」手册（Beta 批初裁：全部内容放一个文档，未实装）；暂停层（迭代 17 卡③）= 局内只读查看钥石与解锁进度 | | F9 | 06 条目原文口径 | 「跨局汇总 / 历史冒险回看 / 图鉴承接」三段内容清单是 06 条目给定骨架，本提纲在其上展开，不另起炉灶 | | F10 | 阶段语境 | 教学引导五条目已整体改排 Beta（2026-10-04 拍板）；生涯未标阶段——分期建议须回答「生涯第几期落在 Alpha 后哪个窗口」 | @@ -70,7 +70,7 @@ | 界面 | 管什么 | 与生涯的边界 | |---|---|---| | 营地 | 跨局成长的**操作**（买/装配/点树） | 营地不改生涯只读定位；生涯不做任何购买入口，「去买」按钮也不放（跳转型入口随 P4） | -| 暂停层（迭代 16 卡③） | **局内**只读看钥石与解锁进度 | 暂停层看「这一局进行中的当前值」，生涯看「跨局累计与历史」；局内是否给生涯入口随 P4 | +| 暂停层（迭代 17 卡③） | **局内**只读看钥石与解锁进度 | 暂停层看「这一局进行中的当前值」，生涯看「跨局累计与历史」；局内是否给生涯入口随 P4 | | 结算屏 | 当局收束当下的入账明细 | 收束当下保留；生涯承接的是收束之后的任意时刻回看 | | 帮助手册（Beta 批） | 规则与玩法的说明文档 | 手册讲「怎么玩」，生涯讲「我玩过什么」；图鉴条目文案与手册条目是否共用内容源，归 Beta 批一并裁（本提纲只登记接口） | | 图例面板（legend_overlay） | 局内符号/徽标解码 | 局内即时解码不动；图鉴是跨局收集面，两者不合并 | @@ -187,7 +187,7 @@ | 5 | 重闸 | §7（doc 三闸默认不跑，用户点名则对基线零新增） | | 6 | 人闸 | §6 T2（设计提纲评审 = 本批唯一人闸） | | 7 | 异常分级 | §10 | -| 8 | 收口五步 | §6 T2（active.md 快照 + 工作日志 + 06 状态行 + roadmap 迭代 16 行随批登记） | +| 8 | 收口五步 | §6 T2（active.md 快照 + 工作日志 + 06 状态行 + roadmap 迭代 17 行随批登记） | ## 10. 异常分级 diff --git a/roadmap.md b/roadmap.md index 353ec341..83368b03 100644 --- a/roadmap.md +++ b/roadmap.md @@ -61,12 +61,13 @@ | 迭代 13 | **工程债与测试基建批（含 D6 爆破工兵包实施）**：六条目=ui_click_probe 完整局适配（D1——分派链序修正+停点/锁期/重放三态断言）/探针只读出口（D2——六出口 26 直入清零）/ArmedTimer helper（D3——P4 乙三处计时收口缝零动）/main.gd 二期瘦身（D4——bonus_interact_controller+camp_shop_presenter 拆件 1370→1119，家族②契约3绑定面留置；~900±50 锚差=族级清单上限不自洽已归因）/aux 二期合并（T5 判不合收口）/杂项尾差四件（D5）/爆破工兵包中立移除雷格（D6——P1 甲邻接冻结/P2 甲退色降档，判定逻辑零改动，充能表驱动零新码）。**✅ 已落籍（2026-10-04，台账 342）**：worktree m4iter13-debt-20261004 八提交 cd7d3ea…2402877 合并 eff8cb8；闸=冒烟 718/0（断言数持平基线）+run_all 15+click 三种子绿+全探针绿+doc 三闸零新增+熵增 PASS+MC 零跑（静态零漂移证明）；合并后主区全量复跑同绿 | 迭代 12 出口 | T0-T9 ≈4.8-5.3d（知情超限单批，实际单会话） | | 迭代 14 | **初始展开收窄批（2026-10-04 用户拍板甲乙混合立项）**：甲=先布后删剃雷域收窄至出生 3×3∪外扩 r 环（参数化半径，现值 r=1——开阔地均值从板面 66.5% 根因性降至约三成）+乙=生成重掷闸 R₀≤cap（合法性门序列、cap=板面 30% 锚〔10×10=30/12×12=43/13×13=51〕、重试耗尽走既有三分出口）；**玩法侧零改动路线**（排雷玩法「初始展开恰等」验收原样为真，minesweeper_rules.gd 零 diff）；裸数字截断路否决退役（可见 0 格+未开邻居=扫雷不可能态）。可行性报告=`design/research/研究-初始展开收窄可行性-2026-10-04.md`，任务书=`design/research/任务书-初始展开收窄批-2026-10-04.md`（T0-T8≈5.25d，读数批 T5-T6 可切独立后批；拍板点 P1-P3 全读数后置；停机点 S1 相变警戒/S2 带越界回调）。**✅ 实施批落地（2026-10-05，worktree m4iter14-narrow-20261005 台账 357；S1 停机呈报已裁=用户方案A）**：T0-T4+T7+T8 全落（T5 结构读数随批出讫；T6 MC 四带复算读数批按切分预案后置，跑批待用户批准挂 07 现行义务）——甲=剃雷域收窄（shave_ring_radius 参数化，r=1→出生 5×5，全域 flood 剃雷退役，零 RNG 消费变化）+乙=R₀≤cap 重掷闸（合法性闸序列+同流重试+耗尽三分出口诚实降级+r0_cap_rejected 指标）+参数面两列（schema 域校验加载期致命+19 行投值）+断言面 +12（R₀≤cap/ring_removed 量级/cap 压线诚实降级/确定性逐位）+夹具复核 3 处（relic 候选身份按 TP0 v2.2=kind|tier|relic_id、商店购买笔数推导防 GP 流漂移、极性探针种子自愈）；**S1 停机实录**=r=1 自然 R₀ 均值 39>cap30 锚结构性倒挂（94% 拒绝/inf 0.976→0.719/常态非法板）→用户裁方案A「10×10 cap 30→45」〔P1 上调预案字面〕，12×12/13×13 健康侧维持；改后结构读数=R₀ 均值 39.7/37.9/42.8/46.6（收窄自 68.6/83.2——10×10 −42%、12×12 −54%）/尾部闸精确截断/雷密度 19.2-21.6%<25% 相变线/inf 全行达标；玩法侧零改动（minesweeper_rules.gd 零 diff、「初始展开恰等」验收原样为真）；闸=冒烟 767/0（+12）；registry initial_expansion_narrowing 条+棋盘生成.md v0.5+07⑬ 四信号组；06 视野条目已于 745b92ea 清账批退役（收窄立项即正主）。**②挖掘风险不等式判式换代批（2026-10-04 用户裁编入本迭代，作为迭代内需求）**：判式三层换代（条款2 标中旗锚/条款3 聚合健康式「(1−ρ̂)E_dig−ρ̂V_mine≥0」/旗边际引理+条件二旗溢价）+β 比值带判读 [1.2,2.5]（u=3 登记态）+标中兑付溢价 δ=1.25（形态 a 兑付公式一处·雷安同池冻结不动）+runsum 旗行为五字段+audit 工具常量刷新（池 77/直伤 6-8-8/AP 8）；裁决全落零新拍板点（方案报告 §九（已退役，git 1da9a41）），任务书=`.zcode/plans/mine-inequality-revision-miniloop-plan-2026-10-04.md`（T0-T5≈2.5d；条件二 T3 落文按登记已知破·T4 机制转绿；契约红线=DamageController 零改/直伤雷 6-8-8 与 p_perfect 不动——iter8 缺口四选一解绑独立在案；开工门=U0）。**✅ 实施批落地（2026-10-05，worktree m4iter14-mineq-20261005 台账 356）**：T0-T5 全落——audit 工具常量刷新（改前静态锚与方案报告 §四 逐位吻合）+runsum 五字段（行侧判据考证=授予行专带 highlight，87行==87插旗1:1）+F1 条款3 重立三层口径（v0.8）+战斗结算 v0.25+难度联动表+6 行+registry clause3_inequality 重立条（改前锚+P7 修正注记）+06 破线条收口+**T4 标中兑付溢价机制**（settlement.flag_hit_premium=125 provisional，grant 单点只挂 flag_hit 正向·percent 幅度贯穿应用与呈现，标空/挖格不乘，DamageController 零改/同池冻结）+smoke 750/0（+3 断言；max 路径种子 42→43 重采）；判读三件=β 带 u=1/2 带内 u=3 登记态/δ 敏感度行为无感（η 位移 <1.4pp<5pp，保留+登记）/条件二判式口径等号压线转绿（整数量级实现 u=1/2 绿·u=3 微欠 −1.1% 登记面）；改后锚换代 runsum_m4iter14mineq_post_n200_20261005（perfect 冒险通关 65.3%→72.0% 增强向位移，四带判读归 M-4）；出口报告=design/qa/m4iter14-mineq-exit-report-2026-10-05.md（provisional 追认单 8 项+07⑫ 人工项）；damage_probe A1 红灯=改前既有非本批新增（在册）。**③全局作用域变异首发批（2026-10-04 用户拍板立项——调研报告 P1-P8+盘问 Q1-Q4 全按推荐案落，批内序位待排）**：L2/L3 Boss 图恒定一型 scope=global 变异，首发型=**案A 资源面·微贫向偏斜**（正向格面池合计不变、进攻族 attack/blast/pierce/magic 权重上浮/生存族 heal/defense 明显下调、EV 微降 3-5% provisional、gp/action 白名单不动；v1.0「沃土+雷密对冲」形勘误作废——雷数为生成器事实、布置段不可加，改生成端=踩结构面否决理由）；**替换制**（Boss 图不再布 region 片——L2 完美 Boss 承伤 55.8% 已越带不叠加；迭代 12 四件地形应对件在 Boss 图失效=知情代价，registry/调参日志随批登记）；L1 Boss 免疫（带B [50,85] 教学保护）；三层预告（开战横幅+HUD 常驻角标+帮助手册行）；带A 判读后置 M-4（落地 off/on 对拍只测不判；off 基线=替换制后零变异 Boss 图，与现行带 region 片 Boss 图语义不同须注明）；偏运硬币合成序=图级先件级后（代拍随批锚登记）。调研报告（事实源，v1.1 裁决落盘）=`design/research/调研-全局作用域变异设计空间-2026-10-04.md`，任务书已退役（git 01bfc15 批；裁决全录另见调研报告 §7）（T0-T8≈5.75d，读数批 T7 可切独立后批→主体≈5.25d；零新拍板点·provisional 追认单随批；停机点 S1 普通图逐位漂移/S2 读数越带只呈报/S3 互锁误伤；开工门=U0；**⑥A4 批开工门含本批出口——本批落地图级偏斜投影点为⑥合成链中段**〔2026-10-05 注：⑥已移出迭代 14 挂起，此依赖句冻结待其重启〕）。与①②互不撞（收窄=普通图初始展开轴/判式=不等式判读口径/全局变异=Boss 图资源面轴），出口读数各自分开归因。**✅ 实施批落地（2026-10-04，worktree m4iter14-gvar-20261004 台账 345）**：T1-T8 实施批全落（T7b MC 读数批按切分预案切独立后批，跑批待用户批准）——skewed_veins 贫矿脉行+互锁三条+effect_value [0,50]/门控第三维节点身份/替换制+兜底回落/装板序全局决议前置（数据依赖调和，出口报告在册）/资源面偏斜投影（整数最大余数守恒 77+合成序图级先件级后）/三层预告三层全接/七正主落文+06 收口；闸=冒烟 747/0（+29）+run_all 15+golden 普通图逐位 12/12 全等+六探针+三闸熵增终录见批报告 design/qa/m4iter14-gvar-exit-report-2026-10-04.md（Q3 四件应对件知情代价登记+静态推演+provisional 追认单+人闸目检清单）；**③出口成立——⑥A4 开工门解一半**（另半=②出口）；off/on 双档读数待 T7b（带 A 判读归 M-4 只测不判）。**④技能池执行批（2026-10-04 用户点名入列——调研+四裁+任务书全齐，06 Alpha 验证条目随之收口）**：文档五件（敌人系统.md 池构成表补 L2/L3 五敌种行/护甲列改读表口径/Boss 三代错峰句/意图呈现节补解锁弹出规格/版本 v0.13+EV 锚整数口径重登记+enemy.tres 批注消歧）+**新机制一件=Boss 半血解锁新独占伤害技**（三 Boss 血量 ≤50%〔用户口径定死〕解锁：酋长「震地怒击」类 ×2.5/CD4·卓尔遏毒类 ×2.0/CD3·石君王「岩崩」类 ×2.5/CD4——参考档即工作值，命名 T5 定稿、倍率冷却 provisional 归调参；enemy.tres 池条目扩 unlock_hp_pct 键〔int [1,99] 缺省无=无门槛〕；未解锁条目双面过滤不进摇号与保底集合；解锁出一次归因明细行「XX 解锁了 YY」）；首拍加权取消（杂鱼纹理注销——巨蜘蛛 52% 读数已被 Package B 抬血自愈、地精两行终裁不加工）；呈现=明细行+既有类型级预告+解锁时技能名一次性弹出（零动画资产、不改演出）；裁决 D1-D8 零待裁；任务书=`design/research/任务书-技能池执行批-2026-10-04.md`（T0-T7≈4.25d，切分预案在册）——开工=用户发令升计划书。**✅ 实施批落地（2026-10-05，worktree m4iter14-skillpool-20261005 台账 358；goal 开工令 U0）**：T0-T6+⑤ 全落（T7 读数批后置挂 07 现行义务，跑批待用户批准）——T0 表盘点零漂移；T1 敌人系统.md v0.13 五件全落；T2 skills.tres 有效倍率表批注〔D4 整数基线半点矩阵〕+enemy.tres EV 锚整数口径重登记+巨蜘蛛 1.11 消歧〔=atk1 口径非混用〕+registry enemy/skill 条目换代；T3-T4 机制件=unlock_hp_pct〔1,99] 可选键（schema 域校验，缺省无=无门槛）+容器闩 check_skill_unlocks（单向闩零随机）+双面过滤（保底不逼锁定）+编排归因行「XX 解锁了 YY」〔type=highlight 高光键 skill_unlock 零行型新增〕+呈现一次性技能名 toast〔排除 perfect_sweep 误触〕；T5 三 Boss 解锁技落表（震地怒击 ×2.5/CD4·遏毒 ×2.0/CD3·岩崩 ×2.5/CD4 案甲 provisional+池尾 weight2/unlock50）+断言基线换代 3 处〔技能表 12 行/池模板+门控条目/酋长 EV 锚重锚 1.10-1.30 实测 1.1948〕；T6 单测 skill_unlock_test 22 断言（run_all 15 套）+smoke +5 集成（半血→次轮解锁行恰一次/文本/行型零新增）；闸=冒烟 772/0+run_all 15+探针绿+doc 三闸零新增（reward_overlay_test 红=master 既有在册）。**⑤✅ 提灯 +2 接线落地（同批顺路）**：board_view.set_fog_lantern 公共接线面（半径算式迷雾批已在位；载体道具仍归 Alpha 信息件重定批=接缝就绪态）+ui_input_probe case⑮ 接线断言+HUD框架 注记**⑤魔法提灯 +2 效果接线（小卡）**：零调研直入——2026-09-30 拍板④已裁（灯甲视野外扩 +2 格、类型微光不随视野扩），迷雾批已留常量 LIGHT_RADIUS_LANTERN_BONUS，纯接线+断言估 0.5d 内。原候选卡注记终态（2026-10-04）：敌人系统内容批=已具化为④；教学引导定稿批=用户裁改排 Beta（06 教学节头注记在案），移出本迭代候选。**⑥冒险前资源配比预设批——已移出本迭代（2026-10-05 用户令挂起：暂不做；条目保留 06-待办清单「冒险前资源配比预设（构筑提案）」〔已裁待实施→挂起〕，八项裁决全数有效、任务书冻结保留=design/research/任务书-冒险前资源配比预设批-2026-10-04.md；重启须用户另行发令，届时开工门仍=②③号卡出口〔若②③已落籍 master 则自动解——合成序与包络数值锚依赖②判式换代与③变异投影，三者共用摇号投影点〕）**。 | 迭代 13 出口（**迭代 13 已落籍 2026-10-04 eff8cb8**，台账 342） | 初始展开批 T0-T8（可两段切分）+判式换代批 T0-T5≈2.5d（独立 worktree 合并）+全局变异首发批 T0-T8≈5.75d（读数批可切，独立 worktree 合并）+技能池执行批 T0-T7≈4.25d（独立 worktree 合并）+提灯接线小卡 0.5d（可并入任一批顺路）〔⑥配比预设批 A4 已移出本迭代挂起，2026-10-05 用户令〕 |**③全局作用域变异首发批（2026-10-04 用户拍板立项——调研报告 P1-P8+盘问 Q1-Q4 全按推荐案落，批内序位待排）**：L2/L3 Boss 图恒定一型 scope=global 变异，首发型=**案A 资源面·微贫向偏斜**（正向格面池合计不变、进攻族 attack/blast/pierce/magic 权重上浮/生存族 heal/defense 明显下调、EV 微降 3-5% provisional、gp/action 白名单不动；v1.0「沃土+雷密对冲」形勘误作废——雷数为生成器事实、布置段不可加，改生成端=踩结构面否决理由）；**替换制**（Boss 图不再布 region 片——L2 完美 Boss 承伤 55.8% 已越带不叠加；迭代 12 四件地形应对件在 Boss 图失效=知情代价，registry/调参日志随批登记）；L1 Boss 免疫（带B [50,85] 教学保护）；三层预告（开战横幅+HUD 常驻角标+帮助手册行）；带A 判读后置 M-4（落地 off/on 对拍只测不判；off 基线=替换制后零变异 Boss 图，与现行带 region 片 Boss 图语义不同须注明）；偏运硬币合成序=图级先件级后（代拍随批锚登记）。调研报告（事实源，v1.1 裁决落盘）=`design/research/调研-全局作用域变异设计空间-2026-10-04.md`，任务书已退役（git 01bfc15 批；裁决全录另见调研报告 §7）（T0-T8≈5.75d，读数批 T7 可切独立后批→主体≈5.25d；零新拍板点·provisional 追认单随批；停机点 S1 普通图逐位漂移/S2 读数越带只呈报/S3 互锁误伤；开工门=U0；**⑥A4 批开工门含本批出口——本批落地图级偏斜投影点为⑥合成链中段**〔2026-10-05 注：⑥已移出迭代 14 挂起，此依赖句冻结待其重启〕）。与①②互不撞（收窄=普通图初始展开轴/判式=不等式判读口径/全局变异=Boss 图资源面轴），出口读数各自分开归因。**✅ 实施批落地（2026-10-04，worktree m4iter14-gvar-20261004 台账 345）**：T1-T8 实施批全落（T7b MC 读数批按切分预案切独立后批，跑批待用户批准）——skewed_veins 贫矿脉行+互锁三条+effect_value [0,50]/门控第三维节点身份/替换制+兜底回落/装板序全局决议前置（数据依赖调和，出口报告在册）/资源面偏斜投影（整数最大余数守恒 77+合成序图级先件级后）/三层预告三层全接/七正主落文+06 收口；闸=冒烟 747/0（+29）+run_all 15+golden 普通图逐位 12/12 全等+六探针+三闸熵增终录见批报告 design/qa/m4iter14-gvar-exit-report-2026-10-04.md（Q3 四件应对件知情代价登记+静态推演+provisional 追认单+人闸目检清单）；**③出口成立——⑥A4 开工门解一半**（另半=②出口）；off/on 双档读数待 T7b（带 A 判读归 M-4 只测不判）。**④技能池执行批（2026-10-04 用户点名入列——调研+四裁+任务书全齐，06 Alpha 验证条目随之收口）**：文档五件（敌人系统.md 池构成表补 L2/L3 五敌种行/护甲列改读表口径/Boss 三代错峰句/意图呈现节补解锁弹出规格/版本 v0.13+EV 锚整数口径重登记+enemy.tres 批注消歧）+**新机制一件=Boss 半血解锁新独占伤害技**（三 Boss 血量 ≤50%〔用户口径定死〕解锁：酋长「震地怒击」类 ×2.5/CD4·卓尔遏毒类 ×2.0/CD3·石君王「岩崩」类 ×2.5/CD4——参考档即工作值，命名 T5 定稿、倍率冷却 provisional 归调参；enemy.tres 池条目扩 unlock_hp_pct 键〔int [1,99] 缺省无=无门槛〕；未解锁条目双面过滤不进摇号与保底集合；解锁出一次归因明细行「XX 解锁了 YY」）；首拍加权取消（杂鱼纹理注销——巨蜘蛛 52% 读数已被 Package B 抬血自愈、地精两行终裁不加工）；呈现=明细行+既有类型级预告+解锁时技能名一次性弹出（零动画资产、不改演出）；裁决 D1-D8 零待裁；任务书=`design/research/任务书-技能池执行批-2026-10-04.md`（T0-T7≈4.25d，切分预案在册）——开工=用户发令升计划书。**⑤魔法提灯 +2 效果接线（小卡）**：零调研直入——2026-09-30 拍板④已裁（灯甲视野外扩 +2 格、类型微光不随视野扩），迷雾批已留常量 LIGHT_RADIUS_LANTERN_BONUS，纯接线+断言估 0.5d 内。原候选卡注记终态（2026-10-04）：敌人系统内容批=已具化为④；教学引导定稿批=用户裁改排 Beta（06 教学节头注记在案），移出本迭代候选。**⑥冒险前资源配比预设批——已移出本迭代（2026-10-05 用户令挂起：暂不做；条目保留 06-待办清单「冒险前资源配比预设（构筑提案）」〔已裁待实施→挂起〕，八项裁决全数有效、任务书冻结保留=design/research/任务书-冒险前资源配比预设批-2026-10-04.md；重启须用户另行发令，届时开工门仍=②③号卡出口〔若②③已落籍 master 则自动解——合成序与包络数值锚依赖②判式换代与③变异投影，三者共用摇号投影点〕）**。 | 迭代 13 出口（**迭代 13 已落籍 2026-10-04 eff8cb8**，台账 342） | 初始展开批 T0-T8（可两段切分）+判式换代批 T0-T5≈2.5d（独立 worktree 合并）+全局变异首发批 T0-T8≈5.75d（读数批可切，独立 worktree 合并）+技能池执行批 T0-T7≈4.25d（独立 worktree 合并）+提灯接线小卡 0.5d（可并入任一批顺路）〔⑥配比预设批 A4 已移出本迭代挂起，2026-10-05 用户令〕 | | 迭代 15 | **①调试功能整合批（2026-10-05 用户令自「14.5」临时卡改编入册——原周期外 0.5 卡，落地事实与验证读数零变化，只改编号归属）**：主菜单三调试散件（随机种子输入框/角色数值调整板/两层调试入口）收一张调试浮窗 DebugOverlay——入口=开始覆盖层右下角「调试」角标（与主按钮组非平级，DS_DEBUG=1 环境变量门控沿用迭代 8 卡④口径）；浮窗=悬浮菜单之上 Dialog（不隐藏开始层，同确认弹窗形态；旧 TunePanel「与开始层互斥」形态与类整体吸收退役含 .uid）；可扩展滚动列表页四区块（随机种子/数值调整/批量模拟/两层调试入口——后续调试项往下追加滚轮下探）。四拍板全落（2026-10-04 用户裁）=P1 甲 DS_DEBUG 门控/P2 乙全摊平/P3 仅开始菜单可开·对局不可达（_show_debug_overlay 门禁护栏+对局发起随开随收）/P4 可扩展列表。**✅ 已全批落籍（2026-10-05，worktree iter145-debug-hub 两提交 48c0b34/46dadbb，主区 merge --no-ff d0a3c6b/10c301b，台账 352）**：闸=冒烟 747/0+探针 ui_tune/ui_click/ui 三绿（worktree+主区双跑，主区跑前 --import 重刷类名缓存在册坑）；遗留=实机目检归用户（DS_DEBUG=1 启动→右下角角标→浮窗四区块→两层调试入口） | 卡①门：迭代 14 出口（注：本卡先于迭代 14 出口落籍——编入时点迭代 14 ③已闭/①②④⑤在飞/⑥挂起，门列仅记编入时点状态，不构成追溯闸） | 单批已落地（原估 0.5d，实际一次会话）；后续扩调试项=debug_overlay.gd _build() 列表区追加区块（P4 扩展口径） | -| 迭代 15 | **②奇物概念收口与词族对齐批（2026-10-05 用户令编入本迭代）**：概念层已由用户逐轮裁定定稿（《奇物》v1.0→v2.7，7 轮），本批只做**落地对齐**、不做二次设计。三批内容：**①三套旧词族全面对齐**（顶层已改名「奇物」而代码仍叫旧名＝用户最初抱怨的"文档与代码分开"）：`feature_*`→`curio_*`（103 处/7 文件）、`relic_*`→`feat_*`（162 处/12 文件）、运行层 `bonus_*`→`curio_*`（160 处/8 文件）。**硬约束：`reward_*` 已被 `reward_pick`/`reward_node`/`reward_preview` 占用，统一词族不得使用**；`relic_table.gd` 与两个控制器类改名须同步 Godot `.uid`/`.tscn`（非文本层无法自证）。**②三条渠道按分类分离**（现行三渠道共用同一个 98 张池、三类混编）：关底 Boss 击败＝通过这一关→只出专长；奖励节点/商店→属性值提升+资源、专长在此**只以门票形式**出现。**兑付频率红线**：奇物不是打一场战斗给一份，关内普通战斗节点打完不给任何奇物，一关之内只兑付一次（用户 2026-10-05 纠错）。**③两个新种类入池**＝刷新次数（须先与"商店独立刷新机制"划清边界）+ 专长获取门票（拿到即开不可囤积/罕见只在概率/一局限购一次/计步保底：连续 5 次三选一展示未出→第 6 次必出，刷新重展计入、奖励节点与商店共享计数）；附带 `shop.tres` 补回复（默认原则要求分类内成员都在该出现的渠道池里）与 charge 标签补至 ≥4 件（现仅 3 件，档二永远达不到——数据缺陷）。设计事实源=`design/gdd/systems/冒险循环/奇物.md` v2.7，任务书=`design/research/任务书-奇物词族对齐与渠道分离批-2026-10-05.md`（T0-T8≈4.5d，两段切分预案在册〔段一词族 T0-T3≈2d/段二渠道+入表 T4-T8≈2.5d〕，切分点=T3 出口；11 条设计契约含 6 条 🔴 停机级；12 条批末验收断言；代拍板白名单 5 项；待用户裁点 4 项〔玩家可见面违规/第四关档二复裁/门票四参数终值/存档键正式迁移〕）。**开工门**：与在途 M-4 各批（判式换代/全局变异/配比预设）撞同一批文件（`adventure_table.gd`/`level_runner.gd`/`adventure.tres`），须确认不并行或用户明示插队 | 卡②门：迭代 14 出口 | 卡①已落籍（原估 0.5d）；卡② ✅ **已全批落籍（2026-10-05，worktree curio-wordfamily 七提交 d4cde73..049aa62+master 同步 23547b5，主区 merge 见台账；出口报告=[iter15-2-curio-exit-report](design/qa/iter15-2-curio-exit-report-2026-10-05.md)）**：三套词族代码层全换（feature_→curio_ 93 处/bonus_ 运行层→curio_/relic_→feat_——feat_table.gd/feats.tres/feats_engine.gd 改名）；渠道白名单分离（总池-渠道子集多级缓存形=用户裁）；门票入表（四参数 provisional 20%/2/1/5+拿到即开+计步保底+限购 1+节点商店共享计数）；refresh 入池（B 案 heal 5→3 挤占）+shop.tres 补 heal 行+门票行；T2 裁点甲案=六存档键禁改（含任务书漏登记的 "relics" 键）；charge 缺陷登记不硬补；autoplay 门票分支缺陷批内实测修复（MC timeout 形态）；闸=冒烟 782/0（+10）+run_all 16 套历史首次全绿（reward_overlay 红转绿=M7 bcard 成因修复）+五探针绿+doc 三闸零新增+MC n200 只测不判（normal 0.5%/perfect 77.5%）；遗留=07⑰ 目检归用户+C1 呈现批/C2 第四关批/C3 调参批/C4 存档批四移交。原估 T0-T8≈4.5d（实际一次会话）；**迭代 15 整行保持开放不标完成** | -| 迭代 15 | **③秘宝代码词族对齐批（2026-10-05 用户令编入本迭代）**：设计侧已完成（消歧更名批 `430419c`+`06e94b7`，26 个设计文档「魔法道具」→「**秘宝**」，同调位机制名保留不变），本批只做**代码侧对齐**、不做二次设计。内容：`aux_*`/`AuxItem*` 词族全族换词 **358 处 / 36 文件**（重灾 `adventure_runner.gd`79 / `level_runner.gd`27 / `bonus_interact_controller.gd`19 / `battle_orchestrator.gd`18 / `config_db.gd`14 / `main.gd`13），分五组落：**A 玩家可见文案（P0，5 处）**=`battle_narrator.gd:117-118` + `bonus_interact_controller.gd:76` + `hero_info_panel_view.gd:56`（槽位标题 `UiKit.label`）+ `:178`（tooltip）· B schema 与数据表（`aux_item_table.gd`/`aux_items.tres`/`aux_items.gd` 文件名+类名+`ConfigDB` 持有变量与访问器全链跟改，**须同步 Godot `.uid`/`.tscn` + `--import` 重刷类名缓存**——迭代 14.5 实证在册坑）· C 文档链接修复（含 `architecture.md` 两处既有断债顺带清偿）· D 中文注释层（**须分色**：`魔法矢`/`魔法反噬`/`魔法族`/`魔法护甲` 属敌方伤害护甲语汇🔴不动）· E 测试文件名+内部变量。**用户三项拍板**：全族彻底改（含数据表）· **断点存档键一律保留**（`bonus_aux_carry`/`aux_detail`/`aux_cleared`/`aux_cleared_last`/`aux_items` 断点数组/`attunement_charges` 共 34 处引用一字不改，破档即进度丢失）· registry 条目键 `aux_items` 不改（数据契约键）。设计事实源=`design/gdd/systems/排雷循环/秘宝.md` v0.9，任务书=`design/research/任务书-秘宝代码词族对齐批-2026-10-05.md`（T0-T9≈5.0d，**超软盒 3 日上限·知情预挂**：T7 段末闸后 L3 呈报切点不擅切；**三档降级面 G1/G2/G3 在册**〔G3 下限=仅组 A 完成〕；5 条设计契约含 5 条 🔴 停机级〔存档兼容零破坏/数值零漂移/schema 契约面零变更/零字段更名/核心层零 await〕；代拍板白名单 5 项；**C1/C2 已裁关闭·全改保一致·待裁点 0 项**）。**撞批已消解**：② 奇物批 2026-10-05 收口落库（合并 `c571af2`），并行风险解除，本批为迭代 15 唯一在途需求；**T0 须重取基线**（判式换代批 T5 读数 750/0、② 又动数据层，§1.2 的 747 为②前旧数禁沿用）并复核事实表。**✅ 裁决（用户 2026-10-05「全改保一致」）**：C1 `"aux_item"` 域串**照改**（实测连锁面收窄——`reward.tres` 已零 aux_item 数据行，池种随迭代 11 T7 退役；16 处字面量全在代码内闭合无存档依赖；唯一连锁项=`smoke_all.gd:3932` 断言须同步）· C2 `aux_items` 一名两义**拆分**（ConfigDB 持有变量+表注册键✅改 / 断点存档键+冒烟夹具🔴禁改——**「键名禁改」与「变量名禁改」是两回事**，禁改的只是落盘字面量）。新增**组 F**（分派语汇与域串 16 处），任务卡扩为 T0-T10≈5.5d。**开工门**：✅ 已无待裁点，可直接发 T0 | 卡③门：迭代 14 出口（**裁点已全决·可开工**） | 卡①已落籍（原估 0.5d）；卡②文档+数据层落籍（`c571af2`，实施段回归迭代 15 在飞——2026-10-05 用户令）；**卡③ ✅ 已全批落籍（2026-10-05，worktree m4iter15-mibao 九提交 b4b8bb3..收口笔，主区 merge --no-ff 哈希见台账/active.md 快照行；出口报告=[iter15-3-mibao-exit-report](design/qa/iter15-3-mibao-exit-report-2026-10-05.md)）**：词族实数 364 处/36 文件全换尽（例外 43+2 处=存档键引号字面量+夹具，穷举在报告 §五）；闸=冒烟 755/0+run_all 14/15（唯一红=②批遗留基线红 reward_overlay，对照零新增）+行为探针四件全绿+doc 三闸/熵增闸零新增+存档键六键普查零差异+MC 按 goal 令豁免（静态零漂移证明代）；渲染像素五闸屏蔽挂账 07⑮；遗留=实机目检归用户（07⑮）+reward_overlay 基线红归②批处置 | -| 迭代 16 | **①敌人表行集多行批（2026-10-05 用户令编入本迭代，纯功能与数值轴四卡之一）**：放开敌人表「同一（关卡序号 × 节点深度）行集恰一敌种」加载期校验（enemy_table.gd:108-112 考证在册），允许同场遭遇混编多种敌人——生成（unit_container spawn 行集受理）/编排（battle_orchestrator/narrator）/断言面全链接通 + GDD 结构冻结面修订先行（敌人系统.md:75/:263）。事实源=06「同深度第二敌种与精英/Boss 编码位」条剩余面（前半已由关卡节点地图 v1.0 消解）；前置=技能池实施批已落籍（d3fa887）开工门已解。任务书=`design/research/任务书-敌人表行集多行批-2026-10-05.md`（T0-T8≈4.25d 含条件卡 T5 首行投放/3.75d 不含；🔴 契约 5 条含零内容期逐位零漂移；代拍板白名单 3 项；**待用户裁点 4 项**〔P1 混编数量语义三案/P2 行集解析双算法处置〔工作日志 312 既有待裁随批〕/P3 本批是否投首个混编行/P4 Boss 行是否放开〕——裁点裁决后 U0 开工） | 迭代 15 出口 | T0-T8≈4.25d（超软盒预挂，T4 末切分点） | -| 迭代 16 | **②M4 数值批（2026-10-05 用户令编入本迭代）**：四件数值欠账合一批——①削弱档位终值（weaken 现值 −65/duration 2/refresh 考证在册；叠层改续时语义已定案，差 duration 终值+当量锚复算）②调参批数值点评（06 条目现行登记五条——任务口径「八条」与条目五条不符，任务书 §2.2 已呈报差异以条目为准）③迭代 10 奖励重构联动欠账①②（钥石产出重标 boss_keystone 首杀 3/3/3·复杀 2/2/3 provisional + 通关率带重扫〔通关回血 20%+AP 件首轮 +1〕）④元进度定价剩余面（forge base 20/比 150 考证在册——06 条目文本「base 10」滞后于 2026-09-22 对齿批已呈报；Boss 两档终值）。读数义务随批=迭代 14 两件后置复算（T6 MC 四带复算+T7 技能池节奏重测，均挂 07）；顺路修复 damage_probe A1 改前既有红灯（判式换代批出口报告 §四.7 在册）。**硬约束：一切 MC/verifier 跑批发起前须用户批准；调参联动禁独立调参网络（β 带 [1.2,2.5] 逐 u 检算）**。任务书=`design/research/任务书-M4数值批-2026-10-05.md`（T0-T8≈6.0d，天然切分点 T4 末；🔴 契约 5 条含跑批批准制；**待用户裁点 4 项**〔P1 削弱终值三案推算后裁/P2 点评不对称裁决方向/P3 钥石产出终值/P4 工坊直购价立否〕） | 迭代 15 出口 | T0-T8≈6.0d（超软盒预挂，段一 T0-T4≈4.25d/段二 T5-T8≈2.0d） | -| 迭代 16 | **③暂停层只读入口批（2026-10-05 用户令编入本迭代）**：新增局内暂停层，承载钥石余额与解锁态（营地三柜台进度）只读查看——事实源=06「解锁界面与钥石呈现的交互形态（残余：暂停层只读入口）」条。考证在册：现行无暂停层；模态栈/设置面/调试浮窗三先例齐；UiKit 公共件（modal_shell/bcard/verb_button/徽章形制）与色板 token 单点现成；MetaProgression 只读访问器面齐全；战斗屏 GP/钥石已迁出=局内零查看入口正是本批由来。**美术红线：复用现行公共件与色板，零新素材零新色值（2026-10-05 用户立规）**。任务书=`design/research/任务书-暂停层只读入口批-2026-10-05.md`（T0-T5≈3.0d；🔴 契约 5 条含公共件单点/模态登记纪律；**待用户裁点 4 项**〔P1 入口位置四案荐丁/P2 与既有弹窗层关系三案荐甲/P3 展示范围三案荐甲/P4 减动效联动两案荐甲〕） | 迭代 15 出口 | T0-T5≈3.0d（贴软盒，T2 末切分点） | -| 迭代 16 | **④生涯界面设计立项（2026-10-05 用户令编入本迭代；只做设计提纲不做实装）**：事实源=06「『生涯』界面——冒险中数据回看的唯一承接处」条（P-C7 裁：M9 已退役局内结算明细回看，历史数据现无承接面=用户知情裁决）。考证在册：回看退役已落码（battle_end_overlay/battle_log_view/ui_assembler 三处注记）+settlement_review_overlay.gd 遗留件在盘+跨局持久面=save v5 meta 域+**无历史冒险记录面**（settle_adventure 只入账不留痕=最大数据设计题）。任务书形态=设计提纲版：信息架构+承载内容清单（跨局汇总/历史冒险回看/图鉴承接）+与既有界面关系+三期实装建议+待裁点，标注「实装批另行立项」。任务书=`design/research/任务书-生涯界面设计立项-2026-10-05.md`（T0-T2≈1.25d 纯文档零测试；**待用户裁点 6 项**〔P0 载体/P1 入口位置/P2 历史数据面范围/P3 图鉴范围与顺序/P4 跳转边界/P5 遗留件处置〕） | 迭代 15 出口 | T0-T2≈1.25d（软盒内） | +| 迭代 15 | **②奇物概念收口与词族对齐批（2026-10-05 用户令编入本迭代）**：概念层已由用户逐轮裁定定稿（《奇物》v1.0→v2.7，7 轮），本批只做**落地对齐**、不做二次设计。三批内容：**①三套旧词族全面对齐**（顶层已改名「奇物」而代码仍叫旧名＝用户最初抱怨的"文档与代码分开"）：`feature_*`→`curio_*`（103 处/7 文件）、`relic_*`→`feat_*`（162 处/12 文件）、运行层 `bonus_*`→`curio_*`（160 处/8 文件）。**硬约束：`reward_*` 已被 `reward_pick`/`reward_node`/`reward_preview` 占用，统一词族不得使用**；`relic_table.gd` 与两个控制器类改名须同步 Godot `.uid`/`.tscn`（非文本层无法自证）。**②三条渠道按分类分离**（现行三渠道共用同一个 98 张池、三类混编）：关底 Boss 击败＝通过这一关→只出专长；奖励节点/商店→属性值提升+资源、专长在此**只以门票形式**出现。**兑付频率红线**：奇物不是打一场战斗给一份，关内普通战斗节点打完不给任何奇物，一关之内只兑付一次（用户 2026-10-05 纠错）。**③两个新种类入池**＝刷新次数（须先与"商店独立刷新机制"划清边界）+ 专长获取门票（拿到即开不可囤积/罕见只在概率/一局限购一次/计步保底：连续 5 次三选一展示未出→第 6 次必出，刷新重展计入、奖励节点与商店共享计数）；附带 `shop.tres` 补回复（默认原则要求分类内成员都在该出现的渠道池里）与 charge 标签补至 ≥4 件（现仅 3 件，档二永远达不到——数据缺陷）。设计事实源=`design/gdd/systems/冒险循环/奇物.md` v2.7，任务书=`design/research/任务书-奇物词族对齐与渠道分离批-2026-10-05.md`（T0-T8≈4.5d，两段切分预案在册〔段一词族 T0-T3≈2d/段二渠道+入表 T4-T8≈2.5d〕，切分点=T3 出口；11 条设计契约含 6 条 🔴 停机级；12 条批末验收断言；代拍板白名单 5 项；待用户裁点 4 项〔玩家可见面违规/第四关档二复裁/门票四参数终值/存档键正式迁移〕）。**开工门**：与在途 M-4 各批（判式换代/全局变异/配比预设）撞同一批文件（`adventure_table.gd`/`level_runner.gd`/`adventure.tres`），须确认不并行或用户明示插队 | 卡②门：迭代 14 出口 | 卡①已落籍（原估 0.5d）；卡② ✅ **已全批落籍（2026-10-05，worktree curio-wordfamily 七提交 d4cde73..049aa62+master 同步 23547b5，主区 merge 见台账；出口报告=[iter15-2-curio-exit-report](design/qa/iter15-2-curio-exit-report-2026-10-05.md)）**：三套词族代码层全换（feature_→curio_ 93 处/bonus_ 运行层→curio_/relic_→feat_——feat_table.gd/feats.tres/feats_engine.gd 改名）；渠道白名单分离（总池-渠道子集多级缓存形=用户裁）；门票入表（四参数 provisional 20%/2/1/5+拿到即开+计步保底+限购 1+节点商店共享计数）；refresh 入池（B 案 heal 5→3 挤占）+shop.tres 补 heal 行+门票行；T2 裁点甲案=六存档键禁改（含任务书漏登记的 "relics" 键）；charge 缺陷登记不硬补；autoplay 门票分支缺陷批内实测修复（MC timeout 形态）；闸=冒烟 782/0（+10）+run_all 16 套历史首次全绿（reward_overlay 红转绿=M7 bcard 成因修复）+五探针绿+doc 三闸零新增+MC n200 只测不判（normal 0.5%/perfect 77.5%）；遗留=07⑰ 目检归用户+C1 呈现批/C2 第四关批/C3 调参批/C4 存档批四移交。原估 T0-T8≈4.5d（实际一次会话）；迭代 15 三卡全落籍（①352/②本批/③8944dca 前身③批+本批） | +| 迭代 15 | **③秘宝代码词族对齐批（2026-10-05 用户令编入本迭代）**：设计侧已完成（消歧更名批 `430419c`+`06e94b7`，26 个设计文档「魔法道具」→「**秘宝**」，同调位机制名保留不变），本批只做**代码侧对齐**、不做二次设计。内容：`aux_*`/`AuxItem*` 词族全族换词 **358 处 / 36 文件**（重灾 `adventure_runner.gd`79 / `level_runner.gd`27 / `bonus_interact_controller.gd`19 / `battle_orchestrator.gd`18 / `config_db.gd`14 / `main.gd`13），分五组落：**A 玩家可见文案（P0，5 处）**=`battle_narrator.gd:117-118` + `bonus_interact_controller.gd:76` + `hero_info_panel_view.gd:56`（槽位标题 `UiKit.label`）+ `:178`（tooltip）· B schema 与数据表（`aux_item_table.gd`/`aux_items.tres`/`aux_items.gd` 文件名+类名+`ConfigDB` 持有变量与访问器全链跟改，**须同步 Godot `.uid`/`.tscn` + `--import` 重刷类名缓存**——迭代 14.5 实证在册坑）· C 文档链接修复（含 `architecture.md` 两处既有断债顺带清偿）· D 中文注释层（**须分色**：`魔法矢`/`魔法反噬`/`魔法族`/`魔法护甲` 属敌方伤害护甲语汇🔴不动）· E 测试文件名+内部变量。**用户三项拍板**：全族彻底改（含数据表）· **断点存档键一律保留**（`bonus_aux_carry`/`aux_detail`/`aux_cleared`/`aux_cleared_last`/`aux_items` 断点数组/`attunement_charges` 共 34 处引用一字不改，破档即进度丢失）· registry 条目键 `aux_items` 不改（数据契约键）。设计事实源=`design/gdd/systems/排雷循环/秘宝.md` v0.9，任务书=`design/research/任务书-秘宝代码词族对齐批-2026-10-05.md`（T0-T9≈5.0d，**超软盒 3 日上限·知情预挂**：T7 段末闸后 L3 呈报切点不擅切；**三档降级面 G1/G2/G3 在册**〔G3 下限=仅组 A 完成〕；5 条设计契约含 5 条 🔴 停机级〔存档兼容零破坏/数值零漂移/schema 契约面零变更/零字段更名/核心层零 await〕；代拍板白名单 5 项；**C1/C2 已裁关闭·全改保一致·待裁点 0 项**）。**撞批已消解**：② 奇物批 2026-10-05 收口落库（合并 `c571af2`），并行风险解除，本批为迭代 15 唯一在途需求；**T0 须重取基线**（判式换代批 T5 读数 750/0、② 又动数据层，§1.2 的 747 为②前旧数禁沿用）并复核事实表。**✅ 裁决（用户 2026-10-05「全改保一致」）**：C1 `"aux_item"` 域串**照改**（实测连锁面收窄——`reward.tres` 已零 aux_item 数据行，池种随迭代 11 T7 退役；16 处字面量全在代码内闭合无存档依赖；唯一连锁项=`smoke_all.gd:3932` 断言须同步）· C2 `aux_items` 一名两义**拆分**（ConfigDB 持有变量+表注册键✅改 / 断点存档键+冒烟夹具🔴禁改——**「键名禁改」与「变量名禁改」是两回事**，禁改的只是落盘字面量）。新增**组 F**（分派语汇与域串 16 处），任务卡扩为 T0-T10≈5.5d。**开工门**：✅ 已无待裁点，可直接发 T0 | 卡③门：迭代 14 出口（**裁点已全决·可开工**） | 卡①已落籍（原估 0.5d）；卡② ✅ 已全批落籍（2026-10-05 merge 3c6f2c9，台账 362——c571af2 文档+数据层之上的实施段全量补完）；**卡③ ✅ 已全批落籍（2026-10-05，worktree m4iter15-mibao 九提交 b4b8bb3..收口笔，主区 merge --no-ff 哈希见台账/active.md 快照行；出口报告=[iter15-3-mibao-exit-report](design/qa/iter15-3-mibao-exit-report-2026-10-05.md)）**：词族实数 364 处/36 文件全换尽（例外 43+2 处=存档键引号字面量+夹具，穷举在报告 §五）；闸=冒烟 755/0+run_all 14/15（唯一红=②批遗留基线红 reward_overlay，对照零新增）+行为探针四件全绿+doc 三闸/熵增闸零新增+存档键六键普查零差异+MC 按 goal 令豁免（静态零漂移证明代）；渲染像素五闸屏蔽挂账 07⑮；遗留=实机目检归用户（07⑮）+reward_overlay 基线红归②批处置 | +| 迭代 16 | **UI 设计对齐批（2026-10-05 用户令：迭代 16 改编为 UI 优化需求实现，原四卡全数顺延迭代 17；美术线用户自理立规的例外面=本批只改 UI 设计代码、零美术资源改动）**：三路改进整合轴的代码侧落地——事实源=`design/research/UI预览demo三路改进整合对照-2026-10-04.md`（A 落码差异对照+OPT-A 机检+WB 变体三路整合，基线原型 v2.1）。**红线=不修改美术资源**：game/assets/art 与 artwork/ 均不动、不生新素材不重烘，只改 UI 设计代码（ui_kit 色板 token/字号档/布局纪律/对比度垫底/抖动呈现/panel_skinned 接线等）。无分歧可直接收项=对比度 7 处 FAIL 修法（血数 2.09→12.29 垫底等已复算）/站桩溢出 3.2px/4 处裸色收 ui_kit/status 图标 preload 违规/tg-* 类型色接线。**前置待裁=六分歧点**（①底色冷暖 ②棋盘格边长 32/44/45 ③字号档位 ④九宫格切片 ⑤圆角去留 ⑥图标尺寸解法，对照表 §三）+开放项（抖动范围/色板唯一来源，§五）。任务书=`design/research/任务书-UI设计对齐批-2026-10-05.md`（T0-T11≈7.25d，**超软盒 3d 预挂**，三段切分=段一 2.0d 无阻断〔T0-T4a〕/ 段二 4.0d 待裁〔T4b-T8〕/ 段三 1.0d 收口〔T9-T11〕；🔴 契约 7 条 R1-R7；无分歧收项 N1-N6 已逐处 file:line 考证；**待用户裁点 11 项**=六分歧 P1 底色冷暖/P2 棋盘格边长/P3 字号档位/P4 九宫格切片/P5 圆角去留/P6 图标尺寸解法 + 开放项 P7 色板唯一来源/P8 抖动范围/P9 §五 已决注销清单/P10 记忆态口径/P11 装饰 caption 豁免；**六分歧与开放项一律呈全备选案含淘汰依据**）。**事实校正（实查，2026-10-05）**：9 处色板漂移实测 4 已收 5 未收；`tg-*` 五族在 ui_kit 并不存在（以裸 Color8 内联于 bonus_pick_overlay/shop_overlay_view，缺第五族）；panel_skinned 消费面实测 8 处+工厂 1 处；棋盘格边长=动态公式 clamp[26,46] 与 §8.1 锚点 45/36 三方互不等；手绘图标十枚 20×20 已入库，真问题转为 64×64 柜台四枚显示倍率；站桩溢出实机存在 1px 余量同型写法（standee_body.gd:476）；demo 基线 md5 已再次漂移（实测 78ebbee0…）。状态=**任务书已起草（2026-10-05）+ 取向已定（2026-10-06）**：✅ P1=甲（维持暖化零改动）/ P2=丁（棋盘格边长零改动，46/45/44 不一致登记为已知偏差）；✅ **其余八项取向已定**（用户采纳推荐）——**跟 demo**：P4 九宫格切片 8→16 / P7 五处色板向 demo / P10 记忆态纹理灰罩；**按条款解**：P3 字号立 FS_* 档（demo 34 处<14、54 处<16 不可跟）/ P6 图标显示档（demo 自身 0.3125× 违规）/ P8 抖动只做卡顶色带（demo 渐变+blur 违反像素纪律）/ P11 装饰 caption 12px 豁免；P5 两路同结论。**「以 demo 为准」三层优先级栈=任务书 §8.3**（①用户终裁＞②冻结条款＞③demo）；三条结构级差异（卡片 232×352 / 商店全屏化 / 地图底栏合并）**不入本批、已登记 06 待立项**。估时 T0-T11≈**6.9d**（段一 2.15d 无阻断可发令 / 段二 3.75d / 段三 1.0d；三段同属一迭代、**只在段三末合并一次**）；**拷打轮一 9 问已全部落地**（Q1 `panel_skinned` content margin clamp / Q2 不走独立样张闸改并进 T10 目检 / Q3 柜台图标统一 32px / Q4 商店补类型分族 / Q5 血数 11px 与装饰 caption 合并写一条豁免 / Q6 槽两态不新增通道 / Q7 一次合并 / Q8 已知偏差已登记 06 / Q9 demo 取值抄录表为唯一引用源） | 迭代 15 出口 | T0-T11≈7.25d（三段切分，段一可先发令） | +| 迭代 17 | **①敌人表行集多行批（2026-10-05 用户令编入本迭代，纯功能与数值轴四卡之一）**：放开敌人表「同一（关卡序号 × 节点深度）行集恰一敌种」加载期校验（enemy_table.gd:108-112 考证在册），允许同场遭遇混编多种敌人——生成（unit_container spawn 行集受理）/编排（battle_orchestrator/narrator）/断言面全链接通 + GDD 结构冻结面修订先行（敌人系统.md:75/:263）。事实源=06「同深度第二敌种与精英/Boss 编码位」条剩余面（前半已由关卡节点地图 v1.0 消解）；前置=技能池实施批已落籍（d3fa887）开工门已解。任务书=`design/research/任务书-敌人表行集多行批-2026-10-05.md`（T0-T8≈4.25d 含条件卡 T5 首行投放/3.75d 不含；🔴 契约 5 条含零内容期逐位零漂移；代拍板白名单 3 项；**待用户裁点 4 项**〔P1 混编数量语义三案/P2 行集解析双算法处置〔工作日志 312 既有待裁随批〕/P3 本批是否投首个混编行/P4 Boss 行是否放开〕——裁点裁决后 U0 开工） | 迭代 15 出口 | T0-T8≈4.25d（超软盒预挂，T4 末切分点） | +| 迭代 17 | **②M4 数值批（2026-10-05 用户令编入本迭代）**：四件数值欠账合一批——①削弱档位终值（weaken 现值 −65/duration 2/refresh 考证在册；叠层改续时语义已定案，差 duration 终值+当量锚复算）②调参批数值点评（06 条目现行登记五条——任务口径「八条」与条目五条不符，任务书 §2.2 已呈报差异以条目为准）③迭代 10 奖励重构联动欠账①②（钥石产出重标 boss_keystone 首杀 3/3/3·复杀 2/2/3 provisional + 通关率带重扫〔通关回血 20%+AP 件首轮 +1〕）④元进度定价剩余面（forge base 20/比 150 考证在册——06 条目文本「base 10」滞后于 2026-09-22 对齿批已呈报；Boss 两档终值）。读数义务随批=迭代 14 两件后置复算（T6 MC 四带复算+T7 技能池节奏重测，均挂 07）；顺路修复 damage_probe A1 改前既有红灯（判式换代批出口报告 §四.7 在册）。**硬约束：一切 MC/verifier 跑批发起前须用户批准；调参联动禁独立调参网络（β 带 [1.2,2.5] 逐 u 检算）**。任务书=`design/research/任务书-M4数值批-2026-10-05.md`（T0-T8≈6.0d，天然切分点 T4 末；🔴 契约 5 条含跑批批准制；**待用户裁点 4 项**〔P1 削弱终值三案推算后裁/P2 点评不对称裁决方向/P3 钥石产出终值/P4 工坊直购价立否〕） | 迭代 15 出口 | T0-T8≈6.0d（超软盒预挂，段一 T0-T4≈4.25d/段二 T5-T8≈2.0d） | +| 迭代 17 | **③暂停层只读入口批（2026-10-05 用户令编入本迭代）**：新增局内暂停层，承载钥石余额与解锁态（营地三柜台进度）只读查看——事实源=06「解锁界面与钥石呈现的交互形态（残余：暂停层只读入口）」条。考证在册：现行无暂停层；模态栈/设置面/调试浮窗三先例齐；UiKit 公共件（modal_shell/bcard/verb_button/徽章形制）与色板 token 单点现成；MetaProgression 只读访问器面齐全；战斗屏 GP/钥石已迁出=局内零查看入口正是本批由来。**美术红线：复用现行公共件与色板，零新素材零新色值（2026-10-05 用户立规）**。任务书=`design/research/任务书-暂停层只读入口批-2026-10-05.md`（T0-T5≈3.0d；🔴 契约 5 条含公共件单点/模态登记纪律；**待用户裁点 4 项**〔P1 入口位置四案荐丁/P2 与既有弹窗层关系三案荐甲/P3 展示范围三案荐甲/P4 减动效联动两案荐甲〕） | 迭代 15 出口 | T0-T5≈3.0d（贴软盒，T2 末切分点） | +| 迭代 17 | **④生涯界面设计立项（2026-10-05 用户令编入本迭代；只做设计提纲不做实装）**：事实源=06「『生涯』界面——冒险中数据回看的唯一承接处」条（P-C7 裁：M9 已退役局内结算明细回看，历史数据现无承接面=用户知情裁决）。考证在册：回看退役已落码（battle_end_overlay/battle_log_view/ui_assembler 三处注记）+settlement_review_overlay.gd 遗留件在盘+跨局持久面=save v5 meta 域+**无历史冒险记录面**（settle_adventure 只入账不留痕=最大数据设计题）。任务书形态=设计提纲版：信息架构+承载内容清单（跨局汇总/历史冒险回看/图鉴承接）+与既有界面关系+三期实装建议+待裁点，标注「实装批另行立项」。任务书=`design/research/任务书-生涯界面设计立项-2026-10-05.md`（T0-T2≈1.25d 纯文档零测试；**待用户裁点 6 项**〔P0 载体/P1 入口位置/P2 历史数据面范围/P3 图鉴范围与顺序/P4 跳转边界/P5 遗留件处置〕） | 迭代 15 出口 | T0-T2≈1.25d（软盒内） | ## 执行纪律（2026-09-27 用户立规）