docs(roadmap): 专长实装批编入迭代 20（2026-10-11 用户令）

- roadmap 迭代 20 行：空位待编 → 专长实装批（卡片指针/T0-T10/估时/三段推进）；规划冻结按自身口径由用户直接发令解锁（仅迭代 20，21/22 维持）
- 卡片与 06 状态同步=已编入迭代 20、开工门=U0；active 460

active.md

@@ -58,3 +58,4 @@
 458. **文档一致性修复批（2026-10-11，用户令修复定时检查呈报第 1、2 项；worktree docfix-docsync-20261011 单提交 081027c+主区 merge --no-ff 4400351，纯文档零测试）**：①**死链 7 处清零**——秘宝.md 10-10 目录归位批漏网 5 处改指 systems/跨局循环/秘宝.md（01-核心循环 v1.6 版本行/02-系统清单 v1.3 版本行/奇物.md v3.5 版本行〔反斜杠路径一并改正〕/地形变异.md 负责表+依赖表两行）+camp.md 树面板行两处补 ../systems/ 前缀（天赋树/HUD框架）；数据配置.md:221 存量挂账维持（iter19 基线在册）。②**gdd_lint 三文件转绿**——01-核心循环：R10 版本历史 v1.5 同号顺延（10-10 分界尺措辞行→v1.7）+R5「生命周期轴（五档）」节补五档嵌套字符画〔报错原文误记「死了之后」节=工具 prev/cur 错位，tools/gdd_lint.py R5 报错节名一行修正随批〕+「死了之后」节顺带补死亡重开环字符画；02-系统清单：R6 术语表行多余版本列摘除+R3 三行状态格改写现行白话句并换代版本号（天赋树 v0.4 换代定稿 29 节点=营地统一案甲、武器锻造 v0.2、奇物 27 件扩容后）+v1.21；03-内容规模：R1 超长段拆两段+目录计数换代 15→12 件（普通 7/优秀 3/稀有 2——回能器删/换装券撤/第四只手删三轮在本文件的漏网面）+v1.3。闸=lint 9 文件 2 不通过（=06/07 基线存量）/主区死链 1（=数据配置 221 存量）/熵增 PASS。版本行：01 v1.8/02 v1.21/03 v1.3。**未处置呈报遗留**=term「充能」词表口径 17 处误报（第 6 项）/registry aux_items 旧六行换代（第 3 项，归秘宝实装批 T0）/roadmap 当前位置节 2026-09-29 滞后（第 4 项）/状态记录 450-452 三对同号（第 5 项）。
 
 459. **迭代粒度规矩修正+专长实装批卡片成立批（2026-10-11，用户两裁 Q2 占位值/Q3 单迭代+用户令废「软时间盒 ≤3 工作日」自造规矩；worktree iterbox-fix，主会话直执，纯文档零测试）**：①**规矩修正**：roadmap 迭代粒度节「软时间盒 ≤3 个工作日，超限即切迭代」系 3abb3bd2「粒度对齐敏捷迭代」批成文时自造、用户从未立过（用户质询「是不是你幻想出来的规定」——查史证实出处后依令改文）——换代=**迭代周期 ≈ 一周左右**；全库仅 roadmap:92 一处承载（迭代 12 行「超软时间盒切 12/12b」系历史行留痕）。②**卡片成立**：需求卡片-专长实装批 Q1-Q3 全裁清零（Q1 Boss 兑付换代/Q2 占位值/Q3 单迭代交付全量——内部 A/B/C 三段顺序推进+段末汇报，估时 10-12d 如实标注略超一周基准）——零待裁点，状态=成立待编入迭代；06 条目同步。
+460. **专长实装批编入迭代 20 批（2026-10-11，用户令「把当前的编入迭代20」；worktree enlist-iter20，主会话直执，纯文档零测试）**：①**确认迭代现状**：最新已落籍=迭代 19（五卡 2026-10-08）；迭代 20=空位待编（原头卡A 已并入迭代 19 卡⓪）。②**编入落位**：roadmap 迭代 20 行=专长实装批（奇物）——卡片指针/T0-T10 范围/估时 10-12d/三段推进+段末汇报；进度行换代「已编入待开工 U0」。③**冻结令关系**：编入系用户直接发令，按冻结条自身口径（重启=用户直接发令）解锁迭代 20；**迭代 21/22 冻结维持**。④卡片与 06 状态同步=已编入迭代 20、开工门=U0。

design/gdd/06-待办清单.md

@@ -144,7 +144,7 @@
 
 **状态**：待办（冻结——2026-10-10 迭代规划冻结令覆盖，重启=用户直接发令）
 
-**进展注记（2026-10-10）**：数据文件面本批不依赖武器锻造线；**槽位面依赖修正（2026-10-10 设计骨架批后）**——同调位数量与品质的语义已裁归天赋树同调位节点（树侧接线归天赋树线/天赋树实装批），本批与该批存在槽位定序点（先树后宝或合并评估，随排期裁），现役谓词表求值作为本批落地前的过渡基座仍成立；秘宝体系文档正确性检查已过（五文件交叉核对：仅 registry 三处现行旧称「魔法道具」残留，已随检查批修正；其余命中均为版本历史与更名记载的合法引述）——**检查通过；设计侧裁点经 grilling 审查轮+设计骨架批已清零（秘宝.md v2.3），按三段流程设计段完成**。**③专长侧联动已拆出独立成卡（2026-10-11 用户发令；同日用户纠正=奇物线单独成卡、秘宝面不并入）**：design/research/需求卡片-专长实装批-2026-10-11.md（T0-T10 ≈10-12d 单迭代交付；**Q1-Q3 已全裁清零**〔Q1 Boss 兑付换代/Q2 占位值/Q3 单迭代〕——**卡片成立，零待裁点，状态=成立待编入迭代**；奇物侧设计+命名+裁定齐备〔奇物.md v3.15〕）——本条目余项（①②④⑤⑥⑦）维持冻结待发令，其中⑥效果引擎扩签核实与停手挂点由专长实装批 T1 先行承载。两条线交叉核对点一处随本批 T0：feats.tres 的 magic_vs_magic 条件值所属专长件是否在素材库表二 27 件删除名单内（若在，武器锻造实装批③「改值复活」随之作废）。
+**进展注记（2026-10-10）**：数据文件面本批不依赖武器锻造线；**槽位面依赖修正（2026-10-10 设计骨架批后）**——同调位数量与品质的语义已裁归天赋树同调位节点（树侧接线归天赋树线/天赋树实装批），本批与该批存在槽位定序点（先树后宝或合并评估，随排期裁），现役谓词表求值作为本批落地前的过渡基座仍成立；秘宝体系文档正确性检查已过（五文件交叉核对：仅 registry 三处现行旧称「魔法道具」残留，已随检查批修正；其余命中均为版本历史与更名记载的合法引述）——**检查通过；设计侧裁点经 grilling 审查轮+设计骨架批已清零（秘宝.md v2.3），按三段流程设计段完成**。**③专长侧联动已拆出独立成卡（2026-10-11 用户发令；同日用户纠正=奇物线单独成卡、秘宝面不并入）**：design/research/需求卡片-专长实装批-2026-10-11.md（T0-T10 ≈10-12d 单迭代交付；**Q1-Q3 已全裁清零**〔Q1 Boss 兑付换代/Q2 占位值/Q3 单迭代〕——**卡片成立，零待裁点，状态=已编入迭代 20（2026-10-11 用户令，待开工 U0）**；奇物侧设计+命名+裁定齐备〔奇物.md v3.15〕）——本条目余项（①②④⑤⑥⑦）维持冻结待发令，其中⑥效果引擎扩签核实与停手挂点由专长实装批 T1 先行承载。两条线交叉核对点一处随本批 T0：feats.tres 的 magic_vs_magic 条件值所属专长件是否在素材库表二 27 件删除名单内（若在，武器锻造实装批③「改值复活」随之作废）。
 
 #### 效果引擎条件事实扩签——生命比例（背水实现前置需求）（2026-10-11 用户批登记）
 

design/research/需求卡片-专长实装批-2026-10-11.md

@@ -78,7 +78,7 @@ L1 自救（断言失败自查表值/占位值）；L2 记录继续（扩签落
 
 效果引擎扩签的查询面落法映射；schema 新字段英文键命名；冒烟断言形态与种子选择；占位数值在 GDD 结构锚形态内取整；卡面文案直读行 desc；代称与注释措辞。超出清单必呈报。
 
-## 10. 待裁点（已全裁清零——卡片成立，零待裁点，开工门=编入迭代）
+## 10. 待裁点（已全裁清零——卡片成立，已编入迭代 20〔2026-10-11 用户令〕，开工门=U0 用户发令）
 
 1. **Q1 Boss 兑付换代口径=换代**（2026-10-11 用户裁）：通关提升三选一整体退出、专长三选一进驻+回血保留。
 2. **Q2 数值占位策略=按 GDD 结构锚给 provisional 占位值**（2026-10-11 用户裁）。

roadmap.md

@@ -24,7 +24,7 @@
 ## 当前位置（2026-10-11 刷新）
 
 - **里程碑语义（2026-10-09 立规换代，详见下方里程碑表的换代注）**：现行里程碑 = **M3「Alpha 版本的完整实现」**——用户未明令宣布完成前停留 M3，迭代只排 M3 需求；M4=Beta 版本的完整实现，一律不排期。下文里程碑表的旧编号（M-3/M-4）保留作历史序列，语义以本节为准。
-- **迭代进度**：迭代 19 五卡全部已入库（2026-10-08，批末闸全绿）；迭代 20 尚未开工（头卡=主菜单开局缺陷修复批四件已立，待用户发令）；迭代 21/22 规划冻结（2026-10-09 用户令，重启=用户直接发令）。
+- **迭代进度**：迭代 19 五卡全部已入库（2026-10-08，批末闸全绿）；**迭代 20 已编入=专长实装批（2026-10-11 用户令，卡片零待裁点成立）待开工 U0**；迭代 21/22 规划冻结维持（重启=用户直接发令）。
 - **近期主战场**：文档治理与设计换代连续批（秘宝/奇物正文换代、件表扩容、全库术语统一、天赋树 v0.4、武器锻造成文），批次详情见 git 提交史；下一前沿=专长与秘宝实装批写卡、迭代 20 卡A，均待用户发令。
 - **实时状态**：以根目录 [active.md](active.md) 顶部「当前状态快照」节为准（`stage.txt` 已定性为旧阶段开关，仅存档）。
 
@@ -76,7 +76,7 @@
 | 迭代 18 | **⑦新冒险种子随机化+调试浮窗升级（2026-10-07 用户令入迭代 18，同日两裁点全裁+浮窗目标态已定）**：**(a) 种子随机化**——现状考证 main.gd:1210 `_seed_value()` 调试种子框为空时硬编码返回 42=每次新冒险同一种子全程可复现；改法=玩家界面入口（主菜单开新冒险）默认分支随机生成；**✅ 裁点全裁（2026-10-07 用户令）：①首次冒险维持固定种子（教学态可复现）/②测试脚本与调试接口维持显式指定种子（冒烟·MC·探针全链显式传种子零影响，锚零作废）/③种子不进玩家 UI**；断点续玩零影响（存档已载 master_seed 回填，main.gd:447 现役）；与⑥收官批零耦合、排序自由。**(b) 调试浮窗升级**（承载「调试浮窗可查当局数据」裁点=种子的唯一查看位；**本项修订迭代 15 卡① P3 甲「仅开始菜单可开·对局不可达」裁决**）——目标态三件：独立于整体界面的**最高层浮窗**（对局中也可开）/DS_DEBUG=1 调试态下**默认打开**/新增**当局数据只读区块**（当前局种子/关卡/节点/HP/GP/钥石等——玩家 UI 不展示、调试浮窗可查）。考证在册（2026-10-07 实查）：现行=开始覆盖层角标入口〔main.gd:292-293，DS_DEBUG=1 点亮〕+main.gd:1189 门禁「仅开始菜单可开」+Dialog 形态走 ModalStack 模态栈登记〔非最高层〕+visible=false 初始非默认开+五区块（胜利演出/种子输入/数值滑条/批量模拟/两层调试）无当局数据面。需求卡片待裁点：最高层与模态栈登记制的关系〔置顶/登记序末+move_child 或独立层〕/输入吞噬边界〔浮窗矩形外透传游戏输入〕/对局发起「随开随收」逻辑改向/ui_tune_probe 断言面换代/入口形态（角标宿主迁移或热键）。需求卡片=`design/research/需求卡片-种子随机化与调试浮窗升级批-2026-10-07.md`（v1.0——实装级裁点 P1 遮挡语义〔荐甲=维持登记制〕/P2 入口形态〔荐甲=角标迁宿主〕/P3 默认打开范围〔荐甲=启动即开〕/P4 当局数据字段集〔荐甲=六项〕/P5 首局种子值〔荐甲=沿用 42〕待裁；估时勘误 1d→2.0d 含探针换代与收口） | **✅ 已落地（2026-10-07 worktree iter18-seed：C1 种子三分+浮窗升级 P1-P6 甲全落；批末重闸全绿=冒烟 811/0+四探针+run_all 17 套+doc 三闸/熵增闸零新增；MC 零跑；实机人闸挂账待用户〔不阻塞已入库与后续卡④〕）** | T0-T5≈2.0d |
 <<<<<<< HEAD
 | 迭代 19 | **卡⓪主菜单开局缺陷修复批（原迭代 20 头卡A；2026-10-08 用户令并入本迭代、执行序第一）**：①**主菜单开新冒险+继续上局两入口补传同调三键**（attunement/attune_refresh_y/tree_rules——main.gd:510/:470，接收面 adventure_runner.gd:129-138/215-217 现成；静态考证缺陷成立：全仓无补偿路径、真实入口同调/X/Y 恒空、仅冒烟夹具喂值）；②**关卡开场行攻血改传当前生效值**（main.gd:519-521 现传初始表值，与战斗面板不一致=用户确认缺陷；「含面板加成」后缀判断同步改为认局外加成）；③冒烟补主菜单入口传参断言；④顺手删 adventure_runner.gd:129-134 三行重复赋值（零行为变化）。范围外=被动同调件呈现（用户令不动）、Fork 规则归因行（呈现层）、X/Y 刷新双源语义倒置（实现与用户口径镜像互换——X=刷新件源每节点重置不结转/Y=营地源整局持久/先扣 X，见 adventure_runner.gd:658-659/:706-709；用户口径=X 持久·Y 每节点重置·先扣 Y；真实局因①此前恒 0 未暴露——待用户裁定甲改实现/乙认现状，裁定落 GDD）。**卡①自动化验收补齐批（2026-10-07 用户令立项——全迭代两阶段验收盘点〔功能性+展示性，均自动化口径，不含人工目检〕的落地批）**：三件主内容——①**渲染闸自动化**：新增 `tools/render_gate.sh` 窗口化自动闸（shot_probe 四屏→shot_checker.py A-D 语义断言自动判定+fx_shot/board_shot 抓帧取证），棋盘 L1-L3 golden 逐像素基线入库 `game/tests/golden/`（测试资产入库先例，.gitignore 已核只挡 artwork/）；**probe_gate 头注释「渲染闸归真人目检」纪律句删除改写**（用户 2026-10-07 明示授权=历史偷懒标记），迭代 15③ 屏蔽挂账的机器补跑半随批核销〔07⑮ 目检半仍归用户不销号〕；②**探针收编**：ui_probe/ui_tune_probe/t17_defer_probe/fx_probe 四件游离探针（实测 17.4s/49.6s/63.0s/21.9s 全绿）收进 probe_gate `--full` 段挂重闸，轻闸默认段零改；damage_probe 出闸留盘标注诊断件、config_fatal_probe 删除（与 run_all 致命类单测重复）、零断言三件标注分析工具+ui_layout 补 1280/1920 最小断言；③**账务修正**：tests/README 套件数/断言数漂移（十五→17、752+→双口径说明）+integration 空目录处置（代拍板）。〔2026-10-07 范围改道：原「明示不收」的 B4/B5/B6 三缺口经用户令各立需求卡片并入本迭代，本卡改称卡①，新增卡②③④见后〕。需求卡片=`design/research/需求卡片-自动化验收补齐批-2026-10-07.md`（v1.1——**待裁点 0 项**，P1-P5+拷打轮一 Q1-Q8 全裁 2026-10-07〔重闸定义正式扩容 CLAUDE.md/过程截图即弃/shot_probe 扩屏三新屏/1280 单档/素材缺位 SKIP 而基线禁锚回退态/基线换代权限呈现批 agent/取证失败=闸红/integration 删空壳〕；🔴 契约 6 条含运行时代码零 diff/轻闸零删减/并行避让；停机点 S1 首跑存量 FAIL 全量呈报登记 06+S3 基线生成素材缺位停机；代拍板白名单四项）。**卡②旧界面呈现断言回补批（B5，2026-10-07 用户令立项）**：迭代 16 前落地旧屏追溯补 ui_contrast 测点对+ui_struct 契约——普查结论=对比度测点对旧屏 0 对（15 对现役全属 HUD/锚点/徽章/生涯）、专项契约仅 pause/career、legend/node 两屏从未过结构族；优先级=战斗结算框>商店>营地柜台+天赋树>设置面>三选一>迷雾锚定对；红线=只加断言零改旧屏、违例登记呈报不修（处置权归用户）；需求卡片=`design/research/需求卡片-旧界面呈现断言回补批-2026-10-07.md`（v1.1 grilling 三轮全裁——待裁点 0 项，WL 豁免边界/迷雾合成对最坏判据/时长闸 ≤2s/出口报告/06 遗留件登记全钉死；停机点 2〔对比度首跑存量违例/legend-node 结构首跑〕，T0-T4≈1.0d，worktree iter19-uibackfill）〔2026-10-08 施工已入库·**S1 停机态**——T1+T2 测点对 15→38 对（+23：battle_end 3/shop 5/camp 9/settings 2/curio 2/迷雾合成对 1，全 UiKit 常量实时求值）；**新对首跑暴露存量对比度违例 7 项**（结算 GP 账行 2.67:1/商店 legacy 行卡名 1.12:1/货架价签 1.46:1/营地铭牌副题 3.59:1/行价格 4.02:1/树分组头 2.67:1/工坊状态 3.00:1）——全量登记清单+修复建议案〔全现役常量换墨可落〕随出口报告呈用户裁，处置权归用户、批内零修（红线）；违例对在册=闸红登记存量形态，修复批落后自然转绿；T3 struct 13→15 根（legend/node 全真路径开合）首跑全绿 S2 未命中、WL 零新增；冒烟 840/0+run_all 17 套件持平；出口报告=`design/qa/iter19-uibackfill-exit-report-2026-10-08.md`；settlement_review 遗留件已在 06 登记落位〕。**卡③CI 预接线批Line truncated
-| 迭代 20 | （**空位待编**〔**2026-10-09 用户令：迭代 20/21/22 规划冻结**——先解决眼前问题，重启=用户直接发令〕——原头卡A 主菜单开局缺陷修复批已并入迭代 19 卡⓪〔2026-10-08 用户令：其为迭代 19 卡④的 T1 前置门且随同 goal 执行，归属随执行落位〕；候选 B-F 留档〔奇物改名/商店刷新收尾/C 三件/D 敌系/E 生涯/F 典检〕编入待用户点名） | —— | —— |
+| 迭代 20 | **专长实装批（奇物）**——需求卡片=design/research/需求卡片-专长实装批-2026-10-11.md（零待裁点已成立）；**2026-10-11 用户令编入**（=规划冻结的直接发令解锁，仅解迭代 20；21/22 冻结维持）。范围：T0-T10（效果引擎词表扩签/池结构案D 实装/专长 27 件换代/凭证五件/Boss 兑付换代〔已裁换代〕/状态账/断点扩容/MC 新基线/迁出行删除/空配置验收闸）；估时 ≈10-12d；内部 A/B/C 三段推进+段末汇报。候选 B-F 留档不变 | 需求卡片成文（Q1-Q3 全裁清零） | T0-T10 |
 | 迭代 21+ | **M4 数值批（**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 用户立规）