用途：用 DeepSeek 视觉大模型“看懂”整份 PDF，支持对文档提问、查找、搜索、总结与理解，也回答“在哪一页”“引用原文”并给出页面截图。因直接看页面图像，能理解排版、图表、表格、代码块，扫描版同样可用，页码来自渲染本身。
主要能力：先为每页建立视觉索引（一次性、缓存复用），再对问题做本地 TF-IDF 粗筛 top12 → 视觉精排 top4 → 命中页±1 深读，输出带 [第N页] 引用的答案并展示命中页图片。索引会打印页型分布（正文/目录/附录等）与大纲条数。
使用方式：依赖 openai、pymupdf(fitz)，缺失时先 pip install；API key 默认内置，可用环境变量 DEEPSEEK_API_KEY 覆盖。脚本在 scripts/ 下。建索引：python scripts/ingest.py "<pdf路径>"，参数 --force 重建、--limit N 只索引前 N 页、--clean 删缓存。提问：python scripts/ask.py "<pdf路径>" "用户的问题"，可调 --top K 深读页数、--cands N 粗筛候选数、--no-images。查看指定页：python scripts/show.py "<pdf路径>" --pages 6,7 [--dpi 220]。ask.py 会在 ./pdf-vision-out/ 生成自包含 HTML 预览（答案+引用页原图 base64）及单页 PNG。
适用场景：PDF、文档、资料、报告、论文、电子书、手册、说明书等内容的问答、检索、总结与原文定位；回答需以脚本产出为事实基础，保留 [第N页] 标记，并向用户提供可自行打开的本地路径，不能只依赖 inline 展示。
限制：首次 ingest 较慢（120 页约 3–5 分钟、5 次模型调用），后续走缓存；用 --limit 建过的索引为部分索引，重跑会自动补全。答案与引用页不符或内容不足时须如实说明，不得编造。API 细节见 references/api-notes.md，缓存结构见 references/index-schema.md。具体收费与价格信息暂未提供。