gaia-navigation

gaia-navigation 是面向游戏 AI 智能体的导航与寻路技能，核心是使用 navcat 与 navcat/three 生成导航网格并查询路径。资料说明导航网格是三维环境的简化表示，由相互连接的多边形定义可行走区域，多边形之间通过边和 off-mesh 连接相连。\n\n用途方面，该技能用于从三维场景几何体生成导航网格，并对智能体进行路径查找。资料给出的快速开始示例在 Three.js 中创建地板与箱体，提取几何体的 positions 与 indices，调用 generateSoloNavMesh 生成单块导航网格，再用 createNavMeshHelper 在场景中可视化，并用 findPath 计算起点到终点的路径，同时可视化路径点与 A* 搜索节点。\n\n主要能力包括：生成单块导航网格（generateSoloNavMesh）并输出中间结果用于调试；按智能体尺寸设置大量生成参数，如 cellSize、cellHeight、可行走半径、高度、坡度角、台阶高度、区域面积、简化误差、最大边长、多边形顶点数、细节采样距离与误差等；支持分步管线（标记可行走三角形、体素化高度场与过滤、构建紧凑高度场并按半径侵蚀、构建区域、构建轮廓、构建多边形网格与细节网格、转换为运行时格式、组装导航网格）；查询方面提供 findPath、findSmoothPath、findNodePath 与 findStraightPath、moveAlongSurface、raycast、findNearestPoly、findRandomPoint、findRandomPointAroundCircle，以及 off-mesh 连接。\n\n使用方式上，资料通过 TypeScript 代码示例展示从 navcat、navcat/blocks、navcat/three 导入函数，构建场景几何、提取位置与索引、设置生成选项、生成导航网格、可视化并寻路的完整流程，也展示了分步 API 调用与查询 API 调用。\n\n适用场景包括游戏 AI 寻路、三维场景中的智能体导航、简单角色控制器沿表面移动、视线检测、生成巡逻或出生随机点、跨越鸿沟或梯子等非相邻区域连接。限制方面，资料指出多数项目应从单块导航网格开始，只有需要动态更新、内存管理、并行生成或大型世界时才考虑分块导航网格；生成参数需按智能体尺寸调整以平衡细节与生成速度。具体收费、价格与平台信息暂未提供。