用途：把一段文字提示或脚本，变成可直接发布的成品多镜头视频。自己不生成内容，而是把请求转交给 Pexo 托管的后端处理并交付结果；该后端会自动写脚本、按镜头挑选合适模型、生成每个镜头，并加上音乐、字幕和转场。用户提交的内容应原样转达，不应额外添加时长、风格或未要求的模型，否则会覆盖其判断、导致视频变差。
准备工作：先在 Pexo 获取 API 密钥并充值积分。配置文件位于 ~/.pexo/config，填入 PEXO_BASE_URL="https://pexo.ai" 与 PEXO_API_KEY="sk-<your-api-key>"。首次使用或无账号时，参考 references/SETUP-CHECKLIST.md 完成注册流程；配置出错时运行 scripts/pexo-doctor.sh 并按输出处理。
主要流程：1）用 pexo-project-create.sh "<short brief>" 创建项目并保存 project_id；2）用户提供了文件则用 pexo-upload.sh <project_id> <path> 上传，保存 asset_id，并以 <original-image>asset_id</original-image> 等标签内联引用，标签必需，Pexo 不能抓取 URL，需先下载再上传；3）用 pexo-chat.sh <project_id> "<用户原话与素材标签>" 提交请求；4）告知用户已提交、约需 15 到 20 分钟，并提供 https://pexo.ai/project/<project_id>；5）每隔至少 60 秒运行 pexo-project-get.sh <project_id>，按 nextAction 处理：WAIT 继续轮询，RESPOND 处理 recentMessages（转达文本、让用户在预览选项中挑选后再提交），DELIVER 用 pexo-asset-get.sh 获取资源并原样发送完整 URL 与项目链接，FAILED 解释 nextActionHint 并询问是否重试，RECONNECT 发送 "continue" 后继续轮询。WAIT 期间不要调用 pexo-chat.sh，以免触发重复制作。
修订：交付后用户的调整（如缩短、换音乐、换镜头）应复用同一项目并再次轮询，不要新建项目，否则会丢失服务端上下文。积分不足时按错误中的购买链接或 https://pexo.ai/home 的 Credits 处理，确认后再重试。超过 30 分钟仍未交付可提醒用户并询问是否继续等待。错误代码与边界情况见 references/TROUBLESHOOTING.md。