用途:通过项目自带的命令行脚本读取 https://rss.qiaomu.ai 的数据,用于查看乔木/QMReader 上的新文章、读取某篇文章、获取中文翻译或乔木改写版,也可在 qmreader-ios 项目中调试相关接口。
主要能力:脚本位于本 skill 目录下的 scripts/qm_reader.py,只依赖 Python 标准库,无需安装。支持获取最新文章列表、订阅源列表(含 id、分类、文章数,禁用源带 ✗ 标记)、某订阅源下的文章、文章正文(原文为空时自动回退到改写版)、中文翻译、乔木改写版,以及任意 /api 路径的原始 JSON。所有命令支持 --json 输出原始结构化数据。
使用方式: SCRIPT="<skill目录>/scripts/qm_reader.py" python3 "$SCRIPT" entries --limit 20 python3 "$SCRIPT" sources 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/" 典型流程:先跑 entries 或 sources 拿到 entry id,再跑 entry <id>;需要中文表达时用 --translation 或 --rewrite。source 返回 nextCursor 时,用 raw "/api/sources/<id>/entries?limit=40&ready=rewrite&cursor=<cursor>" 翻页。
限制:API 只返回已就绪(ready=rewrite)的内容,服务端正在生成的文章不会出现。订阅源可能被服务端禁用,禁用源的接口返回 HTTP 404,其文章也不在跨源 entries 列表中,遇到时应告知用户该源不可用,不要反复重试。网络失败会以非零退出码结束并打印错误原因,此时如实告知用户,不要编造文章内容。时间戳为服务器返回的毫秒 epoch,脚本已转成本地时间。