ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

DeerFlow SLR 技能 BibTeX 引文模板全解析:为 arXiv 预印本生成规范、可直接编译的 LaTeX 引用

DeerFlow SLR 技能 BibTeX 引文模板全解析:为 arXiv 预印本生成规范、可直接编译的 LaTeX 引用 DeerFlow SLR 技能 BibTeX 引文模板全解析为 arXiv 预印本生成规范、可直接编译的 LaTeX 引用【免费下载链接】deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.项目地址: https://gitcode.com/GitHub_Trending/de/deer-flow本文围绕 DeerFlow 内置技能systematic-literature-review的 BibTeX 引文模板 展开。该技能面向系统文献综述SLR场景跨多篇论文检索 arXiv、结构化提取元数据、主题综合并按 APA / IEEE / BibTeX 三种风格输出报告。本文聚焦其中的 BibTeX 分支——从为什么 arXiv 必须用misc而非article这一最易踩坑的规则讲起逐字段拆解条目写法、继承报告骨架模板并结合 SKILL.md 与 arxiv_search.py 源码说清每个字段的数据来源与规范化逻辑。读完你可以理解为什么模板这样设计并能在实际综述报告里直接产出可复制进.bib文件的条目。一、模板在 SLR 工作流中的定位只在 Phase 4 读取一份模板先交代上下文。systematic-literature-review技能存放于 skills/public/systematic-literature-review/其目录结构为skills/public/systematic-literature-review/ ├── SKILL.md # 技能定义元信息 五阶段工作流 ├── scripts/ │ └── arxiv_search.py # arXiv 检索客户端输出结构化论文元数据 JSON ├── templates/ │ ├── apa.md # APA 7th 引文模板 │ ├── ieee.md # IEEE 数字序号引文模板 │ └── bibtex.md # BibTeX 引文模板本文主角 └── evals/ ├── evals.json └── trigger_eval_set.json按照 SKILL.md 的定义整条综述流程分成五个阶段Plan确认主题/范围/格式/输出位置→ Search arXiv检索→ Extract子代理并行抽取元数据→ Synthesize and format主题综合与格式化→ Save and present落盘与呈现。BibTeX 模板服务于 Phase 4 的格式化环节它决定两件事报告的引用正文写法\cite{key}与.bib条目的字段规范报告正文的结构骨架执行摘要、方法学、主题、共识与分歧、缺口、逐篇批注。需要强调的是 SKILL.md 中的一条纪律只读取与用户要求格式匹配的那一个模板文件而不是三个都读见 SKILL.md 的 Phase 4 小节。也就是说用户要 APA 或未指定格式 → 读 templates/apa.md用户投稿 IEEE 会议/期刊或明确要求 IEEE → 读 templates/ieee.md用户提到 BibTeX、LaTeX、natbib、biblatex或想要机器可读的参考文献 → 读 templates/bibtex.md。bibtex.md本身也明确了触发条件Use this template when the user mentions BibTeX, LaTeX, wants machine-readable references, or is writing a paper that will be typeset with a LaTeX citation style (natbib, biblatex, etc.)——即只要用户要做 LaTeX 排版论文、需要被 natbib/biblatex 解析的引用就走 BibTeX 分支。这一按需取单模板的设计也从 evals/evals.json 的评测用例中得到印证eval #2Survey recent papers on graph neural networks for drug discovery. 5 papers, BibTeX format.明确期望 The BibTeX template file (templates/bibtex.md) was read, not apa.md or ieee.md且输出条目必须是misc并带eprint、primaryClass字段。环境提示该技能作为 DeerFlow 的公开技能public skill分发运行时被挂载到沙箱的/mnt/skills下SKILL.md 中的检索命令即为python /mnt/skills/public/systematic-literature-review/scripts/arxiv_search.py ...。二、最关键的规则arXiv 论文必须用misc而不是article模板开头就用一个醒目的Critical段落给出本分支最核心、也最容易出错的规则arXiv 预印本必须写作misc绝不能用article。为什么这条规则被抬高到如此位置模板列出了三点原因字段契约不匹配article类型强制要求journal字段而 arXiv 不是期刊是预印本服务器。把 arXiv 写成journal {arXiv}在技术上就是错的部分书目样式bibliography style会因此报错或渲染不一致。misc才是预印本的正确归宿misc专门用于没有正式刊载渠道的文献如预印本、技术报告等它原生接受howpublished与eprint字段——eprint恰好是 arXiv 引用真正需要的承载字段。何时才能换回article/inproceedings只有当论文已经正式发表在同行评审的期刊/会议上且你手上有该出版渠道的元数据时才切换到对应类型。而在本技能的流水线中我们手上只有 arXiv 元数据因此始终输出misc。这一点同样被evals.json固化为验收标准The report contains BibTeX entries usingmisc, notarticle。在整条工作流里论文的唯一来源是 arXiv 检索见下节所以理论上不存在已经正式发表的信息路径——这与模板在本工作流中我们只有 arXiv 元数据永远输出misc的结论互为印证。三、逐字段拆解misc条目每个字段该填什么3.1 标准骨架与真实示例模板给出如下misc骨架misc{citekey, author {LastName1, FirstName1 and LastName2, FirstName2 and ...}, title {Title of the Paper}, year {YYYY}, eprint {ARXIV_ID}, archivePrefix {arXiv}, primaryClass {PRIMARY_CATEGORY}, url {https://arxiv.org/abs/ARXIV_ID} }并配了一个完全真实的例子字段值均来自该论文的 arXiv 元数据misc{vaswani2017attention, author {Vaswani, Ashish and Shazeer, Noam and Parmar, Niki and Uszkoreit, Jakob and Jones, Llion and Gomez, Aidan N. and Kaiser, {\L}ukasz and Polosukhin, Illia}, title {Attention Is All You Need}, year {2017}, eprint {1706.03762}, archivePrefix {arXiv}, primaryClass {cs.CL}, url {https://arxiv.org/abs/1706.03762} }第二个模板内示例devlin2018bert则展示了标题含专有名词时用双层花括号保护大小写的写法misc{devlin2018bert, author {Devlin, Jacob and Chang, Ming-Wei and Lee, Kenton and Toutanova, Kristina}, title {{BERT}: Pre-training of Deep Bidirectional Transformers for Language Understanding}, year {2018}, eprint {1810.04805}, archivePrefix {arXiv}, primaryClass {cs.CL}, url {https://arxiv.org/abs/1810.04805} }3.2 逐字段规范速查模板对每个字段都给出了精确规则汇总如下表字段规则示例引用键 cite key首作者姓年份标题首词全小写、无标点同一报告内必须唯一vaswani2017attentionauthor姓, 名 and 姓, 名 ...——作者之间用单词and不是逗号LaTeX 只认这一分隔符姓在前、逗号、再给名Vaswani, Ashish and Shazeer, Noam and ...特殊字符对 LaTeX 敏感字符转义或用花括号包裹如Łukasz→{\L}ukasz、é→{\e}不确定就把整个名字包进花括号以保留大小写Kaiser, {\L}ukasztitle含缩写/专有名词需保留大写时用双层花括号包住对应部分否则单层花括号即可title {{BERT}: ...}year取论文published字段中的 4 位年份2017eprint裸 arXiv 编号不带arXiv:前缀、不带版本后缀1706.03762archivePrefix字面量{arXiv}{arXiv}primaryClass取论文categories列表中的第一个类别论文的主学科如cs.CL、cs.CV、stat.MLcs.CLurl论文元数据里的完整abs_urlhttps://arxiv.org/abs/1706.037623.3 这些字段与 arXiv 检索脚本的输出一一对应bibtex.md里每个字段的取值规则都不是拍脑袋——把它们和 scripts/arxiv_search.py 的解析逻辑对照会发现模板字段规则 检索脚本输出的字段子集脚本把 arXiv Atom feed 的每个entry解析成含id / title / authors / abstract / published / updated / categories / pdf_url / abs_url的字典见 arxiv_search.py 的_parse_entry。misc条目中的author、title、year取自published、primaryClass取categories[0]、url取abs_url全部直接映射自这些输出字段无需再做外部检索。关于eprint必须是裸编号、无版本后缀的规则源码给出了更底层的证据arXiv 响应的id实际是完整 URL如http://arxiv.org/abs/1706.03762v5脚本为此专门写了_normalise_arxiv_id见 arxiv_search.py逻辑为先取出/abs/之后的部分兼容hep-th/9901001这类历史编号再剥离v\d版本后缀得到1706.03762。SKILL.md 的 Notes 里也再次强调Theidfield is a bare arXiv id (e.g.1706.03762), not a URL and not with a version suffix.——可见裸 id这一约定从检索阶段就被强制保证了。关于primaryClass脚本用显式的命名空间映射NS_MAP见 arxiv_search.py逐个读取atom:category的term属性得到categories列表模板据此要求取第一个类别作为主学科分类。这条检索脚本输出 → BibTeX 字段的对应链条正是模板能稳定产出可用条目的底层保障因为上游已经做好 URL 归一化、类别收集、日期切片下游只需按既定规则机械填充。四、BibTeX 报告的独特之处正文用\cite参考文献独立成.bib模板明确指出BibTeX 报告与 APA / IEEE 分支有两处结构性差异参考文献是独立的.bib文件正文用 LaTeX 风格的\cite{key}引用编译时由 bibtex/biblatex 解析该文件来生成参考文献表由于当前输出介质仍是 Markdown因此正文中把\cite{key}原样verbatim写出同时把全部.bib条目放在文末的一个 fenced code block 中方便用户直接复制存盘。对应的报告结构模板占位符用法保留自原文档如下# Systematic Literature Review: Topic **Date**: YYYY-MM-DD **Papers surveyed**: N **Scope**: arXiv search query, category, time window **Citation format**: BibTeX ## Executive Summary 3-5 sentences. Use \cite{key} form for citations, e.g. Transformer architectures \cite{vaswani2017attention} have become the dominant approach. ## Methodology This review surveyed N arXiv papers retrieved on YYYY-MM-DD using the query query, filtered to category cat, published between start_date and end_date. Metadata extraction was performed by language-model agents, with cross-paper synthesis performed by the lead agent. All citations in this report use BibTeX cite keys; the corresponding .bib entries are at the end of this document. **Limitations of this review**: arXiv preprints are not peer-reviewed; coverage is limited to arXiv. ## Themes ### Theme 1: Theme name Paragraphs describing the theme. Cite with \cite{key} form: The original transformer architecture \cite{vaswani2017attention} introduced self-attention, which was later extended in \cite{dai2019transformerxl}. ### Theme 2: Theme name ... ## Convergences and Disagreements **Convergences**: e.g. Multiple papers \cite{key1,key2,key3} agree that X is necessary. **Disagreements**: ... ## Gaps and Open Questions ... ## Per-Paper Annotations ### \cite{vaswani2017attention} — Attention Is All You Need (2017) **Research question**: 1 sentence **Methodology**: 1-2 sentences **Key findings**: - bullet - bullet - bullet **Limitations**: 1-2 sentences ### \cite{devlin2018bert} — BERT: Pre-training of Deep Bidirectional Transformers (2018) ... ## BibTeX Bibliography Save the entries below to a .bib file and reference them from your LaTeX document with \bibliography{filename}.该骨架与 APA 分支的结构见 apa.md同为 Executive Summary / Methodology / Themes / Convergences and Disagreements / Gaps / Per-Paper Annotations / References保持对齐只是把References 列表换成了BibTeX Bibliography 代码块把正文里的(Author, Year)文内引用换成了\cite{key}。这也与 SKILL.md 的要求一致报告必须do more than list papers至少要给出 3–6 个主题、跨论文的共识Convergences与分歧Disagreements、文献未覆盖的空白Gaps若论文集太杂不足以支撑主题综合要在报告里明说不许伪造主题。五、文末 BibTeX 代码块的正确打开方式报告结尾的 BibTeX Bibliography 小节把所有条目的集合放进一个bibtex语言围栏代码块真实落盘时为普通围栏模板文档里那对被转义的反引号只是模板本身也处于 Markdown 代码块中的自我嵌套处理misc{vaswani2017attention, author {Vaswani, Ashish and Shazeer, Noam and Parmar, Niki and Uszkoreit, Jakob and Jones, Llion and Gomez, Aidan N. and Kaiser, {\L}ukasz and Polosukhin, Illia}, title {Attention Is All You Need}, year {2017}, eprint {1706.03762}, archivePrefix {arXiv}, primaryClass {cs.CL}, url {https://arxiv.org/abs/1706.03762} } misc{devlin2018bert, author {Devlin, Jacob and Chang, Ming-Wei and Lee, Kenton and Toutanova, Kristina}, title {{BERT}: Pre-training of Deep Bidirectional Transformers for Language Understanding}, year {2018}, eprint {1810.04805}, archivePrefix {arXiv}, primaryClass {cs.CL}, url {https://arxiv.org/abs/1810.04805} } ... more entries, one per paper ...使用方拿到这份报告后的落地流程很直接把该代码块整体复制保存为report-name.bib在 LaTeX 主文档中用\bibliography{filename 不带 .bib}声明引用库正文中已有的\cite{key}即会在编译时与.bib中的键一一解析若使用 biblatex可用\addbibresource{filename.bib}加载。由于条目类型被统一为misc且eprint/archivePrefix/primaryClass/url齐备natbib、biblatex 及绝大多数 arXiv 感知的书目样式都能正确渲染成带 arXiv 编号与链接的引用条目。六、定稿前的质量检查清单模板在末尾给出了一份 check 清单用于任何一份报告落盘前逐项核对。它既是给 LLM 自检用的也可以视为BibTeX 正确性的可执行定义每条文献都是misc而非article本工作流只有 arXiv 元数据引用键在同一报告内唯一引用键符合首作者姓年份标题首词规则且全小写author字段作者之间使用单词and而非逗号作者名中的 LaTeX 特殊字符已转义或用花括号包裹eprint是裸 arXiv 编号无arXiv:前缀、无版本后缀primaryClass取自论文第一类别正文每个\cite{key}都在参考文献区有对应的misc条目无悬空引用参考文献区整体置于bibtex围栏代码块内方便用户直接复制进.bib文件。对照 evals.json 中 BibTeX 场景的评测期望读取 bibtex 模板而非其他两者、输出misc、每条含eprint与primaryClass、报告含主题综合而非逐篇罗列可以看出这份清单同时就是评测通过标准的外化——清单里的每一项几乎都能在评测的expectations里找到对应断言。七、从模板到生产级使用几点实操建议结合上游工作流再给几个让 BibTeX 分支真正好用的注意点键命名先行全报告一致cite key 规则姓年标题首词如vaswani2017attention应在 Phase 4 综合阶段就贯穿正文\cite与文末.bib一旦键不一致就会产生悬空引用——这正是检查清单第八条要拦截的失败模式。title大小写保护只针对必需处像{BERT}: ...这样仅在首个缩写处用双层花括号即可不要把整个标题都套双层括号否则会影响部分样式对标题的句首大写化处理。作者特殊字符宁可过度保护模板的建议是不确定就把该名字整个用花括号包起来例如{Łukasz}。这样做牺牲一点排版灵活性换取 BibTeX 解析绝不报错。不要拿pdf_url当url模板要求url取abs_url论文摘要页。APA 模板的质量检查里也写了 arXiv URLs use theabs_urlform... notpdf_url两种格式对读者/审稿人的体验差别明显。数据来源单一化author/year/primaryClass/eprint/url全部来自arxiv_search.py输出的同一条元数据不要混入人工记忆或二手信息——这正是本技能只在 arXiv 检索、绝不复造元数据纪律的自然延伸。结语DeerFlow 的 bibtex.md 模板 篇幅不长却精确地封住了 arXiv 引用最常见的两个坑类型用错articlevsmisc与字段填错eprint是否裸编号、primaryClass取哪一类别、作者分隔符用不用and。它在技能五阶段流水线中承上启下——上游arxiv_search.py的原子字段设计让裸 id / 首类别 / abs_url等约定从源头成立模板再把它们翻译成 LaTeX 生态认可的misc语法下游用独立的.bib代码块交付确保每份综述报告都能被 natbib/biblatex 直接消费。需要 APA 或 IEEE 风格时读者可以分别对照同目录下的 apa.md 与 ieee.md并在 SKILL.md 查看完整的工作流约束与使用边界。【免费下载链接】deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.项目地址: https://gitcode.com/GitHub_Trending/de/deer-flow创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表