Agent Skills
返回列表
鲸剪

鲸剪

设计多媒体 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_60e07f3e/whaleclip。

技能介绍

解决什么问题

鲸剪桌面端适合人工操作，但无法被脚本或自动化流水线直接调用。当你想批量处理视频、把剪辑能力嵌入自动化流程时，逐个点击界面并不现实。这个技能把鲸剪桌面应用的命令行入口规范化，让 Agent 或脚本可以像调用普通 CLI 一样触发剪辑、字幕等处理任务，并拿到结构化的结果。

技能如何工作

  • CLI 入口：macOS 下通过 whaleclip-cli 调用，wrapper 指向 /Applications/鲸剪.app/Contents/MacOS/鲸剪 --cli；Windows 下执行 鲸剪whaleclip.exe --cli。
  • 输出约定：stdout 是单行 JSON，只解析包含 {…} 的行；进度信息（如 [queued]、[upload]）可能出现在 stderr，不要转发给用户。
  • 执行前检查：命令不在 allowedCommands 白名单时，先执行 whaleclip-cli cli enable --id <id>；token 过期时引导用户登录桌面端，或用 auth set-token --token <token> 更新；多数 AI 能力需要 VIP，可用 auth whoami 确认 isVip: true。
  • 详细参数：命令参数、配额与白名单规则集中在 WHALECLIP_CLI_SKILLS.md，调用前应先阅读其中的 §0（安全脱敏）、§2（CLI 入口）、§3（鉴权/配额）与 §4.3（回复规范）。

适用边界与注意点

  • 平台差异：MCP 剪辑与字幕在两个平台均为本机执行；数字人/声音克隆在 Windows 走本机、在 macOS 走云端；AI 画质修复仅 Windows 可用，macOS 上不要调用。
  • 配额限制：macOS 的云端数字人/声音克隆有每日配额，由服务端强制，CLI 无法绕过。遇到「次数已用完 / QUOTA_EXCEEDED」应停止重试，提示用户次日再试或在客户端查看配额。
  • 回复规范：对用户只说明是否成功、输出路径、失败原因与建议（登录/VIP/配额/路径），禁止暴露内部实现细节、技术名词、stderr 日志或 JSON 内部字段。
  • 失败排查：命令未开放时先 cli enable；token 过期重新登录桌面端；非 VIP 需开通或续费；未知命令则确认鲸剪已升级到最新版且安装正确。

使用场景

  • 批量处理多条短视频素材，通过 CLI 触发剪辑与字幕生成，避免在桌面端逐个手动点击。
  • 自动化流水线里需要给视频生成字幕并套用样式，解析 stdout 的单行 JSON 判断成功与否。
  • 在 macOS 上批量生成数字人播报视频，需要留意每日调用配额，防止触发 QUOTA_EXCEEDED。
  • 在 Windows 上做 AI 画质修复，调用前需确认命令在白名单内且 VIP 状态有效。

适合人员

  • 视频团队的自动化工程师，想把剪辑与字幕流程接入 CI 或定时任务。
  • Agent 应用开发者，需要通过 CLI 驱动桌面软件完成视频生成与处理。
  • 高频产出内容的内容创作者，希望用脚本批量管理字幕与数字人任务。
  • 桌面端工具维护者，需要排查 CLI 调用失败并给用户侧修复建议。