spacezephyr weread-export — 微信读书划线笔记导出
触发条件
用户说：
- 导出我的所有微信读书划线笔记
- 导出读书笔记
- 把我的划线保存成文件
- 备份微信读书笔记
- export weread notes
前置依赖
- 已安装
weread-skills（同目录下） - 环境变量
WEREAD_API_KEY已配置
工作流
步骤 1：询问格式、范围、保存位置（每次必问，不可省略）
无论触发语中是否提到这些信息，每次执行都必须先把三个问题问完再动手。 即使用户说"导出全部为 PDF"，也要复述确认一遍。
一次问完三个问题：
请确认导出参数：
1. 输出格式？
a. Markdown（.md）
b. PDF（.pdf）
c. 两个都要
2. 导出范围？
a. 全部书籍
b. 指定书籍（请告诉我书名或 bookId）
3. 保存到哪个目录？
- 直接回车 = 当前工作目录
- 或者输入一个绝对路径 / 相对路径（如 ~/Documents/微信读书）
收到用户答复后再进入步骤 2。如果答复不清晰（例如只回了格式没回范围），追问缺失的那一项，不要默认。
保存路径处理：
- 用户给的是绝对路径：原样使用
- 用户给的是相对路径：相对当前工作目录展开
- 用户直接回车：使用当前工作目录
- 路径不存在：自动
mkdir -p创建，不再追问
步骤 2：拉取笔记本概览
调 /user/notebooks 分页拉取所有有笔记的书：
{"api_name":"/user/notebooks","count":50,"skill_version":"1.0.3"}
hasMore=1 时，用最后一项的 sort 作为 lastSort 继续拉。参数必须平铺在 body 顶层，不要包在 params 里。
汇总：
totalBookCount：书籍数- 累加各书
noteCount + reviewCount作为总笔记数
步骤 2.5：指定书籍不在书架上的处理
如果用户在步骤 1 选了"指定书籍"，但该书 不在 /user/notebooks 的返回结果中（说明用户没有个人划线/笔记），必须先问用户：
你的书架上没有《xxx》的个人笔记。
要改为导出这本书的【热门划线】（其他读者的高频划线）吗？
a. 是，导出热门划线
b. 否，取消导出
如果用户选 a：
- 调
/store/search拿到 bookId（如果用户给的是书名） - 调
/book/chapterinfo拿章节列表 - 调
/book/bestbookmarks（bookId, chapterUid=0）拿全书 Top 20 热门划线 - 在 Markdown 顶部标注 "热门划线导出（非个人笔记）"，每条划线下方显示划线人数（
totalCount字段，格式🔥 N 人划线），不显示时间
步骤 3：逐本拉划线和想法
对每本书并行调两个接口：
{"api_name":"/book/bookmarklist","bookId":"<bookId>","skill_version":"1.0.3"}
{"api_name":"/review/list/mine","bookid":"<bookId>","count":100,"skill_version":"1.0.3"}
注意：/review/list/mine 的字段名是 bookid（全小写），不是 bookId。
步骤 4：组装 Markdown
按下方模板生成。文件保存到步骤 1 用户指定的目录，文件名固定为 微信读书划线-YYYY-MM-DD.md。
Markdown 模板
# 微信读书划线笔记
> **导出时间**：YYYY-MM-DD HH:MM
> **共 N 本书 · X 条划线 · Y 条想法**
---
## 目录
1. [书名 A](#1-书名-a) · 12 划线
2. [书名 B](#2-书名-b) · 5 划线 / 2 想法
---
## 1. 书名 A
**作者**：xxx
**最近笔记**：YYYY-MM-DD
**统计**：12 划线 / 0 想法 / 进度 45%
### 第三章 章节名
> 划线原文……
📅 2025-09-21
> 第二条划线……
📅 2025-09-22
💭 我对这条的想法（如果有 review 关联到这条划线）
---
## 2. 书名 B
……
排版要点：
- 书名用
##，章节用### - 划线正文用
>引用块 - 时间格式
YYYY-MM-DD（不带时分秒） - 想法在划线下方用
💭前缀 - 整本书评（reviews 中
chapterName为空）单独放在该书末尾"## 整本书评"小节 - 每本书之间用
---分隔 - 顶部"共 N 本书 · X 条划线 · Y 条想法"用粗体
排序规则（强制）：
- 章节顺序：严格按
chapters[].chapterIdx升序排列；从/book/bookmarklist或/book/bestbookmarks回包的chapters数组拿到章节顺序，不要按笔记创建时间排 - 章节内划线顺序：按
range起始位置（range字段-前的数字，转为 int）升序，保证划线在文中出现的先后顺序 - 跨章节的想法/书评：
chapterName为空的整本书评单独放在该书末尾 - 未匹配章节：从
chapters中找不到对应chapterUid的划线归到该书末尾"### 未分类"小节 - 排序在生成 Markdown 前完成，禁止在输出阶段乱序
步骤 5：如需 PDF，转换
如果用户要 PDF，对生成的 MD 执行：
python3 ~/.claude/skills/read-weread-export/scripts/md_to_pdf.py <md路径> <pdf路径>
脚本依赖 Chrome（macOS 自带或已安装）。失败时回退到 Markdown 并提示用户。
步骤 6：报告结果
输出：
- 文件路径（可点击打开）
- 统计：N 本书 / X 划线 / Y 想法
- 如果导出耗时较长，提示进度
注意事项
- 不要重复请求：如果在同一轮对话已经调过
/user/notebooks，直接复用结果 - 大量笔记：超过 30 本书时分批并行调用接口（每批 5 本），避免请求堆积
- 空数据：某本书
bookmarklist为空（只有书签没有划线）时，在导出中标注"（仅书签，无可导出划线）" - 时间戳转换：所有
createTime转为 YYYY-MM-DD 格式（用户时区按本机） - 想法与划线关联：
/review/list/mine返回的 review 如果包含range字段且匹配某条划线的 range，则贴在该划线下方；否则放章节末尾或全书末尾 - 章节标题：从
bookmarklist回包的chapters数组按chapterUid映射；未匹配章节归到"## 未分类" - 文件名安全：书名中的
/、:等字符替换为-