DKChan
03c4b4c933
一、里程碑语义立规：M3=Alpha 完整实现/M4=Beta 完整实现，未明令关闭 M3 前只排 M3 需求（roadmap M-4 节头立规注+M-3 节头口径指针+迭代 21+ 行注+06 倍率差条注）；迭代 20/21/22 规划冻结（roadmap 迭代 20 行注——先解决眼前问题，重启=用户直接发令） 二、文档正确性审查批三波：全 GDD 29 份过审——状态记录按代码证据订正/里程碑删前缀（M-x+迭代N→迭代N，裸 M-4→Beta 阶段（未排期））/退役词退役件当现役清零/在役旧实现节加隔离横幅；重件=秘宝.md v1.7 老正文深层清算（横幅重写消「过渡形态已退役」误读/沿革节换代/六件旧件登记摘除/验收与 charges 矛盾订正）+奇物 v3.8+冒险结构 v0.18+关卡节点地图 v1.7+图生成 v0.7+难度曲线与Boss v0.26+战斗结算 v0.27+敌人系统 v0.16+地图战斗资源 v0.21+增益状态 v0.13+战斗表现 v0.6+元进度 v1.9+生涯 v0.3+00 v1.3+02 v1.16+03 v1.1+ux 八份（battle 23 处/camp/shop/node-reward/level-clear/interaction-patterns/settlement-summary/level-map） 三、去毒批：奇物 v3.7（魔法道具→秘宝/档名三档→四级/门票与刷新「尚未入表」假话订正/验收第 3 条改令牌口径/资源成员指路凭证件表）+秘宝 v1.6（速览旧目录退役标注/退役件示例换现役） 四、道具退役素材库新建（design/research/道具退役素材库.md，案乙已追认）：秘宝退役 9 件含去向+专长退役 27 件名单+待核 4 行；魔法提灯（fog_lantern）裁退役（06 条目已裁+秘宝.md 注记换代+素材库迁表一；拆线归实装批） 五、B2/B3/B4 裁决落文：元进度.md 道具工坊行删旧写新（v1.10——旧六行登记作废、指路秘宝新目录+解锁门槛谓词分级）；奇物.md P1「两项合成高阶项」注销（v3.9——用户定性脏信息）；§3 刷新句按最新口径换代（刷新券替代、不进持有集） 六、天赋树独立成文（B1 裁决）：新建 design/gdd/systems/跨局循环/天赋树.md v0.1（33 节点机制全按 meta_tree.tres 实态+迭代 12 落籍裁决+被删底稿 git 取证——脊柱行门槛/钥石单币/Fork A/B 面/存档 v5 域/注入双通道）+元进度.md 定名节换代（v1.11）+02-系统清单跨局循环区加行（v1.17） 七、A 类卫生包：版本历史表理排四份（秘宝/奇物含 v2.7 断裂行修复/敌人系统/图生成，只调行序）+缺号注记三处（增益状态 v0.6 未考/冒险结构 v0.15/关卡节点地图 v1.6=MC-1 批）+node-reward v2.2 双号改 a/b+07 补建版本历史表+06 删「设置与本地化」空节+「文档/结构闸存量欠账」块挪文末「文档与结构」节+「L1 商店编排」两悬空指针改指 GP 换算失衡条+难度曲线两处过期指向核销注记（v0.27）+B5「现役 UI/文案两处自相冲突」登记 06 待办（battle_narrator.gd:160 旧话/hero_info_panel 两段同标「特性」——随后续迭代修） 八、命名统一（用户令「任务书」全库改「需求卡片」）：167 文件约 800 处（design/ 全部文档+roadmap+CLAUDE.md+active.md+entities.yaml+game/ 注释与数据批注）；两文件改名（需求卡片-M4数值批/需求卡片-冒险前资源配比预设批）；残留=自造短语全量清单（黑话证据文档故意跳过） 九、CLAUDE.md：批次工作流标准清单收口段新增第 12 条「文档同步闸」（需求卡片必列关联文档同步面、合并前同步完毕方算收口，原 12/13 顺延）；呈报六问铁规适用范围补立（前序批随批落籍） 十、active.md 快照节+工作日志 414-421（并行会话 416 黑话清扫条目按共享工作日志惯例一并入库）；06 中并行会话「active.md 定性与裁剪」条目未提交，按零吞并纪律留在工作区未入库 零测试（文档批两入口铁规）；主区前序脏件（.gitignore/.zcode/config.json/playnote/project.godot/.zcodeignore/美术审计报告 html 等）未带
7.9 KiB
7.9 KiB
迭代 19 实机目检总清单+代拍板追认单（2026-10-08 总收口批交付）
性质：人闸材料包——实机目检归用户后置执行，不阻塞收口；追认单收集本迭代全部 provisional 投值与代拍板处置，逐项待用户追认或否决。 事实源：五卡+尾裁微批六份出口报告（design/qa/iter19-*-exit-report-2026-10-08.md）+ 台账 397-405。
一、实机目检总清单（按卡分组，勾选即销）
卡⓪ 主菜单开局缺陷修复批
- 主菜单「开新冒险」：带已装同调件/已购 Fork 规则的存档开局，局内同调件生效、树分叉规则生效（修复前真实局三键恒空）
- 主菜单「继续上局」：续玩局同调三键带下传（attunement/Y 刷新池/tree_rules——resume 受理已随尾裁微批闭环）
- 关卡开场行攻/血数值与战斗面板同值；白板局不带「含面板加成」后缀，带永久强化或调试加成局带
卡① 自动化验收补齐批
- render_gate 焦点预算项：七屏样张（shot_checker 机检 A-D 已全过）焦点/可读性人工复核
- 07⑮ 真人半：「秘宝」字样全 UI 面 3 分钟巡检（机器半已随 46db30c 核销，此半明示不销号）
卡② 旧界面呈现断言回补批
- 无专项目检项（纯断言批）；可顺带复核 38 对测点覆盖面的整体观感
卡③ CI 预接线批
- 无本机目检项；首次 push 后人工盯首跑（移交清单在需求卡片 §七）：chickensoft setup 步绿/三段+ui_layout 四探针绿/Linux 字体环境差异预判（contrast 首跑若红属环境非回归）/导入步耗时观察
卡④ 提灯载体道具批
- 营地同调目录现「魔法提灯」（目录十件）
- 装配后棋盘视野迷雾外扩 +2（视野边缘可辨格数实机对比装配前后）；卸下复原
- 存档→续玩循环提灯状态正常
尾裁微批
- 对比度 7 项修复位实机观感（商店行卡名/货架价签/结算 GP 账行/营地铭牌副题·行价格·树分组头·工坊状态——位置详卡②出口报告 V1-V7）
- 续玩局后续关卡 Fork 树规则与新开局行为一致（resume tree_rules 闭环验证）
二、代拍板追认单（provisional/代处置逐项追认）
| # | 事项 | 代行内容 | 追认点 |
|---|---|---|---|
| 1 | 卡④ 行字段六值 | display_name=魔法提灯／desc=灯光区半径+2／id=fog_lantern／slot_cost=1／无稀有度字段／无门槛键（用户 2026-10-08「按推荐」秒答） | 终值确认 |
| 2 | 卡② 存量 7 项修复 | 用户裁甲另立修复批→尾裁微批落地（实测 5.21/9.53/5.21/5.98/6.70/5.21/5.84，全 ≥4.5:1） | 修复值确认 |
| 3 | 卡① golden 基线换代 | S2 波动性越限根因=抓帧时序（入场动画未完），修时序锚后换代基线三连跑 0.00% | 换代追认 |
| 4 | 卡① integration 空壳删除 | 需求卡片 Q8 代拍板白名单项；章程句并入 tests/README | 追认 |
| 5 | 卡① config_fatal_probe 退役 | 与 run_all 致命类单测断言面重复（2026-10-02 还账）；数据配置.md:205 活性指路连带改指；v0.4 历史行死链已入 doc_link_known.txt 登记（历史成文不可动先例） | 追认 |
| 6 | 尾裁微批三件 | 对比度 7 项/resume tree_rules 受理一行+断言/tests.yml 换 chickensoft action——均用户 2026-10-08 裁甲授权 | 落值追认 |
| 7 | ui_layout 入 CI 轻段 | 裁点②用户裁甲；总收口批接线（轻段三探针→四探针） | 接线追认 |
| 8 | 秘宝.md 双裁决调和 | 卡④目录十件 × 道具批归留裁决（在飞 WIP）stash 避让双保留并存，附编辑注「十-三=七 调和归秘宝层实装批」；v1.1 版本行号重复（2026-10-07 生命周期轴 vs 2026-10-08 提灯）提请道具批会话收尾时重编 |
✅ 追认结果（2026-10-08 用户令「如果是经过我授权的，那没有问题，可以按照这些项来做」）：八项全部追认通过落终态——第 1-7 项投值/处置即为终态；第 8 项被后令取代作废（秘宝文档已还原，代码保留）。另：tests.yml 按用户同日裁决「仅用本地流水线、不用远程 CI」就地休眠（§一 卡③ 首跑盯梢项随之永不激活）。
目检注意点汇总（2026-10-08 追认时整理——实机体验时的预期变化与易误判点）
行为变化类（真实局此前从未生效的功能现在生效了）：
- 同调件/Fork 树规则第一次在真实局生效（卡⓪修的主菜单入口缺传——此前真实局三键恒空，只有冒烟夹具喂过值）。带同调件/树规则的存档开局，难度与开局观感可能与以往不同——这是缺陷修复的预期效果，非数值变动。
- 续玩局后续关卡 Fork 规则现在生效（尾裁微批补的 resume 受理）——续玩与新开局行为一致。
- 提灯可拿可用（卡④）：营地同调目录装配「魔法提灯」后视野迷雾外扩 +2，卸下复原；每战装配链重算。未装配时无任何变化，模拟器/MC 画像不受影响。
呈现变化类： 4. 七处文字变色（对比度修复）：商店行卡名/货架价签/结算 GP 行/营地铭牌副题·行价格·树分组头·工坊「已解锁」改用高对比常量——实机看是变清晰了，不是改配色风格。 5. 开场行数值与战斗面板一致（卡⓪②）：白板局不再带「含面板加成」后缀；带永久强化或调试加成才带。
跑闸须知类：
6. render_gate 是窗口化闸——会弹真实 Godot 窗口（七屏截图+取证），headless 环境必红，属护栏非缺陷。
7. 改棋盘视觉素材后 golden 必红——基线换代走 tools/golden_baseline_refresh.sh（素材齐盘态生成，S3 口径），换代原因强制记载提交说明。
8. 新重闸口径自此生效：批末=轻闸+--click+--full+render_gate+run_all+doc 三闸+熵增，周期执行不进每次变更（CLAUDE.md 分级周期口径句）。
9. doc/熵增现存登记红 7 件（06 在册，用户认领并行处理）——跑全套时见到这些红属已知存量，非新破；doc_link_audit 带 --known tools/doc_link_known.txt 跑（数据配置历史行死链已登记）。
10. tests.yml 休眠（用户裁：仅用本地流水线）——本文件零维护零作用，本地验证一切照旧。
三、存量欠账移交（已登记 06，处置不阻塞本收口）
新重闸口径（doc 三闸/熵增）首次全闸套跑翻出的旧债，经 T0 基点 9160942 复测确认非本迭代新增：
- gdd_lint 表格占比 3 件（01 核心 35%/06 待办 0%/07 体验 6%——T0 已 2 件存量；第 3 件疑道具批散文稀释）→ 归文档体检批
- 熵增 design/diagrams 越界（archify 架构图批
00712d5旧债）→ 白名单扩须用户拍板（CLAUDE.md Project Layout+脚本白名单两处） - doc_link 奇物.md:245 双死链（../ux/battle.md、../ux/node-reward.md——b6b43eb 旧债）→ 归奇物域批
- doc_term 06「拔旗」退役术语旗 → 该备选条目自身裁决时顺手处置
四、收口闸数字（2026-10-08 主区实跑）
| 闸 | 结果 |
|---|---|
| run_smoke | 846 项 0 失败（三闸过） |
| probe_gate 默认段 | input/struct(15 根)/contrast(38 对) 全绿 |
| probe_gate --click --full | +click 走查 0 问题+ui_probe/tune/t17_defer/fx 四探针全 PASS，残留 Godot=0 |
| render_gate | shot_checker A-D 全过+fx_shot 7 帧+board_shot L1-L3+golden 0.00%×3（容差 ≤16/≤2%），残留 0 |
| run_all | 18 套件全绿（含 fog_lantern_wiring_test） |
| doc_link_audit --known | 数据配置历史行归"已知"；余 2 件奇物存量（advisory） |
| gdd_lint / 熵增 | 存量红如 §三（已登记 06，非本迭代新增） |