Folio 的全部用法。

开始使用

安装、第一次打开和界面。

Folio 不需要注册账号。所有内容都保存在你自己电脑上的一个文件夹里。

安装

从 GitHub 发布页 下载对应系统的安装包。

• Mac 打开 .dmg，把 Folio 拖进“应用程序”文件夹。第一次打开时，如果提示“无法验证开发者”，打开 系统设置 ▸ 隐私与安全性，在页面底部点 仍要打开；也可以在终端运行：

  xattr -dr com.apple.quarantine /Applications/Folio.app

• Windows 运行安装程序。出现“Windows 已保护你的电脑”时，点 更多信息 ▸ 仍要运行。Windows 版依赖系统自带的 WebView2，缺少时安装程序会自动补装。

欢迎向导

第一次打开时会出现一个简短的向导。每一步都可以跳过，之后也都能在设置里更改。向导会依次帮你：

1. 从 Zotero 导入：如果在电脑上找到了 Zotero 文献库，可以一键导入条目、PDF、分组和标签。Folio 只读取 Zotero 数据库的副本，不会修改 Zotero，两个软件可以同时使用。
2. 安装浏览器插件：在默认浏览器里装好 Folio 插件，之后可以在论文网页上一键保存。
3. 让 AI 智能体使用你的文献库：为电脑上已安装的智能体（Claude Code、Codex 等）添加 Folio 的 MCP 服务器和技能。
4. 设置整篇翻译：选择翻译服务。翻译引擎是内置的，不需要另外下载。

没做完的步骤，下次打开时会继续。之后可以随时从 帮助 ▸ 欢迎使用 Folio… 再打开向导；Windows 上在 设置 ▸ 通用 ▸ 帮助 里。

界面

左栏和检查器都可以隐藏：显示 ▸ 显示/隐藏边栏 和 显示/隐藏检查器，或者用工具栏两端的按钮。

文献库与同步

文献库就是一个文件夹。

论文的 PDF、批注、笔记和译文都存放在文献库文件夹里，条目信息存在同一文件夹的数据库文件中。

位置

默认在用户目录下的 Folio 文件夹。在 设置 ▸ 文献库 ▸ 文献库位置 里可以：

• 在 Finder / 资源管理器中显示：打开这个文件夹。
• 更改…：选择新位置，Folio 会把整个文献库移动过去。
• 打开其他文献库…：切换到另一个已有的文献库文件夹；如果选的文件夹还不是文献库，可以在那里新建一个空的。

Mac 版和 Windows 版的文献库格式完全相同，可以互相打开。

在多台电脑之间同步

1. 在第一台电脑上，把文献库位置改到同步盘（iCloud 云盘、OneDrive、坚果云、Dropbox 等）里的一个文件夹。
2. 等同步盘把文件全部上传完。
3. 在另一台电脑上安装 Folio，在 设置 ▸ 文献库 ▸ 打开其他文献库… 里选择同一个文件夹。

文件命名

设置 ▸ 文献库 ▸ 检索到元数据后按「作者_年份_标题」重命名文件：打开后，识别出论文信息时会自动重命名 PDF，例如 Li_2026_SnakeSAM - A topology-preserving....pdf。默认打开。

译文文件的名字里会写明内容、语言和翻译服务，例如“论文（简体中文译文 · DeepSeek · deepseek-chat）.pdf”“论文（双语对照 · Google）.pdf”。同一服务和模型翻译了两次、并选择保留两份时，名字后面会再加上翻译时间。

回收站

• 删除的文献（右键 ▸ 删除，或 ⌘⌫ / Delete）先放进回收站，可以右键 ▸ 恢复。在某个分组里时，Windows 上 Delete 只把文献移出这个分组，Shift Delete 才移到回收站。
• 在回收站里右键 ▸ 彻底删除，或在左栏回收站上右键 ▸ 清空回收站…，会永久删除文献和文件，无法恢复。
• 设置 ▸ 文献库 ▸ 自动彻底删除回收站中超过 30 天的内容：默认打开。

隐私

Folio 不收集任何使用数据。只有这几件事会联网：识别论文信息、翻译（内容只发给你选的服务）、查询期刊指标、检查更新。API Key 等密钥在本机加密保存，不会写进文献库，也不会随同步盘上传。

添加文献

把论文放进来，信息自动补全。

添加 PDF 后，Folio 会自动查出标题、作者、期刊、卷期页、年份、出版社、DOI 和摘要，不需要手动填写。

添加方式

论文信息是怎么查出来的

Folio 先在 PDF 里找 DOI 或 arXiv 编号，再到 Crossref、arXiv、OpenAlex 等公开数据源查询完整信息。PDF 里找不到标识符时，如果打开了“使用 Zotero 识别服务”，会把前 5 页的文字发给 Zotero 的识别服务来认出论文。

查询时，标题旁边会显示一个转圈的图标。查不到时，条目会保留为“独立文件”，标题就是文件名，检查器里显示“未检索到元数据，已保留为独立文件”。网络不通时显示“网络不可用，恢复后会自动重试”。

识别不准或没识别出来时

• 右键 ▸ 重新检索元数据（⌥⌘R / Ctrl Alt R）：重新查一遍。
• 右键 ▸ 手动匹配…：输入 DOI、arXiv 编号或论文标题，按回车搜索，从结果中选出正确的那一篇，点 使用所选结果。
• 直接在检查器的“信息”页里修改：每个字段都可以点开编辑；作者点 编辑作者，可以分别填写姓和名、添加或删除作者、调整顺序；文献类型可以从下拉列表里换（期刊论文、会议论文、预印本、图书、学位论文等）。
• 扫描版 PDF 里没有文字，先右键 ▸ 识别文字（OCR），识别完成后再重新检索。

一篇论文有多个文件

一个条目可以附带多个文件，例如原文、译文、补充材料。右键 ▸ 添加文件…，或在检查器“信息”页底部的“文件”区域里点 添加文件…。在文件上右键可以 设为默认打开文件（双击条目时打开它），或在 Finder / 资源管理器中显示。

整理文献

分组、标签、状态和搜索。

一篇论文可以同时属于多个分组、带多个标签，文件只有一份。

分组

• 新建：左栏“分组”旁的 +，或 ⇧⌘N / Ctrl Shift N。在分组上右键 ▸ 新建子分组，子分组的层数不限。
• 加入分组：把文献拖到左栏的分组上；或者右键 ▸ 添加到 ▸ 选择分组；或者在检查器“信息”页的“分组”一栏点 +。
• 移出分组：在分组里选中文献，右键 ▸ 从当前分组移除。文献仍留在文献库里。
• 重命名、删除：在分组上右键。删除分组时可以选择只删除分组（文献保留在文献库中），或连同其中的文献一起移到回收站。
• 调整位置：在左栏拖动分组，可以排序，也可以拖进另一个分组变成子分组。
• 未分组：左栏“未分组”列出还没放进任何分组的文献，方便整理新加入的论文。

设置 ▸ 通用 ▸ 父分组中显示子分组的条目：打开后，点父分组时会同时列出所有子分组里的文献。

标签

• 添加：右键 ▸ 标签 ▸ 勾选；或在检查器“信息”页的“标签”一栏点 +，输入名称搜索已有标签，或直接新建。
• 颜色：新建或编辑标签时，可以选择红、橙、黄、绿、薄荷、青、蓝、靛、紫、粉，或自定义颜色；也可以不设颜色。在左栏标签上右键 ▸ 颜色 可以直接换。
• 按标签筛选：点左栏的标签，列出带这个标签的所有文献。
• 改名、删除：在左栏标签上右键 ▸ 编辑标签… 或 删除标签…。删除标签不会删除文献。

阅读状态与评分

• 阅读状态：未读、在读、已读。在右键 ▸ 阅读状态，或检查器“信息”页里设置。设置 ▸ 通用 里的“打开未读的论文时，标为‘在读’”默认打开。
• 评分：一到五星。在右键 ▸ 评分，或检查器里点星星设置。

搜索

• 工具栏的搜索框（⌘F / Ctrl F）按标题、作者、来源、年份、标签、DOI 等查找，输入即筛选。
• 搜索范围是左栏当前选中的分组或标签；点“所有文献”后再搜，就是搜整个文献库。Mac 上也可以用 编辑 ▸ 查找 ▸ 在全部文献中搜索 直接扩大范围。
• 打开“搜索包含 PDF 全文”后，也会搜索论文正文。扫描件要先识别文字才能被搜到。

列表的列与排序

• 在列标题上右键，选择要显示的列：标题、来源、作者、年份、分区、影响因子、标签、添加日期、修改日期、评分、阅读状态、类型、卷、期、页码、出版社、引用键、文件数等。
• 点列标题按这一列排序，再点一次反向。拖动列标题的边缘可以调整列宽。
• 右键 ▸ 按自定义顺序排列：之后可以直接拖动行来排列顺序。

一眼看出哪些已翻译

有译文的论文，标题后面带一个绿色的 已翻译 标签，悬停可以看到具体有哪些译文，见翻译全文。

快速查看

选中论文后按 空格，不打开阅读器就能翻看 PDF；再按一次或按 Esc 关闭。Windows 上也可以用鼠标中键点按。

批量操作

按住 ⌘ / Ctrl 点选多篇，或按住 ⇧ / Shift 选一段，然后右键。加入分组、加标签、设置阅读状态和评分、复制引用、导出、翻译、重新检索和删除，都可以一次作用于所有选中的论文。

检查器

一篇论文的全部信息。

选中论文后，右栏的检查器显示它的详细内容，分为三页。

同时选中多篇时，检查器显示“已选择 N 项”。

阅读 PDF

在标签页里读论文。

双击论文（或选中后按回车），它会在 Folio 的阅读器里打开，每篇论文一个标签页。

打开方式

• 右键 ▸ 打开方式：可以临时用系统默认应用或其他应用打开。
• 设置 ▸ 通用 ▸ 打开 PDF 时使用：选择 Folio 阅读器、系统默认应用，或指定一个应用。改成外部应用后，批注等功能就在那个应用里使用。
• 设置 ▸ 通用 ▸ 启动时重新打开上次的论文标签页：默认打开。

翻页与跳转

• 滚动浏览；在左栏点缩略图或目录跳到对应位置。
• 前往页面…（⌥⌘G / Ctrl Alt G）：输入页码直接跳转。标题下方显示“第 N / M 页”。
• 后退、前进（⌘[ ⌘]）：点了文中的引用或图表链接后，可以回到原来的位置。

显示

• 工具栏最左边的 显示 菜单：放大、缩小、实际大小、适合页宽，以及单页连续或双页连续。
• 设置 ▸ 阅读 里设置首次打开时的缩放（适合页宽或实际大小）、默认的显示方式和是否显示页面阴影。

左栏

点工具栏左侧的边栏按钮显示或隐藏。顶部四个按钮切换：

其他

• 打印：工具栏或 文件 ▸ 打印…（⌘P / Ctrl P），批注会一起打印。
• 有密码的 PDF：打开时会要求输入密码。
• 扫描件：页面顶部会提示“这是扫描件，识别文字后即可选中、搜索与翻译”，点 识别文字。识别时会显示进度，可以随时取消。识别出的文字是隐藏的，页面外观不变，但之后可以选中、搜索、翻译和编辑。Mac 使用系统自带的文字识别；Windows 使用系统的“光学字符识别”语言功能（需安装论文所用语言的识别组件，见常见问题）。
• 自定义工具栏：在工具栏上右键 ▸ 自定义工具栏…，增减按钮或调整顺序，可以随时恢复默认。

批注

批注写在 PDF 里。

高亮、下划线、便签等批注按 PDF 标准写进文件本身，用 Mac 的“预览”、Acrobat 等其他阅读器打开，也能看到和修改。

工具

每个工具都有快捷键：Mac 上是 ⌃⌘ 加一个字母，Windows 上是 Ctrl Alt 加同一个字母，悬停在工具按钮上可以看到，完整列表见快捷键。

修改批注

• 在批注上右键：更改颜色、添加评论… / 编辑评论…、编辑内容…（文本框）、删除批注。
• 拖动便签、文本框和手绘笔迹可以移动位置。
• 选中批注后按 Delete 删除。⌘Z / Ctrl Z 可以撤销。
• 设置 ▸ 阅读 ▸ 批注作者：写进批注的作者名，在其他阅读器里会显示出来。

选中文字后的右键菜单

笔记

每篇论文一份笔记。

笔记用来记想法、摘录和待办，支持 Markdown，自动保存。

• 打开笔记：在文献库里选中论文，按 ⌥⌘N / Ctrl Alt N，或点工具栏的笔记按钮，或切换到检查器的“笔记”页。在阅读器里，点工具栏右侧的边栏按钮打开右栏。两处是同一份笔记。
• 摘录：在阅读器里选中文字，右键 ▸ 添加到笔记。摘录以 > 引用块的形式加入，末尾注明“—— 第 N 页”。
• Markdown：可以用 # 标题、- 列表、**加粗**、> 引用等写法。
• 导出：右键 ▸ 导出笔记… 或 文件 ▸ 导出笔记…，保存为 Markdown（.md）文件。
• 笔记存在文献库里，会随同步盘同步，也能被 AI 智能体读取和修改。

编辑 PDF 文字

直接修改 PDF 里的文字。

不用另开编辑器。改过的文字沿用原来的字体、字号和排版，段落会自动重新排行。

1. 在阅读器工具栏点 编辑 PDF 中的文字（方框加铅笔的图标）。可以编辑的段落会显示边框。
2. 在段落里单击放置光标，或双击选中一个词，像在文本框里一样修改。
3. 点页面空白处，修改就写进 PDF 并保存。只有被修改的那几行会重新排列，批注和链接保持不变。
4. 改完再点一次同一个按钮，退出编辑。

配置翻译服务

选一个服务，填上它需要的信息。

翻译服务在 设置 ▸ 翻译 ▸ 翻译服务 里选择，整篇翻译和划词翻译都会用到它。免费服务什么都不用填；其他服务按下表填写，然后点 测试：Folio 会用它翻译一句话，显示译文和用时。

该选哪一个

每个服务要填什么

服务列表按类别分组。标“选填”的项留空即用默认值。

免费

本机

本机智能体

大模型 API

机器翻译 API

选择模型

大模型和智能体的“模型”一栏会从服务商取回可用模型的列表。可以在列表顶部搜索；列表里没有的，直接输入模型名称，点“使用‘…’”。点 重新获取 刷新列表，点 恢复默认 回到默认模型。有的服务不提供模型列表，这时直接输入模型名称即可。

推理强度（思考程度）

推理模型（如 OpenAI 的 gpt-5 系列、DeepSeek 的推理模型）可以设置推理强度。默认选中标着“推荐”的那一档。翻译不需要深度思考，档位越低越快，质量几乎不变。所选模型不是推理模型时，这一项显示“当前模型不支持”，不会发送这个参数。

保存为配置

同一个服务可以保存多套设置，例如两个不同的中转站，或同一服务的两个模型。填好后点 存为配置…，起个名字，例如“DeepSeek 推理”。保存的配置出现在服务列表顶部的“我的服务”里，在“翻译全文”面板和划词翻译里也能直接选。点配置旁的 删除 会删掉它保存的地址、模型和 Key。

限流时自动换用其他免费服务

使用免费服务时，这一项默认打开：Google 和 Microsoft（Mac 上还有 Apple 离线翻译）互为备用，一个被限流就自动换另一个，翻译不会中断。

用本机 AI 智能体翻译

用你已经登录的 AI 工具翻译。

如果电脑上装了 Claude Code、Codex 这类命令行 AI 工具，Folio 会自动找到它们，直接拿来翻译，用的是你自己的订阅或额度，不需要另外申请 API Key。

支持的智能体

Claude Code、CodeBuddy（WorkBuddy）、Codex、Gemini CLI、Qwen Code、opencode、Cursor CLI、Grok CLI、Antigravity CLI、GitHub Copilot CLI、Kiro CLI、Cline CLI、Kimi CLI、Factory Droid、Amp、goose、pi、Hermes Agent、OpenClaw、DeepSeek Harness。

使用步骤

1. 先在终端里运行一次这个智能体（如 claude、codex），完成登录。
2. 在 设置 ▸ 翻译 ▸ 翻译服务 的“智能体”一组里选择它。找到时会显示“已找到 …（版本号）”；没找到时提示先安装并登录。
3. 选择模型和思考程度（可以不改）。
4. 点 测试。

刚装好或刚卸载了智能体，到 设置 ▸ AI 点 重新检测。智能体装在非标准位置时，在“高级”里填写“可执行文件路径”。

模型与思考程度

• 模型：列表里是你的账号能用的模型。留空表示使用智能体自己的默认模型。Claude Code 默认选用速度快的 haiku；CodeBuddy 留空时自动选用快速模型。
• 思考程度：默认选中标着“推荐”的那一档（通常是“低”），并提示“翻译不需要深度思考，越低越快”。只有遇到特别难的段落才值得调高。
• 模型名里自带档位的（如 gemini-3.8-flash-high），思考程度显示为“由所选模型决定”。
• 选“由智能体决定”时，沿用智能体自己配置文件里的设置。
• Amp 和 DeepSeek Harness 的模型由它们自己的配置决定；Hermes Agent 需要先在终端运行 hermes model 选择模型；opencode、pi、OpenClaw 的模型写成 provider/model。

CodeBuddy（WorkBuddy）

CodeBuddy 命令行和 WorkBuddy 使用同一个腾讯账号，但 WorkBuddy 桌面版的登录只能在它自己的应用里使用，所以需要另装命令行并登录一次：

1. 在翻译服务里选 CodeBuddy（WorkBuddy）。如果检测到 WorkBuddy 桌面版但没有命令行，会显示 安装 CodeBuddy 命令行，点它。安装失败时，也可以在终端运行 npm install -g @tencent-ai/codebuddy-code。
2. 点 在终端登录，在打开的终端窗口里选择中国站，用 WorkBuddy 的腾讯账号登录，完成后关掉窗口。
3. 回到 Folio，点 测试。

翻译全文

保留排版，整篇翻译。

公式、图表、页眉页脚都留在原位，只把文字换成译文。译文作为附件加入这篇论文，原文不会被改动。翻译引擎内置在 Folio 里，不需要安装 Python 等组件。

开始翻译

1. 在文献列表里选中一篇或多篇论文，右键 ▸ 翻译全文…（⌃⌘T / Ctrl Alt T）。也可以在阅读器工具栏点 翻译 ▸ 翻译全文…。
2. 在弹出的面板里确认翻译服务和选项。在面板顶部换服务或配置，只对这一次有效，不改变设置里的默认值。
3. 点 开始翻译。

翻译时，列表里这篇论文的标题旁会显示进度。可以继续做别的事，也可以关闭面板。要停止，右键 ▸ 取消翻译。

选项

这些选项在“翻译全文”面板和 设置 ▸ 翻译 里都能设置，设置里的是默认值。

翻译图片中的文字

• 插图里的标注、坐标轴、图例都会识别并翻译，字号按原文测量，保持居中、对齐和对称，图片其余部分不变。
• 矢量插图里的文字（包括竖排的坐标轴标题）按文字翻译，效果最好；位图插图通过文字识别读取。
• 跨行的标注作为一整句翻译后再分回各行；SnakeSAM、ResNet 这类名称和 ✓ ✗、箭头等符号保持原样；会参考标题、摘要、图注和术语表，让图中术语和正文一致。
• 印刷后几乎看不清的小字（例如截图里软件的按钮文字）会被跳过。
• Windows 文字识别按语言安装，系统一般只带中文。翻译英文插图前，按这一项下方的提示安装英语的“光学字符识别”组件（需要管理员确认），然后重新启动 Folio。

批量翻译

一次选中多篇论文翻译时，设置 ▸ 翻译 ▸ 同时翻译 决定同时进行几篇，其余的排队等候。

打开译文

翻译完成后，文献列表里这篇论文的标题后面会出现绿色的 已翻译 标签，鼠标悬停可以看到它有哪些译文，例如“双语对照 · Google、译文 · DeepSeek”。正在翻译时标签暂时隐藏，让出位置给进度条。

论文左边出现展开箭头。展开后可以看到原文和各个译文文件，文件名写明了语言、服务和模型，例如“双语对照 · Google”。双击打开，也可以在原文的阅读器里使用对照阅读。

出错时

翻译中遇到问题（Key 无效、额度用完、网络不通、被限流等），列表里会马上显示具体原因，不会一直卡在进度条上。被限流时 Folio 会自动等待后重试。需要排查时，设置 ▸ 翻译 ▸ 翻译日志 里的 在 Finder / 资源管理器中显示 会打开完整的日志。

对照阅读

原文和译文并排滚动。

读原文时想看某段的译文，不用来回切换文件。

1. 在阅读器里打开原文。
2. 点工具栏的 翻译 ▸ 对照阅读。
3. 右边出现这篇论文的译文，两边同步滚动。再点一次 对照阅读 关闭。

对照阅读打开的是已经翻译好的译文；还没翻译时，按钮会提示先翻译全文。你在原文上做的高亮和批注照常保留在原文里。

划词翻译

选中就能翻译。

只想看懂一句话时，不必翻译整篇。

用法

• 在阅读器里选中文字，旁边会出现一个翻译按钮，点它弹出译文。
• 也可以选中后右键 ▸ 翻译，或者按快捷键 ⌥D / Alt D。
• 译文小窗顶部显示语言方向，右上角可以临时换一个翻译服务；底部可以拷贝译文、打开划词翻译设置，或重新翻译。
• 小窗可以拖动到别处。点外面、按 Esc 或切换窗口时关闭。

设置 ▸ 划词翻译

浏览器插件

在论文网页上一键保存。

在期刊、arXiv、Google Scholar 等网页上点一下，论文信息和 PDF 就进了 Folio。插件随 Folio 一起提供。

支持的浏览器

Chrome、Edge、Brave、Vivaldi、Opera、Arc、Firefox，Mac 上还有 Safari。设置 ▸ 浏览器 列出电脑上找到的浏览器和插件状态：已启用、未安装、已停用、有新版本等。

安装到 Chrome、Edge 等

插件还没有上架应用商店，需要以“开发者模式”载入，大约一分钟：

1. 在 设置 ▸ 浏览器 找到你的浏览器，点 安装…。Folio 会打开浏览器的扩展页面，拷贝扩展页面的地址，并在 Finder / 资源管理器里选中插件文件夹。
2. 如果浏览器没有跳到扩展页面（新版 Edge 会只打开一个新标签页），把地址粘贴到地址栏并回车。地址是 chrome://extensions、edge://extensions、brave://extensions 等。
3. 打开 开发者模式：Chrome 在右上角；Edge 叫“开发人员模式”，在左下角。
4. 把插件文件夹拖进扩展页面，松开即载入。也可以点“加载已解压的扩展程序”（Edge 叫“加载解压缩的扩展”），然后选择这个文件夹；Mac 上在选择窗口里按 ⇧⌘G，粘贴已拷贝的路径。

只想拿到插件文件夹，点 显示插件文件夹。

安装到 Firefox

1. 点 安装…。Firefox 不允许其他应用打开它的调试页面，把已拷贝的地址 about:debugging#/runtime/this-firefox 粘贴到地址栏。
2. 点“临时载入附加组件…”，选择插件文件夹里的 manifest.json。

Firefox 以临时附加组件载入，重启 Firefox 后需要重新载入。

启用 Safari 插件（Mac）

1. Safari ▸ 设置 ▸ 高级，勾选“显示网页开发者功能”。
2. Safari ▸ 设置 ▸ 开发者，勾选“允许未签名的扩展”。
3. Safari ▸ 设置 ▸ 扩展，勾选“Folio 文献保存”，并允许它在所有网站上使用（读取论文页面时需要）。

Folio 使用开发证书签名，Safari 每次重新打开后，需要再勾选一次“允许未签名的扩展”。

保存论文

• 在论文页面点浏览器工具栏上的 Folio 按钮，或按 ⇧⌘S / Ctrl Shift S。
• 小窗里显示识别到的论文：类型、标题、作者、期刊。可以选择 分组、填写 标签（多个用逗号分隔），以及是否 同时保存 PDF（下载可以公开获取的 PDF，如 arXiv）。点 保存。
• 在搜索结果、期刊目录这类列表页上，小窗会列出页面中的所有文献，勾选后点 保存 N 篇。
• 在链接上右键 ▸ 保存链接到 Folio，可以不打开页面直接保存。
• 文献库里已有的论文会提示“文献库中已有这篇文献”，不会重复添加。
• 没识别到论文信息的页面会作为网页保存。

引用与导出

复制引用，导出参考文献。

选中论文后按 ⇧⌘C / Ctrl Shift C，就能按默认样式复制参考文献，直接粘贴到 Word 或其他文稿里。

引用样式

GB/T 7714-2015、APA、IEEE、MLA、Chicago、Harvard、Vancouver、Nature。默认样式在 设置 ▸ 通用 ▸ 默认引用样式 里修改。

右键 ▸ 引用与导出

工具栏的“引用与导出”按钮和 文件 ▸ 导出参考文献…（Mac，⇧⌘E）也提供同样的功能。

引用键

每篇论文有一个引用键，例如 li2026，显示在检查器标题下方，可以修改。导出 BibTeX 时用它作为条目名，在 LaTeX 里写 \cite{li2026}。

期刊分区与影响因子

一眼看出期刊级别。

填写 easyScholar 的密钥后，列表和检查器会显示中科院分区（含 Top 标记）、JCR 分区、影响因子、5 年影响因子，以及 CCF、EI 等标记。

1. 登录 easyScholar，在“开放接口”页面复制 SecretKey。免费。
2. 在 设置 ▸ 文献库 ▸ 期刊指标 里粘贴到“easyScholar 密钥”，点 测试：会用这个密钥查一次 Nature 的指标。
3. 打开“自动获取期刊分区与影响因子”。

• 同一期刊只查询一次，结果缓存 30 天。
• 列表里可以显示“分区”和“影响因子”两列，并按它们排序。
• 检查器“来源”下方显示指标标签，悬停查看说明。右键可以 拷贝期刊指标。
• 查不到时显示“easyScholar 未收录该期刊”或“没有查到分区信息”。核对“来源”里的期刊全称（不要用缩写），然后右键 ▸ 刷新期刊指标。
• arXiv 等预印本没有期刊，不显示指标。

密钥在本机加密保存。数据由 easyScholar 开放接口免费提供。

让 AI 使用文献库

让 Claude、Codex 帮你查文献、写综述。

Folio 自带一个 MCP 服务器。接入后，可以在 AI 工具里直接说：“帮我找出文献库里讲视网膜血管分割的论文，按年份列出来，附上 GB/T 引用。”

一键接入

1. 打开 设置 ▸ AI。“这台电脑上的智能体”列出找到的 AI 工具，支持 Claude Code、Codex、Gemini CLI、GitHub Copilot CLI、Cursor CLI、Kiro CLI、Cline CLI、opencode、Antigravity、Qwen Code、Pi、Grok CLI、Hermes Agent、OpenClaw、Kimi Code、Droid、Amp、goose、DeepSeek Harness。
2. 为要用的智能体打开开关：
   • MCP：让它能调用 Folio 的工具。
   • 技能：一份说明，告诉它什么时候用、怎么用这些工具，效果更好。
   Folio 按各智能体官方的方式写入配置，修改前会自动备份。悬停在开关上可以看到写入的配置文件位置。
3. 重启那个智能体，或开始一个新会话。

有的智能体共用同一个技能文件夹（例如 Codex 和 Pi 都使用 ~/.agents/skills），关掉其中一个的技能时，Folio 会提醒其他几个也会受影响。

其他设置

AI 能做什么

Folio 提供 26 个工具：

例如：“把这五篇 DOI 加进‘综述’分组”“读一下 SnakeSAM 那篇的方法部分，总结成三点写进它的笔记”“导出‘参考文献’分组的 BibTeX 到 refs.bib”。

命令行 folio-cli

folio-cli 也可以直接在终端或脚本里用：

通用选项：--library <目录> 使用指定的文献库；--read-only 只允许读取。

设置一览

每个设置项的意思。

设置窗口用 ⌘, / Ctrl , 打开，Windows 上也可以点左上角的齿轮。

通用

阅读

文献库

检索

见添加文献末尾。

翻译

翻译服务与它的字段、高级选项、存为配置、测试、限流时自动换用其他免费服务，见配置翻译服务；翻译选项、同时翻译篇数、翻译日志，见翻译全文。

划词翻译

使用的服务、触发方式、快捷键，见划词翻译。

浏览器

允许浏览器插件保存到 Folio、连接状态、每个浏览器的安装状态和按钮，见浏览器插件。

AI

允许 AI 修改文献库、MCP 检查、命令行工具、智能体的 MCP 与技能开关、手动配置，见让 AI 使用文献库。

快捷键

全部快捷键。

文献库

阅读器

窗口与其他

右键菜单里的每一项旁边都标着它的快捷键。划词翻译的快捷键可以在设置里修改。

常见问题

遇到问题时。

翻译

文献库与添加

插件与 AI

其他

本指南适用于 Folio 1.3。