讲解视频 — Pexo

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

生成一段清晰、配有旁白的讲解视频。你只需将用户的主题原样传递给托管的 Pexo 代理，并将最终结果交付给用户；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 获取各选项 URL（标为 A/B/C），展示给用户供其选择，然后执行 pexo-chat.sh "<选择>" --choice ；对 document 类事件，需主动向用户说明。
   • DELIVER → 执行 pexo-asset-get.sh <最终 assetId>，并将完整的资源 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 充值。待用户确认充值完成后重试。

示例

用户：“用一段 60 秒的视频讲解我们预算应用的工作原理。”

pid=$(pexo-project-create.sh "budgeting app explainer")
pexo-chat.sh "$pid" "Explain how our budgeting app works in a 60-second video."
# 告知用户：已提交，预计耗时约 15–20 分钟，https://pexo.ai/project/$pid
# 持续轮询 pexo-project-get.sh "$pid"，直至 nextAction 为 DELIVER，然后交付资源 URL。

脚本说明

错误代码及边缘情况处理 → references/TROUBLESHOOTING.md。