wip: T7 文档同步批（机械面七处+实现报告+active 470 记账——并入 master 前落盘）

active.md

@@ -22,12 +22,12 @@
 - **代拍板追认单十条已追认（2026-10-12 用户逐裁，06 在册）**：全数通过+连带裁定（血税保留/疼痛记忆「下场战斗」系笔误改「下一次攻击」/血税 desc 补生效时点修正案/流派=对外不显示对内保留事件族划分）；**V20/V21/V22 人工核对半+实机目检五件仍待用户**（07 在册；V23 配额数字已随②③追认闭环）。
 - **GDD 反哺点①-④全部落文（2026-10-12 用户逐裁令）**：①奇物.md v3.16+血税 desc fe0970d（冒烟 864/0）；②冒险结构.md v0.20（关卡大奖励=专长三选一按档配比加权+回血，提升池机制段移交奇物.md）；③难度曲线与Boss.md v0.28（投放读数只测不判，数值不动）；④02-系统清单.md v1.24（奇物行换代）；⑤归奇物呈现条（06 在册）。
 - **回补带出四条待裁点**（秘宝卡两条+天赋树卡两条不阻塞；专长卡 §10.4 已随追认闭环）。
-- **现行文档事实源**：秘宝.md v2.9+**奇物.md v3.16**+天赋树.md v0.8+**锻造工坊.md v0.5**（17 裁点清零定案，2026-10-12）+术语表 v1.8；迭代粒度规矩=迭代周期 ≈ 一周左右。
+- **现行文档事实源**：秘宝.md v2.9+奇物.md v3.16+**天赋树.md v0.8（迭代 21 已按此实装入库）**+锻造工坊.md v0.5+术语表 v1.8；迭代粒度规矩=迭代周期 ≈ 一周左右。
 
 ## 项目当前位置（2026-10-11 刷新；实时细节以根目录 `roadmap.md` 与 06-待办清单 为准）
 - **里程碑**：M3=Alpha 版本的完整实现（2026-10-09 立规：用户未明令宣布 M3 完成前停留 M3，迭代只排 M3 需求，M4 一律不排期）
-- **迭代**：迭代 19 五卡已入库（2026-10-08）；**迭代 20 专长实装批已入库（2026-10-11，goal 会话 U0 开工总收口）**；迭代 21=天赋树实装批、迭代 22=秘宝实装批已编入待开工（开工门=U0，用户发令）；M4=迭代 23+ 未排期
-- **近期主战场**：迭代 20 反哺落文批（待发令）+目检五件待人闸；迭代 21/22 按序待 U0 发令；文档治理连续批详情见 git 提交史
+- **迭代**：迭代 19 五卡已入库（2026-10-08）；迭代 20 专长实装批已入库（2026-10-11）；**迭代 21 天赋树实装批已入库（2026-10-12，goal 会话 U0 开工总收口）**；迭代 22=秘宝实装批已编入待开工（开工门=U0，用户发令）；M4=迭代 23+ 未排期
+- **近期主战场**：迭代 20 残留人闸（目检五件+V20/V21/V22 人工半）+**迭代 21 残留人闸（实机目检营地四柜台+实现报告反哺点六条/追认单十二条待用户）**；迭代 22 按序待 U0 发令；文档治理连续批详情见 git 提交史
 
 ## 未决面（进行中/待人闸/待裁点指针；现行事实源登记处=`design/gdd/06-待办清单.md`）
 - 待用户裁决：美术审计两项 P0（art-bible 死样张指涉+主角像素管线重产；06 在册）；filter-repo 计划书批准或放弃（06 在册）；去毒残留词扫否（魔法道具约 30 处/罕见约 18 处，呈报在案）；锻造工坊 17 裁点**已清零**（2026-10-12 B 组逐裁落文 v0.5，06 在册；实装批开工门只剩用户发令）；奇物呈现三处违规改法与档位呈现三路（06 在册）；喂雷流 R5 甲重启条件回落文（一句话件）；「通关 vs 通过第 N 关」全库口径统一 273 处（待裁是否补登记 06）；**迭代 20 反哺点②③④+目检五件**（追认单十条已清，2026-10-12）
@@ -45,3 +45,4 @@
 - **467（2026-10-11~12，锻造工坊裁决会话——更名批+A 组定案落文+handoff）**：①更名批 bafc556——系统名「武器锻造」→「锻造工坊」（用户令，与树上钥匙节点同名；文档改名，全库现行指路+06 实装批条名换代，历史记载保留）。②A 组定案批 8e78792（用户逐裁）：营地=四柜台并排（树淬炼/锻造工坊/秘宝匣/图鉴）、攻防独立柜台、工作间两区并列；生命档移除=生命唯一入口树脊柱；**攻防所有权切分=攻击唯一入口武器路线、AC 唯一入口甲路线，树零攻防来源红线**；锻造加值只按当前选中武器/甲生效；钥匙无前置直接点亮；2c 结案（magic_vs_magic 复活作废——mana_weaver 在素材库表二退役名单，与迭代 20 T0 核结一致）+5a 结案；存档域旧档废弃口径；道具工坊退役词清除。③属性审计=角色可增强数值轴就四根（hero.tres 三数值轴+命中树线），彩蛋前提随用户裁加同调位全解锁（树侧落文归天赋树会话——彼会话已三轮换代 v0.8 终态 12 节点）。④B 组 15 裁点挂起待发令，handoff prompt 已交付新会话；active.md 本会话期间被并行脏件占用未及登记，本条补登。
 
 - **469（2026-10-12，迭代 21 天赋树实装批开工）**：/goal+iter 技能调用=U0 开工令。开工检查全过：卡片 v1.7（73acee0 已入库）零阻塞待裁点——R1 按卡片既定默认=裁撤案执行（schema 只保留点亮前置），出口报告追认单列明；验收清单 V1-V23 三要素齐；自洽扫描 8 处事实抽查全符（33 行表/schema 词表/tree_buy 族/slots 谓词求值/存档 v6/_roll_gp_drop 挂点/:1116-1131 标错分支/结算=每轮末时序）。T0 四查结案：②聚乘算位=_roll_gp_drop() 返回表达式内（battle_orchestrator.gd:1461）；③锋=mine_hit 现成挂点零改、守=_flag_miss_seen 去重闸后（:1119-1121）grant_ap mode:queue 下轮 notify_round_start 兑现，末轮判出无下一轮=契约 12 作废态自动成立；④锻造工坊 v0.5 两节读取完成——本批预留 0 锻造加值位与「4a 前缓后陡/6 满级特效留扩展位」零冲突、钥匙 free 无前置一致；⑤基线复读=冒烟 864/0 但 run_smoke 判 FAIL（SCRIPT ERROR 51 行：_flush_pending_reveals 三处 _emit_row("fx_reveal","",...) 空 source_class 触发 :1592 行来源断言——a57489e9 迭代20 T1 落地件存量红，两轮确定性复现，本批内顺手修复+实现报告单列）+run_all 21 套全绿+probe_gate --click 全绿残留 0。定义面已入库（并行会话 73acee0 含 roadmap/06/卡片 v1.7）。主区残留脏件全属他批遗产零碰（.zcode hook 三件/锻造工坊.md v0.5 未提交/playnote/四 untracked）。worktree g-plan2-iter21-tree 开工，T1 起。
+- **470（2026-10-12，迭代 21 天赋树实装批总收口）**：T1-T7 全量交付（worktree g-plan2-iter21-tree，实现批+文档同步批两笔）。T1 schema 换代（FORK_GROUPS 4→3/RULE_KEYS 2→6/fork 单行双态 effects_a·b/row 退役门槛换轴/R1 裁撤案执行）+33→12 行重排（easter 摘攻防=契约 9）；T2 购买面（easter 拒购/Fork 解锁默认 A/零币切态/彩蛋特化判定）；T3 六键接线（EVENTS+flag_missed/FACTS+battle_index=L2 扩签两处/posture 窗双闸/sense 限次 counter 闸 domain:adventure/守侧去重闸后发射/聚入账前×1.5/散双计价点×80%——数值全 provisional 归 M4）；T4 注入换代（树淬炼 flat+锻造加值位预留 0/槽位判定源切树点亮数/ks_refresh 同账路由）；T5 删除批（migrate_tree/buy_forge 家族/forge_products 行族/forge_levels 域/attunement_growth 谓词表/生涯三投影全删；tree_struct=2 标记废弃重置禁迁移）；T6 四柜台并排（树=主界面/两钥匙门+零交互占位面板/图鉴常开/暂停层锻造段连带删）。存量红修复=fx_reveal 三处空 source_class（a57489e9 落地件，基线 51 行脚本错误清零）。验证：冒烟 886/0（V1-V10/V16 断言随批）+run_all 22 套（新增 V11 六键闭集单测）+probe --click 全绿（树购买/双态切换点击路径）+V19 MC 三组同种子配对×60 局（读数归验证记录）；守侧五场景=编排 rig（_judge_flag 直注）+引擎直构双承载。追认单十二条+反哺点六条+欠账三条（AP clamp/刷新软上限另立/Y 不入断点）落实现报告 design/qa/iter21-实现报告-2026-10-12.md 待用户；残留人闸=实机目检四柜台（V22）。

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

@@ -130,7 +130,7 @@
 
 **归属**：[天赋树](systems/跨局循环/天赋树.md) v0.8 实装（树结构换代+营地统一；跨 [锻造工坊](systems/跨局循环/锻造工坊.md)（工作间=其柜台改造对象，攻防数值唯一实装面在彼批）/ [元进度](systems/跨局循环/元进度.md)（注入通道与柜台退役面）/ [秘宝](systems/跨局循环/秘宝.md)（同调位求值与秘宝匣工作间）/ 数值批（命中值域与全部 provisional 数值））
 
-**状态**：待办（**2026-10-11 用户澄清：2026-10-09「先不要动」系暂缓口径、非全面冻结令——设计完成的批次即可做，本批不再以冻结为前置**；开工门=用户发令；**2026-10-12 完备性/跨系统歧义审查后：卡片侧零阻塞待裁点，只差 U0 发令**）。**需求卡片 v1.7（2026-10-12 完备性审查十一裁）**——在 v1.4→v1.6 三轮换代基础上新增裁决：①账号层攻/AC 空窗期**知情接受**（Alpha 开发阶段，不设过渡、不登记欠账）；②**守侧=失误补偿**（契约 12：触发主语=当回合标错动作非在场标错旗；单格最多一次；末轮不返）；③折扣（散）**只覆盖商品购买价格、不含刷新**，键名 `gp_cost_mult`（`cost_mult` 已被 `yield_mult` 占用），聚的乘算落**入账前**；④限次承载=`adventure_counters`+`domain:"adventure"`+关卡切换点清零（**不升 v7**）；⑤**开发阶段无视任何文档层条款**，不为本批增设豁免/例外条款；⑥**生涯页三投影整行删**（`forge_level`/`workshop_status`/`tree_nodes`——生涯不统计天赋树与账号成长态）；⑦三条登记欠账、本批不做=AP 上限 clamp / 三选一刷新软上限（另立待办）/ Y 不入断点；⑧§5 之外另查到的 42 处旧表述**不做清扫**（不做加法）。**需求卡片 v1.4→v1.6 连带换代（2026-10-11 攻防所有权切分+一线一节点+Fork一节点双态三轮）**：design/research/需求卡片-天赋树实装批-2026-10-11.md——结构目标 33→12 全卡换代（脊柱=生命/命中一线一节点×4 级、Fork=三节点双态〔购买解锁默认 A 态、零币切换、行持 a/b 双效果键〕）、锻造工坊钥匙前置改无、地脉共鸣条件效果换代、注入公式换代、营地呈现措辞对齐四柜台、行门槛平移节点等级（用户驳「合并破坏统计/门槛」之疑——节点等级可区分可计数，门槛主语=第 N 级）；T 估时复核 ≈7.0-8.0d（T1 下修，其余不动）；**开放待裁点 R1=schema「等级阈值前置」新形态去留（钥匙改无前置后现无消费者，推荐裁撤）**——裁决前不阻开工门（默认按裁撤案排程，用户推翻即先改文档）；2026-10-11 用户令整卡编入迭代 21（不切分）不变。**历史落卡记录（v1.1→v1.3）**：grilling 五裁全落（Q1 刷新升级双入口并存·秘宝侧重复后续审查轮用户自办/Q2 槽位数量树说了算+旧条件作废删除随批清扫/Q3 开发阶段无迁移·旧存档废弃重置·迁移需求整体删除/Q4 本批程序占位重排/Q5 转排期规则默认先行）；歧义扫描六裁（/grilling）已落 GDD v0.4：术语回归「危险格/安全格」/彩蛋三线/行门槛含全部节点/聚仅战斗掉落+散全消费面/限次生命周期/三处旧裁决换代（彩蛋三线后随 v0.6 攻防所有权切分换代为两线）；架构面结论=现有分层承载得住零重构，三处小扩〔schema 阈值前置形态（去留=R1 待裁）/效果引擎关卡域状态/营地呈现重排〕随批
+**状态**：✅ **已入库（2026-10-12，/goal+iter U0 开工——worktree g-plan2-iter21-tree 全量交付；T1-T6 代码批+T7 文档同步批，批末重闸全绿；实现报告=design/qa/iter21-实现报告-2026-10-12.md）**。R1 按卡片既定默认=裁撤案执行（schema 只保留点亮前置，未增设 requires_level），出口报告追认单列明。**登记欠账三条随批入册**：①AP 上限 clamp 缺位（树+AP 件+时沙同走 _pending_ap_delta 无上限——新叠加源使既有缺陷可观测化）；②三选一刷新软上限（停点内倍率增长×停点间基础价随进度递增，另立待办）；③Y（_attune_refresh_y）不入断点存档漏洞（用完退菜单再续玩满血复活——V15 仅验账本一致性，刷新链路可用性不受本批影响）。**需求卡片 v1.7（2026-10-12 完备性审查十一裁）**——在 v1.4→v1.6 三轮换代基础上新增裁决：①账号层攻/AC 空窗期**知情接受**（Alpha 开发阶段，不设过渡、不登记欠账）；②**守侧=失误补偿**（契约 12：触发主语=当回合标错动作非在场标错旗；单格最多一次；末轮不返）；③折扣（散）**只覆盖商品购买价格、不含刷新**，键名 `gp_cost_mult`（`cost_mult` 已被 `yield_mult` 占用），聚的乘算落**入账前**；④限次承载=`adventure_counters`+`domain:"adventure"`+关卡切换点清零（**不升 v7**）；⑤**开发阶段无视任何文档层条款**，不为本批增设豁免/例外条款；⑥**生涯页三投影整行删**（`forge_level`/`workshop_status`/`tree_nodes`——生涯不统计天赋树与账号成长态）；⑦三条登记欠账、本批不做=AP 上限 clamp / 三选一刷新软上限（另立待办）/ Y 不入断点；⑧§5 之外另查到的 42 处旧表述**不做清扫**（不做加法）。**需求卡片 v1.4→v1.6 连带换代（2026-10-11 攻防所有权切分+一线一节点+Fork一节点双态三轮）**：design/research/需求卡片-天赋树实装批-2026-10-11.md——结构目标 33→12 全卡换代（脊柱=生命/命中一线一节点×4 级、Fork=三节点双态〔购买解锁默认 A 态、零币切换、行持 a/b 双效果键〕）、锻造工坊钥匙前置改无、地脉共鸣条件效果换代、注入公式换代、营地呈现措辞对齐四柜台、行门槛平移节点等级（用户驳「合并破坏统计/门槛」之疑——节点等级可区分可计数，门槛主语=第 N 级）；T 估时复核 ≈7.0-8.0d（T1 下修，其余不动）；**开放待裁点 R1=schema「等级阈值前置」新形态去留（钥匙改无前置后现无消费者，推荐裁撤）**——裁决前不阻开工门（默认按裁撤案排程，用户推翻即先改文档）；2026-10-11 用户令整卡编入迭代 21（不切分）不变。**历史落卡记录（v1.1→v1.3）**：grilling 五裁全落（Q1 刷新升级双入口并存·秘宝侧重复后续审查轮用户自办/Q2 槽位数量树说了算+旧条件作废删除随批清扫/Q3 开发阶段无迁移·旧存档废弃重置·迁移需求整体删除/Q4 本批程序占位重排/Q5 转排期规则默认先行）；歧义扫描六裁（/grilling）已落 GDD v0.4：术语回归「危险格/安全格」/彩蛋三线/行门槛含全部节点/聚仅战斗掉落+散全消费面/限次生命周期/三处旧裁决换代（彩蛋三线后随 v0.6 攻防所有权切分换代为两线）；架构面结论=现有分层承载得住零重构，三处小扩〔schema 阈值前置形态（去留=R1 待裁）/效果引擎关卡域状态/营地呈现重排〕随批
 
 #### 秘宝体系实现重构落地批 — 已编入迭代 22（2026-10-11 用户令）（2026-10-10 用户令「文档层已改完，记录新设计的实现重构落地」登记）
 

design/gdd/07-体验验证清单.md

@@ -186,7 +186,7 @@
 ### ⑲ 生涯页目检（迭代 18 卡④生涯界面实装批·期一随批登记——主菜单新增一级只读页+存档 v6）
 
 - **入口与开合**：主菜单「营地与系统」组出现「生涯」钮（营地钮与设置钮之间）；点击开全屏页、点「返回」回主菜单（继续上局钮可见性随开合正确恢复）。
-- **页呈现六类九项**：组一·冒险战绩（冒险总局数 / 通关局数〔括注「三关全通」〕 / 各关通关次数〔一行三关，关名带层号〕 / Boss 首杀〔X/3 关〕 / Boss 总击杀）；组二·资源与成长（钥石余额徽 / 属性锻造已购合计 / 秘宝匣已解锁 X/6 件 / 天赋树已购概览）——数值与存档实况一致（对照：玩几局后总局数含放弃与失败、三关全通才计通关）。
+- **页呈现两类六项**：组一·冒险战绩（冒险总局数 / 通关局数〔括注「三关全通」〕 / 各关通关次数〔一行三关，关名带层号〕 / Boss 首杀〔X/3 关〕 / Boss 总击杀）；组二·资源（钥石余额徽）——数值与存档实况一致（对照：玩几局后总局数含放弃与失败、三关全通才计通关）。〔原「属性锻造已购合计」「天赋树已购概览」两观测项随生涯页三投影删除摘除——2026-10-12 用户裁⑧，天赋树实装批随批〕
 - **旧档载入**：v5 现役档（升级前存档）载入后生涯页正常显示，总局数/通关局数从 0 起计（终身计数域 v6 新增，缺省补零），钥石等既有进度原样。
 - **零跳转与局内零入口**：页内除「返回」外无任何前往他处的按钮；冒险进行中（战斗屏/关卡地图屏/暂停层）无生涯入口。
 - **对比度与零动效**：页文字亮墨族在深棕底上可读（机检 3 对已入 ui_contrast 闸）；开页/关页无过渡动画。

game/README.md

@@ -565,3 +565,15 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
 
 **换代面**：feats.tres 整表换代（旧 27 件退役→重设计 29 行=基础 27+迁入淬毒刃纹/封印爆裂——订阅行 on/when/do 四级 rarity+cap）；效果引擎词表扩签（事件 18/效果类型 30/事实 18/算子 +mod_eq——heal/ac_bonus/damage_reduce/bonus_delta/blast_scaled/preview_area/target_attack_bonus 七新类型+adventure 域计数器跨战账本）；池结构案D（四级档位 70/25/9/0=104+曝光槽 2+1+概率上限解耦案②+Boss 按档配比加权抽取）；凭证五件入池（刷新券 F-1 修复/储备金袋/同调电池〔choose_battery_target 玩家点选〕/时沙/完美保险）；流派标签/档位激活机制退役（FeatsEngine 求值摘除——HUD 特性段降级为逐件行，呈现改法归 06 在册奇物呈现条）。
 **验证**：冒烟 864/0+run_all 21 套+probe_gate 全绿；MC 同种子重放 30 局逐位复现；新基线 normal/off 100 局通关 0%（master 对照同为 0%=零配基线本相，止步分布 90/10→93/7 可归因曝光槽）。设计权威=奇物.md（反哺点清单见 design/qa/iter20-实现报告-2026-10-11.md）。
+
+## 2026-10-12 迭代 21 天赋树实装批（U0——需求卡片 v1.7；设计权威 = 天赋树.md v0.8）
+
+**结构换代 33→12 节点**：脊柱 2（生命/命中淬炼一线一节点 cap4——攻/护淬炼线随攻防所有权切分砍除，攻唯一入口=锻造工坊武器路线、AC 唯一入口=甲路线）+ 锻造脉 2（forge_workshop 钥匙 free 无前置 + easter_ley 彩蛋〔effects 摘攻/护分量〕）+ 钥石脉 2（秘宝匣/刷新升级）+ 同调脉 6（同调位 1/2/3——socket1 改根节点无前置 + Fork 3 单行双态）。schema 换代：FORK_GROUPS 4→3（fg_mastery 退役）/ RULE_KEYS 2→6 / row 字段退役（行门槛主语=节点第 N 级需全树总投入 ≥4×(N−1)）/ requires 只留点亮前置（R1 裁撤案执行）。
+
+**六键真效果**：开局姿态窗=每关首战首轮（FACTS 扩签 battle_index=关卡域战斗序）；危险直觉锋=踩雷减半·守=标错返还 AP（EVENTS 扩签 flag_missed、契约 12 去重闸语义）——两组每关限次（adventure_counters domain=adventure、按关重置）；财富之道聚=战斗掉落 GP 入账前×1.5、散=商品购买价×80%（双计价单点，刷新价不折）。数值全 provisional 归 M4。
+
+**退役删除**：属性锻造柜台全家（buy_forge/forge_flat/meta_forge_row/forge_products 行族/forge_levels 存档域/营地·暂停层·生涯三投影）；migrate_tree 三体系迁移（旧档=tree_struct 标记检测破坏性废弃重置，禁迁移折算）；attunement_growth 谓词表（同调位槽位判定源切树点亮数——Q2 裁甲）。
+
+**营地统一**：四柜台并排（树淬炼=树脊柱界面形态主界面/锻造工坊柜台钥匙门+零交互占位面板/秘宝匣柜台钥匙门+工坊六行+同调装配段+Y 升级行迁入/图鉴常开）；刷新升级双入口同账（树上 ks_refresh 路由 buy_attune_refresh）。
+
+**验证**：冒烟 886/0（基线 864/0+存量红修复——fx_reveal 三处空 source_class 补标签，a57489e9 落地件 51 行脚本错误清零）+ run_all 22 套（新增 tree_rules_v11 六键闭集校验）+ probe --click 全绿（树购买/双态切换点击路径换代）；V10 行为段=引擎直构+编排授予段直注（守侧五场景/聚散同种子配对/限次生命周期）。存量红修复与帐目细节见 design/qa/iter21-实现报告-2026-10-12.md。