6大模块、3套主题与"小巴"引导:learn-from-materials学习页首次使用全解读

原创2026-10-16 23:20:301,753 阅读
文章标签:AI 技能AI 应用人工智能知识库知识管理教育文档CLI

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 的"开始前:选择学习深度"一节)。

learn-from-materials 首次打开学习页时的"小巴"新手引导界面,讲解主题、模块、出处、自检与本地笔记

2️⃣ 首次打开:向导"小巴"会问你什么

每份新生成的学习页在浏览器里第一次打开时,都会弹出"小巴"引导(见上图)。它是这个项目的学习向导,做两件事:

  • 带你看懂页面:依次介绍模块目录、主题切换、出处显示、动态自检和本地笔记的位置;
  • 建立你的学习画像:询问你的职业和兴趣。之后你追问知识点时,小巴会遵循三级讲解策略——先给严谨解释,你说"没懂"才用画像举例,再不懂才上图片说明(协议见 references/answer-protocol.md)。

💡 画像只保存在当前浏览器本地,且与这份页面独立绑定,不会混入其他材料页面;不想回答可以直接跳过,不影响使用。

3️⃣ 六大模块逐个看

学习页的内容骨架由渲染器固定生成,模块顺序不会变(内容契约见 references/content-contract.md)。

核心框架:把全书方法论变成卡片

页面先给出材料级"一句话总论",再把材料中的命名框架(如书中提出的模型、方法)整理成带稳定编号的框架卡片:每张卡片写清"是什么、适用场景、材料出处"。卡片之间还能一键切换为框架关系图,看清框架之间的依赖与因果,并可追溯每条连线来自材料的哪一页。

马斯克传记学习页的核心框架卡片,每张卡片带稳定编号、简介与材料出处

内容导学:按章节带读,出处随行

内容导学模块把材料拆成一个个内容单元(对应章节/幻灯片/连续主题组),每个单元给出:讲什么、核心结论、关键框架与行动要点。鼠标悬浮核心观点时会显示来源提示,并附可展开的"出处"面板;若页码映射经过核验,还会显示具体页码。这样你随时知道"这句话是从材料哪来的"。

市场展望学习页的内容导学单元,显示 PDF 页码范围、核心观点与出处提示

术语大全:遇到生词不用出页面

术语模块汇总理解材料所必需的名词、英文缩写、角色、流程与指标,支持页内搜索,并为每个术语标注真实出处和首次出现的单元。中英文术语都能给出解释,读英文材料时尤其好用。

行动规则:从"看懂"到"会用"

模块会把材料中"条件—行动—原因"式的关系整理成规则卡片(如:什么情况下该做什么、为什么),整体方法论图固定放在这里。若材料本身不含方法,页面会如实说明,而不是编造。

学习自检:和 AI 出题互考

点击自检口令,可复制一段结构化口令粘贴回你的对话,让 AI 基于当前材料知识库出题测验:支持综合全部、指定章节、自定义要求,还能选择题量、难度和能力重点。AI 会优先从题库 question-bank.json 抽取原题;测验结束输出的错题记录可导入页面,之后一键复测(路由规则见 references/question-bank-routing.md)。

我的笔记:一键收藏,只存本地

阅读时看到值得留存的内容,点"一键保存"就进入"我的笔记";也支持自由新增笔记。所有笔记仅存于浏览器本地存储,可导出 Markdown 备份,没有账号、不上传云端。

Attention Is All You Need 论文学习页的方法论地图局部,展示编号的推理步骤与关系连线

4️⃣ 三套主题:按光线切换阅读氛围

学习页内置三套完整主题(定义见 templates/themes/README.md),每套都会同时改变主色、背景、导航与信号色,而不只是换个底色:

主题名 风格 适合场景 样式文件
warm-paper 雾蓝书房 低饱和暖调、纸感 白天长时间精读 warm-paper.css
minimal 灰白画册 中性灰白、留白多 追求极简专注 minimal.css
dark 深海夜读 深色护眼 夜间阅读 dark.css

页面右上角可随时切换,选择会记忆在本地。窄屏设备上模块目录会自动变为横向导航,手机上同样可读。

5️⃣ 新手上手清单:从材料到学习页

  1. 准备环境:Python 3.10+,以及一个能读文件、跑本地命令的 Agent 环境。把仓库放到技能的搜索路径即可,例如 WorkBuddy:

    git clone https://gitcode.com/gh_mirrors/le/learn-from-materials.git ~/.workbuddy/skills/learn-from-materials
    
  2. 检查解析能力(可选,在仓库根目录):python3 scripts/extract.py --check

  3. 发起对话:说一句"请用 learn-from-materials 系统学习这份材料",按提示选择深度。

  4. 打开生成的 HTML:跟着小巴走完引导,设置画像,然后按模块阅读。

  5. 想试试效果? 可直接打开内置演示页 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 的价值不在"生成一个网页",而在于把材料变成一座带目录、带出处、能测验、可记笔记的学习空间——首次打开跟着小巴走一遍,六大模块和三套主题就会成为你固定的阅读动线。

登录后查看全文
learn-from-materials