AI解说大师 CLI & Skill 安装指南
一句话让AI帮你做电影解说视频,从此告别手动剪辑。本文适用 Windows 和 macOS,全程约 15 分钟。
先花 30 秒搞懂原理
AI解说大师的自动化视频生产分两个部分:CLI 是"手" ,把选素材、选模板、生成视频这些操作封装成了一条条终端命令;Skill 是"脑" ,是一份技能说明书,让 AI 助手(小龙虾 OpenClaw、WorkBuddy、Windsurf 等)读懂后知道怎么调用这些命令。
两个都装好,你就可以对着 AI 说"帮我做一个大话西游的电影解说视频",它就会自动搜索电影 → 匹配解说风格 → 生成文案 → 合成视频 → 返回下载链接,全程不需要你手动操作。
系统要求:Python 3.10+、Git。
下面一步一步来。
第 1 步:安装 Python
打开 Python 官方下载页,点击黄色大按钮 "Download Python 3.x.x" 下载安装。
Windows 用户请特别注意: 安装界面最下方有一个复选框 "Add python.exe to PATH",默认是未勾选的——你必须手动勾上它。不勾的话后面所有步骤都会报错"不是内部或外部命令"。勾好之后再点 "Install Now"。macOS 用户下载 .pkg 文件后双击安装,一路点"继续"即可。
安装完成后关闭终端/命令提示符窗口,重新打开一个新的(这一步很重要,不关的话系统读不到新装的 Python),然后输入验证命令:
# Windows 用户
python --version
# macOS 用户
python3 --version
看到 Python 3.10 或更高版本号,说明安装成功。
第 2 步:安装 Git
Windows: 打开 Git 官方下载页,页面会自动开始下载。下载完成后双击安装,所有设置页面全部点 "Next",最后点 "Install" → "Finish" 即可。
macOS: 在终端输入以下命令,系统会弹出白色安装对话框,点"安装"等待完成:
xcode-select --install
💡 如果提示磁盘空间不足(Xcode 命令行工具需要约 17GB),可以改用
brew install git(需要先安装 Homebrew),只需要几百 MB。
安装完成后,同样关闭终端重新打开,输入验证命令:
git --version
看到 git version 2.x.x 就说明成功了。
第 3 步:安装 CLI 工具
Python 和 Git 都就绪后,开始安装 AI解说大师的命令行工具。根据你的系统复制对应的一键安装命令,粘贴到终端里按回车执行:
Windows(命令提示符 或 PowerShell):
python -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/jieshuo-ai/narrator-ai-cli/main/install.py').read())"
macOS(终端):
curl -fsSL https://raw.githubusercontent.com/jieshuo-ai/narrator-ai-cli/main/install.py | python3
等终端刷完一堆文字停下来就行,大概 1-3 分钟。
⚠️ 如果超过 30 秒没有任何反应,说明网络访问 GitHub 受限(国内常见问题)。按
Ctrl+C(macOS 是Control+C)终止,改用手动安装:# 第 1 条:用镜像加速下载代码 git clone https://ghfast.top/https://github.com/jieshuo-ai/narrator-ai-cli.git # 第 2 条:进入项目目录 cd narrator-ai-cli # 第 3 条:安装 CLI(macOS 用 pip3) pip install -e .如果 ghfast.top 也打不开,把地址换成
https://mirror.ghproxy.com/https://github.com/jieshuo-ai/narrator-ai-cli.git再试。
安装完成后,关闭终端重新打开,输入验证命令:
narrator-ai-cli --version
看到版本号输出(比如 0.1.0),说明 CLI 安装成功。macOS 如果提示 command not found,先执行 source ~/.zshrc 再试。
第 4 步:配置 API Key
CLI 装好了,接下来让它连上 AI解说大师的服务器。你需要一个 API Key(相当于账户钥匙)。
获取方式: 联系 AI解说大师商务咨询,获取你的专属 API Key。
拿到 Key 后,在终端输入以下命令(把"你的API_Key"替换成你实际拿到的那串字符):
narrator-ai-cli config set app_key 你的API_Key
然后验证连接是否成功:
narrator-ai-cli user balance
能看到你的账户余额(积分数),说明 CLI 已经完全就绪。
第 5 步:加载 Skill 到 AI助手(小龙虾)
前四步搞定了"手"(CLI 工具),这一步给 AI 装上"脑"(Skill 技能文件),让它学会怎么用 CLI 帮你做视频。
根据你使用的 AI 助手平台,选择对应方式:
WorkBuddy / QClaw(腾讯系): 在技能管理界面直接上传 SKILL.md 文件。
小龙虾 OpenClaw: 原生 Skill 加载,在终端执行:
mkdir -p ~/.openclaw/skills/narrator-ai-cli
# 先把 SKILL.md 下载到本地,然后复制进去
cp SKILL.md ~/.openclaw/skills/narrator-ai-cli/SKILL.md
Windsurf: 复制 SKILL.md 到项目的 .skills/narrator-ai-cli/ 目录。Windsurf 只需要 CLI 仓库地址就能自动理解,体验最流畅。
其他支持 Markdown Skill 的 Agent(有道龙虾、元气AI、Cursor、Claude Code 等): 指向 SKILL.md 文件即可。
通用备选方案——在对话中让 AI 自己学习: 如果找不到上传入口,直接在 AI 助手的对话框里分两步操作。先发送第一条消息:
请帮我安装这个 CLI 命令行工具:https://github.com/jieshuo-ai/narrator-ai-cli
等 AI 回复完成后,再发送第二条:
请学习这个技能文件:https://github.com/jieshuo-ai/narrator-ai-cli-skill/blob/main/SKILL.md
💡 为什么要分两步?国内 AI 助手一次只处理一个仓库时理解能力更稳定,分两步成功率更高。海外的 Windsurf 只需要给一个 CLI 地址就行。
AI 提示输入 API Key 时,把你第 4 步配置的那个 Key 发给它。看到"已准备就绪"或显示出账户余额,说明全部配置成功。
安装完成!试试看
在 AI 助手的对话框里输入:
帮我做一个飞驰人生的电影解说视频
AI 会自动执行完整流程:搜索电影信息 → 选择解说风格 → 选 BGM → 选配音角色 → 生成解说文案 → 合成视频 → 返回下载链接。全程你只需要在 AI 询问时回复"确认"就行。
AI解说大师内置了 93 部电影素材、146 首 BGM、63 个配音角色(支持 11 种语言)和 90+ 种解说风格模板,全部开箱即用,无需上传任何素材。
常见问题
Q1:安装过程中网络一直卡住,怎么办?
A:国内访问 GitHub 经常受限。把命令中的 https://github.com 替换为 https://ghfast.top/https://github.com。如果仍然不行,再试 https://mirror.ghproxy.com/https://github.com。两个镜像都不行的话,联系 AI解说大师商务咨询直接要安装包。
Q2:输入命令后提示"不是内部或外部命令"(Windows)或"command not found"(macOS),怎么办?
A:最常见的原因是安装完成后没有关闭终端重新打开。关掉当前窗口,重新打开一个新的终端再输入命令。Windows 用户还要确认安装 Python 时勾选了"Add python.exe to PATH",没勾的话需要重新安装 Python。macOS 用户可以先执行 source ~/.zshrc 刷新环境变量后再试。
Q3:API Key 从哪里获取?
A:联系 AI解说大师商务咨询,即可获取你的专属 API Key。拿到后在终端执行 narrator-ai-cli config set app_key 你的API_Key 完成配置。
Q4:AI小龙虾自动选了我不想要的解说风格或配音,怎么控制?
A:指令越具体,AI 执行越精确。比如说"帮我做飞驰人生的解说,解说风格用爆笑喜剧,配音用男声热血风,BGM 用轻快节奏",效果远好于只说"帮我做个解说"。AI解说大师内置 90+ 种解说风格模板和 63 个配音角色,你可以提前用 narrator-ai-cli task narration-styles 和 narrator-ai-cli dubbing list 查看所有可选项。
Q5:提示云盘空间不足,怎么处理?
A:上传自定义素材会占用账户的 3GB 云盘空间。对 AI 助手说"帮我查看云盘空间"可以查看用量,说"帮我删除之前的文件"可以清理。注意先把已生成的视频下载到本地再删除云盘文件。
Q6:macOS 终端前面显示 (base),Python 版本不对怎么办?
A:终端提示符前出现 (base) 说明你之前装过 Anaconda,它会"劫持" python3 命令指向自带的旧版本。先输入 python3 --version 看一下版本,如果是 3.10 以上就可以直接用。如果低于 3.10,需要从官网另装新版 Python,然后用完整路径执行命令,比如 /Library/Frameworks/Python.framework/Versions/3.14/bin/python3(把 3.14 换成你实际安装的版本号)。
相关链接
- 📦 CLI 工具仓库:github.com/jieshuo-ai/…
- 🧠 Skill 技能文件仓库:github.com/jieshuo-ai/…