  joywayerandClaude Opus 5
|
6d3816d7ef
|
docs(enemy): Boss AI 单轨落地——新增作者指南，清理描述已删除系统的长期文档
新增 Docs/Guides/09_BossAi_Authoring_Guide.md：
定制路径写法（[AiDefinition] + AiScript）、建态原语（AiStateFragments +
BossFragments + IBossControl）、阶段=换招池、一招怎么配（EnemyAbilitySO +
EnemyAttackSO + 动画事件）、开战触发、死亡归物理层，
以已落地的 ChaoFengAi 为逐段范例，附 Boss 专属陷阱与已知缺口。
08 号指南加交叉引用。
删除两份整份描述已删除且从未实现的体系的文档：
Docs/Architecture/23_BossSkillModule.md、Docs/Design/47_BossSkillSystem.md。
删前已确认全库无 Markdown 链接残留，索引行与关联文档行改指新指南或 spec。
修订：25_CharacterArchitectureOverview §4 Boss 章节按实际代码重写；
07_EnemyModule 加过时提示、§11 改重定向；02_EventSystem 修正 Boss 事件发送方；
19_BossPatternLibrary 加废止提示（设计意图仍有效，类型名已废）；
AssetFolderSpec 删旧 Boss 技能编辑器条目；三处 README/索引同步。
Docs_Dev/ 历史记录保留不动。
spec 标记为已实施，并记录实施期偏差（无 Boss 骨架、Telegraph 枚举保留、
阶段直查不走黑板、BossSkillEvent 一并删除）与八项已知未完成项，
其中 EnemyHurtState 无受击动画永久卡死为最高优先级、且与 Boss 轨无关。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
2026-07-30 17:14:32 +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 |
|