诊断快照与命令¶
GFDiagnosticsUtility 可在运行时聚合架构生命周期、事件系统、性能监视器、日志缓存、常见工具快照和外部贡献的诊断分区,并提供可注册的诊断命令入口。
阅读入口¶
- 快照与场景树诊断:
collect_snapshot()、内置诊断命令和只读场景树快照。 - 命令 Schema:诊断命令参数 schema、启停控制和 JSON 安全结果。
- 风险等级与认证:命令等级、认证 token、控制类命令和
DANGER命令保护。
使用边界¶
编辑器调试会话中的 GF Runtime Debugger 可读取命令目录、请求诊断快照,并向运行项目发送命令名和参数字典。该入口由 GFRuntimeDebuggerPlugin 和 GFRuntimeDebuggerTab 承载;运行侧返回值会经过 JSON 兼容归一化,以便树状视图和文本详情稳定展示。
诊断命令只提供统一调度和结果包装。若要暴露给远程开发工具、玩家可访问控制台或线上 GM 工具,项目层必须提供权限、脱敏、白名单和审计策略。编辑器调试器入口不绕过命令风险等级、认证 token 或 DANGER 命令保护。