| name | read-weread-export |
| description | 导出微信读书划线笔记为 Markdown 或 PDF 文件。当用户说"导出我的微信读书划线"、"导出读书笔记"、"把划线保存下来"、"weread 导出"时触发。依赖 weread-skills 调用接口，按书籍-章节分组排版，附划线时间，输出美观的笔记文档。 |
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 映射；未匹配章节归到"## 未分类"
- 文件名安全：书名中的
/、: 等字符替换为 -
