PodMate — 播客管理 CLI¶
Python CLI 工具，自动订阅、下载播客并转录为文字稿，用于 cbrain 知识库的播客内容采集。
概述¶
PodMate 由 Claude Code 实现，最初从 Codex 迁移过来。核心职责是播客 RSS 订阅管理 + 自动下载 + 语音转录。
技术栈¶
- 语言： Python 3
- 数据目录：
~/.local/share/podmate/ - 转录引擎： Deepgram API（远程，不在本地跑 faster-whisper）
- 包管理： pip / standalone
架构决策¶
| 决策 | 方案 | 理由 |
|---|---|---|
| 远端转录 | Deepgram API | RPi 算力不够跑本地 Whisper，API 延迟可接受 |
| 数据存储 | ~/.local/share/ | XDG 规范，与用户配置分离 |
| 分发 | pip install / pipx | 简单可靠，不依赖容器 |
| 订阅格式 | OPML 导入 / 手动添加 | 兼容主流播客客户端导出 |
核心命令¶
# 订阅播客
podmate subscribe <rss-url>
# 检查新集数并下载
podmate sync
# 转录已下载的音频
podmate transcribe <episode-id>
# 列表
podmate list
# 全文搜索转录内容
podmate search <keyword>
当前状态¶
- ✅ GitHub 仓库已创建：
github.com/tuxknight/podmate - ✅ 核心功能（订阅、下载、转录）已实现
- ✅ 数据目录统一到
~/.local/share/podmate/ - ⏳ 与 cbrain 自动对接（转录结果自动存到 fuyuans-kb/podcasts/）
相关链接¶
- 仓库：https://github.com/tuxknight/podmate