Peytontalismanic424/paper-share-skills

Lädt die TeX-Quelldateien (e-print tar.gz) eines arXiv-Artikels von einer arXiv-URL oder einer reinen ID herunter und entpackt sie in paper_src/. Verwende dies zuerst, wenn eine Pipeline-Eingabe ein arXiv-Link ist und der TeX-Quelltext dem PDF vorgezogen wird (paper-to-beamer, paper-to-bilibili, paper-venue-discovery).

Was ist paper-share-skills?

Dieser Skill ist der erste Schritt in jeder Pipeline, die mit einem arXiv-Link oder einer arXiv-ID arbeitet und den TeX-Quelltext (nicht nur das PDF) benötigt. Er lädt das e-print-Archiv (tar.gz) von https://arxiv.org/e-print/<id> herunter, entpackt es in ein `paper_src/`-Verzeichnis und gibt die Pfade der extrahierten TeX-Dateien aus. Damit werden nachgelagerte Skills wie `paper-to-beamer`, `paper-to-bilibili` und `paper-venue-discovery` unterstützt, die auf den strukturierten TeX-Quelltext angewiesen sind, um Tabellen, Gleichungen und Abbildungen präzise zu verarbeiten. Wenn kein TeX-Quelltext vorliegt (nur PDF), gibt der Skill `PDF_ONLY` aus, sodass die Pipeline auf den MinerU-basierten PDF-Pfad zurückfallen kann. Der Skill ist idempotent (überspringt Downloads mit `SKIP` bei wiederholten Ausführungen, sofern nicht `--force` gesetzt ist) und bricht bei Fehlern mit einer Nicht-Null-Exit-Code und einer `ERROR:`-Nachricht auf stderr ab.

Funktioniert mit~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/Peytontalismanic424/paper-share-skills/tree/HEAD/paper-download-arxiv-paper-source

Dokumentation

arXiv-Artikel-TeX-Quelltext herunterladen

Bei einem arXiv-Link oder einer reinen arXiv-ID den TeX-Quelltext des Artikels von https://arxiv.org/e-print/<id> herunterladen und für nachgelagerte Pipelines entpacken. Dies ist der erforderliche erste Schritt, sobald der Benutzer einen arXiv-Link angibt und der TeX- Quelltext (nicht nur das PDF) die Pipeline speisen soll — der TeX-Quelltext bewahrt Tabellen, Gleichungen und Abbildungen exakt und umgeht MinerU.

Verwendungszweck

Der Benutzer gibt eine arXiv-URL (arxiv.org/abs/…, arxiv.org/pdf/…, arxiv.org/e-print/…, export.arxiv.org/…) oder eine reine ID (2509.07996, 2509.07996v4) als Eingabe für eine beliebige Artikel-Pipeline an.
Ein verbrauchender Skill benötigt den Artikel-Quelltext auf der Festplatte (paper_src/), hat aber nur eine arXiv-Referenz.

Aufruf

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

--output standardmäßig das aktuelle Arbeitsverzeichnis der Sitzung.
--force lädt erneut herunter, auch wenn das Archiv bereits existiert.

Ausgabe-Vertrag

Im Ausgabeverzeichnis:

arXiv-<id>.tar.gz — heruntergeladenes E-Print-Archiv (gzip/tar).
paper_src/ — extrahierter TeX-Quelltext (abgeflacht, wenn das Archiv in einem einzigen obersten Verzeichnis verpackt ist; unsichere Mitglieder werden abgelehnt).
Nur-PDF-Einreichungen (kein TeX-Quelltext auf arXiv): stattdessen arXiv-<id>.pdf.
Einzeldatei-TeX-Einreichungen: stattdessen arXiv-<id>.tex.

Bei Erfolg endet stdout mit TEX_SOURCES: <durch Kommas getrennte relative Pfade> (oder PDF_ONLY: <absoluter PDF-Pfad>). Diese Zeilen konsumieren — niemals Dateinamen raten.

Idempotenz

Ein erneuter Aufruf mit derselben ID im selben Ausgabeverzeichnis überspringt den Download (stdout beginnt mit SKIP), sofern nicht --force angegeben ist; die Extraktion wird dennoch überprüft.

Fehlerfall

Exit-Code ungleich Null + ERROR:-Meldung auf stderr (Parsefehler, Netzwerkfehler, leerer Body, unerwartete Nutzlast, unsicheres Archivmitglied, kein .tex im Archiv). Die Pipeline muss anhalten und melden — niemals stillschweigend auf das PDF zurückfallen.

Fallback-Hinweis

Wenn das Skript PDF_ONLY: <Pfad> meldet, hat der Artikel keinen TeX-Quelltext auf arXiv. Verbraucher verwenden dann dieses PDF mit dem MinerU-Pfad (z. B. paper-to-beamer Phase 2's DECISION GATE) anstatt TeX zu lesen.

Verwendet von

paper-to-beamer Phase 1 (arXiv-Link/ID-Eingabe)
paper-to-bilibili Folienmodus (Einträge mit arxiv_id, kein lokaler Quelltext)
paper-venue-discovery Schritt 1 (Quelltext abrufen, wenn nur ein Link gegeben ist)