文献技能(检索 + 阅读/综述 + 引用 + BibTeX)
模式选择
模式 适用场景 输出/动作
多源检索与题录合并(推荐前置) 多数据库导出 RIS/Bib、可重复检索说明、合并去重 见 references/multi-source-retrieval.md;可选 scripts/dedupe_bibtex.py
检索 「找文献」「关键词扩展」「Zotero 检索」 扩展关键词、检索结果列表、可选脚本 zotero_searcher / zotero_export_bibtex
阅读与综述 「读这篇 PDF」「总结文献」「综述重写」「related work 素材」 阅读笔记、横向比较、综述段落、BibTeX(改写模式)
插入引用 「给这段加引用」「插入 \cite{}」「润色引用句」 润色后的 LaTeX 段落含 \cite{key} 或 \cite{key1,key2}
生成 BibTeX 「把参考文献列表转成 BibTeX」「生成 .bib」 BibTeX 条目、简称规则见 references
根据用户表述选择模式;可串联(如 多源合并去重 → 检索/阅读 → 插入引用 → 生成 BibTeX)。读取 PDF 时联动 pdf 技能。
系统综述(纳入/排除标准、PRISMA 流程记录)请使用 systematic-review-lite 技能,与本书写类模式互补。
非 Zotero / 纯 Word 管线见 references/non-zotero-bibliography.md。
目录占位符与环境变量见仓库根目录 README.md(默认 {{THESIS_DIR}}/references/zotero.bib)。
多源检索与题录合并(与「检索」模式配合)
当需要从多个数据库可重复地构建题录池时:
在各库使用记录的检索式导出 RIS 或 BibTeX;
合并为单一 .bib(或先导入 Zotero 再导出);
按 DOI 或「规范化标题 + 年份」去重(见 multi-source-retrieval.md);
再进入下方「检索 / 阅读与综述」等模式。
多个 .bib 文件合并且需命令行去重时,可使用 scripts/dedupe_bibtex.py。
一、检索模式
关键词扩展:同义词、中英文对应、领域术语、组合查询。
检索方式:语言能力检索 或 脚本(Zotero 本地 API)。脚本见本技能 scripts/zotero_searcher.py、scripts/zotero_export_bibtex.py;API 默认 http://localhost:23119/api/,鉴权可用环境变量 ZOTERO_LOCAL_API_KEY。
输出:结构化检索结果(高/中/低相关)、扩展关键词列表。导出 BibTeX 时写入 {{THESIS_DIR}}/references/zotero.bib(默认即 论文章节/references/zotero.bib,按 citekey 去重)。
检索流程与关键词扩展、相关性排序等详见原 literature-search 设计;脚本用法见下方「脚本」节。
二、阅读与综述模式
阅读模式:对单篇/多篇 PDF 提取元数据、主旨、方法、结论、与本文相关性、启发性信息;多篇时做横向比较与综合结论。输出结构参考 references/output-template.md。
改写模式:综述草稿→规范学术综述,保留引用、补充文献、优化结构、输出 BibTeX。技术要点见 references/rewriting-workflow.md。
端到端模式:阅读结果→可插入论文的综述段落,标明可插入位置与 \cite{} 线索。
PDF 正文提取使用 pdf 技能。不编造 DOI/期刊/作者/结果;与当前论文相关性需显式判断。
三、插入引用模式
引用类型:直接引用、间接引用、多项引用;带页码 \cite[p. 10]{key}、带章节 \cite[Chapter 3]{key}。
格式:\cite{key}、\cite{key1, key2};润色句首句尾使衔接自然,符合学术规范。
Zotero 自动补引:用户提供 Zotero API 且要求「对段落加文献依据」时,用 scripts 检索→导出 BibTeX→在句末插入 \cite{} 并润色。
详见 references/citation-formats.md、references/language-polishing.md、references/citation-examples.md。
四、生成 BibTeX 模式
输入:参考文献列表(中/英/混合);若来自 PDF 阅读或用户提供全文/摘要,一并作为摘要来源。
简称规则:英文 作者首字母+年份+中文关键词;中文 作者姓氏首字母+年份+中文简称。见 references/abbreviation-rules.md、references/bibtex-types.md。
输出:完整 .bib 条目,含 note 字段(中文简称/英文原名)。尽量附带摘要:在生成每条 BibTeX 时,(1) 若有文献自带摘要或用户/阅读笔记提供的摘要,则在 note 中增加「摘要: …」;(2) 若无现成摘要但可读取原文(如 PDF 正文、已提取文本),则从原文中总结 1~2 句话作为摘要写入 note;(3) 仅当既无摘要又无法读取原文时不写摘要,不编造内容。类型:article、inproceedings、phdthesis、book、techreport 等。
详见 references/conversion-examples.md、references/bibtex-types.md 中关于 note 与摘要的约定。
参考文档汇总
references/multi-source-retrieval.md:多库导出、合并与去重
references/non-zotero-bibliography.md:EndNote/Mendeley/Word 等与 LaTeX 混用
references/output-template.md:阅读模式输出模板
references/rewriting-workflow.md:综述改写流程与引用处理
references/citation-formats.md:引用格式
references/language-polishing.md:引用句润色
references/citation-examples.md:插入示例
references/bibtex-types.md:BibTeX 类型
references/abbreviation-rules.md:简称规则
references/conversion-examples.md:Bib 转换示例
脚本
scripts/zotero_searcher.py:Zotero 本地库检索(--query、--expand、--limit、--base-url、--api-key)。
scripts/zotero_export_bibtex.py:按 item-key 导出 BibTeX 到指定 .bib(--bib-path、--item-key 可多次)。
scripts/dedupe_bibtex.py:合并多个 .bib 并按 DOI / 标题+年份去重(无网络依赖,见脚本 --help)。