Sources → Refs：参考文献
Refs 存放 BibTeX 条目——你要引用的文献的元数据。对应项目里的 sources/refs/ 目录。
Docs 和 Refs 的分工：Docs 是「文章本身」（PDF 全文），Refs 是「怎么引用它」（作者、年份、期刊、DOI）。理想状态下两者一一配对。
把条目放进来
底部 + 菜单：
| 来源 | 说明 |
|---|---|
| BibTeX file (.bib)… | 导入 .bib 文件 |
| RIS / EndNote file (.ris)… | 导入 RIS 格式，自动转成 BibTeX |
| From clipboard (BibTeX) | 从剪贴板粘贴一段 BibTeX |
| External sources… | 通过 agent 检索外部文献库 |
也可以在 Docs 里右键一篇文档 →「Add to References」，直接为它生成条目。
配对提示条
Refs 列表顶部有一条横幅：「Docs 和 refs 应当一一配对，展开查看并解决缺口。」
展开后按状态分类列出：
| 状态 | 含义 | 可用动作 |
|---|---|---|
| linked | 已配对 | —— |
| unmatched | 有条目但没有对应全文 | Attach（找并下载全文） |
| need review | 自动匹配了但不确定 | Link / Ignore |
| downloaded | 刚下载好全文 | —— |
| failed | 查找失败 | —— |
Attach 会拿条目里的 DOI 去查开放获取的全文（走 Unpaywall），找到就下载进 Docs 并建立关联。条目没有 DOI 时这个动作不可用——先把 DOI 补上。
反方向也有：Docs 里有全文但 Refs 里没条目时，横幅提供 Generate 直接生成条目。
打开一条条目
点击一行，在中间栏打开 BibTeX 编辑器。
工具栏上：
- Citation style——选 CSL 引用样式（APA、MLA、Chicago 等），上方的引用文本会按所选样式实时重渲染
- Reference type——改 BibTeX 条目类型（
@article、@inproceedings…） - Fill missing fields——按 DOI 或标题去 Crossref / Semantic Scholar / OpenAlex 补全缺失字段
- Find and link an attachment——查找并关联全文（需要条目有 DOI，且当前只选中一条）
- Preview the linked document——跳到已关联的全文
- Import the references this work cites——把这篇文章引用的参考文献批量导入（见下）
引用样式的渲染细节见 引用管理。
导入一篇文章引用的参考文献
「Import the references this work cites」会取这篇文献的引文列表，让你勾选后批量导入成新条目。
数据源限制
引文列表来自出版方提交给 Crossref 的数据，覆盖度取决于出版方。有些出版商（如 ACS）只提供 DOI 不提供完整元数据，arXiv 预印本通常一条都没有。导入前列表会告诉你实际拿到多少条。
排序与筛选
排序：Created · Modified · Title · Year
按条目类型筛选：All · Journal article · Conference · Book / chapter · Thesis · Other
条目类型从 BibTeX 的 @type 读取。还没被索引到的条目只在「All」下出现。
阅读队列与分组
和 Docs 一样，Refs 也支持阅读队列和文件分组，行为完全一致——见 Docs。
多选
Cmd / Shift 多选若干条目后打开，会得到一个聚合预览：所有选中条目按当前引用样式一起渲染，可以整段复制进论文的参考文献部分。
深入
- 引用管理——CSL 样式、写作时插入引用、生成参考文献表