先定位层级

配置和资源问题应先用 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