Architecture

架构说明

项目结构

weread-notes-export/
├── SKILL.md                          # 技能定义
├── README.md                         # 使用说明
├── scripts/
│   ├── export_weread_notes.py        # 🎯 核心导出引擎
│   ├── daily_sync_weread.py          # 每日增量同步
│   └── format_notes.py               # 批量格式整理
├── templates/
│   └── weread.env.template           # 环境变量模板
└── LICENSE                           # MIT 协议

核心流程

[微信读书 API]
     │
     ├─ /user/notebooks     → 有笔记的书列表
     ├─ /book/bookmarklist  → 划线（书签）
     ├─ /review/list/mine   → 评论/想法
     └─ /book/chapterinfo   → 章节树
     │
     ▼
[export_weread_notes.py]
     │
     ├─ 按 chapterUid 归类 → 划入对应章节
     ├─ 评论匹配           → 查找关联划线
     ├─ 同章排序           → 按 range 排序
     └─ Markdown 输出       → 带分隔线的文件

数据流

1. 列出有笔记的书 → 2. 逐本拉取划线/评论 → 3. 获取章节结构 → 4. 归类排序 → 5. 写入 Markdown

增量同步

daily_sync_weread.py 筛选最近 48 小时有更新的书导出，与本地文件对比避免重复处理。

零依赖

纯 Python 3 标准库（urllib + json），无需 pip install 任何包。