用途：把长视频自动转化为竖屏短视频片段，面向 YouTube Shorts、TikTok、Instagram Reels 等短内容平台。它是 AI Clipping 能力的平台预设封装，按目标平台选择画幅比例与片段数量，高光提取、去重和面部跟踪自动裁切由 muapi.ai 的托管 /ai-clipping 端点处理。
主要能力：服务端会转写音频，按传播性框架对高光打分（钩子时刻、情绪峰值、观点、反转、冲突、金句、故事高潮、实用价值），按分数对重叠候选去重，选出 Top-N 并做竖屏裁切；每个片段附带 0–100 分、开场钩子句和一句“为什么有效”的理由。
使用方式：需先安装并认证 muapi-cli（muapi auth configure），并具备 MUAPI_API_KEY。常用参数有 --source（YouTube URL、托管 mp4 URL 或本地文件）、--platform（shorts | tiktok | reels | feed，决定默认比例与片段数）、--num-clips、--aspect-ratio。运行命令：bash library/social/youtube-shorts/scripts/run-youtube-shorts.sh --source "<YOUTUBE_URL>" --platform shorts --num-clips 5 --view。脚本解析来源（本地文件上传到 muapi CDN）、套用平台默认值、调用端点、轮询至完成并输出排名摘要，可选下载或打开片段。异步方式可加 --async --output-json，再用 muapi predict wait "$REQUEST_ID" --download ./outputs。
平台默认：shorts 为 9:16、3 个片段；tiktok 为 9:16、5 个；reels 为 9:16、3 个；feed 为 1:1、3 个。
适用场景与限制：适合单条长视频或批量 URL 列表生成短视频；本地无需 ffmpeg、Whisper 或 LLM 密钥。若 API 返回片段少于请求数，说明可排序高光不足，应如实返回而非填充低分内容；片段 URL 失效时应按同一 request_id 重新获取而非重新剪辑；密钥缺失、任务超时或来源不可达时需对应处理，不要伪造密钥。