From ef1998db2b7cd829bfbec60232b86f8729f32d78 Mon Sep 17 00:00:00 2001 From: Joywayer Date: Thu, 30 Jul 2026 16:28:21 +0800 Subject: [PATCH] =?UTF-8?q?docs(enemy):=20Task=2019=20=E8=A1=A5=20Step=200?= =?UTF-8?q?=E2=80=94=E2=80=94=E4=B8=A4=E5=A4=84=E8=AE=A1=E5=88=92=E9=81=97?= =?UTF-8?q?=E6=BC=8F=E7=9A=84=E5=BC=95=E7=94=A8=EF=BC=8C=E4=B8=8D=E6=B8=85?= =?UTF-8?q?=E5=88=99=E5=88=A0=E9=99=A4=E4=BB=BB=E5=8A=A1=E5=BF=85=E7=84=B6?= =?UTF-8?q?=E7=BC=96=E8=AF=91=E5=A4=B1=E8=B4=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ChaoFengKnockdownCounter.cs:82 有 BossSkillExecutor 的编译期类型引用， 该文件既不在删除清单也未安排改动，却仍被 ChaoFengBoss 使用。 EditorScaffoldUtils 的命名前缀表里有 BossSkillSO/SkillSequenceSO 两条死条目。 后续任务再添一项：池化敌人复活带着上一条命的冷却——OnSpawn 里 InterruptAll 的注释声称重置冷却，实际 Interrupt 在未运行时提前返回、 运行时又是设置而非清零冷却。影响全体池化敌人。 --- .../plans/2026-07-30-boss-ai-single-track.md | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/Docs_Dev/superpowers/plans/2026-07-30-boss-ai-single-track.md b/Docs_Dev/superpowers/plans/2026-07-30-boss-ai-single-track.md index 81fa376a..c92a0367 100644 --- a/Docs_Dev/superpowers/plans/2026-07-30-boss-ai-single-track.md +++ b/Docs_Dev/superpowers/plans/2026-07-30-boss-ai-single-track.md @@ -2751,6 +2751,30 @@ AI 图挂 When(x => x.Boss.ResourceFull) 边进专属招态。 **Files:** - Delete: 9 个脚本（见下） +- [ ] **Step 0: 先清掉两处计划遗漏的引用（Task 16–18 执行时发现，不清则本 Task 必然编译失败）** + +**0a. `ChaoFengKnockdownCounter.cs:82` —— 编译期类型引用，必须改：** + +```csharp +// 改前 +_boss.GetComponentInChildren()?.InterruptCurrentSkill(); +// 改后（与 BossBase 瘦身时同一形状） +_boss.Abilities.InterruptAll(InterruptReason.ExternalRequest); +``` + +该文件不在删除清单里且仍被 `ChaoFengBoss._knockdownCounter` 使用（`DefeatSequence` 与 +`OnDamageTaken` 都会调）。按需补 `using BaseGames.Enemies.Abilities;`。 +⚠️ 注意 `EnemyBase.Abilities` 属性遮蔽同名命名空间（执行须知第 1 条），写法参照 `BossBase` 里已落地的那处。 + +**0b. `EditorScaffoldUtils.cs:21-22` —— 命名前缀表里的死条目：** + +```csharp +{ "BossSkillSO", ("SKL_", "SKL_{Name}，例：SKL_BossRage") }, +{ "SkillSequenceSO", ("SKL_", "SKL_Seq_{Name}，例：SKL_Seq_RageCombo") }, +``` + +字符串字面量，不影响编译，但类型删除后是误导性死配置（还与 `AssetFolderSpec` 的 `ABL_` 冲突）。删掉这两行。 + - [ ] **Step 1: 确认零引用** ```bash @@ -2980,5 +3004,6 @@ EnemyAbilityModule（能力资产编辑器总览）。" | `BossEncounterCoordinator` | 多体 Boss 交替出招令牌。等真设计双体 Boss 时再做。见 spec §7.2 | | 嘲风动画 Clip 接入 | 美术资源缺口。Clip 到位后校招式判定时序与预警节奏 | | `BrainBuilder.Build()` 校验"态是否有出边" | Task 9+10 执行时发现：`Build()` 只校验"边指向的态是否已声明"（`RequireState` 的正向），**不校验反向**——一个已声明却没有任何出边的非终态会让敌人永久卡住且零报错。`BossFragments.PhaseTransition` 按设计不自带出边，正是这类风险点。做法是给 `AiStateFragments.Terminal` 加显式终态标记，`Build()` 对"非终态且无出边"抛异常 | +| **池化敌人复活时带着上一条命的冷却** | Task 16 执行时确认：`EnemyBase.OnSpawn` 里 `_abilities.InterruptAll(InterruptReason.Dead)` 的注释写着「重置能力冷却」，但 `EnemyAbilityBase.Interrupt` 在 `!_isRunning` 时**提前返回**，真跑到时又是**设置** `_cooldownEndTime = Time.time + cooldown*0.5f` 而非清零。所以冷却从未被重置。修法：给 `EnemyAbilityBase` 加 `ResetCooldown()`，在 `EnemyBase.OnSpawn` 遍历调用。影响全体池化敌人 | | **`EnemyHurtState` 无受击动画时永久卡死（优先级最高）** | Task 15 实测发现：`EnemyHurtState.Enter` 在 `AnimConfig.Hurt` 为空时**提前返回且不安排回到 `Controlled`**。任何没有受击动画的敌人被打一次就永久停在 `Hurt` 态，`IsControllable` 恒假、AI 永久停摆。当前美术未接入，等于**大部分敌人一挨打就废**。典型的规则 6 静默提前返回。与 Boss 轨无关，影响全体敌人，应尽快单独立项 | | `MoveToAnchor` 只在 `OnEnter` 采样锚点 | 锚点 Transform 若会移动则不会重新取点。与"锚点是固定点"的设定一致，但这是个隐含假设，将来若出现移动锚点需显式处理 |