完整文档
该知识库会根据用户反馈持续更新：
配套项目获取，以及迁移请查看：准备工作。
基于最新源码的最新文档请访问：https://yuewu.dev/docs/GenericAISystem
概述
GenericAISystem 为 UE5 项目提供可复用、可扩展的游戏 AI 框架，将玩家或 AI 的意图转化为相互协作的命令、小队、阵型、战术分配与分层 StateTree 行为。
文档与支持
为什么需要 Generic AI System？
单个 AI Actor 通常不难写。真正复杂的是多个单位要共享命令、角色、阵型、目标、战术任务和长期行为时，系统之间必须不断传递“谁该做什么、为什么做、做到哪一步”。如果没有一层稳定的编排模型，那么这些系统之间的集成和维护成本会不断提升。
- 如何让玩家命令、脚本动作和 AI 决策使用同一套命令生命周期？
- 如何把一组单位组织成有角色、容量、阵型和共享状态的小队？
- 如何让阵型给出每个单位的移动意图，同时不替代项目自己的移动系统？
- 如何把 attack、defend、support、hold、interact 等高层目标变成可验证的单位分工？
- 如何让长期模式和短期任务在 StateTree 中分层运行，而不是堆成一个巨型行为资产？
关键特性
用同一套 Command System 处理指令与 AI 决策
Command System 提供验证、立即执行、排队、插入、取消、结果和可替换执行定义。玩家输入、脚本事件和 AI 决策可以共用这一生命周期；Command Intent 能把同一个高层请求解析成不同单位各自能执行的具体命令。
把相关单位组织成可管理的小队
Squad System 管理成员、角色、容量、formation、共享状态和 小队级别的整体命令。它可以从现场单位创建或重组小队，自动补位，并让 StateTree 在成员、角色或组成变化时响应。
让 Formation 输出 movement intent
Formation System 支持可复用阵型资产、带权重/标签化的槽点、运行时切换和导航适配。它输出每个单位的 Movement Intent（运动倾向），再通过 driver 连接到 CharacterMovement 或项目自定义移动方案；也可通过Modifier临时调整间距、速度、朝向或战术偏移。
把战术目标分配给合适单位
Tactical Assignment 通过候选来源、过滤器、评分、allocator（分配）、和 target claims（目标占位），把高层目标转成 unit-to-target 工作。它可以使用 squad members、角色、给定 actors、EQS 结果或项目自定义来源，并在战场变化时重新评估。
分层组织 StateTree 行为
StateTree Stack 用命名层、优先级、覆盖和恢复管理复杂AI行为的拆分和解耦以及长期运行；StateTree Queue 运行短期有序任务。也可借由CommandSystem临时以最高优先级接管AI的当前行为。
深度Gameplay Debugger集成
内置丰富的Gameplay Debugger集成，让你以清晰的方式查看不同子系统的当前状态，以协助调试和开发。
适用项目与人群
- 即时战术与小队指挥游戏
- 小队制动作、策略和 RPG 项目
- 伙伴、队伍、巡逻组和可操控单位玩法
- 需要多单位协同、而不只是孤立行为角色的 AI 密集型项目
- 使用 StateTree、Gameplay Ability System、EQS、Gameplay Tags 或自定义 movement / combat 的团队
- 已有移动、战斗、动画或 UI 系统，并需要可复用协调层连接它们的项目
GAIS 不替代项目的移动、战斗、动画或 UI 实现，也不是一堆状态树模板。它更像这些系统之间的协作层：决定命令如何下发、单位如何成组、阵型如何表达目标、战术工作如何分配，以及 StateTree 如何承载长期和短期行为。
技术详情
代码模块（Code Modules）：
GenericAISystem（Runtime）GenericAIEditor（Editor）
依赖插件（Plugin Dependencies）：
StateTreeGameplayStateTreeModularGameplayGameplayAbilities
Blueprint 数量（Number of Blueprints）： 随配套项目提供
C++ 类数量（Number of C++ Classes）： 100+
网络复制（Network Replicated）： 是
开发支持平台（Supported Development Platforms）：
- Windows：是（Win64）
- Mac：是
支持的目标构建平台（Supported Target Build Platforms）： Win64、Mac、Android、Linux
配套项目（Companion Project）： 购买后通过购买验证提供
重要说明/附加说明（Important/Additional Notes）： 查看我的产品整体设计