269 lines
11 KiB
Python
269 lines
11 KiB
Python
"""
|
||
人教社电子教材交互式终端下载器 (cli.py)
|
||
支持：
|
||
1. 交互式菜单筛选（学段 -> 学科 -> 年级）
|
||
2. 批量全选下载或勾选指定教材下载
|
||
3. 命令行参数一键过滤下载 (例如: python cli.py --xd "小学（六三学制）" --xk "语文" --nj "一年级")
|
||
4. 关键词全局模糊搜索下载
|
||
5. 缓存清理与目录强制刷新
|
||
"""
|
||
|
||
import sys
|
||
import os
|
||
import argparse
|
||
from typing import List, Dict
|
||
from pep_core import PepCatalog, PepDownloader, XD_ORDER, XK_ORDER_PREFIX, NJ_ORDER, sort_xk_key, sort_nj_key
|
||
|
||
if hasattr(sys.stdout, "reconfigure"):
|
||
sys.stdout.reconfigure(encoding="utf-8")
|
||
|
||
|
||
def print_banner():
|
||
print("=" * 65)
|
||
print(" 📚 人民教育出版社 (PEP) 电子教材终端下载工具")
|
||
print("=" * 65)
|
||
|
||
|
||
def select_from_list(prompt: str, options: List[str], allow_all: bool = True) -> str:
|
||
"""辅助函数：提供多选编号菜单"""
|
||
items = ["全部"] + options if allow_all and "全部" not in options else options
|
||
print(f"\n👉 请选择【{prompt}】：")
|
||
for i, item in enumerate(items, 1):
|
||
print(f" [{i}] {item}")
|
||
|
||
while True:
|
||
try:
|
||
choice = input(f"请输入序号 (1-{len(items)}, 默认 1): ").strip()
|
||
if not choice:
|
||
return items[0]
|
||
idx = int(choice)
|
||
if 1 <= idx <= len(items):
|
||
return items[idx - 1]
|
||
print(f"[-] 输入超出范围，请输入 1 到 {len(items)} 之间的数字。")
|
||
except ValueError:
|
||
print("[-] 请输入有效的数字序号。")
|
||
|
||
|
||
def interactive_mode():
|
||
"""交互式导航筛选模式"""
|
||
print_banner()
|
||
print("[*] 正在加载教材分类结构...")
|
||
structure = PepCatalog.get_structure()
|
||
all_xds = list(structure.keys())
|
||
|
||
print("\n请选择检索模式：")
|
||
print(" [1] 分类层级筛选（学段 ➔ 学科 ➔ 年级）")
|
||
print(" [2] 关键词全局搜索（如输入：'必修一'、'高一数学'、'生物'）")
|
||
print(" [3] 一键按「学段 ➔ 年级」两层目录全量下载全部教材")
|
||
|
||
mode_choice = input("请输入模式编号 (1/2/3, 默认 1): ").strip()
|
||
|
||
matched_books = []
|
||
|
||
if mode_choice == "3":
|
||
matched_books = PepCatalog.fetch_and_decrypt_all()
|
||
print(f"\n[+] 已加载全网全部教材，共 {len(matched_books)} 本。")
|
||
elif mode_choice == "2":
|
||
kw = input("\n🔍 请输入搜索关键词: ").strip()
|
||
if not kw:
|
||
print("[-] 关键词不能为空！")
|
||
return
|
||
matched_books = PepCatalog.filter_books(keyword=kw)
|
||
else:
|
||
# 1. 选择学段（已按规定排序）
|
||
selected_xd = select_from_list("学段", all_xds, allow_all=True)
|
||
|
||
# 获取该学段下的学科和年级
|
||
if selected_xd == "全部":
|
||
s_set = set(s for x in structure.values() for s in x["subjects"])
|
||
all_subjects = sorted(list(s_set), key=sort_xk_key)
|
||
g_set = set(g for x in structure.values() for g in x["grades"])
|
||
all_grades = sorted(list(g_set), key=sort_nj_key)
|
||
else:
|
||
all_subjects = structure[selected_xd]["subjects"]
|
||
all_grades = structure[selected_xd]["grades"]
|
||
|
||
# 2. 选择学科（已按规定排序）
|
||
selected_xk = select_from_list("学科", all_subjects, allow_all=True)
|
||
|
||
# 3. 选择年级（已按规定排序）
|
||
selected_nj = select_from_list("年级", all_grades, allow_all=True)
|
||
|
||
matched_books = PepCatalog.filter_books(xd=selected_xd, xk=selected_xk, nj=selected_nj)
|
||
|
||
if not matched_books:
|
||
print("\n[-] 未匹配到任何符合条件的教材！")
|
||
return
|
||
|
||
print(f"\n✅ 共检索到 {len(matched_books)} 本教材：")
|
||
print("-" * 65)
|
||
for idx, b in enumerate(matched_books[:15], 1):
|
||
xd = b.get("xd", "")
|
||
xk = b.get("xk", "")
|
||
nj = b.get("nj", "")
|
||
cc = b.get("cc", "")
|
||
title = b.get("title", "")
|
||
print(f" [{idx:2d}] [{xd}|{xk}|{nj}{cc}] 《{title}》 (ID: {b['id']})")
|
||
if len(matched_books) > 15:
|
||
print(f" ... 以及其余 {len(matched_books) - 15} 本教材（已折叠显示）")
|
||
print("-" * 65)
|
||
|
||
print("\n请选择下载范围：")
|
||
print(" • 直接按 Enter 或输入 'all': 下载当前列表中的【全部】教材")
|
||
print(" • 输入单个序号（如 '3'）: 只下载第 3 本")
|
||
print(" • 输入多个序号（如 '1,3,5' 或范围 '1-4'）: 批量下载指定教材")
|
||
print(" • 输入 'q': 退出")
|
||
|
||
select_str = input("\n请输入下载指令: ").strip().lower()
|
||
if select_str == "q":
|
||
print("[*] 已取消操作。")
|
||
return
|
||
|
||
to_download = []
|
||
if not select_str or select_str == "all":
|
||
to_download = matched_books
|
||
else:
|
||
indices = set()
|
||
for part in select_str.split(","):
|
||
part = part.strip()
|
||
if "-" in part:
|
||
try:
|
||
s, e = map(int, part.split("-"))
|
||
for i in range(s, e + 1):
|
||
indices.add(i)
|
||
except ValueError:
|
||
pass
|
||
elif part.isdigit():
|
||
indices.add(int(part))
|
||
|
||
for i in sorted(list(indices)):
|
||
if 1 <= i <= len(matched_books):
|
||
to_download.append(matched_books[i - 1])
|
||
|
||
if not to_download:
|
||
print("[-] 未选择有效教材，退出。")
|
||
return
|
||
|
||
res_choice = input("\n请选择画质 [1] 普通清晰度 (默认) [2] 高清大图 (large): ").strip()
|
||
is_high_res = (res_choice == "2")
|
||
|
||
out_dir = os.path.abspath("./downloads")
|
||
print(f"\n🚀 即将开始下载 {len(to_download)} 本教材 ({'高清版本' if is_high_res else '普通版本'})，基础保存目录: {out_dir}")
|
||
print(f"🌲 采用「学段 ➔ 年级」两层子目录分类保存 (已存在 PDF 自动跳过)")
|
||
downloader = PepDownloader(headless=True, output_dir=out_dir)
|
||
|
||
for idx, b in enumerate(to_download, 1):
|
||
xd = b.get("xd", "其他学段")
|
||
nj = (b.get("nj") or "通用").strip() or "通用"
|
||
import re
|
||
safe_xd = re.sub(r'[\/:*?"<>|]', '_', xd).strip()
|
||
safe_nj = re.sub(r'[\/:*?"<>|]', '_', nj).strip()
|
||
sub_dir = os.path.join(safe_xd, safe_nj)
|
||
|
||
print(f"\n==================================================")
|
||
print(f"[{idx}/{len(to_download)}] [{safe_xd}/{safe_nj}] 《{b.get('title')}》")
|
||
print(f"==================================================")
|
||
downloader.download_book(
|
||
book_id=b["id"],
|
||
custom_title=b.get("title"),
|
||
sub_dir=sub_dir,
|
||
skip_if_exists=True,
|
||
clean_temp=True,
|
||
high_res=is_high_res
|
||
)
|
||
|
||
print("\n🎉 全部选定任务执行完毕！")
|
||
|
||
|
||
def cli_args_mode(args):
|
||
"""命令行参数直接执行模式"""
|
||
print_banner()
|
||
if args.all:
|
||
matched = PepCatalog.fetch_and_decrypt_all()
|
||
else:
|
||
matched = PepCatalog.filter_books(xd=args.xd, xk=args.xk, nj=args.nj, keyword=args.search)
|
||
|
||
if not matched:
|
||
print("[-] 未查找到符合条件的教材！")
|
||
return
|
||
|
||
print(f"[+] 符合条件的教材共 {len(matched)} 本：")
|
||
for idx, b in enumerate(matched[:15], 1):
|
||
print(f" [{idx}] [{b.get('xd')}|{b.get('nj')}] 《{b.get('title')}》 (ID: {b['id']})")
|
||
if len(matched) > 15:
|
||
print(f" ... 以及其余 {len(matched) - 15} 本教材（已折叠）")
|
||
|
||
if not args.yes:
|
||
confirm = input(f"\n确认下载以上 {len(matched)} 本教材吗？(y/n, 默认 y): ").strip().lower()
|
||
if confirm == "n":
|
||
print("[*] 已取消。")
|
||
return
|
||
|
||
out_dir = os.path.abspath(args.output)
|
||
downloader = PepDownloader(headless=True, output_dir=out_dir)
|
||
use_tree = not args.flat
|
||
is_high_res = args.high_res
|
||
|
||
print(f"\n📂 保存根目录: {out_dir}")
|
||
print(f"🌲 目录结构: {'按「学段/年级」两层子目录' if use_tree else '全部平铺在根目录'}")
|
||
print(f"🖼️ 图像规格: {'高清大图模式 (large)' if is_high_res else '普通模式 (mobile)'}")
|
||
|
||
for idx, b in enumerate(matched, 1):
|
||
sub_dir = None
|
||
if use_tree:
|
||
import re
|
||
safe_xd = re.sub(r'[\/:*?"<>|]', '_', b.get("xd", "其他学段")).strip()
|
||
safe_nj = re.sub(r'[\/:*?"<>|]', '_', (b.get("nj") or "通用").strip() or "通用").strip()
|
||
sub_dir = os.path.join(safe_xd, safe_nj)
|
||
|
||
print(f"\n[{idx}/{len(matched)}] 正在下载: 《{b.get('title')}》...")
|
||
downloader.download_book(
|
||
book_id=b["id"],
|
||
custom_title=b.get("title"),
|
||
sub_dir=sub_dir,
|
||
skip_if_exists=True,
|
||
clean_temp=True,
|
||
high_res=is_high_res
|
||
)
|
||
|
||
print(f"\n🎉 下载完成！文件已保存至: {out_dir}")
|
||
|
||
|
||
def main():
|
||
parser = argparse.ArgumentParser(description="人民教育出版社电子教材 CLI 下载器")
|
||
parser.add_argument("--all", "-a", action="store_true", help="下载全网全部 780+ 本教材")
|
||
parser.add_argument("--xd", help="指定学段（如：小学（六三学制）、初中（六三学制）、高中等）")
|
||
parser.add_argument("--xk", help="指定学科（如：语文、数学、英语、物理等）")
|
||
parser.add_argument("--nj", help="指定年级（如：一年级、七年级、必修等）")
|
||
parser.add_argument("--search", "-s", help="全局搜索关键词")
|
||
parser.add_argument("--high-res", "--hd", action="store_true", help="下载高清大图版本 (large)，默认普通版本 (mobile)")
|
||
parser.add_argument("--output", "-o", default="./downloads", help="PDF 文件保存目录 (默认: ./downloads)")
|
||
parser.add_argument("--flat", action="store_true", help="平铺存放在根目录下（默认自动按「学段/年级」两层子目录分类）")
|
||
parser.add_argument("--yes", "-y", action="store_true", help="免确认直接开始下载")
|
||
parser.add_argument("--refresh", "-r", action="store_true", help="强制从官方服务器重新拉取并解密最新教材目录")
|
||
parser.add_argument("--clear-cache", "-c", action="store_true", help="清理本地临时下载缓存 (temp_pages)")
|
||
|
||
args = parser.parse_args()
|
||
|
||
if args.clear_cache:
|
||
print_banner()
|
||
res = PepCatalog.clear_cache_files()
|
||
print(f"[✔] {res['message']}")
|
||
return
|
||
|
||
if args.refresh:
|
||
print_banner()
|
||
print("[*] 正在从人教社官方前端拉取并解密最新教材目录...")
|
||
books = PepCatalog.fetch_and_decrypt_all(force_refresh=True)
|
||
print(f"[+] 目录同步成功！共获取到 {len(books)} 本教材。")
|
||
return
|
||
|
||
if args.all or args.xd or args.xk or args.nj or args.search:
|
||
cli_args_mode(args)
|
||
else:
|
||
interactive_mode()
|
||
|
||
|
||
if __name__ == "__main__":
|
||
main()
|