队伍身份与调试参数

说明 GenericAISystem 中队伍身份、项目策略、蓝图辅助和调试参数的职责、使用场景与误配风险。

相关文档：功能说明见队伍身份与项目策略，接入流程见接入队伍身份与阵营，调试入口见 GameplayDebugger。

`UGAIS_TeamAgentComponent`

参数/事件	用途
`TeamId`	当前队伍身份，支持复制和 OnRep。
`bApplyTeamIdToMirrors`	是否把 TeamId 同步到 Owner、Controller 或接口镜像。
`SetTeamId`	权威端修改队伍 ID。
`OnTeamIdChangedEvent`	队伍 ID 变化广播。
`OnTeamIdChanged`	可覆写的变化钩子。

`UGAIS_ProjectPolicy`

方法	用途
`ResolveTeamAgent`	找到 Actor 对应的 TeamAgent。
`HasGenericTeamId`	判断 Actor 是否有有效队伍身份。
`GetGenericTeamId`	读取队伍 ID。
`SetGenericTeamId`	写入队伍 ID。
`GetGenericTeamQuerySource`	调试队伍信息来自哪里。

蓝图辅助

UGAIS_BlueprintFunctionLibrary、UGAIS_CommandFunctionLibrary、UGAIS_FormationFunctionLibrary 与 UGAIS_TacticalAssignmentFunctionLibrary 提供蓝图侧查询、数据构造和系统调用辅助。函数库适合连接项目 UI、输入或玩法逻辑，但不应替代资产配置、权威校验和明确的扩展点。

调试入口

FGAIS_GameplayDebuggerCategory_AI 负责显示 Blackboard、Stack、Queue、CommandSystem、Formation、Squad、Team 等摘要。槽位分配的 debug-only 解释受 GAIS_SQUAD_SLOT_ASSIGNMENT_WITH_DIAGNOSTICS 控制，Shipping/Test 不包含。