Skip to content

Repository files navigation

Progressive Learning

Finally finish what you read — and what you write: progressive reading digests your input, progressive writing turns it into finished drafts — a complete loop from reading to writing.

Highlights

  • ✍ Progressive writing — your material, queued to be written: send selected blocks from any document straight into a writing book, let the roller serve you one piece a day, finalize as you go, then compile the draft; a four-color structure tree shows at a glance how far the book has come. What you read becomes the raw material of what you write
  • 📖 Two progressive modes — excerpt-based (pick the essence) and piece-based (slice the whole doc), so long reads get digested day by day
  • ✂️ Text-splitting toolkit — sentence splitting, Enter-to-split, block merging, double-tap multi-select on mobile
  • 🎴 Card-making pipeline — multi-line cloze, multi-line cards, word flashcards and Daily Card — make cards where you read
  • 🗺 AI-drawn knowledge maps — let AI read the book and draw the relationship graph: people, concepts, events, evidence-anchored and jump-to-source; pan it, save your own views, export as image

Features

✍ Progressive Writing

  • Writing books — create one with a name and an outline; each outline line becomes a slot, so you frame the skeleton before you write
  • Three ways to feed slots — send selected blocks from any doc, pull from the excerpt pool, or push from the floating bar; material carries a source badge that jumps back to the original text
  • One roller, two phases — reading books and writing books share the same scheduler: reading is content written by others queued to read; writing is your own material queued to write. Each phase gets its own status-bar flame (reading / teal writing), so writing never eats into your reading quota
  • Piece management — split into new pieces, move material across pieces, finalize when done (reversible)
  • Structure tree at a glance — writing books open the knowledge map too: green = finalized, theme color = has material, orange = gap, grey = container; nodes carry material and sub-chapter counts, click to jump straight to a slot, export as image
  • Let AI structure it (MCP) — AI inventories where material sits and where the gaps are, proposes a skeleton and previews every step before touching anything; it can also break a model essay down into a reusable skeleton
  • Recite link-up — send a whole book or a single piece into Recite Practice: type on the original to annotate, extract into exercises, close the original, write from memory and compare word by word
  • Compile to draft (Pro) — turn finalized pieces into a standalone document in one click, from material to finished work; the everyday writing flow is free

📖 Progressive Reading

  • Excerpt-based progressive learning — select to excerpt; the essence goes into a day-by-day queue
  • Piece-based progressive learning — the whole document is auto-sliced; read one piece a day
  • Books from doc folders — turn a folder of articles into one book: reading order follows the file tree, pieces attach to their source article, reorder any time and progress self-corrects
  • Volume splitting for giant docs — a 3-million-word tome? Split it into volume sub-docs first (right-click in the doc tree), then add as a folder book — daily portions stay fine-grained either way

✂️ Reading & Editing Helpers

  • Sentence splitting (Pro) — split long paragraphs into blocks automatically
  • Split block by pressing Enter — Enter splits, staying out of your way
  • Merge blocks — combine multiple blocks into one
  • Multi-line selection via double-tap on mobile — select paragraphs fast on phones
  • Word highlighting with explanations — select a word, see the meaning instantly

🎴 Cards & Review

  • Word flashcards — turn new words into cards in one click
  • Multi-line cloze deletion — cloze over multiple lines
  • Multi-line card creation — batch-create Q&A cards
  • Daily Card — one card a day, steady accumulation
  • Display pinyin — annotate Chinese characters with pinyin
  • Visit frequency — revisits too dense or too sparse? Three gears stretch or tighten the revisit curve (3→6→12→24→48 days by default) without resetting progress
  • Notes to your future self — leave a note on anything you revisit; newest on top, and the latest note rides along with each review reminder
  • 7-day calendar strip — the review plan panel shows the coming week: due counts, estimated minutes, overload colors; click a day to filter
  • Zero-output auto-relax — a book with no excerpts and no cards for 30 days gets its revisit interval gently stretched, with a badge and one-click restore — transparent, never silent

Free vs Pro

One rule of thumb: the whole reading & writing loop is free — unlimited books, pieces, excerpts and views. Pro adds the automation layer: letting the machine do the repetitive splitting, extracting and converting, plus decorating your workspace.

Domain Free Pro adds
📚 Reading Add books, daily piece rolling, fleet & dual-flame progress (reading & writing tracked separately), floating bar, excerpts, all views, physical volume split for huge books Auto sentence splitting — books & excerpts sliced by sentence, no manual splitting
✍️ Writing Writing books, three ways to feed slots, piece management, moving pieces across books Compile finalized pieces into a standalone draft, material to work in one step; extract notes (all / current piece / append to bottom) — gather them as you finish; one-click note-color strip & restore
🎴 Cards Word flashcards, cloze deletion, multi-line card creation, Daily Card, turning excerpts into review cards AI word lookup — saving words is free; AI translation & example sentences are Pro
📥 Collection — Collect selected content to a file (Shift+Alt+O), merging as you go
🎨 Appearance Native look — clean and distraction-free Skin sets — a whole new look in one click

Pro is ¥72, one-time — and it gifts Recite Practice Pro (¥10, yours for free): activate once, own both. Purchase & activation: plugin settings → order → paste the redemption code back in settings — it binds to your SiYuan account automatically.

Getting Started

  1. Open a long document, select the text you want to read, and click "Excerpt" on the floating bar — or run the command "Add current document to piece-based progressive reading" to slice the whole doc
  2. Run "Start today's reading" from the command palette, read today's portion, and page through
  3. To remember the good parts: select and cloze/make cards — review happens in SiYuan's built-in flashcard system
  4. Got something to write? Create a "new writing book" from the fleet panel to set up slots, send great material you come across straight into them, let the roller serve one piece a day, finalize as you go, then "compile to draft" in one click

Docs & Community

  • 📖 Documentation (Chinese, with GIFs & videos for every feature)
  • 🎬 Hands-on Tutorial (Chinese, zero jargon — follow along to finish the "read → recall → review" loop in ~10 minutes, with GIFs & full videos for every step)
  • 🤖 Connect AI to SiYuan (MCP) (Chinese) — let AI check your reading queue, reschedule reviews and sort out your writing books' structure; three-step setup for ZCode / Trae / CodeBuddy / Qoder
  • 🙏 Acknowledgments
  • 💬 QQ Group (Chinese) — feedback and feature requests
  • 💬 Feishu Group (Chinese) — feedback and feature requests
  • 📱 Scan to join: Group QR codes (left: QQ Channel, right: Feishu)
  • 📦 Source repository — what you see is what's compiled: release packages are built remotely by GitHub Actions from source

📊 SiYuan Marketplace: 32,000+ downloads

License

All released versions up to v3.19.0 remain under the MIT License. Starting with the next release, this plugin ships under a proprietary license (see LICENSE):

  • Personal use stays free — nothing changes for individual users
  • Redistribution, re-packaging and distributing modified copies are not allowed
  • Removing or bypassing the activation check is not allowed
  • Commercial use (charging users, paid services, use inside a company) needs written permission — reach out via the Feishu group or GitHub issues

Support the Author

WeChat

Alipay

About

思源笔记渐进学习插件(开源):摘抄式/分片式渐进学习、断句拆分、划词解释、单词闪卡、多行挖空制卡、Daily Card、拼音标注——渐进阅读理念在思源中的实践。

Topics

Resources

Stars

29 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages