# Qiaomu Read Helper > 乔木共读助手：把本地电子书或已下载图书按章节整理成飞书文档，支持用户阅读后加粗、划线、评论，再读取飞书评论与重点标记进行短点评回复，并基于用户标记写出一篇乔木风格读书笔记。触发词包括：带我读一本书、共读、读书助手、把这一章发到飞书、读取我的批注、回复飞书评论、根据加粗和评论写读书笔记、下一章。 - Skill: `joeseesun/qiaomu-read-helper` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add joeseesun/qiaomu-read-helper` - Raw SKILL.md: https://api.skillmd.com/api/skills/joeseesun/qiaomu-read-helper/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: joeseesun (https://skillmd.com/u/joeseesun) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/joeseesun/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` 读取正文样式，抽取 `` 加粗块；若 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 或公开分享。