开源、本地优先的 AI 研究助手。自动发现高质量信源，采集 RSS 与已授权公众号，并生成日报、周报和月报。
你不需要先整理 RSS、作者或公众号。只要告诉 iRead 你关注什么，它会先给出信源、代表作、评分和风险供你检查；得到批准后才开始采集。
不接 RSS、不登录公众号、不调用模型，也不安装定时任务。先运行离线证据合成 Demo，确认本地运行时能完成事件去重、信源角色区分、冲突提示和 Markdown / JSON 输出：
git clone https://github.com/roy-tong/iRead.git
cd iRead
bin/iread doctor --surface cli --offline
bin/iread demo --output-dir ./iread-demo成功标准：iread-demo/offline-demo.md 和 offline-demo.json 均存在，命令明确返回 network_used: false、model_used: false。这一步只证明本地核心闭环，不声称已经验证真实信源、长期报告质量或持续使用价值。
当前实时监测要求 macOS、Python 3.9+ 和联网环境。两种路径：
快速路径（推荐）：批准一个 RSS-only 试用后，一条命令完成采集、标注和首份日报：
bin/iread activate --approved --skip-wechat --bootstrap--bootstrap 会自动执行：多轮采集 → 并行标注（最多 8 批）→ 生成首份日报。仍想逐步确认，或首次就大规模回补，再按下面的顺序逐级验证：
- 离线 Demo：确认安装与输出；
- RSS-only 小试：1 个领域、3–10 个信源、只生成 1 份本地报告；
- 连续 7 天使用：每天判断报告是否节省时间、是否遗漏关键内容；
- 只有第 3 步有价值，再接更多信源、公众号和定时任务。
标注尚未完成时，可以用 report daily --allow-partial（或 run --allow-partial）从已分析的文章生成报告，报告中会标注数据覆盖率，而不是一直等不到报告。
需要 GitHub CLI 2.90.0 或更高版本；gh skill 当前处于 Public Preview。若本地没有该子命令，请先升级 GitHub CLI。安装前可以先预览 Skill 内容：
gh skill preview roy-tong/iRead iread
gh skill install roy-tong/iRead iread --agent codex --scope user也可以使用支持 70+ Agent、公开匿名安装数的 skills.sh CLI：
npx skills add roy-tong/iRead --skill iread -g -a codex -y首次运行时，Skill 会按需安装本地 iRead runtime。新用户应先运行离线 Demo；在用户读过一份真实报告前，Agent 不应默认安装定时任务。
Codex：
set -o pipefail; curl -fsSL https://cdn.jsdelivr.net/gh/roy-tong/iRead@main/install | bash -s -- codexClaude Code 只需把最后的 codex 换成 claude-code。豆包专业版和 WorkBuddy 适配仍处于实验阶段。
用 iRead 同时订阅医疗器械监管、新能源电力市场和独立游戏发行。
先推荐信源和代表作，我确认前不要启动采集。
iRead 会按领域展示候选信源及代表作。你可以删除、替换或补充信源，再选择 light、standard 或 deep 报告。批准后先启动小规模 RSS 试用；最近一个自然月回补、公众号接入和本地定时任务作为后续独立决策。
flowchart LR
A["说出一个或多个领域"] --> B["检查信源与代表作"]
B --> C["选择报告深度"]
C --> D["批准一次小规模试用"]
不希望运行 curl | bash，或要安装到其他 Agent？查看 完整安装说明。
信息检索真正困难的部分通常不是“总结文章”，而是判断该长期听谁的、哪些内容互相重复、结论由什么证据支撑。
| 常见 RSS / AI 摘要工具 | iRead |
|---|---|
| 用户自己提供订阅源 | 用户提供领域，iRead 生成待审核信源组合 |
| 逐篇摘要，重复事件反复出现 | 事件级去重，追踪共识、分歧和变化 |
| 官方、媒体、KOL 混为一谈 | 区分一手证据、独立核验、专业分析、专家经验和发现线索 |
| 只回答“今天发了什么” | 日报看新增，周报看演化，月报看结构性变化 |
| 数据通常进入云端 | 配置、凭据、文章和报告默认保留在本机 |
适合需要长期跟踪专业领域的研究者、投资人、产品经理、行业从业者和学生。
严格提案必须覆盖五种角色：
- 一手来源：政府、监管机构、标准组织、公司原始发布。
- 独立报道：交叉核验事实。
- 专业分析：解释机制与影响。
- 专家与从业者：补充实践经验和非公式知识。
- 发现信号：发现新话题，不能单独支撑事实结论。
冷启动评分只是候选排序，不是对信源的永久判决。iRead 会保留利益冲突、抓取限制和不确定性。详见 信源质量方法。
| 模式 | 适合 | 输出特点 |
|---|---|---|
light |
只想知道关键变化 | 最短，只保留高优先级项 |
standard |
长期专业跟踪 | 默认，平衡覆盖与阅读时间 |
deep |
研究、投资或战略分析 | 更多证据、分歧和跨期回看 |
日报负责发现新增事实和异常信号；周报合并重复事件、分析演化；月报维护趋势账本并回看此前判断。所有新订阅默认只生成本地 Markdown。
自动测试和历史基准说明代码路径可运行，但维护者尚未把 iRead 作为稳定的日常工作流持续使用。因此，beta.10 把“首次成功”与“长期有用”明确拆开：
- 离线 Demo 在本地完成证据合成，不需要网络、模型、凭据或定时任务；
- 83 个自动测试覆盖安装、权限、采集、报告、性能与离线 Demo；
- 历史基准中，15 个 RSS 源并发回补最近一个自然月约 11 秒返回，14 个成功、导入 318 篇；
- 历史日报质量规则曾得分 94/100，但这不能替代连续使用中的“是否值得每天读”。
稳定版新增一条硬门槛：维护者先完成至少 7 天连续自用，并公开记录每天的阅读价值、重复率、关键遗漏、人工修正和总耗时。完整方法、失败项和边界见 Beta 6 第三方体验基准 与 用户体验验收。
- 支持任意多个领域合并为一个订阅，不内置或限制特定行业。
- 支持 RSS / Atom、公开网页候选源和已授权微信公众号。
- 微信采集需要用户拥有某个公众号的管理员或运营者权限；没有权限时可使用 RSS / 网页模式。
web_pending会明确显示为覆盖缺口，不伪装成已经采集。- 当前运行时优先支持 macOS，定时任务运行时机器需要开机并联网。
0.2.0-beta.10是公开 Beta，不是稳定版；真实长期价值仍在自用验证中。
- 配置、凭据、文章和报告默认留在本机。
- 公开归档默认只包含链接、元数据和结构化分析，不上传第三方全文。
- 只有确认拥有转载权或兼容许可证时，才能导出第三方全文。
代码使用 MIT License。第三方组件、信源和内容权利边界见 NOTICE.md 和 开源发布说明。
| 你想做什么 | 入口 |
|---|---|
| 只写领域，让社区协助设计订阅 | 提交订阅需求 |
| 安装失败或结果异常 | 报告问题 |
| 纠错或推荐高质量信源 | 贡献信源 |
| 参与开发 | 贡献指南 |
| 查看全部技术文档 | 文档导航 |
开发者可运行 scripts/test.sh，并使用 bin/iread --help、bin/iread capabilities 和 bin/iread workspace 检查结构化能力与本地状态。
| 项目 | 约定 |
|---|---|
| 何时调用 | 用户想长期监测一个或多个领域，而不是做一次性搜索 |
| 输入 | 研究领域、报告深度、候选信源修改和采集授权 |
| 输出 | 信源提案、覆盖审计、日报、周报、月报和趋势账本 |
| 写入与权限 | 默认只写本机；采集、回补和定时任务必须按控制面要求获得批准 |
| 成功标准 | workspace、订阅 acceptance 和报告路径均可被结构化检查 |
gh skill search的关键词排名用于判断是否能被 Agent 搜到；它不是曝光次数。- skills.sh 徽章记录通过其 CLI 产生的匿名安装数；用户可关闭该 CLI 的遥测。
- GitHub Traffic、Star、Issue 和 Release 下载用于判断关注与转化，不能当作 Agent 调用次数。
- iRead 当前不联网回传研究领域、信源、文章、报告或本机身份。实际调用次数在没有用户自愿遥测前保持不可观测。
如果 iRead 对你有用，给仓库点一个 Star，会帮助更多需要高质量信息源的人找到它。
iRead 由 Roy.Tong 发起并维护。更多关于 AI 产品、具身智能与开源研究工具的文章见 Roy's Notes。