QMReader 数据读取
通过项目自带的命令行脚本读取 https://rss.qiaomu.ai 的数据。脚本位于本 skill 目录下的
scripts/qm_reader.py，只依赖 Python 标准库，无需安装任何东西。
用法
所有命令都支持 --json 输出原始 JSON（需要完整结构化数据时使用）。
SCRIPT="<skill目录>/scripts/qm_reader.py"
python3 "$SCRIPT" entries --limit 20 # 最新文章列表（默认 60 篇）
python3 "$SCRIPT" sources # 订阅源列表（含 id、分类、文章数）
python3 "$SCRIPT" source <source_id> # 某个订阅源下的文章
python3 "$SCRIPT" entry <entry_id> # 文章正文（原文；原文为空时自动回退到改写版）
python3 "$SCRIPT" entry <entry_id> --translation # 中文翻译
python3 "$SCRIPT" entry <entry_id> --rewrite # 乔木改写版
python3 "$SCRIPT" raw "/api/entry/<id>" # 任意 /api 路径的原始 JSON
<skill目录> 即本 SKILL.md 所在目录。
典型工作流
- 用户问"最近有什么新文章" → 跑
entries，把标题和时间整理成简洁清单回复。 - 用户要读/总结某篇文章 → 先用
entries或sources拿到 entry id，再跑entry <id>；
如果正文质量差或用户偏好中文表达，改用--translation或--rewrite版本作为总结素材。 - 用户想看某个订阅源的内容 → 先
sources按名字找到 source id，再source <id>。 - 翻页：
source命令返回nextCursor时，用
raw "/api/sources/<id>/entries?limit=40&ready=rewrite&cursor=<cursor>"取下一页。
回复用户的注意事项
- 列表输出里每篇文章的方括号内是 entry id，读取正文时要原样传给
entry命令。 - 时间戳为服务器返回的毫秒 epoch，脚本已转成本地时间。
- API 只返回已就绪（ready=rewrite）的内容；服务端正在生成的文章不会出现在结果里。
- 网络失败会以非零退出码结束并打印错误原因（HTTP 状态码或 DNS/连接错误），
此时如实告知用户即可，不要编造文章内容。
数据来源说明
此 API 与 QMReader iOS 客户端使用同一后端，接口契约参见项目中
QMReader/APIClient.swift 与 QMReader/Models.swift。主要端点：
| 端点 | 说明 |
|---|---|
/api/entries?limit=N&ready=rewrite |
跨源最新文章 |
/api/sources?ready=rewrite |
订阅源列表 |
/api/sources/{id}/entries?limit=&cursor= |
单源文章，cursor 分页 |
/api/entry/{id} |
文章详情（含 content、summary、rewrite.body 等） |
/api/entry/{id}/translation |
中文翻译（段落对数组 content[].target/targetHtml） |
/api/entry/{id}/rewrite |
乔木改写版（markdown body） |
