game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(迭代23-T7): 总收口——四闸全绿留痕+机械面文档七件+实现报告落档

Browse Source 
- 批末重闸全绿：冒烟 938/0+run_all 24 套+probe --click/--full+render_gate golden 0.00%+doc 三闸/熵增对基线零新增；MC 同种子配对 80 局逐位零漂移+锻造满配档方向性补充（30/80 局差）
- 机械面同步：roadmap 迭代 23 行入库态/entities.yaml forge_workshop 回填实态（impl+save_domain+currency）/06 状态+①② v0.6 措势订正/存档序列化 v1.6（forge_routes 落地态+v7 沿革）/07 ㉒ 目检节+版本行/game/README 批次段
- 实现报告=design/qa/iter23-实现报告-2026-10-12.md（代拍板追认单九条+GDD 反哺点三条+残留人闸）
- active.md 快照换代+状态记录 479/480
This commit is contained in:
DKChan committed 2026-10-13 01:21:56 +08:00
1 parent 2915f19c4b
commit 31e12c8813
8 files changed
+115 -19
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

design/gdd/06-待办清单.md
+2 -2
View File
@@ -116,11 +116,11 @@
#### 锻造工坊实装批 — 待办（冻结：迭代规划冻结中，重启=用户发令）（2026-10-09 随成文批登记，时名「武器锻造系统实装批」；2026-10-11 随系统更名换代）
**内容**：按 [锻造工坊](systems/跨局循环/锻造工坊.md) **v0.5** 定案口径实装（需求卡片输入=其「裁决结果清单」+「工作间内容清单」两节）——迁移面八项：① `meta.tres` forge_products 攻击/护甲两行改造为武器与护甲独立等级路线（生命行清退归「天赋树实装批」旧柜台退役——生命唯一入口=树脊柱生命线，2026-10-11 A① 裁；同表其余四行族零触碰）；② `hero.tres` 攻击类型/甲型两休眠轴启用（营地选中即写轴，既有预留位启用；一次冒险一个武器类型+一个甲型，营地免费切换、冒险开始后锁死）；③ `feats.tres` magic_vs_magic 死条件行——复活案作废（2026-10-11 核结：所属件魔网织者在素材库表二 27 件退役删除名单），随专长退役删行批消解，本批零触碰；④ 存档域新增三武器+三甲型等级与当前选中标记（**不设特效域**——2026-10-12 裁 6；开发阶段无迁移——旧档废弃口径随批登记存档序列化文档与 registry）；⑤ **满级特效本期不实装**（2026-10-12 裁 6：不开三条新参数位、不加效果类型词，扩展位留空，启用需另立项）；⑥ **敌方攻击类型轴填值（3b 裁连带，跨系统汇合点）**——敌方攻击单据 `attack_type` 按「未设置=默认 normal」填值使其参与克制矩阵查表（现役为 `""` 恒不查矩阵；`enemy.tres:527` 轴未开、全部 normal 档）：**执行面归敌人系统/战斗结算侧**，本批只登记需求与数值影响（全局平移主角受伤点数：穿重甲 −1、穿魔法护甲 +1，须进⑧配对读数验证）；排期与敌人系统/战斗结算侧协商（可同批做，也可先行）；敌方 attack_type 为敌方定义数据（与敌种名字/血量同批同时读写、无独立时序），填值归敌人系统/战斗结算侧自然推进；本批只按 3b 裁落结构面（矩阵查表现役已支持）（2026-10-12 订正：原「两批排期协商（可同批做，也可先行）」句删除——用户裁：时序问题不存在）；⑦ 术语登记——三型甲统一命名（轻甲/重甲/魔法护甲；**「魔法甲」系笔误不登记别名**）+ 工作间两区定名（武器锻造区/护甲锻造区）登记 registry entities.yaml；⑧ 数值验证义务=改前/改后同随机种子配对读数验证难度影响，统一调整归 M4 数值批。**解锁通道**：四条待解锁路线（长枪/法杖/重甲/魔法护甲）均走并联双通道（练满前一档 OR 一次性解锁价，互不影响、玩家自选），不设串联门槛。**前置**：17 裁点用户逐点裁决——**已清零（2026-10-12 B 组 15 点逐裁落文 v0.5；2c/5a 于 v0.4 结案）**。**关联（2026-10-11 换代）**：锻造工坊钥匙节点改无前置直接可点亮（2026-10-11 用户裁，原等级阈值前置作废）；树脊柱砍攻/护两线（攻防所有权切分——攻击唯一入口=武器路线、AC 唯一入口=甲路线，树侧落文归天赋树会话交接批）后本批=攻防数值唯一实装面；树结构换代（33→12）已随迭代 21 入库——本批④存档域 forge_routes 独立成域（已预登记存档序列化.md v7 计划行），无共域冲突（2026-10-12 订正：原「排期两批合并评估」语境随树批入库消失——用户裁：非裁点）。**前置信息（2026-10-12 用户裁定：不在本批考虑）**：3b 后现行数据三型成纯序（重甲正向 > 轻甲中性 > 魔法护甲负向，敌方现行无魔法攻击故暂无优势窗口）——系**后续开发改造的前置事实**，敌方攻击类型差异化与魔法护甲的正当性归后续批次（含 M4 在基础 AC / 解锁价上的取值）；本批只按统一伤害轴落结构与字段。
**内容**：按 [锻造工坊](systems/跨局循环/锻造工坊.md) **v0.6** 定案口径实装（需求卡片输入=其「裁决结果清单」+「工作间内容清单」两节）——迁移面八项：① **新建锻造路线行族**（forge_products 已随迭代 21 T5 整体退役、无改造对象——v0.6 事实订正：行族/访问器/购买面三处退役登记在册，本批新建而非改造；落位=新表 forge.tres〔ForgeTable〕，钥石定价历史考古 20/150%、provisional 投值归 M4 终值）；② **两根类型轴所有权移交**（默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档域 forge_routes+冒险开始参数面注入；一次冒险一个武器类型+一个甲型，营地免费切换、冒险开始后锁死）；③ `feats.tres` magic_vs_magic 死条件行——复活案作废（2026-10-11 核结：所属件魔网织者在素材库表二 27 件退役删除名单），随专长退役删行批消解，本批零触碰；④ 存档域新增三武器+三甲型等级与当前选中标记（**不设特效域**——2026-10-12 裁 6；开发阶段无迁移——旧档缺键补齐=初始持有态，v6→v7 空迁移；存档序列化文档与 registry 随批登记）；⑤ **满级特效本期不实装**（2026-10-12 裁 6：不开三条新参数位、不加效果类型词，扩展位留空，启用需另立项）；⑥ **敌方攻击类型轴填值（3b 裁连带，跨系统汇合点）**——敌方攻击单据 `attack_type` 按「未设置=默认 normal」填值使其参与克制矩阵查表（现役为 `""` 恒不查矩阵；`enemy.tres:527` 轴未开、全部 normal 档）：**执行面归敌人系统/战斗结算侧**，本批只登记需求与数值影响（全局平移主角受伤点数：穿重甲 −1、穿魔法护甲 +1，须进⑧配对读数验证）；敌方 attack_type 为敌方定义数据（与敌种名字/血量同批同时读写、无独立时序），填值归敌人系统/战斗结算侧自然推进；本批只按 3b 裁落结构面（矩阵查表现役已支持）（2026-10-12 订正：原「两批排期协商（可同批做，也可先行）」句删除——用户裁：时序问题不存在）；⑦ 术语登记——三型甲统一命名（轻甲/重甲/魔法护甲；**「魔法甲」系笔误不登记别名**）+ 工作间两区定名（武器锻造区/护甲锻造区）登记 registry entities.yaml；⑧ 数值验证义务=改前/改后同随机种子配对读数验证难度影响，统一调整归 M4 数值批。**解锁通道**：四条待解锁路线（长枪/法杖/重甲/魔法护甲）均走并联双通道（练满前一档 OR 一次性解锁价，互不影响、玩家自选），不设串联门槛。**前置**：17 裁点用户逐点裁决——**已清零（2026-10-12 B 组 15 点逐裁落文 v0.5；2c/5a 于 v0.4 结案）**。**关联（2026-10-11 换代）**：锻造工坊钥匙节点改无前置直接可点亮（2026-10-11 用户裁，原等级阈值前置作废）；树脊柱砍攻/护两线（攻防所有权切分——攻击唯一入口=武器路线、AC 唯一入口=甲路线，树侧落文归天赋树会话交接批）后本批=攻防数值唯一实装面；树结构换代（33→12）已随迭代 21 入库——本批④存档域 forge_routes 独立成域（已预登记存档序列化.md v7 计划行），无共域冲突（2026-10-12 订正：原「排期两批合并评估」语境随树批入库消失——用户裁：非裁点）。**前置信息（2026-10-12 用户裁定：不在本批考虑）**：3b 后现行数据三型成纯序（重甲正向 > 轻甲中性 > 魔法护甲负向，敌方现行无魔法攻击故暂无优势窗口）——系**后续开发改造的前置事实**，敌方攻击类型差异化与魔法护甲的正当性归后续批次（含 M4 在基础 AC / 解锁价上的取值）；本批只按统一伤害轴落结构与字段。
**归属**：[锻造工坊](systems/跨局循环/锻造工坊.md) 实装（跨 meta/hero/feats/存档/战斗开场参数五面）
**状态**：**已编入迭代 23**（2026-10-12 用户令——开工门=U0 发令；设计面 v0.6：17 裁点清零+完备性检查批〔现役基线换代/两轴所有权移交/术语登记完毕〕，commit f5215c7）
**状态**：✅ **已入库（2026-10-12，/goal+iter U0 开工单会话交付——T1 行族/T2 两轴移交/T3 写口族/T5 存档 v7〔序调先行：写口硬依赖〕/T4 注入链/T6 工作间 UI/T7 收口七提交；冒烟 938/0+run_all 24 套+重闸全绿+MC 同种子配对零漂移；实现报告=design/qa/iter23-实现报告-2026-10-12.md；残留人闸=实机目检工作间形态与购买交互〔07 在册〕；代拍板追认单+GDD 反哺点待用户）**
#### 玩家向显示名改名小批（局内三轴 + 临时 AC 状态）——跨循环名称冲突清偿（2026-10-12 用户逐裁，锻造工坊裁决会话续 8a 连带）
design/gdd/07-体验验证清单.md
+10
View File
@@ -209,6 +209,15 @@
- **装配不可变**：冒险中无任何换装入口（三选一/奖励节点/战斗内零替换交互——旧替换子交互已拆）。
- 验证方式：用户实机目检（本批自动闸外唯一人闸；能力验证半已由自动化闸覆盖=V1-V19）。
### ㉒ 锻造工坊工作间形态与购买交互（迭代 23 锻造工坊实装批随批登记——2026-10-12）
- **门与形态**：树上「锻造工坊」钥匙未点亮=锁定态（纯文案、无任何可交互购买路径）；点亮后工作间展开=武器锻造区/护甲锻造区两区并列，六路线行板（行名=件名+锻造：长剑锻造/长枪锻造/法杖锻造/轻甲锻造/重甲锻造/魔法护甲锻造；每行件名+Lv+解锁态+钮组）。
- **购买面**：已解锁路线「锻造 N 钥石」钮（几何价 20/30/45/67/101 逐级涨）；余额不足钮禁用；买后等级+1、行板即时刷新、钥石余额扣减。
- **解锁面**：待解锁路线双通道呈现——「练满长剑锻造 或 200 钥石直购」：长剑练满→长枪/法杖解锁钮消失可直接锻造（零收费）；或 200 钥石直购开；两通道互不影响（未练满可直购、直购后练满不重复收）。
- **选中面**：已解锁路线「选中」钮免费切换（当前路线=「当前」禁用态）；一次冒险只带一个武器类型+一个甲型；冒险开始后无切换入口（锁死）。
- **注入抽查**：营地选长枪→开局攻击类型=穿刺（对敌护甲查克制矩阵生效）；选重甲→入战 AC=12+路线加值；旧路线练度保留（换回即生效）。
- 验证方式：用户实机目检（本批自动闸外唯一人闸；能力验证半已由自动化闸覆盖=V1-V14）。
## 验收读数重测义务（履行留痕 + 现行义务）
**已履行**（按序换代，旧读数各随其批作废留痕不入本单）：①验收读数重测批（2026-09-19——Boss 单独出列/承伤带/通关率基线全量重测，硬化翻倍期·乏力死效果期·充能期旧读数作废）；②迭代 5 基线重测（统一随机流后 MC+verifier 双窗）；③**数值修复批新尺重测（2026-10-01）**——模拟档位重构后全量重测，新锚 `sim-data/runsum_numfix_final_n200_20261001.jsonl`，全旧带作废只测不判（numfix 报告（已退役，git 历史可查））；④**迭代 10 奖励重构批重锚（2026-10-01）**——四代锚 77000/78000/79000/80000（改前/重构后/共享池后/掷定前置后，各 400 局），普通 L1 41.8%/L2 10.2% 带内（迭代10通关率读数（已退役，git 历史可查））；⑤**T19 真人标定局收口（2026-10-03 用户裁）**——有效局 2（1 通关 1 死于 L3 首战，T19真人试玩读数（已退役，git 历史可查）），用户裁定**佐证级收口不再补局**；k 预期带同日立（**正常 >0.5、预警 <0.3**），字段随 81000 重锚入库后补算终值。
@@ -226,3 +235,4 @@
| v0.3 | 2026-10-09 | 版本历史表补建——本文件此前无版本表（2026-10-09 审查批呈报在案），本卫生批补建本表并补登上两行 |
| v0.4 | 2026-10-09 | **文档正确性审查批·独立复核（worktree docaudit-2026-10-09）**：①三处「链接语法但目标非路径」伪死链去链接改纯文本（numfix 报告/迭代10通关率读数/T19真人试玩读数——三份读数均已退役，git 历史可查口径不变）；②「难度修正批」批次名全替「数值批（Beta 阶段，未排期）」——与 06 现行归属称呼对齐（同批=M4 数值批需求卡片，未排期态不变） |
| v0.5 | 2026-10-10 | 生涯页呈现行柜台名扫改（2026-10-10 天赋树设计会话裁「道具工坊」改名「秘宝匣」）：「道具工坊已解锁 X/6 件」改「秘宝匣已解锁 X/6 件」；计数语义（旧六件→新目录）随实装批换代，见 06「天赋树结构重构批」改名连带面 |
| v0.6 | 2026-10-12 | 新增 ㉒ 锻造工坊工作间形态与购买交互目检节（迭代 23 锻造工坊实装批随批登记——V13 人闸观测项：门与形态/购买/解锁双通道/选中与锁死/注入抽查） |
design/gdd/systems/表现与支撑/存档序列化.md
+4 -3
View File
@@ -101,7 +101,7 @@ SaveManager 不依赖任何玩法系统就能工作：它是被动的承载方
| `adventure_total` | 冒险总局数终身计数（开局即计、含放弃与失败，v6） | [生涯](../跨局循环/生涯.md) |
| `adventure_cleared` | 通关局数终身计数（三关全通才计 1，v6） | [生涯](../跨局循环/生涯.md) |
| ~~`forge_levels`~~ | ~~属性锻造三档等级~~ | **已退役**（迭代 21 T5：行族/访问器/域随攻防所有权切分删除——`save_manager.gd:12-14/:399-401` 白名单收口；继任 = 锻造工坊路线等级域，见下行计划登记） |
| `forge_routes`（**计划新增**——锻造工坊实装批，v7；域名以实装批定名为准） | 三武器等级 + 三甲等级 + 当前武器/甲选中标记（各 1；无特效域；旧档破坏性废弃口径归该批） | [锻造工坊](../跨局循环/锻造工坊.md) |
| `forge_routes`（**已落地 v7——锻造工坊实装批 T5，迭代 23**） | {levels: 六路线等级（sword/spear/staff/light/heavy/ward）, unlocked: 直购解锁路线 id 清单, weapon: 当前武器路线 id, armor: 当前甲路线 id}；无特效域；旧档缺键补齐 = 初始持有态 | [锻造工坊](../跨局循环/锻造工坊.md) |
| `breakpoint` | 冒险断点快照（停点粒度续玩域；空字典 = 无断点合法态——「继续上局」隐藏） | [冒险结构](../冒险循环/冒险结构.md) |
v4/v5/v6 各域缺键由读取方按默认值补齐（空集合/0），旧档零迁移损失；收束自增域（通关次数/Boss 计数/终身计数）的唯一入账点 = `apply_adventure_summary`。
@@ -128,7 +128,7 @@ v4/v5/v6 各域缺键由读取方按默认值补齐（空集合/0），旧档零
### 版本与迁移
存档带版本字段（`version`，当前 = **6**；版本沿革：v2 = 断点域出生〔迭代 8 卡①〕→ v3 = 断点附随件扩列 + 摘要 keystone_drops〔迭代 10 奖励重构〕→ v4 = 同调批扩域〔boss_kill_count / attunement_equipped / attune_refresh_level，迭代 11 第①批〕→ v5 = 天赋树域〔tree_nodes / fork_sides，迭代 12〕→ v6 = 生涯终身计数域〔adventure_total / adventure_cleared，迭代 18 卡④〕；与 registry `schema_version` 同源）。**（计划）v7 = 锻造路线域**〔三武器/三甲等级 + 当前选中标记——锻造工坊实装批，2026-10-12 v1.5 预登记；届时旧档破坏性废弃口径归该批，禁迁移/折算〕。三条走向：
存档带版本字段（`version`，当前 = **7**；版本沿革：v2 = 断点域出生〔迭代 8 卡①〕→ v3 = 断点附随件扩列 + 摘要 keystone_drops〔迭代 10 奖励重构〕→ v4 = 同调批扩域〔boss_kill_count / attunement_equipped / attune_refresh_level，迭代 11 第①批〕→ v5 = 天赋树域〔tree_nodes / fork_sides，迭代 12〕→ v6 = 生涯终身计数域〔adventure_total / adventure_cleared，迭代 18 卡④〕→ **v7 = 锻造工坊域〔forge_routes，迭代 23 T5——已落地：{levels 六路线等级 + unlocked 直购解锁清单 + weapon/armor 当前选中标记}，无特效域；旧档缺键由 _normalize 按默认补齐 = 初始持有态（sword/light 在档、余四锁、选中=初始路线），v6→v7 空迁移 = 缺键补齐模式（v3→v4 先例）；开发阶段禁迁移禁折算——契约 4〕**；与 registry `schema_version` 同源）。三条走向：
| 情形 | 处置 |
|---|---|
@@ -136,7 +136,7 @@ v4/v5/v6 各域缺键由读取方按默认值补齐（空集合/0），旧档零
| 版本更高（未来版本的档） | **拒读且禁写**：不加载、后续写盘一律拒绝、内存以默认新档运行——保护未来版本的档不被当前版本覆写 |
| 版本更低（旧档） | 读档时逐级迁移：从旧版本起逐个调用注册的迁移函数升到当前版本；任一步失败按损坏兜底处理 |
迁移函数经 `register_migration(旧版本号, 函数)` 注册：函数把数据从「旧版本」改写成「旧版本 + 1」。生产迁移链现行五件（v2 起自注册）：v1→v2 = 断点域补空；v2→v3 = 断点附随件与摘要 keystone_drops 补键（读取方 .get 兜底）；v3→v4 = 同调三域补键；v4→v5 = 树域两键补齐（原挂接的「三体系迁移」体已随迭代 21 T5 攻防所有权切分删除——`save_manager.gd:96-98`、`meta_progression.gd:294-295` 实证；forge_levels 旧域同批清退，加载时按默认模型键集白名单收口，`save_manager.gd:399-401`）；v5→v6 = 生涯两终身计数域补零。任一步失败按损坏兜底处理。
迁移函数经 `register_migration(旧版本号, 函数)` 注册：函数把数据从「旧版本」改写成「旧版本 + 1」。生产迁移链现行六件（v2 起自注册）：v1→v2 = 断点域补空；v2→v3 = 断点附随件与摘要 keystone_drops 补键（读取方 .get 兜底）；v3→v4 = 同调三域补键；v4→v5 = 树域两键补齐（原挂接的「三体系迁移」体已随迭代 21 T5 攻防所有权切分删除——`save_manager.gd:96-98`、`meta_progression.gd:294-295` 实证；forge_levels 旧域同批清退，加载时按默认模型键集白名单收口，`save_manager.gd:399-401`）；v5→v6 = 生涯两终身计数域补零；**v6→v7 = 锻造工坊域 forge_routes 缺键补齐（迭代 23 T5——无结构迁移体，版本号推进仅为 schema_version 对齐；解锁态派生不落档：初始持有〔表 initial_owned〕∨ 直购〔unlocked 清单〕∨ 练满前一档〔levels[prereq]≥cap〕）**。任一步失败按损坏兜底处理。
### 损坏兜底
@@ -192,3 +192,4 @@ MVP 不要求本系统的闭环（[不做清单](../../05-不做清单.md)把单
| v1.3 | 2026-10-01 | **版本兼容口径批（迭代 10 追加批 g 裁——用户拍板：版本兼容对齐 semantic version 标准）**：①版本策略成文口径——本域版本号语义 = **向后兼容的次序版本**：升版只允许「旧档在新代码可读可玩可续玩」（缺新键=合法空态、内容零丢失、断点可续），禁「新档在旧代码可读」承诺（向前兼容不做）；②v2→v3 迁移体=空迁移（断点附随件扩列〔bonus_taken/bonus_pending/bonus_result/bonus_aux_carry/keystone_drops + bonus.ap 轴〕与摘要 additive 键 keystone_drops 均由读取方 .get 兜底——兼容性由冒烟 v1→v3 与 v2→v3 断点续玩断言承载，2026-10-01 增）；③中断节点兼容义务：每升版必须在冒烟断言「旧版断点→新版续玩受理」（现行三档 v1/v2/v3 齐） |
| v1.4 | 2026-10-09 | **文档正确性审查批·独立复核（worktree docaudit-2026-10-09——版本滞后四代换代，全部代码实证 save_manager.gd SAVE_FORMAT_VERSION=6）**：①数据模型 JSON 与域清单表换代 v2→v6——补 v4 同调三域（boss_kill_count/attunement_equipped/attune_refresh_level，迭代 11①）、v5 树域（tree_nodes/fork_sides，迭代 12）、v6 生涯两终身计数域（adventure_total/adventure_cleared，迭代 18 卡④）逐域 owner 行；②版本与迁移节换代——当前=6、迁移链五件（v1→v2…v5→v6，含 v4→v5 三体系迁移指路天赋树）；③调参表版本常量 2→6；④缺键补齐纪律句补记（读取方默认补零/空集合，收束自增唯一入账=apply_adventure_summary）。注：v3/v4/v5/v6 四次升版当时均未回写本文，本批一次性清偿 |
| v1.5 | 2026-10-12 | **锻造工坊完备性检查批随迁（用户令：新加内容现在补、不等实装批）**：①**预登记锻造路线域**（计划 v7）：域清单表 + 版本沿革补 `forge_routes`（三武器等级+三甲等级+当前选中标记、无特效域、旧档破坏性废弃归锻造工坊实装批；域名以实装批定名为准）；②**清偿 forge_levels 残留**——JSON 示例、域清单表删该域（代码侧已随迭代 21 T5 删除：`save_manager.gd:12-14/:399-401` 白名单收口）；迁移链 v4→v5 的「三体系迁移」体改述为已删除（`save_manager.gd:96-98`、`meta_progression.gd:294-295`）；③**补登两漏域**（代码实证 `save_manager.gd:119-139`）：`tree_struct`（树结构版本标记，迭代 21 T5，缺失=换代前结构加载废弃重置，owner 天赋树）、`first_adventure_done`（首冒险完成标记，新档默认 false、旧档缺省按已完成兜底，`meta_progression.gd:100` 置位，owner 元进度）；④消费面纪律句「读写锻造等级」→「读写树等级」（访问器已随行族退役删除）。版本号常量仍 =6（v7 未落地） |
| v1.6 | 2026-10-12 | **锻造工坊实装批随迁（迭代 23 T5——v7 落地）**：①域清单表 `forge_routes` 计划行→实际落地态（{levels 六路线等级 + unlocked 直购解锁清单 + weapon/armor 当前选中标记}，域内键名以实装批定名）；②版本与迁移节——当前 =7、迁移链补 v6→v7（空迁移=缺键补齐模式，解锁态派生不落档三通道）；③旧档口径订正——「破坏性废弃」→「缺键补齐 = 初始持有态」（开发阶段禁迁移禁折算纪律不变，契约 4）；④域界注记——forge_routes 属 meta 永久进度域（契约 2 反面清单不涉） |
design/qa/iter23-实现报告-2026-10-12.md
+66
View File
@@ -0,0 +1,66 @@
# 迭代 23 实现报告——锻造工坊实装批
> 日期：2026-10-12 ｜ 迭代：23（M3=Alpha 完整实现面）｜ 开工令：/goal + iter 技能 U0（用户目标=总收口全绿：冒烟/单测/探针/读数对拍四闸全过+实现报告落档）
> 需求卡片：`design/research/需求卡片-锻造工坊实装批-2026-10-12.md`（v1.2，Q1/Q2 已裁、零待裁点）
> 设计权威：`design/gdd/systems/跨局循环/锻造工坊.md` v0.6（17 裁点清零+完备性检查批，commit f5215c7）
> Worktree：`g-plan2-iter23-forge`（分支 iter23-forge-20261012，基点 b9cca33）｜ 批内提交：T0 定义入库 b9cca33 + T1 df666dd / T2 00d98b6 / T5 6def354 / T3 a6270ba / T4 ed06292 / T6 2915f19 / T7 收口笔
> 状态：**✅ 已全批入库（单会话交付）**——四闸全绿+重闸全绿；残留人闸=实机目检工作间形态与购买交互（07 ㉒）+代拍板追认单九项+GDD 反哺点三条待用户
## 一、开工检查结论（第 2 步）
- **门**：roadmap 迭代 23 行「开工门=U0 发令」——本会话 /goal 调用即 U0，门解。
- **待裁点**：卡片 v1.2 零阻塞待裁点（Q1=等级 0 起步+锻造第一级=首个 +1；Q2=provisional 沿锚表投值——均已裁）。
- **验收清单**：V1-V14 逐条三要素（测什么/怎么测/谁验）齐；V9（静态 grep 人工核对）与 V13（用户目检）为纪律类人工项，余自动闸。
- **自洽扫描两处 L2（记录继续，不触红线）**：①卡片 F8「meta 域 13 件」清单滞后——现行 15 键（vision_used 系迭代 22 T2 同日新增未及登卡），对 forge_routes 新域零影响；②卡片 F11「效果类型闭集 24 种」系 2026-10-07 设计文档事实快照——现行 31（迭代 20 T1 +7、迭代 22 T3 +1），本批零扩签，断言钉 31。另：06 条目①「forge_products 两行改造」系 v0.5 旧文（v0.6/卡片 F1 已订正为「行族已退役、新建行族」）——T7 机械面同步时订正。
- **T0 实查**：基线复读=冒烟 898/0+run_all 22 套+probe --click 全绿残留 0（存量 fx_reveal 已随 iter21 修复，零存量红）；buy_forge/forge_products 断言已随迭代 21 T5 全摘；hero 两轴读取面全清单（运行时 unit_container.gd:64 + 冒烟 smoke_all.gd:1901 + battle_orchestrator 间接消费 + README 文档面）；注入链探明（build_adventure_params → adventure params → set_* 族 → enc → spawn）。
## 二、任务卡状态（T0-T7）
| 卡 | 状态 | 交付要点 | 提交 |
|---|---|---|---|
| T0 前置实查 | ✅ | 基线三件套+F1-F13 事实核对+断言摘除清单+两轴读取面清单+注入链探明；定义面入库（b9cca33） | b9cca33 |
| T1 路线行族 | ✅ | 新表 forge.tres（ForgeTable：默认两轴+六路线行族）+ConfigDB 六访问器+单测 41 断言（V1 正反 22 类/V11 行字段闭集+词表 31 钉现/V2 价格梯） | df666dd |
| T2 两轴移交 | ✅ | hero.tres 两字段删除（schema 同步）+spawn 注入缝（空串=锻造配置默认值回退，行为逐位连续）+冒烟 4 断言（V5 前半） | 00d98b6 |
| T5 存档 v7 | ✅ **（序调先行——T3 写口硬依赖存档域）** | SAVE_FORMAT_VERSION 6→7+_migrate_v6_v7 空迁移+forge_routes 域（levels/unlocked/weapon/armor，无特效域）+访问器组+冒烟 V8 六断言（往返/v6 旧档补齐/键集/值拷贝） | 6def354 |
| T3 写口族 | ✅ | MetaProgression 锻造写口（forge_buy_level 几何价/forge_buy_unlock 一次性解锁价/forge_select_weapon·armor 免费选中/forge_route_unlocked 派生单点）+冒烟 V2/V3/V4/V6 共 15 断言 | a6270ba |
| T4 注入接线 | ✅ | hero_override 公式换代（FORGE_ROUTE_BONUS 退役）+build_adventure_params 两键+参数面快照（契约 8 锁死）+effective_ac 三层（甲型基础 AC+路线加值+局内）+enc→spawn 末端；冒烟 V5 后半/V6/V7/V10 共 15 断言 | ed06292 |
| T6 工作间 UI | ✅ | 占位面板→两区六路线行板（锻造/解锁/选中三钮+余额联动+锁定态零行板零购买路径）+presenter 三意图处理器+main 接线+新单测 forge_workbench_test 12 断言（V13 自动化前置面） | 2915f19 |
| T7 收口 | ✅ | 重闸全绿+MC 配对+机械面文档七件+本报告 | 收口笔 |
## 三、验证闸总账（批末重闸）
| 闸 | 结果 |
|---|---|
| 冒烟（run_smoke 三闸：退出码/摘要/脚本错误扫描） | **938 项检查 0 项失败**（基线 898/0 + 本批 40 断言：T2×4/T3×15/T4×15/T5×6） |
| 单元（run_all） | **24 套全绿**（基线 22 + forge_table_test 41 断言 + forge_workbench_test 12 断言） |
| 探针（probe_gate） | **--click + --full 全绿、残留 Godot=0**（ui_input/ui_struct/ui_contrast/click/ui_probe/ui_tune/t17_defer/fx_probe 八件） |
| 读数对拍（MC 同种子配对，verifier_batch adventure 段 na=40 seed0=9000 双画像） | **A) 改前 vs 改后白板：80 局同种子逐位零差异**（normal 0/40↔0/40 均关 0.10；perfect 28/40↔28/40 均关 2.42）——默认态行为连续零漂移铁证。**B) 方向性补充**：白板 vs 锻造满配档（atk+5/ac+5 同种子）80 局中 30 局结局变化（normal 0/40→1/40、perfect 28/40→33/40）——锻造加值注入面生效且方向正确（数值 provisional 归 M4） |
| render_gate（窗口化渲染闸） | **全绿**——shot_checker A-D 断言过 + 棋盘 golden 三屏 changed=0.00%（容差内） |
| doc 三闸（gdd_lint/doc_link/doc_term） | **对基线零新增**——gdd_lint 3 个存量红同款（06/07 表格占比、术语表，master 同）；doc_link 已知死链 1（存量）；doc_term 单 hit 存量（06:37 拔旗，非本批编辑区） |
| 熵增闸（repo_structure_audit） | **PASS**（四查全过） |
> 环境注记：render_gate 的 PIL 依赖需 gamedev venv（`PATH=/d/dev/python/envs/gamedev/Scripts:$PATH`）——WorkBuddy 裸 python 无 PIL；本机 Godot 4.7.2 路径 `D:\code\godot\Godot_v4.7.2-stable_win64_console.exe`。
## 四、代拍板追认单（白名单内，待用户追认）
1. **行族落位选型**：新表 `forge.tres`（ForgeTable）而非 meta.tres 内新行族——T2「锻造工坊配置表新建」与 T1 行族同表承载（默认两轴+六路线）；访问器连续性沿 treasure_items 先例（`db.forge_*`）。meta.tres 三行族零触碰。
2. **路线 id 命名**：sword/spear/staff/light/heavy/ward——甲路线 id=甲型值本身（ward=魔法护甲，3a 裁统一命名）；存档域 levels 六键同。
3. **存档域键名**：`forge_routes = {levels:{六路线→等级}, unlocked:[直购路线 id], weapon/armor:选中路线 id}`——unlocked 只记直购；初始持有（表 initial_owned）与练满前一档（levels[prereq]≥cap）为派生解锁不落档（解锁态派生单点=MetaProgression.forge_route_unlocked）。
4. **provisional 行值**：沿 T1 锚表投值（cap 5/每级增量统一 +1/基础价 20×150%^n=20/30/45/67/101/一次性解锁价 200/甲型基础 AC 10-12-9/初始持有 sword+light/前置 spear·staff←sword、heavy·ward←light）——Q2 已裁沿锚，终值归 M4。
5. **v6→v7 空迁移形态**：缺键补齐模式（v3→v4 先例）——无结构迁移体，_normalize 按默认模型补 forge_routes=初始持有态；幂等零漂移（冒烟断言）。
6. **执行序调整**：T5 存档域先于 T3 写口施工（写口族硬依赖存档域——不满足则 T3 无法落盘），台账记录。
7. **工作间行板布局**（程序占位）：件名+Lv+解锁态双通道文案+锻造/解锁/选中三钮横排；锁定态（钥匙未点亮）默认不可见+门控重建=零行板零购买路径（占位纪律延续，2026-10-11 用户令）；视觉终稿归 HUD 营地视觉批。
8. **V11 词表钉 31**：卡片 F11「效果类型闭集 24 种」系 2026-10-07 旧快照（现行 31）——L2 事实订正，断言钉现行数（将来加词即转红提示复核）。
9. **F8 域计数订正**：卡片「meta 域 13 件」实为 15 键（vision_used 迭代 22 T2 同日新增）——L2 事实订正，零需求影响。
## 五、GDD 反哺点（设计权威文档不动，逐点待用户裁决后另批落文）
1. **锻造工坊.md**：①「每条路线的内容·等级：1 → 上限」正文宜补 Q1「0=未练合法态」衔接表述（Q1 已在版本历史续裁行落文，正文未同步）；②「现役代码事实」表「效果引擎效果类型闭集 24 种」滞后（现行 31）；③实装边界 1「行族命名、字段结构与落表位置归实装批定义」已兑现（新表 forge.tres/ROUTE_IDS 六 id/12 字段闭集）——可回填实态句。
2. **元进度.md**：①「跨局注入」节四层公式宜补「甲型基础 AC=选中甲路线行 base_ac（effective_ac 第一层）」终态句（树 flat+锻造路线加值已实装）；②营地钥石入口族宜登记锻造三写口（forge_buy_level/forge_buy_unlock/forge_select_*——buy_forge 退役后的新族，契约 9 写口唯一）。
3. **术语表.md**：实现引入路线 id 与存档域内键名（levels/unlocked/weapon/armor）——非玩家可见术语，预计零新词；若需登记补登待裁。
## 六、残留人闸与遗留
- **残留人闸（07 ㉒，用户实机目检）**：工作间门与形态（锁定态零购买路径/点亮后两区六路线）/购买面（几何价逐级涨、余额禁用、即时刷新）/解锁面（双通道：练满派生零收费 vs 200 直购、互不重复收）/选中面（免费切换、当前态、冒险锁死）/注入抽查（选长枪=穿刺生效、选重甲 AC=12+加值、旧路线练度保留）。
- **遗留（在册不阻）**：①敌方 attack_type 填值（3b 裁连带）归敌人系统/战斗结算侧——本批只落结构面（矩阵查表现役已支持），06 在册；②全部数值 provisional 终值归 M4 数值批（未排期）；③满级特效本期不做（六路线扩展位留空——不开参数位/不加效果类型词/存档无特效域）；④工作间视觉终稿归 HUD 营地视觉批。
- **本批零触碰面**：meta.tres 三行族、克制矩阵九格、局内货架三行（奇物属性件）、天赋树、效果引擎词表（零扩签）。
design/registry/entities.yaml
+3 -2
View File
@@ -717,10 +717,11 @@ entities:
kind: 营地四柜台之三（树「锻造工坊」钥匙节点 free 无前置、点亮展开；未点亮 = 锁定态但配置常驻可读——默认值与解锁状态解耦）
routes: 六条独立等级路线——武器区 长剑锻造（普通/初始）/长枪锻造（穿刺/待解锁）/法杖锻造（魔法/待解锁）；护甲区 轻甲锻造（基础 AC10/初始）/重甲锻造（AC12/待解锁）/魔法护甲锻造（ward AC9/待解锁）；行名统一「件名+锻造」（8a 裁）
unlock_channels: 并联双通道——练满前一档 OR 一次性解锁价，互不影响、不设串联门槛（4b-1 裁）
currency: 纯钥石单币（5b 裁；几何递增定价历史考古参数 = 20 钥石/150% 公比——forge_products 行族已随迭代 21 T5 退役、无现役计价字段可沿，实装投值归 M4）
currency: 纯钥石单币（5b 裁；几何递增定价 provisional = 基础 20 × 150%^已购级数〔20/30/45/67/101〕/一次性解锁价 200/甲型基础 AC 10-12-9——迭代 23 T1 沿锚表投值，终值归 M4）
selection: 一次冒险 = 一个武器类型 + 一个甲型（1a 裁）；营地内免费切换、冒险开始后锁死（1b/1c 裁）
axis_ownership: attack_type/armor_type 默认值由锻造工坊配置常驻持有（默认值 = normal/light）、hero.tres 静态表两轴随实装删除；营地选中态写存档域、冒险开始经参数面注入（v0.6 订正——与现役「表运行期只读」纪律 meta_progression.gd:12-13/119 一致）
save_domain: forge_routes（计划 v7——三武器等级 + 三甲等级 + 当前选中标记；无特效域；旧档破坏性废弃归实装批；已预登记 存档序列化.md）
save_domain: forge_routes（已落地 v7——迭代 23 T5：{levels 六路线等级 + unlocked 直购解锁清单 + weapon/armor 当前选中标记}；无特效域；_normalize 缺键补齐 = 初始持有态（sword/light 在档余四锁），v6→v7 空迁移缺键补齐模式；旧档禁迁移禁折算——契约 4）
impl: 实装落位（迭代 23 实装批）——data/schemas/forge_table.gd + data/tables/forge.tres（ForgeTable：默认两轴常驻持有 + 六路线行族，ConfigDB.forge_* 访问器）· core/meta_progression.gd 锻造写口族（forge_buy_level 几何价/forge_buy_unlock 一次性解锁价/forge_select_weapon/armor 免费选中/forge_route_unlocked 派生解锁单点/forge_shop_status 投影）· presentation/views/camp_overlay_view.gd 工作间两区六路线行板（forge_buy/unlock/select_requested 三意图信号，契约 9 UI 只发意图）· core/save_manager.gd forge_routes 域读写访问器
red_lines: 攻防所有权切分——攻击唯一入口 = 武器路线、AC 唯一入口 = 甲路线、树零攻防来源（契约 9 红线）；局内无武器/护甲提升（货架三行 = 奇物属性件，现役显示名 攻击祝福/生命祝福/护甲祝福）
max_effect: 满级特效本期不做、只留扩展位（6 裁——不设计清单/不定值/不实装/不开参数位/存档不设特效域）
referenced_by: [元进度, 天赋树, 存档序列化, 术语表]