SaaS 视频 — Pexo

Pexo： https://pexo.ai — 获取 API 密钥，查看项目渲染进度，并在该平台购买积分。

制作完成的 SaaS 演示视频或功能讲解视频。您将软件描述（或其 URL、截图）提交给托管的 Pexo agent，即可获得最终成片；Pexo 自动撰写脚本、生成画面，并添加旁白与字幕。

您的角色：中转，而非创作

创建项目 → 原样转发用户请求 → 轮询状态 → 交付结果。Pexo 后端负责全部创意工作——包括脚本撰写、模型选择、提示词工程、配乐等。若您额外加入主观指令（如指定时长、风格，或用户未要求的模型），将覆盖 Pexo 的自主判断，导致成片质量下降。

配置

~/.pexo/config：

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-"

无账号 / 首次运行 → 请阅读 references/SETUP-CHECKLIST.md 并引导用户完成流程——其中包含带邀请码的注册流程（新用户可获赠额外积分），以及上述配置文件的创建方法。配置错误 → 运行 scripts/pexo-doctor.sh 并按其输出提示操作。

工作流

相关脚本位于本技能的 scripts/ 目录下。请使用用户的语言回复用户。

1. 创建项目：pexo-project-create.sh "<简短说明>" → 保存返回的 project_id。
2. 上传用户提供的任意文件：pexo-upload.sh <路径> → 保存返回的 asset_id，并在请求中以内联方式引用为 asset_id（或 / ）。标签为必填项——仅提供裸 asset_id 将被忽略。Pexo 不支持直接抓取 URL，请先下载再上传。
3. 提交请求：pexo-chat.sh "<用户原始文字> <资产标签>"。务必逐字复制用户输入，仅追加资产标签。
4. 告知用户（使用其语言）：已提交 ✓ · 预计耗时约 15–20 分钟 · https://pexo.ai/project/。
5. 轮询状态：每 ≥60 秒执行一次 pexo-project-get.sh ，并依据响应中的 nextAction 字段采取对应操作：
   • WAIT → 继续轮询；每约 5 次轮询后，向用户发送一行简明更新（含项目链接）。
   • RESPOND → 处理 recentMessages 中的每条事件：原样转发 Pexo 返回的文本（若其提问，则等待用户回复后，再用 pexo-chat.sh 提交）；遇到 preview_video 事件时，对每个选项分别执行 pexo-asset-get.sh ，展示 A/B/C 对应的 URL，由用户选择后，执行 pexo-chat.sh "" --choice ；遇到 document 事件时，需主动向用户说明。
   • DELIVER → 执行 pexo-asset-get.sh ，然后将完整的资源 URL 以纯文本形式发送给用户（保留全部 ?… 查询参数，不可截断或包裹在 Markdown 中），同时附上项目链接。
   • FAILED → 用通俗语言解释 nextActionHint，并主动提供重试选项。
   • RECONNECT → 执行 pexo-chat.sh "continue"，告知用户连接已中断、正在恢复，并继续轮询。
   • 在 WAIT 状态期间切勿调用 pexo-chat.sh——否则会触发重复生成。
   • 耗时过长 → 若已持续 >30 分钟仍处于 WAIT 状态，请告知用户（附项目链接 + https://pexo.ai/connect/openclaw）当前处理时间偏长；询问是否继续等待或终止任务。禁止无限轮询。

修改（Revisions）

交付成片后，用户提出的调整（如“缩短时长”、“更换音乐”、“切换镜头”）均应在同一项目中进行：pexo-chat.sh "<用户反馈>"，随后再次轮询（即步骤 5）。切勿为修改新建项目——这将丢失 Pexo 服务端已建立的上下文。

积分（Credits）

若脚本因“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。

脚本列表

错误码与边界情况详见 references/TROUBLESHOOTING.md。