README file from
GithubWeave Incremental Reading
把「以后再看」变成可持续推进的阅读队列
Standalone incremental reading for Obsidian — topics, reading points, calendar scheduling, and source resume
中文文档
Weave Incremental Reading(插件 ID:weave-incremental-reading)是一款独立的 Obsidian 增量阅读插件。
它帮你把散落在 Markdown、内容块链接、PDF(配合 PDF++)、Canvas、网页、EPUB 等处的材料,整理成可排期、可续读、可回跳的阅读点队列,再用专题与日历长期推进——而不是让内容停在「收藏了就算读过了」。
本插件可单独使用,不依赖 Weave 主插件。需要 EPUB 库内阅读或记忆牌组制卡时,再按需安装系列中的其它插件。
三个核心概念
| 概念 | 说明 |
|---|---|
| 阅读点 | 一条待阅读任务,带来源溯源;可从队列一键回跳原文继续读。 |
| 专题(IRDeck) | 阅读点的容器,以 .irdeck 文件保存在知识库中,按主题或计划分组。 |
| 增量阅读日历 | 插件主界面:按日期查看待处理、已排期与逾期的阅读点,安排每日节奏。 |
核心能力
- 增量阅读日历 — 月历热力与当日队列;查看负载、优先级与逾期项;支持连续阅读等辅助操作
- 统一「添加链接」 — 粘贴网页、双链、块引用、PDF++ 定位、Canvas 节点、EPUB 定位等,一次完成命名、专题与首次排期
- 专题与阅读点管理 — 优先级、暂停、归档;打开
.irdeck在专题视图与日历之间切换 - 调度与续读 — 加工流 / 阅读清单等策略,每日上限与时间预算;完成后自动安排下次出现
- 材料导入 — 从 Markdown 批量拆分导入;高级功能支持订阅文件夹、PDF / EPUB 章节批量导入
- 来源回跳 — Markdown、PDF++、Canvas、网页、EPUB 等保留稳定续读位置
快速上手
- 安装并启用插件(见下方安装)
- 打开增量阅读日历(左侧功能区日历图标,或命令面板「打开增量阅读日历」)
- 点击日历顶部 「+」/ 添加链接:粘贴来源 → 修改名称 → 选择专题 → 安排首次阅读日 → 保存
- 在日历中打开今日待读项,回到原文续读;完成后标记进度,系统会安排下次出现时间
日常主路径建议走 添加链接;选区命令与右键菜单仍可用。
安装与更新
从 Release 安装(当前推荐)
-
打开本仓库 Releases,下载最新版本附件
-
在知识库中创建目录:
.obsidian/plugins/weave-incremental-reading/ -
将同一次 Release 中的
main.js、manifest.json、styles.css放入该目录 -
在 设置 → 社区插件 中启用 Weave Incremental Reading
通过 BRAT 跟踪版本
若使用 BRAT,可添加本仓库并选择 Weave Incremental Reading 检查更新。
Obsidian 社区插件目录
若插件已出现在社区目录中,可在 设置 → 社区插件 中搜索 Weave Incremental Reading 安装与更新。
系统要求
| 项目 | 要求 |
|---|---|
| Obsidian | ≥ 1.8.7(以 manifest.json 的 minAppVersion 为准) |
| 平台 | 桌面端与移动端 |
与 Weave 系列的关系
Weave 是一组面向 Obsidian 的知识工作流插件,围绕 读 → 记 → 排 → 复习 组织长期学习。本插件负责其中的增量阅读队列与日历排期,与其它成员职责分离、可组合使用。
| 插件 | 主要职责 |
|---|---|
| Weave Incremental Reading(本插件) | 阅读点、专题、日历调度、续读与来源回跳 |
| Weave 主插件 | 记忆牌组、题库、摘录制卡、FSRS 复习等 |
| Weave EPUB Reader | 库内 EPUB 阅读、摘录与章节定位 |
怎么组合:
- 只做增量阅读队列 — 只装本插件即可
- 还要读 EPUB 并回跳章节 — 本插件 + Weave EPUB Reader
- 还要制卡与复习 — 本插件 + Weave 主插件
- 完整闭环(读 → 记 → 排 → 复习) — 三款都装
外部协作(非 Weave 系列):PDF++ 可用于 PDF 选区/定位链接,再通过「添加链接」纳入队列。
免费功能与高级功能
当前版本:增量阅读日历与 Markdown 阅读点主流程免费开放,足以完成日常增量阅读。
| 免费 | 高级(需激活) |
|---|---|
| 日历与 Markdown 阅读点 | 批量导入 PDF / EPUB 章节阅读点 |
| 专题与阅读点管理(优先级、暂停、归档) | 调度策略自定义、交错学习设置 |
| 基础调度、今日待读、续读回跳 | 订阅文件夹自动同步 |
| 添加链接创建阅读点(含 MD、块链接、PDF++ 等) | 统计分析、阅读计时器、日历背景墙等 |
| 从 Markdown 拆分导入、数据管理工具 | 阅读点关联笔记等更多能力 |
未激活时,高级入口会明确提示;基础阅读流程不受影响。
若已安装并激活 Weave 主插件,本插件可继承其授权,无需重复激活。独立激活入口:设置 → Weave Incremental Reading → 授权。
数据与隐私
- 阅读点、专题、调度与设置默认保存在本地知识库
- 插件不会主动上传你的笔记内容
- 跨插件协作(如 EPUB 回跳、授权校验)仅在对应功能被实际使用时发生
- 卸载插件不会自动删除已创建的
.irdeck与阅读点数据;清理请用数据管理工具或手动删除
作者
Rabbit (zhuzhige) — GitHub
- 邮箱:[email protected]
- 问题与建议:Issues
- 许可证:GPL-3.0-or-later
让阅读队列真正动起来,而不是躺在收藏夹里。
English (summary)
Full English documentation: README.en.md
Weave Incremental Reading turns scattered “read later” material into a durable reading-point queue, organized by topics (.irdeck) and advanced through a calendar—with source resume for Markdown, PDF++, Canvas, web pages, and EPUB.
It is a standalone plugin in the Weave family: use it alone for incremental reading; add Weave EPUB Reader and/or the Weave main plugin when you need in-vault EPUB reading or spaced-repetition cards.