| name | podcast-bridge |
| description | 一个让 AI Agent 订阅、转录、检索并理解全球播客的 Skill。支持添加和同步 RSS 订阅、获取播客单集、免费转录音频、生成章节与摘要、跨单集全文搜索，并将全文稿保存为本地 Markdown 或 Obsidian 知识库。适用于用户提供小宇宙单集链接、RSS 源、播客名称或单集编号，以及要求转录播客、总结单集、提取要点、检索话题、推荐播客、导入订阅、同步订阅或维护 RSS 源等场景。 |
podcast-bridge
podcast-bridge 用于管理播客订阅、同步 RSS 单集元数据、转录播客、生成章节、搜索本地播客知识库，并基于全文稿生成摘要或笔记。
核心原则
根据用户请求选择最窄、最直接的工作流：
| 用户请求 | 执行动作 |
|---|
| 提供单集链接并要求全文稿 | 运行 python transcribe.py "<url>" --chapters，返回全文稿路径和基础统计；4h+ 超长节目默认输出上集/下集两份 Markdown。 |
| 提供单集链接并要求总结、要点或笔记 | 先转录，读取生成的全文稿；若输出上/下集，必须读取两份稿件后再总结。 |
| 提供 RSS URL 或播客名称并要求添加 | 添加、同步或列出元数据；默认不要批量转录。 |
| 询问某个节目是否聊过某个话题 | 同步或查询本地库，并区分“全文命中”和“仅标题/简介命中”。 |
| 要求推荐播客 | 读取 podcast-bridge-feeds/feeds/*.json，按主题推荐；只有用户明确要求时才导入订阅。 |
| RSS 源损坏或订阅维护 | 使用 podcast-bridge-feeds/resolve_feeds.py 和 podcast-bridge-feeds/import_feeds.py。 |
重要边界：
transcribe.py 是确定性的执行入口，负责转录、章节生成、RSS 入库和搜索。- 超过
long_audio_threshold_minutes 的节目默认先拆成 long_audio_parts=2 个大段，再输出 _上集.md 和 _下集.md 两份稿件；最终回复应同时报告两份路径。
- 摘要需要在读取全文稿之后由 Agent 自己生成；
--summary 只是兼容旧参数和表达期望风格，不会稳定地产生摘要文件。
- 默认 ASR provider 使用
bcut，不需要 API Key。
- 查询当前状态时，应读取实时文件或 SQLite 数据库，不要依赖文档里的固定订阅数量。
- 如果用户要求摘要，最终回复必须包含摘要正文，不能只回复“转录完成”。
参考文件路由
只读取当前任务需要的参考文件：
references/transcription.md：单集转录、启动前检查、ASR provider 选项、输出路径。references/summarization.md：brief、deep、product、investment、Obsidian 等摘要格式。references/rss-workflows.md：订阅管理、订阅库导入、RSS 同步/列表/搜索/转录。references/troubleshooting.md：常见失败、编码问题、API/provider 错误、状态查询。references/project-layout.md：仓库结构、数据文件、路径假设。
常用命令
在 podcast-bridge 项目根目录运行以下命令。config.json 中的 library_dir 会决定使用哪个本地播客库。
python transcribe.py --preflight-only "<episode-url>"
python transcribe.py "<episode-url>" --chapters
python transcribe.py "<episode-url>" --chapters --long-audio-parts 2
python transcribe.py rss subs
python transcribe.py rss sync "<podcast-name>" --limit 50
python transcribe.py rss list "<podcast-name>" --limit 50
python transcribe.py rss search "<podcast-name>" "<topic>" --days 90
python transcribe.py rss transcribe "<podcast-name>" <episode-id> --chapters
python transcribe.py rss transcribe "<podcast-name>" <episode-id> --chapters --long-audio-parts 2
如果当前工作目录不在项目根目录，应使用 transcribe.py 的绝对路径。
维护内置订阅库：
cd podcast-bridge-feeds
python resolve_feeds.py bootstrap
python resolve_feeds.py add "Latent Space" --category ai --country us
python resolve_feeds.py validate feeds/
python import_feeds.py --all
交付要求
转录完成后，尽量报告生成的全文稿路径和基础统计信息，包括时长、分段数量、字数或字符数。超长节目可能生成上集/下集两份 Markdown，必须同时报告两份路径。
回答搜索类问题时，必须说明覆盖范围：有多少单集具备可搜索全文，有多少单集只有标题/简介元数据可搜索。
