create-podcast

播客生成器 (Create Podcast)

将任意内容源（每日早报、每周周刊、单篇文章、任意 Markdown）转化为播客音频（MP3）。采用用户克隆声音的独白式播讲，支持多种内容格式和脚本模板。

认证与环境变量

Fish.audio TTS

-H "Authorization: Bearer $FISH_AUDIO_API_KEY"

需要的环境变量：

BestBlogs API（早报/周刊输入时使用）

-H "X-API-KEY: $BESTBLOGS_API_KEY"

接口地址：https://api.bestblogs.dev

R2 存储

复用 image-gen 已有的 R2 配置：

若任一环境变量未设置，提示用户配置。

⚠️ 首次使用：Fish.audio 声音克隆配置

首次使用前需完成声音克隆。若 FISH_AUDIO_API_KEY 和 FISH_AUDIO_VOICE_ID 环境变量已设置，可跳过。

可选的 EXTEND.md 配置文件用于记录个人偏好（如开场白名字、语速）:

# EXTEND.md 模板
voice_id: <your-voice-id>
speech_rate: 1.0          # 语速（0.5-2.0）
podcast_intro_name: Gino   # 开场白中使用的名字

工作流概览

- [ ] 阶段一: 内容准备（识别输入源，提取关键内容）
- [ ] 阶段二: 脚本生成 ⚠️ 需用户确认
- [ ] 阶段三: 音频合成（Fish.audio TTS 分段 + FFmpeg 合并）
- [ ] 阶段四: 产出 & 分发（标题/ShowNotes/封面 + 展示确认）

阶段一：内容准备

1.0 复用 Workspace 缓存

播客和视频共享内容源。开始前先查 workspace 缓存（contents/tmp/workspace/YYYY-MM-DD/），避免重复 API 调用：

回写: 播客获取的新文章详情也要写回 article-details/，供后续 skill（如 create-video）复用。

1.1 识别输入源

根据用户输入自动识别内容来源类型，选择对应分支：

1.2 每日早报输入

读取 bestblogs-daily-digest 生成的早报文件：

contents/bestblogs-digest/YYYY-MM-DD/digest.txt

若当日早报不存在，提示用户先运行 bestblogs-daily-digest 生成早报。

从早报中提取：10 条内容的标题、来源、摘要、评分、readUrl、关键词标签、日期。

获取 Top 3 深度内容: 先查 workspace 缓存 article-details/{id}.md，缓存未命中时按 resourceType 获取完整信息（获取后写回缓存）：

# 获取资源元数据
curl -s "https://api.bestblogs.dev/openapi/v1/resource/meta?id={RESOURCE_ID}" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY"

# ARTICLE — Markdown 全文
curl -s "https://api.bestblogs.dev/openapi/v1/resource/markdown?id={RESOURCE_ID}" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY"

# PODCAST — 播客完整内容
curl -s "https://api.bestblogs.dev/openapi/v1/resource/podcast/content?id={RESOURCE_ID}" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY"

3 个资源的请求并行执行。详见 references/api_reference.md。

1.3 每周周刊输入

读取 bestblogs-weekly-curator 生成的周刊数据：

# 获取最新周刊
curl -s -X POST https://api.bestblogs.dev/openapi/v1/newsletter/list \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY" \
  -d '{"currentPage":1,"pageSize":1,"userLanguage":"zh_CN"}'

# 获取周刊详情
curl -s "https://api.bestblogs.dev/openapi/v1/newsletter/detail?id={NEWSLETTER_ID}" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY"

提取分类文章列表、编辑推荐语、主题关键词。选出 3-5 篇重点文章获取全文。

1.4 单篇文章输入

用户提供的文章来源：

1.5 任意内容输入

直接使用用户提供的文本，分析内容结构后选择合适的脚本组织方式。

阶段二：播客脚本生成

根据输入源类型选择对应的脚本模板。详细模板和风格指南见 references/script_templates.md。

内容类型与时长

核心规则

⚠️ 脚本常偏短，必须主动扩充到时长下限。重要内容多花时间讲透，不要平均分配。

⚠️ 用户确认

生成脚本后，将完整脚本输出给用户，等待确认或修改后再进入阶段三。

脚本保存到：

contents/tmp/podcast/YYYY-MM-DD/script.md

阶段三：音频合成

3.1 调用 Fish.audio TTS

SKILL_DIR=$(readlink -f ~/.claude/skills/create-podcast 2>/dev/null)

# 批量合成（推荐，自动分段 + 合并）
bun ${SKILL_DIR}/scripts/fish-tts.ts \
  --script contents/tmp/podcast/YYYY-MM-DD/script.md \
  --output-dir contents/tmp/podcast/YYYY-MM-DD/segments/ \
  --voice-id "$FISH_AUDIO_VOICE_ID" \
  --rate 1.0 \
  --merge contents/podcast/daily/YYYY-MM-DD/podcast.mp3

脚本自动按 <!-- SEGMENT: name --> 标记分段合成，--merge 参数自动调用 FFmpeg 合并并归一化音量。

分段合成优势：避免超长文本质量下降，失败时可单段重试。

阶段四：产出 & 分发

4.1 生成 metadata.json

包含：date, title, description, duration(秒), durationFormatted, audioFile(相对路径), audioSize(字节), keywords, series（daily/weekly/article）, items。

4.2 生成小宇宙发布素材

音频合成完成后，自动生成小宇宙所需的全部素材，无需用户额外触发。

4.2.1 单集标题

根据内容类型生成标题：

规则：

4.2.2 ShowNotes

小宇宙 ShowNotes 支持富文本。生成 Markdown 格式的 ShowNotes，用户粘贴到编辑器后自动识别。

Daily 模板:

## 今日精讲

00:40 {Top1 标题}
来自 {来源}，{一句话核心观点}

03:30 {Top2 标题}
来自 {来源}，{一句话核心观点}

06:15 {Top3 标题}
来自 {来源}，{一句话核心观点}

## 速览

08:00 更多值得关注的内容
· {第 4 条标题} — {来源}
· {第 5 条标题} — {来源}
· {第 6 条标题} — {来源}
· {第 7 条标题} — {来源}
· {第 8 条标题} — {来源}
· {第 9 条标题} — {来源}
· {第 10 条标题} — {来源}

## 相关链接

· 精讲原文：{readUrl1}
· 精讲原文：{readUrl2}
· 精讲原文：{readUrl3}
· BestBlogs: https://bestblogs.dev

Weekly 模板:

## 本周亮点

{3-5 个一句话趋势}

## 分类精选

### 模型
00:xx {标题} — {来源}
...

### 开发
xx:xx {标题} — {来源}
...

### 产品
xx:xx {标题} — {来源}
...

## 重点深度

xx:xx {标题}
{2-3 句核心内容}

## 相关链接

· 本期周刊：{newsletter_url}
· BestBlogs: https://bestblogs.dev

Article 模板:

## 文章信息

· 原文：{文章标题}
· 作者：{作者}
· 来源：{来源}

## 内容概要

{2-3 句核心观点}

## 时间线

00:00 开场
00:30 背景介绍
01:00 核心问题
01:30 关键观点
05:00 个人思考

## 相关链接

· 原文链接：{url}

ShowNotes 生成规则：

4.2.3 单集封面

调用 cover-image skill 或 image-gen skill 生成封面：

IMAGE_GEN_SKILL_DIR=$(readlink -f ~/.claude/skills/image-gen 2>/dev/null)

bun ${IMAGE_GEN_SKILL_DIR}/scripts/main.ts \
  --promptfiles contents/tmp/podcast/YYYY-MM-DD/cover-prompt.md \
  --image contents/podcast/daily/YYYY-MM-DD/cover.png \
  --ar 1:1 --quality 2k

封面规格：

生成封面的 prompt 模板：

Minimalist podcast cover, square format, clean design.
Muted color palette (ink blue #1a365d, cream #fefdfb).
Large centered text: "{日期}". Smaller text below: "{关键词}".
No photos, no gradients, flat design, generous whitespace.

4.2.4 产出文件

所有小宇宙素材保存到最终产出目录：

contents/podcast/daily/YYYY-MM-DD/
  podcast.mp3          # 音频
  metadata.json        # 元数据
  cover.png            # 单集封面
  shownotes.md         # ShowNotes（Markdown）

4.3 上传 R2（可选）

SKILL_DIR=$(readlink -f ~/.claude/skills/create-podcast 2>/dev/null)

bun ${SKILL_DIR}/scripts/upload-r2.ts \
  contents/podcast/daily/YYYY-MM-DD/podcast.mp3 \
  "podcast/daily/YYYY-MM-DD/podcast.mp3"

4.4 更新 RSS Feed（可选，扩展到 Apple/Spotify 时启用）

当前阶段可跳过。当需要分发到 Apple Podcasts/Spotify 时启用：

bun ${SKILL_DIR}/scripts/podcast-rss.ts \
  --metadata contents/podcast/daily/YYYY-MM-DD/metadata.json \
  --feed contents/podcast/podcast.xml \
  --base-url "$R2_PUBLIC_URL/podcast" \
  --upload

RSS 适用场景：Apple Podcasts、Spotify、Google Podcasts 等平台通过订阅 RSS Feed 自动同步新单集。小宇宙支持直接上传，不依赖 RSS。

4.5 ⛔ 展示 & 确认

展示完整的小宇宙发布素材：

📻 播客生成完成

🎵 音频: podcast.mp3 ({时长})
🖼️ 封面: cover.png

📝 小宇宙单集标题:
{生成的标题}

📋 ShowNotes:
{生成的 ShowNotes 全文}

请确认是否满意，或需要调整。
确认后可直接复制到小宇宙后台发布。

输出目录

contents/tmp/podcast/YYYY-MM-DD/        # 临时中间文件（gitignore）
  script.md                             # 播客脚本
  segments/                             # TTS 音频片段
  cover-prompt.md                       # 封面生成 prompt

contents/podcast/                        # 最终产出（持久化）
  daily/YYYY-MM-DD/
    podcast.mp3                         # 播客音频
    metadata.json                       # 元数据
    cover.png                           # 单集封面（1:1）
    shownotes.md                        # 小宇宙 ShowNotes
  weekly/YYYY-MM-DD/
    podcast.mp3
    metadata.json
    cover.png
    shownotes.md
  articles/{slug}/
    podcast.mp3
    metadata.json
    cover.png
    shownotes.md
  podcast.xml                           # RSS Feed（可选，扩展时启用）

参数调整

错误处理

重要: 始终先检查 API 响应中的 success 字段。

BestBlogs API

Fish.audio TTS

FFmpeg

R2 上传