夜雨聆风学习资料网

ARTICLE · 1102464

把一本 PDF 变成能追问的学习网页:这个开源 Skill,让 AI 学习有据可查

把一本 PDF 变成能追问的学习网页:这个开源 Skill,让 AI 学习有据可查

把一本厚书丢给 AI,它给你吐一份总结——你是不是也这么用过?看起来很爽,但一追问细节就露馅:这句结论是原文哪一页说的?它答不上来。今天这个开源 Skill,就是来治这个病的。

先还原一个几乎人人都踩过的坑:

你要啃一份几百页的 PDF——可能是行业报告、可能是教材、也可能是一篇超长的技术白皮书。

偷个懒,把它丢给 AI:"帮我总结一下。"

几秒钟,一份条理清晰的摘要就出来了。看着真香。

然后你顺着摘要往下问:

•

"第三章那个结论的推导过程是怎样的?"

•

"这个数据在原文哪一页?"

•

"这里说的例外情况,原文有提吗?"

AI 开始含糊其辞,甚至一本正经地编。

因为它给你的是"二手转述",中间那一步——回到原文——断了。

一句话:AI 总结最大的问题从来不是"不准",而是"无法核验"。

01learn-from-materials:一个专治"看了等于没看"的学习 Skill

learn-from-materials 是一个基于开放 Agent Skills 规范的学习助手。

它干的事,可以说得很直白:

把书籍、PDF、PPT、Word、网页,甚至一堆散装材料,转化成"可追溯的知识库 + 能交互的学习网页 + 同步的 Markdown"。

注意关键词——可追溯。

它不是帮你"总结一下",而是帮你把一份材料真正读完、拆透、并且每一步都能回到原文。

它强调几件事,条条都戳在 AI 学习的痛点上:

•

完整阅读:不跳读、不臆测,先把材料走完

•

出处可核验:每条结论都指得回原文位置

•

材料事实与模型补充分离:哪些是书上写的、哪些是 AI 加的,分得清清楚楚

•

离线优先、最小权限:默认不联网,你的东西留在你自己电脑上

GitHub 仓库:github.com/dmoshehun-prog/learn-from-materials

02它能吃下什么

几乎覆盖了你手上所有"想学但啃不动"的材料:

类型格式
电子书PDF、EPUB、MOBI / AZW / AZW3
办公文档DOCX、PPTX / PPTM
网页与文本HTML、Markdown、TXT、RTF
合集多份材料一起丢进来也行

一份能啃,一摞也能啃。

效果展示

以下依次展示人物传记、金融市场展望报告和学术论文三种材料生成的学习页。每组选取同一套六板块学习页中的不同部分,并非展示每个示例的全部页面。

1. 人物传记:《埃隆·马斯克传》

首次使用引导介绍学习模块和仅保存在浏览器本地的可选画像。生成的页面从整本书的一句话总论,延伸到核心框架卡片及其关系图。

首次使用引导

系统学习页封面

核心框架卡片

框架关系图(局部)

2. 金融市场展望报告:J.P. Morgan《2026 年中展望》

这一示例展示同一流程如何把金融市场展望 PDF 整理为系统学习页。内容导学保留 PDF 页段,并分别呈现单元的核心思想、关键框架和行动要点。

系统学习页封面

带 PDF 页段的内容导学

3. 学术论文:《Attention Is All You Need》

论文示例展示如何把研究论证整理成学习页,并通过方法论关系图呈现有任务边界的推理结构。下图仅是图谱的局部视图。

系统学习页封面

方法论关系图(局部)

这些截图展示页面组织方式,不构成对每项论断、出处或生成结论的独立核验。原材料及截图涉及的内容版权归各自权利人所有;本仓库不包含对应原始材料或完整生成结果。请只处理并展示你有权使用的材料。如需无需原材料的合成演示,可打开整体方法论示例或中文版功能示例。

03两种学习深度,先问你一句"要多深"

这是它比普通总结工具聪明的地方。

开始之前,它会先让你选学习深度:

•

快速了解:先把骨架和主线抓出来,适合"先看看值不值得深读"

•

系统学习:逐章逐节拆解,适合"这门东西我真的要学进去"

同一份材料,你想走个过场还是打穿它,由你定。

04产出三样东西

跑完之后,你会拿到:

产物是什么
.learnkb/ 知识库可追溯的结构化知识底座,藏着所有来源映射
交互式学习网页一个自包含的单文件 HTML,双击就能开
同步 Markdown干净、可以直接进你笔记库的文本

其中那个单文件 HTML,是最直观的惊喜——不用搭环境、不用起服务,一个文件就是一套完整的学习站点。

05学习网页里,固定有六个模块

页面结构是定死的,一共六块:

模块干什么
01 核心框架先把整份材料的骨架立起来
02 内容导学带你走一遍,标注章节与页码范围
03 术语大全把材料里的关键概念集中收口
04 行动规则把"该怎么做"提炼成可执行条目
05 学习自检动态生成自测题,答错会导回原文重测
06 我的笔记边读边记,笔记就存在页面里

注意每个模块的顺序——它按术语在原文中首次出现的顺序排列,而不是随便堆。

它是照着你这份材料的真实结构生成的,不是套模板。

06真正的杀招:可追溯

这是它和所有"AI 总结工具"拉开差距的地方。

它给 PDF 页码、PPT 幻灯片、EPUB 章节都建立了细粒度的来源映射。

也就是说:网页里任何一个结论,你都能一路点回它到底出自原文的哪一页、哪一张、哪一章。

更进一步,它会把内容明确分成四类:

类别含义
材料依据原文白纸黑字写着的
材料未覆盖材料里根本没讲的(如实告诉你"没有")
模型补充AI 自己补的背景知识,明确标注
外部核验引用了外部资料来交叉印证的

这份"诚实",才是它最值钱的地方。

普通 AI 总结,会把它自己脑补的东西,和原文混在一起喂给你,你还分不出来。

而它把"书上说的"和"它自己想的"物理隔开——你看到的每一条,都知道该信几分。

07它甚至会给自己的总结"查漏"

一份材料动辄几百页,AI 真的读完了吗?还是漏了一大块?

learn-from-materials 内置了一套质量控制机制:

•

覆盖审计:检查材料有没有被完整覆盖

•

总结双向映射:总结 ↔ 原文,两边对得上

•

反向覆盖抽查:从原文反查,看有没有被漏掉的段落

•

来源哈希 + 增量更新校验:材料改了,能识别出哪些需要重跑

说人话就是:它不只生成,还自己检查自己有没有偷懒。

08装到哪?四个主流 Agent 环境都能用

它遵循开放的 Agent Skills 规范,只要环境能读文件、跑本地命令、认得 SKILL.md,就能接:

环境技能目录
Claude Code~/.claude/skills/
Codex~/.agents/skills/
WorkBuddy~/.workbuddy/skills/
GitHub Copilot CLI~/.copilot/skills/ 或 ~/.agents/skills/

安装就是一条 git clone,以 Claude Code 为例:

●●●CODE

git clone https://github.com/dmoshehun-prog/learn-from-materials.git ~/.claude/skills/learn-from-materials

装好之后,用法更是简单到一句话:

"请用 learn-from-materials 系统学习这本 PDF,并生成可追溯知识库和学习网页。"

剩下的交给它。

09几个要说清楚的边界

第一,它是个新项目。

Star 数还不高(不同平台统计在两三百量级),社区和打磨程度远没法和成熟项目比。尝鲜可以,别急着当成生产力刚需。

第二,依赖环境和工具链。

需要 Python 3.10+;想要浏览器交互验证的话,还得有 Node.js、Playwright、Chromium;如果材料是扫描版 PDF 或图片密集的幻灯片,那还得有 OCR 或视觉能力,否则它"看不见"内容。

第三,纯聊天环境玩法有限。

如果你的 AI 只能聊天、碰不到文件系统也跑不了 Python,那只能用上一部分提示流程,材料提取、覆盖校验、网页渲染这些核心能力都用不了。

第四,隐私设计是加分项。

默认离线、不联网、不自动装依赖,你的笔记、学习画像、错题记录只存在本地浏览器里。

第五,血缘要交代清楚。

它基于 virgiliojr94 的 book-to-skill 项目二次创作而来(MIT 协议),分发时要保留 LICENSE.md 和 NOTICE.md。

10写在最后

用 AI 学习这件事,我们其实一直卡在同一个地方:

我们得到了"结论",却失去了"来路"。

一份漂亮的摘要,看起来省了时间,实际上把你和原文之间最关键的连接——可核验——给切断了。学得越快,忘得越快,也越不敢用。

learn-from-materials 的价值,不在于它总结得多好。

而在于它逼着 AI 做一件反直觉的事:慢下来,把每句话都钉回原文。

能追问、能溯源、能自检——这才叫"把材料学会了",而不是"把材料过了一遍"。

下次再想把一本厚书丢给 AI 之前,先问一句:

它给我的东西,我能核对吗?

GitHub 仓库:github.com/dmoshehun-prog/learn-from-materials

觉得有用的话,点个赞 or 分享给身边还在"AI 总结一看就会、一考就废"的朋友。

相关学习资料