用途：在本地终端自动查找并下载电子书，目标是让文件可靠落盘并完成校验。优先 EPUB，EPUB 来源耗尽后才接受 PDF。
主要能力：捆绑脚本 libgen_fetch.py 负责搜索 libgen.li、对候选排序、流式下载（每 30 秒打印进度）、代理路由与校验；支持 --search-only 仅搜索、--format epub、--lang English、--top N 等参数。另有 resolve_metadata.py 用于在搜索无结果时解析规范书名与作者（查询 Open Library，中文书名查豆瓣），以及 oceanofpdf_probe.py 探测 OceanofPDF。
使用方式：流程分三步。Step 0 准备网络环境（必做）：用 curl 检测 libgen.li 可达性，用 networksetup/scutil 检测系统代理，设置 HTTPS_PROXY/HTTP_PROXY，并动态发现装有 cloudscraper 的 Python 并导出 BOOK_PYTHON。Step 1 搜索：优先运行 python3 scripts/libgen_fetch.py "Title AuthorSurname" --out ~/Downloads --search-only；无结果或中文书名时改用浏览器搜索 libgen.li，提取 get.php 链接。Step 2 下载：去掉 --search-only 执行下载；代理环境下 ≥10 MB 文件必须用后台模式，命令中需内联发现 BOOK_PYTHON。下载后校验 EPUB 是否为有效 ZIP、PDF 是否为 %PDF- 开头。
适用场景：需要从 libgen 等来源获取电子书、且终端可访问网络或可配置代理的环境；支持多本书批量处理（先全部 --search-only 再逐本下载）。
限制：资料声明仅供学习研究，严禁违法违规使用，作者不承担损失。代理下载速度约 30-80 KB/s，大文件耗时较长；HTTP Range 续传会返回 524，需删除部分文件重新获取新 key；Safari/computer_use 无法下载 get.php 链接；IPFS 镜像与 Z-Library 域名已失效；OceanofPDF 需人工处理，为最后手段；当年新书与近期译本可能无扫描版。具体收费、平台支持等事实资料未提供。