DKChan
1460cf9077
补 42d64ec2／17ef0180 两笔漏掉的两件执行层：
一、版本历史行（22 个文档各一行，doc-conventions R4 与项目惯例要求每批改动落行）
00 v1.4／01 v1.10／02 v1.28／03 v1.4／05 v1.5／08 v1.11／关卡节点地图 v1.9／
冒险结构 v0.23／难度曲线 v0.30／战斗结算 v0.30／排雷玩法 v0.7／行动经济 v0.14／
存档序列化 v1.10／教学引导 v0.6／元进度 v1.22／天赋树 v0.12／秘宝 v2.5／
锻造工坊 v0.11／camp v1.6／settlement-summary v1.4／shop v1.2／术语表 v1.14
（奇物.md 已于前批加 v3.20，不重复）
二、06 新建两条（pipeline_gate PASS：06 条目 63）
「定名传导遗留二项」（来源=会话提及，设计面=文档轨）：
①增益状态.md 用「账」指战斗内状态容器——经用户确认与「系统资源」不是同一个
东西，仅用词冲突；改名与否（候选：容器／状态池）与连带范围待用户裁
②art/ 两处＋entities.yaml 三处 GP 更名已在分支 gpsweep-20261019 改完但未合回
master，合并归用户另会话，本批不代做
「代码注释旧称二处」（来源=会话提及，设计面=工程直入，状态=待写卡）：
adventure_table.gd:21/:24 注释仍写「资源类」；kind 字面是账名不是分类名，
数据零改动，只改注释两处；按用户令等建需求卡片
坑：06 状态行写「金币分支」触发 doc_term（「金币」退役 2026-10-18，该行无日期
白名单信号）→ 改「GP 更名分支」；06 现状段引述退役词带日期信号，合规放行。
闸：worktree 内 run_all_gates.sh --docs 验收通过，对基线零新增红。
47 lines
6.4 KiB
Markdown
47 lines
6.4 KiB
Markdown
# 结算总结 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）
|
||
> 相邻：[battle.md](battle.md)（战斗屏出口锚与信息归属两原则）/ [level-clear.md](level-clear.md)（关卡结算屏——Boss 胜利走大奖励面，非本 spec）/ [level-map.md](level-map.md)（GP 常驻徽章）
|
||
|
||
## 定位
|
||
|
||
本 spec 承载两个**已实装**的结算总结呈现面（2026-09-27 用户拍板定名，接线登记 06 状态记录）：
|
||
|
||
- **战斗总结结算**——冒险模式普通战斗胜利时的总结覆盖层（战斗小循环的出口呈现）；
|
||
- **冒险总结结算**——冒险终结（倒下 / 末关通关 / 放弃）时的终局覆盖层（冒险大循环的收束呈现）。
|
||
|
||
两面是两个循环层级的事，各成一节互不混写。本 spec 纯呈现：不定义任何机制，数据锚与归属全部指路上游文档。
|
||
|
||
## 战斗总结结算（战斗胜利面）
|
||
|
||
- 触发：冒险模式战斗胜利（verdict=win）含 Boss 胜利——迭代 10 起 Boss 胜利也经本面（钥石逐杀掉落增量在此呈现，确认后进[关卡结算屏](level-clear.md)三选一面；原「Boss 胜利走大奖励面不经本面」口径随大奖励重构退役）。非 Boss 接线 2026-09-29 迭代 8 卡⑥。
|
||
- 载体：battle_end_overlay 胜利形态（金蜡封）。
|
||
- 呈现内容（2026-09-27 拍板面 + 迭代 10 扩）：金蜡封 + 判定行 + 战利品行（GP 增量 + 总量；Boss/精英击杀追加**钥石增量行**——首杀/复杀档位读 meta.tres boss_keystone）+「下一节点」钮（明细回看入口已随 2026-10-04 P-C7 退役——冒险中回看归「生涯」）。
|
||
- 数据锚：增量 = `battle_finished` 载荷 `gp_dropped`；总量 = runner.gp 现值（LevelRunner 入账先于呈现连接——次序依赖在案，M-1 迭代 2 T5 接线）。
|
||
- 出口：「下一节点」→ 关卡画面选路（零自动推进）。
|
||
|
||
## 冒险总结结算（冒险终结面）
|
||
|
||
- 触发：主角倒下（verdict=lose）/ 末关通关 / 玩家放弃——三结局同面（`adventure_finished` 收束）。
|
||
- 载体：与战斗面同一个 battle_end_overlay（2026-09-29 迭代 6 T7 接线）——末关通关走 `open_victory`（金蜡封 +「本局 GP 入账 · 合计 N」行，GP 收束清零前的呈现侧影子账）；倒下 / 放弃走 `open_defeat`（暮蓝）。无独立「冒险终局面板」实体，06 状态记录旧称随本条完成。
|
||
- 呈现内容：冒险摘要五件事（定义归[冒险结构](../systems/冒险循环/冒险结构.md)）+ 钥石写入明细（= 本局逐杀 Boss 掉落合计；消费归[元进度](../systems/跨局循环/元进度.md) settle_adventure——迭代 10 起大奖励面不再产钥石）+ GP 合计行。
|
||
- 出口：确认 → 回存档首页。
|
||
|
||
## 口径
|
||
|
||
- **命名（2026-09-27 拍板文本口径）**：战斗总结结算 / 冒险总结结算。历史变体退役清单（正文一律改用正名）：①「战斗结算画面」——battle.md 旧口径（06 归属行已判登记偏差）；②「结算画面」单用——两义词（level-clear 语境=冒险面、battle 旧语境=战斗面），禁用；③「战斗胜利总结结算」——level-clear 与 06 状态记录旧用四字变体；④「摘要结算画面」——冒险结构 旧称（冒险总结结算的摘要呈现位）；⑤「冒险终局面板」——06 状态记录对同一 overlay 冒险面打开形态的俗称，无独立实体。06-待办清单 现状段按其「措辞不改」体例保留历史原文，以本清单为命名准绳。
|
||
- **GP / 钥石呈现分工**（battle.md OQ14 完成口径 + 迭代 10 扩）：GP = 本 spec 战斗面（增量+总量）+ 关卡画面常驻总量；钥石 = 本 spec 战斗面（Boss/精英击杀增量行，迭代 10 起）+ 冒险面（收束明细）+ 营地存量。钥石多处并存系「进账时刻 / 收束明细 / 存量可用」不同义，不构成重复展示（level-clear.md OQ3 完成维持）。
|
||
- **失败面不呈战利品**：冒险总结结算不呈现 GP 增量（倒下即终语义，失败侧恒不呈现）。
|
||
- **禁重复展示**：本面不呈状态效果、不呈结算明细正文（明细回看 overlay 已随 P-C7 退役——冒险中明细回看归「生涯」）——[battle.md](battle.md) 信息归属两原则（循环限定 + 单一展示面）对面级呈现同样适用。
|
||
|
||
## 版本历史
|
||
|
||
| 版本 | 日期 | 改动 |
|
||
|---|---|---|
|
||
| v1.0 | 2026-09-30 | 首版落文（审计拍板点 2 用户裁决：丙案两面分节 + 纯呈现轻量 spec——成文已实装显示规则，无新概念；命名三名并存收口为拍板文本口径） |
|
||
| v1.1 | 2026-10-01 | **钥石呈现接线批注记（迭代 10 奖励重构——呈现侧 spec 先行，实装随批）**：战斗面触发扩 Boss 胜利（钥石逐杀掉落增量行上战斗总结结算框——契约「钥石增量一面承载」推荐案）+ 呈现内容补钥石增量行；冒险面钥石明细口径改「本局逐杀 Boss 掉落合计」；GP/钥石分工口径三面化（战斗面增量/冒险面明细/营地存量）。原「Boss 胜利不经本面」退役 |
|
||
| v1.2 | 2026-10-09 | 文档正确性审查批：明细回看入口两处订正——已随 2026-10-04 P-C7 退役（冒险中回看归「生涯」；battle_end_overlay review_pressed 已退役在码），战斗面呈现内容与禁重复展示条同步 |
|
||
| v1.3 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 8 处——台账×4→状态记录（定位节接线登记条/冒险面载体条「06 状态记录旧称」/命名清单③⑤）；收口×4→完成（冒险面载体条「随本条完成」/命名清单头「历史变体收口清单」→「历史变体退役清单」/GP钥石分工条 OQ14 完成口径与 OQ3 完成维持）；头注状态行版本号随本行对齐 |
|
||
| **v1.4** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「钥石入账明细」→ 钥石写入明细——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|