learn-from-materials

把PDF和论文变成能做题、能做笔记的学习网页

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署学习教育 🍴 复刻 127 👀 关注 3

GitHub ↗

GitHub 星标 ★ 1355

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源项目，免费使用

项目预览

learn-from-materials 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类学习教育

开发团队dmoshehun-prog

GitHubhttps://github.com/dmoshehun-prog/learn-from-materials

定价模式🏷️完全免费

价格说明开源项目，免费使用

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent-skills,ai-agent,book,claude-code,codex,education,knowledge-base,learning,markdown,workbuddy

GitHub 星标★ 1355

上线时间2026-09-08 00:00:00

代码更新2026-10-19

仓库体积22.1 MB

本站数据更新2026-11-09

维护状态较活跃

收录时间2026-09-25

浏览次数38

项目介绍

learn-from-materials 是一个把 PDF、电子书和学术论文自动转成可交互学习网页的开源工具。它针对的核心痛点是：学习资料往往又长又密，读完记不住、找不到重点、也没法即时自测。项目通过 AI Agent 能力解析原始材料，生成结构化的 Markdown 学习页面，保留原文出处以便随时回溯，同时支持生成测验题和笔记区，让被动阅读变成主动学习。技术栈以 Python 为主，结合 agent-skills、Claude Code、Codex 等 AI 编码代理生态，适合把教材、论文、技术书变成个人知识库。整体定位偏轻量，强调可追溯、可测验、可做笔记三个动作，适合自学、备考和知识管理场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-25 · 当前星标 ★ 1355

技术标签

agent-skills ai-agent book claude-code codex

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 5 分钟部署方式：本地安装 6 步

环境要求

支持 Agent Skills 规范的代理环境（WorkBuddy、Codex、Claude Code、GitHub Copilot CLI 等）
该代理需能读取文件、运行本地命令并识别 SKILL.md
Python 环境（用于材料提取、覆盖率校验与 HTML 渲染）
安装 1.0 发布包时需能解压 learn-from-materials-1.0-release.zip

安装与启动步骤

1确认代理环境

运行环境需支持读取文件、执行本地命令并识别 SKILL.md；纯聊天环境只能用部分提示工作流。
2选择技能目录

按所用客户端选择用户级技能搜索目录，如 Claude Code 用 ~/.claude/skills/，目录不存在时先创建。
3克隆仓库安装

把仓库直接克隆为技能目录下的 learn-from-materials 文件夹，路径按你的客户端替换。
```
git clone https://github.com/dmoshehun-prog/learn-from-materials.git ~/.claude/skills/learn-from-materials
```
4或解压 ZIP 安装

用 1.0 发布包时，解压 learn-from-materials-1.0-release.zip，把完整的 learn-from-materials/ 文件夹放入技能目录。
5检查目录结构

确认 SKILL.md、scripts/、references/、templates/ 直接位于 learn-from-materials/ 内，别多套一层文件夹。
6重启客户端

若客户端没发现新版本，重新加载或重启；已有同名旧技能要先自行备份，不要直接覆盖。

如何确认成功

重新加载或重启客户端后，技能列表中出现 learn-from-materials，且能识别该版本。

常见问题

Q：该用 ZIP 还是 git clone 安装？

A：ZIP 对应 1.0 发布版；git clone 安装的是仓库默认分支，内容可能与 ZIP 不同。要装这个 1.0 版本请用 ZIP。

Q：纯聊天客户端能用吗？

A：不支持。没有文件系统访问或 Python 执行能力的纯聊天环境只能使用部分提示工作流，无法做材料提取、覆盖率校验和 HTML 渲染。

Q：目标目录已存在同名技能怎么办？

A：先自行备份，不要直接覆盖。整个 learn-from-materials/ 目录替换后再让客户端重新发现技能。

Q：云或托管代理读不到本地目录怎么办？

A：这类代理可能无法访问本地用户目录，应通过该产品的技能导入、同步或项目级目录机制安装。

Q：客户端没识别到新版本怎么办？

A：重新加载或重启客户端；仍不生效时检查技能目录是否放对、是否多了一层嵌套。

注意事项

各客户端用户级目录：WorkBuddy 为 ~/.workbuddy/skills/，Codex 为 ~/.agents/skills/，Claude Code 为 ~/.claude/skills/，GitHub Copilot CLI 为 ~/.copilot/skills/ 或 ~/.agen
ZIP 中的 SKILL.md、scripts/、references/、templates/ 必须直接位于 learn-from-materials/ 文件夹内，避免多余嵌套层级。
更新已有同名技能前先备份，不要直接覆盖原目录。
云/托管代理可能读不到本地用户目录，需改用该产品的技能导入或项目级目录机制。