S4-07 process 1

2026-03-11 10:18:14 +08:00
parent 52f9e212b9
commit 9de2e50262
32 changed files with 803 additions and 194 deletions
@@ -130,8 +130,8 @@
 | [x] | S4-03 | 先固化 Tag 系统设计与首发范围       | `docs/TagSystemDesign.md`<br>`docs/CodeX-TODO.md`                                                                                    | Tag 的来源、汇总、生效与首发集合口径固定      |
 | [x] | S4-04 | 实现组件实例 Tag 的统一生成入口      | `Assets/GameMain/Scripts/Definition/`<br>`Assets/GameMain/Scripts/CustomComponent/PlayerInventory/`                                  | 掉落、商店、初始种子、事件奖励共用同一生成结果     |
 | [x] | S4-05 | 实现组塔后的 Tag 汇总与展示入口      | `Assets/GameMain/Scripts/Definition/`<br>`Assets/GameMain/Scripts/CustomComponent/PlayerInventory/`<br>`Assets/GameMain/Scripts/UI/` | 组件 Tag 可汇总为塔级结果，且 UI 展示口径一致 |
-| [ ] | S4-06 | 实现首批基础 Tag 的战斗生效        | `Assets/GameMain/Scripts/Entity/`<br>`Assets/GameMain/Scripts/Components/`<br>`Assets/GameMain/Scripts/Definition/`                  | 首发 6~8 个基础 Tag 至少完成一批可验证效果，且战斗入口与状态运行时结构可继续扩展 |
-| [ ] | S4-07 | 补齐 Tag 规则与数据表的映射关系      | `Assets/GameMain/Scripts/DataTable/`<br>`Assets/GameMain/Scripts/Definition/`                                                        | 表字段不是只存在而未被消费，Tag 参数可配置可解释  |
+| [x] | S4-06 | 实现首批基础 Tag 的战斗生效        | `Assets/GameMain/Scripts/Entity/`<br>`Assets/GameMain/Scripts/Components/`<br>`Assets/GameMain/Scripts/Definition/`                  | 首发 6~8 个基础 Tag 至少完成一批可验证效果，且战斗入口与状态运行时结构可继续扩展 |
+| [~] | S4-07 | 补齐 Tag 规则与数据表的映射关系      | `Assets/GameMain/Scripts/DataTable/`<br>`Assets/GameMain/Scripts/Definition/`                                                        | 表字段不是只存在而未被消费，Tag 参数可配置可解释  |

 > 2026-03-09 更新：`InventoryRarityRuleService` 已落地；塔品质计算与组件品质归一化已统一收口，`PlayerInventoryTowerAssemblyService`、`ShopFormUseCase`、`EnemyDropResolver`、`InventorySeedUtility` 已接入同一规则入口。你已确认 Unity Test Runner 中 `Assets/Tests/EditMode` 全部通过，其中包含新增的 `InventoryRarityRuleServiceTests`。
 >
@@ -143,9 +143,11 @@
 >
 > 2026-03-10 更新：`S4-06` 已完成第一段落地。战斗链现在已从旧的 `damage + AttackPropertyType` 入口提升为携带 `TagRuntimeData[]` 的命中载荷；`AttackPayload`、`HitContext`、`TagEffectResolver`、`EnemyTagStatusRuntime` 已接入主命中链。当前已实际生效的基础 Tag 为 `Fire`、`Ice`、`Crit`、`Execution`：其中 `Fire` 已改为独立 DOT 公式，并按 `EnemyEntity` 每帧提供的 `deltaTime` 连续结算；`Ice` 已有独立减速状态；`Crit` 与 `Execution` 已进入命中前数值修正。状态类 Tag 已按“每个 Tag 各自配置文件、状态文件、效果文件”的方式拆开，`EnemyTagStatusRuntime` 只负责按激活 Tag 动态 Tick，不再持有具体 Tag 字段。
 >
-> 2026-03-10 更新：当前 `S4-06` 仍未整体完成。`Shatter`、`Inferno`、`AbsoluteZero` 仍处于“已注册但 no-op 占位”的状态；`BurnSpread`、`IgniteBurst`、`FreezeMask`、`Pierce`、`Overpenetrate` 仍只有分类与占位路由，没有实际战斗效果。因此当前仓库状态应视为“首批 4 个基础 Tag 已进入战斗，首发 7 个 Tag 尚未收满”，而不是 `S4-06` 全量完成。
+> 2026-03-10 更新：`S4-06` 已补齐首发剩余 3 个 Tag。`Shatter` 已接入命中前数值修正链，并按“目标已减速”口径增伤；`Inferno` 与 `AbsoluteZero` 已按首发方案作为 `Fire` / `Ice` 的强化 Tag 落地，分别增强 DOT 时长/伤害与减速时长/强度；对应 EditMode 测试已同步补齐。`BurnSpread`、`IgniteBurst`、`FreezeMask`、`Pierce`、`Overpenetrate` 仍保持分类与占位路由，没有实际战斗效果，因此仍属于后续扩展，不计入 `S4-06` 当前完成标准。
 >
 > 2026-03-10 更新：`S4-07` 仍未开始正式收口。当前 Tag 参数仍主要承载在代码侧 `TagConfigRegistry` 与各 Tag 配置类中，`Tag.txt` / DataTable 仍只提供基础字典与 `MinRarity` 输入；文档中约定的 `TagRule` 表、触发阶段、权重、效果参数等尚未形成 DataRow 与运行时消费闭环。因此 `S4-07` 继续保持未完成状态。
+>
+> 2026-03-11 更新：`S4-07` 已进入第一阶段实现。当前已新增 `TagConfig.txt` 与 `DRTagConfig`，`ProcedurePreload` 会在加载 `TagConfig` 表后驱动 `TagConfigRegistry.LoadFromRows(...)`，把 `TriggerPhase`、`Description` 以及首发 7 个 Tag 的配置参数从表覆盖到运行时强类型 `TagConfig`。`ItemDescForm` 也已开始消费该配置说明；塔详情会优先使用 `TagRuntimes` 构建 `Ice x2` 这类叠层展示。因此 `S4-07` 不再是“完全未开始”，但当前仍只完成了 `TagConfig` 级别的参数映射与 UI 消费，尚未把文档中的完整 `TagRule`（如权重、生成规则等）全部收口。

 ### S4-01 边界结论

@@ -177,10 +179,11 @@
 ### S4 当前进度结论（2026-03-10）

 - `S4-02 ~ S4-05` 已完成，品质、组件实例 Tag 生成、塔级 `TagRuntimeData` 汇总、以及 UI 展示口径都已收口。
- `S4-06` 已完成第一阶段：战斗链已支持 Tag 透传与统一结算，`Fire`、`Ice`、`Crit`、`Execution` 已有可验证效果，状态类 Tag 的内部结构也已从集中字段改为注册式运行时。
- 当前 `S4-06` 的未完成部分集中在首发剩余 3 个 Tag：`Shatter`、`Inferno`、`AbsoluteZero`。它们虽然已进入 `TagType`、配置类、注册表和占位效果类，但还没有实际战斗语义。
+- `S4-06` 已完成：战斗链已支持 Tag 透传与统一结算，正式首发 7 个 Tag `Fire`、`Ice`、`Crit`、`Execution`、`Shatter`、`Inferno`、`AbsoluteZero` 均已有可验证效果。
+- `Shatter` 已接入命中前数值修正链；`Inferno`、`AbsoluteZero` 已按“强化现有 `Fire` / `Ice` 状态”的首发口径落地，状态类 Tag 的内部结构继续保持注册式运行时。
 - `BurnSpread`、`IgniteBurst`、`FreezeMask`、`Pierce`、`Overpenetrate` 已进入分类与配置骨架，但仍属于后续扩展，不计入当前 `S4` 的完成标准。
- `S4-07` 仍未开始正式实现。当前仓库只有“代码内注册表配置”，还没有把 `TagRule` 设计回写成 DataTable / DataRow / 运行时消费链。
+- `S4-07` 已进入第一阶段实现。当前仓库已具备 `TagConfig.txt -> DRTagConfig -> TagConfigRegistry -> ItemDescForm` 的消费闭环，首发 7 个 Tag 的触发阶段、描述与核心参数已可由表覆盖。
+- `S4-07` 仍未完成最终收口。当前采用的是 `TagConfig` 表驱动，而不是文档原方案里的完整 `TagRule`；权重、生成规则等字段仍未全部映射回 DataTable / DataRow / 运行时消费链。

 ### S4-06 当前代码状态

@@ -193,16 +196,14 @@
 - `EnemyTagStatusRuntime` 已不再硬编码 `burn/slow` 字段，而是按激活的状态类 Tag 动态调度 Tick。
 - `Fire` 已改为独立 DOT 公式：当前使用独立 `BurnDamagePerSecondPerStack`，并按敌人实体每帧提供的 `deltaTime` 连续结算，不再依赖命中伤害或内部 `TickInterval`。
 - `Ice` 仍是独立减速状态，移速倍率通过状态运行时聚合得到。
- `Crit`、`Execution` 已通过数值修正链路生效；`Shatter` 仍仅有占位配置与入口，没有实际增伤逻辑。
+- `Crit`、`Execution`、`Shatter` 已通过数值修正链路生效；`Shatter` 当前按“目标已减速时增伤”收口。
+- `Inferno` 与 `AbsoluteZero` 已不再是独立状态效果，而是分别在 `Fire` / `Ice` 生效时读取同次命中的强化 Tag 层数，增强 DOT 时长/伤害与减速时长/强度。

 ### S4 后续执行计划

-1. 先补完 `S4-06` 的首发缺口，只做正式首发集合剩余的 `Shatter`、`Inferno`、`AbsoluteZero`，不提前展开传播、爆炸、穿透、多命中体系。
-2. `Shatter` 优先接入现有命中前数值修正链，直接消费“目标已减速”这一当前已存在的状态查询能力。
-3. `Inferno` 与 `AbsoluteZero` 优先作为对已有 `Fire` / `Ice` 的强化 Tag 落地，不额外引入第二套状态系统；要求仍沿用当前“单 Tag 配置 + 单 Tag 效果 + 注册式状态运行时”的结构。
-4. 首发 7 个 Tag 全部进入战斗并补齐对应 EditMode 测试后，再将 `S4-06` 标记为完成。
-5. 之后进入 `S4-07`：新增并消费 `TagRule` 表或等价 DataTable 映射，把当前代码内的 Tag 参数逐步迁移为可配置数据，而不是继续堆在 `TagConfigRegistry` 默认值里。
-6. `S4-07` 完成标准仍以“表字段被实际消费、参数可解释、运行时与文档口径一致”为准，不要求一步到位把全部 12 个 Tag 都配置化。
+1. 继续推进 `S4-07`：在现有 `TagConfig` 表驱动基础上，决定是否补成文档中的完整 `TagRule`，或明确将 `TagConfig` 作为当前阶段的等价收口方案。
+2. `S4-07` 完成标准仍以“表字段被实际消费、参数可解释、运行时与文档口径一致”为准；当前已完成首发 7 个 Tag 的参数和说明配置化，后续重点转向剩余规则字段是否也要配置化。
+3. `BurnSpread`、`IgniteBurst`、`FreezeMask`、`Pierce`、`Overpenetrate` 继续留在后续扩展阶段，不因为 `S4-06` 完成而提前进入当前迭代。

 ## 阶段 S5 - 收口耐久规则

@@ -227,7 +228,7 @@
 1. 先做 `S1`，把主流程真正收成一条稳定可验收的链。
 2. `S2` 已完成口径对齐，`NodeMapForm` 不再作为 M1 阻塞项。
 3. 接下来优先做 `S3`，补齐出战合法性，解决 `P0-10`。
-4. 再做 `S4`，统一品质 / Tag 的规则口径，解决 `P0-11`。其中当前优先级已经收口为：先补完 `S4-06` 的首发 7 Tag，再做 `S4-07` 的数据表映射。
+4. 再做 `S4`，统一品质 / Tag 的规则口径，解决 `P0-11`。其中当前优先级已经收口为：`S4-06` 已完成，下一步转入 `S4-07` 的数据表映射。
 5. 最后做 `S5`，决定耐久是完整收口还是同步缩范围，解决 `P0-12`。
 6. 全部完成后做 `S6`，补测试并同步文档状态。

@@ -235,9 +236,8 @@

 1. `S1` 与 `S2` 已完成口径收口，可直接进入规则侧收尾
 2. `S3-01 ~ S3-04` 已完成，当前可转入 `S4`
-3. 当前先继续完成 `S4-06`，补齐 `Shatter`、`Inferno`、`AbsoluteZero`
-4. 然后进入 `S4-07`，把 `TagRule` / DataTable 映射真正接进运行时
-5. 最后补 `S6-01 ~ S6-04`
+3. 当前转入 `S4-07`，把 `TagRule` / DataTable 映射真正接进运行时
+4. 然后补 `S6-01 ~ S6-04`

 ## 备注