narrator-ai-cli-skill 快速路径详解：4步从搜片到合成视频的原创文案全流程

narrator-ai-cli-skill 快速路径详解4步从搜片到合成视频的原创文案全流程【免费下载链接】narrator-ai-cli-skillAI 解说大师 — Agent skill封装 narrator-ai-cli 供 Claude/Codex 等工具调用项目地址: https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skillnarrator-ai-cli-skill是一款让 AI Agent 自动制作电影/短剧解说视频的「AI 解说大师」技能文件它封装了narrator-ai-cli命令行工具安装到 Claude / Codex 等 AI 工具后只需说一句话AI 就能完成搜片、选模板、生成文案、合成视频的完整流程。其中快速路径Fast Path是生成原创文案视频最快、最省积分的路线本文带你从零讲透这条路线的全部关键参数与实战示例。先搞懂narrator-ai-cli-skill 是什么一句话概括CLI 是双手Skill 是大脑。CLI命令行工具Skill技能文件是什么一组可执行命令教会 AI 如何使用这些命令的说明书类比厨房厨具菜谱能否单独使用可以在终端手动敲命令不可以必须配合 CLI技能文件由 SKILL.md核心决策流程和 references/ 目录详细参数表两部分组成。装进支持 markdown 技能的 AI Agent 后你只需用自然语言下指令例如帮我做一个《肖申克的救赎》解说视频Agent 就会自动跑完全流程。 前置条件已安装narrator-ai-cli命令行工具并配置好NARRATOR_APP_KEY密钥。可用narrator-ai-cli user balance一条命令验证环境是否就绪。快速路径 vs 标准路径两条路线怎么选项目内置了两条端到端工作流快速路径就是本文主角⚡ 快速路径Fast Path原创文案 标准路径Standard Path二创文案流程素材 → fast-writing → fast-clip-data → video-composing素材 → generate-writing → clip-data → video-composing文案风格根据剧情独立撰写不依赖参考片模仿某个参考解说的风格二创速度与成本更快、更省积分耗时更长解说风格更像人适用场景默认推荐大多数情况用它即可想复刻某款爆款解说风格时快速路径只有3 个核心任务外加 1 个可选步骤没有标准路径里风格学习的额外环节因此更适合新手。完整流程对照图可参考 SKILL.md 中的 Pipeline at a Glance 章节。快速路径准备动手前先选好 4 样食材在创建任何任务前按顺序确认以下资源AI Agent 会逐一向你展示选项并等待确认不会自动替你选源片素材技能内置约100 部现成电影视频 字幕均已就绪material list直接取用即可绝大多数情况无需自己上传文件BGM 背景音乐内置146 首bgm list --search 关键词可按情绪筛选配音音色内置63 种音色、覆盖 11 种语言dubbing list --lang 普通话按语言筛选解说风格模板内置90 个模板、12 个题材爆笑喜剧 / 烧脑悬疑 / 热血动作……task narration-styles --genre 爆笑喜剧直接筛选四类资源的完整字段说明和筛选命令见 references/resources.md。快速路径四步实战指南第 0 步搜片并确定 target_mode解说模式先确认源片来自哪里这决定了target_mode参数取何值场景target_mode关键输入素材库搜到该片只写剧情解说1纯解说confirmed_movie_json从素材字段映射而来无需字幕素材库搜到该片想贴合原声对白2原声混剪同上 episodes_data含字幕srt_file_id冷门/新剧自己上传字幕3新剧模式episodes_data含字幕影片信息可缺省素材库未收录的已知影片Agent 会调用task search-movie 片名联网搜索约 60 秒结果缓存 24 小时绝不编造影片信息——这是技能的强制规则之一。第 1 步fast-writing —— 让 AI 写出原创文案创建文案生成任务核心参数只有 5 个参数作用新手建议learning_model_id解说风格模板 ID直接选用内置模板免去风格学习target_mode第 0 步选定的模式1/2/3playlet_name影片名称直接填中文片名confirmed_movie_json影片信息模式 1/2 必填从素材字段自动映射不用手写model文案模型档位flash更快更省纯解说 5 积分/千字符pro质量更高15 积分/千字符两个容易忽略的可选参数language文案输出语言必须与所选配音音色语种一致选英文配音就要显式改成英文不能留默认中文perspectivefirst_person或third_person默认第三人称第一人称需额外提供主角名任务完成后从返回中记下两个值task_id和文案文件的file_id——它们都是下一步的输入。第 2 步fast-clip-data —— 给文案配上 BGM 与配音这一步把上一步的文案、你选好的 BGM 和配音音色组装起来并关联影片画面narrator-ai-cli task create fast-clip-data --json -d request.jsonrequest.json里要放的东西概念上记住即可Agent 会自动填task_idfile_id第 1 步的文案任务与文案文件bgm、dubbing、dubbing_type第准备阶段选好的 BGM 与配音episodes_data影片的视频/字幕文件 ID素材库直取这一步产出的task_order_num形如fast_writing_clip_data_xxxxx是整条快速路径里最关键的接力棒——第 3 步全靠它切记别拿 32 位十六进制的task_id来顶替否则必报10001错误。第 3 步video-composing —— 一键合成最终视频快速路径的合成任务参数最简洁只需一个narrator-ai-cli task create video-composing --json -d { order_num: fast_writing_clip_data_xxxxx }轮询到任务完成后从.results.tasks[0].video_url拿到最终 MP4 的下载地址。至此一条完整的原创文案解说视频就诞生了 可选第 4 步magic-video —— 套上专业视觉模板如果你还想给成片加上品牌化字幕版式可追加一个视觉模板任务覆盖 YouTube / 抖音 / Shorts 三大平台14 款竖屏、横屏、方屏模板可配置主标题、副标题、免责文案、分集数segment_count留 0 由 AI 自动判断-1 不分集计费30 积分/分钟且提交前 AI 必须向你展示全部参数并等待确认防误扣费注意语言联动非中文解说时模板文字参数必须翻译为目标语言不能提交中文默认值模板目录与参数详解见 references/magic-video.md。快速路径关键参数速查表任务必填参数完成后要记下的输出fast-writinglearning_model_id、target_mode、playlet_name、影片信息task_id、文案file_idfast-clip-data上一步两值 bgm/dubbing/dubbing_type 影片文件task_order_num接力棒video-composing仅order_num 接力棒video_url成片下载地址magic-video可选task_id合成的template_name每个模板一条成片 URL完整参数表、JSON 请求示例和标准路径细节都在 references/workflows.md 中Agent 执行时会逐条对照。实战示例5 分钟生成一条《飞驰人生》解说视频安装好技能后整个过程就是一段对话你帮我做一条《飞驰人生》的解说视频风格轻松搞笑 AI内置素材库里有《飞驰人生》视频和字幕都是现成的。 你想走哪条路线① 快速路径原创文案更快更省 ② 标准路径二创风格 你快速路径 AI好。解说模式选哪种① 纯解说只写剧情 ② 原声混剪贴合原片对白 你纯解说 AI解说模板给你 3 个推荐爆笑喜剧·老张式 / …… BGM 推荐 3 首配音推荐 3 个——你各选一个或者我按默认推荐来 你都按推荐来Agent 随后自动执行fast-writingflash 档→ 轮询完成 →fast-clip-data→ 轮询完成 →video-composing→ 轮询完成 → 把成片video_url发给你。全程每步都有积分消耗预估task budget可预先估算任何一步失败也会停下来问你是重试还是换路线绝不擅自切换路径。新手避坑清单4 个最容易踩的坑拿错order_num的值下游任务的order_num必须填带前缀的task_order_num如fast_writing_clip_data_xxxxx填 32 位十六进制task_id或账单侧的script_xxxxx都会报10001 任务关联记录数据异常轮询盯错状态字段任务查询返回里有两个 status——顶层.status0~42 为成功才是轮询对象嵌套的.results.tasks[0].status是另一套编码盯错会死循环。标准轮询脚本5 秒间隔 双重熔断已内置于 references/operations.md语种链条断裂配音音色语种 → 文案language参数 → magic-video 模板文字三处必须一致。选英文配音却留默认中文成品里会出现英文配音 中文字幕文案的尴尬失败后自动换路线某一步失败时正确做法是让你决定重试 / 换路线 / 终止技能已禁止 Agent 自作主张切换路径延伸阅读文档地图想了解看这里技能总览、强制规则、两条路径对比SKILL.md资源选择素材 / BGM / 配音 / 模板的字段映射references/resources.md两条路径的完整参数表与 JSON 示例references/workflows.md轮询脚本、任务管理、文件操作、全部错误码references/operations.md视觉模板目录与文字参数规则references/magic-video.md安装步骤与已验证平台清单README.md把 narrator-ai-cli-skill 装进你的 AI Agent接下来要做的就只剩下——说出你想解说的片名然后坐等成片 ⏬【免费下载链接】narrator-ai-cli-skillAI 解说大师 — Agent skill封装 narrator-ai-cli 供 Claude/Codex 等工具调用项目地址: https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考