PodMate — 项目进度
播客伴侣 — 订阅、下载、转录、翻译、配音一条命令搞定。
项目管理：GitHub Issues + PR 分支流程 | 知识库文档管理
状态总览
| 看板 |
当前 |
| ✅ Done |
所有 7 个 Issues 已解决 (PR #7-#14) |
| ✅ Done |
177 tests, 74% coverage, ruff/CI 全绿 |
| 🟢 待定 |
等 Fuyuan 验收 + 确定 Phase 4 方向 |
开发流程
发现/决定 → 开 Issue（带验收标准）
→ Claude Code 拉分支 `feat/issue-N-xxx`
→ 写代码 + 测试 → 开 PR（Closes #N）
→ ProMan review（diff + pytest + lint）
→ Merge to main → Close Issue
Phase 0 — 🐛 修 bug
| # |
Issues |
状态 |
| 1 |
sub <编号> 跨进程丢结果 |
✅ 内联 iTunes 搜索 + --pick N |
| 2 |
await resp.json() 导致 discover 无法搜索 |
✅ 0b9f1dd 修复 + 测试 mock 同步修正 |
| #6 |
mark -1 --read 负号 Bug → --id -1 |
✅ #6 solved (PR #8) |
Phase 1 — 📻 订阅管理基础 ✅
| # |
事项 |
状态 |
备注 |
| 1 |
describe <podcast-id> |
✅ |
播客详情 + 最近集 |
| 2 |
list |
✅ |
已订阅列表 + 状态总览 |
| 3 |
unsubscribe |
✅ |
取消订阅 |
| 4 |
episodes <feed-id> |
✅ |
剧集列表 + 读/星标标记 |
| 5 |
episode <id> |
✅ |
集数详情 + 路径 |
| 6 |
mark --read/--star |
✅ |
现支持 --id 负数 ID |
| 7 |
Podcast Index 集成 |
✅ |
6ab3c5c |
Phase 2 — 🎯 转写升级 ✅
| # |
事项 |
状态 |
备注 |
| 1 |
说话人分离 |
✅ |
3da247c |
| 2 |
时间戳 [HH:MM:SS] |
✅ |
3da247c |
| 3 |
语气标记 [笑声][掌声][音乐] |
✅ |
cdc6bba |
| 4 |
结构化文字稿 .json + .md |
✅ |
3da247c |
| 5 |
podmate read 终端阅读 |
✅ |
cf54f1b |
| 6 |
podmate search 全文搜索 |
✅ |
447f413 |
| #1 |
podcasts/index.md 自动生成 |
✅ #1 solved (PR #7) |
转写完成自动更新索引 |
| #2 |
podmate export 手动导出 |
✅ #2 solved (PR #9) |
--format json/md, --output, --id |
Phase 3 — 🧠 cbrain 知识库对接 & 持续优化 ✅
| # |
事项 |
状态 |
备注 |
| 1 |
转写稿自动导出到 cbrain |
✅ |
pipeline 自动导出 |
| 2 |
自动轮询 RSS |
✅ |
Hermes cronjob 每 6h |
| #3 |
podmate sync-cbrain 批量导出 |
✅ #3 solved (PR #12) |
--dry-run, --since |
| #4 |
自动轮询优化 + 配置化 |
✅ #4 solved (PR #11) |
沉默输出, poll.interval_hours |
| #5 |
测试覆盖提升 |
✅ #5 solved (PR #10) |
57%→74% |
Phase 4 — 🎙️ 配音 & 更多（待规划）
已解决 Issues 清单
| # |
类型 |
标题 |
PR |
状态 |
| 1 |
feat |
podcasts/index.md 自动生成 |
#7 |
✅ merged |
| 2 |
feat |
podmate export 手动导出 |
#9 |
✅ merged |
| 3 |
feat |
sync-cbrain 批量导出 |
#12 |
✅ merged |
| 4 |
feat |
自动轮询优化 + 配置化 |
#11 |
✅ merged |
| 5 |
test |
测试覆盖提升 |
#10 |
✅ merged |
| 6 |
bug |
mark 命令负号 Bug |
#8 |
✅ merged |
| 7 |
refactor |
CLI 层次化重构 |
#14 |
✅ merged |
验收测试结果
| 测试项 |
结果 |
discover 搜索 iTunes |
✅ Lex Fridman 499 集 |
status 空状态 |
✅ 显示 0 |
search 无数据 |
✅ "未找到匹配" |
episode/describe/mark 不存在 ID |
✅ 中文错误提示 |
poll --dry-run 无订阅 |
✅ "还没有订阅" |
mark --id -1 --read 负号 |
✅ 支持 |
| ruff lint |
✅ 0 errors |
| pytest |
✅ 177/177 passed |
| 测试覆盖率 |
✅ 74% |
关键信息
- 仓库： github.com/tuxknight/podmate
- 测试： 177 tests, 74% coverage, ruff 0 errors
- CI：
.github/workflows/ci.yml (pytest + ruff, py3.11+3.13) 全绿
- 数据目录：
~/.local/share/podmate/
- 文字稿：
.json (结构化) + .md (带时间轴+说话人+语气标记)
- PR 历史： 7 个 PR (#7-#14) — 全部已 merge, Issues 全部 closed
更新: 2026-07-10 | 所有 7 个 Issues 解决，全新层次化 CLI，177 tests, 74% coverage, CI 全绿