先定位层级
配置和资源问题应先用 validate、expand、explain 与 lock 工具定位,不需要启动后端。运行问题再区分 Application 生命周期、Plugin binding、UniRoboSim 能力和具体 Provider 行为,避免直接把所有异常归因于物理引擎。
运行时检查
暂停应在完整 tick 边界生效,并保留世界用于 scene、frame、geometry、control target、插件状态和输出检查。单步用于确认一个受控边界的变化,不等同于随意调用后端 step()。
可视化通道
Application visualization API 发布点、线、frame、文本、metric 与 event 等稳定描述。Provider 可以原生绘制,Server 可以远程传输,记录系统可以保存;发布者不需要知道最终 UI。
证据而非截图替代事实
截图和视频适合证明可见行为,但应与结构化 run ID、plan digest、generation、tick、插件状态和错误日志一起保存。只有图片无法证明使用了哪份配置或资源。
常见排查路径
| 现象 | 最先检查 |
|---|---|
| Run 无法编译 | 配置诊断、Project、Registry 与资源 digest |
| 能编译但无法 prepare | Provider/插件发现与能力要求 |
| reset 后出现旧命令 | generation、Operation 与订阅清理 |
| UI 有内容但控制失败 | control targets、binding 与 authority |
| 输出不完整 | 插件终结、staging 校验与发布状态 |
公共可视化门面见Application SDK,远程表面见Server REST API。