merge: 迭代30卡②③剔除批入库(worktree g-plan2-card23-extract,分支 card23-extract-20261017)——2026-10-17 用户令:卡②战斗一屏样张、卡③二三关棋盘观感剔出迭代 30 移 06 状态「待设计」(设计澄清/美术定稿环节不满足代码实现批开发条件),卡①经质量复查保留零回滚。roadmap 三处+06 新条+active.md 四处与状态记录 513。全量档闸零新增红(回执 commit=a1850777 与分支尖一致)。主区并行未提交件已 stash 避让,合并后即恢复

This commit is contained in:
DKChan committed 2026-10-17 20:32:54 +08:00
commit 6e85f93ef6
3 files changed
+24 -7

No files matched your search

+6 -4
View File
@@ -16,23 +16,23 @@
- **工程路线图**:根目录 `roadmap.md`(里程碑时间线的权威;实时状态看下方快照节)
## 当前状态快照(收口批先更新本节,再追加状态记录;≤10 行)
- **更新于**:2026-10-17(**在途线头收编批已合并**——`art-standee-20261006` 立绘定档批合入+`doc-adr-fixes-20261014` 判废删除,两 worktree 与分支已清(用户令):立绘机检三件工具与 2026-10-07 三处文档修正(溢出甲案×2/参考核验废路径更正)+06 新登「战斗区背景图替换」条落 master,13 件未跟踪立绘抢救至 `artwork/archive/standee-tier-20261007/`(素材不入 git);立绘批引擎实装与人闸两段仍未跑、roadmap 迭代位归属仍待裁。此前同日已合并迭代 30 卡① `7ffd1dc0`、迭代 29 批 `fff4f120`、闸按域分跑批 `60c25ca3`、GDD 反哺写入批 `bd6ab32e`,M4 数值批已废归 06 待裁)。**同日文档批**(`iter30-fb-20261017`):卡①代拍板七项追认通过(用户令「追认没有问题」)、反哺点七条全部回写(06/HUD框架/08/art-bible/roadmap/07 六文件+两份 reports 批注),`--docs` 域闸零新增红。
- **更新于**:2026-10-17(**迭代 30 卡②③剔除批**——用户令:卡②战斗一屏样张、卡③二三关棋盘观感剔出迭代 30 移 06 状态「待设计」,理由=两卡本质是设计澄清/美术定稿环节、无现成素材,不满足代码实现批开发条件;卡①保留零回滚;roadmap 迭代 30 行/迭代进度行/主战场行三处换代+06 新登待设计条;v1.4 原卡片留 `design/research/` 作设计素材;同批清理三 iter30 worktree 与分支。此前同日:线头收编批合并、迭代 30 卡① `7ffd1dc0` 与文档批 `34f3cdb3` 落地、迭代 29 批 `fff4f120`、闸按域分跑批 `60c25ca3`、GDD 反哺写入批 `bd6ab32e`,M4 数值批已废归 06 待裁)。
- **最新闸态**:重闸唯一入口 `tools/run_all_gates.sh` 按改动域分跑(代码域 01 冒烟/02 单元/03-04 探针/05 渲染/09 静态扫描/10 熵增/11 对拍,文档域 06 gdd_lint/07 doc_link/08 doc_term/08b active.md 体量/10 熵增;**域划分只在该脚本定义一处,文档禁止另列闸清单**)。文档域末次回执 commit=分支尖(2026-10-17 线头收编批,见合并说明),零新增红。代码域末次实测读数(2026-10-17 迭代 30 卡①合并态,回执 commit=`7ffd1dc0`):冒烟 1151/0、单元 34 套件(type_glow_test 51 检查)、探针十八断言、渲染 golden 棋盘×3(0.13/0.11/0.10%)与菜单(0.14%)均在容差内、static_scan 相对基线「改善」(基线红→现绿);**11 号闸 parity 是条件闸件,本批判未触面(diff 未触数值/存档/RNG/结算面)SKIP**,迭代 29 批判为触面、须 `PARITY_APPROVED=1` 才发起,MC 未跑。
- **迭代 28 交付**:修好启动时菜单被冒险层盖住的装配顺序,层序收敛为唯一装配合同(散落的两处 `move_child` 删除);boot 链路、九阶段生命周期、启动态菜单 golden 三组验收补全;本批新立硬规则「验收函数无变异红记录不算验收成立」,三处规约落文。
- **迭代 27 交付**:三屏壳场景与局态物化、结算五段拆分、RunLedger 单类持四账、模态编排类、类型闸、死代码退役,编排器由 1725 行降到 1325 行。
- **规约体系现状**:规则文件按领域拆为 7 份、单文件上限 150 行,CLAUDE.md 只留元信息、命令、目录、规范导航与一行一条红线;动手前按规范导航表查对应细则。2026-10-17 增两条硬边界:迭代批(`/iter` 发射的代码实现)对 `design/` 只读、禁止在其中新增/修改/删除任何文件,产出物只准落 `reports/`,批末只跑代码域闸;非迭代批(工具/规则/文档改动)不占 roadmap 迭代号,按改动域跑闸。
- **人闸在册两件**:迭代 27 全流程走查〔07 ㉖〕与迭代 28 启动态菜单〔07 ㉗〕,均登记不阻塞;贫矿脉目检项〔07 ⑪〕已随 2026-10-16 屏蔽令转记失效;迭代 19~26 的目检已于 2026-10-14 全部核销。
- **簿记出清**:迭代 19~26 的代拍板追认单与 GDD 反哺点已全部裁决落文,对应 14 份迭代实现报告按「证据只留最新」删除(git 历史可考)。
- **已裁在册**:M4 数值批已废(2026-10-16 用户删卡令——禁止再以该名义立批/规划/引用已删卡,四项数值欠账归 06 在册、重新归属待裁);**迭代 29=测试分层与门禁语义修正批已合并**(`fff4f120`,十提交);**迭代 30=UI 呈现三卡批·卡①未开格类型徽章批已合并**(`7ffd1dc0`,2026-10-17;卡片 v1.4+开工前预授权 U1 四项已用完;迭代内串行剩 ②战斗一屏样张→③二三关棋盘观感,各须 `/iter` 发令,禁并行);迭代 27/28 位预留追加卡。
- **已裁在册**:M4 数值批已废(2026-10-16 用户删卡令——禁止再以该名义立批/规划/引用已删卡,四项数值欠账归 06 在册、重新归属待裁);**迭代 29=测试分层与门禁语义修正批已合并**(`fff4f120`,十提交);**迭代 30=UI 呈现批·卡①未开格类型徽章批已合并**(`7ffd1dc0`,2026-10-17;卡片 v1.4+开工前预授权 U1 四项已用完);**原卡②③已于 2026-10-17 用户令剔除迭代 30、移 06 状态「待设计」**(前置=设计讨论→需求澄清→美术定稿,禁未定稿直接开工);迭代 27/28 位预留追加卡。
- **界面美化三层**:第一层三件全部交付;余第二层三件(贴图/字体/样张)与第三层其余(九宫格切片/棋盘观感)待立项。
## 未决面(进行中/待人闸/待裁点指针;现行事实源登记处=`design/gdd/06-待办清单.md`)
- 待用户裁决(06 在册):美术审计两项 P0(art-bible 死样张指涉、主角像素管线重产);去毒残留词是否清扫(「魔法道具」约 30 处、「罕见」约 18 处);喂雷流 R5 甲重启条件回落文;「通关」与「通过第 N 关」全库口径统一(约 273 处);**贫矿脉屏蔽的设计语义面反哺五处**(地形变异.md §全局作用域型/HUD 框架三层预告/教学引导手册行/难度曲线与Boss 两行/art-bible §4.6.3 括注——均描述已撤回功能,待裁是否改写,机械面已同步)。
- 待登记 06:需求卡片入库纪律一条(502 批遗留,2026-10-17 在 06 清单内查无该条,属悬空待办)。
- 待用户追认:仅剩 req-card 技能的 WorkBuddy 与 ZCode 两份副本是否取齐一项。迭代 27 代拍板十五项、迭代 28 十三项(含四条白名单外)、迭代 29 十二项、迭代 30 卡① 七项已于 2026-10-17 用户令全部同意(iter30 追认令原文「追认没有问题」)——iter27/28/29 三份实现报告(2026-10-17 文档批已迁位 `reports/`)的追认单节已就地标注追认结果,iter30 卡① 追认单(独立文件)文末已加追认结果行;迭代 29 第四节「经你裁决的四项」不在追认范围(当时已问过已答)。
- 待发令:**迭代 30 UI 呈现三卡批·卡②战斗一屏样张批与卡③二三关棋盘观感批**(卡①已合并 `7ffd1dc0`;②③卡片=`design/research/需求卡片-战斗一屏样张批-2026-10-16.md`/`design/research/需求卡片-二三关棋盘观感批-2026-10-16.md`,v1.2 零待裁残留,②不适用卡①的 U1 预授权并留分类结论注,③有 Q2 判据自动裁/目标带批内自定/L3 分类预授权;两批合计 ≈7.5–10.5d,逐个 `/iter` 发令);迭代 27/28 预留追加卡;黑话清扫第二波(GDD 正文流程动词族约三千处);规则文件编写 skill(按规则文件审计与目录划分批的工作流提炼,见提交 `81c0ee2b`)。
- 待发令:迭代 27/28 预留追加卡;黑话清扫第二波(GDD 正文流程动词族约三千处);规则文件编写 skill(按规则文件审计与目录划分批的工作流提炼,见提交 `81c0ee2b`)。〔原待发令的迭代 30 卡②③已于 2026-10-17 用户令剔除,移 06 状态「待设计」——非发令项,重启须先过设计定稿〕
- 待批准发起:**11 号闸 parity 回放确定性对拍**(迭代 29 把它收编为重闸里的条件闸件,每次跑批只做触面判定、不自动跑;迭代 29 批已判触面并挂 NEED-APPROVAL,批准方式=带 `PARITY_APPROVED=1` 发起,MC 须用户批准才跑)。
- 在途分支未合并 master(读现状时勿当已入库):**无**。线头清理(2026-10-17 用户令):`art-standee-20261006` 已合并入 master(立绘定档批机检三件+文档修正,见状态记录 511)、`doc-adr-fixes-20261014` 判废删除(ADR 体系已废、内容 git 历史可考),两 worktree 与分支同删。已合并的 worktree/分支清理(2026-10-17 用户令执行):`g-plan2-iter29-testlayers`、`g-plan2-menusub-20261016` 两工作区与分支 `adr-purge-20261015`、`adr-leak-fix-20261016` 已删;`ci-removal-20261015` 已按 2026-10-16 既裁重做(只删 `.github/workflows/tests.yml`、撤 ADR 两条)合并 `db032fb5` 后工作区与分支同删;**在盘待删**:`g-plan2-carddoc-20261017`(分支 `carddoc-20261017` 已合并 `480d8118`)、`g-plan2-iter30-glow`(分支 `iter30-glow-20261017` 已合并 `7ffd1dc0`)、`g-plan2-iter30-fb`(分支 `iter30-fb-20261017` 已提交 `34f3cdb3`,合回 master 后删)三工作区,删除待令。
- 在途分支未合并 master(读现状时勿当已入库):**无**。线头清理(2026-10-17 用户令):`art-standee-20261006` 已合并入 master(立绘定档批机检三件+文档修正,见状态记录 511)、`doc-adr-fixes-20261014` 判废删除(ADR 体系已废、内容 git 历史可考),两 worktree 与分支同删。已合并的 worktree/分支清理(2026-10-17 用户令执行):`g-plan2-iter29-testlayers`、`g-plan2-menusub-20261016` 两工作区与分支 `adr-purge-20261015`、`adr-leak-fix-20261016` 已删;`ci-removal-20261015` 已按 2026-10-16 既裁重做(只删 `.github/workflows/tests.yml`、撤 ADR 两条)合并 `db032fb5` 后工作区与分支同删;**在盘待删**:`g-plan2-carddoc-20261017`(分支 `carddoc-20261017` 已合并 `480d8118`)。`g-plan2-iter30-glow`/`g-plan2-iter30-fb`/`g-plan2-iter30-sample` 三工作区与分支已随 2026-10-17 卡②③剔除批删除(sample 分支 5 个未合入提交——卡②样张批 T0/T1/515 终止/active 清理——随用户「3 个工作区全部删除」令一并废弃,git 历史可考)。
- 在册观察(06 登记,非阻塞):迭代 27 卡片义务补登两项——长函数余量 17 个中的装配/校验函数、lambda 连接防回归。
## 状态记录(滚动窗口:仅当前迭代;退役规则见 doc-conventions §10)
@@ -59,3 +59,5 @@
- **511(2026-10-17,在途线头收编批——立绘定档分支合入+两条老线头清理)**:用户令「art-standee-20261006 合入;完成之后把两个工作区删除」。①**`art-standee-20261006` 合入**(worktree `g-plan2-standee-tier`,2026-10-06/07 立绘定档与站桩重排实装批,领先 5 笔、落后曾达 478 笔;先 merge master 解一处冲突——art-bible 定档行取 master 用语规范版、排版行取分支「允许向上溢出盒顶 N px」甲案版)。落 master 内容:10-07 三处文档修正(art-bible §8.2 站桩排版③大体档溢出甲案与光柱脱钩/§8.3 参考核验废路径 `production/mockups/`→`artwork/mockups/`/battle.md 敌方站桩行同款甲案措辞——三处 master 实查均仍为旧措辞即从未落库)+06 新登「战斗区背景图替换——B 区舞台插画+临时光柱退役」条(2026-10-07 用户点名登记)+机检三件工具(`tools/standee_asset_check.py` 逐键档高升级版、`tools/palette_check.py`、`tools/path_check.py`;依赖 `STANDEE_TIER_H` master 已有)+四份过程文档归档(实装批任务书/交接说明/artwork 独立仓 dry-run 清单/立绘读数 txt)。**该批止于 B 段工具闸,C 段引擎实装、D 段人闸未跑,roadmap 迭代位归属仍待用户裁**。②**13 件未跟踪立绘先抢救再删区**:`_tmp_standee_new/`(八敌+主角三态+九人对照总图+读数,149K,素材不入 git)已拷至主区 `artwork/archive/standee-tier-20261007/`(gitignore 豁免面零状态噪音);该批 AI 生成像素立绘在 2026-10-14「精细手绘像素」方向裁定下的去留归用户后裁。③**`doc-adr-fixes-20261014` 判废删除、不合入**(worktree `g-plan2-doc-adr-fixes`):五笔提交改的 10 文件全数失效——7 份 `adr-*.md` 已被废除批删除(modify/delete 冲突面)、architecture.md v1.4 被 v1.8 超越、02 清单与 registry 实查零 ADR 字样;分支内 ADR 审查报告已被分支自身第三笔删除,git 历史 `302b5b2c` 可考(Qoder 会话「报告仍在分支」系误报,已核)。两 worktree 与分支(`-d`/`-D`)均删,merge 说明载 --docs 闸回执。
- **512(2026-10-17,迭代 30 卡① 文档批——代拍板七项追认+反哺点七条回写)**:用户令「追认没有问题;反哺点可以都进行回写」两项一波走完(文档批,不占迭代号,worktree `g-plan2-iter30-fb`,分支 `iter30-fb-20261017`,基于 master `0a164958`、合回前 merge master 解 active.md 一处冲突——本批状态记录原编 511 与 master 线头收编批 511 撞号,按 iter29 先例改 512)。**追认**:卡①代拍板白名单 7 项全部同意,追认结果行加在 `reports/iter30-代拍板追认单-2026-10-17.md` 文末(用户令原文「追认没有问题」)。**反哺点七条全部回写**:①06-待办清单——条目状态待办→已完成(入库 7ffd1dc0、冒烟 1151/0、单测 34 套、探针 case⑰、07 ㉘ 人闸五项)+色相措辞修正为「样张 v2 冻结既裁值」+2026-10-05 实查读数刷新(bonus_pick_overlay.gd 已改名 curio_pick_overlay.gd:97、TG_* 五族在役 ui_kit.gd:49-53)+新增「卡顶色带与格面微光两带统一」待办条(Q3 甲案);②HUD框架——实装状态行转「已实装(迭代 30 卡① 2026-10-17 入库,合并 `7ffd1dc0`)」、验收行转正式验收(去「待实施批落地后验收」括注)、版本历史 v0.19、口径史注记后补两带分工注记;③08-Alpha版本标准——「五 · 表现」表新增「未开格类型微光(五组色相+明度档)」行(在役;明度档 provisional 值,样张批复核转正)+版本历史 v1.9+文头状态行 v1.8→v1.9;④art-bible——五组明度档 provisional 值(芥末黄 #F7DF43/黄绿 #68D042/青 #30A6A6/紫罗兰 #7B5BD6/绯红 **#A61D37**=冻结 #FF2D55 的 V=0.65 档;五组 ΔH ≤0.13° 色相零移动)+生成口径(渲染合成空间伽马阶梯、相邻组模型 CR 1.245/1.234/1.239/1.270、判据线 1.20、实测最弱对 1.232、群伤暗档停机呈报留痕)落版本历史 v3.15;§4.2/§4.6.3 权威面零改动、§2.1 未追加(Q5 甲案静态);头注「现行为」v3.11→v3.15 漏更订正;⑤roadmap——迭代进度行、近期主战场行与迭代 30 表行状态列同步卡①已入库(②③待 `/iter` 发令);⑥Q3 甲案两带分工——注记落 HUD框架 微光节、06 新待办条(见①);⑦07-体验验证清单——新增 ㉘ 节五项人闸(五组一眼可分/不遮数字〔环不外溢〕/出圈灭入圈复亮/整屏不脏/群伤暗档 #A61D37 观感〔provisional,读数归样张批〕)+版本历史 v1.5。**反哺点清单批注**:`reports/iter30-反哺点-2026-10-17.md` 加「回写结果」节逐条标已回写。**验收**:文档域闸 `tools/run_all_gates.sh --docs` 零新增红(回执 commit=`34f3cdb3`)。**遗留**:卡②③待 `/iter` 发令(未决面在册);实机目检人闸五项(07 ㉘)待用户过目;群伤暗档 provisional 待样张批转正;`g-plan2-iter30-fb` 工作区待合回后清理。
- **513(2026-10-17,迭代 30 卡②③剔除批——零回滚·状态换代)**:用户先令排查迭代 30 已合入 master 的提交面(卡①实现五提交+文档批+卡片批等 14 笔在案),复查卡①质量后裁「卡①没有问题,保留」,**零 git 回滚**;随后裁定卡②③本质为设计澄清/美术定稿环节(卡②样张即设计目标图、产出规格反向给素材批;卡③挂素材轴定性人闸且素材规格依赖卡②产出),不满足「迭代=代码实现批」开发条件,令剔除迭代 30、在 06 登记状态「**待设计**」(前置=设计讨论→需求澄清→美术定稿,v1.4 原卡留 `design/research/` 作素材,禁未定稿直接开工)。落地:roadmap 三处换代(迭代 30 表行改单卡①+剔除注、迭代进度行、近期主战场行)+06 新登待设计条(两卡分列);同批按前令删除三 worktree(`g-plan2-iter30-fb`/`iter30-glow`/`iter30-sample`)与三分支,sample 分支 5 个未合入提交一并废弃(含卡②样张批 T0/T1 方向稿三张与 515 终止记账,git 历史可考)。主区并行未提交件(术语表/project.godot/M4 卡片删除等)零触碰。
+15
View File
@@ -755,3 +755,18 @@
**归属**:测试基建批/工程债批(不阻塞,不排期)
**状态**:**在册待裁**(七条均为本批未收的余量;迭代 29 已交付的部分见实现报告与 architecture.md 测试与质量域节)
---
#### 迭代 30 剔除卡②③——战斗一屏样张+第二/三关棋盘观感(2026-10-17 用户令移本清单·状态「待设计」)
**现状**:两卡原编入迭代 30(2026-10-16 用户令「UI 呈现三卡批」,卡片均 v1.4 零待裁残留)。卡①(未开格类型徽章批)已入库交付;卡②③经 2026-10-17 用户裁定**不满足「迭代=代码实现批」的开发条件**——卡②(战斗一屏样张)交付物本身就是设计规格(样张即设计目标图,产出尺寸档/色板/明度档清单反向给素材批,正式字体与素材均未定稿);卡③(二三关棋盘观感)自身挂「素材轴/UI 轴」定性人闸+甲/乙(recolor/远程生图重产)素材裁点,且若裁乙其瓦片规格依赖卡②的目标规格清单产出。两卡同日样张批开工已被用户终止(理由=「设计未完全定下来,此前可直接开发结论错误」)。剔除后 roadmap 迭代 30 位只留卡①;两卡在 `design/research/` 的 v1.4 原稿保留,作后续设计讨论的输入素材(非现行需求,重启不得直接开工)。
| # | 事项 | 状态 | 前置条件 |
|---|---|---|---|
| 1 | **战斗一屏样张**(原迭代 30 卡②,卡片=`design/research/需求卡片-战斗一屏样张批-2026-10-16.md`) | **待设计** | 设计讨论→需求澄清→美术定稿;定稿后重新立卡方可开发 |
| 2 | **第二/三关棋盘观感**(原迭代 30 卡③,卡片=`design/research/需求卡片-二三关棋盘观感批-2026-10-16.md`;素材轴甲/乙裁点随设计讨论重开) | **待设计** | 同上;且素材规格依赖条 1 的目标规格清单产出 |
**归属**:设计讨论批(不阻塞,不排期;设计权威产出归 GDD/美术文档,走设计流程非迭代实现)
**状态**:**待设计**(2026-10-17 用户令自迭代 30 剔除移入本清单;禁止未过设计定稿直接 `/iter` 开工)
+3 -3
View File
@@ -24,8 +24,8 @@
## 当前位置(2026-10-16 刷新)
- **里程碑语义(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 位移在带;实现报告已退役(git 历史可考);残留人闸=实机目检三观测〔07 ㉓〕;代拍板追认单+GDD 反哺点五条待用户;**本迭代位仍预留后续追加卡——用户将把其他需求陆续编入本迭代**);;**迭代 25=UI 全局主题批 ✅ 已入库**(2026-10-13 用户令编入,/goal+iter U0 单会话交付:全局主题资源 main_theme.tres 挂载+两处局部做法退役+冒烟 V1-V6 断言 38 条,冒烟 987/0+重闸全绿;实现报告已退役(git 历史可考);残留人闸=实机目检全屏巡检〔07 ㉔〕);**迭代 26=UI 交互与观感批已编入待开工**(2026-10-14 用户令;需求卡片 v1.2 零待裁点;开工门=U0——用户新会话 /iter 26 发令;本迭代位预留后续追加卡,同迭代 24 先例);**迭代 27=代码架构技术债修复批 ✅ 已入库**(2026-10-14 /goal+iter U0 开工单会话交付:三屏场景化+会话物化+五段 Segment+RunLedger+ModalFlow+类型闸+卫生件五波全落;逐位一致对拍三变体五跑全同;实现报告=reports/iter27-实现报告-2026-10-14.md;残留人闸=实机目检五件〔07 ㉖〕;代拍板追认单十五项已追认(2026-10-17 用户令全同意)+GDD 反哺点两条已于 2026-10-17 用户逐条裁决写入);**迭代 28=启动装配与生命周期验收补全批 ✅ 已入库**(2026-10-15 用户令编入并预批连做全批,单会话交付:T1 装配语义合同 `LAYER_CONTRACT` 单点化+冒险屏先挂/菜单屏后挂的顺序修复+V1a-d 断言重写/T2 `_smoke_boot_chain` boot 链路十断言/T3 `_smoke_lifecycle_matrix` 九阶段×五引用面/T4 渲染面三件(shot_probe 两自检+shot_checker 墨色判据+启动态菜单 golden)/T5 变异验证六次注入全见红并精确还原/T6 规范三处落文;冒烟 **1086/0→1125/0**(+39=新增 42−退役裸下标断言 3);实现报告=reports/iter28-实现报告-2026-10-15.md;残留人闸=实机目检启动态菜单〔07 ㉗〕;代拍板追认单十三项已追认(含四条白名单外,2026-10-17 用户令全同意;第 14 项「req-card 双副本是否取齐」仍待裁)+GDD 反哺点三条已于 2026-10-17 用户逐条裁决写入);**迭代 29=测试分层与门禁语义修正批 ✅ 已入库**(2026-10-16 /iter U0 开工单会话交付:T1 三硬闸〔退出码/脚本错误扫描/断言数下限,三反例改前判绿改后判红〕/T2 术语订正+CI 残留 8 处清除/T3 `tests/integration/` 建承载+parity 收编为重闸 11 号条件闸件/T4 `screen_flow_probe` 入轻闸/T5 新增六套单测〔27→33 套〕/T6 S3 路径修正+零命中自检+补 S5/T7 游离脚本台账+golden 判有效/T8 架构事实源三张表回写+06 登记遗留七条;冒烟 1127/0 持平、重闸全绿存量红零新增;实现报告=reports/iter29-实现报告-2026-10-16.md;**无用户目检项**;代拍板追认单十二项已追认(2026-10-17 用户令全同意)+GDD 反哺点三条待用户裁决;**遗留:11 号闸 parity 对拍判为触面,需用户批准才发起**);**迭代 30=UI 呈现三卡批(徽章→样张→观感,迭代内串行):卡①未开格类型徽章批 ✅ 已入库**(2026-10-17,7ffd1dc0;冒烟 1151/0、单测 34 套、渲染闸全绿、golden 0.10–0.14% 判有效;卡②③待 `/iter` 发令——详见迭代 30 表行);**迭代 31+ 位空·无批次**(原 M4 数值批已废——2026-10-16 用户删卡令「它就不是一个应该存在的东西」,禁止再以该名义立批/规划/引用已删卡;四项数值欠账归 06 在册、重新归属待用户裁)。
- **近期主战场**:迭代 20/21/22/23/24/25/26 残留人闸(实机目检六批,07 在册);**迭代 29 已入库;下一前沿=迭代 30 UI 呈现三卡批**(迭代 29 入库后遗留=11 号闸 parity 对拍待批准发起+GDD 反哺三条已裁决写入(2026-10-17);其后**迭代 30=UI 呈现三卡批**同日用户令编入(卡①未开格类型徽章批 2026-10-17 已入库 7ffd1dc0,卡②战斗一屏样张/③第二三关棋盘观感待 `/iter` 发令〔三卡裁点已留痕,见迭代 30 表行〕);各批 provisional 终值的统一标定义务随 M4 数值批废除归 06 在册、重新归属待裁;迭代 20~28 残留人闸八批 07 在册)。
- **迭代进度**:迭代 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 位移在带;实现报告已退役(git 历史可考);残留人闸=实机目检三观测〔07 ㉓〕;代拍板追认单+GDD 反哺点五条待用户;**本迭代位仍预留后续追加卡——用户将把其他需求陆续编入本迭代**);;**迭代 25=UI 全局主题批 ✅ 已入库**(2026-10-13 用户令编入,/goal+iter U0 单会话交付:全局主题资源 main_theme.tres 挂载+两处局部做法退役+冒烟 V1-V6 断言 38 条,冒烟 987/0+重闸全绿;实现报告已退役(git 历史可考);残留人闸=实机目检全屏巡检〔07 ㉔〕);**迭代 26=UI 交互与观感批已编入待开工**(2026-10-14 用户令;需求卡片 v1.2 零待裁点;开工门=U0——用户新会话 /iter 26 发令;本迭代位预留后续追加卡,同迭代 24 先例);**迭代 27=代码架构技术债修复批 ✅ 已入库**(2026-10-14 /goal+iter U0 开工单会话交付:三屏场景化+会话物化+五段 Segment+RunLedger+ModalFlow+类型闸+卫生件五波全落;逐位一致对拍三变体五跑全同;实现报告=reports/iter27-实现报告-2026-10-14.md;残留人闸=实机目检五件〔07 ㉖〕;代拍板追认单十五项已追认(2026-10-17 用户令全同意)+GDD 反哺点两条已于 2026-10-17 用户逐条裁决写入);**迭代 28=启动装配与生命周期验收补全批 ✅ 已入库**(2026-10-15 用户令编入并预批连做全批,单会话交付:T1 装配语义合同 `LAYER_CONTRACT` 单点化+冒险屏先挂/菜单屏后挂的顺序修复+V1a-d 断言重写/T2 `_smoke_boot_chain` boot 链路十断言/T3 `_smoke_lifecycle_matrix` 九阶段×五引用面/T4 渲染面三件(shot_probe 两自检+shot_checker 墨色判据+启动态菜单 golden)/T5 变异验证六次注入全见红并精确还原/T6 规范三处落文;冒烟 **1086/0→1125/0**(+39=新增 42−退役裸下标断言 3);实现报告=reports/iter28-实现报告-2026-10-15.md;残留人闸=实机目检启动态菜单〔07 ㉗〕;代拍板追认单十三项已追认(含四条白名单外,2026-10-17 用户令全同意;第 14 项「req-card 双副本是否取齐」仍待裁)+GDD 反哺点三条已于 2026-10-17 用户逐条裁决写入);**迭代 29=测试分层与门禁语义修正批 ✅ 已入库**(2026-10-16 /iter U0 开工单会话交付:T1 三硬闸〔退出码/脚本错误扫描/断言数下限,三反例改前判绿改后判红〕/T2 术语订正+CI 残留 8 处清除/T3 `tests/integration/` 建承载+parity 收编为重闸 11 号条件闸件/T4 `screen_flow_probe` 入轻闸/T5 新增六套单测〔27→33 套〕/T6 S3 路径修正+零命中自检+补 S5/T7 游离脚本台账+golden 判有效/T8 架构事实源三张表回写+06 登记遗留七条;冒烟 1127/0 持平、重闸全绿存量红零新增;实现报告=reports/iter29-实现报告-2026-10-16.md;**无用户目检项**;代拍板追认单十二项已追认(2026-10-17 用户令全同意)+GDD 反哺点三条待用户裁决;**遗留:11 号闸 parity 对拍判为触面,需用户批准才发起**);**迭代 30=UI 呈现批:卡①未开格类型徽章批 ✅ 已入库**(2026-10-17,7ffd1dc0;冒烟 1151/0、单测 34 套、渲染闸全绿、golden 0.10–0.14% 判有效;原卡②③已于 2026-10-17 用户令剔除——待设计归 06,见迭代 30 表行);**迭代 31+ 位空·无批次**(原 M4 数值批已废——2026-10-16 用户删卡令「它就不是一个应该存在的东西」,禁止再以该名义立批/规划/引用已删卡;四项数值欠账归 06 在册、重新归属待用户裁)。
- **近期主战场**:迭代 20/21/22/23/24/25/26 残留人闸(实机目检六批,07 在册);**迭代 29 已入库;迭代 30 卡①已入库、卡②③已剔除归 06 待设计(2026-10-17 用户令)**(迭代 29 入库后遗留=11 号闸 parity 对拍待批准发起+GDD 反哺三条已裁决写入(2026-10-17);迭代 30=UI 呈现批,卡①未开格类型徽章批 2026-10-17 已入库 7ffd1dc0;卡②战斗一屏样张/③第二三关棋盘观感本质为设计澄清/美术定稿环节、不满足代码实现批开发条件,移 06 待设计,见迭代 30 表行);各批 provisional 终值的统一标定义务随 M4 数值批废除归 06 在册、重新归属待裁;迭代 20~28 残留人闸八批 07 在册)。
- **实时状态**:以根目录 [active.md](active.md) 顶部「当前状态快照」节为准(`stage.txt` 已定性为旧阶段开关,仅存档)。
## 主线路线(里程碑 × 迭代序列)
@@ -86,7 +86,7 @@
| 迭代 27 | **①代码架构技术债修复批(2026-10-14 用户令编入;来源=[代码架构与实现质量审计报告-2026-10-14](design/research/代码架构与实现质量审计报告-2026-10-14.md),双席审计基线 97de02c,已逐条复核)**:需求卡片=`design/research/需求卡片-代码架构技术债修复批-2026-10-14.md`(**v1.2——三点全裁零待裁〔2026-10-14 用户三裁全按推荐案:①第三个 autoload/②单类持四账/③审计五段〕,卡片成立**)。五波:· **波一 场景拆分+局生命周期物化(≈4-5d)**〔P0-1/P0-2:屏容器 .tscn 切分=开始菜单根场景+营地场景+冒险场景〔内含 level_map/battle 两容器〕,视图代码原样搬、**40+ views 不转 .tscn**;SaveManager/MetaProgression 升格跨场景持有者;「一局」物化为可整体 `queue_free()` 的节点,`main.gd:647-657`/`:555-559` 手工清单消亡;13 个 smoke 探针挂载假设同批迁移〕· **波二 `_settle` 拆段(≈1.5d)**〔P1-1:五段 Segment 类 grant/aura/combat/decay/verdict,24 处 kind 分派随段归位,姊妹病灶 `damage_controller.gd:272` 148 行同批拆〕· **波三 账本收口(≈1.5d)**〔P1-4 共享四账 Ledger 类化+P1-2 刷新双账删 main 副本+P1-3 summary 增 `gp_final` 键、删 `gp_shadow_ledger.gd`〕· **波四 组合根可测化抽取+模态协议内聚(≈1.5-2d)**〔P1-5/P2-7;**须在波一落地后重估抽取面再动**〕· **波五 类型闸收尾+卫生件包(≈3d)**〔P1-6 拉闸+存量 73 处收口,**须在其他重构全部落地后**;P2 七组顺手带〕。🔴 契约 6 条(**零行为变更·重构前后同种子完整局输出逐位一致**/只拆不重写/views 不转 .tscn/探针契约零破坏/信号纪律不变/执行顺序锁+渲染零漂移);**核心验收=逐位一致对拍**(RngService 单盐流在役);验证闸 V1-V9;代拍板白名单九项;反馈点两条(architecture/code-conventions)。 | **✅ 已全批入库(2026-10-14 /goal+iter U0 开工单会话交付,worktree g-plan2-iter27-techdebt 分支 iter27-techdebt-20261014 七提交)**——波一 三屏场景化+run_scope 会话物化+双 autoload(7a0d57d)/波二 _settle 五段 Segment+英雄攻击拆步(26301ba)/波三 RunLedger 单类四账+刷新双账删副本+gp_final 删影子账(6fd7d78)/波四 ModalFlow+互斥域 tags+双 context(8b9e556)/波五a 类型闸 368 参数化+审计器+warning 配置(b605022)/波五b 卫生件 13 死代码+FeatsEngine 退役+Callable 换装+状态机 enum 化+ConfigDB 归根+resolver 解耦(T6 笔)/T7 文档同步(本笔)。**闸**:逐位一致对拍三变体五跑全同(V1 核心验收)+冒烟 1055→1081/0(+V2 屏壳 11+V3 两连局 11+V4 段类 16+V6 模态 19+V5 快照 3+V7 2 断言)+run_all 25→27 套+probe click+render golden 0.00%+static_scan S1/S2/S4/S9 全绿(历史 cd 静默空转顺修);MC 对拍=parity_anchor 三变体×40 局×RUNSUM+JSONL 双面(工具入库 tools/parity_anchor.py);实现报告=reports/iter27-实现报告-2026-10-14.md(代拍板追认单十五项+GDD 反哺点两条);残留人闸=实机目检五件(07 ㉖);审计报告本体按退役规则 git rm | T0-T7≈12-14d(实际单会话) |
| 迭代 28 | **①启动装配与生命周期验收补全批(2026-10-15 用户令编入)**:需求卡片=design/research/需求卡片-启动装配与生命周期验收补全批-2026-10-15.md(v1.0——零待裁点,用户预批连做全批)。六任务:T1 装配语义合同单点化+装配顺序修复+V2 断言重写/T2 boot 链路时序后置条件(_smoke_boot_chain 六断言)/T3 生命周期存活性矩阵(_smoke_lifecycle_matrix 十阶段×五引用面)/T4 渲染面内容断言(shot_probe 两自检+shot_checker 墨色占比+启动态菜单 golden)/T5 变异验证(横切随批)/T6 规范落文+文档同步闸+收口;修复坏事实三件(main.gd:207-210 装配序错致 F5 见战斗界面、smoke_all.gd:176 V2 断言保护 bug、菜单截图无内容断言)。🔴 契约 7 条(零玩法行为变更/合同单点化/断言禁裸下标/测试先行/变异验证门槛/只加不重构/闸机轮次纪律) | ✅ 已入库(2026-10-15 单会话交付:T0-T6 全绿;冒烟 1125/0、run_all 全套、probe_gate --click/--full、render_gate 四闸全绿;变异验证六次注入全见红;实现报告=reports/iter28-实现报告-2026-10-15.md;残留人闸=实机目检启动态菜单〔07 ㉗〕) | 实耗≈1 会话(原估 T0-T6≈5.25d) |
| 迭代 29 | **①测试分层与门禁语义修正批(2026-10-16 用户令编入)**:把验收语义从「跑一遍没崩=冒烟通过」扭转为「**三层完备+判定可靠**」——兑现用户三条诉求(①最单元的逻辑代码有单元测试 ②整体模块有接口测试 ③整体系统有 UI 方面与场景切换相关的测试)且验收不止于冒烟。四件事:**①本地闸三硬闸**(退出码为唯一权威判据·PASS 串降级为日志;`SCRIPT ERROR`/`Parse Error` 扫描命中即红;断言数为零即红——`probe_gate.sh` 四探针判定改退出码优先、`test_kit.finish` 零断言判红、`run_all` 汇总校验实跑套件数,全部反例实证留档);**②L2 接口层从零建承载**(建 `game/tests/integration/`+`parity_anchor` 收编入闸表+存档⇄RNG 快照往返首个集成用例);**③L3 屏壳切换探针**(新建 `screen_flow_probe`:六步主流程+三屏壳 `visible` 互斥+放弃回退路径,入轻闸);**④L1 补洞+术语订正+状态记录清理**(4 个 core 零指名模块+呈现层风险前三补单测;「冒烟」唯一保留语义=秒级存活检查;15 个游离脚本逐个定性、golden 基线时效判定、补 S5 扫描规则)。🔴 契约 7 条(零玩法行为变更/三硬闸不可绕过/现有断言面只增不减/不引入第三方测试框架/架构事实唯一源=architecture.md/探针契约零破坏/测试执行两入口铁规);验证闸 V1–V11;代拍板白名单 10 项;**无用户目检项(纯基建)**。需求卡片=`design/research/需求卡片-测试分层与门禁语义修正批-2026-10-15.md`(**v2.0**——三轮复查定稿、零待裁点;§2 事实面改指针归 architecture.md「测试与质量域」节,T2 吸收 CI 残留 8 处,T6 收 S3 路径修正+零命中自检,T5 补洞选面换 board_generator;T0–T8≈6.0–7.5d) | ✅ 已入库(2026-10-16 /iter U0 发令;worktree `g-plan2-iter29-testlayers`,分支 `iter29-testlayers-20261016`;重闸全绿、存量红零新增;**遗留=11 号闸 parity 对拍待用户批准发起**) | 实耗≈1 会话(原估 T0–T8≈6.0–7.5d) |
| 迭代 30 | **①UI 呈现三卡批(2026-10-16 用户令编入——三卡待裁项同日用户令「按推荐方案」全部代拍板留痕,卡片均 v1.4;迭代内串行 ①→②→③,禁三线并行,依据=06/08/07/art-bible/roadmap/active 汇聚文件互踩〔grilling 审查记录 D3〕)**:**①未开格类型徽章批**——类型微光实装:英雄周界 8 格内未开格、组粒度五组色相(色相系既裁=art-bible 样张 v2 定稿,本批只补从未定义的组间明度档 provisional 值、复核转正义务移交②)、渲染路线裁丙=每格 CanvasItem shader 接触带柔光为主+程序绘制兜底(T0 原型帧先行件前置;视觉调优走「出帧→目检→改参」迭代,不承诺轮数)、开关裁丙=默认开+组合根布尔+调试浮窗可切(off 态逐位一致断言承接基线保护)、静态态(§2.1 既裁合规)、两套色带不并入本批(统一另登 06 条·批次出口写入文档)。卡片=`design/research/需求卡片-未开格类型徽章批-2026-10-16.md` → **②战斗一屏样张批**——裁丙「样张即设计目标图」:本批仅战斗屏(Q2 甲,余三屏登 06 排队)、引擎实拍+shader 为主路线(Q3 乙,半天试验件前置、证伪预设退甲案纯代码管线)、字重按目标效果示意(Q4 丙,字体补完批按样张补真件)、双口径两闸分跑(Q6 乙)、死指涉改指在盘最近稿注「指代稿」(Q5 甲);交付含目标规格清单(尺寸档/色板/明度档逐件成文,反向给素材批)+徽章明度档复核转正。卡片=`design/research/需求卡片-战斗一屏样张批-2026-10-16.md`(≈5–6d)→ **③第二/三关棋盘观感批**——L2/L3 同批(Q3 甲);T1 定性采样+归因报告过 06 既裁「素材轴/UI 轴」定性人闸(含 T1b 新建舞台底采样件);素材轴默认甲案 recolor 换色候选样张先行,甲/乙(远程生图重产)裁点挂 T1 出口呈报硬步骤;若裁乙,瓦片规格随②目标规格清单、与徽章明度档同基线防互踩。卡片=`design/research/需求卡片-二三关棋盘观感批-2026-10-16.md`(5–7d)。验收共性=机检断言+用户目检(真人检测按 CLAUDE.md 既裁登记不阻塞、否决即回补);08「五 · 表现」对应三行出口改写 | 卡①已入库(2026-10-17,7ffd1dc0;卡②③ U0 开工门=用户 `/iter` 发令,三卡裁点已全部留痕·无待裁残留) | 三批串行合计 ≈11–14d——超软盒 7d,按批次分会话逐个 U0 发令(各卡内部切分点见卡),禁单会话连做跨卡 |
| 迭代 30 | **①UI 呈现批(原「三卡批」——2026-10-17 用户令剔除卡②③:两卡本质是设计澄清/美术定稿环节、无现成素材可消费,不满足「迭代=代码实现批」的开发条件,移 06 待设计;重新立卡开发前须先走设计讨论→需求澄清→美术定稿)**:**①未开格类型徽章批**——类型微光实装:英雄周界 8 格内未开格、组粒度五组色相(色相系既裁=art-bible 样张 v2 定稿,本批只补从未定义的组间明度档 provisional 值、复核转正义务移交②)、渲染路线裁丙=每格 CanvasItem shader 接触带柔光为主+程序绘制兜底(T0 原型帧先行件前置;视觉调优走「出帧→目检→改参」迭代,不承诺轮数)、开关裁丙=默认开+组合根布尔+调试浮窗可切(off 态逐位一致断言承接基线保护)、静态态(§2.1 既裁合规)、两套色带不并入本批(统一另登 06 条·批次出口写入文档)。卡片=`design/research/需求卡片-未开格类型徽章批-2026-10-16.md`。验收=机检断言+用户目检(真人检测按 CLAUDE.md 既裁登记不阻塞、否决即回补)。〔卡②战斗一屏样张批/卡③第二三关棋盘观感批已于 2026-10-17 用户令剔除本迭代位,移 06「待设计」条,原 v1.4 卡片留 `design/research/` 作设计讨论素材〕 | 卡①已入库(2026-10-17,7ffd1dc0;卡②③已剔除→06 待设计) | 卡①单批 ≈4–5d,已交付 |
| 迭代 31+ | **(位空·无批次——原「M4 数值批」已废)**:2026-10-16 用户令删除需求卡片(原话「它就不是一个应该存在的东西」)⇒ **禁止再以「M4 数值批」名义立批、再规划、再引用已删卡片**。四件数值欠账本身仍在册——①削弱档位终值 ②调参批数值点评(06 条目现行五条)③钥石产出重标+通关率带重扫(迭代 10 奖励重构联动欠账)④元进度定价剩余面(forge 定价·Boss 两档终值)——连同各批 provisional 终值标定义务,**一律归 `design/gdd/06-待办清单.md` 跟踪,重新归属待用户裁**;读数复算义务(迭代 14 两件后置)仍挂 07,damage_probe A1 既有红灯在册。M4=Beta 阶段口径不变(M3 未由用户明令关闭前不排期);本迭代位留空待用户令编入 | 用户发令编入(未排期) | —— |
## 执行纪律(2026-09-27 用户立规)