Qiaomu Read Helper

Qiaomu Read Helper

把一本书变成可持续的“章节共读”流程。

何时使用

当用户想要：

• 从一本书的某一章开始共读，创建飞书文档让用户批注
• 读取飞书文档里的评论、加粗、划线或重点标记
• 在飞书评论里给用户短点评、解答、启发
• 基于用户的批注和重点，写一篇站在用户视角的乔木风格读书笔记
• 继续下一章，并沿用同一套工作流

工作流

1. 准备章节

   • 确认书籍来源：本地 EPUB/PDF、已下载文件、或先调用 qiaomu-ebook-downloader 下载。
   • 优先从 EPUB 目录、章节标题、正文标题定位章节边界；PDF 转 EPUB 的 index_split_003.html 不等于自然章节，必须校验真实章节标题。
   • 轻度清理正文：去掉页眉页码、合并断行、保留作者原文，不改写正文。

2. 创建飞书文档

   • 使用 lark-doc / lark-cli docs +create --api-version v2 创建章节文档。
   • 默认每章一个文档；如果用户要长期读一本书，优先为整本书创建或复用一个飞书文件夹，再把章节文档放入该文件夹。
   • 文档开头放简短“共读批注区”，提醒用户可以加粗、划线、评论。

3. 读取用户批注

   • 使用 lark-drive 读取未解决评论，默认 is_solved:false。
   • 使用 docs +fetch --api-version v2 --doc-format xml --detail full 读取正文样式，抽取 <b> 加粗块；若 CLI 未暴露 underline 样式，说明并让用户用评论补充定位。
   • 每条评论必须结合 quote 或所在 block 的前后文理解，不要只按评论短句猜。

4. 回复评论与重点

   • 对用户显式评论：优先回复原评论线程。
   • 对用户加粗/划线：在对应 block 新增本地评论。
   • 回复目标是“更多启发和解答”，不是长篇讲章。每条回复控制在 1-4 句，抓住上下文、方法论、可迁移的洞见。

5. 写整体读书笔记

   • 汇总用户评论、加粗重点、AI 回复和章节主线。
   • 站在用户视角写，像“我读这一章时意识到……”而不是客观书摘。
   • 使用乔木写作风格：清晰、有结构、有洞见、有个人反应，但不装腔。
   • 如本地可用，调用或参考 qiaomu-writer；否则遵循本 skill 的读书笔记结构。

执行细节

详细流程见：

• references/lark-cli-setup.md
• references/workflow.md
• references/feishu-comments.md
• references/reading-note.md

边界

• 不替用户生成大段原书内容用于公开传播；章节文档默认面向用户个人阅读批注。
• 不在未读取评论 quote / block 上下文的情况下直接回复。
• 不自动把评论标记为已解决，除非用户明确要求。
• 不把 PDF 转换分片误当作自然章节。
• 不擅自开启高风险飞书权限、删除文档、转移 owner 或公开分享。