导入文献
将 Zotero 中选中的文献或整个收藏分类导入攻玉学术个人收藏夹，并按需一并上传本地 PDF。
想把 Zotero 中已经整理好的文献用于攻玉学术的研究工作时，可以选择少量条目，也可以导入整个收藏分类。文献信息进入个人收藏夹后，便于在网页端继续查找和整理。
选择导入范围
| 你的任务 | Zotero 中的准备 | 插件中的操作 |
|---|---|---|
| 只带入本次需要的几篇文献 | 在中间的条目列表中选中文献 | 上传选中条目 |
| 带入一个主题下的文献 | 在左侧选择对应收藏分类（Collection） | 预览收藏夹内容，再上传整个收藏夹 |
插件界面中的“收藏夹”也用于指代 Zotero 的收藏分类。保存到攻玉收藏夹 则是导入后的目标位置，请在开始前分别确认来源和目的地。
完成一次导入
连接账号并选择保存位置
先完成 连接攻玉账号。在插件打开 连接攻玉 → 文献同步，点击 刷新收藏夹，在 保存到攻玉收藏夹 中选择目标。
核对范围并上传
回到 Zotero 主窗口选中条目或收藏分类，再到插件确认 Zotero 主窗口中的选择。上传整个收藏夹 会包含该分类及其子分类中的文献，请先点击 预览收藏夹内容 检查范围。
点击 上传选中条目 或 上传整个收藏夹，等待结果显示。
在攻玉学术查看结果
打开攻玉学术的 个人工作区 → 收藏夹，进入所选目标，检查条目与 PDF 状态，继续进行分类和阅读。
看懂导入结果
文献信息和 PDF 分别处理，因此条目成功导入时，PDF 仍可能被跳过或上传失败。结果中会分别显示两部分的完成情况。
如果条目存在但没有全文，先在 Zotero 确认本地附件可读取，再检查是否勾选上传 PDF，以及攻玉账号的存储空间是否充足。已有或无需重复处理的内容可能显示为跳过，请结合目标收藏夹中的实际状态判断。
导入后的文献如何管理
从 Zotero 单向导入攻玉学术
插件虽然将入口命名为“文献同步”，当前操作是 Zotero → 攻玉学术的单向导入。你在攻玉学术中整理、修改或删除内容，不会写回 Zotero；本次导入也不会删除或修改 Zotero 原有文库。
这项操作用于带入文献信息及按需上传的本地 PDF。Zotero 的账号同步、机构访问权限和原始文件下载仍按各自服务的规则进行。