podcast-intel

将你的 Overcast 听力历史转化为结构化的知识库，进而从近期播客节目中提炼洞察，并将其与你当前的工作和兴趣建立关联。

基于 Harold Martin 开发的三个工具构建：

• overcast-to-sqlite — https://github.com/hbmartin/overcast-to-sqlite
• podcast-transcript-convert — https://github.com/hbmartin/podcast-transcript-convert
• podcast-chapter-tools — https://github.com/hbmartin/podcast-chapter-tools

一次性初始化设置

1. 安装工具

uv tool install overcast-to-sqlite
uv tool install podcast-transcript-convert

2. 使用 Overcast 进行身份验证

overcast-to-sqlite auth
# 登录 Overcast 并将认证 Cookie 保存至 ./auth.json
# 不会保存你的密码，仅保存会话 Cookie

请将 auth.json 存放在稳定路径下（例如：~/.overcast/auth.json）：

mkdir -p ~/.overcast
mv auth.json ~/.overcast/auth.json

3. 执行首次完整同步（首次运行耗时较长）

overcast-to-sqlite all -a ~/.overcast/auth.json ~/.overcast/overcast.db -v

该命令按顺序执行 save → extend → transcripts → chapters 四个阶段。 首次运行会为所有已订阅的 RSS 源下载 XML 数据，可能需要数分钟。 默认情况下，转录文本将保存至 ~/.overcast/archive/transcripts/ 目录。

每日同步

运行以下命令以拉取最新的收听活动：

overcast-to-sqlite all -a ~/.overcast/auth.json ~/.overcast/overcast.db

如需更快更新（跳过 RSS 源 XML 的重复下载），可执行：

overcast-to-sqlite save -a ~/.overcast/auth.json ~/.overcast/overcast.db
overcast-to-sqlite transcripts -a ~/.overcast/auth.json ~/.overcast/overcast.db

仅获取已加星标（starred）节目的转录文本：

overcast-to-sqlite transcripts -s -a ~/.overcast/auth.json ~/.overcast/overcast.db

建议的定时任务调度方案：每天执行一次 overcast-to-sqlite all，例如设为凌晨 4 点（早于任何依赖此数据的晨间摘要任务）。macOS 上使用 launchd，Linux 上使用 cron。

查询近期收听记录

对 ~/.overcast/overcast.db 数据库执行如下 SQL 查询：

过去 24 小时内播放过或进度显著推进的节目

SELECT
  e.title,
  f.title AS podcast,
  e.overcastUrl,
  e.userRecommendedDate,
  e.transcriptDownloadPath,
  e.progress,
  e.played
FROM episodes e
JOIN feeds f ON e.feedId = f.overcastId
WHERE (e.played = 1 OR e.progress > 300)
  AND e.userUpdatedDate >= datetime('now', '-1 day')
ORDER BY
  e.userRecommendedDate DESC,
  e.userUpdatedDate DESC;

已加星标且具备转录文本的节目

SELECT
  e.title,
  f.title AS podcast,
  e.overcastUrl,
  e.userRecommendedDate,
  e.transcriptDownloadPath
FROM episodes_starred e
JOIN feeds f ON e.feedId = f.overcastId
WHERE e.transcriptDownloadPath IS NOT NULL
ORDER BY e.userRecommendedDate DESC
LIMIT 20;

在章节内容中进行全文检索

SELECT c.content, e.title, f.title AS podcast, c.time
FROM chapters_fts
JOIN chapters c ON chapters_fts.rowid = c.rowid
JOIN episodes e ON c.enclosureUrl = e.enclosureUrl
JOIN feeds f ON e.feedId = f.overcastId
WHERE chapters_fts MATCH 'your search term'
ORDER BY rank;

转录文本处理

转录文本以多种格式存储（SRT、WebVTT、HTML、JSON）。 使用 podcast-transcript-convert 将其标准化为 PodcastIndex JSON 格式：

transcript2json ~/.overcast/archive/transcripts/ ~/.overcast/archive/transcripts-json/

若需将转录文本作为纯文本供 LLM 分析，请解析 JSON 文件：

python3 -c "
import json, sys
data = json.load(open(sys.argv[1]))
for seg in data.get('segments', []):
    print(seg.get('speaker', ''), seg.get('body', ''))
" ~/.overcast/archive/transcripts-json/episode.json

LLM 分析工作流

当被要求分析近期收听记录时，请遵循以下流程：

步骤 1 — 查询数据库获取近期节目

在终端中使用上述“过去 24 小时”SQL 查询语句，针对 ~/.overcast/overcast.db 执行。

步骤 2 — 区分已加星标与未加星标节目

userRecommendedDate 字段非空的节目即为已加星标节目，应给予更深入的分析。

步骤 3 — 加载并分析转录文本

对每个具有 transcriptDownloadPath 字段的节目：

1. 读取转录文本文件（必要时通过 transcript2json 转换格式）
2. 提取其中的关键概念、主张、技术方法及提及的人名等信息
3. 标注重要观点出现的时间戳或章节位置

对于无转录文本的节目，可使用 episodes_extended.description 中的节目简介进行替代分析。

步骤 4 — 与用户兴趣交叉比对

向用户询问其当前正在从事的工作与关注方向，或从上下文中提取相关信息。 对每个节目，识别以下内容：

• 与用户当前项目或实际问题解决工作的直接关联
• 提及的可迁移应用的技术或框架
• 值得跟进的人物、论文或工具引用
• 值得深入思考的反共识观点或出人意料的见解

步骤 5 — 输出格式化

分析深度由用户调用该能力时指定。默认输出结构如下：

[Starred] 节目标题 — 播客名称 摘要：2–3 句概述本集核心内容 关键洞察：最具可操作性或最富启发性的观点 关联点：该内容如何与用户当前工作产生联系 后续行动：值得进一步研读的论文、人物、工具或待探索的问题

[Played] 节目标题 — 播客名称 一句话摘要 + 值得突出呈现的亮点观点

收听统计信息

overcast-to-sqlite stats ~/.overcast/overcast.db

输出内容包括：已播放总集数、累计收听时长、已加星标集数、按收听时长排序的 Top 播客列表。

搜索你的收听历史

overcast-to-sqlite search "reinforcement learning" ~/.overcast/overcast.db
overcast-to-sqlite search "agentic" ~/.overcast/overcast.db -l 5

在节目标题、RSS 源描述以及章节内容（FTS5 全文索引）中进行跨字段搜索。

数据库位置

默认数据库路径：~/.overcast/overcast.db 默认转录文本归档路径：~/.overcast/archive/transcripts/ 默认认证文件路径：~/.overcast/auth.json

所有路径均可通过 CLI 参数覆盖。完整参数列表请参阅 overcast-to-sqlite --help。

注意事项

• 转录文本仅对启用了 podcast:transcript RSS 标签的播客提供；并非所有节目都包含转录文本。
• extend 命令将为每个 RSS 源额外向数据库增加约 2MB 数据量；若订阅大量播客，数据库体积将显著增大。
• auth.json 中仅包含会话 Cookie，不包含密码；可通过 overcast-to-sqlite auth 重新生成。
• 如需仅为已加星标节目下载转录文本，请在 transcripts 命令中添加 -s 标志。
• 章节 FTS5 全文搜索是一种高效方式，可在无需通读全部转录文本的前提下，精准定位特定话题在全部收听历史中被讨论的具体位置。