FreePEP 是一款专为人民教育出版社中小学电子教材平台开发的自动化教材解析、批量抓取与高清 PDF 合成工具。
提供WebUI 界面与交互式命令行，内置全量 780+ 本教材目录（数据截止到2026年08月31日）自动解密引擎与阿里云 WAF 滑块验证码自动破解机制，支持一键下载指定学段、学科、年级的全套教材并自动生成高清 PDF 文件。
- 🎯 双操作模式：
- 现代化 WebUI 界面：全响应式布局，还原官网层级筛选体验，支持复选框一键批量下载、实时进度条展示与本地保存目录快捷打开。
- 交互式 CLI 终端：支持数字菜单导航选择与命令行参数直达（脚本集成与服务器环境友好）。
- 📦 高清单页下载与 PDF 合成：自动探测各教材实际总页数，批量下载高分辨率原始 JPG，并通过 Pillow 库自动合成为标准 PDF 文件。
直接下载发行包，解压缩后运行FreePEP.exe，在弹出的Web页面里面自行操作下载。
# 克隆仓库
git clone https://github.com/siknet/FreePEP.git
cd FreePEP
# 安装 Python 依赖
pip install -r requirements.txt
# 安装 Playwright 所需的 Chromium 浏览器内核
playwright install chromium在终端中执行以下命令，系统将自动启动本地服务并在默认浏览器中打开管理页面：
python webui.py- 访问地址：
http://127.0.0.1:8000 - 默认下载目录：项目根目录下的
./downloads文件夹（可在 Web 界面点击「📁 打开保存目录」直达）。
直接运行 cli.py，根据控制台提示逐步选择学段、学科与年级：
python cli.py通过命令行参数直接指定条件过滤并自动开始下载：
# 1. 下载小学一年级的所有学科教材
python cli.py --xd "小学" --nj "一年级" -y
# 2. 下载高中数学的所有必修/选修教材
python cli.py --xd "高中" --xk "数学" -y
# 3. 下载初中全部教材
python cli.py --xd "初中" -y
# 4. 全局关键词搜索并下载（如包含"物理"的所有教材）
python cli.py --search "物理"
# 5. 清理本地临时图片缓存
python cli.py --clear-cache
# 6. 自定义 PDF 输出路径
python cli.py --xd "小学（六三学制）" --xk "语文" --nj "一年级" -o "D:/Textbooks" -y参数说明：
| 参数 | 说明 | 示例 |
|---|---|---|
--xd |
指定学段 | 小学（六三学制）、初中（六三学制）、小学（五四学制）、初中（五·四学制）、高中、培智学校、聋校、盲校（盲文版）、盲校（低视力版） |
--xk |
指定学科 | 语文、数学、英语、物理、化学、历史、道德与法治 等 |
--nj |
指定年级/册次 | 一年级、二年级 ... 九年级、专项、必修 等 |
--search, -s |
关键词全局搜索 | 必修、高一、地理 |
--clear-cache, -c |
清理本地下载临时图片缓存 (temp_pages) |
无需参数 |
--refresh, -r |
强制重新从官方服务器拉取解密最新目录 | 无需参数 |
--output, -o |
指定 PDF 保存目录 | 默认: ./downloads |
--yes, -y |
跳过确认提示直接开始下载 | 开启免交互 |
如果您想将本项目打包成 脱离 Python 环境 的独立绿色软件包发布给普通用户，只需执行工作区自带的一键打包脚本：
python build_exe.py- 自动检查并安装
PyInstaller编译工具。 - 将 WebUI 及所有 Python 依赖打包为独立可执行文件
FreePEP.exe。 - 自动提取并内嵌绿色便携版 Chromium 浏览器内核至
browsers/目录。 - 自动在
dist/目录下生成FreePEP-Windows-x64.zip发行压缩包。
分发给用户使用：用户下载压缩包后解压，双击
FreePEP.exe即可直接使用（会自动弹出系统默认浏览器打开 WebUI，无需安装 Python、无需配置环境变量、无需额外下载浏览器内核）。
FreePEP/
├── pep_core.py # 核心底层库（AES 解密、Playwright 爬取、PDF 合成）
├── webui.py # FastAPI WebUI 服务器与一体化前端界面
├── cli.py # 交互式与参数化 CLI 终端下载器
├── build_exe.py # 一键打包发布 Windows EXE 独立便携包脚本
├── pep_crawler.py # 命令行测试与示例下载脚本
├── pep_catalog.json # 全量教材元数据本地缓存（自动生成）
├── requirements.txt # 项目 Python 依赖清单
├── README.md # 项目使用说明文档
├── temp_pages/ # 图片下载临时缓存目录（下载后自动清理/保留）
└── downloads/ # 生成的高清 PDF 默认存放目录
- 略。我是不明白为什么免费教材免费提供阅读不提供免费下载。
- 本项目仅供 Python 爬虫技术交流、逆向工程学习与个人学习研究使用，严禁用于任何商业用途或盈利活动。
- 本项目下载的所有教材版权均归**人民教育出版社（PEP）**及相关版权所有方所有。
- 使用本项目时请控制请求频率，严禁进行任何可能对官方服务器造成过大负载的行为。请于下载后 24 小时内自行删除，如需长期使用请购买或支持官方正版出版物。
- 使用者因违反版权或不当使用造成的一切法律纠纷与责任，均由使用者个人自行承担，与本项目作者无关。
本项目基于 MIT License 协议开源。欢迎提交 Issue 与 Pull Request！