跳转至

风险等级与认证

诊断命令可设置风险等级与认证要求。默认只允许观察类命令;如果项目要把控制类命令桥接到远程调试或编辑器工具,应显式提高 max_command_tier 并按需要启用 token。

DANGER 等级即使在等级范围内,也需要额外设置 allow_danger_commands = true 才会执行。

diagnostics.set_auth_token("dev-token")
diagnostics.max_command_tier = GFDiagnosticsUtility.CommandTier.CONTROL
diagnostics.register_command(
    &"runtime.pause",
    Callable(self, "_diagnostics_pause"),
    "暂停运行时。",
    GFDiagnosticsUtility.CommandTier.CONTROL
)

控制类命令应默认只在本地开发或受控编辑器工具中开启。远程入口需要项目自己处理身份认证、参数白名单、审计日志、速率限制和敏感字段过滤。