updream ai agent调用skill无响应或输出空白，主因是skill未被显式连线触发、预演台未启用或人设id未绑定、下游字段映射不匹配、references编码错误或runtime声明缺失。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
updream AI Agent调用Skill后界面无响应、输出空白或卡在“正在执行”状态，不是模型没算完，而是Skill工作流在画布里断在了某个隐性环节——可能是预演台未激活、人设资产未绑定、或是技能输出被上游节点静默过滤。
确认Skill是否真被触发
在updream画布中点击右上角「调试模式」→打开「节点日志」面板→执行一次调用；如果日志里完全没出现该Skill名称和输入摘要，说明根本没进到执行层。这时要检查画布连线：Skill节点必须被上游「剧本拆解」或「分镜脚本」节点的输出端口明确连接，不能只靠文字描述触发。updream不支持自然语言唤醒，【所有Skill都必须通过显式连线激活】。
若日志中显示“已调用”，但后续无任何输出记录，跳转到下一环节。
检查预演台是否启用并匹配人设
方法一：点击画布顶部「预演台」标签→确认右上角开关为开启状态→查看左侧「人设资产库」是否已加载当前剧情所需角色（如“悬疑女主”“反派AI”）。
方法二：双击Skill节点→在右侧属性面板中找到「运行依赖」→确认「预演台激活」打钩、「人设ID」字段非空且与预演台中激活角色一致。updream的Skill默认不读取全局人设，【必须手动指定人设ID，否则输出会因缺失角色锚点而返回空字符串】。
这一步操作起来很简单，直接把预演台里角色ID复制粘贴过去就行。
验证输出结构是否被上游节点过滤
第一步：找到连接该Skill的下游节点（比如「视频渲染」或「字幕生成」）→双击打开配置面板。
第二步：检查「输入字段映射」区域——如果这里写了类似“content → script_text”这样的映射，但Skill实际输出的是{“narrative_flow”: […], “visual_cues”: […] }结构，就会因字段名不匹配导致数据丢失。
第三步：临时删掉下游节点，把Skill输出端口直接拖到画布空白处→点击「预览输出」。如果此时能看到完整JSON结果，就证实是下游字段映射错误。修复方式：要么修改下游节点的映射字段名，要么在Skill的SKILL.md里用output_schema明确声明输出键名，例如：
output_schema:
type: object
properties:
script_text:
type: string
排查Skill内部依赖是否就绪
打开Skill文件夹→检查是否存在references/目录→若存在，确认其中的.md文档是否全部可读（无中文乱码、无路径含空格）。updream在加载references时遇到编码错误会静默跳过，不报错也不提示。
进入scripts/子目录→查看是否有.py或.js执行文件→若有，确认其首行是否包含#!/usr/bin/env python3或// updream-runtime: node，并且文件权限为可执行（Linux/macOS需chmod +x）。Windows用户忽略权限，但必须确保文件扩展名与runtime声明一致。
这一步容易被忽略：如果Skill依赖外部API（如调用updream内置的“运镜分析”服务），需在SKILL.md的requires字段中显式声明，例如：
requires:
- updream://visual/shot_analysis
未声明则会被运行时拦截，返回空结果。
