Télécharger la Source TeX d'un Article arXiv

Que fait Télécharger la Source TeX d'un Article arXiv ?

Étant donné un lien arXiv ou un ID arXiv brut, télécharge la source TeX de l'article depuis https://arxiv.org/e-print/<id> et la décompresse pour les pipelines en aval. C'est la première étape requise lorsque l'utilisateur fournit un lien arXiv et que la source TeX (pas seulement le PDF) doit alimenter le pipeline — la source TeX préserve les tableaux, les équations et les figures exactement et évite MinerU.

Quand l'utiliser

• L'utilisateur fournit une URL arXiv (arxiv.org/abs/…, arxiv.org/pdf/…, arxiv.org/e-print/…, export.arxiv.org/…) ou un ID brut (2509.07996, 2509.07996v4) comme entrée d'un pipeline d'article.
• Une compétence consommatrice a besoin de la source de l'article sur disque (paper_src/) mais ne dispose que d'une référence arXiv.

Invocation

uv run --no-project python \
  "<SKILLS_DIR>/paper-download-arxiv-paper-source/scripts/download_source.py" \
  "<arxiv-url|arxiv-id>" [--output DIR] [--force]

• --output par défaut : le répertoire de travail courant de la session.
• --force retélécharge même si l'archive existe déjà.

Contrat de sortie

Sous le répertoire de sortie :

• arXiv-<id>.tar.gz — archive e-print téléchargée (gzip/tar).
• paper_src/ — source TeX extraite (aplatie si l'archive s'emballe dans un seul répertoire de premier niveau ; les membres dangereux sont rejetés).
• Soumissions PDF uniquement (pas de source TeX sur arXiv) : arXiv-<id>.pdf à la place.
• Soumissions TeX à fichier unique : arXiv-<id>.tex à la place.

En cas de succès, stdout se termine par TEX_SOURCES: <chemins relatifs séparés par des virgules> (ou PDF_ONLY: <chemin absolu du pdf>). Consommez ces lignes — ne devinez jamais les noms de fichiers.

Idempotence

Réexécuter avec le même ID dans le même répertoire de sortie saute le téléchargement (stdout commence par SKIP) sauf si --force est donné ; l'extraction est toujours vérifiée.

Échec

Code de sortie non nul + message ERROR: sur stderr (échec d'analyse, échec réseau, corps vide, charge utile inattendue, membre d'archive dangereux, pas de .tex dans l'archive). Le pipeline doit s'arrêter et signaler l'erreur — ne jamais recourir silencieusement au PDF.

Note de repli

Si le script signale PDF_ONLY: <chemin>, l'article n'a pas de source TeX sur arXiv. Les consommateurs utilisent alors ce PDF avec le chemin MinerU (par exemple la PORTE DE DÉCISION Phase 2 de paper-to-beamer) au lieu de lire le TeX.

Consommé par

• paper-to-beamer Phase 1 (entrée lien arXiv/ID)
• paper-to-bilibili mode diapositives (entrées avec arxiv_id, pas de source locale)
• paper-venue-discovery étape 1 (récupération de la source quand seul un lien est donné)

Compétences associées

• skill://paper-to-beamer
• skill://paper-to-bilibili
• skill://paper-venue-discovery
• skill://paper-to-beamer-workflow
• skill://paper-bilibili-multi-part-series-upload
• skill://paper-bilibili-series-upload