用途
Explainer 用于生成解说视频（explainer video），将一位主播的旁白配音与 AI 生成的画面组合，适用于产品介绍、概念解释和教程。当用户想制作解说或教程视频、用视频形式解释某内容、需要带旁白的 AI 画面内容，或提到「解说视频」「explainer video」「tutorial video」时可使用。
以下情况不适用：仅需音频而无画面（改用 /speech 或 /podcast）；播客式讨论（改用 /podcast）；生成单张图片（改用 /image-gen）；无视频的文本朗读（改用 /speech）。
主要能力
- 支持两种风格：Info（信息展示型）与 Story（故事叙述型）。模式必须为 info 或 story，不能使用 slides（应改用 /slides 技能）。
- 解说视频仅使用 1 位主播。
- 支持仅生成解说文字脚本，或生成完整的「文字 + 视频」。
- 可选参数：--source-url 提供参考链接、--skip-audio 用于纯文本输出、--image-size（2K|4K，默认 2K）、--aspect-ratio（16:9|9:16|1:1，默认 16:9）、--style 指定 AI 画面的视觉风格。
- 支持语言 zh、en、ja。
使用方式
生成前会按顺序确认：主题/内容、语言、风格、主播、输出类型，最后汇总确认后执行。主播默认使用内置默认值，只有用户明确要求更换声音时才展示完整主播列表，且不硬编码主播 ID，需通过 speakers CLI 获取。
执行采用后台运行（run_in_background: true，timeout: 660000），CLI 阻塞至生成完成并返回 JSON。命令示例：
$CMD_PREFIX create \
--query "{topic}" \
--mode {info|story} \
--lang {en|zh|ja} \
--speaker "{name}" \
--speaker-id "{id}" \
--timeout 600 \
--json
其中 $CMD_PREFIX 依据认证模式确定：若 AUTH_MODE 为 openapi，则 CMD_PREFIX="listenhub openapi storybook"，否则 CMD_PREFIX="listenhub explainer"（OpenAPI 命令名为 storybook，后端相同）。
结果解析字段包括 episodeId、audioUrl、videoUrl、credits。纯文本输出时展示脚本并给出在线查看链接 https://listenhub.ai/app/explainer/{episodeId}；文字加视频时展示视频与音频链接及消耗积分。选择下载时，按主题命名生成文件：纯文本保存为 {slug}-explainer.md，图文视频创建 {slug}-explainer/ 目录，写入 script.md 并用 listenhub download "{audioUrl}" -o "{slug}-explainer/audio.mp3" 下载音频。产物保存到当前工作目录，不保存到 ~/Downloads/ 或 .listenhub/。
配置存于 .listenhub/explainer/config.json，默认 {"outputMode":"inline","language":null,"defaultStyle":null,"defaultSpeakers":{}}，首次使用会静默创建默认配置并直接进入交互流程，不询问设置问题；仅在用户明确要求重新配置时才展示当前设置并询问。生成成功后会将会话中的语言、风格、主播写入配置。
适用场景
产品介绍、概念解释、教程制作等需要旁白加 AI 画面的解说内容。
限制
- 仅支持 1 位主播。
- 模式只能是 info 或 story，不支持 slides。
- 预估耗时：纯文字脚本 2-3 分钟；文字 + 视频 5-10 分钟。
- 需通过 CLI 认证后使用，认证、执行模式、错误处理等遵循相关共享文档。