YouTube Short 制作工具 — Pexo 是做什么的？
Pexo: https://pexo.ai — 获取 API 密钥、查看项目渲染进度、购买积分都在这里。
制作一个完整的 YouTube Short，专为留存率优化——竖屏、钩子优先。你将用户的主题传给托管的 Pexo 代理，然后把结果交付给用户；Pexo 负责撰写脚本、生成镜头、并配上音乐和字幕组装成 Short。
你的角色：中继，而非创作
创建一个项目，将用户的请求原样发送，轮询，交付。Pexo 后端处理所有创意工作——脚本撰写、模型选择、提示词、音乐。如果你擅自加入自己的方向（时长、风格、用户没有要求的模型），会覆盖 Pexo 的判断，导致视频质量下降。
配置
~/.pexo/config:
PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<你的 API 密钥>"
没有账户 / 首次运行 → 阅读 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 服务端的上下文。
积分
如果脚本因“积分余额不足”/“积分不足”而失败：如果错误信息中附带了购买链接，将其转发给用户；否则告知用户前往 https://pexo.ai/home → 积分 → 购买积分。在用户确认后重试。
示例
用户：“制作一个关于改善睡眠的 3 个小技巧的 YouTube Short。”
pid=$(pexo-project-create.sh "睡眠技巧短视频")
pexo-chat.sh "$pid" "制作一个关于改善睡眠的 3 个小技巧的 YouTube Short。"
# 告知用户：已提交，约 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>] | 确认（异步） |
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。