Peytontalismanic424/paper-share-skills

Baixe o código-fonte TeX (e-print tar.gz) de um artigo do arXiv a partir de uma URL ou ID simples e descompacte-o em paper_src/. Use PRIMEIRO sempre que a entrada do pipeline for um link do arXiv e o código-fonte TeX for preferido ao PDF (paper-to-beamer, paper-to-bilibili, paper-venue-discovery). Execute com uma URL do arXiv (abs/pdf/e-print, arxiv.org ou export.arxiv.org) ou um ID simples como 2509.07996v4.

O que é paper-share-skills?

Esta skill baixa e extrai o código-fonte TeX de artigos do arXiv, permitindo que pipelines de processamento downstream (como paper-to-beamer, paper-to-bilibili e paper-venue-discovery) acessem tabelas, equações e figuras exatas preservadas no TeX, em vez de depender apenas da saída minerada do PDF. Ela suporta entradas como URLs completas do arXiv (abs, pdf, e-print, export) ou IDs simples (ex: 2509.07996v4), faz o download do arquivo e-print .tar.gz da API oficial e o descompacta em uma pasta `paper_src/`, rejeitando membros inseguros e achatando estruturas de diretório quando necessário. A saída é padronizada: no sucesso, exibe `TEX_SOURCES: <caminhos>` ou `PDF_ONLY: <caminho>` se não houver fonte TeX; no fracasso, retorna código de saída diferente de zero e mensagem de erro. É idempotente por padrão, evitando redownloads a menos que a flag `--force` seja usada, e é essencial como primeiro passo em qualquer pipeline que exija o código-fonte TeX a partir de um link do arXiv.

Funciona com~Claude Code~Codex CLI~Cursor

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

Documentação

Baixar Código-Fonte TeX de Artigo do arXiv

Dado um link do arXiv ou um ID simples, baixe o código-fonte TeX do artigo de https://arxiv.org/e-print/<id> e descompacte-o para pipelines downstream. Este é o primeiro passo necessário sempre que o usuário fornece um link do arXiv e o código-fonte TeX (não apenas o PDF) deve alimentar o pipeline — o código-fonte TeX preserva tabelas, equações e figuras exatamente e ignora o MinerU.

Quando usar

O usuário fornece uma URL do arXiv (arxiv.org/abs/…, arxiv.org/pdf/…, arxiv.org/e-print/…, export.arxiv.org/…) ou um ID simples (2509.07996, 2509.07996v4) como entrada de qualquer pipeline de artigo.
Uma skill consumidora precisa do código-fonte do artigo em disco (paper_src/) mas só tem uma referência do arXiv.

Invocação

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

--output assume como padrão o diretório de trabalho atual da sessão.
--force força o redownload mesmo se o arquivo já existir.

Contrato de saída

No diretório de saída:

arXiv-<id>.tar.gz — arquivo e-print baixado (gzip/tar).
paper_src/ — código-fonte TeX extraído (achatado se o arquivo estiver encapsulado em um único diretório de nível superior; membros inseguros são rejeitados).
Submissões apenas PDF (sem código-fonte TeX no arXiv): arXiv-<id>.pdf.
Submissões de TeX em único arquivo: arXiv-<id>.tex.

Em caso de sucesso, stdout termina com TEX_SOURCES: <caminhos relativos separados por vírgula> (ou PDF_ONLY: <caminho absoluto do pdf>). Consuma essas linhas — nunca adivinhe nomes de arquivos.

Idempotência

Reexecutar com o mesmo ID no mesmo diretório de saída ignora o download (stdout começa com SKIP) a menos que --force seja usado; a extração ainda é verificada.

Falha

Saída diferente de zero + mensagem ERROR: em stderr (falha de análise, falha de rede, corpo vazio, payload inesperado, membro de arquivo inseguro, nenhum .tex no arquivo). O pipeline deve parar e reportar — nunca recair silenciosamente no PDF.

Nota de fallback

Se o script reportar PDF_ONLY: <caminho>, o artigo não tem código-fonte TeX no arXiv. Consumidores então usam esse PDF com o caminho do MinerU (por exemplo, o GATE DE DECISÃO da Fase 2 do paper-to-beamer) em vez de ler o TeX.

Consumido por

paper-to-beamer Fase 1 (entrada de link/ID do arXiv)
paper-to-bilibili modo slides (entradas com arxiv_id, sem fonte local)
paper-venue-discovery etapa 1 (buscar fonte quando apenas um link é fornecido)

Skills relacionadas

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