用途：运行 video-studio 的 vs CLI，将一部影片的 shots.json 分镜提交给 Seedance，轮询并下载片段，再拼接为成片。每部影片是自包含的 films/<slug>/ 目录，含 shots.json、stills.json 和 CLI 维护的 tasks.json。它只负责“运行命令、选参数、按成本阶梯推进影片”，不负责撰写 shots.json / stills.json 内容（用 seedance），也不负责故事文档（用 storycraft）。
主要命令：vs init <dir> 搭建影片骨架（720p 默认）；vs doctor [task-id] 检查 Node、.env、密钥、ffmpeg 等；vs cast sync <shots-file> 把 characters.json 展开为 cast 块与设定图；vs stills <stills-file> 生成参考静帧；vs generate <shots-file> 提交、轮询并下载不可变片段；vs score <prompt> 生成 Lyria 3 Pro 配乐；vs narrate <lines.tsv> 与 narrate assemble 生成并放置旁白；vs status、vs use、vs download、vs animatic、vs review、vs stitch、vs upscale、vs share 负责状态、选版、下载、故事板、审阅、拼接、上采样与分享压缩。
用法：dist/ 过期先 npm run build，再 node dist/cli.js <cmd>（npm link 后可用 vs）。--help 是参数权威。生成是付费的：vs doctor 先查密钥与 ffmpeg，--dry-run 不花钱。跨命令通用 --dry-run、--json、--verbose、--draft。
限制与注意：720p 是生成目标而非 1080p，交付用免费的 vs upscale；Seedance 2.5 严格串行且更贵；非交互运行需 --yes，并配 --max-cost；结果 URL 约 24 小时过期；--force 只创建新版本；标题卡仅 macOS 支持，animatic/review/stitch/upscale 需要 ffmpeg；需要 AI_GATEWAY_API_KEY（或 VERCEL_OIDC_TOKEN）、ARK_API_KEY、GEMINI_API_KEY、ELEVENLABS_API_KEY 等。