diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index 28e53ced..32912c1e 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -58,6 +58,14 @@ **状态**:待办(**Alpha 阶段需完成**)——①②③是观感改动,④只需关闭或移进调试浮窗,成本很低,可以顺手带上。**①已销号**(2026-10-13 迭代 25「UI 全局主题批」收口——滑轨词条迁全局主题时两段对比度重配:已填充段 BG_ROOT #3A2E22 对槽暖石 #B8A582 ≈5.5:1,「拖到中点一眼可辨」;实机目检随 07 登记项归用户。另:代码面两段色实为暖石/深棕两值,与诊断「同一深棕」描述不符,已随批呈报)。余②③④保留待立项。 +#### 需求卡片:UI 交互与观感批(2026-10-13 成文,待裁) + +**内容**:UI 美化三层诊断剩余可纯工程落地部分的收口批,六项——①按钮五态矩阵补齐(普通钮悬停态甲/乙待裁、禁用态错配修正、危险钮本族按下态、三工厂焦点样式盒);②全局纹理过滤设邻近采样(project.godot 一行+显式 LINEAR 白名单+翻转面枚举);③三处 <4.5:1 文字位换墨(站桩护甲徽标两处+敌顺位徽标+RAP 反馈行,机检断言锚定);④光柱硬边修(带内 alpha 渐变+纵向衰减);⑤元素细节余②③(BCard 图标槽明度差降档、商店卡片区垂直居中、营地四栏等高);⑥诊断转储钮移入调试浮窗。**范围按代码实查订正**( iter25 滑轨条同款订正先例):②垫块仅三选一 BCard 一处(商店卡实为纯文字行卡无图标);③仅商店+营地(三选一卡片区实查已居中);危险钮「无按下态」订正为「按下态在但皮肤错配(红钮承石纹按压图)」。任务卡 T0-T6 共 ≈2–2.5d,验证闸 V1-V7,代拍板白名单八项,反哺点三条。 + +**指针**:`design/research/需求卡片-UI交互与观感批-2026-10-13.md` + +**状态**:**已编入**(2026-10-14 用户令入迭代 26 卡①;卡片 v1.2 成立、零待裁点;开工门=U0〔用户新会话 /iter 26 四检发令〕)——本批落地后上方第一层第二/三条、第三层四条(<4.5:1/氛围层光柱半/元素细节余项)按卡片 §5 同步面销号或改写。 + #### 旧行为 MC 行为锚全数作废——重锚归数值批(2026-10-06 登记) **现状**:案C 地图伤害账殿后批(git 7ef18ac,台账 371)改变每轮结算行为序——授予段不再兑付任何伤害(伤害形态单据暂存至战斗段末,段内序=主角先手→逐敌还手→地图账),主角死亡短路语义随之换代(「授予段伤害致死短路先手」路径消失)。既有全部 MC 行为锚与对拍锚所锚行为已不存在,**全数作废**;新段内序断言已入冒烟闸。按 sim-data MC 缓存层规则(无数值调整禁重跑),重锚不在改动批执行。 diff --git a/design/research/需求卡片-UI交互与观感批-2026-10-13.md b/design/research/需求卡片-UI交互与观感批-2026-10-13.md new file mode 100644 index 00000000..bc1e58f4 --- /dev/null +++ b/design/research/需求卡片-UI交互与观感批-2026-10-13.md @@ -0,0 +1,196 @@ +# 需求卡片:UI 交互与观感批(按钮五态矩阵 · 全局纹理过滤 · 观感四件) + +- 版本:v1.2(2026-10-14 grilling 第二轮三裁落文,用户令「按推荐」:⑥<4.5:1=换墨 ⑦光柱=连续 alpha(filter 归 LINEAR 白名单)⑧诊断钮=移调试浮窗)——**两轮八裁全落、零待裁点,卡片成立;开工门=U0(待用户编入迭代点名)** +- 来源:[06-待办清单](../gdd/06-待办清单.md) 五条(2026-10-13「UI 美化三层诊断」登记)+[08-Alpha版本标准](../gdd/08-Alpha版本标准.md) 对应行 +- 归属:呈现层表现批(纯工程,零新素材) +- 排期:**已编入迭代 26 卡①**(2026-10-14 用户令;卡片状态=已编入;开工门=U0——用户新会话 /iter 26 四检发令;本迭代位预留后续追加卡,同迭代 24 先例);**M4 数值批顺延 27+** + +## 1. 目标与完成定义 + +把「UI 美化三层诊断」里**剩余可纯工程落地**的部分一次收口,六项: + +1. **按钮五态矩阵补齐**(第一层第二条):普通钮悬停态(乙案 modulate 提亮)+禁用态错配修正、危险钮本族按下态+禁用态、主钮禁用态、三工厂键盘焦点样式盒; +2. **全局纹理过滤设邻近采样**(第一层第三条):`project.godot` 一行设置+显式 LINEAR 白名单+翻转面全枚举; +3. **三处 <4.5:1 文字位换墨**(第三层机判组):站桩护甲徽标两处+敌顺位徽标+RAP 反馈行,机检断言锚定; +4. **光柱硬边修**(第三层①):斜光带内 alpha 渐变+纵向衰减; +5. **元素细节余②③**(第三层,④诊断钮单列):BCard 图标槽明度差降档、商店卡片区垂直居中、营地四栏等高; +6. **诊断转储钮退出玩家画面**(第三层④):移入调试浮窗。 + +**完成定义**:六项落码;冒烟+单元+场景探针+改前改后读数对拍四闸全绿;冒烟新增断言在位(§7);06 相关条目销号或改写、08 回填、07 登记目检项(登记不阻塞);反哺点四条列明待用户裁决。 + +## 2. 现状事实(2026-10-13 代码级实查;开工自行复核) + +### 2.1 按钮皮(`game/presentation/views/ui_kit.gd`) + +- `_apply_button_skin`(:541-555,四工厂公共打底):normal=button_stone 九宫格(8px 切片);**hover=同一张常态图**(:547,悬停零视觉变化);pressed=button_stone_pressed(:549);**disabled= pressed 图**(:550——禁用态长相=按下态);font 五色齐(normal/hover/pressed/focus 同 INK,disabled=INK α0.45);**无 focus 样式盒**——键盘焦点走引擎默认灰描边。 +- 四工厂终态(实查各厂 override 叠加结果): + +| 工厂 | normal | hover | pressed | disabled | focus 样式盒 | +|---|---|---|---|---|---| +| `button()` :445 / `verb_button()` :562 | 石纹 | **=常态图** | 石纹按压 | **=石纹按压** | **无** | +| `primary_button()` :575 | 烛光黄平涂 | 烛光黄提亮 | 烛光黄深档 | **=石纹按压(错配)** | **无** | +| `danger_button()` :591 | 深红平涂 | 深红提亮 | **=石纹按压(错配)** | **=石纹按压(错配)** | **无** | + +- 素材:`game/assets/art/ui/button_stone.png` 与 `button_stone_pressed.png` 均 **48×48 RGBA**(8px 九宫格,实查 PIL);**无悬停态素材**。 +- **诊断订正①**:06 记「危险钮只填常态与悬停,没有按下态也没有禁用态」——实查按下/禁用态**在**(承自 skin 打底),但皮肤错配(红钮按下显石纹棕图);危险钮自身只覆写了 normal/hover。缺的是「本族按压态」,不是「态本身」。按迭代 25 滑轨条先例,卡片以代码面为准。 +- **诊断订正②**:06 记「五种状态覆盖数量很不齐(悬停四处/按下三处/禁用一处/焦点零处)」——焦点样式盒为零属实;其余计数系按工厂逐条数的近似值,与 override 叠加终态有出入(禁用态实为三厂**全部**继承 skin 的 pressed 图=错配而非「一处」)。本卡以本表终态为准。 + +### 2.2 纹理过滤 + +- `game/project.godot` **无** `rendering/textures/canvas_textures/default_texture_filter` 设置(引擎默认 Linear;全文仅 theme/custom_font 与 theme/custom 两行界面相关)。 +- 全库显式 `texture_filter` 共 13 处:**NEAREST 11 处**(ui_assembler.gd:188、battle_end_overlay.gd:60/76、board_fx_view.gd:150、board_view.gd:310、board_world.gd:50、hero_info_panel_view.gd:202、level_map_screen.gd:169、standee_body.gd:222、ui_kit.gd:234/508/671);**LINEAR 2 处**(board_world.gd:43 脚影=径向渐变平滑衰减;status_slot_row.gd:127 状态图标=§8.2 已登记例外「抗锯齿矢量风源图」)。(**2026-10-14 T0 勘误**:成文时计 12 处、漏登 `board_world.gd:50`(hero 立绘 sprite NEAREST),开工事实抽查实测 13 处;该点与本批全局 Nearest 意图同向,不属翻转面风险、不进 LINEAR 白名单,V3 断言不受波及) +- 平滑渐变件(当前无显式 filter=继承 Linear,改全局 Nearest 后会劣化,须显式白名单): + - `vignette_rect`(ui_kit.gd:242-258)径向暗角 256×256,STRETCH_SCALE 拉满全屏——Nearest 下 1920 宽屏会出可见像素块; + - `gradient_base`(ui_kit.gd:281-296)竖向渐变 64×256,STRETCH_SCALE; + - `beams_rect`(ui_kit.gd:263-277)程序生成 560×560,STRETCH_TILE——归属已裁=显式 LINEAR 白名单(Q7,随 T4 连续 alpha 实现一并落)。 +- 改全局 Nearest 的翻转面=上述之外的全部纹理(立绘/瓦片/格面/图标——即本批意图);T0 枚举成清单。 + +### 2.3 呈现层残余 <4.5:1 文字位(第三层) + +- 站桩护甲徽标(standee_body.gd:489-494,敌 only,直绘舞台底 STAGE_BG #3E342A,ui_kit.gd:118):轻甲 WARM_FAINT(过);**魔法护甲 HERO_BLUE(≈3.2:1)**;**重甲 GOLD_DEEP(≈3.3:1)**。 +- 敌顺位徽标 ①②③(standee_body.gd:436-441):GOLD_DEEP 13px 直绘同底(≈3.3:1)。 +- RAP 反馈行(ap_bar_view.gd:77):STONE_FAINT 对 AP 条面板底 PANEL_DATA #E9D9B8(ap_bar_view.gd:43;≈2.9:1)。 +- 站桩名行(:501 WARM)与轻甲档已过,不动;**不改 GOLD_DEEP/HERO_BLUE 常量本身**(他处语义岗在役——如 standee_body.gd:199 意图动画判据、board_view.gd:35 小人边框、level_map_screen.gd:237),只换上述裸用点位。 +- 机检设施现役:smoke_all.gd:29-37 `_theme_rel_luminance`/`_theme_contrast`(迭代 25 V2 滑轨断言同款)。 + +### 2.4 光柱(第三层①) + +`beams_rect`(ui_kit.gd:263-277)生成 560×560 贴片:带域 d∈[240,340) 内 α=0.05 匀净、**带内外缘零过渡**,暖白 (1, 236/255, 200/255),STRETCH_TILE 满铺——实机为三块等距硬边梯形(06 诊断原文)。 + +### 2.5 元素细节余②③④(第三层;①滑轨已随迭代 25 销号) + +- ②图标垫深块:BCard 图标槽(ui_kit.gd:659-663)76×76 SLOT_BACKDROP #3E362C 深墨棕直角块+1px 边,坐米色卡面;bcard 在役消费方=三选一(curio_pick_overlay.gd:103)。**诊断订正③**:06 记「商店与三选一的卡片上」——实查商店卡(shop_overlay_view.gd:121-139)为纯文字行卡、无图标槽;垫块仅三选一一处。 +- ③留白失衡:商店 `_cards_box`(shop_overlay_view.gd:64-67)VBox EXPAND_FILL、子项默认顶对齐→卡片堆上半、下半空(诊断属实)。**诊断订正④**:06 记「三选一同款」——实查三选一 `_choice_box`(curio_pick_overlay.gd:62-65)已 ALIGNMENT_CENTER+EXPAND_FILL、卡已垂直居中,描述不符。营地侧:camp_overlay_view.gd:106-175 四栏(天赋树/锻造工坊/秘宝匣/图鉴)高度不一(树与秘宝匣 scroll 有 336 min 高;锻造锁定态与图鉴栏仅锁文、无 min 高)。 +- ④诊断转储钮:main.gd:333-334 **无条件挂载** `UiAssembler.build_diag_button`(ui_assembler.gd:219-228,左下角 112px 常驻)——「调试变体」注释在册但无门控,玩家画面可见(06 诊断属实)。 + +### 2.6 冒烟基线与渲染闸 golden 面 + +987/0(active.md 489 条,2026-10-13;开工日复核)。迭代 25 遗留两条主题红线断言(smoke_all.gd:5376-5385:Button 类型词条零接触+focus 族词条零定义)——本批走逐实例 override 路线,两条断言**维持不换代**(§3)。 + +- **渲染闸 golden 面**(tools/render_gate.sh):board L1-L3 整屏帧逐像素比对(tools/golden_compare.py,容差=灰度差 ≤16 且 changed ≤2%)。**本批预期变更区=站桩徽标换墨**(①②③ 顺位徽标+护甲图标落在棋盘裁剪区):徽标像素静态估约 1% 量级(低于 2% 线,但换墨色差远超 16 容差,是否越线取决于当屏敌数)——处置见 T6 第 4 步。 +- 光柱仅在标题屏(ui_assembler.gd:111 `build_start_overlay`),**不在 golden 面**;战斗屏舞台底=平色 `panel_flat(STAGE_BG)`(battle_stage_view.gd:49),无纹理过滤依赖。 +- 全站按钮经 ui_kit 四工厂(裸 `Button.new()` 全库仅工厂自身 :446 命中,T1 覆盖面闭合)。 + +## 3. 设计契约(红线,违反=L3 停机呈报) + +- 🔴 **主题层零新增词条**:全部按钮状态走逐实例 override(ui_kit 工厂内),不碰 main_theme.tres 的 Button/focus 任何词条——迭代 25 两条红线断言(smoke_all.gd:5376-5385)必须原样维持绿。若实现中发现必须走主题层:停机呈报,两条断言同批换代须用户批。 +- 🔴 **零新美术素材**:全部改动用既有贴图/程序化生成(悬停态乙案=modulate 提亮,零素材);本批不自行产图——需要新素材的需求一律出批走美术线自立批。 +- 🔴 **棋盘战斗逻辑与棋盘几何零触碰**:board_view/board_world 除脚影既有显式 LINEAR 外零改动;全局纹理过滤属渲染设置面,不算触碰(其观感翻转正是意图,枚举清单见 T0)。 +- 🔴 **对比度硬指标**:换墨后各处 ≥4.5:1(art-bible §7.2),机检断言锚定;不达即回炉换值,不许放行。 +- 🔴 **旧实现同批清理**:诊断钮从 main.gd 卸载点真删(不留死开关);disabled=pressed 图的错配随批修正,禁止新旧并存。 + +## 4. 范围边界 + +**做**(六项,见 §1)。 + +**不做**(去向): +- 引擎原生控件(LineEdit/SpinBox/滑轨/滚动条)的键盘焦点视觉 → 维持引擎默认;归 06「棋盘战斗键盘/手柄输入」Beta 条连带裁决点③(本批交付的焦点态是其前置件,只覆盖游戏自有钮)。 +- 九宫格切片错位(氛围层条后半)→ 06 在册;须先核素材尺寸能否撑住新切片值(border_stone 48×48 按 12 切片、panel_stone 48×48 按 16 切片,铺到四百多像素宽面板的拉伸接缝),可能要重出素材=美术线连带面,本批不碰。 +- UI 贴图重构 / 字体补完 / 战斗一屏样张(第二层三件)→ 06 在册,美术线。 +- 第二/三关棋盘观感 → 06 在册,开工前须过「素材轴/UI 轴」定性人闸。 +- 关卡节点图重构 → 06 在册,用户已裁「先文档设计讨论」,不属本批。 + +## 5. 关联文档同步面 + +| 文档 | 关联点 | 同步义务 | +|---|---|---| +| [06-待办清单](../gdd/06-待办清单.md) | ①「UI 按钮状态矩阵缺档」条;②「全局纹理过滤」条;③「呈现层残余 <4.5:1 文字位」条;④「UI 氛围层与九宫格切片」条(仅光柱半);⑤「UI 元素细节修」条(余②③④;②③范围按 §2 诊断订正③④收窄:②仅三选一 BCard、③仅商店+营地) | **机械面,随批**:①②③销号;④改记「九宫格半存续」;⑤销号余项 | +| [08-Alpha版本标准](../gdd/08-Alpha版本标准.md) | 三·界面「UI 按钮状态矩阵」行;五·表现「全局纹理过滤」「UI 氛围层与九宫格切片」「UI 元素细节修」三行 | **机械面,随批**回填(氛围行注明九宫格半未结) | +| [07-体验验证清单](../gdd/07-体验验证清单.md) | 新增目检节(㉕):按钮五态/Nearest 全屏巡检/光带/布局/诊断钮清零 | **机械面,随批**登记(不阻塞) | +| active.md | 批收口快照惯例 | **机械面,随批** | +| roadmap | 迭代行 | 编入时随编入批更新;本卡不动 | +| art-bible §7 | ①按钮五态/焦点态规格无条款(本批实现=临时权威);②平滑渐变件 LINEAR 白名单无例外条款(§8.2 已有状态图标例外先例);③若立新色 token(HERO_BLUE 亮档/GOLD 亮档)§4.1 语义岗登记;④**氛围层风格一致性**——vignette/gradient_base/beams 保平滑 vs DitherBand 抖动派并存(grilling Q5 裁保平滑,不一致性留样张批统一裁决) | **反哺点**(四条列实现报告待用户裁决,另批落文;**设计权威文档,不随批更新**) | + +## 6. 任务卡 + +### T0 基线与枚举复核(≈0.25d) + +1. §2 全部 file:line 开工复核(含四项诊断订正复命)。 +2. 纹理过滤翻转面全枚举:无显式 filter 的 TextureRect/Sprite2D 清单,一式两份(实现报告+卡审留档)。 +3. 按钮消费点枚举:四工厂全部调用方清单(焦点/禁用改动的波及面,含 HUD 顶条紧凑钮豁免域)。 + +### T1 按钮五态矩阵(≈0.5d) + +1. skin 函数改版为五态统一管线,三厂一致(grilling 第一轮已裁值落此): + - **悬停=乙案**:普通钮 hover=常态图+modulate 提亮(档位见代拍板项 1;与 `primary_button` 现行 `CANDLE.lightened(0.06)`(ui_kit.gd:579)同纪律);主钮/危险钮 hover 承现行提亮档不动。 + - **禁用=甲案**:三厂 disabled=本族底+modulate α0.45(与现行 `font_disabled_color` α0.45 同纪律的幽灵化),取代现状「=石纹按压图」错配(§2.1)。 + - **焦点=甲案**:三厂 focus 样式盒=INK 2px 内缩 1px(与现行 `font_focus_color=INK` 同源;三类钮底可辨性实比,不达走 §8 L2 调宽/内缩,不动色系不动主题层)。 + - 危险钮补本族 pressed(深红平涂系深档)+disabled(承上)。 +2. 断言见 §7 V1/V2。 + +### T2 全局纹理过滤(≈0.25d) + +1. `project.godot` 增 `[rendering]` 节 `textures/canvas_textures/default_texture_filter=0`(0=Nearest)。 +2. vignette_rect/gradient_base 补显式 LINEAR(白名单两处);脚影/状态图标既有显式不动;beams 归显式 LINEAR 白名单(Q7 裁,随 T4 实现一并落)。 +3. 断言见 §7 V3。 + +### T3 <4.5:1 文字位换墨(≈0.25d) + +1. standee_body.gd:441 顺位徽标、:494 重甲徽标(GOLD_DEEP)与 :492 魔法护甲徽标(HERO_BLUE)换同族亮档(≥4.5:1 vs STAGE_BG;token 处置见代拍板项 4)。 +2. ap_bar_view.gd:77 STONE_FAINT→STONE_DEEP(既有 token,对 PANEL_DATA 5.6:1,ui_kit.gd:95 在案)。 +3. 断言见 §7 V4。 + +### T4 光柱氛围修(≈0.25d) + +1. beams_rect 带内 alpha 渐变(0→0.05→0 横向过渡)+纵向衰减(上亮下暗);**衰减实现=连续 alpha**(grilling Q7 裁:与 Q5 裁定的氛围保平滑三件(暗角/地图渐变/光柱)同血统;Bayer 抖动案弃——α0.05 极弱件上台阶不可见且与同屏平滑暗角风格跳变);**纹理 filter=显式 LINEAR 白名单**(与 Q5 同一条纪律,入 T2 白名单清单)。 +2. 目检见 §7。 + +### T5 元素细节余②③(≈0.5d) + +1. ②BCard 图标槽(ui_kit.gd:659-663)明度差降档(白图标 ≥3:1 图形对比硬约束;代拍板项 6)。 +2. ③shop_overlay_view.gd:64-67 卡片区垂直居中;camp_overlay_view.gd:106-175 四栏等高(统一 min 高或拉伸;代拍板项 7)。 + +### T5b 诊断转储钮退役(≈0.25d) + +1. main.gd:333-334 卸载点删除;build_diag_button(ui_assembler.gd:219-228)退役,转储入口收口调试浮窗(**grilling Q8 裁甲**:承迭代 18 卡⑦「主菜单三散件收一」纪律;删除案否——`dump_diagnosis` 卡死取证功能保留;门控隐藏案否——debug_overlay 本就可全局可开,双轨无意义);`_on_diagnose_pressed`(main.gd:1288-1299)连接随迁。 +2. 断言见 §7 V6。 + +### T6 文档同步闸与全闸(≈0.25d) + +1. §5 机械面五件更新完毕+反哺点四条列明。 +2. 07 登记目检节。 +3. 批末四闸全绿合并。 +4. **渲染闸 golden 面处置**(grilling 补入 2026-10-14):跑 `tools/render_gate.sh`;board golden(L1-L3)若红——核对热区**限于站桩徽标换墨面**(§2.6 已证的唯一预期变更区)→ 显式重制三张基线(视觉换代批既定动作:golden_compare.py 头注「资产升档批换代时显式重制基准」;重制=变更面随批呈报)→ 复闸;**热区超预期面 → §8 L3 停机呈报**。若闸直接绿(徽标占比未越 2% 线)=登记即结。 + +**估时合计 ≈2–2.5d**(T6 含 golden 重制一次)。切分预案:T1 焦点视觉若在三类钮底可辨性上反复(超 0.5d 软盒),先落石纹钮+危险钮两处焦点,主钮焦点随 L2 记录继续;T5b 若调试浮窗挂载面比预期深,诊断钮先隐藏(visible=false)且转储入口落浮窗,不阻塞合并。 + +## 7. 验证闸(逐需求点验收清单) + +**能力验证(自动化;谁验=批末四闸闸机,全绿才合并)**——冒烟新增/改写断言: + +- V1 按钮五态覆盖:四工厂产物逐只断言 normal/hover/pressed/disabled/focus 样式盒非空;**hover≠normal**(乙案判据=hover 样式盒 modulate_color ≠ 常态的 WHITE);危险钮 pressed/disabled 为非石纹本族;**disabled≠pressed**(错配修正判据)。 +- V2 主题红线维持:Button 类型词条零接触+focus 族词条零定义(smoke_all.gd:5376-5385 原样绿)。 +- V3 纹理过滤:`ProjectSettings` 读 `default_texture_filter==0`;vignette/gradient_base 显式 LINEAR 断言(白名单两处在位);脚影/状态图标 LINEAR 不丢。 +- V4 对比度锚定:换墨后三处 vs 各自底色 ≥4.5:1(复用 smoke_all.gd:29-37 helper;色值冻结断言);RAP 行 vs PANEL_DATA ≥4.5:1。 +- V5 回归:冒烟全绿(基线 987/0,开工日复核)。 +- V6 诊断钮退役:main.gd 无 build_diag_button 调用残留;转储入口在 debug_overlay 可达(探针或源码断言二选一)。 +- V7 改前改后读数对拍:本批零游戏逻辑改动——对拍面=冒烟全量+探针结构断言零漂移(渲染设置不影响逻辑读数)+**渲染闸 golden 面按 T6 第 4 步处置**(预期内变更=重制基线+呈报;超预期=L3)。 + +**测试方式两分法**:V1-V6 归能力验证(调试接口/自动化闸);观感类(悬停反馈手感/焦点环可见性/光带过渡/布局均衡/Nearest 后全屏无劣化)归正常流程体验=用户目检,登记 07 不阻塞。 + +**正常流程体验(用户目检;谁验=用户自排)**:标题屏/营地/商店/设置/三选一逐屏——鼠标悬停/按下/禁用(余额不足钮)反馈可感;Tab 遍历焦点环可见不糊;全局 Nearest 后立绘/瓦片/图标/九宫格无新增糊感、暗角与地图渐变无像素块(白名单生效判据);光带无硬边梯形;商店卡片区不堆上半;营地四栏视觉等高;玩家画面无「诊断转储」钮。 + +## 8. 异常分级 + +- L1(自救):样式盒/词条名拼错、filter 值写错、色值算错——断言立红即修。 +- L2(记录继续):焦点环观感、光带衰减手感、图标槽明度、布局等感官微调——登记 07,随批内迭代或后批微调。 +- L3(停机呈报):触碰 §3 任一红线;全局 Nearest 后出现 §2 枚举外的存量观感意外劣化(漏枚举);主题层误触;**渲染闸 golden 热区超站桩徽标预期面**(T6 第 4 步)。 + +## 9. 代拍板白名单(超清单必呈报) + +1. hover 乙案提亮档位(modulate 值;硬约束=INK 字对比 ≥4.5:1;参考主钮现行 `lightened(0.06)` 量级)。 +2. 禁用态 α 值(基准 0.45,与文字禁用同档;目检可微)。 +3. 焦点环最终参数(INK 2px 内缩 1px 为裁值;三类钮底实比不达可调宽/内缩,不动色系、不动主题层)。 +4. 换墨具体值与 token 处置(Q6 裁换墨后定:同族亮档优先既有亮族 token;语义岗冲撞则立新 token 并登记反哺点③;机检锚定 ≥4.5:1)。 +5. 连续 alpha 的渐变曲线参数(过渡带宽度/纵向衰减梯度;目检可微)。 +6. BCard 图标槽明度档(白图标 ≥3:1 硬约束;不达回退「去槽底+图标深描边」案)。 +7. ③布局修具体值(商店 _cards_box 居中方式;营地四栏等高=统一 min 高 or EXPAND_FILL 拉伸)。 +8. 诊断钮在 debug_overlay 内的落点(行位/显隐形态;方向已裁=移入浮窗)。 + +## 10. 待裁点 + +**零待裁点,卡片成立**(2026-10-14 grilling 两轮八裁全落,用户令「按推荐」): +- 第一轮:①范围=六项捆一批;②悬停态=乙案 modulate 提亮;③焦点环=INK 2px 内缩 1px+引擎控件焦点不碰(归 Beta 键盘批裁决点③);④禁用态=本族底+α0.45 幽灵化;⑤氛围平滑件=保平滑挂 LINEAR 白名单(不一致性=反哺点④)。 +- 第二轮:⑥<4.5:1=换墨(站桩两处同族亮档 ≥4.5:1;RAP 行 STONE_DEEP);⑦光柱=连续 alpha 渐变(filter 归 LINEAR 白名单);⑧诊断钮=移入调试浮窗(dump_diagnosis 保留)。 + +**开工门=U0**(已编入迭代 26〔2026-10-14 用户令〕——用户新会话 /iter 26 四检发令)。收口=§5 同步闸+06 销号+反哺点四条呈裁。 diff --git a/roadmap.md b/roadmap.md index f268e0da..ac82bad7 100644 --- a/roadmap.md +++ b/roadmap.md @@ -21,11 +21,11 @@ | 2026-09-28 | **M-2 关卡画面独立化完成(迭代 3+4 已入库,出口闸目检通过)**:独立屏 LevelMapScreen+独立性断言(状态记录 224)/关卡画面样张 v1 机检 11/11 冻结+节点图标组接线+终稿落码+换层挂点(art-bible v2.14,状态记录 225);出口检查单 `design/qa/m2-exit-gate-checklist-2026-09-28.md` 用户八项目检通过(状态记录 227) | | 2026-09-29 | **迭代重排(用户裁决「内容逻辑闭环先于验收」)**:M-3 更名「数值标定与 Alpha 创建」——战斗演出完善前移迭代 6、魔法道具+元进度标定编入迭代 7、Alpha 验收后移迭代 8;M-4 转 Alpha 后深化与内容扩展(本批,状态记录 242) | -## 当前位置(2026-10-11 刷新) +## 当前位置(2026-10-14 刷新) - **里程碑语义(2026-10-09 立规换代,详见下方里程碑表的换代注)**:现行里程碑 = **M3「Alpha 版本的完整实现」**——用户未明令宣布完成前停留 M3,迭代只排 M3 需求;M4=Beta 版本的完整实现,一律不排期。下文里程碑表的旧编号(M-3/M-4)保留作历史序列,语义以本节为准。 -- **迭代进度**:迭代 19 五卡全部已入库(2026-10-08);**迭代 20=专长实装批 ✅ 已入库**(2026-10-11,出口闸全绿;残留人闸=实机目检五件+V20/V21/V22 人工核对半,07 在册);**迭代 21=天赋树实装批 ✅ 已入库(2026-10-12 U0 开工单会话交付,T0-T7 全绿;残留人闸=实机目检四柜台)**;**迭代 22=秘宝体系实现重构落地批 ✅ 已入库(2026-10-12 单会话交付,T1-T7 全绿;残留人闸=实机目检秘宝解锁-装配流程)**;**迭代 23=锻造工坊实装批 ✅ 已入库(2026-10-12 单会话交付,T0-T7 全绿;残留人闸=实机目检工作间形态与购买交互)**;**迭代 24=敌人表内容修批(三关)✅ 已入库(2026-10-13 /goal+iter U0 开工单会话交付——N1 (1,2) 降档 hp22/ac2·N2 毒吐盾击两行六池·N3 敌方 attack_type 轴全填 normal+敌方结算克制消费点;冒烟 949/0+run_all 25 套+重闸全绿+MC 同种子配对 40 局×both 位移在带;实现报告=design/qa/iter24-实现报告-2026-10-13.md;残留人闸=实机目检三观测〔07 ㉓〕;代拍板追认单+GDD 反哺点五条待用户;**本迭代位仍预留后续追加卡——用户将把其他需求陆续编入本迭代**);;**迭代 25=UI 全局主题批 ✅ 已入库**(2026-10-13 用户令编入,/goal+iter U0 单会话交付:全局主题资源 main_theme.tres 挂载+两处局部做法退役+冒烟 V1-V6 断言 38 条,冒烟 987/0+重闸全绿;实现报告=design/qa/iter25-实现报告-2026-10-13.md;残留人闸=实机目检全屏巡检〔07 ㉔〕);**迭代 26+**=M4 数值批(Beta 位·未排期——用户令 2026-10-07:后续新迭代一律不先做 M4;迭代 24 与 25 占位后本批顺延)。 -- **近期主战场**:迭代 20/21/22/23 残留人闸(实机目检四批:专长五件+营地四柜台+秘宝解锁装配+锻造工作间,07 在册);**下一前沿=M4 数值批,待 U0 发令**(锻造工坊批 provisional 数值终值归其统一标定)。 +- **迭代进度**:迭代 19 五卡全部已入库(2026-10-08);**迭代 20=专长实装批 ✅ 已入库**(2026-10-11,出口闸全绿;残留人闸=实机目检五件+V20/V21/V22 人工核对半,07 在册);**迭代 21=天赋树实装批 ✅ 已入库(2026-10-12 U0 开工单会话交付,T0-T7 全绿;残留人闸=实机目检四柜台)**;**迭代 22=秘宝体系实现重构落地批 ✅ 已入库(2026-10-12 单会话交付,T1-T7 全绿;残留人闸=实机目检秘宝解锁-装配流程)**;**迭代 23=锻造工坊实装批 ✅ 已入库(2026-10-12 单会话交付,T0-T7 全绿;残留人闸=实机目检工作间形态与购买交互)**;**迭代 24=敌人表内容修批(三关)✅ 已入库(2026-10-13 /goal+iter U0 开工单会话交付——N1 (1,2) 降档 hp22/ac2·N2 毒吐盾击两行六池·N3 敌方 attack_type 轴全填 normal+敌方结算克制消费点;冒烟 949/0+run_all 25 套+重闸全绿+MC 同种子配对 40 局×both 位移在带;实现报告=design/qa/iter24-实现报告-2026-10-13.md;残留人闸=实机目检三观测〔07 ㉓〕;代拍板追认单+GDD 反哺点五条待用户;**本迭代位仍预留后续追加卡——用户将把其他需求陆续编入本迭代**);;**迭代 25=UI 全局主题批 ✅ 已入库**(2026-10-13 用户令编入,/goal+iter U0 单会话交付:全局主题资源 main_theme.tres 挂载+两处局部做法退役+冒烟 V1-V6 断言 38 条,冒烟 987/0+重闸全绿;实现报告=design/qa/iter25-实现报告-2026-10-13.md;残留人闸=实机目检全屏巡检〔07 ㉔〕);**迭代 26=UI 交互与观感批已编入待开工**(2026-10-14 用户令;需求卡片 v1.2 零待裁点;开工门=U0——用户新会话 /iter 26 发令;本迭代位预留后续追加卡,同迭代 24 先例);**迭代 27+**=M4 数值批(Beta 位·未排期——用户令 2026-10-07:后续新迭代一律不先做 M4;迭代 24/25/26 占位后本批顺延)。 +- **近期主战场**:迭代 20/21/22/23 残留人闸(实机目检四批:专长五件+营地四柜台+秘宝解锁装配+锻造工作间,07 在册);**下一前沿=迭代 26 UI 交互与观感批,待 U0 发令**(需求卡片 v1.2 已成立;M4 数值批殿后顺延 27+,各批 provisional 终值归其统一标定)。 - **实时状态**:以根目录 [active.md](active.md) 顶部「当前状态快照」节为准(`stage.txt` 已定性为旧阶段开关,仅存档)。 ## 主线路线(里程碑 × 迭代序列) @@ -82,7 +82,8 @@ | 迭代 23 | **锻造工坊实装批(2026-10-12 用户令编入——设计面 v0.6 就绪)**:按 [锻造工坊](design/gdd/systems/跨局循环/锻造工坊.md) **v0.6** 设计权威文档实装——迁移面:①新建锻造路线行族(现役 `meta.tres` forge_products 已随迭代 21 T5 退役、无改造对象;钥石定价历史考古 20/150%、投值归 M4)②两根类型轴所有权移交(默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档域+冒险开始参数面注入)③存档域 forge_routes(已预登记存档序列化.md v7 计划行)④满级特效本期不实装(只留扩展位)⑤敌方 attack_type 填值归敌人系统/战斗结算侧(非本批——敌方定义数据、与名字血量同时读写、无独立时序)⑥术语登记(v0.6 已做完:术语表+registry)⑦数值验证义务=改前/改后同种子配对读数。解锁通道=并联双通道;一次冒险=一武器类型+一甲型。**✅ 已全批入库(2026-10-12,/goal+iter U0 开工单会话交付——worktree g-plan2-iter23-forge 七提交;T1 行族+T2 两轴移交+T3 写口族+T5 存档 v7(序调先行)+T4 注入链+T6 工作间 UI+T7 收口;冒烟 938/0+run_all 24 套+probe click/full+render_gate+doc 三闸/熵增对基线零新增+MC 同种子配对零漂移;实现报告=design/qa/iter23-实现报告-2026-10-12.md;残留人闸=实机目检工作间形态与购买交互〔07 在册〕;代拍板追认单+GDD 反哺点待用户)** | ✅ 已入库(出口闸全绿+实机目检归用户 07 在册) | 估时随需求卡片立项(实际单会话) | | 迭代 24 | **①敌人表内容修批(三关)(2026-10-13 用户令编入;**本迭代位预留后续追加卡**——用户将把其他需求陆续编入本迭代)**:需求卡片=`design/research/需求卡片-敌人表内容修批-2026-10-13.md`(**v1.1**——grilling 复核九问 Q1-Q9 已全裁、零待裁点、开工门=U0)。三件事合一:**N1** 第一关 (1,2) 降档(`enemy.tres:48` 改两值:`hp` 50→22、`armor_class` 3→2;**敌种 `bugbear` 不动**——`enemy.tres:594-600` 注释载明该行 50 血系 2026-09-24 用户裁决的设计而非填错,且 `hobgoblin` 无立绘,故「改敌种」案已否决;本批定性=阶名化解方案实机未达预期按 2026-10-13 体验反馈重裁)· **N2** 第二/三关普通敌技能投放(`skills.tres` 12→14 行:新增 `venom_spit` 毒吐 damage 1.6/CD2 挂 (2,5)/(2,6)/(2,7) 巨蜘蛛族、`shield_bash` 盾击 damage 1.7/CD3 挂 (3,0)/(3,5)/(3,7) 灰矮人族;**首遇教学位 (2,4) 池不动**,venom_spit 自 (2,5) 起投;两新行均不带 `rider_mult`——低 atk 下恒被 `damage_floor` 兜成 1 与 0.75 档等效)· **N3** 敌方 `attack_type` 加列并全填 `normal`(挂**敌种行**、20 行同值,不做差异化;`enemy_table.gd` 加枚举校验 + `unit_container.gd:119` 加单位快照 + `battle_orchestrator.gd:1406` 第 9 参由 `""` 改传值;全局平移=穿重甲受伤 −1 / 魔法护甲 +1 / 轻甲 0,使锻造甲路线首次具备战斗意义)。**契约要点**:池与敌种键属**契约级**,改必同步 `smoke_all.gd:3211` `expect_pools`(N1 因键值不变零改动、N2 同步 6 键);节点图拓扑零触碰(A1 关卡节点图重构的地盘);(1,1) 地精一伙不在本批范围(「第二个节点」字面偏差已登记 06)。**收口去向**:06「第一关遭遇表数值异常」「第二关技能池与投放」与锻造工坊条迁移面⑥ 三条一并销号;08「二·内容量」敌种池行注摘除 | ✅ 已入库(2026-10-13 单会话交付,出口闸全绿:冒烟 949/0+run_all 25 套〔485 批基线漂移 24→25 在案〕+探针 click/full+render_gate golden 0.00%+doc 三闸/熵增对基线零新增+MC 配对三组读数;实现报告=design/qa/iter24-实现报告-2026-10-13.md;残留人闸=实机目检三观测 07 ㉓) | | 迭代 25 | **①UI 全局主题批(引擎原生控件接管皮肤)(2026-10-13 用户令编入;UI 美化三层诊断 · 第一层第一条)**:**✅ 已全批入库(2026-10-13 /goal+iter U0 开工单会话交付,worktree g-plan2-iter25-theme 分支 iter25-theme-20261013)**——**T0 主题资源**:新建 `game/assets/theme/main_theme.tres` 挂 `project.godot` `gui/theme/custom`(15 类型全覆盖:V/HScrollBar·ScrollContainer·H/VSlider·TooltipPanel/Label·LineEdit·SpinBox·H/VSeparator + 预盖 CheckBox/CheckButton/OptionButton/PopupMenu 弹层;`default_font` 显式指向现役同字体文件=V6 中文字形防御;位图由 `tools/gen_theme_icons.py` 一次性生成落 `game/assets/art/ui/gen/`,色值溯源表落 `game/assets/theme/README.md`)· **T1 换代退役**:`ui_kit.gd` 的 `tooltip_theme()`/`_tip_theme` 与 `styled_slider()` 样式段、`ui_assembler.gd` 挂载行同批删除(禁新旧并存),settings_overlay 几何内联+debug_overlay `_slider_row` 双轨消隐· **T2 断言与文档同步闸**:冒烟新增 V1-V6 主题词条断言 38 条。**顺手销号**=06 第三层「UI 元素细节修」之①(音量滑轨两段对比度重配=已填充段 BG_ROOT #3A2E22 对暖石 #B8A582 实测 5.49:1)。**契约遵守**:🔴 Button 类型词条零接触(冒烟断言在闸)· 🔴 focus 族词条零定义(全主题扫描断言)· 🔴 零新增美术素材(位图=脚本生成纯色/几何)· 🔴 全局纹理过滤未动。**引擎事实订正(呈报追认)**:Godot 4.7.2 源码+默认主题链双查实证——①CheckButton 图标词条名与 CheckBox 同套 `checked`/`unchecked`(卡片 v1.2 注③「CheckButton 用 on/off」不成立,按引擎事实落位)②Slider 无 `grabber_pressed` 图标槽(冻结表「柄·按」值 GOLD_DEEP 留档未落位)③ScrollBar 柄是 StyleBox 非 Icon(无需位图)④4.7 导入参数已无逐贴图 filter 标志(位图原生尺寸消费无滤波伪影)。**闸**:冒烟 987/0(基线 949+本批 38 断言)+run_all 25 套+probe click/full+render_gate golden 0.00%+doc 三闸/熵增对基线零新增;MC 零跑(零数值零行为=纯呈现)。**收口去向**:06「UI 全局主题资源缺失」条移除+「UI 元素细节修」①销号;08 升 v1.3(三·界面主题行→在役、五·表现细节修行注①销号);07 ㉔ 全屏巡检登记;实现报告=design/qa/iter25-实现报告-2026-10-13.md。**待用户**:实机目检全屏巡检+专项观察点二(07 ㉔,登记不阻塞)+代拍板追认单(位图不入 git 政策口径/CheckButton 词条名订正等)+GDD 反哺点(组件规格是否立条款入 art-bible §7 等)。↓ 原任务登记:三件事合一——**T0** 新建 `game/assets/theme/main_theme.tres` 并挂 `project.godot` 的 `gui/theme/custom`,覆盖滚动条 / 滑轨 / 悬停气泡 / 输入件 / 分隔线等引擎原生控件,并预盖 CheckBox / CheckButton / OptionButton 及其弹层 PopupMenu(须在新主题内显式设 `default_font`=现役同一字体文件;新增小位图落 `game/assets/art/ui/gen/`,色值溯源表落 `game/assets/theme/README.md`)· **T1** 退役 `ui_kit.gd` 的 `tooltip_theme()` 与 `styled_slider()` 两处局部做法、消 `debug_overlay._slider_row` 双轨(🔴 旧实现同批删除)· **T2** 断言与文档同步闸。契约要点:🔴 Button 类型词条零接触 · 🔴 focus 族词条零定义 · 🔴 不新增美术素材、不改美术圣经 §7 · 🔴 全局纹理过滤不动 | ✅ 已入库(出口闸全绿+实机目检归用户 07 ㉔ 在册) | T0-T2≈0.5–1d(实际单会话) | -| 迭代 26+ | **M4 数值批(**原 22+;迭代 21 已编入天赋树实装批、迭代 22 已编入秘宝实装批(均 2026-10-11 用户令)、迭代 23 已编入锻造工坊实装批(2026-10-12 用户令)**;迭代 24 已由用户令编入敌人表内容修批、迭代 25 已由用户令编入 UI 全局主题批(2026-10-13),本批顺延 26+**——**Alpha 收官位·未排期**〔2026-10-09 语义换代:M4=Beta 阶段、非 Alpha 收官位,M3 未由用户明令关闭前不排期维持〕——2026-10-05 用户令编入迭代 17 卡②;2026-10-06 用户令移出独立成批并定序「Alpha 阶段最后——内容补全先行、统一数值调整殿后」〔当日曾被编入迭代 18 为收官卡,2026-10-07 用户令撤回〕;**2026-10-07 用户令二次后移:后续新迭代(迭代 20 起)一律不先做 M4,除非用户明确要求启动 M4 批次**)**:四件数值欠账合一批——①削弱档位终值(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`(**v1.2 2026-10-06 案C 增补+联审修订**:v1.1 三事实与第五推算件照旧;联审=P3 转正顺延至重扫读数后/检算工具 WEAKEN_PCT 入同步面/F11 两句死文本全刷/T3·T5 四带复算并账一次跑批双认账/R5 改前锚=本批新立案C 锚/估时段一勘误 4.25d;案C 增补内容照旧=§2.6 三事实〔行为换代/锚全作废/难度预判〕+T0 推算稿第五件=对拍锚按新序重推导+T6 四带复算按案C 新行为首采;T0-T8≈6.25d,天然切分点 T4 末;🔴 契约 5 条含跑批批准制;**✅ 裁点全裁(2026-10-06 用户令:P1甲=维持 2 场·magnitude [60,85] 带内当量锚复算、具体值随出口 provisional 追认/P2甲 不对称有意/P3甲 3-3-3·2-2-3 维持、转正顺延至重扫读数到账且带内(Q4 二裁)/P4甲 不立直购价);开工=U0**) | 迭代 18 全部内容卡(③④⑤⑦)出口+全部内容批行为变更落定+**用户发令(未排期)**——重锚窗口须收尽全部内容批行为变更 | T0-T8≈6.25d(超软盒预挂,段一 T0-T4≈4.25d〔v1.2 勘误,原 4.5 系加总错误〕/段二 T5-T8≈2.0d) | +| 迭代 26 | **①UI 交互与观感批(2026-10-14 用户令编入;UI 美化三层诊断 · 第一层第二/三条+第三层四件;本迭代位预留后续追加卡,同迭代 24 先例)**:需求卡片=`design/research/需求卡片-UI交互与观感批-2026-10-13.md`(**v1.2**——grilling 两轮八裁全落、零待裁点、卡片成立)。六项:**T1 按钮五态矩阵**(悬停=乙案 modulate 提亮〔与 primary_button 现行 `CANDLE.lightened(0.06)` 同纪律〕/禁用=本族底+α0.45 幽灵化/焦点=INK 2px 内缩 1px/危险钮补本族 pressed;走逐实例 override,迭代 25 两条主题红线断言维持不换代)· **T2 全局纹理过滤**(`project.godot` `default_texture_filter=0`+vignette/gradient_base/beams 显式 LINEAR 白名单+翻转面全枚举)· **T3 <4.5:1 换墨**(站桩顺位/护甲徽标换同族亮档+RAP 行 STONE_DEEP,机检断言锚定)· **T4 光柱连续 alpha 渐变**(0→0.05→0 横向+纵向衰减)· **T5 元素细节余②③**(BCard 图标槽明度差降档/商店卡片区垂直居中/营地四栏等高)· **T5b 诊断转储钮移调试浮窗**(`dump_diagnosis` 功能保留)。🔴 契约 5 条(主题层零新增词条/零新美术素材/棋盘零触碰/对比度 ≥4.5:1/旧实现同批清理);验证闸 V1-V7;代拍板白名单八项;反哺点四条;**渲染闸 golden 面处置**=T6 第 4 步(徽标换墨落 board golden 裁剪区:闸红→核热区限预期面→显式重制基线+呈报→复闸,超预期=L3)。**范围订正**(grilling 实查,iter25 滑轨条同款先例):②垫块仅三选一 BCard(商店卡实为纯文字行卡)/③仅商店+营地(三选一已居中)/危险钮「无按下态」订正为「在但皮肤错配」。估时 T0-T6≈2–2.5d | **已编入待开工**(2026-10-14 用户令;开工门=U0——用户新会话 /iter 26 四检发令) | T0-T6≈2–2.5d | +| 迭代 27+ | **M4 数值批(**原 22+;迭代 21 已编入天赋树实装批、迭代 22 已编入秘宝实装批(均 2026-10-11 用户令)、迭代 23 已编入锻造工坊实装批(2026-10-12 用户令)**;迭代 24 已由用户令编入敌人表内容修批、迭代 25 已由用户令编入 UI 全局主题批(2026-10-13)、迭代 26 已由用户令编入 UI 交互与观感批(2026-10-14),本批顺延 27+**——**Alpha 收官位·未排期**〔2026-10-09 语义换代:M4=Beta 阶段、非 Alpha 收官位,M3 未由用户明令关闭前不排期维持〕——2026-10-05 用户令编入迭代 17 卡②;2026-10-06 用户令移出独立成批并定序「Alpha 阶段最后——内容补全先行、统一数值调整殿后」〔当日曾被编入迭代 18 为收官卡,2026-10-07 用户令撤回〕;**2026-10-07 用户令二次后移:后续新迭代(迭代 20 起)一律不先做 M4,除非用户明确要求启动 M4 批次**)**:四件数值欠账合一批——①削弱档位终值(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`(**v1.2 2026-10-06 案C 增补+联审修订**:v1.1 三事实与第五推算件照旧;联审=P3 转正顺延至重扫读数后/检算工具 WEAKEN_PCT 入同步面/F11 两句死文本全刷/T3·T5 四带复算并账一次跑批双认账/R5 改前锚=本批新立案C 锚/估时段一勘误 4.25d;案C 增补内容照旧=§2.6 三事实〔行为换代/锚全作废/难度预判〕+T0 推算稿第五件=对拍锚按新序重推导+T6 四带复算按案C 新行为首采;T0-T8≈6.25d,天然切分点 T4 末;🔴 契约 5 条含跑批批准制;**✅ 裁点全裁(2026-10-06 用户令:P1甲=维持 2 场·magnitude [60,85] 带内当量锚复算、具体值随出口 provisional 追认/P2甲 不对称有意/P3甲 3-3-3·2-2-3 维持、转正顺延至重扫读数到账且带内(Q4 二裁)/P4甲 不立直购价);开工=U0**) | 迭代 18 全部内容卡(③④⑤⑦)出口+全部内容批行为变更落定+**用户发令(未排期)**——重锚窗口须收尽全部内容批行为变更 | T0-T8≈6.25d(超软盒预挂,段一 T0-T4≈4.25d〔v1.2 勘误,原 4.5 系加总错误〕/段二 T5-T8≈2.0d) | ## 执行纪律(2026-09-27 用户立规)