并 master(dbc42b60): 迭代56批后收尾批(反哺落文/六件退役/待办登记两条)并入本分支

# Conflicts: # 待办清单.md
2026-11-09 03:22:56 +08:00
commit dffa119ad5
@@ -2,7 +2,7 @@

 > **一句话定位**：本文定义这个项目的 **Alpha 版本包含哪些东西**——它是里程碑 M3 的完成标准，也是判断"还差什么"的对照表。
 > **本文只列条目，不写内容**：每样东西是什么、规则怎么走，一律归各自的权威文档，本文只给指路链接。想知道某样东西的定义，请点链接，不要在本文里找解释。
-> **状态**：**已定稿（v1.30）**——2026-10-13 用户令定稿，历次升版明细见 git 提交史。Alpha 的内容范围自此冻结：增删条目一律须经用户裁决。
+> **状态**：**已定稿（v1.31）**——2026-10-13 用户令定稿，历次升版明细见 git 提交史。Alpha 的内容范围自此冻结：增删条目一律须经用户裁决。
 > **成文**：2026-10-13。

 ## 本文怎么用
@@ -39,7 +39,7 @@ Alpha 内以玩法循环本身的内容与表现为主（棋盘、关卡、战
 | 敌人系统 | [敌人系统](systems/战斗循环/敌人系统.md) | 在役 |
 | 增益状态 | [增益状态](systems/战斗循环/增益状态.md) | 在役 |
 | 地图战斗资源（格面资源） | [地图战斗资源](systems/战斗循环/地图战斗资源.md) | 在役 |
-| 战斗表现（动画与演出） | [战斗表现](systems/战斗循环/战斗表现.md) | 在役（Alpha 判据＝受击闪白／死亡不瞬间消失／高光行／逐行排播四条可读；正式演出设计与资产终稿排 Beta，不属 Alpha 完成判据） |
+| 战斗表现（动画与演出） | [战斗表现](systems/战斗循环/战斗表现.md) | 在役（Alpha 判据＝受击闪白／死亡不瞬间消失／高光／演出链兑现可读四条；正式演出设计与资产终稿排 Beta，不属 Alpha 完成判据） |

 ### 冒险循环

@@ -1,7 +1,7 @@
 # 战斗结算

 > 一句话：轮末结算的编排与逐行兑现
-> 状态：已定稿；现行为 v1.9
+> 状态：已定稿；现行为 v2.0

 ## 设计目的

@@ -77,14 +77,14 @@
 | 效果行 | 增益/减益段每条效果一行：本次授予贡献值与池合成值分列，防误读 |
 | 伤害行 | 每次伤害一行：目标、伤害分量、修正终值、击杀标记；吃护甲等级掷点的分量，掷点读数与折扣档位随行留档，nat20 暴击随行标记并金框高亮（行型封闭清单不变） |
 | 治疗行 | 治疗生效一行：封顶后的真实回复量 |
-| 奖励未生效行 | 满层拒收、满血治疗等合法例外一行 |
+| 奖励未生效行 | 四类合法例外一行，reason 键封闭（full_layers 叠层满拒收／full_hp 满血零兑／no_enemy_alive 场上无敌可打／hero_down 主角倒下整体不兑）；封印作废行已退役（封印受理即揭示，无作废产生面） |
 | 封印未中行 | 封印落空的零值归因行，每颗雷只记一次；标错的负向兑付另记效果行 |
 | 施放行 | 敌人本拍施放增益技——0 伤害动作、具名技能、不掷不折（蓄力语义 = 纯攻击增益技，见[敌人系统](敌人系统.md)） |
 | 衰减行 | 到期临时效果移除一行 |
 | 判定行 | 胜 / 负 / 继续各一行；终局判定行同时是胜负画面的数据锚 |
 | 高光行 | 完美封印成立时一行，只记实际有效兑付 |

-每行还携带公共字段：来源类别、来源格、轮次、显示名、数值，以及可空的高光标记（用于强调封印标中、清图奖励这类值得高亮的结果）。**显示名等玩家可见文案是数据面字段：文案值登记在数据表行，代码按来源类别与效果身份读表拼行，不在代码里写死文案字串**（2026-11-06 用户裁——文案归属数据表承载；承载表与字段形态归表结构设计段定，设计闭合后由实装批落表）。奖励直伤行的数值字段沿用 `effectiveness` 键名、值为整数点数——键名与量纲是数据导出与分析工具的兼容契约，改动须连动分析工具面。没生效也要留痕：两类"未生效"行如实记录合法例外，呈现时聚合计数，不逐行刷屏。
+每行还携带公共字段：来源类别、来源格、轮次、显示名、数值，以及可空的高光标记（用于强调封印标中、清图奖励这类值得高亮的结果）。**显示名等玩家可见文案是数据面字段：文案值登记在数据表行，代码按来源类别与效果身份读表拼行，不在代码里写死文案字串**（2026-11-06 用户裁——文案归属数据表承载；承载表与字段形态归表结构设计段定，设计闭合后由实装批落表）。奖励直伤行的数值字段沿用 `effectiveness` 键名、值为整数点数——键名与量纲是数据导出与分析工具的兼容契约，改动须连动分析工具面。没生效也要留痕：奖励未生效行如实记录四类合法例外（reason 键封闭：full_layers／full_hp／no_enemy_alive／hero_down），呈现面按 reason 归因（聚合计数呈现已随明细带退役）。**日志落盘零文案：text 与 display_name 不落盘**，玩家可见文案仅呈现面消费。

 任何一行找不到来源即断言失败——宁可返回错误，也不让"合并到看不出来源"的呈现混过数据层。但有些行天然没有棋盘来源，断言为此留了两层豁免，豁免集合是封闭清单，改动同样走本文修订。

@@ -1,7 +1,7 @@
 # 战斗表现

 > 一句话：战斗动画与演出
-> 状态：范围草案（待设计）；现行为 v1.3
+> 状态：范围草案（待设计）；现行为 v1.4

 ## 设计目的

@@ -50,7 +50,7 @@

 战斗屏是挖掘与结算两种形态共用的同一张屏：常驻双舞台（白话：战斗画面与扫雷图同屏常驻，像同一块屏上的两个舞台），结算期不切换场景，裁决与理由见 [battle.md 布局决策 1](../../../ux/battle.md)。所以战斗表现的工作不是另做一个战斗场景，而是在既有呈现上叠加动画密度与演出——这是本系统范围边界的第一条。

-"发生什么"与"怎么动"因此分了工：敌人死亡是血条归零后灰化加碎裂退场、禁止瞬间消失，结算明细带逐行滚动，完美封印与封印标中有高光行强调——这些呈现语义已由 battle.md 与 HUD 框架定稿，本文不复述。本文将来承接的只是其上的动画密度：受击反馈、弹道、退场动画等类别。
+"发生什么"与"怎么动"因此分了工：敌人死亡是血条归零后灰化加碎裂退场、禁止瞬间消失，结算演出链逐拍兑现（明细带逐行文字已退役），完美封印与封印标中有高光强调——这些呈现语义已由 battle.md 与 HUD 框架定稿，本文不复述。本文将来承接的只是其上的动画密度：受击反馈、弹道、退场动画等类别。

 资产侧同理，这也是双舞台带来的管线约束：若舞台形态悬而未决，同一份角色资产可能因舞台不同而重画。现行解法是剪影跨舞台通用——角色剪影按"棋盘、结算画面与任一战斗舞台通用"设计，不为舞台未决问题付重画成本（art-bible §5.1）。

@@ -96,7 +96,7 @@

 ### 演出服从信息与可读性

-两条现行硬约束，将来任何动画方案都禁止越过。其一，数字可读性高于氛围：挖掘期画面无杂音，动画禁止遮挡数字、禁止在挖掘期抢焦；结算期的色彩与能量走向以 art-bible 第 2 节为权威。其二，结算逐行兑现是信息载体：battle.md 已承诺不可整体跳过、只提供减动效选项（时长减半或直达终态，逐行兑现可加速不可省略），本文将来兑现其动画侧。
+两条现行硬约束，将来任何动画方案都禁止越过。其一，数字可读性高于氛围：挖掘期画面无杂音，动画禁止遮挡数字、禁止在挖掘期抢焦；结算期的色彩与能量走向以 art-bible 第 2 节为权威。其二，结算演出链是兑现呈现（非文字信息载体——明细带逐行文字已退役）：battle.md 已承诺不可整体跳过、只提供减动效选项（时长减半或直达终态，演出可加速不可省略），本文将来兑现其动画侧。

 ### 结算演出与轮间节奏（已实装）

@@ -148,7 +148,7 @@ MVP 不要求本文的闭环：不做清单把战斗动画演出列为 MVP 打
 - 挖掘期零打扰：结算演出只发生在结算期；挖掘期不因动画新增运动元素，数字可读性不受影响。
 - 因果可读：玩家看完一段兑现演出，能说出这一行结算来自他刚才的哪一步操作。
 - 死亡可辨：敌人死亡瞬间可辨识，不存在"敌人凭空消失"的观感。
- 可访问：逐行兑现不可被整体跳过；减动效档下全部演出有时长减半或直达终态的通路。
+- 可访问：结算演出不可被整体跳过；减动效档下全部演出有时长减半或直达终态的通路。

 ## 待办

@@ -269,7 +269,7 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
 - 悬停光标三语义（移动 / 挖 / 封印）随目标切换并高亮目标格；悬停已开格画出合法路径（不可达不显示）；可挖域常驻呼吸微光。
 - 一帧内意图整批到达，停手点击终结当帧收集。
 - 每次拒绝可感知：棋盘面、资源面、相位三类各有呈现且前两类可区分；停手被改判（本轮已清图）玩家可感知；拒绝反馈图标加文案双通道。
- 结算逐行实时滚出且每行带来源标注；未生效类行聚合计数并带形状冗余；零值行不被吞；效果行的单次贡献与池合成值分示、禁相加误读。
+- 结算演出链逐行兑现（FX 载体——明细带逐行文字已退役）；零值行不被吞（语义在日志面：step 行零删减）；效果行的单次贡献与池合成值分示、禁相加误读。
 - 高光三档：封印标中行金框、清图奖励行金框、完美封印全屏喝彩级——庆祝不打在空兑现上（首份即零兑付则不发高光）。
 - 状态槽显示图标加层数加剩余结算次数，悬停见来源；极性按键级表呈现（金满框 / 红缺框），空态整排隐藏、数据框上移补位；战斗结束全清有微文案。
 - 敌人呈现（站桩立绘，载体 = 无框立绘+底座）：意图占位 = 本拍摇定结果的动画占位（敌人技能池三档可见性——普通攻击零表示、特殊技类型级提示〔攻/防系两型〕，不预告技能名与数值、池与权重不公开）且挖掘期全程可见、映射跨局恒定、顺位可读、血量数字可读、敌方共享层数各立绘同值（血条悬浮头顶、状态小图标挂血条正下方）；死亡灰化加碎裂退场（禁止瞬间消失）且就地更新不丢灰化态。
@@ -2,7 +2,7 @@

 > **Status**: Complete（现行）
 > **Author**: user + ux-designer
-> **Last Updated**: 2026-11-07
+> **Last Updated**: 2026-11-09
 > **Platform Target**: PC (Steam)——Keyboard/Mouse 主（全部操作纯鼠标可完成）、Gamepad Partial 非 MVP、Touch None（同 technical-preferences）
 > **上游修订依赖**: 弃图刷新挖掘期受理依赖上游现行规则（行动经济 Active 受理 + 每轮上限 2 次、排雷玩法 Active·仅刷新路径装板、战斗结算的挖掘期刷新编排 + 恒同盘不变、系统索引的刷新规则同步——见布局决策 4 与 OQ11）
 > **Template**: UX Spec
@@ -197,7 +197,7 @@
 | B | 主角站桩立绘 | 站桩（无框立绘+落影） | HP 条落底盘（2026-10-06 方案二拍板：站桩排式 = **立绘→血条→状态**，全场血条对齐一线；血条嵌石板位、台缘线留作地面线；不悬浮头顶——高盒下血条-立绘空洞，用户点名否决）、状态效果小图标一排挂血条正下方（形状+色相双通道、层数角标；空态不占位退化为空行）——**HP 与状态效果的唯一展示面（2026-09-26 信息归属拍板；悬停 tooltip〔来源+语义+剩余结算次数〕职责在本组件）**；攻击值等规划数据仍归 C 区数据框（2026-09-20 全站桩拍板，英雄卡退役） | 悬停状态小图标看 tooltip | HUD 视图拆分改造 |
 | B | 敌人站桩立绘 ×1–3 | 站桩（无框立绘+落影） | 血条+顺位徽标落底盘（同主角排式，2026-10-06 方案二；**大体档〔显示 >150px 级：drider/duergar_king〕允许向上溢出盒顶 N px（N 由实装实算，溢出判定与背景无关），血条仍落底**）、状态小图标挂血条正下方（敌方增益按个体呈现——各立绘只显示它自己名下的状态实例〔蓄力/硬化/削弱/暴走/警觉，2026-11-02 个体化裁〕；数据源 = 战斗结算流水经增益状态投影，敌人系统×4④；无行为环点〔proposal §2.4〕，意图占位 = 本拍摇定结果的动画占位——普通攻击零表示 / 特殊技类型级提示，**意图徽标悬浮头顶上方，探顶档压胸**，敌方增益〔蓄力/硬化〕入状态图标行）；死亡灰化加碎裂退场直接演在立绘上（2026-09-20 全站桩拍板，敌人卡退役）；血条下名字行 = 纯名字 + 护甲类型图标（形状+色相双通道，与状态图标同行共存，状态空时为纯名字），AC 数值不展示——2026-09-26 终裁（用户口径：HP 信息已足够，攻防数值不直接写上；护甲类型图标保留克制对策可读性——类型可读、数值隐藏） | 只读 | 新建 |
 | B | 轮次·阶段指示 | 标签 | "第 N 轮 · 挖掘中/结算中"（终局定格「战斗结束」；Boss 变体附 Boss 名） | 只读 | 新建 |
-| B | 结算明细带 | 滚动列表 | 结算期逐行流水（[战斗结算](../gdd/systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋) 9 类行协议）；挖掘期收起为上轮摘要 1 行 | 无明细回看——带保留单行摘要，冒险中回看归「生涯」 | 改造 |
+| B | 结算明细带 | 摘要位＋叙述行 | 逐行流水文字呈现已退役（2026-11-07 用户裁）：挖掘期显示上轮摘要 1 行与冒险叙述行，结算期空带＋FX 排播链承接演出；流水协议保留在数据面（[战斗结算](../gdd/systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋) 9 类行协议，供日志落盘与回放对账） | 无明细回看——带保留单行摘要，冒险中回看归「生涯」 | 改造 |
 | B | 结算明细回看（已退役） | —— | 冒险中回看归「生涯」；回看覆盖层为未接线遗留件（待办清单登记） | —— | 未接线 |
 | C | 攻击数据框 | 直角细线数据框 | 攻击值 + 修正来源角标 + 护甲 AC（AC 二轮拍板 2026-09-26 补入——我方 AC 唯一展示面；HP 与状态归 B 区站桩、RAP 归 D 区右栏，不在本组件） | 只读 | HUD 视图拆分 |
 | C | 秘宝槽 | 图标槽 ×4 | 四槽壳在役、空槽占位（标题「秘宝」，悬停「秘宝槽（空）」）；局内两步使用与关卡域库存随秘宝过渡形态退役——现行秘宝 = 营地同调装配件（秘宝.md），本区展示重接归装配面 | 悬停 tooltip | 已实装 |
@@ -361,7 +361,7 @@
 | State / Variant | Trigger | What Changes |
 |---|---|---|
 | **挖掘阶段（默认态）** | 轮次开始 / 结算完毕回 Active 相位 | B 区敌人待机（意图徽标全程可见——敌人系统 Rule 8⑤），D 区棋盘可交互，左右行动资源侧栏点亮；能量 2/10，唯悬停呼吸微光在动（§2.1） |
-| **结算阶段** | round_end 触发（AP 尽/停手/清图） | D 区锁输入（棋盘去饱和 + 金橙色相偏移，明度不变，数字保持全对比）；B 区播放五段编排演出（授予段 → 增益/减益段 → 战斗段 → 衰减段 → 判定段，战斗结算 段序冻结）；明细带按结算期档展开（高读 `log_band_h_settle`）逐行滚动；阶段指示→"结算中"；能量 7/10 |
+| **结算阶段** | round_end 触发（AP 尽/停手/清图） | D 区锁输入（棋盘去饱和 + 金橙色相偏移，明度不变，数字保持全对比）；B 区播放五段编排演出（授予段 → 增益/减益段 → 战斗段 → 衰减段 → 判定段，战斗结算 段序冻结）；明细带按结算期档展开（高读 `log_band_h_settle`）——settle 态空带＋叙述行承载，零逐行文字；阶段指示→"结算中"；能量 7/10 |
 | **清图瞬间** | 全部安全格开完 | 金粒喷泉 + 彩纸 3–5s 即收（§2.3）；清图奖励行强调呈现（H2，地图战斗资源×④——金框高亮行）；随后换新图 install |
 | **完美封印高光** | 战斗结算高光判定（全图标中/零误标类） | 全屏喝彩级反馈（§2.2 最高档）：金光带加倍扫射 + 「完美封印 ×2」横幅——P2 爆发兑现节点（创意风险 #2 落点） |
 | **封印标中高光** | 封印判定·标中 | 该印记化暴击弹道加重 + 明细行金框——chord 缺席的即时兑现补偿（创意风险 #3 落点） |
@@ -436,7 +436,7 @@
 | 状态图标行全清（战斗结束） | 状态逐枚化光收回（B 区站桩图标行）+ 「状态随战斗结束消散」微文案 | 增益状态×4④；RAP 不在本行清空（整局冒险保留） |
 | 胜利 | 蜡封自上落下弹跳定格 → 碎砖拼纹章 → overlay 暖金渐显 | §2.4 克制不狂欢 |
 | 失败 | 全屏明度不变转暮蓝色相 → 印记化光点 800ms 逐枚收回 → overlay | §2.5 最静一拍 |
-| 减动效选项 | 上述全部动画提供时长减半/直接跳终态开关（基线权威 = HUD框架「可访问性基线」节；开关承载 = 设置面——2026-09-27 拍板不另立无障碍专项文档） | 动议：结算逐行兑现为信息载体不可整体跳过，可加速 |
+| 减动效选项 | 上述全部动画提供时长减半/直接跳终态开关（基线权威 = HUD框架「可访问性基线」节；开关承载 = 设置面——2026-09-27 拍板不另立无障碍专项文档） | 动议：结算演出不可整体跳过，可加速 |

 ---