装完之后，你只需要对 AI 说"帮我做一个《飞驰人生》的电影解说视频"，它会自动完成搜索素材、匹配风格、生成文案、合成视频的全流程，全程你只需要回复"确认"。
前置条件： Python 3.10+（安装时勾选 Add to PATH）、Git
支持的 AI 助手平台： WorkBuddy、有道龙虾、腾讯 Q-Claw、小龙虾 OpenClaw、Windsurf、元气AI、Claude Code、Cursor——只要支持 Markdown Skill 的 Agent 都能用。
三步接入流程：Skill + CLI + APP Key 全配置
第1步：给 AI 助手导入 Skill 文件（装上"解说大脑"）
第2步：安装 CLI 工具（接上"操作双手"）
第3步：配置 APP Key，开始对话出片
简易版安装：把仓库地址丢给 AI 助手，自动完成 CLI 和 Skill 配置
如果你已经有 AI 助手（小龙虾/WorkBuddy 等），最快的方式是直接把仓库地址丢给它，让它自己完成安装。
第一步：发送以下内容给 AI 助手
请安装这个 Skill：https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill
请读取这个 CLI 安装教程并帮我在电脑中下载安装：https://github.com/GridLtd-ProductDev/narrator-ai-cli
建议分两条消息发送，国内 AI 助手一次处理一个仓库时理解能力更稳定，分两步成功率更高。
第二步：把 APP Key 发给 AI 助手
AI 助手提示输入 APP Key 时，把你的 Key 发给它。看到账户余额显示，说明配置成功。
第三步：直接下指令出片
帮我做一个《飞驰人生》的电影解说视频
AI 会自动执行：搜索素材 → 匹配解说风格 → 选 BGM → 选配音角色 → 生成文案 → 合成视频 → 返回下载链接。
简易版搞不定的，跟着下面详细版一步一步来。
详细版安装：Python + Git + narrator-ai-cli 手动配置全流程
Step 1：安装 Python 3.10+
Windows：
Windows 用户请特别注意： 如果你下载的是老板本Python，安装界面最下方有一个复选框 "Add python.exe to PATH"，默认是未勾选的——你需要手动勾上它。不勾的话后面所有步骤都会报错"不是内部或外部命令"。勾好之后再点 "Install Now"。
macOS：
下载 .pkg 文件双击安装，一路点"继续"即可。
验证安装（安装完成后关闭终端重新打开）：
Windows
python --version
macOS
python3 --version
看到 Python 3.10 或更高版本号即成功。
Step 2：安装 Git（Windows / macOS 双平台）
Windows：
打开git下载，安装过程所有页面全部点 Next，最后点 Install → Finish。
macOS：
xcode-select --install
系统弹出安装对话框，点"安装"等待完成。如果提示磁盘空间不足（Xcode 工具需要约 17GB），改用：
brew install git
验证（关闭终端重新打开）：
git --version
看到 git version 2.x.x 即成功。
Step 3：安装 narrator-ai-cli 命令行工具（含 GitHub 镜像加速方案）
Python 和 Git 就绪后，安装 narrator-ai-cli 命令行工具。
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 终止，改用镜像加速：
用镜像下载代码
git clone https://ghfast.top/https://github.com/jieshuo-ai/narrator-ai-cli.git
进入目录
cd narrator-ai-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
看到版本号输出即成功。macOS 提示 command not found 先执行 source ~/.zshrc 再试。
Step 4：配置 APPKey 并验证链路
narrator-ai-cli config set app_key 你的APP_Key
验证连接：
narrator-ai-cli user balance
看到积分数显示，说明 CLI 已完全就绪。
Step 5：加载 Skill 文件到 AI Agent（小龙虾 / WorkBuddy / Q-Claw 等）
根据你使用的平台选择对应方式：
WorkBuddy / 腾讯 Q-Claw：
在技能管理界面直接上传 SKILL.md 文件。
小龙虾 OpenClaw：
mkdir -p ~/.openclaw/skills/narrator-ai-cli
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）：
在对话框分两步操作：
第一条消息
请帮我安装这个 CLI 工具：https://github.com/jieshuo-ai/narrator-ai-cli
等 AI 回复完成后，发第二条
请学习这个技能文件：https://github.com/jieshuo-ai/narrator-ai-cli-skill/blob/main/SKILL.md
AI 提示输入 APP Key 时，把第四步配置的 Key 发给它。看到"已准备就绪"或显示积分数，全部配置完成。
安装验证：一句话触发电影解说全流程
在 AI 助手对话框输入：
帮我做一个《飞驰人生》的电影解说视频
想要更精确的效果，指令越具体越好：
帮我做《飞驰人生》的解说，解说风格用爆笑喜剧，配音用男声热血风，BGM 用轻快节奏
查看所有可选项：
查看解说风格列表
narrator-ai-cli task narration-styles
查看配音角色列表
narrator-ai-cli dubbing list
narrator-ai-cli 安装常见报错与解决方案
Q：安装过程中网络一直卡住
把命令中的 https://github.com 替换为 https://ghfast.top/https://github.com，还不行再换 https://mirror.ghproxy.com/https://github.com。
Q：提示"不是内部或外部命令"（Windows）或"command not found"（macOS）
最常见原因是安装完没有关闭终端重新打开。关掉当前窗口，重开一个新终端再试。Windows 用户还要确认安装 Python 时勾选了"Add python.exe to PATH"，没勾需要重新安装。macOS 用户先执行 source ~/.zshrc 刷新环境变量。
Q：AI 自动选了不想要的风格或配音
指令越具体效果越精确。说"解说风格用爆笑喜剧，配音用男声热血风"，远好于只说"帮我做个解说"。
Q：提示云盘空间不足
对 AI 助手说"帮我查看云盘空间"查看用量，说"帮我删除之前的文件"清理。注意先把已生成的视频下载到本地再删除云盘文件。
Q：macOS 终端前面显示 (base)，Python 版本不对
出现 (base) 说明装过 Anaconda，它会覆盖 python3 命令。先执行 python3 --version 确认版本，低于 3.10 需要从官网另装新版，然后用完整路径执行，例如 /Library/Frameworks/Python.framework/Versions/3.14/bin/python3。
