播客发布到小宇宙 Skill

概述

此 Skill 实现了每日科技早报播客的全自动发布流程：播客生成 → RSS.com发布 → 小宇宙同步 → 飞书通知。

项目路径: /Users/qitmac001395/workspace/QAL/ideas/apps/daily-podcast-ai

核心能力

使用方法

方式1: 自动执行（推荐）

无需操作，每天早上7点自动运行：

07:00 - 从缓存读取新闻（0:00-6:00收集的30-50篇）
07:02 - AI优选Top 10新闻
07:05 - 生成对话脚本（双人播报模式）
07:10 - TTS语音合成（ElevenLabs）
07:15 - 合并音频 + 生成封面
07:17 - 发布到RSS.com
07:18 - 发送飞书通知
08:00 - 小宇宙自动同步

方式2: 手动发布指定日期

cd /Users/qitmac001395/workspace/QAL/ideas/apps/daily-podcast-ai

# 发布昨天的播客
python scripts/publish_to_rss.py --date 2026-01-14

# 生成今天的播客并发布
python scripts/daily_generate.py --from-cache && \
python scripts/publish_to_rss.py --date $(date +%Y-%m-%d)

方式3: 仅发送飞书通知

python scripts/notify_feishu.py \
  --date 2026-01-14 \
  --rss-url "https://rss.com/podcasts/xxx/feed.xml" \
  --episode-url "https://rss.com/podcasts/xxx/episodes/ep_xxx" \
  --article-count 10

首次配置指南

步骤1: RSS.com配置（5分钟）

1. 注册账号: https://rss.com/ → Sign Up

2. 创建播客: Dashboard → Create New Podcast

   名称: 今日科技早报
   分类: Technology / News
   语言: Chinese (Simplified)
   

3. 获取凭证:

   • Settings → API Keys → Generate New API Key
   • 复制 API Key: rss_com_sk_xxx
   • 从播客URL获取 Podcast ID

4. 配置环境变量: 编辑 apps/daily-podcast-ai/.env：

   RSS_COM_API_KEY=rss_com_sk_your_actual_key
   RSS_COM_PODCAST_ID=your-podcast-uuid
   

步骤2: 小宇宙订阅配置（3分钟，仅需一次）

1. 登录创作者平台: https://podcaster.xiaoyuzhoufm.com/podcasts/695e1e64e0970c835fb2e784/home
2. 添加RSS订阅:
   • 设置 → RSS Feed设置
   • 输入: https://rss.com/podcasts/{YOUR_ID}/feed.xml
   • 点击「验证并导入」
3. 首次同步: 点击「立即同步」

步骤3: 飞书通知配置（可选，5分钟）

1. 创建飞书应用: https://open.feishu.cn/app
2. 添加权限: im:message + im:message:send_as_bot
3. 配置环境变量:

   FEISHU_APP_ID=cli_xxx
   FEISHU_APP_SECRET=xxx
   FEISHU_RECEIVER_OPEN_ID=ou_18b8063b232cbdec73ea1541dfb74890  # 王植萌
   

步骤4: 测试验证（2分钟）

# 测试发布
python scripts/publish_to_rss.py --date 2026-01-14

# 预期看到:
# ✅ Episode published successfully!
# 📱 发送飞书通知...
# ✅ 飞书消息发送成功

技术架构

集成流程图

┌─────────────┐
│ 早报生成     │  scripts/daily_generate.py
│ (每天7点)    │  - 从cache读取新闻
└──────┬──────┘  - AI优选Top 10
       │         - TTS语音合成
       ↓
┌─────────────┐
│ 输出文件     │  output/{date}/dailyReport/
│             │  - podcast-{date}-1.2x.mp3
│             │  - cover-{date}.png
└──────┬──────┘  - script-{date}.md
       │
       ↓
┌─────────────┐
│ RSS发布     │  scripts/publish_to_rss.py
│             │  - 上传音频到RSS.com
└──────┬──────┘  - 创建单集元数据
       │
       ├──────────────────┐
       ↓                  ↓
┌─────────────┐    ┌─────────────┐
│ RSS Feed    │    │ 飞书通知     │  scripts/notify_feishu.py
│ 更新        │    │             │  - 发送卡片消息
└──────┬──────┘    └─────────────┘  - 包含RSS链接
       │
       ↓ (每小时)
┌─────────────┐
│ 小宇宙同步   │  podcaster.xiaoyuzhoufm.com
│             │  - 自动抓取RSS
└─────────────┘  - 发布到App

关键文件

环境变量清单

# 必需 - 播客生成
ELEVENLABS_API_KEY=sk_xxx          # TTS语音合成

# 可选 - AI增强
OPENAI_API_KEY=sk-xxx              # AI摘要和优选

# 必需 - RSS发布
RSS_COM_API_KEY=rss_com_sk_xxx    # RSS.com API
RSS_COM_PODCAST_ID=xxx-xxx-xxx     # 播客频道ID

# 可选 - 飞书通知
FEISHU_APP_ID=cli_xxx              # 飞书应用ID
FEISHU_APP_SECRET=xxx              # 飞书密钥
FEISHU_RECEIVER_OPEN_ID=ou_xxx     # 接收者Open ID

代码改进（已实现）

1. 智能文件名识别（publish_to_rss.py:258-269）

问题: 项目生成 podcast-{date}-1.2x.mp3，但脚本期望 podcast-{date}.mp3

解决: 自动查找并使用多速率版本

audio_file = base_path / f"podcast-{args.date}.mp3"
if not audio_file.exists():
    audio_file_12x = base_path / f"podcast-{args.date}-1.2x.mp3"
    audio_file_15x = base_path / f"podcast-{args.date}-1.5x.mp3"

    if audio_file_12x.exists():
        audio_file = audio_file_12x

2. 多端点重试机制（publish_to_rss.py:106-159）

问题: RSS.com API端点可能变化

解决: 依次尝试3个可能的端点

upload_endpoints = [
    f"{self.API_BASE_URL}/upload",
    f"{self.API_BASE_URL}/media",
    f"{self.API_BASE_URL}/podcasts/{self.podcast_id}/media"
]

3. 飞书通知集成（publish_to_rss.py:343-362）

功能: 发布成功后自动调用 notify_feishu.py

特性:

• 使用 check=False 避免通知失败中断主流程
• 自动提取文章数量
• 传递RSS URL和单集URL

飞书消息效果

发布成功后，接收者会收到蓝色卡片消息：

┌─────────────────────────────────────────┐
│ 🎙️ 今日科技早报已发布                    │
├─────────────────────────────────────────┤
│ 📅 日期: 2026-01-14                     │
│ 📰 内容: 精选 10 篇科技新闻              │
│                                         │
│ 📢 发布状态:                             │
│ - ✅ RSS.com 发布成功                    │
│ - ⏳ 小宇宙同步中（预计1小时内）          │
│                                         │
│ 🔗 单集链接: https://rss.com/...        │
│ 📡 RSS Feed: https://rss.com/...feed.xml│
│                                         │
│ ───────────────────────────────────────  │
│ 💡 小宇宙订阅步骤:                       │
│ 1. 打开小宇宙创作者平台                  │
│ 2. 点击「立即同步」查看最新单集          │
│ 3. 首次设置需添加RSS订阅（仅需一次）      │
└─────────────────────────────────────────┘

故障排查

常见问题

调试命令

# 查看最近的生成日志
tail -50 logs/daily_run.log

# 检查错误日志
tail -50 logs/daily_error.log

# 验证RSS Feed可访问
curl -I "https://rss.com/podcasts/{YOUR_ID}/feed.xml"

# 验证环境变量
python3 -c "from dotenv import load_dotenv; import os; load_dotenv(); \
  print('RSS Key:', bool(os.getenv('RSS_COM_API_KEY'))); \
  print('Podcast ID:', bool(os.getenv('RSS_COM_PODCAST_ID')))"

使用场景

场景1: 每日自动发布（默认）

触发: 每天07:00自动执行 流程: 完整的生成 → 发布 → 通知 无需操作: 配置一次后永久生效

场景2: 补发昨天的播客

# 用户说: "帮我重新发布昨天的播客到小宇宙"
python scripts/publish_to_rss.py --date 2026-01-14

场景3: 仅通知不发布

# 用户说: "通知植萌播客已发布"
python scripts/notify_feishu.py \
  --date 2026-01-14 \
  --rss-url "https://rss.com/podcasts/xxx/feed.xml" \
  --article-count 10

场景4: 生成但不发布

# 用户说: "生成今天的播客但先不发布"
python scripts/daily_generate.py --from-cache
# 不运行 publish_to_rss.py

技术细节

RSS.com API集成

API版本: v4 Base URL: https://api.rss.com/v4 认证方式: Bearer Token

核心端点:

POST /upload                           # 上传文件（主端点）
POST /media                            # 备选端点1
POST /podcasts/{id}/media              # 备选端点2
POST /podcasts/{id}/episodes           # 创建单集
GET  /podcasts/{id}/feed.xml           # RSS Feed

文件上传:

• 音频: 最大100MB，支持MP3/M4A
• 封面: 最大5MB，推荐3000x3000px PNG
• 超时: 120秒

小宇宙集成方式

方式: RSS订阅（非API上传）

优势:

• ✅ 一次配置，永久生效
• ✅ 无需逆向工程小宇宙API
• ✅ 官方支持，稳定可靠
• ✅ 支持多平台分发

更新频率:

• 默认: 每小时
• 可设置: 30分钟/2小时/4小时

飞书通知实现

消息类型: Interactive（卡片消息）

卡片结构:

{
  "header": {"title": "🎙️ 今日科技早报已发布", "template": "blue"},
  "elements": [
    {"tag": "markdown", "content": "📅 日期: {date}\n📰 内容: 精选 {count} 篇..."}
  ]
}

依赖库: httpx>=0.27.0

监控与维护

日志位置

logs/
├── daily_run.log        # 主日志（生成+发布）
├── daily_error.log      # 错误日志
├── hourly-stdout.log    # 每小时收集日志
└── hourly-stderr.log    # 收集错误

关键日志搜索

# 查看最近5次发布状态
grep "Publication completed" logs/daily_run.log | tail -5

# 查看RSS发布错误
grep "RSS" logs/daily_error.log

# 查看飞书通知记录
grep "飞书通知" logs/daily_run.log | tail -5

数据清理

# 清理30天前的播客文件（节省空间）
find output/ -type d -mtime +30 -exec rm -rf {} +

# 清理缓存（保留最近7天）
find cache/ -name "*.json" -mtime +7 -delete

成本预估

每日成本

月度总计: ¥45-90（主要是ElevenLabs和OpenAI）

免费额度

• ElevenLabs: 10,000 credits/月（约10分钟）
• OpenAI: 需付费，但gpt-4o-mini成本极低
• RSS.com: 免费版支持5GB存储+流量
• 飞书: 企业自建应用免费

扩展功能（可选）

1. 多平台分发

将同一个RSS Feed提交到：

• 小宇宙（已支持）
• 喜马拉雅
• 荔枝FM
• Apple Podcasts
• Spotify Podcasts

2. 数据分析

从RSS.com获取统计数据：

curl -H "Authorization: Bearer $RSS_COM_API_KEY" \
  "https://api.rss.com/v4/podcasts/$RSS_COM_PODCAST_ID/analytics"

3. 智能推送

根据播放数据优化：

• 调整发布时间（当前07:00）
• 优化新闻选择策略
• A/B测试不同播报风格

4. 批量操作

# 批量发布最近7天的播客
for date in $(seq -f "%Y-%m-%d" 7 -1 1); do
  python scripts/publish_to_rss.py --date $date
  sleep 10
done

注意事项

重要提醒

1. API凭证安全:

   • ✅ .env 已在 .gitignore 中
   • ❌ 不要将API Key提交到Git
   • ❌ 不要在日志中打印完整API Key

2. 文件命名规范:

   • 项目生成带速率后缀的文件（-1.2x.mp3）
   • 发布脚本会自动识别
   • 优先使用1.2x版本（平衡时长和音质）

3. 错误处理策略:

   • RSS发布失败 → 中断流程（需要人工介入）
   • 飞书通知失败 → 仅记录日志（不影响发布）
   • 小宇宙同步延迟 → 可手动触发

4. RSS Feed更新频率:

   • RSS.com: 实时更新
   • 小宇宙: 每小时抓取（可配置）
   • 加速同步: 手动点击「立即同步」

相关资源

官方文档

• RSS.com API: https://api.rss.com/v4/docs
• 小宇宙创作者指南: https://podcaster.xiaoyuzhoufm.com/help
• 飞书开放平台: https://open.feishu.cn/document/

项目文档

• 完整集成指南: docs/XIAOYUZHOU_INTEGRATION.md
• 快速开始: QUICKSTART_XIAOYUZHOU.md
• 主项目README: apps/daily-podcast-ai/README.md

工具链接

• Feed验证: https://validator.w3.org/feed/
• 卡片消息构建: https://open.feishu.cn/tool/cardbuilder
• ElevenLabs管理: https://elevenlabs.io/app/

更新记录

• 2026-01-15: 初始版本，支持RSS.com自动发布和小宇宙订阅
• 2026-01-15: 添加飞书通知功能（王植萌）
• 2026-01-15: 修复多速率音频文件名识别问题
• 2026-01-15: 增强API错误处理，支持多端点重试

Skill维护者

• 创建者: Claude Code
• 项目: daily-podcast-ai
• 版本: v1.0.0
• 最后更新: 2026-01-15