Merge branch 'closure-iter37b-20261026':迭代 37 结项补记——拆件后 design/ 行号引用改指现址+两处文档版本头换代(--docs 域闸绿,回执 e62bb84c)

域判定:diff 仅 design/ 三份 GDD 与根体验验证清单.md,零 game/ 代码、零行为变化 ⇒ 文档域档(--docs)。
修因:迭代 37 压行/拆件使 design/ 内多处 文件:行号 指针指错代码(08d 只查越界、查不出范围内漂移)。
改动:生涯.md 三处指针(摘要组装配点/ relics 行/ main 收束处理)、锻造工坊.md 一处(GP 开局清零落点)、settlement-summary.md 事实源三指针;锻造工坊 v0.8→v0.9、settlement-summary v1.3→v1.4;体验验证清单迭代 37 段退役词「对拍」改「逐项比对」。
This commit is contained in:
DKChan committed 2026-10-26 00:54:23 +08:00
commit 0ebe2a9fe6
4 files changed
+8 -8

No files matched your search

+3 -3
View File
@@ -47,7 +47,7 @@
### 历史冒险回看(期二)
数据面现役事实:每局冒险收束时已有逐局摘要自动入档——`recent_summaries`(默认域 `save_manager.gd:116`、值拷贝访问器 `:316`、入账原语 `:325-338` 逐局插最前并按上限截断),上限 `SUMMARY_CAP := 10`(`:40`)。摘要字段在冒险收束时组装(`adventure_runner.gd:1005-1018`:结局 result、通关关数 levels_cleared、止步关 stopped_at、钥石合计 keystone_total、本局主种子 master_seed,另附逐杀掉落 keystone_drops 与终局专长持有集 relics(存档键名沿用历史形态)等);摘要的内容口径 owner = [冒险结构](../冒险循环/冒险结构.md),本文不复述其口径。
数据面现役事实:每局冒险收束时已有逐局摘要自动入档——`recent_summaries`(默认域 `save_manager.gd:116`、值拷贝访问器 `:316`、入账原语 `:325-338` 逐局插最前并按上限截断),上限 `SUMMARY_CAP := 10`(`:40`)。摘要字段在冒险收束时组装(`adventure_runner.gd:812-826` 的 `_settle`:结局 result、通关关数 levels_cleared、止步关 stopped_at、钥石合计 keystone_total、本局主种子 master_seed,另附逐杀掉落 keystone_drops 与终局专长持有集 relics(存档键名沿用历史形态)等);摘要的内容口径 owner = [冒险结构](../冒险循环/冒险结构.md),本文不复述其口径。
2026-10-06 用户裁(P2 甲):每局一行摘要,行内给**结局 / 到达关卡 / 钥石收入 / 用时**四件事,上限存最近 N 局。对应三件实绩(本批代码级复核确认的缺口,非新建数据面):
@@ -57,7 +57,7 @@
单局结算明细回看:遗留件 `settlement_review_overlay.gd`(`game/presentation/views/`,文件本体在盘、全仓无实例化引用——仅 `ui_kit.gd:356` 样式注记提及)由期二实装批复活承接,改挂生涯(2026-10-06 用户裁 P5 甲)。
可选增强(不占期、不上列):关键构筑列——摘要已附终局专长持有集 relics(`adventure_runner.gd:1017`——存档键名沿用历史形态),实装期评估是否呈现。
可选增强(不占期、不上列):关键构筑列——摘要已附终局专长持有集 relics(`adventure_runner.gd:825`——存档键名沿用历史形态),实装期评估是否呈现。
### 图鉴(期三)
@@ -71,7 +71,7 @@
|---|---|---|
| 营地([camp UX spec](../../ux/camp.md)) | 跨局成长**操作**面(花钥石买强化 / 装配 / 点树)+ 底栏「最近冒险」条带——`camp_overlay_view.gd:431` `_rebuild_recent()` 逐局拼行(`:442`「完成/放弃/失败 · 通关 N 关 · 钥石 +N · 种子 N」,无截断上限),数据源 = `camp_shop_presenter.gd:85` 投影的同一份 `recent_summaries` | 营地不改生涯只读定位;生涯不做任何购买入口,也不放「去买」按钮。营地条带的去留是本提纲必答项——见 §五 P6 |
| 状态面板(迭代 17 卡③,并行批开发中) | **局内**只读查看这一局进行中的钥石与本局冒险进度 | 状态面板看当局当前值,生涯看跨局累计与历史;局内无生涯入口(P4 甲) |
| 结算屏([settlement-summary UX spec](../../ux/settlement-summary.md)) | 冒险收束当下的入账明细——`main.gd:537` `_on_adventure_finished` 收束时呈现摘要与钥石明细(复用终局面账行,`battle_end_overlay.gd:118-129`) | 收束当下的呈现保留不动;生涯承接的是收束之后的任意时刻回看 |
| 结算屏([settlement-summary UX spec](../../ux/settlement-summary.md)) | 冒险收束当下的入账明细——`main.gd:408` 的 `_on_adventure_finished`(实体在 `main_adventure_flow.gd:84`)收束时呈现摘要与钥石明细(复用终局面账行,`battle_end_overlay.gd:118-129`) | 收束当下的呈现保留不动;生涯承接的是收束之后的任意时刻回看 |
| 帮助手册(Beta 批,未实装——教学内容归 Beta 帮助手册,`ui_assembler.gd:99` 注记) | 讲「怎么玩」 | 生涯讲「我玩过什么」。图鉴条目文案与手册是否共用内容源,接口登记归 Beta 批一并裁 |
| 图例面板(legend_overlay) | 局内符号/徽标即时解码 | 不合并——图例是局内解码面,图鉴是跨局收集面 |
@@ -1,7 +1,7 @@
# 锻造工坊
> 一句话:营地的武器与护甲成长——武器锻造区三条路线、护甲锻造区三条路线各练各的,钥石消费,一次冒险各选一件,满级特效留位本期不做
> 状态:**v0.8 迭代 21 反哺④残余写入文档(2026-10-13)**——「树侧钥匙」句换代:钥匙节点 forge_workshop 已随迭代 21 实装在役(free 无前置、点亮展开本柜台、锁定态零购买路径),原「实装归待办清单」悬置指针终结。承 v0.7 迭代 23 反哺写入(2026-10-13)——正文补 Q1 等级语义衔接(0 = 未练合法态)、效果类型闭集 24→31 订正、实装边界 1 回填实装实态(已随迭代 23 入库)。承 v0.6 完备性检查批(承 v0.5 B 组定案——**17 裁点全数清零**:1 丙 / 1a 一次冒险一件武器+一件甲 / 1b 营地可换·战斗禁换 / 1c 免费 / 2a 伪裁点消解 / 2b 随 3a 消解 / 3a 魔法护甲统一命名 / 3b 敌方攻击缺省普通·克制反向当下生效 / 3c 每型独立路线 / 4a 前缓后陡 / 4b 锻造内自闭环 / 4b-1 并联双通道 / 5b 纯钥石 / 5c 零材料 / 6 满级特效本期不做留扩展位 / 8a 工作间两区定名;2c、5a 已于 v0.4 结案)。**v0.6 变更(2026-10-12 完备性检查批·grilling 用户逐条裁)**:现役事实基线换代(forge_products 行族已随迭代 21 T5 退役、定价参数改历史考古口径);**两根类型轴所有权移交**(默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档+参数面注入);「与秘宝混合制同构」与「激活穿刺系专长」两处无依据表述订正删除。**满级特效本期不做**(只留扩展位);全部数值 provisional,终值归 Alpha 收官 M4 数值批〔未排期〕;实装已随迭代 23 入库(2026-10-12)
> 状态:**v0.9(2026-10-26 迭代 37 结项:实现载体行号引用改指现址,规则与数值零变化);承 v0.8 迭代 21 反哺④残余写入文档(2026-10-13)**——「树侧钥匙」句换代:钥匙节点 forge_workshop 已随迭代 21 实装在役(free 无前置、点亮展开本柜台、锁定态零购买路径),原「实装归待办清单」悬置指针终结。承 v0.7 迭代 23 反哺写入(2026-10-13)——正文补 Q1 等级语义衔接(0 = 未练合法态)、效果类型闭集 24→31 订正、实装边界 1 回填实装实态(已随迭代 23 入库)。承 v0.6 完备性检查批(承 v0.5 B 组定案——**17 裁点全数清零**:1 丙 / 1a 一次冒险一件武器+一件甲 / 1b 营地可换·战斗禁换 / 1c 免费 / 2a 伪裁点消解 / 2b 随 3a 消解 / 3a 魔法护甲统一命名 / 3b 敌方攻击缺省普通·克制反向当下生效 / 3c 每型独立路线 / 4a 前缓后陡 / 4b 锻造内自闭环 / 4b-1 并联双通道 / 5b 纯钥石 / 5c 零材料 / 6 满级特效本期不做留扩展位 / 8a 工作间两区定名;2c、5a 已于 v0.4 结案)。**v0.6 变更(2026-10-12 完备性检查批·grilling 用户逐条裁)**:现役事实基线换代(forge_products 行族已随迭代 21 T5 退役、定价参数改历史考古口径);**两根类型轴所有权移交**(默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档+参数面注入);「与秘宝混合制同构」与「激活穿刺系专长」两处无依据表述订正删除。**满级特效本期不做**(只留扩展位);全部数值 provisional,终值归 Alpha 收官 M4 数值批〔未排期〕;实装已随迭代 23 入库(2026-10-12)
> 成文底稿:提案过程稿《提案-武器锻造系统-2026-10-07》(**已退役**——中间产物吸收即死,2026-10-22 删除;全部备选案与淘汰依据、用户原案逐条对照已逐条落进本文,结论不依赖过程稿;**满级特效候选池已于 2026-10-21 迁入本文「满级特效扩展位」节**;考古=git 历史——删除批 603eba31,删除前全稿见历史版本 f958a03f)
## 设计目的
@@ -145,7 +145,7 @@
| 甲效矩阵 normal 行取值:轻甲 0 / 魔法护甲 +1 / 重甲 −1(整数点数:+1 被克 / 0 中性 / −1 挡住) | `settlement.tres:31-47` |
| 敌方攻击类型轴**未开**——单据 `attack_type` 栏现役为 `""`(空串恒不查矩阵,`""` 与"群伤/反噬/地形/敌方技"同列无类型族);`enemy.tres` 登记「敌方技能攻击类型轴仍未开(全部 normal 档)」 | `damage_controller.gd:19/:550-552`、`enemy.tres:527` |
| 效果引擎效果类型闭集 **31 种**(原记 24 系 2026-10-07 旧快照——迭代 20 T1 +7、迭代 22 T3 +1,2026-10-13 迭代 23 反哺写入订正;冒烟断言钉 31,将来加词即转红提示复核) | `effect_engine.gd` |
| 营地消费货币=钥石(现役入口 tree_buy / buy_attune_refresh → spend_keystone——buy_forge 随 forge_products 退役删除);GP=局内一次性货币,开局清零不入存档 | `meta_progression.gd:175/:354`、`adventure_runner.gd:116` |
| 营地消费货币=钥石(现役入口 tree_buy / buy_attune_refresh → spend_keystone——buy_forge 随 forge_products 退役删除);GP=局内一次性货币,开局清零不入存档 | `meta_progression.gd:175/:354`、`adventure_runner.gd:100` |
## 实装边界(执行归实装批,本文只登记方案)
+2 -2
View File
@@ -1,7 +1,7 @@
# 结算总结 UX spec(settlement-summary)
> 状态:v1.3(2026-10-15 简明技术中文用语规范(用户令)批:词面修正 8 处——两面分节、纯呈现轻量 spec 不变;无新概念)
> 事实源:`game/presentation/views/battle_end_overlay.gd`(胜利金蜡封 / 失败暮蓝双形态载体)+ `main.gd`(胜利接线 main.gd:398 调试与迭代 8 卡⑥冒险主路径 / 冒险终局接线 main.gd:339-346)
> 状态:v1.4(2026-10-26 迭代 37 结项:事实源行号引用改指拆件后现址,呈现设计与规则零变化;承 v1.3(2026-10-15 简明技术中文用语规范(用户令)批:词面修正 8 处——两面分节、纯呈现轻量 spec 不变;无新概念))
> 事实源:`game/presentation/views/battle_end_overlay.gd`(胜利金蜡封 / 失败暮蓝双形态载体)+ `main.gd`(胜利接线:调试 `main.gd:455-461`、冒险主路径 `main_adventure_flow.gd:165`;冒险终局接线:`main_adventure_flow.gd:19` 的 `adventure_finished.connect`)
> 相邻:[battle.md](battle.md)(战斗屏出口锚与信息归属两原则)/ [level-clear.md](level-clear.md)(关卡结算屏——Boss 胜利走大奖励面,非本 spec)/ [level-map.md](level-map.md)(GP 常驻徽章)
## 定位
+1 -1
View File
@@ -399,7 +399,7 @@
## ㉟ 迭代 37——缺陷定点修+结构重构四卡实机目检总清单(2026-10-25 随批后收尾登记)
> 四卡=卡① 行为缺陷定点修+卡②③④ main 判离/boardview 拆件/runner 拆件与断点 schema 单点(等价重构),玩法语义零变化,但动了呈现装配与商店/三选一接线。机检已覆盖撤销证明、断点 27 键逐键对拍与双树原始面逐字节比对;真机上「看着是否与改前一致」仍要人眼看。登记不阻塞(2026-10-12 真人检测立规);总收口时点=迭代 37 实现报告(已退役,git 可考)。
> 四卡=卡① 行为缺陷定点修+卡②③④ main 判离/boardview 拆件/runner 拆件与断点 schema 单点(等价重构),玩法语义零变化,但动了呈现装配与商店/三选一接线。机检已覆盖撤销证明、断点 27 键逐键比对与双树原始面逐字节比对;真机上「看着是否与改前一致」仍要人眼看。登记不阻塞(2026-10-12 真人检测立规);总收口时点=迭代 37 实现报告(已退役,git 可考)。
| # | 目检项 | 判据 |
|---|---|---|