核心功能
narrator-ai-cli 是 Narrator AI 的官方命令行客户端，专为AI Agent和开发者设计，用于批量生成AI配音的影视解说视频。该工具提供完整的视频生产管线，涵盖素材管理、文案生成、智能剪辑到成品输出的全流程。
双工作流设计
- 原创文案模式（Fast Path）：搜索影视信息 → 快速文案生成 → 智能切片 → 视频合成，成本更低速度更快
- 二创文案模式（Standard Path）：热门学习 → 生成文案 → 切片数据 → 视频合成，适合深度定制解说风格
核心资源库
- 93部预置电影素材：支持按类型筛选（喜剧、悬疑、动作等12类）
- 146首背景音乐：覆盖多种情绪和场景
- 63种AI配音：11种语言（中/英/日/韩/西/葡/德/法/阿/泰/印尼），含39种普通话音色
- 90+解说风格模板：12种类型风格，可直接调用免训练
显著优点
1. 完整闭环：从原始素材到成品视频的一站式解决方案，无需切换多个工具
2. 成本可控：提供pro（15点/字）和flash（5点/字）两档模型，支持任务前预算估算
3. 多语言出海：11种语言配音支持，适合跨境电商和海外内容分发
4. 机器友好：所有命令支持--json输出，支持SSE流式进度，便于Agent集成
5. 安全设计：API密钥本地存储（权限0600），支持子密钥管理，上传文件隔离存储
潜在局限
- API依赖：所有处理在云端完成，必须联网且受服务商稳定性影响
- 搜索延迟：
search-movie调用Gradio后端，可能耗时60秒以上 - 计费模式：按字符/任务点数计费，高频使用成本累积较快
- 素材版权：预置93部电影的商用授权范围需额外确认
- 工作流复杂度：5步以上的标准路径容易混淆
order_num来源（常见错误：误用clip-data的order_num而非writing的）
适用人群
- MCN机构/自媒体团队：批量生产影视解说、短剧切片内容
- 跨境电商卖家：多语言产品视频、本地化营销内容
- AI Agent开发者：需要结构化视频生成能力的自动化工作流
- 个人创作者：零剪辑基础快速入局解说赛道
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 密钥泄露 | `~/.narrator-ai/config.yaml` 本地存储 | 设置文件权限0600，勿提交Git |
| 余额透支 | 异步任务创建后扣费，失败不退 | 先用`task budget`估算，再用`task verify`校验 |
| 任务卡死 | Gradio后端超时(40000错误) | 设置充足超时，支持重试机制 |
| 素材失效 | 预置资源可能下架 | 优先使用`material list`实时查询 |
| 版权争议 | AI生成文案与原片相似度 | 建议人工审核后发布 |
认证与合规
- 许可证：MIT开源，可自由集成
- 数据流向：仅与
openapi.jieshuo.cn通信，文件上传至服务商OSS - 隐私措施：用户上传文件绑定账户隔离，不公开共享