用途：在 comfy CLI 命令失败时进行自下而上的排查。核心是每个命令都会输出标准 JSON envelope，其中 error.code 映射到对应修复，hint 为权威建议，details 说明原因。
主要能力与用法： 服务器未运行（本地）：运行 comfy launch，或 comfy launch --background；若该命令失败，检查 comfy --json env 解析出的解释器与工作区，并查看其 stdout。 云端未配置或未授权：comfy cloud login（浏览器 OAuth + PKCE），或用 comfy cloud set-key --key sk-… 作为后备；用 comfy --json cloud whoami 确认 signed_in。鉴权优先级为 OAuth 优先：活跃会话高于 COMFY_CLOUD_API_KEY 环境变量，再高于存储的 key；陈旧会话导致 401 时先 comfy cloud logout 再登录，设置 API key 无法覆盖活跃会话。自定义环境先 comfy cloud set-base-url。 transient_auth：API 节点服务端会话在中途过期，与本地凭证无关，重新提交即可：comfy --json run --workflow same_workflow.json --where cloud。 workflow_not_api_format：客户端用 object_info 转换；conversion_error 时在 ComfyUI 用 File > Export (API) 重新导出，cql_no_graph 时重试或启动本地服务器。workflow_invalid_json：检查首尾 100 字节，常见为误存的 HTML 错误页。 prompt_rejected：details.node_errors 含逐节点错误；未知 class_type 用 comfy --json nodes search 名称，为 0 或 close_match 为真则节点缺失，本地用 comfy node install；缺模型文件时用 comfy --json nodes show CheckpointLoaderSimple 查看 choices，用 comfy --json env 查看 models 路径。 cloud_http_error：401 多为 token audience 不匹配；404 返回 XML 多为路径错误；503 查云控制台或日志。cloud_rate_limited（429）不是工作流问题，等待 retry_after，重新运行前先用 comfy jobs ls --where cloud 确认；--wait 轮询时遇 429 说明已提交，改用 comfy jobs watch。cloud_payment_required（402 或旧式 429）为套餐限制，不重试不修改，转达服务器消息。cloud_timeout 为每事件静默超时（默认 120 秒，有进度则重置），可加大 --timeout 或异步提交后用 jobs watch --max-wait。ws_timeout/ws_disconnected 本地用 comfy jobs status 或 comfy --json-stream jobs watch 重新附加。 cql_query_invalid：不存在查询语法，改用标志过滤。cql_no_graph：需要 object_info.json，可 comfy launch 或 comfy nodes ls --input。internal_error 为 CLI 缺陷，看 details.exception 与 traceback，不要循环重试。 注意：comfy generate 仅部分可机器读取；卡住任务按 jobs ls、jobs status、jobs watch 三步排查；用 comfy jobs cancel 取消。不要改模型目录权限、不要删 OAuth 会话来重置。诊断困难时用 comfy --json env、which、cloud whoami 及本地/云端日志。
限制：以上为资料原文所述行为，未提供的内容（如具体平台版本、计费价格）暂未提供。