WayinVideo — 借助 AI 工具掌握视频编辑与理解

什么是 WayinVideo？

WayinVideo 是一款基于人工智能的视频编辑与分析平台，旨在通过几次点击即可简化复杂的视频处理任务，例如提取爆款高光片段、使用自然语言搜索特定时刻、生成结构化摘要、提供高质量语音转文字（transcription）等。WayinVideo 不仅面向用户提供友好的图形界面（GUI），还提供 API 接口，供智能体（agents）自动化其工作流。无论您处理的是在线 URL（YouTube、TikTok 等）还是本地文件，WayinVideo 均支持高度可定制的导出选项，如 AI 重构帧（reframing）与自动加字幕（captioning），助您将内容快速适配至任意平台。本技能集包含 WayinVideo CLI 工具，它大幅简化了 API 的调用流程，并支持持久化保存用户偏好设置。

安装与配置

检查 WayinVideo CLI 是否已安装：wayinvideo --help。

• 推荐方式：以本地包形式安装：pip3 install -e /wayinvideo-cli
• 免安装方式：若您不希望安装，可将所有 wayinvideo 替换为以下命令： PYTHONPATH=/wayinvideo-cli python3 -m wayinvideo

快速入门

请按以下简易工作流高效使用 CLI：

1. 检查运行环境：确保已设置环境变量 WAYIN_API_KEY。
2. 确认视频来源：
   • 若为受支持的 URL（YouTube、Vimeo、Dailymotion、Kick、Twitch、TikTok、Facebook、Instagram、Zoom、Rumble、Google Drive），直接进入第 4 步。
   • 若为不受支持的 URL，请先下载该视频。
   • 若为本地文件（或已下载完成），进入第 3 步。
3. 上传本地视频：运行 wayinvideo upload --file-path 获取视频的 identity（唯一标识符）。
4. 提交任务：使用 wayinvideo submit --url "" 并指定所需参数选项。
5. 轮询结果：使用 wayinvideo poll --type --id 跟踪任务进度并获取最终结果。

WayinVideo CLI 支持哪些功能？

WayinVideo 提供多种专业化任务类型，以满足不同用户需求：

您在提交任一任务前，必须阅读对应的任务文档。

如何选择合适任务类型

• “让它爆红” / “给我一些高光片段” → 使用 clip。最适合宽泛、主观性强的请求。
• “他们在哪提到 X？” / “找出猫跳跃的画面” → 使用 search。专为明确搜索意图设计。
• “这个视频讲了什么？” / “总结一下这次会议” → 使用 summarize。适用于宏观层面的理解需求。
• “我需要完整脚本” / “Y 这句话是谁说的？” → 使用 transcribe。最适合获取详细文本证据及说话人追踪。
• “把字幕改成双语” / “把这些片段裁成 9:16” → 使用 export。适用于对先前 clip 或 search 结果进行二次渲染。

高级用法

后台轮询（Polling in the Background）

轮询可能耗时较长。建议尽可能将 wayinvideo poll 作为子智能体（subagent）或后台任务运行，从而让您在子智能体处理任务的同时保持对用户的响应能力。

并行处理：对于涉及多个视频或多任务并发的场景（例如，对同一视频同时执行 clip 和 summarize），强烈建议启动多个并行子智能体或后台任务，实现并发执行，显著缩短总耗时（wall-clock time）。

专业提示： OpenClaw 用户可使用 --event-interval 300 参数，启用每 300 秒（默认为 0，即禁用）通过 openclaw CLI 发送一次进度更新。

• 收到提醒后，请向用户同步当前进度。
• 主动每隔 2 * --event-interval 秒检查一次子智能体 / 后台任务状态：
  • 若任务仍在运行，及时告知用户处理仍在进行中（例如：“处理仍在进行中；由于视频较长，可能还需稍等片刻”）。
  • 若任务已失效（崩溃或异常终止），请通知用户并提供重试选项（重新开始轮询或重新提交任务）。

自定义用户偏好设置

• 识别行为模式：定期回顾用户的近期任务与交互记录，识别其稳定偏好（例如目标语言、双语字幕、特定字幕样式或画幅比例）。
• 持久化配置：使用 wayinvideo config set 将这些偏好全局保存，提升体验流畅性与个性化程度。示例：
  • wayinvideo config set defaults.target zh
  • wayinvideo config set defaults.clip.ratio RATIO_9_16

结果汇报规范

若 WayinVideo CLI 在本地生成输出文件，则响应中必须始终包含文件路径。若用户请求视频转录（transcription），请务必询问是否需将字幕转换为通用格式（例如 .txt）。

若结果中提供了 export_link：

1. 检查链接有效期：
   • 若项目已过期（提交后满 3 天），请通知用户并重新提交任务。
   • 若 export_link 已过期（距离最近一次轮询已超 24 小时），请再次运行 wayinvideo poll --type --project-id 刷新链接。
2. 提供可点击链接：始终将 export_link 以 Markdown 可点击链接形式呈现。严禁截断、缩短或修改该链接。
3. 下载视频：若用户希望下载视频或本地使用，请执行：curl -L -o ""。

复杂场景处理

执行以下任务前，您必须通读对应的高级文档。

核心原则

1. 穷尽所有可能性：除非已尝试所有工具、参数与工作流组合，否则不得声称某项任务“无法完成”。不存在借口——只有创造性的问题解决与持续不懈的尝试。
2. 先行动，再提问：优先使用手头可用的工具开展操作，而非等待许可。当确需向用户澄清时，务必附带诊断数据或状态更新作为依据。切勿依赖记忆——所有事实均须首先通过文档或日志验证。
3. 做主人，不做 NPC：对端到端交付结果负全责。主动管理后台任务、应对链接过期问题，并在无需用户催促的前提下交付最终成果。推动进展，而非被动响应。