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>
This commit is contained in:
Claude Opus 5
@@ -1,8 +1,26 @@
|
||||
# 19 · Boss 攻击模式库（Boss Pattern Library）
|
||||
|
||||
> **命名空间** `BaseGames.Enemies.Boss.Patterns`
|
||||
> **所属文档集** [← 返回索引](./README.md) · [总览](./00_Overview.md)
|
||||
> **依赖** `BaseGames.Enemies` · `BaseGames.Combat` · `BaseGames.Feedback` · `BaseGames.Core.Events` · BehaviorDesigner · Animancer
|
||||
> **文档性质** 设计意图文档
|
||||
|
||||
---
|
||||
|
||||
> ## ⚠️ 本文描述的实现方案已废止（2026-07-30）
|
||||
>
|
||||
> 文中的 `AttackPatternSO` / `BossOrchestrator` / `TelegraphSystem` 三个类型**从未落地**，
|
||||
> 并已随旧 Boss 技能轨一并退役。当前实现：
|
||||
>
|
||||
> | 本文提出的 | 实际由谁承担 |
|
||||
> |---|---|
|
||||
> | `AttackPatternSO`（攻击模式数据层） | `EnemyAbilitySO` + `EnemyAttackSO`（小怪与 Boss 共用一套） |
|
||||
> | `BossOrchestrator`（运行时编排器） | `EnemyAiBrain` 上的 `AiScript` 定制图；选招归 `EnemyAttackSelector` |
|
||||
> | `TelegraphSystem`（预警系统） | 动画时间轴：预警是 clip 的一段，判定/VFX/音效/无敌帧全挂动画事件 |
|
||||
> | 阶段切换换招池 | `BossPhaseAbilityGate`（按阶段启停能力组件） |
|
||||
>
|
||||
> **本文的设计意图（攻击模式的节奏分层、预警的可读性、阶段递进的学习曲线）仍然有效**，
|
||||
> 但类型名与代码结构一律以下列文档为准：
|
||||
> - [`Docs/Guides/09_BossAi_Authoring_Guide.md`](../Guides/09_BossAi_Authoring_Guide.md)（作者指南）
|
||||
> - `Docs_Dev/superpowers/specs/2026-07-30-boss-ai-single-track-design.md`（设计依据）
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# 69 · Boss 设计圣经（Boss Design Bible）
|
||||
|
||||
> **所属文档集** [← 返回索引](./README.md) · [总览](./00_Overview.md)
|
||||
> **关联文档** 19_BossPatternLibrary · 47_BossSkillSystem · 60_Lore_WorldBible · 63_AudioCreativeDirection · 48_EnemyRoster
|
||||
> **关联文档** 19_BossPatternLibrary · 60_Lore_WorldBible · 63_AudioCreativeDirection · 48_EnemyRoster · 实现写法见 [`Docs/Guides/09_BossAi_Authoring_Guide.md`](../Guides/09_BossAi_Authoring_Guide.md)（原 47_BossSkillSystem 已于 2026-07-30 废止）
|
||||
> **文档性质** 每个 Boss 的独立设计规格。包含攻击序列、阶段结构、学习曲线、叙事角色、死亡设计。19_BossPatternLibrary 是工具，本文档是作品。
|
||||
|
||||
---
|
||||
|
||||
@@ -57,7 +57,7 @@
|
||||
| 44 | [关卡设计指南](./44_LevelDesignGuide.md) | 房间尺寸规范、难度曲线与节奏、敌人布置原则、危险物规范、收集品与秘密房间设计、平台路径参数、房间连通性、视觉叙事、Tilemap SOP、关卡验收清单 |
|
||||
| 45 | [教程与情境提示系统](./45_TutorialSystem.md) | ContextualHintTrigger、AbilityTutorialSequence、InGameHintPanel、TooltipPopup、TutorialManager、SaveData 集成（seenHints[]）、多语言支持 |
|
||||
| 46 | [平台发布集成指南](./46_PlatformIntegration.md) | IPlatformService 抽象接口、Steam PC/Deck 集成、Steamworks.NET 成就桥接、Steam Cloud 存档同步、Steam Rich Presence、多平台手柄振动适配、构建配置、发布验收清单 |
|
||||
| 47 | [Boss 技能系统框架](./47_BossSkillSystem.md) | BossSkillSO 数据层、技能分类体系（BossSkillCategory + InteractionTag）、脆弱窗口系统、玩家反制接口（PlayerCounterResponse）、技能序列系统（SkillSequenceSO）、Boss 资源/愤怒系统、场景联动接口（ArenaEventBus）、平衡数据模板、编辑器工作流 |
|
||||
| ~~47~~ | ~~Boss 技能系统框架~~ | **已于 2026-07-30 删除。** 该框架从未实现，且已被"Boss 与小怪单轨统一"取代：招式即能力（`EnemyAbilitySO`），阶段即招池（`BossPhaseAbilityGate`），决策即 AI 图（`EnemyAiBrain`）。作者指南见 [`Docs/Guides/09_BossAi_Authoring_Guide.md`](../Guides/09_BossAi_Authoring_Guide.md) |
|
||||
| 48 | [敌人图鉴](./48_EnemyRoster.md) | 5 区域 × 6-7 只普通敌人 + 5 只区域精英怪完整设计、AI 复杂度分级（T1-T4）、弹反标记、掉落表、房间编队配置建议 |
|
||||
| 49 | [防软锁系统](./49_AntiSoftlockSystem.md) | SoftlockDetector（45s 无移动检测）、EscapeTeleporter（安全传送回存档点）、RoomEscapeInfoSO（每间房逃生路线）、HardAbilityGate（高风险门扩展）、EscapeGuaranteeValidator（BFS 可达性编辑器工具）|
|
||||
| 50 | [叙事设计系统](./50_NarrativeDesignSystem.md) | NarrativeNodeSO 故事节点、WorldStateRegistry 全局状态标志、NarrativeNPC+DialogueVersion 世界状态对话版本、NPCMigrationConfigSO、LoreItemSO（题记/遗物/回忆/回响碎片）、EndingGate 结局评估、5阶段叙事弧线、NPC 迁移路线表 |
|
||||
|
||||
Reference in New Issue
Block a user