从安装到第一篇译文，
一步一步照着做。

1 / 11

下载与安装插件

第一次使用从这里开始。准备一份已下载到本机的 PDF，安装文件保留 .xpi 后缀。

1. 打开官网下载页

   进入 下载 TwinText，点击“下载 TwinText”保存标准安装包。等待浏览器显示下载完成，记住文件所在文件夹，通常是“下载”。

2. 检查 Zotero 版本

   打开 Zotero 桌面程序。“关于 Zotero”中可以查看版本：Mac 在“Zotero”菜单中，Windows 在“帮助”菜单中。当前公开版 2.0.35 要求 Zotero 10.0–10.9.9；具体兼容范围始终以下载页为准。

3. 打开插件管理窗口

   在 Zotero 顶部菜单点击 工具 → 插件。窗口可能显示为英文“Plugins Manager”。

4. 从文件安装

   点击窗口右上角的齿轮按钮，选择 Install Plugin From File…（从文件安装插件）。

5. 选中下载好的 XPI

   进入刚才的下载文件夹，选中 twintext-版本号.xpi，点击 Open（打开）。Windows 文件选择器同样选择 XPI 并点击“打开”。无需解压，也不要改成 ZIP。

6. 确认安装并重新打开 Zotero

   按安装弹窗提示确认。保存正在编辑的内容，退出并重新启动 Zotero，然后再进入“工具 → 插件”。

7. 确认 TwinText 已启用

   找到 TwinText for Zotero。启用开关应处于打开状态；点击名称可查看版本。截图中的蓝色开关表示已启用。

2 / 11

打开设置，激活或领取试用

先完成插件授权，再选择翻译服务。激活码用于授权 TwinText；API Key用于调用翻译服务，分别填写在不同位置。

1. 进入 TwinText 设置

   按上面的系统路径打开设置。在左侧插件列表中向下滚动，点击 TwinText。右侧显示“TwinText for Zotero”及“授权”区域。

2. 已有激活码：粘贴完整代码

   在“激活码”输入框粘贴收到的完整代码，确认没有多余空格，然后点击 激活。保持网络连接，等待授权结果。

3. 核对激活结果

   出现 已授权…版本 即表示成功；已激活界面的按钮会变为“更换激活码”。截图中账号和激活码已遮挡。

没有激活码：领取免费试用

4. 点击“开始免费试用”

   未激活的新用户，在同一“授权”区域找到 新用户免费试用 3 天，点击 开始免费试用。本机已经激活，因此上方实机截图不显示试用领取卡片。

5. 在浏览器验证 Zotero 账号

   在自动打开的页面登录自己的 Zotero 账号，阅读页面内容并完成身份验证授权，然后回到 Zotero。

6. 刷新并核对状态

   等待自动领取完成；未更新时点击 刷新试用状态。显示 免费试用中 后继续配置。

3 / 11

选择翻译服务与语言

翻译服务负责生成译文，文档引擎负责识别与排版。先选一个自己有权限使用的服务。

1. 设置翻译语言

   在“基础设置”中，英文文献可将源语言设为 Auto Detect，目标语言设为 Chinese (S)（简体中文）。识别源语言不准时，手动改为 English。

2. 官方服务用户：选择官方翻译

   在“翻译服务 → 翻译引擎”下拉菜单中选择 TwinText 官方翻译。

3. 检查套餐与可用额度

   阅读服务下方的套餐、用量或试用提示。官方服务的地址和密钥由后台管理，本机不需要再填写 API Key。若授权不包含此服务，继续下一章配置自己的接口。

4 / 11

配置自己的翻译 API

适用于提供 OpenAI 兼容接口的大模型服务。先从服务商后台取得接口地址、API Key 和模型名称；网页聊天会员不能代替 API 配置。

1. 选一个自定义接口位置

   进入“翻译服务”，在“翻译引擎”中选择 自定义接口 1（也可选 2–5）。截图使用本机已有的自定义接口 2，填写方法相同。

2. 选择接口协议

   “接口协议”选 OpenAI 兼容。使用 DeepL、小牛或 Google Cloud 专用 API 时，改选对应协议，并按界面要求填写。

3. 填写完整 URL

   在“完整 URL”填服务商文档给出的完整请求地址。OpenAI 兼容接口通常包含 /v1/chat/completions。仅填网站首页或 /v1 通常不够。

4. 填写 API Key 和模型

   将自己的 Key 填入“API Key”，把服务商给出的准确模型标识填入“模型”。截图中的地址与模型来自实际已配置服务，仅用于说明字段位置；不要把它们当成通用配置。

5. 首次使用先保留默认高级参数

   “高级参数”可留空。只有服务商明确要求时，再填写 Temperature、最大输出 token 或长度参数名称。

6. 点击“测试连接”

   测试会发送一条简短的真实请求。等待下方出现 连接测试成功；若失败，按提示核对地址、模型、Key 和额度。

7. 点击“保存配置”

   连接成功后点击 保存配置，完成配置保存。之后打开 PDF，在 TwinText 面板选中同一个自定义接口位置。

5 / 11

选择文档引擎与首次准备

大多数论文先选 TT 原版保真（推荐）。更换引擎会影响下一次翻译；已经生成的结果不会自动重排。

1. 找到“文档翻译”区域

   在 TwinText 设置页向下滚动，找到 文档翻译 → 文档引擎。

2. 按需要选择引擎

   希望保留 PDF 的版面、公式和图表时选 TT 原版保真（推荐）。先验证接口且不想等待文档环境准备时，可选 TT 轻量快译（免安装）；TT 智能版面使用前端版面模型。

3. 等待运行环境准备完成

   首次使用按界面提示加载文档引擎，保持 Zotero 打开并连接网络。下载和准备耗时随网络、电脑及已有环境而变化；已有兼容环境会复用。

4. 核对运行状态

   看到 文档引擎已就绪 后再开始。可点击 测试文档引擎检查当前状态；准备失败时，按运行状态旁的加载或修复按钮提示重试。

5. 按需调整高级选项

   原版保真下展开 高级选项。“富文本化翻译”控制对应的富文本处理；需要翻译图表中的可处理文字时，勾选 翻译 PDF 中的图表。

6. 开始新的翻译任务

   高级选项旁会提示 更改从下次开始翻译时生效。已有译文要应用新设置时，先导出所需结果，再清除当前译文并重新开始。

6 / 11

完成第一次当前页翻译

先用一页确认服务和结果，再扩展到全文。本章截图使用自建的两页英文示例 PDF，译文由本机已配置的真实翻译服务生成。

1. 在 Zotero 中打开 PDF

   在文库中双击 PDF 附件。文件必须在 Zotero 内置阅读器中打开；如果打开到了外部阅读软件，回到 Zotero 用右键“打开 PDF 到新标签页”。

2. 展开 TwinText 面板

   点击阅读器上方的青蓝色双页图标（TwinText）。弹出的面板顶部写有“TwinText”。

3. 选择“当前页”

   在“翻译范围”点击 当前页。先确认阅读器顶部的页码正是要测试的页面。

4. 核对服务和文档引擎

   “翻译服务”选择刚才配置好的服务；“文档引擎”选择已就绪的引擎。本机截图使用自定义接口 2 和 TT 原版保真。

5. 设置对照方式

   “对照方式”选 左右对照，“翻译窗口”选 副窗口（右侧／下方）；需要同步翻页和滚动时开启 原译联动。

6. 点击“开始翻译”并等待

   点击面板右下角 开始翻译。准备期间出现原文或逐步生成的预览是正常过程，保持页面打开，等当前页生成。

7. 对照检查译文

   核对标题、首段和术语是否出现中文，以及当前页内容是否完整。原版保真应等待最终页面生成，再评估版式或导出。

7 / 11

全文、指定页与暂停继续

阅读器页码按 PDF 实际页面顺序计算。例如封面是第 1 页，即使论文正文页脚从 1 开始，也不能直接照抄印刷页码。

1. 翻译整篇：选择“全文”

   打开 TwinText 面板，在“翻译范围”点击 全文，核对服务后点击 开始翻译。

2. 只翻译几页：选择“指定页”

   点击 指定页，面板底部会出现“页码范围”。再点击显示“第…页—第…页”的范围框。

3. 输入起始页与结束页

   左侧输入起始页，右侧输入结束页。两页示例可设为 1 至 2；其他 PDF 按实际总页数填写。确认范围后点击 开始翻译。

4. 暂停进行中的任务

   翻译进行中如需暂停，重新点 TwinText 图标打开面板，点击 暂停翻译，等待当前任务停下。不要通过清理缓存来暂停。

5. 继续已暂停的任务

   保留同一文档和兼容的翻译设置，再点击开始翻译按钮继续。进度和可复用缓存会帮助续译；更换语言、服务或引擎可能重新生成。

6. 查看原文或重新翻译

   完成后点击 显示原文可切回原文。需要移除当前译文显示并重新开始时，用 清除译文；清除前先导出需要保留的结果。

8 / 11

对照阅读与外观调整

可以在阅读器中调整当前阅读方式，也可以在 TwinText 设置页设置默认值。

1. 选择排列方式

   在面板“对照方式”里选择 左右对照、上下对照或仅译文。宽屏适合左右对照；希望上下核对同页内容时选上下对照。

2. 决定译文放哪边

   “翻译窗口”选 主窗口（左侧／上方）或副窗口（右侧／下方）。这项决定译文所在位置。

3. 按需开启原译联动

   打开 原译联动，滚动一边时另一边跟随。关闭后可独立滚动核对不同位置；仅译文模式不需要此项。

4. 展开阅读外观

   点击 字号 100% · 行距 100%，用“+ / −”调整字号与行距，在“字体”中选择衬线或非衬线。原版保真最终 PDF 主要保留原文版式；阅读外观调整对轻量快译、智能版面的阅读视图更适用。

5. 需要时恢复默认

   点击外观菜单中的 恢复默认。在设置页对应按钮名称是 恢复默认格式。

6. 设置忽略区域

   要让参考文献或页眉页脚保留原文，在开始翻译前勾选 忽略参考文献或忽略页眉页脚。修改从下一次翻译生效，已生成结果不会自动改写。

9 / 11

在文库右键翻译与批量翻译

不逐篇打开阅读器，也能从文库翻译全文并自动保存附件。开始前在 TwinText 设置中确认授权、翻译服务、语言和文档引擎。

1. 在文库选择 PDF 或文献条目

   单篇翻译点击一个已有 PDF 的条目或附件。批量翻译按住 Ctrl（Windows）或⌘（Mac）逐个多选；连续多选可用 Shift。只有网页记录、没有本地 PDF 的条目要先添加 PDF。

2. 右键打开 TwinText 子菜单

   在选中的条目上点击鼠标右键，找到 TwinText。菜单一般在“重建条目索引”下方。

3. 选择保存格式

   选择 翻译PDF（仅译文）或翻译PDF（双文对照）。多选时名称是 批量翻译PDF（仅译文）、批量翻译PDF（双文对照）。

4. 等待批次翻译与保存

   查看进度提示，等待当前文献处理完成。此入口处理全文，并自动保存 PDF 附件，不需要逐篇选择文件路径；保存完成前不会把进度当作全部完成。

5. 需要中止时点击“停止本次翻译”

   在进度提示标题行点击 停止本次翻译。排队文献取消，当前文献可能先显示“正在停止…”；已经保存的结果保留。

6. 展开原条目查找结果

   有上级文献时展开条目查看附件。仅译文结果名为 TwinText-translated，双文对照结果名为 TwinText-compare。独立 PDF 的结果在文库中保存；可用快速搜索查找名称。重复保存时加 -1、-2等序号。

10 / 11

导出文件与保存附件

等待所选范围翻译完成，再导出要保留的结果。需要原版式 PDF 时，使用原版保真引擎并等最终页面生成。

1. 打开导出菜单

   点击阅读器上方的 TwinText 图标，再点击面板顶部 导出文件。

2. 选择需要的格式

   保存到电脑：选 PDF 文件（仅译文）、PDF 文件（对照翻译）、Markdown 文件或离线 HTML 网页。保存到文库：选 Zotero 附件（对照翻译）或Zotero 笔记。

3. 文件导出：选择位置和文件名

   系统保存窗口出现后，选保存文件夹，确认文件名和格式，再点 Save（保存）。使用新文件名，保留原始 PDF。Mac 与 Windows 保存窗口外观不同，操作相同。

4. 等待成功提示并检查文件

   出现 导出完成后，到选定文件夹打开结果，检查页面与所选翻译范围。当前页翻译不等于已翻译整篇，需要完整译文时先完成全文任务。

保存附件、笔记或设置自动保存

5. 保存为 Zotero 附件

   在导出菜单选 Zotero 附件（对照翻译）。等待完成提示，回到文库查找 TwinText-compare；重复保存会追加序号。

6. 保存为可编辑笔记

   选 Zotero 笔记，完成后回到文库打开新生成的笔记，可继续编辑整理。Markdown 适合外部编辑，离线 HTML 适合浏览器阅读。

7. 需要每次自动保存时开启开关

   在设置页“翻译与阅读”中勾选 翻译完成后自动保存到附件（对照翻译）。默认关闭；无需每次保存时保持关闭，按需手动导出。

11 / 11

遇到问题，按顺序排查

先记下错误提示，再判断是安装、授权、服务还是引擎的问题。不要一遇到问题就删除环境或清理全部缓存。

1. 检查版本和入口

   在“工具 → 插件”确认 TwinText 已启用、版本与 Zotero 兼容。重启 Zotero，再在内置阅读器打开 PDF，寻找 TwinText 图标。

2. 检查授权与接口

   授权应为“已授权”或“免费试用中”。使用官方服务时查看额度；使用自定义接口时，重新“测试连接 → 保存配置”，阅读器选择同一接口。

3. 用当前页缩小问题范围

   先翻译一页。原版保真正在准备环境时等待完成；也可用免安装的轻量快译验证服务，区分翻译接口与文档环境问题。

4. 检查运行环境

   进入 TwinText 设置，滚动到 维护与诊断，点击 检查运行环境，记录检查结果。需要提供诊断材料时点击 打开诊断目录。