核心定位
AI Podcast Pipeline 是一套面向韩语 AI 播客创作者的全链路自动化工具链，专门解决从原始趋势内容到可发布播客资产的多环节割裂问题。该系统深度整合 Gemini 多说话人 TTS、智能字幕渲染与 YouTube 元数据生成，实现"一键式"端到端内容生产。
核心功能与使用方法
内容输入：系统优先读取 /home/tw2/Documents/n8n/data/shared/syn/8.quartz/Trend/QuickView-YYMM-주차주.md 格式的周度趋势文件，也支持将 wk.aiee.app URL 映射到本地 Markdown 源。
脚本生成：调用 podcast_prompt_template_ko.md 模板，生成 Callie（女声）× Nick（男声）双人对话脚本。提供两种模式——完整版（15-20 分钟深度解析）与压缩版（5-7 分钟核心要点）。脚本强制遵循口语化韩语、短句结构、无系统元文本等规范。
音频合成：采用 Gemini 多说话人 TTS，固定配音映射为 Kore→Callie、Puck→Nick。针对长脚本超时问题，提供分块构建器（build_dualvoice_audio.py，默认 6 行分块）与单通道备用方案（gemini_multispeaker_tts.py），输出标准 MP3。
字幕与视频：build_korean_srt.py 生成完整韩文 SRT（22 字符上限，无截断省略号）；render_subtitled_video.py 合成最终 MP4，支持字体（默认 "Do Hyeon"）、字号（推荐 25-27）及时间轴偏移（-150ms 至 -300ms 常见）微调。
元数据与交付：build_podcast_assets.py 自动生成缩略图（遵循 thumbnail_guidelines_ko.md）及 3 组 YouTube 标题备选+完整描述，最终交付包含源文件、MP3/MP4 路径、缩略图及元数据的完整清单。
显著优势
- 全链路闭环：唯一覆盖"脚本→配音→字幕→视频→缩略图→平台元数据"的自动化方案
- 可靠性设计：分块 TTS 构建规避 API 超时；可调字幕偏移解决唇音同步滞后
- 专业本地化：针对韩语播客场景优化，固定双角色声线确保品牌一致性
- 双模式弹性：长短版本一键切换，适配不同平台时长策略
局限性与风险
- 环境硬依赖：强制依赖特定绝对路径（
/home/tw2/.openclaw/）、环境变量提取（NANO_BANANA_KEY）及本地 Python 运行时，跨设备迁移成本高 - API 单点故障：Gemini TTS 为唯一配音来源，配额耗尽或区域封锁将中断生产
- 字幕微调成本：时间轴偏移与字号需人工试错（"常见 -150 至 -300ms"暗示无自动对齐）
- 安全审计缺失：报告明确标注"未执行安全扫描"，API 密钥通过
grep明文提取存在暴露风险
适合人群
韩语 AI 播客创作者、趋势分析频道运营者、需要批量生产结构化音频内容的内容团队，尤其适合已具备 Linux 本地环境配置能力的技术型创作者。
风险提醒
- API 密钥管理未采用密钥管理服务（KMS），仅依赖文件权限隔离
- 无输入内容过滤机制，恶意 Prompt 可能通过脚本模板注入
- 输出文件路径固定，多任务并行存在覆盖风险