读完一本好书之后，真正困难的通常不是“有没有摘要”，而是：
- 想回到某个概念时，只记得大概位置，找不到上下文。
- 问 AI 一本书的问题时，回答容易脱离原文或变成泛泛而谈。
- 读书笔记越写越长，最后变成一个很少再打开的文档。
- 一章里真正值得反复咀嚼的结构、问题和例子，没有沉淀成可复访的页面。
ReadPilot 的思路是：让书、笔记、对话和生成页面都围绕同一个本地阅读工作区展开。你读到哪里，AI 就围绕哪里帮你解释、追问、整理和生成。
ReadPilot 不是一次性把整本书做成课程，而是在阅读过程中按需生成材料：
- 章节伴读页：把当前章节拆成概念、论证链、关键问题和复习提示。
- 主题深挖页：围绕某个概念生成可复访的解释页面。
- 对比页：把两个概念、人物、模型或章节并排分析。
- 书籍 Hub：汇总进度、已生成页面、主题索引和下一步建议。
- Markdown 笔记：编辑和预览分开，适合记录理解、摘录、疑问和复习线索。
普通解释、摘要、检验题和追问默认停留在 ChatPanel。只有当你明确要求“生成页面”时，ReadPilot 才进入伴读页工作流。
- 导入一本 EPUB。
- 在单本书 Hub 查看章节、进度和已生成内容。
- 进入阅读页，按章节阅读。
- 在右侧 ChatPanel 直接提问、整理、追问。
- 用 Markdown 写笔记，并在需要时切换预览。
- 对值得保留的主题生成伴读页，之后可在 Hub 中反复打开。
ReadPilot 当前支持 Claude Code，并已经加入 Codex provider adapter。ChatPanel 负责会话初始化、流式输出、工具调用展示、TODO/计划状态、错误恢复和宽度调整。
项目提供 .codex/config.toml，方便已配置 Codex 的用户在受信任项目中加载 ReadPilot 的本地上下文能力。普通用户不需要手动理解内部适配细节，只需要在应用中选择可用 provider。
微信读书集成是可选能力。配置后，ReadPilot 可以绑定对应书目，同步划线、想法和阅读进度，并把这些读者侧记忆用于后续伴读对话。
环境要求：
- Node.js 20+
- npm
- Python 3.10+
- Claude Code CLI 或已配置好的 Codex CLI
安装依赖：
npm install
pip install ebooklib beautifulsoup4创建本地配置：
cp .env.example .env.local启动应用：
npm run dev打开：
http://localhost:3000
ReadPilot/
src/ # Next.js 应用、API、UI、状态和本地逻辑
scripts/ # EPUB 转换器和辅助脚本
skills/ # 伴读 skill 入口
docs/ # 安装、使用、结构说明和伴读页参考资料
data/ # 本地运行数据目录
伴读页生成规范位于 docs/references。可加载的 skill 入口位于 skills。
npm run dev
npm run build
npm run start
npm run lint
npm run testReadPilot 使用 MIT License 发布。