用途：把本地 PDF 交给 Gemini 多模态直接阅读，输出中文结构化 Markdown，适用于论文、产品手册/datasheet、行业或 vendor 白皮书、书籍/长篇技术文档。脚本按文档类型选用不同模板（assets/template-{paper,manual,whitepaper,book}.md 加共享 _base.md）。
主要能力：多模态直读 PDF，保留图表、公式与版式，不先做 OCR；paper 类型分 quick 与 full 两种风格，quick 输出速读总结并可导出原始图片（figures/），full 按原文章节逐节展开；manual、whitepaper、book 为 full 风格全文级转写，不抽原图，改用 mermaid 与表格在 Markdown 内表达；支持 --by-chapter 按章节拆分为多个文件，默认 L1 模式（按原生一级章逐章调用），可选 auto（单次调用，仅适用约 50 页以内）；支持 --auto-detect 依据 PDF 元数据、首页文本与首页渲染识别文档类型。
使用方式：依赖 Python 3.7 以上与 google-genai（pip install -U google-genai），需设置环境变量 GEMINI_API_KEY。调用脚本示例：python3 yzr-gemini-pdf-summary/scripts/gemini_pdf_summary.py --pdf <path> --type paper --output <output-dir>。常用参数包括 --type、--auto-detect、--full、--by-chapter、--granularity、--pages、--no-figures、--focus、--model 等；--type 与 --auto-detect 必须二选一。
适用场景：单份 PDF 的中文结构化总结、批量过稿、含大量图表公式的 PDF、产物需落盘供后续处理的场景。
限制：一次只处理一份本地 PDF，不做逐字翻译，不做多份对比；非 PDF 需先转换；脚本出错时不自动降级到更便宜模型，需用户决定是否显式指定模型；部分模式参数细节以资料为准，未提供的内容暂未提供。