arXiv 논문 TeX 소스 다운로드은(는) 무엇을 하나요?
arXiv 링크 또는 bare 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/…) 또는 bare 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: <comma-separated relative paths>(또는 PDF_ONLY: <abs pdf path>)로 끝납니다. 이러한 행을 사용하십시오. 파일 이름을 추측하지 마십시오.
멱등성
동일한 ID로 동일한 출력 디렉토리에서 다시 실행하면 다운로드를 건너뜁니다(표준 출력이 SKIP으로 시작) — --force가 제공되지 않는 한; 추출은 계속 확인됩니다.
실패
0이 아닌 종료 코드 + stderr의 ERROR: 메시지(구문 분석 실패, 네트워크 실패, 빈 본문, 예상치 못한 페이로드, 안전하지 않은 아카이브 멤버, 아카이브에 .tex 없음). 파이프라인은 중단되고 보고해야 합니다 — PDF로 자동 대체되지 않습니다.
대체 참고 사항
스크립트가 PDF_ONLY: <path>를 보고하면, 논문에 arXiv에 TeX 소스가 없다는 의미입니다. 소비자는 TeX을 읽는 대신 MinerU 경로(예: paper-to-beamer 2단계의 DECISION GATE)와 함께 해당 PDF를 사용합니다.
사용 대상
paper-to-beamer1단계 (arXiv 링크/ID 입력)paper-to-bilibili슬라이드 모드 (로컬 소스 없이arxiv_id가 있는 항목)paper-venue-discovery1단계 (링크만 주어졌을 때 소스 가져오기)
관련 스킬
- 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