用途:分析单个本地视频。运行 scripts/analyze_video.py,模型固定为 muse-spark-1.2-contributor,不得替换或增加模型选择。
必要用法:将视频解析为绝对本地路径;原样保留用户的分析提示;确认 META_MUSE_KEY 存在但不打印其值。基础命令:python "<skill-directory>\scripts\analyze_video.py" "C:\absolute\path\video.mp4" --prompt "Describe the requested analysis"。长或多行提示可写入临时 UTF-8 文本文件并用 --prompt-file;需要保存结果时用 --output。CLI:analyze_video.py VIDEO (--prompt TEXT | --prompt-file FILE) [--output FILE] [--json] [--keep-upload] [--timeout SECONDS]。命令行不支持提示时读取重定向 stdin 或交互询问;--json 输出机器可读结果;进度与警告写 stderr,分析结果写 stdout。
限制与规则:仅从 META_MUSE_KEY 读取密钥,仅经 https://api.meta.ai/v1 使用 Contributor 模型;上传前检查模型目录,若无 Contributor 访问权限则停止,不回退到标准模型。视频经 Files API 上传并附加到 Responses API 请求,响应后(含失败)删除远程文件,仅用户明确要求时用 --keep-upload。不静默预处理、转码、缩短或拆分;格式或大小被拒时报告并先询问。Contributor 上传视为外部共享数据,发送敏感内容前需警告。密钥不得打印、记录、持久化或复制。API 错误需足够诊断但不暴露密钥。