Nova AI脚本报错“Script Fail”需按三步排查：一查注册状态，确认shebang及YAML元数据块格式正确；二验权限配置，补全permissions字段或校验context JSON合法性；三溯模型调用，通过调用链追踪定位503或401等网关错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Nova AI脚本运行报错时，控制台日志往往只显示“Script Fail”或空错误堆栈，根本看不出是模型调用超时、提示词格式错误，还是权限配置缺失——这导致开发者反复重启服务、重写脚本却始终卡在同一个地方。
确认脚本是否被Nova AI识别为合法可执行单元
第一步：打开Nova AI控制台 → 进入【脚本管理】页 → 查看目标脚本右侧的“状态”列。
若显示【Not Registered】，说明该脚本未通过Nova AI的注册校验。Nova AI要求所有脚本必须包含标准头部注释块，且首行必须为#!/usr/bin/env python3或#!/bin/bash（其他shebang不被识别）。
第二步：点击脚本名称进入编辑页 → 检查顶部是否存在如下结构的YAML元数据块（紧接在shebang之后，中间不能有空行）：
---<br>name: "data_cleaner"<br>version: "1.2"<br>runtime: "python3.11"<br>timeout: 30<br>---
缺少---包裹或字段名拼写错误（如写成verison）会导致注册失败，且控制台不会给出具体提示。
检查脚本执行上下文与权限绑定
方法一：通过控制台快速验证权限
进入【脚本详情页】→ 点击右上角【调试运行】→ 在弹出窗口中勾选“启用完整上下文注入” → 点击【立即执行】。
使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image（图像）和Qwen Wan 2.6（视频）。
若报错信息含Permission denied: access to /api/v1/metrics类路径，说明脚本声明的permissions字段缺失或不匹配。此时需返回脚本元数据块，补充：permissions: ["metrics.read", "logs.write"]（按实际调用的API接口填写）。
方法二：手动触发带上下文的CLI调试
在终端执行：nova-cli run --script-id abc123 --context '{"tenant_id":"t-8899","env":"staging"}'。注意【context必须为合法JSON字符串，不可用单引号或换行】，否则会触发解析错误且错误码固定为00611001。
定位模型调用层失败原因
当脚本中包含ai.invoke(model="qwen-plus", prompt=...)类调用时，错误通常不来自脚本本身，而是模型网关返回的上游响应。
进入【监控 → 调用链追踪】页 → 设置时间范围为最近5分钟 → 筛选service=nova-ai-gateway → 找到对应trace ID。
展开span列表，重点查看名为llm_proxy_call的节点：若其状态为503 Service Unavailable，说明模型服务端点不可达，需检查【系统设置 → AI服务配置】中qwen-plus对应的base_url是否仍为https://dashscope.aliyuncs.com/compatible-mode/v1（2026年6月起已强制要求HTTPS且禁用HTTP）。
若状态为401 Unauthorized，则不是密钥失效，而是Nova AI控制台中【凭证管理】页绑定的API Key未授予qwen-plus模型的调用权限——该权限需单独勾选，不随全局Key自动继承。
