basegames/zeling_v2
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
416 Commits 1 Branch 0 Tags
bf7899f91a818f3e0c9d2560fcbc26b615927aec
Commit Graph
19 Commits
Author SHA1 Message Date
joywayerandClaude Opus 5 0f676b0e88 feat(ai): Build() 校验「非终态必须有出口」，堵住零报错的永久卡死 
BrainBuilder.Build() 此前只做正向校验——边指向的态是否已声明（RequireState
的同款关切）；反向从不检查。一个已声明却没有任何出边的非终态，会让敌人进去
就永久停在那里，且全程零报错。计划里点名的风险点是 BossFragments.PhaseTransition：
它按设计不自带出边，出口全靠调用方补挂，漏一条就把 Boss 锁死。

做法：AiState 加 IsTerminal，StateBuilder 加 .Terminal() 显式标记，
AiStateFragments.Terminal() 自带该标记；Build() 对「非终态且无出口」抛异常。

「有出口」的判定比计划原话严一档，两点都是照 AiRuntime 的实际行为定的：
- 自转换不算——Switch 对 Target == 当前态直接 return false，根本出不去；
- 全局转换不算——全局事件边要外部推信号才触发，不是自主出口。把它算作出口，
  等于让「只有死了才出得去」的死角通过校验，而那恰是本校验要暴露的东西。

校验放在 Build() 而非各生产入口：生产的完整图装配点是 AiScript.GetOrBuildGraph
与 AiRecipeSO 两处，放 Build() 能让将来新增的入口默认受保护。代价是模块单测
需要一条别的路——单个 IUnawareModule / IEngagementModule 按设计只声明自己的态，
升级边由 PerceptionSkeleton 事后挂，单独构建时的死角是正常中间态而非缺陷。
为此加 BuildPartial()：跳过本项校验，其余照旧。

测试侧按语义分两类处理，没有一刀切：
- 概念上确实是终态的（Dead）标 .Terminal()，保留 Build() 的全量校验；
- 隔离验证单个模块/片段的部分图改用 BuildPartial()；
- AiScriptTests / AiDefinitionRegistryTests 的夹具经 GetOrBuildGraph 走生产
  Build()，给桩汇态补了回边——这两条本就该验完整图。
- 断言 Build() 因别的原因抛异常的用例原样保留。
PerceptionSkeleton 与嘲风图建的都是完整图，无需改动即通过——这本身就是覆盖。

验证：编译 0 错；EditMode 269/269（264 + 新增 5）。
加校验后曾有 49 条既有测试变红，全部为上述两类夹具，逐条按语义修正后转绿。

变异验证：注释掉 ChaoFengAi 里 PhaseTx 的 txDone 出边后，ChaoFengAiTests
8 条全部变红，报错精确点名 'PhaseTransition'；还原后复验 269/269。
本改动之前，同样的删除是零报错的——Boss 会静默锁死在过渡态，
这正是本校验存在的理由。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-31 13:21:07 +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
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 825cae7977 feat(enemy): PerceptionRecipeSO 配方资产 + SubclassSelector 模块下拉 
未发现层/交战层各用 [SerializeReference]+[SubclassSelector] 下拉挑选模块，
新增模块类自动出现在下拉里，无需改枚举或已有文件。默认交战模块仍为
RushEngagement——未配能力时建图必须显式报错，而非静默产出打不出手的图。
 2026-07-29 14:46:41 +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
joywayer acfba66c5d feat(enemy): 未发现层三模块（单一态/单向降级/定时交替） 2026-07-29 12:19:26 +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