小马的 AI 工具集

影视解说

教 AI Agent 调用 narrator-ai-cli，一句话自动生成电影解说视频

影视解说
类型 技能 1,313 星标 更新 2026-06-03 许可 MIT 原仓库

中文文档

在你的 AI agent（OpenClaw、Windsurf、WorkBuddy 等）中安装此 Skill，然后只需说“创建一个电影解说视频”——AI 负责其余部分。

这是什么？

一个机器可读的技能文件（SKILL.md），用于指导 AI agents 如何使用 narrator-ai-cli 工具进行自动视频解说制作。

你说：“为《飞马》创建一个喜剧风格的解说视频”

AI 执行：搜索电影 → 选择模板 → 选择 BGM → 选择配音 → 生成脚本 → 合成视频 → 返回下载链接

CLI 和 Skill 如何协同工作

CLI（命令行工具）Skill（能力描述）
是什么一组可执行命令指导 AI 如何使用这些命令的指令
类比厨房工具一本食谱
能否单独工作？可以，手动在终端中执行不能，需要 CLI

简而言之：CLI 是双手。Skill 是大脑。 两者结合，AI agent 可以端到端地制作视频。

快速开始

步骤 1：安装 CLI 工具

pip install "narrator-ai-cli @ git+https://github.com/NarratorAI-Studio/narrator-ai-cli.git"

查看 narrator-ai-cli 了解详细的安装选项。

步骤 2：配置 API 密钥

narrator-ai-cli config set app_key <your_app_key>

📧 需要 API key？发送邮件至 merlinyang@gridltd.com 或扫描本页底部的二维码。

步骤 3：安装 Skill

该技能包含 SKILL.md 和 references/ 目录——两者都是必需的。将仓库直接克隆到你的 agent 技能文件夹中：

OpenClaw:

mkdir -p ~/.openclaw/skills
git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \
  ~/.openclaw/skills/narrator-ai-cli

Windsurf / Claude Code:

mkdir -p /path/to/your/project/.skills
git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \
  /path/to/your/project/.skills/narrator-ai-cli

Cursor:

mkdir -p /path/to/your/project/.cursor/rules
git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \
  /path/to/your/project/.cursor/rules/narrator-ai-cli

任何支持 Markdown 的 agent:

mkdir -p /path/to/agent/skills
git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \
  /path/to/agent/skills/narrator-ai-cli

WorkBuddy / QClaw（腾讯）:

通过技能管理界面上传 SKILL.md 和整个 references/ 文件夹，保持目录结构不变（references/ 必须作为与 SKILL.md 同级的子文件夹——不要平铺文件）。

💡 提示：之后要更新技能，只需在克隆的目录中运行 git pull。

步骤 4：开始对话！

安装完成后，使用自然语言：

  • “为《肖申克的救赎》创建一个解说视频”
  • “告诉我有哪些电影可用”
  • “为不同的动作片制作 5 个解说视频”
  • “使用喜剧模板，生成一个解说”

已测试平台

平台设置方式状态
OpenClawgit clone 到 skills 目录✅ 已验证
Windsurfgit clone 到 .skills 目录✅ 已验证
WorkBuddy（腾讯）上传 SKILL.md + references/ 中的所有文件✅ 已验证
QClaw（腾讯）上传 SKILL.md + references/ 中的所有文件✅ 已验证
Youdao Lobstergit clone 到 skills 目录✅ 已验证
Yuanqi AIgit clone 到 skills 目录✅ 已验证
Claude Codegit clone 到项目 .skills 目录✅ 已验证
Cursorgit clone 到 .cursor/rules 目录✅ 已验证
任何支持 Markdown 技能的 agentgit clone 仓库，将 agent 指向 SKILL.md✅ 兼容

能力

功能详情
两种工作流路径Adapted Narration 和 Original Narration
三种创作模式Hot Drama / Original Mix / New Drama
内置资源~100 部电影，146 首 BGM，63 种配音，90+ 解说模板
完整管线脚本 → 剪辑数据 → 视频合成 → 视觉模板
独立任务声音克隆，文本转语音
数据流映射哪个输出作为哪个输入
错误处理全部 18 个 API 错误码及建议操作
成本估算创建任务前的预算检查

SKILL.md 包含什么

章节描述
Frontmatter技能元数据（名称、描述、需求）
Reference Index指向 references/ 中详细查找表的指引（资源、工作流、magic-video、操作）
Pipeline at a GlanceFast Path 和 Standard Path 的 ASCII 图
Agent Rules强制规则：行动前确认、语言链、轮询模式等
Prerequisites假设已安装 narrator-ai-cli 并设置了 NARRATOR_APP_KEY
Core Concepts关键术语：file_id、task_id、task_order_num 等
Conversation Initiation如何开启会话以及决策顺序
Two Workflow PathsFast Path（Original Narration）vs Standard Path（Adapted Narration）
Resource Selection ProtocolBGM、配音、模板的选择顺序和规则
Fast Path步骤 0–4 及参数说明
Standard Path步骤 0–5 及参数说明
Standalone Tasks声音克隆和 TTS
Important Notes7 个关键注意事项和最佳实践
Data & PrivacyAPI 端点、文件处理、凭据范围

要求

  • CLI：narrator-ai-cli v1.0.0+
  • Python：3.10+
  • 依赖：typer、httpx[socks]、httpx-sse、pyyaml、rich
  • API key：联系我们获取

链接

联系

需要 API key 或帮助？

联系我们

许可

MIT

在 GitHub 查看完整项目