

读书最怕读成“过客”
翻开书,读了几章,觉得自己懂了,合上书,书还是书,你还是你。书里的观点没进到你的逻辑里,作者的论证没变成你的工具,你只是像路过了一场风景,没带走什么。
现在的阅读环境,太容易让人当“过客”。
罗振宇告诉你结论,樊登告诉你金句,各种解读短视频帮你把书嚼烂了喂给你。这其实是把读书的“思考权”交出去了。
你以为在读书,其实是在听别人的观点,用别人的逻辑,洗着自己的脑。
真正的阅读,得有参与感。
你得和作者在书页里碰面。作者丢出一个观点,你得在心里把它接住,或者把它撞开。你得在书的空白处写写画画,得在某个概念卡住的时候停下来琢磨,得把书里的逻辑拆开,看看它到底是怎么运转的。
这太难了,尤其是面对大部头的长书时。
所以我 vicoding写了一个 AI伴读应用:ReadPilot。
我不想做一个帮你“速读”的工具,我只想做一个能跟你交流的,帮你沉淀知识的助理。
这也是我第一个开源的项目。

ReadPilot 是怎么帮你的?
ReadPilot 的逻辑很简单:读书不是要把书“读完”,而是要把书里的知识变成属于你的东西。
它不是那种丢给你几百字摘要的工具,它是一个本地运行的工作台。你可以直接跟这本书对话聊天,生成可视化网页,管理读书笔记。


第一,解决“记不住”和“想不通”
大多数人看书记不住,是因为你在被动地看文字。
在 ReadPilot 里,右侧的 Chat 面板是用来针对细节提问的。当你读到某个论点觉得不对劲,或者觉得作者说得云里雾里时,你可以随时停下来,就这个点问个究竟。
你可以这么问:“作者这个推导逻辑,是不是忽略了某个前提?”或者“这里提到的概念,能不能用我生活里的一个具体例子来解释?”
Ai 会基于原书的内容和你展开探讨。
你是在和书聊天,和作者辩论,而不是在被动接受信息。





第二,把读书笔记做成 HTML
读书最痛苦的不是读不懂,而是理不清。
当你觉得这一章的逻辑理顺了,或者想把某个复杂模型留下来反复推敲时,ReadPilot 支持“生成伴读页”。你发个指令,它会把原文、你的阅读进度、刚才的讨论,整合成一个独立、可交互的 HTML 页面。
这个网页会存在你的电脑里,你还能直接在 ReadPilot 里查看。
它不只是笔记,它是你的推演过程:
它能把作者的论证拆解成流程图,让你看清它是怎么从 A 推到 C 的。 它能把抽象概念变成测试题,让你在应用中发现自己哪里理解错了。 它能把书里的逻辑和你的真实生活场景对照起来,让你一眼看清这书到底怎么用。




第三,把知识组合成你自己的系统
当你读完一整本书,ReadPilot 留给你的,不是一份别人写好的总结,而是一份你自己搭建起来的知识库。
每一章都有你针对性提问的记录,每个核心概念都有你推演、测试、修正过的过程。
这就是我理解的阅读:你不仅是看过了这本书,你是把这本书彻底拆开,又按照你自己的理解,重新搭建了一遍。








为什么要把书“留在身边”?
现在的阅读工具,比如微信读书,不管你读了什么、划了什么线、记了什么笔记,数据都存进人家的数据库里。虽然可以同步数据到 notion 或者 Obsidian 仓库里,可是整理起来比较麻烦。
ReadPilot 能帮你盘活那些沉淀下来的数据,变成真正属于你自己的“记忆”“知识”“经验”和“洞见”。
你的划线,才是真正的“读者记忆”
如果你有微信读书的习惯,ReadPilot 可以直接绑定它。
以前你读完一本书,划线、想法都在微信读书的 App 里。在 ReadPilot 里,你只需填入微信读书的 Key,书里的划线、想法、进度就会自动同步到本地 SQLite 数据库。

意味着当你读到某一章时,ReadPilot 会自动把这些“你的痕迹”注入给 AI。你问 AI 问题时,它不再是凭空回答,而是基于你读过这些书时的真实感触。

读书笔记界面,能直接看到相应章节的划线和笔记,你也可以继续添加

怎么把 ReadPilot 装到你的电脑里?
ReadPilot 是一个本地运行的应用,它依赖你电脑上的环境来运行 AI 逻辑。
1. 准备环境
你需要提前安装好以下工具:
Node.js(版本 20 或以上):用于运行界面。 Python(版本 3.10 或以上):用于解析 EPUB 格式的书籍文件。 Claude Code:你需要从 Anthropic 官网安装该命令行工具,并确保终端输入 claude --version有响应。
2. 安装与启动
在终端中执行以下命令(不懂啥是终端的朋友可以问问豆包,叫她教教你哈,不难的):
# 克隆代码git clone https://github.com/ChampionGPT/readpilotcd readpilot# 安装依赖npm installpip install ebooklib beautifulsoup4# 配置环境变量cp .env.example .env.local# 启动程序npm run dev
3. 使用方法
导入书籍:将 EPUB 文件拖入书库。 阅读与提问:点击书籍卡片进入阅读页。正文在中间,右侧是对话框。 生成伴读页:在右侧对话框输入“生成一个伴读页”。系统会在 data/books/<书名>/pages/下生成 HTML 文件。继续读书,等 claude code 生成好以后,你就能在中间的书籍目录里面看到刚刚生成好的伴读页面了。同步微信读书(可选):在设置页填入 API Key 后,系统可自动同步你的高亮和笔记。


给新手的补充说明
为什么要安装 Node.js 和 Python? ReadPilot 需要这些程序来读取你的文件和运行 AI 逻辑。 Claude Code 是什么? 它是 ReadPilot 调用 AI 的核心。你需要拥有 Anthropic 的 Claude Code CLI 并完成 Claude Code 配置。 怎么安装? 如果你电脑上有 Ai 编程工具,比如国内的 Trae,国外的 Cursor,Antigravity,codex,claude,openclaw 之类的,直接跟 AI 说:*帮我安装这个应用 https://github.com/ChampionGPT/readpilot 数据存储在哪里? 所有书籍文件、伴读页面、笔记和 SQLite 数据库都存放在你电脑的 data文件夹下。要搭配什么 skill? 仓库里已经帮你设计好了一个生成伴读页的 skill,直接让 claude code 安装就行,
skill 地址:https://github.com/ChampionGPT/readpilot/blob/main/skills/reading-companion-zh/SKILL.md
伴读页生成参考脚本:https://github.com/ChampionGPT/readpilot/tree/main/docs/references


版权声明:ReadPilot 是阅读辅助工具。生成的伴读页面仅供个人学习,请不要在公开网络发布包含版权书籍原文的页面。
项目地址:https://github.com/ChampionGPT/readpilot
如有安装或运行问题,请参考仓库内的 docs/SETUP.md 文档。
如果对你有启发,有帮助
请不吝打赏,关注,点赞,收藏,转发,在看!
长按二维码关注:思考边缘

欢迎加我微信交流:

夜雨聆风