用途:将学术 PDF 转换为干净的 Markdown,便于以文本方式阅读、分析或引用论文。支持本地 PDF 文件与直接指向 PDF 的远程 URL。
主要能力与用法:通过 uvx 运行,无需安装。基本命令为 uvx paper-siphon paper.pdf;远程示例 uvx paper-siphon https://arxiv.org/pdf/1706.03762.pdf;自定义输出 uvx paper-siphon paper.pdf -o paper-notes.md。默认输出为与输入同名的 .md 文件。
提取管线:默认管线基于 Docling,适合多数标准单栏/双栏文本、简单表格、无大量数学的论文,速度最快,会剥离页边行号并规范化空白。--vlm 使用视觉语言模型直接解读页面图像,适合复杂版式、图文交错、扫描件或默认输出乱码的情况,速度明显更慢;在 Apple Silicon 上自动使用 MLX 加速,可用 --no-mlx 关闭,或用 uvx --with 'paper-siphon[mlx]' paper-siphon --vlm paper.pdf 显式包含 MLX 依赖。--enrich-formula 对默认管线提取的数学表达式做后处理以提升保真度,但资源消耗大;数学密集的论文更推荐 --vlm,因为默认管线常丢失展示公式。
其他选项:-o/--output 指定输出路径,--mlx/--no-mlx 控制 MLX 加速,-v/--verbose 输出调试日志。arXiv 需使用 /pdf/ 链接而非 /abs/。可批量转换:for f in papers/*.pdf; do uvx paper-siphon "$f"; done。
限制:默认管线对数学与复杂版式效果有限;--vlm 较慢;--enrich-formula 资源密集。建议先用默认管线,输出乱码或不完整或论文数学密集时再升级到 --vlm。