bo老师
开源仓库google-research/arxiv-latex-cleaner6,939 Stars

arXiv LaTeX Cleaner

一键清理LaTeX工程并优化体积，准备arXiv提交包

适用于准备向arXiv提交LaTeX论文的研究者。它自动删除开发态注释和条件块，剔除未引用文件，缩放图片并压缩PDF，输出可直接打包上传的发布目录。

bo老师判断：推荐

用途和边界相对清楚，可以先从小样本开始。

访问原仓库查看分享卡
...互动状态已更新

什么时候用

先判断任务是否合适

  • 准备向arXiv提交论文前，需要清理开发态的注释和私有命令
  • 论文工程包含大量未引用的tex文件和图片，需要自动剔除冗余文件
  • 论文图片和PDF体积过大，需要达到arXiv 50MB限制要求

先准备什么

材料越清楚，结果越有用

  • •准备完整的LaTeX论文工程目录，确保可正常编译
  • •确认commands_to_delete等清理配置列表，防止误删正文命令
  • •可选：安装Ghostscript以启用PDF压缩功能
  • •确认输出目录_arXiv中无需要保留的内容（会被覆盖重建）

它会怎样推进

从材料到可以检查的结果

  1. 01

    清理源文件

    自动删除行内和整行注释、comment环境、条件编译块和自定义命令，保护隐私

  2. 02

    筛选文件

    从根tex出发迭代收敛引用闭包，剔除未被引用的tex文件和辅助文件

  3. 03

    处理图片

    按配置缩放图片最长边、用Ghostscript压缩PDF，可选将大PNG转JPG

  4. 04

    回写引用

    图片格式变化后用正则策略回写tex中的includegraphics引用路径

  5. 05

    输出发布包

    将全部清理产物输出到_arXiv目录，打包后即可上传arXiv系统

第一次这样开始

把仓库地址直接交给 AI

先让 AI 说明环境和风险，再完成最小安装验证。跑通以后，再把自己的真实材料放进去。

第一次直接复制

帮我安装这个库：https://github.com/google-research/arxiv-latex-cleaner
安装前先告诉我需要什么环境，安装后帮我跑通一个最小示例。

结果出来后

先看这些检查点

  • 清理后的tex文件是否仍能正常编译，确认没有误删关键命令或引用
  • 图片质量和分辨率是否满足期刊或arXiv的清晰度要求
  • 确认注释和条件块已被正确清理，无隐私泄漏风险
  • 确认_arXiv目录包含所有必需文件，未被误剔除被引用的资源

常见误区

这些判断仍由你负责

  • 未配置commands_to_delete列表导致私有命令和Todo注释保留在提交文件中
  • 未将非标准if命令加入if_exceptions清单，导致合法命令被误判为条件块开头
  • 运行前未检查_arXiv目录内容，被覆盖重建导致丢失需要保留的自定义文件
  • 在无Ghostscript的Windows环境启用compress_pdf，该功能只在Linux/Mac可用

技术依据

查看能力拆解、验证范围与来源

能力地图2 项已拆解能力
  1. 01

    LaTeX隐私清理

    把 LaTeX 论文工程中所有 .tex 文件里会泄漏私有笔记的内容（行内注释、整行注释、comment 环境、\iffalse/\iftrue/\if0 条件编译块、用户自定义命令、自定义环境、tikzpicture 源码、includesvg 调用、自定义快捷命令）删除或替换，输出不含可读私有痕迹的 .tex 文本。

  2. 02

    arXiv提交体积优化

    把 LaTeX 论文工程中未被引用的 tex 文件、未被引用的图片、辅助文件（.aux/.log/.out 等）和可选的 .bib 文件剔除，对被引用的图片按像素上限缩放、对被引用的 PDF 用 ghostscript 降分辨率压缩、对被引用的 PNG 按阈值转 JPG，并回写 tex 中的图片引用，输出一个体积适配 arXiv 50MB 限制的可打包 arXiv 目录。

能力主要输入主要输出人工检查

LaTeX隐私清理

源码已核对

  • 输入目录中的全部 .tex 和 .tikz 文件（含根目录和非根目录）。
  • CLI 参数或 cleanerconfig.yaml：
  • 清理后的 .tex 文件，写入 <inputarXiv/ 目录。
  • 这些 tex 文件供体积优化阶段的引用收敛使用（决定哪些文件和图片被保留）。
  • 用户必须确认 commandstodelete、commandsonlytodelete、environmentstodelete 列表，否则会误删论文正文命令或漏删私有命令。
  • 用户必须确认 ifexceptions 是否覆盖所用宏包的非 primitive \if 命令。
  • 用户必须确认 regex patternsandinsertions 不会误匹配正文。

arXiv提交体积优化

源码已核对

  • 输入目录（LaTeX 工程）或 .zip 包。
  • CLI 参数或 cleanerconfig.yaml：
  • 来自隐私清理阶段的 texcontents（已清洗的 tex 全文，用于引用匹配）。
  • <inputarXiv/ 目录，内含：
  • 该目录可直接 ZIP 后上传 arXiv。
  • 用户必须确认 imsize 和 pdfimresolution 是否满足目标体积和清晰度。
  • 用户必须确认 imagesallowlist 中高分辨率图片的豁免是否正确。
  • 用户必须确认 keepbib 是否需要保留 .bib（arXiv 有时要求）。

处理机制

  1. 01

    核心处理链

    一键清理LaTeX工程并优化体积，准备arXiv提交包

已核对范围

  • 静态读取 README.md、arxivlatexcleaner/arxivlatexcleaner.py 全文
  • 静态确认注释删除、条件块简化、命令删除、环境删除、TikZ/SVG/regex 替换的调用链
  • 静态确认 testdata/ 提供预期输出快照
  • 静态确认文件分流、引用收敛、图片缩放、PDF 压缩、PNG 转 JPG 及引用回写的调用链
  • 静态确认 testdata/ 提供 texarXivtrue 和 texarXivpng2jpgtrue 预期输出快照

仍待核对

  • 未安装依赖
  • 未运行 CLI
  • 未用真实论文工程验证 regex 边界
  • 未测试嵌套命令删除和跨行注释的极端情况
  • 未安装依赖（pillow、ghostscript）
  • 未验证 ghostscript PDF 压缩的实际效果
  • 未验证 PNG 转 JPG 后引用回写的正确性

读取版本

bcc1460cc4be72ddac08f22c54b23f23f14b102d

许可

Apache-2.0

最近核对

内容 2026-07-10
Stars 2026-07-11

已完成源码核对

相关文章

科研之我见

用 AI 写文献综述，怎样控制幻觉和证据断裂

把文献关系、核心文献筛选、方法矩阵和四类 Gap 分开处理，让综述中的每个判断都能回到具体材料。

查看内容

具备相关能力的其他库

文献 · 分析 · 写作

grobid

把学术论文PDF解析成结构化TEI XML，提取元数据、全文结构和参考文献

查看内容

文献 · 设计 · 分析 · 写作

Scientific-Agent-Skills

为AI科研代理提供文献检索、写作、统计、实验设计和同行评审的结构化能力。

查看内容

起步 · 文献 · 设计 · 验证 · 写作

Academic Research Skills

在Claude Code中将研究、写作、审稿和修订串成可追溯的学术论文全流程

查看内容