basegames/zeling_v2
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
390 Commits 1 Branch 0 Tags
02c3a764a528e08e2a71edabe8bdc4b321637704
Commit Graph
36 Commits
Author SHA1 Message Date
joywayer 02c3a764a5 docs(enemy): 记录 Task 15 实测结论——含一个项目级严重 bug 
后续任务新增最高优先级项：EnemyHurtState.Enter 在无受击动画时提前返回
且不安排回 Controlled，敌人被打一次即永久卡在 Hurt 态、AI 永久停摆。
美术未接入的当下等于大部分敌人一挨打就废。与 Boss 轨无关，需单独立项。

Task 16 加警示：不得删掉 Task 15 新增的 BossBase.Start()——它是场景直接
放置的 Boss 唯一一次应用阶段招池的时机（EnterPhase 只在换阶段触发、
OnSpawn 只在池化复用触发，开局都不跑）。

顺带更正计划头部的 Unity 版本（实际 2022.3.62f3c1，非 Unity 6）。
 2026-07-30 16:05:26 +08:00
joywayer bdeefca75b docs(enemy): Task 15 补 Phase1_Tornado_HitBox 去留判定 
Task 14 发现该 HitBox 在 _hitBoxes 数组随 BossSkillExecutor 移除后已无任何引用。
龙卷由动画事件生成弹体、判定自带，Boss 身上这个 HitBox 很可能多余。
要么删掉其创建与伤害源绑定，要么绑进对应能力的槽位——不得以无引用状态留在对象树上。
 2026-07-30 15:19:57 +08:00
joywayer e488255315 docs(enemy): Task 15 补两项——UseAbility 静默失败与频道资产实名 
Task 11 发现 EnemyBrainContext.UseAbility 对找不到的能力 id 静默返回 false：
入场演出资产漏配会被静默跳过且零报错，是第 6 条禁止的静默通过。
建图期已挡掉空 id，故运行期解析不到必是配置错误，改为 LogError（非抛异常，
因为这是每帧路径）。放 Task 15 因为那是第一次能观察到配齐/漏配两种表现的时点。

Task 12 实测：EVT_BossFightToggled 资产不存在，实际是 EVT_BossFightEnded
被当开关用（BGMController 与 BossHPBar 都绑它）。资产名与用途不符是既存问题，
本次只记录不改名。
 2026-07-30 14:58:08 +08:00
joywayer d172f903b6 docs(enemy): 记录 BrainBuilder 缺少「态是否有出边」校验 
Task 9+10 执行时发现：Build() 只做 RequireState 的正向校验（边指向的态
是否已声明），不校验反向——已声明却无出边的非终态会让敌人永久卡住且零报错。
BossFragments.PhaseTransition 按设计不自带出边，正是这类风险点。
列入后续任务，并记录 MoveToAnchor 只在 OnEnter 采样锚点这一隐含假设。
 2026-07-30 14:34:32 +08:00
joywayer 5046125acb docs(enemy): 执行须知第 5 条——RequireComponent 指向抽象类型时 AddComponent 返回 null 
HurtBox 标了 [RequireComponent(typeof(Collider2D))]，Collider2D 是抽象类，
Unity 无法自动补齐，AddComponent<HurtBox>() 返回真 null。建测试对象须先挂
具体碰撞体。Task 6 实测证实；HurtBoxEditor.cs:97 早有同样注释，说明这个坑
项目里踩过但没写进规范。
 2026-07-30 14:04:42 +08:00
joywayer c577d6baa6 docs(enemy): Task 16 的行为树残留清理已在 Task 5 顺带完成 2026-07-30 13:52:47 +08:00
joywayer 24c612930e docs(enemy): 记录 EditMode 不触发 Awake 的坑，并分派两处越界发现 
执行须知第 4 条：EditMode 下 AddComponent 不调用 Awake（Task 4 实测证实）。
后果是 EnemyAbilityBase._enemy 留空使 CanUse 恒假——依赖它的断言在修复前
也会通过，成为永远不会失败的测试。做法是给测试子类加 RunAwake() 显式触发，
不要反射直写字段。

Task 5 追加：IAttackCandidate 的 CanUse 注释补上 enabled 这一维。
Task 21 追加：EnemyQuotaManager._maxActiveBehaviorTrees 改名须带
FormerlySerializedAs，否则丢场景配置值。
 2026-07-30 13:30:44 +08:00
joywayer d8d99dd1ce docs(enemy): 计划补三条实测坑与两处修正 
执行须知新增：EnemyBase.Abilities 属性遮蔽同名命名空间（成员访问位置须写全名，
Task 16/17 会再遇到）；unity_get_compilation_errors 在编译成功时不报警告，
'0 warnings' 是上报口径而非真值；MCP 测试运行器忽略过滤参数。

Task 5：选招器防重复的重置移出 BossBase.OnSpawn（Task 3 审查确认应归
EnemyBase.OnSpawn 以覆盖全部池化敌人）。
Task 21：残留扫描的预期由「无命中」改为「BD_/行为树 仍有约 20 处待清」。
 2026-07-30 13:02:52 +08:00
joywayer b0fd040904 docs(enemy): 按 Task 1+2 审查结论修订 spec 与计划 
spec：ResourceFull 由「无组件时恒 false」改为显式抛，与 Boss facet、AnchorAt
统一为「依赖组件缺失一律抛，不返默认值」。
计划：Task 16 补上 BossBase 残余三处行为树残留的清理项（含运行时告警字符串）；
Task 19 记录 Patterns/ 是零外部引用的独立程序集，可整目录删。
 2026-07-30 12:32:43 +08:00
joywayer 5839b423ae docs(enemy): Boss AI 双轨统一实施计划——21 个任务，分两阶段 
阶段一 Task 1-15 只加不删（每 Task 编译通过、测试全绿，末尾嘲风能用新轨打起来）；
阶段二 Task 16-21 删旧轨（先改引用方，再删被引用类型；先删资产，再删脚本）。

编写期核查坐实并更正 spec 两处：
- 取消 EnemyBase.SetInvincible(float)：HurtBox.SetInvincible(bool) 已存在，
  玩家侧 EnableIFrame/DisableIFrame 就走它，无敌时长由动画上两事件间距表达。
  新增件由六件减为五件。
- 竞技场锚点改挂 IBossControl，不走黑板：EnemyAiBrain._context 是私有字段
  且无公开访问器（BossBase 无从写入），且 ResetScratch 会清黑板带来隐式时序约束。

另确认 EditorScaffoldUtils.CreateSOAsset(Type,...) 重载已存在，无需新增辅助。
 2026-07-30 11:01:46 +08:00
joywayer c176423103 docs(enemy): Boss AI 双轨统一设计——决策层与执行层一并归并到小怪轨 
竞品调研 + 代码现状核查后推翻 2026-07-27 §5 的「执行层按复杂度分层」：
Boss 侧那层富编排从未真正存在（0 个 AttackPatternSO/SkillSequenceSO 资产、
5 个 BossSkillSO 除 skillId/weight 外全空、执行器跑一遍纯空转、
UseBossSkillWeighted 零调用者、预制体上无 EnemyAiBrain）。

决策：
- 决策层单轨 —— 每 Boss 一个 AiScript 定制类，不建 Boss 骨架/配方
- 执行层单轨 —— Boss 招走 EnemyAbilitySO + EnemyAttackSO，编排权威=动画时间轴
- 阶段=换招池 —— BossPhaseAbilityGate 按阶段启停能力组件
- 选招策略是可换小构件 —— AttackSelectionMode 加防重复值，不抽策略接口
- 旧 Boss 轨退役 9 脚本 + 5 资产，判据「有更优替代才删」

同时记录 WeakPointSystem.GetDamageMultiplier 零调用者、
BossBase.HandleParrySuccess 订阅全局弹反频道导致的误伤 bug、
敌人侧动画事件只接了 7/20 三处历史遗漏，以及两条脚手架创建链路
（CharacterWizardWindow / SceneObjectPlacerTool.PlaceChaoFeng）必须同改。
 2026-07-30 10:29:49 +08:00
joywayerandClaude Opus 5 c76eba8a0e docs(enemy): T15 并入 T13 审查遗留——AssignModules 改名 + InvalidateGraph 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 14:53:54 +08:00
joywayerandClaude Opus 5 6540560c13 docs(enemy): 计划同步——未配置配方应显式报错，而非"默认必须可建图" 
T13 执行中发现原稿的 DefaultModules_ProduceValidGraph 断言了一条不成立的契约：
建资产到配好模块之间没有任何东西会调 GetOrBuildGraph()，它只在
EnemyAiBrain.Start() 运行时被调，所以"新建资产即报错"的场景不存在。
按该断言把默认改成零配置可建图的模块，会把"必然响亮报错"换成
"建图成功但敌人永不出手、零报错"——方向与第 6 条相反。改为钉相反契约。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 14:48:19 +08:00
joywayerandClaude Opus 5 6a885ec105 docs(enemy): 计划同步取消死亡层——T9 作废、新增 T9R，T10/T11/T13 去掉 death 参数 
T9 原稿折叠保留作历史记录，附必然卡死的机制说明。
PerceptionSkeleton.Add 由三参收为两参并自声明 Death 终态；
PerceptionRecipeSO 去掉死亡层字段。T5 段落保持原样（它记录的是已发生的事实，
IDeathModule 由 T9R 删除）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 13:59:54 +08:00
joywayerandClaude Opus 5 023a4a4ec6 docs(enemy): 取消死亡层——死亡归物理层，四层收为三层 
T9 质量审查发现 TwoStageDeath 在真实运行中必然卡死：PerformDeath 先
ForceState(Dead) 再 Send(Died)，IsControllable 此后永久为假，AiRuntime
的让位门使死亡链里的条件边永不被求值。追根后确认整层放错位置——
死亡完全归物理层(PerformDeath/EnemyDeathSequence/EnemySpawnerOnEvent)，
AI 图只需要一个终态让全局 Died 边有去处。

初稿做成一层的由来：旧 Config 的 DeathAbilityId 字段，而其唯一使用者
E001 留空并注明"演出走物理状态机"。投机字段被放大成了三模块的层。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 13:54:40 +08:00
joywayerandClaude Opus 5 d013fe8e2e docs(enemy): 写明 RushExit.Committed 防抖动的前提是能力 cooldown > 0 
质量审查发现：Committed 的冷却门若遇上 cooldown==0 的能力，
CanUseAbility 结束下一帧即恢复，Rush↔Rest 每帧抖动照旧出现。
这属能力侧配置错误，不在模块内兜底，纳入 AiDefinitionValidator 校验项。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 12:41:09 +08:00
joywayerandClaude Opus 5 5dcbce6019 docs(enemy): 计划新增 T5b——BrainBuilder.DeclareState 防模块间状态名冲突 
契约质量审查提出：模块化后 State() 的"有则取"语义使两个独立模块
取同名状态时后者静默覆盖前者回调。与 T1 的 RequireState 是同一类
失败的两面，趁 0 个模块实现时补代价最低。附带补充交战/死亡层
"为何单阶段 Build 足够"的不变量说明。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 11:57:57 +08:00
joywayerandClaude Opus 5 2643f58b08 docs(enemy): 计划同步——AiStateFragments 空能力 id 改建图期报错 
原稿沿用旧代码的静默跳过写法。AiStateFragments 成为公开原语后，
定制 AiScript 漏配 id 会产出"存在但什么都不做"的状态且无报错，
与 T1 引入 BrainBuilder.RequireState 的理由是同一类失败，不应双标。
校验放建图期而非每帧回调，兼顾快速失败与热路径开销。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 11:43:15 +08:00
joywayerandClaude Opus 5 f3c17de223 docs(enemy): 敌人 AI 组合式模块架构实施计划（17 个任务，TDD） 
含计划阶段发现的三处修正：
- 未发现层拆 Declare/Link 两阶段，保证骨架升级边优先于内部计时边；
- 模块参数校验与委托缓存移出构造函数（[SerializeReference] 不保证走 ctor）；
- 新增 AiStateFragments.AbilityOnce，修死亡态演出被 Tick 无限重播的隐患。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 10:51:07 +08:00
joywayerandClaude Opus 5 e59e24cca0 docs(enemy): 修正 AI 配方解析方式——直接引用替代注册表双源 
实施计划阶段发现两处硬阻塞：
1. BaseGames.AI 只引用 BaseGames.Core，无法收集依赖 Enemies 的 AiRecipeSO；
2. 项目 database SO 走 [SerializeField] 直接引用而非 Addressables，静态注册表取不到。

改为 EnemyAiBrain 上 _recipe 资产引用 / _definitionId 脚本 id 二选一。
净减 AiRecipeDatabaseSO、Addressables 加载、AddressKeys 改动、asmdef 改动；
flyweight 与配方路径零字符串 id 均保持。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 10:38:07 +08:00
joywayerandClaude Opus 5 1c32d8c87e docs(enemy): 敌人 AI 组合式模块架构设计（替换 PerceptionStateMachine） 
四层架构：固定感知骨架 + 可插拔的 未发现层/交战层/死亡层；
两种定义源：PerceptionRecipeSO 配方资产（约 95% 敌人零代码）+ AiScript 定制脚本；
消除 Config 开关面板（EngagementStyle/PatrolBetweenChases → RushExit 语义枚举）；
能力引用资产化（AbilityRef）；AiSignal 8→1 清理死枚举。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 10:20:22 +08:00
joywayer 02ea0bb576 docs(enemy): 标注脱图脱困设计已作废(被移除寻路库方案取代,未实施) 2026-07-28 13:03:54 +08:00
joywayer d9ec0a4f6e docs(enemy): 移除寻路库实现计划(10任务/6阶段,TDD+编译门+回归门+PlayMode验收) 2026-07-28 10:53:21 +08:00
joywayer d74a2b6646 docs(enemy): 移除寻路库后的敌人导航框架设计(IEnemyNavigator 瘦身+地面直移+StallDetector 收敛) 2026-07-28 10:41:30 +08:00
joywayer 579499e678 docs(enemy): 脱困改用敌人自身步速(MoveHorizontal/WalkSpeed),移除独立速度参数 2026-07-27 16:45:00 +08:00
joywayer e7f1633877 docs(enemy): 导航脱图统一脱困设计(含 Wander/Waypoints 静默吞失败与 Pace 边沿翻向两个根因) 2026-07-27 16:31:32 +08:00
joywayer 8a6450910e docs(enemy): 身体几何权威源实现计划(4任务,TDD+编译门+191测试门+PlayMode等价性验证) 2026-07-27 11:38:34 +08:00
joywayer 3752a9a0e0 docs(enemy): 角色身体碰撞体唯一权威源(IEnemyBody)设计 2026-07-27 11:20:09 +08:00
joywayer cd9acfcde1 docs: 共享底座抽取决策记录(WeightedPick 已抽;冷却/HitBox 窗口否决理由;Boss BrainGraph 路线) 2026-07-27 10:00:05 +08:00
joywayer f15f0a6876 docs(enemy): 寻路逼近+攻击选择器实现计划(9任务,TDD选择器+状态机,编译门+Play验证) 2026-07-24 11:50:20 +08:00
joywayer c33ce55f13 docs(enemy): 寻路逼近+攻击选择器设计(感知管交战/招式自管射程/两选招模式) 2026-07-24 11:21:35 +08:00
joywayerandClaude Opus 4.8 a60073d92c docs(enemy): 敌人寻路受阻处理实现计划(6任务,编译门+Play验证) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-23 16:44:12 +08:00
joywayerandClaude Opus 4.8 04b294734a docs(enemy): 敌人寻路受阻处理设计(Waypoints+MoveTo,含卡死检测与最近可达点) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-23 16:37:39 +08:00
joywayer 0ad4acc484 docs(plan): 敌人能力配置迁移到 AbilitySO 子类实现计划 2026-07-21 11:04:36 +08:00
joywayer 68e2cc506d docs(spec): 敌人能力配置迁移到 AbilitySO 子类设计文档 2026-07-21 10:42:25 +08:00
joywayer a7307a5a07 调整文档 2026-07-21 10:22:43 +08:00