用途：在本地终端自动查找并下载电子书，目标是让文件可靠落盘并完成校验。优先 EPUB，EPUB 来源耗尽后才接受 PDF。流程全自动，按固定优先级链执行，不逐源询问。
主要能力：分三阶段严格顺序执行——准备（检测网络环境与系统代理并设置环境变量）、搜索（优先 cloudscraper，失败或 CJK 标题时用浏览器搜索 libgen）、下载（大文件走后台进程并经代理，小于 10 MB 可前台）。脚本 libgen_fetch.py 负责搜索、流式下载（每 30 秒进度）、代理路由与校验；缓存优先，已存在有效文件则跳过；校验 EPUB 为有效 ZIP 并读取 content.opf，PDF 检查 %PDF- 魔数，失败则删除并尝试下一候选。
使用方式：先运行 Step 0 网络诊断，用 curl 检查 libgen.li 可达性，用 networksetup 与 scutil 检测代理，设置 HTTPS_PROXY/HTTP_PROXY；再动态发现装有 cloudscraper 的 Python 并导出 BOOK_PYTHON。搜索示例：python3 scripts/libgen_fetch.py "Title AuthorSurname" --out ~/Downloads --search-only。下载去掉 --search-only；代理下且文件 ≥10 MB 必须用后台模式，后台命令需内联发现 Python。退出码：0 成功、2 全部失败、3 未找到、4 缺少 cloudscraper。搜索无结果时可用 resolve_metadata.py 解析规范标题与作者后重试。
适用场景：需要从终端批量或单本获取电子书、处于受限网络需经代理下载、以及多书或多版本请求（先全部 --search-only 再逐本下载）。
限制：仅供学习研究，严禁违法违规使用，作者不负责损失。代理下载速度约 30-80 KB/s，大文件耗时长；libgen get.php 的 key 与会话绑定，不支持 Range 续传，失败需删部分文件重取 key；IPFS/镜像与 Z-Library 域名多已失效；OceanofPDF 需人工 Safari 处理，为最后手段；当年新书与近期译本常无扫描，需回退英文原版。具体收费、平台与效果资料暂未提供。