SaaS视频 — Pexo 是做什么的？
Pexo: https://pexo.ai — 在此获取API密钥、查看项目渲染进度并购买积分。
制作成品SaaS演示或解说视频。您将软件的描述（或其URL或截图）传递给托管的Pexo代理，并交付结果；Pexo负责编写脚本、生成视觉素材，并添加旁白和字幕。
您的角色：传递，而非创造
创建项目，逐字发送用户请求，轮询，交付。Pexo后端处理所有创意工作——脚本编写、模型选择、提示词、音乐。添加您自己的指示（用户未要求的时长、风格、模型）会覆盖其判断，产生更差的视频。
配置
~/.pexo/config：
PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<your-api-key>"
无账户/首次运行 → 阅读 references/SETUP-CHECKLIST.md 并引导用户完成——它包含注册流程，附带为新用户提供奖励积分的邀请码，以及如何创建上述配置。配置错误 → 运行 scripts/pexo-doctor.sh 并遵循其输出。
工作流程
脚本位于此技能的 scripts/ 目录中。以用户使用的语言回复。
- 创建项目：
pexo-project-create.sh "<简短摘要>"→ 保存project_id。 - 上传用户提供的任何文件：
pexo-upload.sh <project_id> <路径>→ 保存asset_id，使用<original-image>asset_id</original-image>（或<original-video>/<original-audio>）内联引用。标签是必需的——裸asset_id会被忽略。Pexo无法爬取URL——请下载后再上传。 - 发送请求：
pexo-chat.sh <project_id> "<用户的准确表述> <资源标签>"。准确复制用户的原话；仅添加资源标签。 - 告知用户（使用他们的语言）：已提交 ✓ · 约15–20分钟 ·
https://pexo.ai/project/<project_id>。 - 轮询： 每≥60秒运行
pexo-project-get.sh <project_id>并根据nextAction进行操作：- WAIT → 继续轮询；每约5次轮询发送一行更新，附上项目链接。
- RESPOND → 处理
recentMessages中的每个事件：传递Pexo的文本（如果它提问则等待用户回答，然后使用pexo-chat.sh回复用户的回答）；对于preview_video，运行pexo-asset-get.sh <project_id> <assetId>获取每个选项，显示URL（A/B/C），让用户选择，然后运行pexo-chat.sh <project_id> "<选择>" --choice <assetId>；对于document事件，向用户提及。 - DELIVER → 运行
pexo-asset-get.sh <project_id> <最终assetId>，然后将完整的资源URL以纯文本形式发送给用户——保留所有?…查询参数，绝不要截断或用markdown包裹——同时附上项目链接。 - FAILED → 用通俗的语言解释
nextActionHint，并提供重试选项。 - RECONNECT → 运行
pexo-chat.sh <project_id> "continue"，告知用户连接已断开，正在恢复，然后继续轮询。 - 绝不要在WAIT期间调用
pexo-chat.sh——这会触发重复生产。 - 耗时过长 → 如果超过30分钟仍处于WAIT状态，告知用户（附上项目链接 +
https://pexo.ai/connect/openclaw）运行时间较长；询问是继续等待还是停止。不要无限轮询。
修订
交付后，用户的调整（“缩短”、“换音乐”、“换镜头”）复用同一项目：运行 pexo-chat.sh <project_id> "<他们的反馈>"，然后再次轮询（步骤5）。修订时绝不要创建新项目——这会丢弃Pexo服务端的上下文。
积分
如果脚本因“Credits balance”/“Insufficient credits”失败：如果错误信息包含购买链接，将其传递给用户；否则告知用户在 https://pexo.ai/home → Credits → Buy Credits 添加积分。用户确认后重试。
示例
用户：“为我们的SaaS（自动化费用报告）制作一个60秒的演示视频。”
pid=$(pexo-project-create.sh "SaaS demo video")
pexo-chat.sh "$pid" "Make a 60-second demo video for our SaaS that automates expense reports."
# 告知用户：已提交，约15–20分钟，https://pexo.ai/project/$pid
# 轮询 pexo-project-get.sh "$pid" 直到 nextAction 为 DELIVER，然后交付资源URL。
脚本
| 脚本 | 用法 | 返回值 |
|---|---|---|
pexo-project-create.sh | "<摘要>" | project_id |
pexo-upload.sh | <project_id> <文件> | asset_id |
pexo-chat.sh | <project_id> "<消息>" [--choice <id>] | ack（异步） |
pexo-project-get.sh | <project_id> | JSON：nextAction, recentMessages |
pexo-asset-get.sh | <project_id> <asset_id> | 包含 url 的JSON |
pexo-doctor.sh | — | 设置诊断 |
错误代码和边界情况 → references/TROUBLESHOOTING.md。