Pipeline: Artigo → Slides Beamer
Dado um artigo (PDF ou fonte TeX), produzir uma apresentação Beamer compilada no tema SUSTech em
论文分享/<VENUE> - <SHORT_TITLE>/.
Variante do tema: \usetheme{sustech} (minúsculo, Variante A), de
https://github.com/yhbcode000/sustech-slides-template.git.
NÃO use \usetheme{SUSTech} (Variante B, usada no MT3) — tem macros
diferentes e não possui páginas separadoras de seção.
Proporção de aspecto padrão: aspectratio=1610 (16:10). NÃO use 169 (16:9) —
1610 é preferido para compatibilidade com laptop/projetor e oferece um pouco mais de
espaço vertical para conteúdo denso.
Runtime Bash: Todos os comandos shell são executados sob a ferramenta bash da sessão,
que no Windows é o Git Bash. Comandos Unix rm -rf, cp -r,
mkdir -p estão disponíveis. O diretório de trabalho é definido por bloco via cwd.
Requisitos (OBRIGATÓRIOS)
Todo slide deck DEVE satisfazer estas regras. Sem exceções, exceto onde indicado.
- Sem estouro de slide (rigoroso) — todos os slides DEVEM compilar sem avisos
Overfull \hboxouOverfull \vbox. Sigaskill://sustech-beamer-overflow: apenas coluna única, máximo 3 blocos + 1 callout, tabelas ≤5 colunas com\footnotesize, sem\resizebox. A ÚNICA exceção é a página de índice/TOC (layout\twopane) — um leve estouro vertical (Overfull \vbox) no quadro TOC é tolerado.
Fase 1 — Configuração do diretório
-
Aceite
$ARGUMENTS— um caminho de PDF, arquivo.tar.gzTeX ou arquivo.tex(absoluto ou relativo ao cwd da sessão), ou uma URL do arXiv / ID arXiv simples. -
Se a entrada for uma URL do arXiv ou ID simples (corresponde a
^\d{4}\.\d{4,5}(v\d+)?$ou contémarxiv.org/(abs|pdf|e-print)/), baixe a fonte TeX primeiro:uv run --no-project python \ "<SKILLS_DIR>/paper-download-arxiv-paper-source/scripts/download_source.py" \ "<arxiv-ref>" # saída padrão = cwd da sessão- Se stdout terminar com
TEX_SOURCES:: deriveDIR_NAME— veículo de\setsource{Venue}{Year}no TeX extraído depaper_src/(fallback\markboth, depoisarXiv <year>); título curto = primeiras 1–3 palavras significativas de\title{...}(fallback: pergunte ao usuário, regra existente). Entãomkdir -p "论文分享/<DIR_NAME>"emv arXiv-<id>.tar.gz paper_src "论文分享/<DIR_NAME>/". - Se stdout terminar com
PDF_ONLY: <path>: o artigo não tem fonte TeX no arXiv — copie esse PDF para论文分享/<DIR_NAME>/conforme o ramo.pdfabaixo (o caminho MinerU se aplica, Fase 2 DECISION GATE inalterada). - Se o comando sair com código diferente de zero: pare e reporte a mensagem de stderr ao usuário.
- Se stdout terminar com
-
Derive um nome de diretório curto
<VENUE> - <SHORT_TITLE>(entradas arXiv já derivaram na etapa 2):- Remova
.pdf/.tar.gz/.tgz/.tex, substitua espaços/hífens/caracteres especiais. - Pergunte ao usuário pelo nome se veículo/título não forem inferíveis do nome do arquivo.
- Convenção: exemplos existentes são
SCIENCE ROBOTICS - HIL SERL,SCIENCE ROBOTICS - MT3.
- Remova
-
Crie
论文分享/<DIR_NAME>/e extraia/copie a fonte lá (entradas arXiv já moveram o arquivo +paper_src/na etapa 2):.tar.gz/.tgz: extraia comtar -xzfparapaper_src/..pdf: copie diretamente para a raiz do diretório do artigo..tex: copie os arquivos fonte parapaper_src/.
Fase 2 — Extração de conteúdo
DECISION GATE: Se a fonte TeX estiver disponível (arquivo .tar.gz contendo .tex, ou arquivo .tex direto),
pule o MinerU completamente. Leia todo o conteúdo (título, autores, resumo, seções, tabelas, referências)
diretamente da fonte TeX usando read — é mais preciso que a saída do MinerU
e preserva estruturas de tabela exatamente.
Execute o MinerU apenas quando a entrada for um PDF sem fonte TeX disponível:
"$MINERU_PYTHON" \
"<SKILLS_DIR>/pdf-to-markdown/convert.py" \
"论文分享/<DIR_NAME>/<pdf_filename>.pdf" \
"论文分享/<DIR_NAME>/md_output" \
--lang en
- Artigos em inglês:
--lang en. Chinês/misto:--lang ch. - O wrapper imprime
DONE -> ...mdem caso de sucesso. - A saída vai para
md_output/<name>/auto/<name>.md.
Se o ambiente MinerU estiver ausente, pare e informe ao usuário para instalá-lo conforme
as instruções da skill pdf-to-markdown.
Fase 3 — Instalar o template empacotado
O pacote promovido paper-to-beamer é a fonte primária e offline do template:
uv run --project "<SKILLS_DIR>/paper-to-beamer" python \
"<SKILLS_DIR>/paper-to-beamer/scripts/copy_template.py" \
--output "论文分享/<DIR_NAME>/slides-template"
Isso copia o pacote verificado main_template.tex, latexmkrc e
sustech-theme/. Um clone de rede nunca é um fallback. Apenas quando o
usuário solicitar explicitamente uma atualização do template, o repositório upstream poderá ser
clonado em um diretório temporário separado para revisão antes do lançamento do pacote.
Fase 4 — Criar diretório de trabalho e copiar itens essenciais
# cwd: $PP_ROOT
mkdir -p "论文分享/<DIR_NAME>/slides-beamer"
cp -r "论文分享/<DIR_NAME>/slides-template/sustech-theme" \
"论文分享/<DIR_NAME>/slides-beamer/"
cp "论文分享/<DIR_NAME>/slides-template/latexmkrc" \
"论文分享/<DIR_NAME>/slides-beamer/"
cp "论文分享/<DIR_NAME>/slides-template/main_template.tex" \
"论文分享/<DIR_NAME>/slides-beamer/main.tex"
mkdir -p "论文分享/<DIR_NAME>/slides-beamer/figures"
Todas as edições subsequentes devem ter como alvo apenas slides-beamer/.
slides-template/ é mantido intacto como referência.
Fase 5 — Ler e extrair conteúdo
Quando a fonte TeX estiver disponível (preferencial — arquivo .tar.gz ou arquivo .tex):
leia o .tex principal de paper_src/ diretamente usando read. Todo o conteúdo
(título, autores, resumo, seções, tabelas, referências) é extraído da
fonte LaTeX estruturada. Tabelas podem ser recriadas diretamente de ambientes
tabular — sem necessidade de MinerU.
Quando apenas Markdown estiver disponível (entrada apenas PDF):
leia md_output/<name>/auto/<name>.md. Extraia estes pontos de dados:
Fase 6 — Preencher slides-beamer/main.tex
Esta é a fase criativa central. Leia main.tex (copiado do template),
depois edite-o seção por seção para substituir cada placeholder \ph{…} e
\phfig por conteúdo real do Markdown.
Use o exemplo HIL SERL como referência de estilo preenchido:
论文分享/SCIENCE ROBOTICS - HIL SERL/slides-beamer/main.tex.
6.0 Metadados do preâmbulo
\title[ACRONYM 论文分享]{Chinese descriptive title}— título chinês como principal; título curto DEVE incluir o sufixo "论文分享". Siga HIL SERL:\title[HIL-SERL 论文分享]{...}.\subtitle{English original paper title}— título original em inglês como subtítulo.\author[short]{…}— lista completa de autores do artigo.\institute[short]{…}— instituições principais.\setsource{Venue}{Year}— veículo do artigo.\setdomains{\domaintag{...}\domaintag{...}\domaintag{...}}— 3-4 tags de domínio de pesquisa exibidas na página de título como pills coloridas. Tags DEVEM estar em chinês (ex.:多智能体RL,LLM Agent,RL后训练). Termos em inglês comoMulti-Agent RL,RL Post-TrainingNUNCA são permitidos — parecem inconsistentes ao lado do texto chinês e quebram o estilo de apresentação bilíngue do tema SUSTech.\setpresenter{$PRESENTER}(padrão) ou pergunte ao usuário.\setvenue{<venue location>}(padrão: pergunte ao usuário).- Nota de rodapé da página de título
\creditline(padrão:哔哩哔哩 · 白拾的物理AI组会 · github.com/yhbcode000/sustech-slides-template). Para compartilhamento público/publicação de vídeos, recomenda-se manter; para apresentações/defesas que exigem layout limpo, adicione\hidecreditsno preâmbulo para desativar, ou\setcreditline{}para esvaziar,\setcreditline{...}para personalizar o texto.
Apague os macros auxiliares de placeholder \ph e \phfig — eles não são mais necessários.
6.1 首页 (Página de título)
O quadro \titlepage permanece como está. Os metadados do preâmbulo o controlam.
6.2 📑 目录页(TOC Aprimorado)
O template agora usa um layout de dois painéis \twopane (do tema). O painel esquerdo contém um TOC compacto via {\tocdense\small\tableofcontents[hideallsubsections]}. O painel direito contém três blocos:
\block{核心观察}— 3-5 métricas/insights principais do artigo\block{附录讨论}— 3-5 destaques do apêndice (sinal Oral, comparações, explicadores de método)\callout[一句话概括]— resumo do artigo em uma frase
O quadro separado 论文信息 é DELETADO. Título/veículo/autores já estão no preâmbulo. O resumo em uma frase vive no callout do TOC. Nenhum quadro de informações separado é necessário.
Espaçamento do TOC: Use {\tocdense\small\tableofcontents[hideallsubsections]} — \tocdense (do tema) compacta o espaçamento do TOC do beamer. Prefixe com \vspace{-0.6em} para puxar o conteúdo para cima, mais próximo do título.
Margem esquerda: O \tocdense do tema adiciona \hskip2em margem esquerda para um layout de TOC equilibrado.
6.3 👤 作者介绍 — VALIDAÇÃO CRUZADA ONLINE ANTES DE ESCREVER
CRÍTICO: Você DEVE pesquisar online por biografias de autores ANTES de escrever este quadro. Os PDFs dos artigos fornecem apenas nomes e afiliações — faltam nomes chineses, cargos atuais, trabalhos notáveis anteriores, nomes de laboratórios e reconhecimentos recentes. Entradas genéricas como "Universidade Tsinghua, primeiro autor" são INACEITÁVEIS.
Procedimento de pesquisa (execute ANTES de escrever o quadro):
- Escreva para
xd://web_searchcom{"query": "<primeiro autor> <instituição> <domínio do artigo>", "limit": 5}— obtenha nome chinês, cargo atual, trabalho anterior, laboratório. - Escreva para
xd://web_searchcom{"query": "<autor corr 1> <instituição>", "limit": 5}— o mesmo para cada autor correspondente. - Cruzar referências de pelo menos 2 fontes por autor. Prefira páginas pessoais ou Google Scholar.
- Pesquise também via
xd://web_searchcom{"query": "<instituição> <laboratório/prof> <domínio>", "limit": 5}para contexto do laboratório.
O que extrair dos resultados da pesquisa:
- Nome chinês (PDFs de artigos frequentemente não têm caracteres chineses)
- Cargo atual (professor assistente? estudante de doutorado? indústria? a afiliação do artigo pode estar desatualizada)
- Trabalho anterior notável (pelo que esta pessoa é conhecida? ex.: MAPPO, RLinf, GRPO)
- Nome do laboratório/grupo (ex.: EDI Lab, NICS-EFC, RAIL)
- Reconhecimentos recentes (artigos em grandes veículos, prêmios, cargos de liderança)
Preencha o quadro com biografias telegráficas e referenciadas:
\begin{frame}{作者介绍}
\begin{block}{核心作者}
\begin{itemize}
\item \shl{<primeiro autor>}(<chinês>):<departamento>, <cargo>. Conhecido por \keyword{<trabalho anterior>}. Neste artigo, <papel>.
\item Colaboradores de <instituições>, formando uma equipe <descrição>.
\end{itemize}
\end{block}
\tightgap
\begin{block}{通讯作者}
\begin{itemize}
\item \shl{<corr 1>}(<chinês>):<cargo> @ <inst>, PI do <lab>. Áreas de pesquisa: \keyword{<a1>}、\keyword{<a2>}.<trabalho notável>. Neste artigo, <papel>.
\item \shl{<corr 2>}(<chinês>):<cargo> @ <inst>, <lab>.<notável>. Neste artigo, <papel>.
\end{itemize}
\end{block}
\tightgap
\begin{callout}[研究脉络]
<trajetória da equipe levando a este artigo>.
\end{callout}
\end{frame}
6.4 📋 背景与动机
Mapeie para a seção 研究背景与动机 no template:
- Defina
\renewcommand{\secblurb}{…}(resumo de uma frase) antes de\section. - Preencha placeholders de bullet com motivação telegráfica do resumo/introdução.
- Mova a figura para um slide dedicado
[plain,c]após este slide de conteúdo:\fitfigure{fig1_overview.jpg}+\figcap{1}{legenda}. Remova o wrapper\begin{columns}— este slide permanece apenas texto. - Preencha
\metric{…}{…}com até 3 números-chave do artigo.
6.5 相关工作
Mapeie para a seção 相关工作:
- Liste áreas de pesquisa da seção de Trabalho Relacionado do artigo.
- Liste métodos de baseline reais e suas relações.
- Declare o principal diferencial no callout.
Se o artigo tiver uma seção clara "Related Work", use-a. Caso contrário, condense a partir de referências dispersas na introdução.
6.6 🔧 方法
Mapeie para a seção 方法 (2 quadros: visão geral + design central).
Quadro 1 (Visão geral):
- Liste componentes do sistema da seção de método do artigo.
- Mova a figura para um slide dedicado
[plain,c]após este slide de conteúdo:\fitfigure{fig2_system.jpg}+\figcap{2}{legenda}. Remova o wrapper\begin{columns}.
Quadro 2 (Design central):
- Liste até 4 elementos de design principais.
- Adicione um resumo de uma linha no callout.
6.7 🧪 实验设计
Mapeie para a seção 实验设计:
- Liste categorias de tarefas/conjuntos de dados.
- Declare o protocolo de avaliação e baselines.
- Mova a figura para um slide dedicado
[plain,c]após este slide de conteúdo:\fitfigure{fig3_tasks.jpg}+\figcap{3}{legenda}. Remova o wrapper\begin{columns}.
6.8 📈 结果与分析
Mapeie para a seção 实验结果 (2 quadros: tabela principal + análise).
Quadro 1 (Tabela principal):
- Recrie a tabela com dados reais do artigo.
- Mantenha ≤5 colunas, ≤6 linhas.
- Destaque os melhores resultados com
\shl{…}. - Use
\theadrow,\altrow,\thc{…}combooktabs. - Conclusão de uma linha no callout.
Quadro 2 (Análise):
- Análise em bullet points (3–4 observações).
- Figura de análise em um slide dedicado
[plain,c]após os bullets de análise.
6.9 💡 要点总结
Mapeie para a seção 要点总结 (corresponde a "核心贡献"):
- 3 takeaways principais enumerados.
- Resumo de uma frase no callout.
6.10 ⚠️ 局限与讨论
Mapeie para a seção 局限性:
- 3–4 limitações.
- Direções futuras identificadas pelos autores no callout.
6.11 📚 参考文献
Mapeie para o quadro 参考文献:
- Preencha entradas
bibitemcom referências reais do artigo. - O primeiro
bibitemdeve ser o próprio artigo (marcado(本文)). - Inclua 3–5 baselines principais.
6.12 💬 Q&A
Substitua o texto placeholder no quadro Q&A por:
- Nome do apresentador, instituição, informações de contato.
- Mantenha a estilização
Q&A(\fontsize{40}{44}etc.).
6.13 Manipulação de figuras
Para cada placeholder que precisa de uma figura:
- Fonte TeX disponível (preferencial): copie figuras de
paper_src/figures/paraslides-beamer/figures/com nomes semânticos:fig1_overview.pdf,fig2_system.pdf, etc. Fontes TeX usam figuras vetoriais.pdf— qualidade superior. - Markdown disponível: liste imagens de
md_output/<name>/auto/images/. Cada uma é um.jpgcom nome hash. Escolha a figura relevante inspecionando cominspect_imageou a partir das referênciasdo markdown. é APENAS para quadros de conteúdo onde a figura compartilha espaço com texto. - Coloque a figura em seu próprio slide dedicado — NUNCA dentro de um bloco
\begin{columns}:\begin{frame}[plain,c] \centering \includegraphics[height=0.92\textheight,width=\textwidth,keepaspectratio]{filename} \figcap{N}{texto da legenda} \end{frame}
Se uma figura estiver faltando ou não puder ser capturada, insira um callout placeholder em seu lugar
(o auxiliar \phfig foi deletado em 6.0, então NÃO o referencie