用途：通过 video-motion-previs CLI 操作 Motion Previs Studio v4 的本地控制 API，对参考视频做分析与制作包导出。它是对上游 MCP 桥接的封装，读取应用仅限 localhost 的令牌保护发现描述文件，调用同一套允许列表动作。它不是完全无头渲染器：MediaPipe、ffmpeg、UI 状态、分析与导出都由运行中的 Electron 应用负责，CLI 只是控制面。
主要能力：支持导入本地文件或 URL（兼容 Web 视频由 yt-dlp 下载）、设置时间范围与模式、配置采样参数、执行分析、导出制作包并列出产物。模式有 camera_only、actor_motion、object_motion、full_scene；设置项包括 sampleFps、maxPeople、smoothing、detectionConfidence、trackingConfidence、resolution（auto 或 720p），时间单位为秒。允许列表动作共 11 个：get_state、import_file、import_url、set_range、set_mode、set_settings、run_analysis、export_pack、list_bundle、send_to_blockout、screenshot。
使用方式：先运行 node scripts/video-motion-previs.mjs check 检查环境，按需 install，再 launch 启动并用 state 确认连通。可分步执行 import-file、set-range、set-mode、set-settings、analyze、wait --timeout 900、export、list-bundle，或用 workflow 一次性完成已审批的输入。需要高级自动化时可使用 call 调用原始动作。用于 MCP 客户端时可指向上游零依赖桥接，应用必须保持运行。
适用场景：参考视频分析、动作预演制作包生成、向下游 Blender 或 ComfyUI 输送控制层数据。
限制：需要运行中的应用；导出前应确认 analysis.status 为 done；可选层（如深度、Blockout）并不保证总是可用；健康检查失败需重启应用；令牌不得写入报告或提交文件；各平台安装策略不同，Linux 需显式配置 ffmpeg/ffprobe。价格与收费信息暂未提供。