用途：narrator-ai-cli 是命令行工具，用于自动化制作电影解说/评论视频，串联搜索影片、生成脚本、选择背景音乐与配音、合成成片的完整流程。提供两条工作流：原创解说（快速路径，从零生成新解说）与改编解说（标准路径，改编已有影片内容）。
主要能力：搜索影片、列出模板/背景音乐/配音、生成原创或改编解说脚本、生成剪辑时间线数据、文本转语音、上传源视频、合成最终视频、下载文件，以及独立的语音克隆与直接 TTS 任务。
安装与配置：pip install "narrator-ai-cli @ git+https://github.com/NarratorAI-Studio/narrator-ai-cli.git"；需 Python 3.10+，依赖 typer、httpx[socks]、httpx-sse、pyyaml、rich。配置 API Key：narrator-ai-cli config set app_key YOUR_APP_KEY，可用 narrator-ai-cli config show 验证，也可用环境变量 export NARRATOR_APP_KEY=your_api_key_here。配置文件位于 ~/.narrator-ai-cli/config.yaml（Windows 为 %USERPROFILE%.narrator-ai-cli\config.yaml）。
使用方式：所有 create--task 命令均为异步，需用对应 query--task 命令轮询至 completed。关键标识包括 file_id、task_id、task_order_num、movie_id、template_id、bgm_id、dubbing_id。原创流程：create-original-narration-script-task → create-original-clip-data-task → create-tts-task → create-original-compose-task，各步用 download-file 下载产物。改编流程：search-movie → create-adapted-narration-script-task → create-adapted-clip-data-task → create-tts-task → upload-file 上传源视频 → create-adapted-compose-task。资源选择顺序建议模板、BGM、配音。
适用场景：批量制作电影解说视频、改编已有影片、语音克隆与独立 TTS。
限制：需有效 API Key 与额度；文件格式需符合要求（视频 .mp4/.mov/.avi，音频 .mp3/.wav，脚本 .txt/.json）；任务需轮询，可能超时或失败；错误码如 1001 无效 API Key、1002 额度不足、2001 文件不存在、3002 任务失败、4001 影片未找到、5001 模板未找到。具体收费与价格暂未提供。