FreePEP 是一款专为人民教育出版社中小学电子教材平台 设计的自动化工具，是实用软件 类别里针对「教材整本归档」这一具体场景的下载工具。它把「翻页阅读 + 截图下载 + 排版合成」这一长串手动操作收进一个效率工具 里：内置 780+ 本教材目录（截至 2026-08-31）、自动解密引擎、阿里云 WAF 滑块验证码自动破解，既提供现代 WebUI，也提供交互式 CLI，最终产物是每页清晰度与官方原图一致的标准 PDF——一份 PDF工具 形态的离线电子书。
下面是对它的完整解读与上手路径。
截图（WebUI）：学段 / 学科 / 年级三组按钮 + 复选框 + 一键批量下载按钮，最上角有「清理缓存 / 同步最新目录 / 打开保存目录」三个动作入口。
场景痛点
人民教育出版社的电子教材平台把全套中小学教材免费给读者在线翻页阅读，但官方只提供官方应用内的浏览、不提供完整 PDF 下载——这意味着：
- 临时要把整本教材发给孩子 / 学生 / 同事，只能逐页截图或录屏，30–300 页的手动操作不可接受；
- 离线备课、批注、用 PDF 阅读器排版、按页搜索 / 复制文字，都做不了；
- 想做学科素材归档、家庭装机的离线电子书包，必须依赖官方客户端，且不同平台兼容度差异大；
- 阿里云 WAF 的滑块验证码在浏览器自动化场景下属于「常驻障碍」，想用脚本批量抓的人手要解决这一道坎。
FreePEP 解决的正是把「逐页点读 + 截图 + 拼 PDF + 过 WAF」这串动作用一份脚本一键做完，并提供 WebUI 让非程序员也能用——它本身就是一份值得放进工具推荐 清单的开源作品。
它是什么
FreePEP 是一款 Python 写的开源 且开源软件 工具，2026-08-31 首发 v 1.0，MIT 协议，由独立开发者 siknet 维护，是软件工具 类别里针对「教材整本归档」这一具体场景的自动化 方案。
它把「下载 + 解密 + 拼 PDF」这一套流程封装成两层：底层是 pep_core.py（AES 解密、Playwright 浏览器自动化、PDF 合成），上层提供两种入口：
| 入口 | 文件 | 适用人群 |
| WebUI（FastAPI 前后端） | webui.py | 老师、家长、运营——双击 FreePEP.exe 后浏览器自动弹出 |
| 交互式 + 参数化 CLI | cli.py | 程序员、运维、自动化场景——可写成脚本、塞进服务器 |
技术栈核心是 Python + FastAPI + Playwright + Pillow + AES。Playwright 提供浏览器自动化能力，Pillow 负责把逐页 JPG 拼成标准 PDF，FastAPI 起本地 Web 服务。这一套组合对 Windows / macOS / Linux 三平台都友好（但 Release 资产里只提供了 Windows x 64 整合包，367 MB）。
双操作模式
WebUI 网页端
WebUI 是给非程序员准备的「小白」入口：双击 FreePEP.exe，本地服务自动起在 http://127.0.0.1:8000，默认浏览器自动打开。
UI 的几个细节：
- 学段 / 学科 / 年级 三组按钮：复刻官方站的层级筛选（小学 / 初中 / 高中 / 培智 / 聋 / 盲校 / 五四学制 / 六三学制等）；
- 全局搜索框：输入「必修一 / 高一语文 / 道德与法治」等关键词做全文检索；
- 实时进度条：当前状态、队列等待、总体进度三栏展示；
- 三个动作入口：清理缓存、同步最新目录、打开保存目录。
截图（CLI）：交互式菜单三层选择——学段 → 学科 → 年级，全部用数字快捷键导航，回车直达。
CLI 命令行
CLI 是给脚本场景准备的两个分支：
交互式菜单模式—— python cli.py 直接进数字菜单，零学习成本。
参数直达模式—— python cli.py --xd 「小学」 --nj 「一年级」 -y 一行命令拉全套。常用参数：
| 参数 | 含义 | 示例 |
--xd | 学段 | 小学（六三学制）、初中（五·四学制）、高中、培智学校、盲校（盲文版） |
--xk | 学科 | 语文 / 数学 / 道德与法治 等 |
--nj | 年级 / 册次 | 一年级 到 九年级 / 专项 / 必修 |
--search | 关键词全局搜索 | 必修 / 高一 / 地理 |
--output, -o | 自定义 PDF 输出目录 | -o 「D:/Textbooks」 |
--clear-cache, -c | 清理 temp_pages/ 图片缓存 | 无参 |
--refresh, -r | 强制从官方服务器拉取最新目录 | 无参 |
--yes, -y | 跳过确认直接开始 | 无参 |
需要脚本化「开学前一夜把语文全套下完」这类场景时，参数模式直接挂在系统计划任务或 cron 里就能跑。
核心能力
FreePEP 这只工具的能力拆开看，四件事都做满了：
1. 全量教材目录与自动同步
pep_catalog.json 是项目的本地目录缓存。780+ 本教材涵盖从小学到高中、从普通学校到培智 / 聋 / 盲校的 10 个学段，以及 11 个学科。WebUI 顶部「同步最新目录」按钮触发 --refresh 参数，从官方服务器拉一次更新；CLI 默认每次启动都校验目录时效性。
2. AES 自动解密 + 阿里云 WAF 滑块自动破解
教材图片从官方服务器拉回是加密流，必须在客户端解。pep_core.py 里的 AES 解密模块把这一段做掉；阿里云 WAF 的滑块验证码对浏览器自动化是常驻障碍——FreePEP 用 Playwright + 内置浏览器内核做了一次性突破：安装包里自带 Chromium 内核（browsers/ 目录），脱离系统环境也能跑全套解密流程。
3. 高清单页下载 + Pillow PDF 合成
每本教材的「总页数」是程序自动探测的（不是写死的元数据），避免官方目录与实际页数不一致时的截断问题。每一页都拉最高分辨率原图到 temp_pages/，下载完成后用 Pillow 把整本拼成标准 PDF。清晰度与官方站一致，不会因为截图压损模糊。
4. 一键打包 Windows 独立 EXE
build_exe.py 帮你把整个项目打成 FreePEP-Windows-x64.zip 367 MB 的便携包：
- 自动装 PyInstaller；
- 把 WebUI + Python 依赖 + Chromium 内核全打包到
FreePEP.exe； - 用户双击
.exe即可使用，不需要装 Python、不需要配环境变量、不需要单独下浏览器内核——分发门槛降到了零。
安装与上手
两种走法：
方式一（推荐，免配环境）：到 Release 页 下载 FreePEP-Windows-x64.zip（约 367 MB），解压缩后双击 FreePEP.exe，浏览器自动弹出 WebUI；Windows 防火墙第一次可能会弹「允许 Python 私有网络访问」，点「允许」就行。
方式二（从源码启动）：
CLI 同步装好后就能用：
第一次使用使用技巧 上的几个要点：
temp_pages/图片缓存建议保留——一旦批量下载 中途掉线，可以--refresh后用缓存重建 PDF，不必重头再来；- WebUI 默认下载目录是
./downloads，可在「打开保存目录」按钮直达后另存； - 阿里云 WAF 滑块偶尔会因官方策略调整而需要更新
pep_core.py里的识别规则，关注项目 Issue 与 PR。
适用场景与边界
把 FreePEP 推荐给以下几类读者最合适：
- 教师 / 班主任：开学前把本班本学期的全套教材装到本地，制作纸质讲义、批注 PDF、做学科素材归档；
- 家长：希望「教辅级」PDF 永久存档，或者送设备时内置一份离线电子书包（注意：见下文免责声明）；
- 教育研究者 / 课程开发者：需要把多本教材按学段 / 学科 / 关键词做横向整理；
- 特殊教育场景：盲校（盲文版 / 低视力版）、培智学校等特殊版本也覆盖到了。
反过来说，下面几种需求不一定要走 FreePEP：
- 只想读个一两本单页翻翻——直接去官方平台 翻页阅读更轻；
- 需要长期保存并频繁使用——README 的官方建议是下载后 24 小时内删除，长期使用请支持正版；
- 处于中国大陆以外的网络环境，部分 WAF 节点可能在跨境场景下行为不一致；
- 非学科类资料——FreePEP 是人教社专用，不通用于其它出版社（北师大版 / 苏教版 / 沪教版等需要另寻工具）。
兼容性与免责提醒
FreePEP 解决的是「在线阅读→本地 PDF」这个转化问题，但它客观上属于自动化抓取与解密类工具，平台 ToS 与数据爬取条款对这类行为有约束。仓库 README 自带一段免责声明（直引）：
「本项目仅供 Python 爬虫技术交流、逆向工程学习与个人学习研究使用，严禁用于任何商业用途或盈利活动。本项目下载的所有教材版权均归人民教育出版社（PEP）及相关版权所有方所有。使用本项目时请控制请求频率，严禁进行任何可能对官方服务器造成过大负载的行为。请于下载后 24 小时内自行删除，如需长期使用请购买或支持官方正版出版物。使用者因违反版权或不当使用造成的一切法律纠纷与责任，均由使用者个人自行承担，与本项目作者无关。」
把这段放在最后是为了让「工具」和「用法」分开看：
- 代码与原理是公开的（MIT），可以读、可以学习、可以贡献；
- 下载与传播内容则受版权与平台条款约束，使用者按本地法律与平台规则自负责任。
如果只想保留一份长期使用的电子教材，请优先支持官方出版物的电子版/纸质版。
我的使用感受
FreePEP 的 WebUI 体验明显比很多同类 Python 工具更顺手——层级筛选、复选框批量、一键直达保存目录这三个细节直接对齐了官方平台的操作逻辑，零学习成本。CLI 端的 --search 全局关键词 + --yes 跳过确认，是写自动化脚本的好搭档；Pillow 拼 PDF 的清晰度与官方原图一致，比手动截图的工具链可靠。
但同时，「WAF 滑块自动识别」与「AES 解密」这两件事说明项目对官方平台的安全机制有较强依赖——一旦官方升级这两层防御，FreePEP 就会有一段「维护空窗期」。事实上作者在 README 「🔍 技术原理解析」一节留了一个未完待续的「略」字，配着一句「我是不明白为什么免费教材免费提供阅读不提供免费下载」——这是他/她对官方模式的委婉质疑，也提醒读者：工具的可用性是建立在与官方斗智斗勇的灰区之上。
把这一节与上文的免责提醒合并起来看：作为一份「工具介绍」文章，本文只介绍技术能力与使用路径，不替任何人做合规背书。读者按本地法律自负责任。
官方网站
https://github.com/siknet/FreePEP
下载地址
https://pan.quark.cn/s/5eaba563c9c8
