听懂了 - 文章转AI播客

听懂了 (TingDong) - 文章转 AI 播客

把任意文章变成"为你量身定制"的知识音频。粘贴链接，AI 深度分析 + 语音合成，通勤/碎片时间"听懂"内容。

触发条件

仅在用户明确请求以下场景时调用：

• "把这篇文章转成播客" / "生成播客"
• "帮我读一下这篇文章" / "朗读文章"
• "听这篇文章" / "语音版" / "音频版"
• 用户发送链接并说 "tingdong" / "听懂了"

不要在普通聊天、搜索、总结等场景下自动触发。

核心能力

前置依赖

本 Skill 调用外部 REST API，无需本地安装。直接通过 HTTP 调用即可。

后端服务：http://111.229.22.145:8092（公共服务，或自行部署）

如需本地测试脚本：

# 仅需 Python 3.8+
python3 scripts/generate_podcast.py "https://mp.weixin.qq.com/s/xxxxx"

使用方式

1. 单篇文章转播客

用户输入：

把这篇文章转成播客：https://mp.weixin.qq.com/s/xxxxx

Skill 处理：

# 提交任务（异步）
curl -s -X POST http://111.229.22.145:8092/api/v1/podcast/submit \
  -H "Content-Type: application/json" \
  -d '{"content":"https://mp.weixin.qq.com/s/xxxxx","content_type":"url","style":"conversational","user_id":"user_001"}'

# 返回
{"task_id":"td_20260820_103528_d9ea7fd1","status":"pending","estimated_time":60}

即时回复用户：

👌 已收到《文章标题》 正在制作播客，预计 1-2 分钟...

轮询结果（每 5 秒，最多 5 分钟）：

curl -s http://111.229.22.145:8092/api/v1/podcast/td_20260820_103528_d9ea7fd1

完成后推送：

🎵 播客已生成！《文章标题》

🔊 点击收听 ⏱️ 约 8 分钟 | 📎 富兰克林读书俱乐部

2. 指定风格

curl -s -X POST http://111.229.22.145:8092/api/v1/podcast/submit \
  -H "Content-Type: application/json" \
  -d '{"content":"https://...","style":"deep_dive","user_id":"user_001"}'

3. 批量处理

用户发送多个链接时，分别提交，用 batch API 批量查询进度：

# 批量查询（最多 20 个）
curl -s -X POST http://111.229.22.145:8092/api/v1/podcast/batch \
  -H "Content-Type: application/json" \
  -d '{"task_ids":["td_xxx","td_yyy"]}'

4. 本地脚本调用

# 基础用法
python3 scripts/generate_podcast.py "https://mp.weixin.qq.com/s/xxxxx"

# 指定风格
python3 scripts/generate_podcast.py "https://zhuanlan.zhihu.com/p/xxxxx" --style deep_dive

# 只提交不等待
python3 scripts/generate_podcast.py "https://..." --no-wait

内容源支持

任务状态

故障排查

隐私说明

• 文章内容发送至后端服务器进行 AI 分析和语音合成
• 音频文件暂存于服务器（http://111.229.22.145:8092/tingdongle/audio/）
• 不收集用户身份信息，仅通过 user_id 区分额度

资源

• API 完整文档: references/api_docs.md
• 内容源策略: references/content_sources.md
• 后端部署指南: 联系服务提供者或参考 API 文档自行部署