用途：基于阿里云百炼视频分析轻应用（QuanMiaoLightApp API）对视频进行智能理解与分析，输出镜头分析、ASR 转写、标题生成、字幕提取和思维导图等结果。架构为 CLI（凭证链）+ OSS（文件存储）+ 百炼工作空间 + 全妙视频分析服务 + Python SDK 脚本。
主要能力：提交视频分析任务并轮询结果，支持本地文件或可下载 URL 作为视频源；自动检测工作空间与 OSS Bucket，上传文件并生成临时签名 URL；结果保存至 ~/.quanmiao/videoanalysis/ 并写入 index.jsonl 索引，便于缓存复用。输出语言按用户输入语言、环境语言、默认中文的优先级处理，代码、API 响应、路径等技术标识保持原语言。
使用方式：先安装依赖 python -m pip install -r scripts/requirements.txt，并确保 Aliyun CLI >= 3.3.1，运行 aliyun configure set --auto-plugin-install true，再执行 aliyun configure ai-mode enable 与 aliyun configure ai-mode set-user-agent AlibabaCloud-Agent-Skills/alibabacloud-bailian-videoanalysis。用 aliyun configure list 检查凭证，禁止读取或回显 AK/SK。运行 python scripts/check_env.py 验证环境，用 aliyun modelstudio list-workspaces 获取工作空间，本地文件经 aliyun ossutil cp 上传至 /temp/quanmiao/YYYYMMDD/ 路径并用 aliyun ossutil sign 生成临时 URL，随后调用 python scripts/quanmiao_submit_videoAnalysis_task.py 提交任务，再用 python scripts/quanmiao_get_videoAnalysis_task_result.py 轮询至 SUCCESSED。
适用场景：需要对视频做内容理解、字幕与镜头拆解、要点提炼或思维导图生成的场景。
限制：必须使用云端 QuanMiaoLightApp API，禁止使用 ffmpeg、whisper、OpenCV 等本地工具回退；需先在百炼控制台开通视频分析服务并授予 RAM 与百炼工作空间权限，否则可能返回 403；临时 URL 默认 14400 秒过期；轮询最多约 180 次（约 30 分钟）。