From 1e5df2fd641ed357e01b61e6b3af385c51706541 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Wed, 14 Oct 2026 06:41:44 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E8=BF=AD=E4=BB=A326=E6=94=B6=E5=8F=A3):?= =?UTF-8?q?=20active.md=20=E5=BF=AB=E7=85=A7/491-492=20=E7=8A=B6=E6=80=81?= =?UTF-8?q?=E8=AE=B0=E5=BD=95=EF=BC=88=E4=B8=BB=E5=8C=BA=E4=BE=A7=E5=86=99?= =?UTF-8?q?=E2=80=94=E2=80=94=E6=9C=AC=E6=89=B9=E5=8F=B0=E8=B4=A6=E4=B8=8D?= =?UTF-8?q?=E5=85=A5=E5=88=86=E6=94=AF=E9=81=BF=E5=90=88=E5=B9=B6=E4=BA=92?= =?UTF-8?q?=E6=92=9E=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- active.md | 24 +++++++++++++++--------- 1 file changed, 15 insertions(+), 9 deletions(-) diff --git a/active.md b/active.md index c5aa7eff..12c6fc60 100644 --- a/active.md +++ b/active.md @@ -17,23 +17,25 @@ ## 当前状态快照（收口批先更新本节，再追加状态记录；≤10 行） -- **更新于**：2026-10-13（迭代 25 UI 全局主题批总收口——单会话 /goal+iter U0 交付）。 -- **批末闸全绿**：冒烟 987/0（基线 949+本批 38 断言）+run_all 25 套+probe --click/--full+render_gate golden 0.00%+doc 三闸/熵增对基线零新增；MC 零跑（零数值零行为=纯呈现）。 +- **更新于**：2026-10-14（迭代 26 UI 交互与观感批总收口——单会话 /goal+iter U0 全量交付，合并 c8c3db1）。 +- **批末闸全绿**：冒烟 1055/0（基线 987+本批 68 断言）+run_all 25 套+probe --click/--full+render_gate golden 0.00%（登记即结未重制）+doc 三闸/熵增对基线零新增；MC 零跑（零数值零行为=纯呈现）。 +- **迭代 26 交付**：按钮五态矩阵（悬停 modulate 1.06 提亮/禁用 α0.45 幽灵化/焦点 INK 2px 内缩 1px 环/危险钮本族按压态，逐实例 override 主题层零新增）；全局纹理过滤 Nearest+平滑渐变件三处 LINEAR 白名单；三处 <4.5:1 换墨（GOLD_BRIGHT/HERO_BLUE_BRIGHT/STONE_DEEP，6.47/5.88/5.98:1）；光柱连续 alpha；图标槽柔和档+商店居中+营地四栏等高；诊断转储钮迁调试浮窗；冒烟 +68 断言；06 四条销号/氛围层改记+反哺点新条；08 v1.4；07 ㉕；roadmap 行换代；实现报告=design/qa/iter26-实现报告-2026-10-14.md。 +- **迭代 26 待用户**：实机目检五项（07 ㉕，登记不阻塞）+代拍板追认单十三项（报告 §四）+GDD 反哺点四条（报告 §五/06 新条）。 - **迭代 25 交付**：全局主题 `game/assets/theme/main_theme.tres` 挂 `gui/theme/custom`（15 类型全覆盖+预盖 CheckBox/CheckButton/OptionButton/PopupMenu 弹层+`default_font` 中文字形防御）；`tooltip_theme()`/`styled_slider()` 两处局部做法同批退役（settings_overlay 几何内联+debug_overlay 双轨消隐）；冒烟 V1-V6 断言 38 条；06「UI 全局主题资源缺失」条移除+「UI 元素细节修」①销号；08 v1.3；07 ㉔；roadmap 行换代；实现报告=design/qa/iter25-实现报告-2026-10-13.md。 - **迭代 25 待用户**：实机目检全屏巡检+专项观察点二（07 ㉔，登记不阻塞）+代拍板追认单八项（位图不入 git 政策口径/CheckButton 词条名订正/Slider 无 pressed 槽等=报告 §四）+GDD 反哺点五条（报告 §五）。 -- **现行文档事实源**：秘宝.md v2.9+奇物.md v3.16+天赋树.md v0.10+锻造工坊.md v0.8+元进度.md v1.20+术语表 v1.10+**08-Alpha版本标准 v1.3**。 -- **各批残留人闸不变**：迭代 20 实机目检五件+V20/V21/V22 人工核对半；21 营地四柜台〔07 ⑳〕+22 秘宝解锁装配〔07 ㉑〕+23 锻造工作间〔07 ㉒〕+24 敌人表三观测〔07 ㉓〕+**25 全屏巡检〔07 ㉔〕**。 -- **已裁在册**：M4 数值批顺延迭代 26+ 未排期（各批 provisional 终值归其统一标定）。 -- **界面美化三层已登记**（85e2d2a/08 v1.1）：第一层第一条（全局主题）已交付；余二条（按钮状态矩阵/全局纹理过滤）待立项。 +- **现行文档事实源**：秘宝.md v2.9+奇物.md v3.16+天赋树.md v0.10+锻造工坊.md v0.8+元进度.md v1.20+术语表 v1.10+**08-Alpha版本标准 v1.4**。 +- **各批残留人闸不变**：迭代 20 实机目检五件+V20/V21/V22 人工核对半；21 营地四柜台〔07 ⑳〕+22 秘宝解锁装配〔07 ㉑〕+23 锻造工作间〔07 ㉒〕+24 敌人表三观测〔07 ㉓〕+25 全屏巡检〔07 ㉔〕+**26 逐屏巡检〔07 ㉕〕**。 +- **已裁在册**：M4 数值批顺延迭代 27+ 未排期（各批 provisional 终值归其统一标定）。 +- **界面美化三层已登记**（85e2d2a/08 v1.1）：第一层三条全部交付（全局主题=迭代 25；按钮状态矩阵+全局纹理过滤=迭代 26）；第三层四件已交付（<4.5:1 换墨/光柱半/元素细节余项=迭代 26，氛围层九宫格半存续待素材核对）；余第二层三件（贴图/字体/样张）＋第三层其余（九宫格切片/棋盘观感）待立项。 ## 项目当前位置（2026-10-12 刷新；实时细节以根目录 `roadmap.md` 与 06-待办清单 为准） - **里程碑**：M3=Alpha 版本的完整实现（2026-10-09 立规：用户未明令宣布 M3 完成前停留 M3，迭代只排 M3 需求，M4 一律不排期） -- **迭代**：迭代 19 五卡已入库（2026-10-08）；迭代 20 专长实装批已入库（2026-10-11 总收口）；迭代 21 天赋树实装批已入库（2026-10-12）；迭代 22 秘宝体系实现重构落地批已入库（2026-10-12）；迭代 23 锻造工坊实装批已入库（2026-10-12）；迭代 24 敌人表内容修批已入库（2026-10-13，单会话交付；迭代位预留追加卡）；**迭代 25 UI 全局主题批已入库（2026-10-13，单会话交付）**；M4=迭代 26+ 未排期 -- **近期主战场**：迭代 20/21/22/23/24 五批残留人闸（实机目检：专长五件 / 营地四柜台〔07 ⑳〕/ 秘宝解锁-装配〔07 ㉑〕/ 锻造工坊工作间〔07 ㉒〕/ 敌人表三观测〔07 ㉓〕/ **UI 全屏巡检〔07 ㉔〕**）——各批追认单与反哺点全部出清；**下一前沿=M4 数值批，待 U0 发令** +- **迭代**：迭代 19 五卡已入库（2026-10-08）；迭代 20 专长实装批已入库（2026-10-11 总收口）；迭代 21 天赋树实装批已入库（2026-10-12）；迭代 22 秘宝体系实现重构落地批已入库（2026-10-12）；迭代 23 锻造工坊实装批已入库（2026-10-12）；迭代 24 敌人表内容修批已入库（2026-10-13，单会话交付；迭代位预留追加卡）；**迭代 25 UI 全局主题批已入库（2026-10-13，单会话交付）**；**迭代 26 UI 交互与观感批已入库（2026-10-14，单会话 /goal+iter U0 总收口，合并 c8c3db1；迭代位预留追加卡）**；M4=迭代 27+ 未排期 +- **近期主战场**：迭代 20/21/22/23/24/25/26 七批残留人闸（实机目检：专长五件 / 营地四柜台〔07 ⑳〕/ 秘宝解锁-装配〔07 ㉑〕/ 锻造工坊工作间〔07 ㉒〕/ 敌人表三观测〔07 ㉓〕/ UI 全屏巡检〔07 ㉔〕/ **UI 逐屏巡检〔07 ㉕〕**）——各批追认单与反哺点全部出清；**下一前沿=待用户发令（迭代 26 位仍预留追加卡；M4 数值批殿后顺延 27+）** ## 未决面（进行中/待人闸/待裁点指针；现行事实源登记处=`design/gdd/06-待办清单.md`） - 待用户裁决：美术审计两项 P0（art-bible 死样张指涉+主角像素管线重产；06 在册）；去毒残留词扫否（魔法道具约 30 处/罕见约 18 处，呈报在案）；喂雷流 R5 甲重启条件回落文（一句话件）；「通关 vs 通过第 N 关」全库口径统一 273 处（待裁是否补登记 06）；迭代 20 实机目检五件+V20/V21/V22 人工核对半（07 在册） -- 待发令：M4 数值批（迭代 24+，未排期——锻造工坊 provisional 终值/钥石产出重标/削弱档终值/元进度定价余面归其统一执行） +- 待发令：M4 数值批（迭代 27+，未排期——锻造工坊 provisional 终值/钥石产出重标/削弱档终值/元进度定价余面归其统一执行）；迭代 26 迭代位预留追加卡（同迭代 24 先例，待用户编入） - 进行中：黑话清扫第二波（GDD 正文流程动词族约三千处，随时可派） ## 状态记录（滚动窗口：仅当前迭代；退役规则见 doc-conventions §10） @@ -89,3 +91,7 @@ - **489（2026-10-13，迭代 25 UI 全局主题批开工——/goal+iter U0）**：开工检查全过：需求卡片 v1.2 零待裁点（三范围裁点+三 grilling 裁点+同日审核六点全落文）；验收清单 V1-V6 三要素齐（V1-V6 自动闸机+V6 中文字体防御 v1.2 新增）。自洽扫描事实抽查全符（project.godot 仅 custom_font 无 gui/theme/custom/ui_kit:735 styled_slider 与 :753 tooltip_theme 在役/ui_assembler:105 挂载行/consumers=settings_overlay:59+debug_overlay:277 裸 HSlider 双轨/HSeparator 15 处/tooltip_text 11 文件/theme 目录不存在/art/ui 无滚动条滑轨勾选贴图）；一处事实 drift 记录继续（有利方向）=卡片 §5 称 08-Alpha版本标准 系 git 未跟踪文件，实际已于 5f2ef77（迭代 24 文档批）转正入库——手工搬运条款 moot，worktree 直接可见。定义面四件（roadmap 迭代 25 行/需求卡片/06/08）均已跟踪且干净（迭代 24 收口批 7e0f519d union 解带入），T0 无需新定义入库提交；主区脏件全属他批遗产零碰（.gitignore/.zcode/02/playnote/四 untracked/三 .uid）。基线复读全绿=冒烟 949/0（V5 基线按卡片「开工日实测为准」口径订正为 949/0，卡片记 938/0 系迭代 23 时代数）+run_all 25 套+probe --click 全绿残留 0（ui_input 17 断言/ui_struct/ui_contrast 38 对/click 行为走查问题 0）。worktree g-plan2-iter25-theme（分支 iter25-theme-20261013，基点 5f8acd0）已建，冷检出三件套（art 主区绝对路径拷贝+字体 .import 拷贝+--import 刷导入件）完毕，T0 主题资源起。 - **490（2026-10-13，迭代 25 UI 全局主题批总收口——单会话 /goal+iter U0 全量交付）**：T0-T2 三卡全落（worktree g-plan2-iter25-theme，两提交）。**T0 主题资源**：`game/assets/theme/main_theme.tres`（15 类型=V/HScrollBar·ScrollContainer·H/VSlider·TooltipPanel/Label·LineEdit·SpinBox·H/VSeparator+预盖 CheckBox/CheckButton/OptionButton/PopupMenu）挂 project.godot `gui/theme/custom`；位图生成脚本 `tools/gen_theme_icons.py`（PIL，幂等）产 9 张纯色/几何小位图落 `game/assets/art/ui/gen/`；色值溯源表 `game/assets/theme/README.md`；`default_font` 显式指现役同字体文件（V6 中文字形防御）。**T1 换代退役**：ui_kit.gd 删 `tooltip_theme()`/`_tip_theme` 与 `styled_slider()` 整函数、ui_assembler.gd 删挂载行（旧实现同批删除）；settings_overlay 音量滑轨几何内联（裸 HSlider+200×24）、debug_overlay `_slider_row` 补注释（双轨消隐=两处均走全局主题）。**T2 断言与文档闸**：冒烟新增 `_smoke_global_theme()` 38 断言（V1 类型覆盖+Button/focus 双红线+V2 冻结值锚定+5.49:1+V3 预盖证词+V4 退役零残留+V6 字体防御双断言）；06「UI 全局主题资源缺失」条移除+「UI 元素细节修」①销号；08 v1.3（三·界面主题行→在役+五·表现细节修行注；余五行本批零触碰已逐行核对）；07 ㉔ 全屏巡检登记；roadmap 迭代 25 行换代。**引擎事实三证**（4.7.2 源码+默认主题链双查，探针实证）：①CheckButton 与 CheckBox 同套 checked/unchecked 图标名（卡片 v1.2 注③「on/off」不成立——按引擎事实落位否则预盖静默空转，订正随报告呈报）；②Slider 无 grabber_pressed 图标槽（冻结表「柄·按」GOLD_DEEP 留档未落位）；③ScrollBar 柄=StyleBox 非 Icon（滚动条无位图，increment/decrement 箭头默认主题未定义=无箭头按钮）；另证 4.7 导入参数无逐贴图 filter 标志（位图原生尺寸消费无滤波伪影，全局设置红线未触）。**位图不入 git**：.gitignore:52 `game/assets/art/**`（注释明文「运行时资源本地生成不入库」）——卡片 T0「.import 侧车随批入库」与政策冲突，按政策执行（脚本入库可再生+README 溯源+主区随批拷贝 gen/），例外强制入库与否呈报追认。**闸**：冒烟 987/0（基线 949+38）+run_all 25 套+probe click/full+render_gate golden 0.00%（3 屏）+doc 三闸/熵增对基线零新增（死链 3/词命中 2/lint 3 FAIL 均存量）；MC 零跑（零数值零行为=纯呈现）。**待用户**：实机目检全屏巡检+专项观察点二（07 ㉔）+代拍板追认单八项+GDD 反哺点五条（design/qa/iter25-实现报告-2026-10-13.md §四/§五）。合并=见 git（主区 merge --no-ff；合并后 --import 重刷+gen/ 位图拷贝+全量复跑留痕）。 + +- **491（2026-10-14，迭代 26 UI 交互与观感批开工——/goal+iter U0）**：开工检查全过＋两发现按用户裁诀执行。门=U0（本次会话 /iter 26 发令）；卡片 v1.2 零待裁点（grilling 两轮八裁全落）；V1-V7 验收清单三要素齐（V1-V6 自动闸机＋V7 对拍面）。自洽扫描事实抽查 20+ 处全符（_apply_button_skin hover=常态图/disabled=pressed 错配 ui_kit:541-555；primary/danger 无 focus 盒与 disabled 错配 :575/:591；BCard 图标槽 76×76 :659-663；顺位徽标 GOLD_DEEP standee:441；护甲徽标 ward=HERO_BLUE/heavy=GOLD_DEEP :492/:494；GOLD_DEEP 语义岗 standee:199 意图动画判据；RAP 行 STONE_FAINT ap_bar:77；beams 硬边 :263-277；vignette/gradient 无显式 filter；project.godot 无 default_texture_filter；诊断钮无条件挂载 main:333-334＋_on_diagnose_pressed :1290；冒烟双红线 smoke_all:5377/5385＋对比度 helper :29-37；商店纯文字行/三选一已居中/营地四栏不等高；裸 Button.new() 全库仅 uikit:446）。**发现①**（用户裁按建议改法）：卡片 §2.2 texture_filter 枚举漏登 board_world.gd:50（hero NEAREST），计 12 实测 13——已勘误落卡（NEAREST 10→11），该点与全局 Nearest 同向、零翻转风险、不进白名单。**发现②**（用户知会择机自理）：主区 game/project.godot 编辑器对调脏件（theme 两行换序语义等价）——合并点复检，受阻停机呈报不擅动；另主区 active.md 脏件系编入会话快照遗产，本批 active.md 台账一律走主区侧写、不入分支（避免合并互撞），收口后随批在主区单独落 docs 提交。定义面入库 04ec217（roadmap/06/需求卡片指名三件）。基线复读全绿=冒烟 987/0（与在册一致）＋run_all 25 套＋probe --click 全绿残留 0（ui_input 17 断言/ui_struct/ui_contrast 38 对/click 行为走查问题 0）。**枚举两份**（T0 交付）：①纹理过滤翻转面——显式 filter 13 处（NEAREST 11＝ui_assembler:188/battle_end:60,76/board_fx:150/board_view:310/board_world:50/hero_info:202/level_map:169/standee:222/uikit:234,508,671；LINEAR 2＝board_world:43 脚影/status_slot_row:127 状态图标）；无显式 filter 仅 3 处（ui_kit:253 vignette/:272 beams/:291 gradient_base）＝T2 白名单对象；StyleBoxTexture 九宫格（_tex_sb 产线 button_stone×2/panel_stone/border_stone）＋主题 OptionButton 石纹样式盒（SBTex_btn/SBTex_btnp，非 Button 类型、红线不破）/滑轨抓子/勾选/箭头图标翻 Nearest＝意图面；.tscn 零纹理节点（TextureRect/Sprite2D/TextureProgressBar/NinePatchRect/TextureButton/AnimatedSprite2D/TileMap 全零）。②按钮消费点 49 处（button 43＋verb 1＋primary 4＋danger 1）全经四工厂，T1 覆盖面闭合；禁用态实跑点=shop_overlay_view.gd:117 余额不足禁用。另核：ui_contrast_probe 测点表为静态常量对、不覆盖禁用态（disabled 幽灵化不踩该闸）；主题层 SBTex 两子资源归 OptionButton 名下。worktree g-plan2-iter26-ui（分支 iter26-ui-20261014，基点 04ec217）冷检出三件套（game/.godot 5.8M＋art 931K＋字体 .import）＋--import 刷新 EXIT=0，T1 起。 + +- **492（2026-10-14，迭代 26 UI 交互与观感批总收口——单会话 /goal+iter U0 全量交付）**：T0-T6 八提交全量入库（worktree g-plan2-iter26-ui，分支 iter26-ui-20261014：b6f0c66 T1 五态/9ddb571 T2 Nearest+白名单/7cac0dc T3 换墨/86e9aea T4 光柱/02c87fc T5 细节/260c9bb T5b 诊断钮/900dfe9 T6 文档闸）。**T1**：ui_kit 三厂五态统一管线（hover=常态图+modulate 1.06 提亮〔乙案〕/disabled=本族底+α0.45 幽灵化〔甲案，旧「=按压图」错配修正〕/focus=INK 2px 内缩 1px 环〔甲案，负 expand margin 实现，引擎 focus 叠加绘制不遮钮底〕/危险钮补本族 pressed 深档），逐实例 override 主题层零新增；冒烟 +35 断言。**T2**：project.godot default_texture_filter=0＋vignette/beams/gradient_base 显式 LINEAR 白名单；+6 断言。**T3**：立 GOLD_BRIGHT #E0B860/HERO_BLUE_BRIGHT #7EBAF0 两 token（语义岗冲撞走反哺点③），顺位/重甲/魔法护甲三徽标+RAP 行换墨（6.47/5.88/5.98:1）；+9 断言。**T4**：beams 带内 0→0.05→0 三角过渡+纵向衰减（连续 alpha，Q7 裁）；+3 断言。**T5**：SLOT_BACKDROP_SOFT #806A4E（白图标 5.14:1 ≥3:1）+商店 ALIGNMENT_CENTER+营地四栏等高（三 holder min 336+四面板 FILL+锁文居中）；+8 断言。**T5b**：诊断钮卸载点+build_diag_button 工厂同批删除，转储入口迁调试浮窗（diagnose_requested 信号+区块⑤钮，Q8 裁甲）；ui_tune_probe 只读巡检同批入册（白名单+_emit_diagnose_requested、连接数 10→11）；+7 断言。**闸**：冒烟 987→**1055/0**（+68）+run_all 25 套+probe click/full 全绿+render_gate 全绿（shot_checker A-D 过；golden 三屏 **0.00%**——T6 第4 步登记即结未重制基线；战斗屏 draw_calls 191=基线 270 的附带收益）+doc 三闸/熵增对基线零新增（lint FAIL 集=06/07/术语表基线三件；08 一度因新增表格单元格撞 R3「日期+裁决同括号」正则，改措辞回绿——教训=08 表格单元格注记禁载「日期+关键词」同括号）；MC 零跑。**文档同步面**：06 四条销号/氛围层改记「九宫格半存续」+反哺点四条新条+需求卡片条标已收口；08 v1.4；07 ㉕+v0.9；roadmap 迭代 26 行→已全批入库；实现报告=design/qa/iter26-实现报告-2026-10-14.md（代拍板追认单十三项+GDD 反哺点四条+目检五项）。**合并**：主区 game/project.godot 编辑器对调遗产脏件挡合（发现②预案场景）——用户裁「授权提交该对调」，落 no-op 提交 081ae3b 后 merge --no-ff **c8c3db1**（17 文件 +442/-48）；合并后主区 --import 重刷+冒烟 1055/0+run_all 25 套+probe --click 全绿残留 0。active.md 台账本批全程走主区侧写（不入分支，避合并互撞——编入会话的 active.md 遗产脏件同因）。**待用户**：实机目检五项（07 ㉕）+代拍板追认单十三项+GDD 反哺点四条。