6大模块、3套主题与"小巴"引导:learn-from-materials学习页首次使用全解读
6大模块、3套主题与"小巴"引导:learn-from-materials学习页首次使用全解读
如果你把一本 PDF、电子书或论文丢给 AI,只得到一堆零散摘要,学习体验往往虎头蛇尾。learn-from-materials 正是为解决这个问题而生:它是一款开源的跨 Agent 学习技能,能将 PDF、EPUB、Word、PPT 等复杂材料转化为可追溯、可测验、可做笔记的交互式学习网页。生成的学习页固定包含六大模块、三套阅读主题,并由向导"小巴"在首次打开时带你熟悉整个页面。本文面向第一次使用的新手,用最短的路径讲清"页面里有什么、每个模块怎么用、主题怎么切"。
1️⃣ 先认识一下"学习页"长什么样
learn-from-materials 的工作方式可以概括为一句话:模型负责提炼内容,渲染器负责结构与交互。
你只需在支持 Agent Skills 的环境(如 WorkBuddy、Codex、Claude Code)里说一句:
请用 learn-from-materials 系统学习这份 PDF,并生成可追溯知识库和学习网页。
技能会先询问你选择"快速了解"还是"系统学习",随后完成提取、覆盖审计、渲染,最终交付一个自包含的离线 HTML 学习页。两种深度生成的页面结构完全相同——都是下面要讲的六大模块(详见 SKILL.md 的"开始前:选择学习深度"一节)。
2️⃣ 首次打开:向导"小巴"会问你什么
每份新生成的学习页在浏览器里第一次打开时,都会弹出"小巴"引导(见上图)。它是这个项目的学习向导,做两件事:
- 带你看懂页面:依次介绍模块目录、主题切换、出处显示、动态自检和本地笔记的位置;
- 建立你的学习画像:询问你的职业和兴趣。之后你追问知识点时,小巴会遵循三级讲解策略——先给严谨解释,你说"没懂"才用画像举例,再不懂才上图片说明(协议见 references/answer-protocol.md)。
💡 画像只保存在当前浏览器本地,且与这份页面独立绑定,不会混入其他材料页面;不想回答可以直接跳过,不影响使用。
3️⃣ 六大模块逐个看
学习页的内容骨架由渲染器固定生成,模块顺序不会变(内容契约见 references/content-contract.md)。
核心框架:把全书方法论变成卡片
页面先给出材料级"一句话总论",再把材料中的命名框架(如书中提出的模型、方法)整理成带稳定编号的框架卡片:每张卡片写清"是什么、适用场景、材料出处"。卡片之间还能一键切换为框架关系图,看清框架之间的依赖与因果,并可追溯每条连线来自材料的哪一页。
内容导学:按章节带读,出处随行
内容导学模块把材料拆成一个个内容单元(对应章节/幻灯片/连续主题组),每个单元给出:讲什么、核心结论、关键框架与行动要点。鼠标悬浮核心观点时会显示来源提示,并附可展开的"出处"面板;若页码映射经过核验,还会显示具体页码。这样你随时知道"这句话是从材料哪来的"。
术语大全:遇到生词不用出页面
术语模块汇总理解材料所必需的名词、英文缩写、角色、流程与指标,支持页内搜索,并为每个术语标注真实出处和首次出现的单元。中英文术语都能给出解释,读英文材料时尤其好用。
行动规则:从"看懂"到"会用"
模块会把材料中"条件—行动—原因"式的关系整理成规则卡片(如:什么情况下该做什么、为什么),整体方法论图固定放在这里。若材料本身不含方法,页面会如实说明,而不是编造。
学习自检:和 AI 出题互考
点击自检口令,可复制一段结构化口令粘贴回你的对话,让 AI 基于当前材料知识库出题测验:支持综合全部、指定章节、自定义要求,还能选择题量、难度和能力重点。AI 会优先从题库 question-bank.json 抽取原题;测验结束输出的错题记录可导入页面,之后一键复测(路由规则见 references/question-bank-routing.md)。
我的笔记:一键收藏,只存本地
阅读时看到值得留存的内容,点"一键保存"就进入"我的笔记";也支持自由新增笔记。所有笔记仅存于浏览器本地存储,可导出 Markdown 备份,没有账号、不上传云端。
4️⃣ 三套主题:按光线切换阅读氛围
学习页内置三套完整主题(定义见 templates/themes/README.md),每套都会同时改变主色、背景、导航与信号色,而不只是换个底色:
| 主题名 | 风格 | 适合场景 | 样式文件 |
|---|---|---|---|
warm-paper 雾蓝书房 |
低饱和暖调、纸感 | 白天长时间精读 | warm-paper.css |
minimal 灰白画册 |
中性灰白、留白多 | 追求极简专注 | minimal.css |
dark 深海夜读 |
深色护眼 | 夜间阅读 | dark.css |
页面右上角可随时切换,选择会记忆在本地。窄屏设备上模块目录会自动变为横向导航,手机上同样可读。
5️⃣ 新手上手清单:从材料到学习页
-
准备环境:Python 3.10+,以及一个能读文件、跑本地命令的 Agent 环境。把仓库放到技能的搜索路径即可,例如 WorkBuddy:
git clone https://gitcode.com/gh_mirrors/le/learn-from-materials.git ~/.workbuddy/skills/learn-from-materials -
检查解析能力(可选,在仓库根目录):
python3 scripts/extract.py --check -
发起对话:说一句"请用 learn-from-materials 系统学习这份材料",按提示选择深度。
-
打开生成的 HTML:跟着小巴走完引导,设置画像,然后按模块阅读。
-
想试试效果? 可直接打开内置演示页 examples/features-zh.html 和 examples/learn-from-materials-demo.md,无需任何材料。
6️⃣ 延伸参考:关键文件在哪
| 想了解什么 | 看这里 |
|---|---|
| 技能入口与完整工作流 | SKILL.md |
| 快速了解模式流程 | references/quick-workflow.md |
| 小巴三级讲解协议 | references/answer-protocol.md |
| 页面交互与模块模板 | templates/base.html |
| 主题作用域规范 | templates/themes/README.md |
| 页面渲染脚本(主题唯一真源) | scripts/render_page.py |
| 效果演示截图集 | assets/showcase/ |
一句话总结:learn-from-materials 的价值不在"生成一个网页",而在于把材料变成一座带目录、带出处、能测验、可记笔记的学习空间——首次打开跟着小巴走一遍,六大模块和三套主题就会成为你固定的阅读动线。



