WeRead offers a polished reading catalog, making it the primary reading tool for many serious readers. But after finishing dozens of books and accumulating hundreds of highlights, an inevitable bottleneck emerges: your intellectual traces are trapped inside a closed platform.
WeRead does not provide automated, structured export mechanisms. Compiling research notes requires tedious copy-pasting; engaging in multi-turn dialectic debates on past thoughts is impossible in standard mobile comment fields. If network policies shift or catalog access changes, your notes risk becoming digital relics.
Yomitomo builds upon the official WeRead Skill open protocol to offer a lossless local sync and deep reprocessing pipeline: direct communication with official APIs brings your shelf, highlights, thoughts, and progress straight into a local SQLite database.
WeRead Local Sync Workflow
Section titled “WeRead Local Sync Workflow”| Stage | Input | System Processing | Output | Boundaries |
|---|---|---|---|---|
| API Authorization | Official WeRead Skill API Key | Stored securely in OS Keyring; establishes direct HTTPS connection | Encrypted local credentials for library sync | Does not collect WeChat passwords or personal account tokens |
| Selective Sync | Select books from shelf | Incremental fetching of chapters, highlights, and thoughts | Mirrored library entries in local SQLite database | Syncs user annotations and TOCs; does not download DRM-protected full texts |
| Cognitive Tagging | Synced highlights & thoughts | Map to 5 cognitive categories (A); mention AI companions in threads |
Deep debate threads anchored to original highlights | Requires configured local or cloud LLM credentials |
| Knowledge Distillation | Cross-book highlight clusters | Aggregate into Distillation Studio (T); verify with review agents |
Structured distillation text stored locally | Output stays local; does not write back to WeRead cloud |
Action Guide: 3 Steps to Local Sync and Reprocessing
Section titled “Action Guide: 3 Steps to Local Sync and Reprocessing”Step 1: Obtain Official Skill API Key and Connect Directly
Section titled “Step 1: Obtain Official Skill API Key and Connect Directly”Yomitomo uses no intermediate proxy servers. All requests originate directly from your desktop app:
- Open the WeRead Skill Management Portal (or inside the mobile app: Me > Settings > WeRead Skill).
- Click Quick Configuration, scan the QR code to authenticate, and generate your dedicated API Key.
- In Yomitomo, navigate to Settings > Data Sources > WeRead, paste the key, and click Save and Test Connection.
For illustrated setup and troubleshooting, see the WeRead API Key Documentation.
Step 2: Selective Sync and Cognitive Categorization
Section titled “Step 2: Selective Sync and Cognitive Categorization”In Yomitomo’s dedicated WeRead view, select specific titles to sync:
- Preserve Native Thoughts: Yomitomo pulls both text highlights and your spontaneous thoughts attached to them.
- Assign Cognitive Roles: Select a highlight and press
Ato categorize it into one of five cognitive dimensions (Key Point, Assumption, Concept, Question, Quote). - Multi-Turn AI Dialogue: Mention
@ZhouYanto audit causal logic or@ShenQingyuanto unpack theoretical origins.
Step 3: Cross-Book Synthesis and Manual Copying
Section titled “Step 3: Cross-Book Synthesis and Manual Copying”Break free from single-book silos. Press T to open the Distillation Studio and group highlights across different books sharing common themes (e.g., comparing organizational structures across three management classics). Call review agents like @HeMingheng (Logic Auditor) and @TangJian (Senior Editor) to polish your output into a standalone knowledge card.
To continue in an external note app, select the text in the editing area and copy it manually. There is currently no Markdown file export or automatic sync to external note apps. Source anchors and discussion records do not transfer automatically.
Target Audience & Usage Boundaries
Section titled “Target Audience & Usage Boundaries”Who This Is For
Section titled “Who This Is For”- Dedicated WeRead users with extensive reading notes seeking a permanent, sovereign local archive;
- Researchers and writers synthesizing themes across multiple books;
- Readers wanting to engage in rigorous AI debates anchored to their actual book highlights on desktop.
What This Is Not For
Section titled “What This Is Not For”- Downloading pirated full-text eBooks: Yomitomo adheres strictly to official API protocols, syncing annotations, bookmarks, and metadata without bypassing DRM protection;
- Two-way sync back to WeRead: Local annotations and AI conversations remain strictly in your local database without polluting cloud records;
- Multi-user real-time cloud collaboration: All records reside in local SQLite for personal intellectual synthesis.
Frequently Asked Questions (FAQ)
Section titled “Frequently Asked Questions (FAQ)”Q1: Will using the WeRead API Key get my account flagged or banned?
Section titled “Q1: Will using the WeRead API Key get my account flagged or banned?”Answer: Yomitomo uses the official WeRead Skill API, but cannot guarantee account status, future policies or API availability. Follow the current WeRead rules and respond to authorization or rate-limit errors using the official guidance.
Q2: Where is synced data stored, and how do I migrate to a new machine?
Section titled “Q2: Where is synced data stored, and how do I migrate to a new machine?”Answer: Synced notes are stored locally. Use Settings > Data management for backups. A database-only backup does not include original PDFs or ebooks; choose a full backup when moving those too. Configure your API keys again after restoring.
Q3: If a book is delisted from WeRead, will my synced notes disappear?
Section titled “Q3: If a book is delisted from WeRead, will my synced notes disappear?”Answer: No. Once synced to local SQLite, all highlights, thoughts, AI dialogues, and distillation cards are permanent local assets, entirely independent of cloud library changes.