用途：面向 RealityKit 开发中的常见故障提供系统化诊断流程，按症状逐项排查并标注预计节省的时间。
主要能力：覆盖八类症状——实体添加后不可见、AR 锚点不追踪或内容漂浮、3D 实体点击/拖拽手势无响应、帧率下降或卡顿、材质颜色或光照异常、物理体不碰撞或互相穿透、多人实体不同步、模拟器正常但真机崩溃。每类给出分支式检查清单与快速诊断代码片段。
必要用法：第一步强制开启调试可视化，在 RealityView 或 ARView 中设置 arView.debugOptions = [.showStatistics, .showPhysics, .showAnchorOrigins, .showAnchorGeometry]；若看不到碰撞形状，说明 CollisionComponent 缺失或配置错误，应先修复碰撞再调试手势或物理。可见性排查可打印 isEnabled、isEnabledInHierarchy、isAnchored、世界坐标、scale、是否有 ModelComponent 与子实体数量。手势问题需确认 CollisionComponent、visionOS 上的 InputTargetComponent，且手势应挂在 RealityView 上。性能问题检查实体数量、网格与材质资源是否共享、是否每帧创建组件、碰撞形状是否为网格、物理体数量与多边形数。物理问题需双方都有 CollisionComponent，并注意物理仅在同一锚点下的实体间生效。多人同步需 SynchronizationComponent、MultipeerConnectivityService 连接、自定义组件实现 Codable，且只有所有者可修改同步属性。
适用场景：iOS/visionOS 上使用 RealityKit 的 AR 与 3D 应用开发调试。
限制：资料未提供具体版本兼容范围、收费信息或完整 API 参考；架构模式与 API 细节需参考 axiom-realitykit 与 axiom-realitykit-ref。