全文目录：

• • 🌟 开篇语
  • 0️⃣ 前言（Preface）
  • 1️⃣ 摘要（Abstract）
  • 2️⃣ 背景与需求（Why）
  • • 2.1 为什么要爬古籍版本流传信息
    • 2.2 本文目标站点与字段
    • 2.3 版本型元数据和普通图书榜单的不同
  • 3️⃣ 合规与注意事项（必写）
  • • 3.1 robots.txt 基本说明
    • 3.2 频率控制，不要攻击式并发
    • 3.3 不采集敏感信息
    • 3.4 优先使用 API，而不是强行解析页面
  • 4️⃣ 技术选型与整体流程（What/How）
  • • 4.1 静态、动态、API：本文属于哪种
    • 4.2 整体流程
    • 4.3 为什么选择 requests + JSON 解析
  • 5️⃣ 环境准备与依赖安装（可复现）
  • • 5.1 Python 版本
    • 5.2 创建虚拟环境
    • 5.3 安装依赖
    • 5.4 推荐项目结构
  • 6️⃣ 核心实现：请求层（Fetcher）
  • • 6.1 配置文件
    • 6.2 `config.py`
    • 6.3 `utils.py`
    • 6.4 `models.py`
    • 6.5 `fetcher.py`
    • 6.6 请求层说明
  • 7️⃣ 核心实现：解析层（Parser）
  • • 7.1 解析方式
    • 7.2 版本抽取为什么不能太激进
    • 7.3 `cleaner.py`
    • 7.4 `parser.py`
    • 7.5 列表页如何拿详情链接
    • 7.6 详情页如何抽字段
    • 7.7 缺失字段怎么办
  • 8️⃣ 数据存储与导出（Storage）
  • • 8.1 字段映射表
    • 8.2 去重策略
    • 8.3 `storage.py`
    • 8.4 为什么 CSV 用 `utf-8-sig`
  • 9️⃣ 运行方式与结果展示（必写）
  • • 9.1 `main.py`
    • 9.2 启动命令
    • 9.3 输出位置
    • 9.4 示例结果展示
    • 9.5 增加一个命令行参数版本
  • 🔟 常见问题与排错（强烈建议写）
  • • 10.1 403 怎么办
    • 10.2 429 怎么办
    • 10.3 HTML 抓到空壳怎么办
    • 10.4 解析报错怎么办
    • 10.5 编码和乱码如何处理
    • 10.6 抽取不到版本怎么办
    • 10.7 同一书名重复怎么办
    • 10.8 年代字段混乱怎么办
  • 1️⃣1️⃣ 进阶优化（可选但加分）
  • • 11.1 并发：先别急着上
    • 11.2 asyncio 版本思路
    • 11.3 Scrapy 化
    • 11.4 断点续跑
    • 11.5 日志与监控
    • 11.6 定时任务
    • 11.7 多站点扩展
    • 11.8 增加人工复核字段
  • 1️⃣2️⃣ 总结与延伸阅读
  • 🌟 文末
  • • ✅ 专栏持续更新中｜建议收藏 + 订阅
    • ✅ 互动征集
    • ✅ 免责声明