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
323 Commits
Author SHA1 Message Date
joywayerandClaude Opus 5 877d2f5fef feat(enemy): 嘲风迁移到新轨——能力资产 + 对象树 + 开战触发 
删 5 个空 BossSkillSO，用向导重建 6 个 EnemyAbilitySO（含入场演出）。
预制体经放置工具重新产出：EnemyAiBrain(_definitionId=ChaoFeng) +
BossPhaseAbilityGate + 6 个能力组件，不再有 BossSkillExecutor。
TestRoomA 加开战触发区。三件自检 0 error，EditMode 260/260。

首次真正跑通两条脚手架，暴露并修掉三个它们的缺陷：

1. 放置工具漏挂 EnemyLocomotion（PlaceChaoFeng 及其余 7 个敌人放置入口）。
   EnemyBase.Awake 找不到它即报错且 Locomotion 为 null，
   AiStateFragments.ApplyLocomotion 直接 NRE、AiRuntime 构造失败——
   Boss 建不出决策层，完全不动。已在所有敌人放置入口补齐。
2. 向导把空中阶段的 wind_stone 建成 requiresGrounded=true（SO 默认值）。
   Boss 浮空后 IsGrounded 恒 false，选招器把它滤掉，空中阶段站着不打。
   能力定义表加 grounded 列，阶段 1 的招显式置 false。
3. BossPhaseAbilityGate.ApplyPhase 只在 EnterPhase 与 OnSpawn 调用，
   直接摆场景里的 Boss 两条路径都不走，开局后续阶段的招仍在候选池里。
   BossBase.Start 补一次初始阶段应用。

另：Phase1_Tornado_HitBox 确认零消费者（龙卷判定随弹体走），
从放置工具删除其创建与伤害源绑定；
EnemyBrainContext.UseAbility 对解析不到的能力 id 改为 LogError，
不再静默返回 false（CLAUDE.md 第 6 条）；
新增 PlaceBossFightTrigger 脚手架（此前无对应创建入口，属裸建）。

播放模式实测状态序列（TestRoomA，玩家走进触发区）：
Wait →(Engaged) Intro → Ground⇄GroundAttack →(hp<50%) PhaseTransition
→ Air⇄AirAttack，浮空生效，阶段门按阶段换池，全程 0 报错。
动画 Clip 未接入，PlayClipAbility 空 clip 立即完成，故只验证了状态流转，
判定时序待美术接入后再校。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-30 16:02:14 +08:00
joywayerandClaude Opus 5 ba2e22cd58 refactor(editor): PlaceChaoFeng 改挂新轨——决策层 + 阶段门 + 能力组件 
BossSkillExecutor 换为 EnemyAiBrain(_definitionId=ChaoFeng) +
BossPhaseAbilityGate + 6 个能力组件（一招一子物体，绕开
DisallowMultipleComponent）。HitBox 改绑命名槽位，阶段招池经反射写入。
顺带删掉 Place Boss Enemy 报告里的 BossSkillExecutor 旧轨提示，
以及已无引用的 using BaseGames.Boss。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-30 15:17:52 +08:00
joywayerandClaude Opus 5 a64449d213 refactor(editor): 角色向导 Boss 页改产出 EnemyAbilitySO 
该向导是 5 个空 BossSkillSO 资产的创建链路——不改则会持续产出旧轨资产。
招式表扩为带 soType / rangeRadius / cooldown / weight 的形式（与
GetEnemyAbilityDefs 对齐），阶段可用性移交 BossPhaseAbilityGate。
产出时强制 rangeRadius > 0，不把责任推给下游作者。
状态面板改查 EnemyAbilitySO，并新增 AI 图注册状态一行。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-30 15:08:10 +08:00
joywayer 990f90d383 feat(enemy): BossFightTrigger——补上缺失的开战触发 
开战事件频道此前全项目零发送方，Boss 永远不开战。
触发时广播开战事件并向 Boss 决策层发 AiSignal.Engaged。
漏配目标 Brain / bossId / 两个频道 / 玩家层掩码 / isTrigger 一律逐条点名报错并停用组件，
不做部分执行——半开的战斗比彻底不开更难查。
 2026-07-30 14:55:05 +08:00
joywayer 0d81d29527 feat(enemy): 嘲风 AI 图（BrainGraph 定制路径） 
Wait →(Engaged) Intro → Ground⇄GroundAttack →(hp<50%) PhaseTx → Air⇄AirAttack。
Boss 不脱战（rest 指回自身）、阶段单向推进、起手就打完。
死亡不在图上：全局 Died 边进 Death 终态，演出归物理层。
8 条 EditMode 断言覆盖状态序列、过渡只发起一次、过渡结束必须转出、
脱离感知区不脱战、血量回升不回退阶段。
 2026-07-30 14:51:08 +08:00
joywayerandClaude Opus 5 eaba54ea76 feat(ai): Boss 图共享片段 + 竞技场锚点 + AiSignal.Engaged 
BossFragments：阶段过渡 / 逼近选招 / 移动到锚点三个静态建态片段。
ApproachAttackEngagement 的建态逻辑提为 internal static Declare（态名参数化），
模块路径与 Boss 图路径共用同一份行为，Boss 可建多组（地面组/空中组）。

锚点坐标经 IBossControl.AnchorAt / DistanceToAnchor 暴露，不走黑板——
EnemyAiBrain._context 是私有的（BossBase 无从写入），且 ResetScratch 会清黑板
带来隐式时序约束。锚点本就是 Boss 专属知识，归 Boss facet 更直。
锚点漏配 / 下标越界显式抛，不回退到自身位置。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-30 14:32:32 +08:00
joywayerandClaude Opus 5 8c56d207bd feat(enemy): EnemyAbilitySO 补设计备注，命名前缀对齐规范 
+ designNote（目标体量下能力数量大，设计意图需就近记录）。
fileName 由 EAB_ 改为 ABL_——AssetFolderSpec 第 298 行、两个向导
以及 PlayClipAbilitySO 等子类都用 ABL_，此前只有基类是 EAB_。
顺带清掉 abilityId 注释里的旧插件残留字样。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-30 14:23:41 +08:00
joywayerandClaude Opus 5 c05583a365 feat(animation): 敌人侧动画事件补接无敌帧与反馈四件 
EnableIFrame/DisableIFrame → HurtBox.SetInvincible（与玩家侧同形态，
无敌时长由动画时间轴上两事件间距表达）；TriggerFeedback/PlaySFX →
IFeedbackPlayer，用于音效预警。此前敌人侧只接了 7/20 个事件类型。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-30 14:20:47 +08:00
joywayer 5cc93483d3 feat(combat): HurtBox 自带受击伤害倍率 
倍率归 HurtBox 自己（弱点部位就是一个倍率 > 1 的 HurtBox），
取代 WeakPointSystem 那份写进私有字段却零调用者的倍率——
其注释称由 BossStats 调用，而项目里根本没有 BossStats 类型。

倍率 1 时数值原样返回而非"乘完再钳最低 1"：本改动先于任何消费者落地，
若默认路径引入钳制会静默改变游戏里每一次伤害计算。
测试用 ApplyDamageMultiplier(0)==0 守住这条——10 在两种实现下都得 10，
只有 0 能把二者区分开。变异验证：去掉该捷径后恰好该断言变红。
 2026-07-30 14:15:12 +08:00
joywayer 50f505279d feat(enemy): BossPhaseAbilityGate——阶段即换招池 
按阶段启停能力组件，被禁用的招经 CanUse 自动退出选招候选，
阶段门不需要碰选招器。取代 BossSkillSO.availablePhaseIndices。
EnterPhase 先换池后广播；OnSpawn 回阶段 0（对象池复用）。
 2026-07-30 13:50:34 +08:00
joywayer 64d2087adc fix(enemy): 禁用的能力组件不再报告可用 
CanUse 纳入 enabled。此前禁用组件仍返回 true，选招器会选中一个
StartCoroutine 必然失败的招。这也是阶段门（按阶段启停能力）的前提。
 2026-07-30 13:28:23 +08:00
joywayerandClaude Opus 5 0a92d21ce1 fix(enemy): 应用 Task 3 代码审查意见 
补上池化路径的防重复记忆重置——ResetRepeatMemory 此前文档承诺了
「对象池复用时清除」却无任何调用点，而它要取代的 BossBase.LastUsedSkillId
恰好在 OnSpawn 里有重置。放 EnemyBase.OnSpawn 以覆盖全部池化敌人。

折扣系数改为每次选招前刷新，与 attackSelectionMode 的读取时机对齐——
此前策划在播放模式下调系数无效、调模式却立即生效，容易误判为功能没生效。
默认值收敛为 EnemyAttackSelector.DefaultAntiRepeatFactor 单一常量。

测试：IneligiblePrevious 用例改用系数 0.5——原先用 0 时，把折扣错写在
eligibility 归零之前也照样通过，是个永远不会失败的测试；统计用例边界由
7σ 收紧到 5σ 使其真正验证该系数；补 ResetRepeatMemory 的确定性用例、
系数 1.0 无惩罚、三候选三条。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-30 13:00:28 +08:00
joywayerandClaude Opus 5 eb3f4888a4 feat(enemy): 选招器支持防重复折扣——WeightedRandomAntiRepeat 
上一次选中的招按 EnemyStatsSO.attackAntiRepeatFactor 折扣权重（默认 0.3）。
折扣把唯一候选压到 0 时退化为 Priority 路径，不会出现敌人永不出手。
阶段切换清空防重复记忆。取代 BossBase.UseBossSkillWeighted 里的同名逻辑。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-30 12:43:01 +08:00
joywayerandClaude Opus 5 2a1ada4388 fix(ai): 应用 Task 1+2 代码审查意见 
ResourceFull 未挂 BossResource 时改为显式抛——原先静默返回 false，
是 CLAUDE.md 第 6 条禁止的下游兜底，且与紧邻的 Boss facet 行为不一致。
FakeBossControl.DistanceToAnchor 不再忽略 index。测试改用 TearDown 清理
（本项目关闭了 Domain/Scene Reload，失败断言会把物体永久留在打开的场景里）。
BeginPhaseTransition 去掉死的默认参数；接口补充重入契约说明。

顺带去重：FakeAiContext 实现 IEnemyActor，删除两个测试内的本地 Ctx 副本
——一个接口成员改动要同步三份是复发性成本。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-30 12:31:39 +08:00
joywayerandClaude Opus 5 3665504a58 feat(ai): 新增 IBossControl facet——Boss 阶段状态经 IAiContext 供图读取 
非 Boss 敌人访问 IAiContext.Boss 显式抛 InvalidOperationException，
不返回空对象掩盖小怪图误挂 Boss 边的错误。BossResource 补 IsFull 供图条件边判定。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-30 12:15:54 +08:00
joywayer aaca138774 fix(editor): EnemyAiBrain 检视器支持多选——mixed 值不再误写，违规对象逐个点名 2026-07-30 08:46:41 +08:00
joywayer b36ac96ac7 feat(editor): EnemyAiBrain 检视器——二选一不变量提前到编辑期，定义 id 改下拉 2026-07-30 08:38:13 +08:00
joywayer afcc0b10ee fix(enemy): 配方校验改用一次性 builder 探测，不再干扰共享图缓存 2026-07-30 08:33:53 +08:00
joywayer da217af113 feat(enemy): AI 配方接入 SO 校验——漏配/歧义/零冷却 Committed 在编辑期与构建期报错 2026-07-29 17:20:12 +08:00
joywayer 6df4a259b7 docs(enemy): 修正作者指南与两处注释残留的死亡层表述 2026-07-29 16:34:21 +08:00
joywayer 44412adfc7 refactor(enemy): E001 AI 迁移为配方资产，退役定制脚本 
用 EnemyAiRecipeWizard 建 ENM_E001_Ai.asset，配置未发现层
DisguiseThenPatrol + 交战层 RushEngagement(e001_chase, Committed)；
TestRoomA 场景 EnemyAiBrain 改绑 _recipe，_definitionId 清空；
删除 E001CaoZhiAi.cs；SceneObjectPlacerTool 的 E001 挂载分支与其余
AI(BrainGraph) 提示文案统一改为指向配方向导路径。
 2026-07-29 15:38:44 +08:00
joywayer ecdb0040cb feat(editor): 敌人 AI 配方脚手架向导；AssignModules 改名并失效缓存 
- AiRecipeSO 新增 protected InvalidateGraph()，子类装配模块后调用以丢弃缓存图，
  避免改动要等到下次进 Play 才生效的静默陈旧图问题。
- PerceptionRecipeSO.SetModulesForTests 改名为 AssignModules（向导也要用它装配模块，
  旧名字具有误导性），并在装配后调用 InvalidateGraph。
- 新增 EnemyAiRecipeWizard：按 AssetFolderSpec 定名定路径创建感知型 AI 配方资产
  （Assets/_Game/Data/Enemies/{EnemyID}/ENM_{EnemyID}_Ai.asset），已存在则选中不覆盖。
- PerceptionRecipeSoTests 同步改名调用点，并新增测试钉住"装配后缓存必须失效"契约。
 2026-07-29 15:28:25 +08:00
joywayer 426fa3601d fix(enemy): EnemyAiBrain 配置守卫不随重新启用蒸发，注册表消重 2026-07-29 15:23:49 +08:00
joywayer 57cbaacf2c feat(enemy): EnemyAiBrain 支持配方资产/AiScript id 二选一解析 2026-07-29 14:56:54 +08:00
joywayer 825cae7977 feat(enemy): PerceptionRecipeSO 配方资产 + SubclassSelector 模块下拉 
未发现层/交战层各用 [SerializeReference]+[SubclassSelector] 下拉挑选模块，
新增模块类自动出现在下拉里，无需改枚举或已有文件。默认交战模块仍为
RushEngagement——未配能力时建图必须显式报错，而非静默产出打不出手的图。
 2026-07-29 14:46:41 +08:00
joywayerandClaude Opus 5 04f644969b fix(ai): AiRecipeSO.OnEnable 改 protected virtual，防子类静默遮蔽 
留作 private 时，子类另写一个 OnEnable 会遮蔽它（Unity 只调最派生的），
PlayModeResetHook 注册从此不发生且零报错——关闭域重载下即表现为
"改了配方进 Play 仍跑旧图"。T13 的 PerceptionRecipeSO 是第一个子类，
在它出现前先堵住。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 14:36:22 +08:00
joywayer 6d8db95046 feat(ai): IAiDefinition + AiRecipeSO 配方基类（含关闭域重载的缓存重置） 2026-07-29 14:32:45 +08:00
joywayer 7327a5fe09 refactor(enemy): 退役 PerceptionStateMachine，E001 切换到两层模块组装 2026-07-29 14:24:48 +08:00
joywayer 9dc10e0398 test(enemy): 补测骨架 × 另两个模块的组合，以及入口覆盖契约 2026-07-29 14:21:36 +08:00
joywayer bf8101b3f5 feat(enemy): PerceptionSkeleton——两层可插拔的感知骨架，自声明死亡终态 2026-07-29 14:10:46 +08:00
joywayer faa210c789 revert(enemy): 收掉死亡层——死亡归物理层，AI 只需一个终态 2026-07-29 14:02:13 +08:00
joywayer 5a9c1fd569 chore(enemy): 补齐死亡层模块的 .meta 文件 2026-07-29 13:46:45 +08:00
joywayer 3bc7eb1855 feat(enemy): 死亡层三模块（终态/单段/两段） 2026-07-29 13:46:20 +08:00
joywayer 3d00c66677 test(enemy): 补测 Attack 单出边的自愈路径，写明边序依赖的射程前提 
Approach 边序注释：attackInRange 先于 leftAllZones 的前提是攻击射程恒小于
感知区(EnemyAttackSelector.Eligible 的 InAttackRange 门),故两条件不会相争;
若未来出现射程更大的招式,应由 AI 配方校验器报错,而非靠调边序绕开。

FakeCombat 新增 BestAttackFails 开关(与 Eligible 解耦),补测 Attack 唯一出边
attackDone 的自愈不变量:UseBestAttack 触发失败时不留下运行中能力,下一帧即可
自愈回 Approach,不会永久卡死。
 2026-07-29 13:08:46 +08:00
joywayer 9d632cd103 fix(enemy): 退回 Approach 边序——脱战优先属假件失真，改由测试贴合真实射程语义 
HasEligibleAttack() 只看攻击射程圆(远小于追击/视野区),脱离全部感知区在真实系统里
必然已脱离攻击射程,原顺序(attackInRange 先于 leftAllZones)本就正确。
FakeCombat.Eligible 是裸字段不会随 Chase/Vision 联动,才让上一版看似需要调边序。
改法:边序退回原样,测试里玩家离开感知区时手工同步清 Eligible,贴合真实耦合关系。
 2026-07-29 12:59:07 +08:00
joywayer a700bef352 feat(enemy): ApproachAttackEngagement——攻击改为起手即打完，不中途收招 
寻路逼近↔到射程选招攻击的交战模块。招式射程/冷却/权重归 EnemyAttackSelector，
本模块只决定何时逼近、何时出手。

有意的行为变更：Attack 态去掉 leftAllZones 边，玩家在前摇中跑出感知区不再
中途打断招式，招式完整打完后经 Approach 自然脱战。
 2026-07-29 12:53:49 +08:00
joywayer 5771ac414e test(enemy): 补测 Committed 冲锋的防抖动闭环，RushExit 写明冷却前提 2026-07-29 12:45:43 +08:00
joywayer bb1e2f7705 feat(enemy): RushEngagement——两个耦合 flag 合并为 RushExit 语义枚举 2026-07-29 12:32:50 +08:00
joywayerandClaude Opus 5 1c6ce57648 test(enemy): 修正测试名——该用例只验证空 Link 不加边，不涉及单向不可逆 
原名 DisguiseThenPatrol_HasNoInternalEdges_DisguiseIsOneWay 承诺了
"伪装态不可逆"，但那需要骨架的升级边才能验证（T10 覆盖）。
此用例实际只证明 Link 为空时状态不会自行跑掉，按实测内容改名。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 12:26:42 +08:00
joywayer acfba66c5d feat(enemy): 未发现层三模块（单一态/单向降级/定时交替） 2026-07-29 12:19:26 +08:00
joywayer 894ae99984 test(ai): 补测经 AiStateFragments 的跨模块状态撞名，State() 补引导注释 2026-07-29 12:11:07 +08:00
joywayer 80fdc36762 feat(ai): BrainBuilder.DeclareState——重复声明状态即报错，防模块间同名静默覆盖 
State() 仍保持宽松(有则取),用于给已声明的态挂边;DeclareState() 只用于
首次声明行为,重复声明同名状态会抛异常。AiStateFragments 的四个建态原语
(Locomotion/Ability/AbilityOnce/Terminal)改用 DeclareState。同时给
IEngagementModule/IDeathModule/IUnawareModule 补充不变量说明。
 2026-07-29 12:01:19 +08:00
joywayer 17e71dac39 feat(enemy): 未发现层/交战层/死亡层三个模块契约 2026-07-29 11:47:29 +08:00
joywayer 68f615e9c1 fix(enemy): AiStateFragments 空能力 id 建图期报错，补 OnExit 收尾测试 
Ability/AbilityOnce 建图期校验 abilityId 非空，与 BrainBuilder.RequireState
同一类"漏配即快速失败"约束保持一致，避免定制 AiScript 漏配 id 时产出静默
不作为的状态。同时补 4 个测试：Locomotion/Ability 的 OnExit 收尾行为，以及
两个原语对空 id 的报错行为。
 2026-07-29 11:42:47 +08:00
joywayer 77a32cbf8a feat(enemy): AiStateFragments 建态原语，新增 AbilityOnce 修死亡态重触发隐患 
从 PerceptionStateMachine 的 private static 辅助方法提升为公开原语，供后续
模块化重构（骨架+可插拔模块）与定制 AiScript 复用。新增 AbilityOnce：
只在进入时触发能力、不每帧重触发，修复用 Ability() 驱动死亡态时演出播完
被 Tick 无限重播的隐患（现有 PerceptionStateMachine 因 E001 死亡能力 id
为空未暴露，本次不改它，留待 T11 整体退役）。
 2026-07-29 11:35:47 +08:00
joywayer 084354fa6c test(enemy): AbilityRef 补测资产已挂但 abilityId 为空的误配路径 2026-07-29 11:29:47 +08:00
joywayer 474e89de3a feat(enemy): AbilityRef——AI 层能力引用资产化，字符串仅作定制脚本兜底 2026-07-29 11:22:15 +08:00
joywayer fd238b71f1 refactor(ai): AiSignal 8→1，删除零发送方零消费方的死枚举 2026-07-29 11:14:29 +08:00
joywayer e76d6bc118 feat(ai): BrainBuilder.RequireState——未声明状态挂边时构建期报错 2026-07-29 11:08:23 +08:00
joywayerandClaude Opus 5 8d63525b12 chore(scene): TestRoomA 敌人感知槽改 Box 型并配尺寸，微调物体位置 
aggro/los 两个感知槽由点/圆改为 Box(type 7)，offset y=0.31，
分别配 8.1x1.38 / 11.65x1.38；顺带清掉随 NavDriving 死代码移除的序列化残留字段。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 11:05:15 +08:00