arXiv論文TeXソースのダウンロード は何をしますか?
arXivリンクまたはベアarXiv IDが与えられた場合、https://arxiv.org/e-print/<id> から論文の TeXソース をダウンロードし、下流パイプライン用に展開します。これは、ユーザーがarXivリンクを提供し、TeXソース(PDFだけでなく)をパイプラインに渡す必要がある場合の必須の最初のステップです。TeXソースはテーブル、数式、図を正確に保持し、MinerUをスキップします。
使用タイミング
- ユーザーがarXiv URL(
arxiv.org/abs/…、arxiv.org/pdf/…、arxiv.org/e-print/…、export.arxiv.org/…)またはベアID(2509.07996、2509.07996v4)を任意の論文パイプラインへの入力として提供した場合。 - コンシューマースキルがディスク上の論文ソース(
paper_src/)を必要としているが、arXiv参照しか持っていない場合。
呼び出し方法
uv run --no-project python \
"<SKILLS_DIR>/paper-download-arxiv-paper-source/scripts/download_source.py" \
"<arxiv-url|arxiv-id>" [--output DIR] [--force]
--outputはデフォルトでセッションのカレントワーキングディレクトリになります。--forceはアーカイブが既に存在する場合でも再ダウンロードします。
出力契約
出力ディレクトリ以下に生成されるもの:
arXiv-<id>.tar.gz— ダウンロードされたe-printアーカイブ(gzip/tar)。paper_src/— 展開されたTeXソース(アーカイブが単一のトップレベルディレクトリでラップされている場合はフラット化されます。安全でないメンバーは拒否されます)。- PDFのみの投稿(arXivにTeXソースがない場合):代わりに
arXiv-<id>.pdfが生成されます。 - 単一ファイルのTeX投稿:代わりに
arXiv-<id>.texが生成されます。
成功時、標準出力の末尾は TEX_SOURCES: <カンマ区切りの相対パス>(または PDF_ONLY: <絶対PDFパス>)で終わります。これらの行を消費してください。ファイル名を推測しないでください。
冪等性
同じ出力ディレクトリで同じIDを使用して再実行すると、ダウンロードはスキップされます(標準出力は SKIP で始まる)。ただし、--force が指定されている場合は除きます。展開は引き続き検証されます。
失敗時
エラー終了コードと、標準エラー出力への ERROR: メッセージ(解析失敗、ネットワーク障害、空のボディ、予期しないペイロード、安全でないアーカイブメンバー、アーカイブ内に .tex がない場合)。パイプラインは停止し、報告する必要があります。決して静かにPDFにフォールバックしてはいけません。
フォールバックに関する注意
スクリプトが PDF_ONLY: <path> を報告した場合、その論文はarXivにTeXソースがありません。コンシューマーは、そのPDFをMinerUパス(例:paper-to-beamer フェーズ2の判定ゲート)で使用し、TeXを読む代わりにします。
使用されるスキル
paper-to-beamerフェーズ1(arXivリンク/ID入力)paper-to-bilibiliスライドモード(arxiv_idを持つエントリ、ローカルソースなし)paper-venue-discoveryステップ1(リンクのみが与えられた場合にソースを取得)
関連スキル
- 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