1. 为什么我会盯上 narrator-ai-cli 这套本地接入方案如果你正在找一条能跑通「电影解说视频自动生成」的本地链路narrator-ai-cli 值得花半小时试一次。它本质是一个命令行工具加一份 Markdown Skill 文件CLI 负责真正干活搜素材、配风格、选 BGM、合成视频Skill 负责让 AI 助手理解「做解说视频」这件事该怎么拆步骤。你只要在对话框里说一句「帮我做一个《飞驰人生》的电影解说视频」剩下的流程它会自己往下走。这套东西适合谁适合已经装了 Python、用过 Git、手里有 Cursor / Claude Code / Windsurf / 小龙虾 OpenClaw 这类支持 Markdown Skill 的 Agent 的开发者。它不适合完全没碰过终端的人因为中间几步PATH、pip、镜像加速出问题时需要你自己判断。我这次重点不是复述官方安装文档而是把「三步配置」拆成可复制的动作Skill 文件怎么放、CLI 怎么装、APP Key 怎么配以及怎么用 TaoToken 把调用凭证统一管起来。后面会给一份 config.toml 骨架、一段验证请求还有我自己踩过的几个报错。全程命令都能直接抄。2. 前置准备Python、Git 和 TaoToken 的 Key 通道2.1 环境三件套先确认narrator-ai-cli 的硬性前置只有两个Python 3.10 和 Git。Windows 装 Python 时那个「Add python.exe to PATH」复选框一定要勾不勾后面所有命令都会报「不是内部或外部命令」。装完关掉终端重开再验证# Windows python --version # macOS python3 --version看到 3.10 或更高就行。Git 同理Windows 一路 NextmacOS 用xcode-select --install验证git --version出git version 2.x.x即可。2.2 为什么这里要提 TaoTokennarrator-ai-cli 自己需要一个 APP Key 才能调云端能力。但如果你同时还在用 Claude Code、Cursor 里的其他模型Key 会越攒越多散落在各个配置文件里换机器就得重新找一遍。我的做法是把模型调用统一走 TaoToken 的 API 通道官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。这样凭证只在一个地方管理narrator-ai-cli 的 APP Key 和模型 Key 分开记但都从同一个控制台拿。先去控制台建 Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentconsole_api_keysutm_campaignrewrite 。建完先别关页面后面 config.toml 要用。注意APP Key 属于敏感凭证不要写进会提交到 Git 的公开仓库。本地配置文件记得加进.gitignore。3. 三步配置Skill、CLI、APP Key 全流程3.1 第一步把 Skill 文件交给 AI 助手Skill 文件是「解说大脑」它告诉 Agent 做解说视频的完整流程。最省事的方式是直接把仓库地址丢给你的 AI 助手分两条消息发国内助手一次处理一个仓库时理解更稳第一条消息 请安装这个 Skillhttps://github.com/GridLtd-ProductDev/narrator-ai-cli-skill 第二条消息 请读取这个 CLI 安装教程并帮我在电脑中下载安装 https://github.com/GridLtd-ProductDev/narrator-ai-cli如果你用的是小龙虾 OpenClaw也可以手动放mkdir -p ~/.openclaw/skills/narrator-ai-cli cp SKILL.md ~/.openclaw/skills/narrator-ai-cli/SKILL.mdWindsurf 更简单把 SKILL.md 复制到项目的.skills/narrator-ai-cli/目录它只要 CLI 仓库地址就能自动理解。3.2 第二步安装 narrator-ai-cli 命令行工具Python 和 Git 就绪后装 CLI。Windows 用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 秒没反应按 CtrlC 终止改用镜像git clone https://ghfast.top/https://github.com/jieshuo-ai/narrator-ai-cli.git cd narrator-ai-cli pip install -e .ghfast.top打不开就换https://mirror.ghproxy.com/https://github.com/...。装完关终端重开验证narrator-ai-cli --versionmacOS 如果提示command not found先执行source ~/.zshrc再试。3.3 第三步配置 APP Key 与 config.toml 骨架CLI 装好后配 APP Keynarrator-ai-cli config set app_key 你的APP_Key如果你想把模型调用也统一到 TaoToken可以手写一份 config.toml。下面是我实测能用的骨架字段按需替换# ~/.narrator-ai-cli/config.toml [app] app_key 你的解说大师APP_Key [llm] # 统一走 TaoToken 的 API 通道 base_url https://taotoken.net/api api_key 你的TaoToken_Key model claude-sonnet-4-5 [output] dir ./output format mp4base_url用 https://taotoken.net/api 这个入口不要带 UTM 参数配置文件里保持干净。api_key从刚才那个控制台页面拿。改完保存再验证一次连接narrator-ai-cli user balance看到积分数显示说明 CLI 和 Key 都通了。4. 验证请求一句话触发电影解说全流程配置完成后在 AI 助手对话框里输入帮我做一个《飞驰人生》的电影解说视频AI 会自动执行搜索素材 → 匹配解说风格 → 选 BGM → 选配音角色 → 生成文案 → 合成视频 → 返回下载链接。想要更精确指令写具体点帮我做《飞驰人生》的解说解说风格用爆笑喜剧 配音用男声热血风BGM 用轻快节奏内置资源挺全93 部电影素材、146 首 BGM、63 个配音角色支持 11 种语言、90 种解说风格模板开箱即用不用自己传素材。想看有哪些可选# 查看解说风格列表 narrator-ai-cli task narration-styles # 查看配音角色列表 narrator-ai-cli dubbing list成功的结果是终端返回一个视频下载链接点开能播放画面、配音、BGM 都在。如果只返回文案没合成视频多半是云盘空间或 Key 余额的问题看下一节。5. 本篇常见报错排查5.1 安装卡住或超时把命令里的https://github.com换成https://ghfast.top/https://github.com还不行换https://mirror.ghproxy.com/https://github.com。两个镜像都不行直接找 AI解说大师要离线安装包。5.2 提示「不是内部或外部命令」或「command not found」最常见原因是装完没关终端重开。关掉当前窗口重开一个新终端。Windows 还要确认装 Python 时勾了「Add python.exe to PATH」没勾得重装。macOS 先source ~/.zshrc。5.3 macOS 终端前面显示 (base)Python 版本不对出现(base)说明装过 Anaconda它会覆盖python3。先python3 --version确认版本低于 3.10 就从官网另装新版然后用完整路径执行例如/Library/Frameworks/Python.framework/Versions/3.14/bin/python3 -m pip install -e .5.4 AI 自动选了不想要的风格或配音指令越具体越准。说「解说风格用爆笑喜剧配音用男声热血风」远好于只说「帮我做个解说」。5.5 提示云盘空间不足对 AI 助手说「帮我查看云盘空间」看用量说「帮我删除之前的文件」清理。注意先把已生成的视频下载到本地再删云盘文件。5.6 TaoToken 通道报 401 或鉴权失败先确认 config.toml 里base_url是 https://taotoken.net/api 没有多余斜杠或参数再确认api_key是从控制台新建的、没被删。如果 narrator-ai-cli 的 APP Key 和 TaoToken Key 混填了也会报鉴权错两个字段分开核对。6. 凭证统一管理后的下一步把 narrator-ai-cli 的 APP Key 和模型调用分开管之后换机器只要拷一份 config.toml不用满世界找 Key。如果你后面要长期跑编码类任务或搭 Agent可以看下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。只想先验证模型对话效果用模型对话页更快https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodels_chatutm_campaignrewrite 。接入细节和字段说明都在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Key 管理还是回控制台https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentconsole_api_keysutm_campaignrewrite 。我自己的习惯是narrator-ai-cli 的 APP Key 只配一次模型通道走 TaoToken这样以后换 Agent 或加新工具只改一处 base_url 就行。你先按第 3 节的 config.toml 跑通一次user balance再发那句「帮我做一个《飞驰人生》的电影解说视频」看到下载链接就算整条链路通了。
1. 为什么我会盯上 narrator-ai-cli 这套本地接入方案如果你正在找一条能跑通「电影解说视频自动生成」的本地链路narrator-ai-cli 值得花半小时试一次。它本质是一个命令行工具加一份 Markdown Skill 文件CLI 负责真正干活搜素材、配风格、选 BGM、合成视频Skill 负责让 AI 助手理解「做解说视频」这件事该怎么拆步骤。你只要在对话框里说一句「帮我做一个《飞驰人生》的电影解说视频」剩下的流程它会自己往下走。这套东西适合谁适合已经装了 Python、用过 Git、手里有 Cursor / Claude Code / Windsurf / 小龙虾 OpenClaw 这类支持 Markdown Skill 的 Agent 的开发者。它不适合完全没碰过终端的人因为中间几步PATH、pip、镜像加速出问题时需要你自己判断。我这次重点不是复述官方安装文档而是把「三步配置」拆成可复制的动作Skill 文件怎么放、CLI 怎么装、APP Key 怎么配以及怎么用 TaoToken 把调用凭证统一管起来。后面会给一份 config.toml 骨架、一段验证请求还有我自己踩过的几个报错。全程命令都能直接抄。2. 前置准备Python、Git 和 TaoToken 的 Key 通道2.1 环境三件套先确认narrator-ai-cli 的硬性前置只有两个Python 3.10 和 Git。Windows 装 Python 时那个「Add python.exe to PATH」复选框一定要勾不勾后面所有命令都会报「不是内部或外部命令」。装完关掉终端重开再验证# Windows python --version # macOS python3 --version看到 3.10 或更高就行。Git 同理Windows 一路 NextmacOS 用xcode-select --install验证git --version出git version 2.x.x即可。2.2 为什么这里要提 TaoTokennarrator-ai-cli 自己需要一个 APP Key 才能调云端能力。但如果你同时还在用 Claude Code、Cursor 里的其他模型Key 会越攒越多散落在各个配置文件里换机器就得重新找一遍。我的做法是把模型调用统一走 TaoToken 的 API 通道官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。这样凭证只在一个地方管理narrator-ai-cli 的 APP Key 和模型 Key 分开记但都从同一个控制台拿。先去控制台建 Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentconsole_api_keysutm_campaignrewrite 。建完先别关页面后面 config.toml 要用。注意APP Key 属于敏感凭证不要写进会提交到 Git 的公开仓库。本地配置文件记得加进.gitignore。3. 三步配置Skill、CLI、APP Key 全流程3.1 第一步把 Skill 文件交给 AI 助手Skill 文件是「解说大脑」它告诉 Agent 做解说视频的完整流程。最省事的方式是直接把仓库地址丢给你的 AI 助手分两条消息发国内助手一次处理一个仓库时理解更稳第一条消息 请安装这个 Skillhttps://github.com/GridLtd-ProductDev/narrator-ai-cli-skill 第二条消息 请读取这个 CLI 安装教程并帮我在电脑中下载安装 https://github.com/GridLtd-ProductDev/narrator-ai-cli如果你用的是小龙虾 OpenClaw也可以手动放mkdir -p ~/.openclaw/skills/narrator-ai-cli cp SKILL.md ~/.openclaw/skills/narrator-ai-cli/SKILL.mdWindsurf 更简单把 SKILL.md 复制到项目的.skills/narrator-ai-cli/目录它只要 CLI 仓库地址就能自动理解。3.2 第二步安装 narrator-ai-cli 命令行工具Python 和 Git 就绪后装 CLI。Windows 用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 秒没反应按 CtrlC 终止改用镜像git clone https://ghfast.top/https://github.com/jieshuo-ai/narrator-ai-cli.git cd narrator-ai-cli pip install -e .ghfast.top打不开就换https://mirror.ghproxy.com/https://github.com/...。装完关终端重开验证narrator-ai-cli --versionmacOS 如果提示command not found先执行source ~/.zshrc再试。3.3 第三步配置 APP Key 与 config.toml 骨架CLI 装好后配 APP Keynarrator-ai-cli config set app_key 你的APP_Key如果你想把模型调用也统一到 TaoToken可以手写一份 config.toml。下面是我实测能用的骨架字段按需替换# ~/.narrator-ai-cli/config.toml [app] app_key 你的解说大师APP_Key [llm] # 统一走 TaoToken 的 API 通道 base_url https://taotoken.net/api api_key 你的TaoToken_Key model claude-sonnet-4-5 [output] dir ./output format mp4base_url用 https://taotoken.net/api 这个入口不要带 UTM 参数配置文件里保持干净。api_key从刚才那个控制台页面拿。改完保存再验证一次连接narrator-ai-cli user balance看到积分数显示说明 CLI 和 Key 都通了。4. 验证请求一句话触发电影解说全流程配置完成后在 AI 助手对话框里输入帮我做一个《飞驰人生》的电影解说视频AI 会自动执行搜索素材 → 匹配解说风格 → 选 BGM → 选配音角色 → 生成文案 → 合成视频 → 返回下载链接。想要更精确指令写具体点帮我做《飞驰人生》的解说解说风格用爆笑喜剧 配音用男声热血风BGM 用轻快节奏内置资源挺全93 部电影素材、146 首 BGM、63 个配音角色支持 11 种语言、90 种解说风格模板开箱即用不用自己传素材。想看有哪些可选# 查看解说风格列表 narrator-ai-cli task narration-styles # 查看配音角色列表 narrator-ai-cli dubbing list成功的结果是终端返回一个视频下载链接点开能播放画面、配音、BGM 都在。如果只返回文案没合成视频多半是云盘空间或 Key 余额的问题看下一节。5. 本篇常见报错排查5.1 安装卡住或超时把命令里的https://github.com换成https://ghfast.top/https://github.com还不行换https://mirror.ghproxy.com/https://github.com。两个镜像都不行直接找 AI解说大师要离线安装包。5.2 提示「不是内部或外部命令」或「command not found」最常见原因是装完没关终端重开。关掉当前窗口重开一个新终端。Windows 还要确认装 Python 时勾了「Add python.exe to PATH」没勾得重装。macOS 先source ~/.zshrc。5.3 macOS 终端前面显示 (base)Python 版本不对出现(base)说明装过 Anaconda它会覆盖python3。先python3 --version确认版本低于 3.10 就从官网另装新版然后用完整路径执行例如/Library/Frameworks/Python.framework/Versions/3.14/bin/python3 -m pip install -e .5.4 AI 自动选了不想要的风格或配音指令越具体越准。说「解说风格用爆笑喜剧配音用男声热血风」远好于只说「帮我做个解说」。5.5 提示云盘空间不足对 AI 助手说「帮我查看云盘空间」看用量说「帮我删除之前的文件」清理。注意先把已生成的视频下载到本地再删云盘文件。5.6 TaoToken 通道报 401 或鉴权失败先确认 config.toml 里base_url是 https://taotoken.net/api 没有多余斜杠或参数再确认api_key是从控制台新建的、没被删。如果 narrator-ai-cli 的 APP Key 和 TaoToken Key 混填了也会报鉴权错两个字段分开核对。6. 凭证统一管理后的下一步把 narrator-ai-cli 的 APP Key 和模型调用分开管之后换机器只要拷一份 config.toml不用满世界找 Key。如果你后面要长期跑编码类任务或搭 Agent可以看下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。只想先验证模型对话效果用模型对话页更快https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodels_chatutm_campaignrewrite 。接入细节和字段说明都在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Key 管理还是回控制台https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentconsole_api_keysutm_campaignrewrite 。我自己的习惯是narrator-ai-cli 的 APP Key 只配一次模型通道走 TaoToken这样以后换 Agent 或加新工具只改一处 base_url 就行。你先按第 3 节的 config.toml 跑通一次user balance再发那句「帮我做一个《飞驰人生》的电影解说视频」看到下载链接就算整条链路通了。
