[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72184":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":16,"starSnapshotCount":16,"syncStatus":29,"lastSyncTime":30,"discoverSource":31},72184,"zotero-pdf2zh","guaguastandup\u002Fzotero-pdf2zh","guaguastandup","PDF2zh for Zotero | Zotero PDF中文翻译插件","",null,"Python",4628,185,7,54,0,82,163,457,246,28.81,"GNU Affero General Public License v3.0",false,"main",[],"2026-06-12 02:02:59","\u003Cdiv align=\"center\">\n\n![Zotero PDF2zh](.\u002Ffavicon@0.5x.svg)\n\n\u003Ch2 id=\"title\">Zotero PDF2zh\u003C\u002Fh2>\n\n[![zotero target version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FZotero-7-green?style=flat-square&logo=zotero&logoColor=CC2936)](https:\u002F\u002Fwww.zotero.org)\n[![zotero target version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FZotero-8-blue?style=flat-square&logo=zotero&logoColor=CC2936)](https:\u002F\u002Fwww.zotero.org\u002Fsupport\u002Fbeta_builds)\n[![Using Zotero Plugin Template](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FUsing-Zotero%20Plugin%20Template-blue?style=flat-square&logo=github)](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-plugin-template)\n![Downloads release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002Fguaguastandup\u002Fzotero-pdf2zh\u002Ftotal?color=yellow)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fguaguastandup\u002Fzotero-pdf2zh)](https:\u002F\u002Fgithub.com\u002Fguaguastandup\u002Fzotero-pdf2zh\u002Fblob\u002Fmain\u002FLICENSE)\n[![zread](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FAsk_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https:\u002F\u002Fzread.ai\u002Fguaguastandup\u002Fzotero-pdf2zh)\n\n在Zotero中使用[PDF2zh](https:\u002F\u002Fgithub.com\u002FByaidu\u002FPDFMathTranslate)和[PDF2zh_next](https:\u002F\u002Fgithub.com\u002FPDFMathTranslate\u002FPDFMathTranslate-next)\n\n**当前版本信息：** server.zip v4.0.4 | 插件 xpi v4.0.1\n\n**📚 项目文档：** [zotero-pdf2zh.github.io](https:\u002F\u002Fzotero-pdf2zh.github.io)\n\n**📝 其他语言 \u002F Other Languages:**\n\n[English](.\u002Fi18n\u002FREADME.en.md) | [日本語](.\u002Fi18n\u002FREADME.ja.md) | [한국어](.\u002Fi18n\u002FREADME.ko.md) | [Italiano](.\u002Fi18n\u002FREADME.it.md) | [Français](.\u002Fi18n\u002FREADME.fr.md)\n\n> **Note:** The translations above were generated by AI and may contain inaccuracies. For the most accurate information, please refer to this document.\n\n\u003C\u002Fdiv>\n\n## 📖 目录\n\n- [如何使用本插件](#如何使用本插件)\n- [安装说明](#安装说明)\n  - [第零步：安装Python和Zotero](#第零步安装python和zotero)\n  - [第一步：安装uv\u002Fconda](#第一步安装uvconda)\n  - [第二步：下载项目文件](#第二步下载项目文件)\n  - [第三步：启动服务](#第三步启动服务)\n  - [第四步：下载并安装插件](#第四步下载并安装插件)\n  - [第五步：Zotero端插件设置](#第五步zotero端插件设置)\n  - [第六步：关于翻译选项](#第六步-关于翻译选项)\n  - [第七步：关于包更新](#第七步-关于包更新)\n  - [其他安装方法](#其他安装方法)\n- [常见问题（FAQ）](#常见问题faq)\n  - [关于网络](#关于网络)\n  - [关于环境](#关于环境)\n  - [关于翻译服务](#关于翻译服务)\n  - [关于OCR\u002F扫描件](#关于ocr扫描件)\n  - [关于翻译效果](#关于翻译效果)\n  - [关于插件功能](#关于插件功能)\n  - [关于提问](#关于提问)\n  - [关于支持本插件](#关于支持本插件)\n- [致谢](#致谢)\n- [贡献者](#贡献者)\n- [如何支持我](#如何支持我)\n- [开源协议与使用声明](#开源协议与使用声明)\n\n---\n\n# 如何使用本插件\n\n本指南将引导您完成 Zotero PDF2zh 插件的安装和配置。\n\n❓ 遇到问题\n\n- 跳转至本项目总结的常见问题：[常见问题(FAQ)](https:\u002F\u002Fgithub.com\u002Fguaguastandup\u002Fzotero-pdf2zh?tab=readme-ov-file#%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98faq)\n- 基础问题（例如如何安装python，如何安装conda等问题）请向AI提问\n- 在github issue区提问\n- QQ群提问:\n    - 提问时需要遵循规则: **确保已经阅读过issue区和常见问题文档，重复问题不会得到回复。确定问题为新问题后, 将终端报错复制到txt文件, 并截图zotero插件设置端配置**\n    - 1群: 971960014(已满)\n    - 2群: 897867369(已满)\n    - 3群: 1064375380(已满)\n    - 4群: 443031486(已满)\n    - 5群: 1064435415(已满)\n    - 6群: 1083772600\n    - 7群: 930368730\n    - 入群问题答案: github\n\n# 安装说明\n\n## 第零步：安装Python和Zotero\n\n- **Python**：[下载链接](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)，建议安装 3.12 版本\n- **Zotero**：支持 [Zotero 7](https:\u002F\u002Fwww.zotero.org) 和 [Zotero 8](https:\u002F\u002Fwww.zotero.org\u002Fdownload\u002F)（适配 by @[Aphcity](https:\u002F\u002Fgithub.com\u002FAphcity)）\n\n- **打开命令行工具**（后续步骤都在命令行中执行）：\n  - **Windows**：按 `Win + R` → 输入 `cmd` → 回车（建议以**管理员身份运行**）\n  - **macOS**：按 `Cmd + 空格` → 输入\"终端\" → 回车\n  - **Linux**：`Ctrl + Alt + T`\n\n## 第一步：安装uv\u002Fconda\n\n选择一个环境管理工具。如果不确定选哪个，推荐 uv。\n\n**uv安装(推荐)**\n\n```shell\n# macOS\u002FLinux\nwget -qO- https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n# Windows（在PowerShell中执行）\npowershell -ExecutionPolicy ByPass -c \"irm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\"\n```\n\n安装后执行 `uv --version`，能看到版本号即成功。\n\n如果提示找不到命令，需将 uv 路径添加到环境变量并重启终端：\n\n```shell\n# MacOS\u002FLinux\nexport PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"\n# Windows PowerShell\n$env:Path = \"$env:USERPROFILE\\.local\\bin;$env:Path\"\n```\n\n**conda安装**\n\n参考 [Miniconda 安装指南](https:\u002F\u002Fwww.anaconda.com\u002Fdocs\u002Fgetting-started\u002Fminiconda\u002Finstall#windows-command-prompt)进行安装，安装后执行 `conda --version` 验证。\n\n## 第二步：下载项目文件\n\n> ⚠️ **Windows用户注意**：请勿在C盘（系统盘）下创建项目文件夹，建议在D盘或其他非系统盘操作。例如：先执行 `D:` 切换到D盘，再执行后续命令。\n\n```shell\n# 1. 创建并进入zotero-pdf2zh文件夹\nmkdir zotero-pdf2zh && cd zotero-pdf2zh\n\n# 2. 下载并解压server文件夹\n# 如果server.zip下载失败, 可以直接访问: https:\u002F\u002Fgithub.com\u002Fguaguastandup\u002Fzotero-pdf2zh\u002Fblob\u002Fmain\u002Fserver.zip 手动下载\nwget https:\u002F\u002Fraw.githubusercontent.com\u002Fguaguastandup\u002Fzotero-pdf2zh\u002Frefs\u002Fheads\u002Fmain\u002Fserver.zip\nunzip server.zip\n\n# 3. 进入server文件夹\ncd server\n```\n\n> 💡 **提示：确认目录结构**\n>\n> 解压后，请确认您的目录结构应该是：\n> ```\n> zotero-pdf2zh\u002F\n> └── server\u002F\n>     ├── server.py\n>     ├── ...\n>     └── requirements.txt\n>    ```\n>    \n> 如果您看到的是 `server\u002Fserver\u002F` 这样的嵌套结构（两层 server），说明解压出现了嵌套问题，请执行：\n>\n> ```shell\n># 回到上级目录\n> cd ..\n> # 移动内容到正确位置\n> mv server\u002Fserver\u002F* server\u002F\n> # 删除空的嵌套目录\n> rmdir server\u002Fserver\n> # 重新进入 server 目录\n> cd server\n> ```\n\n**快速检查方法**：\n执行 `cd server` 后，运行 `ls server.py`，如果能看到 `server.py` 文件，说明目录结构正确。如果提示找不到文件，说明存在嵌套问题。\n\n## 第三步：启动服务\n\n**uv 用户（推荐）**\n\n```shell\nuv run --python 3.12 --with-requirements requirements.txt server.py\n```\n\n**conda 用户**\n\n```shell\n# 1. 创建环境（仅首次需要）\nconda create -n zotero-pdf2zh-server python=3.12 -y\n# 2. 激活环境\nconda activate zotero-pdf2zh-server\n# 3. 安装依赖（仅首次需要）\npip install -r requirements.txt\n# 4. 启动服务\npython server.py --env_tool=conda\n```\n\n> ⚠️ **重要**：翻译功能依赖本脚本运行，使用翻译时**不要关闭此终端窗口**。\n\n### 常用参数\n\n在启动命令后面追加参数即可，例如 `... server.py --port=9999`：\n\n| 参数 | 说明 | 默认值 |\n|------|------|--------|\n| `--port` | 服务端口号 | `8890` |\n| `--check_update` | 启动时检查更新 | `True` |\n| `--update_source` | 更新源（`github` \u002F `gitee`） | `gitee` |\n| `--enable_mirror` | 启用 pip 镜像加速 | `True` |\n| `--mirror_source` | 自定义镜像源 URL | `https:\u002F\u002Fmirrors.ustc.edu.cn\u002Fpypi\u002Fsimple` |\n| `--enable_winexe` | 使用 Windows exe 模式（需配合 `--winexe_path`） | `False` |\n\n### 注意事项\n\n- **uv 用户**：安装后请不要移动或重命名 `server` 文件夹（会影响环境路径）。\n- **conda 用户**：环境存储在 conda 的 envs 目录中，可以安全移动 `server` 文件夹。\n\n## 第四步：下载并安装插件\n\n新版本v4.0.1[下载链接](https:\u002F\u002Fgithub.com\u002Fguaguastandup\u002Fzotero-pdf2zh\u002Freleases\u002Fdownload\u002Fv4.0.1\u002Fzotero-pdf-2-zh.xpi)\n\n1. 安装方式：在zotero中打开“工具-插件”，将xpi文件拖入，进行安装。（若拖入后功能未生效，请重启Zotero）\n2. 如何更新：您可以在zotero中检查更新，或选择自动更新，来获取最新版本插件。\n\n## 第五步：Zotero端插件设置\n\n\u003Cdiv align=center>\n\u003Cimg src=\".\u002Fimages\u002Fpreference.png\" width=\"600\"\u002F>\u003Cbr>\n\u003Csmall>zotero 插件设置页面\u003C\u002Fsmall>\n\u003C\u002Fdiv>\n\n**检查服务器连接**\n\n在插件设置页面中，点击\"Python Server IP\"输入框旁边的\"检查连接\"按钮，可测试与Python服务的连接状态。若显示连接成功，则服务正常运行；若显示连接失败，请检查：\n\n-   server.py 脚本是否正在运行\n-   端口号是否正确（默认8890）\n-   防火墙\u002F杀毒软件是否阻止了连接\n\n**配置选项说明**\n\n- 切换翻译引擎`pdf2zh\u002Fpdf2zh_next`，界面将显示不同引擎的翻译配置\n\n- 其他说明（初次配置可以忽略）\n\n    - 关于**qps(Query Per Second)**和**poolsize**选项：\n\n    - >具体数值请参考您的LLM服务商提供的参数（例如[zhipu](https:\u002F\u002Fwww.bigmodel.cn\u002Fdev\u002Fhowuse\u002Frate-limits)）\n        >\n        >- 计算公式: `qps = rpm \u002F 60` (RPM = Request Per Minute)\n        >- 对于上游为**qps\u002Frpm限速**：pool size = qps * 10; \n        >- 对于上游为**并发数限制**: pool size = max(向下取整(0.9*官方并发数限制), 官方并发数限制-20)，qps = pool size\n        >- 如果您不知道怎么设置, 请直接设置qps即可, pool size设置为默认值0即可\n\n\n    - 翻译引擎pdf2zh的自定义字体：\n\n    - > - 字体文件路径为本地路径。\n        >\n        > - 如果采用远端服务器部署，暂时无法在插件设置中指定字体路径。需要您手动修改`config.json`文件中的`NOTO_FONT_PATH`字段。\n\n    - 额外配置参数名需要与config文件中的字段相同(例如在pdf2zh_next中, openai对应的额外配置: `openai_temperature`和`openai_send_temperature`与`config.toml`文件中的字段相对应), 本功能将在未来继续优化, 可参考[文档](.\u002Fserver\u002Fdoc\u002FextraData.md)\n\n\n**网页端查看翻译进度**\n\n服务启动后，可在浏览器中访问 `http:\u002F\u002F127.0.0.1:8890` 查看翻译进度和使用相关功能：\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\".\u002Fimages\u002Fhtml1.png\" width=\"400\"\u002F>\u003Cbr>\n  \u003Csmall>查看当前配置信息\u003C\u002Fsmall>\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\".\u002Fimages\u002Fhtml2.png\" width=\"400\"\u002F>\u003Cbr>\n  \u003Csmall>实时查看翻译进度\u003C\u002Fsmall>\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\".\u002Fimages\u002Fhtml3.png\" width=\"400\"\u002F>\u003Cbr>\n  \u003Csmall>查看历史翻译记录并预览下载\u003C\u002Fsmall>\n\u003C\u002Fdiv>\n\n**功能说明：**\n- 查看当前server端的配置信息\n- 实时显示当前翻译任务状态\n- 查看翻译历史记录，支持预览和下载翻译后的文件\n\n> 📢: v4.0.3(3月7日) windows端暂时不支持多进度条显示(多个pdf同时翻译时只会有一个进度条会更新，是bug待修复)\n\n**翻译引擎对比**\n\n插件支持两种翻译引擎，请根据需求选择：\n\n| 对比项 | PDF2ZH (旧版) | PDF2ZH Next (新版) |\n|--------|---------------|-------------------|\n| **维护状态** | ❌ 不再活跃维护 | ✅ 持续更新维护 |\n| **翻译速度** | ⚡ 较快 | 速度适中 |\n| **自定义字体** | ✅ 支持更换自定义字体 | ❌ 不支持 |\n| **配置文件** | `config.json` | `config.toml` |\n| **双语模式** | 默认为Top&Bottom | 默认为 Left&Right |\n| **术语表功能** | ❌ 不支持 | ✅ 自动提取并使用术语表 |\n| **表格翻译** | ❌ 不支持 | ✅ 支持表格内容翻译 |\n| **OCR兼容** | ❌ 不支持 | ✅ 支持 OCR 兼容模式和自动 OCR |\n| **支持的翻译服务** | 支持海量翻译服务 | 提供免费 siliconflowfree |\n| **上游项目** | [Byaidu\u002FPDFMathTranslate](https:\u002F\u002Fgithub.com\u002FByaidu\u002FPDFMathTranslate) | [PDFMathTranslate-next](https:\u002F\u002Fgithub.com\u002FPDFMathTranslate\u002FPDFMathTranslate-next) |\n\n**翻译服务配置**\n\n配置翻译服务需完成两步：\n\n**第一步：添加API配置**\n\n在\"LLM API配置管理\"区域点击\"新增\"，填写服务配置信息。同一服务可添加多个配置，但只能激活其中一个。\n\n**第二步：选择翻译服务**\n\n在页面顶部的\"翻译服务\"下拉菜单中，选择要使用的服务名称。\n\n>警告：仅添加API配置不会生效，必须完成第二步选择服务，翻译功能才能使用。\n\n\u003Cdiv align=center>\n\u003Cimg src=\".\u002Fimages\u002Feditor.png\" width=\"400\"\u002F>\n\u003C\u002Fdiv>\n\n\n**💡 翻译服务介绍(必读)**\n\n| 服务类型                | 服务名称         | 服务介绍                                                     | 💡注意事项                                                    |\n| ----------------------- | ---------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |\n| 免费&免配置的翻译服务   | siliconflowfree  | 基于硅基流动提供的GLM4-9B模型, 仅支持翻译引擎pdf2zh_next，由[@硅基流动](https:\u002F\u002Fwww.siliconflow.cn\u002F)、[@pdf2zh_next](https:\u002F\u002Fgithub.com\u002FPDFMathTranslate\u002FPDFMathTranslate-next) 和 [@BabelDOC](https:\u002F\u002Fgithub.com\u002Ffunstory-ai\u002FBabelDOC)联合提供服务 | 1. 此服务无需选择qps，默认为20\u003Cbr \u002F>2.此服务可能会存在漏翻译的情况，如果需要高质量翻译请优先选择其他服务\u003Cbr \u002F>3. 此服务仅支持pdf2zh_next引擎 |\n| 免费&免配置的翻译服务   | bing\u002Fgoogle      | bing\u002Fgoogle的官方机器翻译                                    | bing和goole的翻译服务都存在限流，如果翻译失败，请将并发数设置调至2及以下重试 |\n| 具有优惠\u002F赠送的翻译服务 | openaliked       | 加入[火山引擎协作计划](https:\u002F\u002Fconsole.volcengine.com\u002Fark\u002Fregion:ark+cn-beijing\u002FopenManagement?OpenAuthorizeModal=true&OpenTokenDrawer=false)，个人用户每个模型每天最多赠送50w token | 1. 协作计划的额度赠送规则是：按照前一天参加协作的token量等额计算（例如您昨天使用了10w token，那么今天的赠送额度则为10w token）上限为50w，请注意检查自己的额度使用情况，避免超额\u003Cbr \u002F>2. 此服务支持高并发数：可设置并发数为500~1000 |\n| 具有优惠\u002F赠送的翻译服务 | silicon          | 通过邀请好友可以获得14元赠送金额                             | 1. 此服务url需填写为: `https:\u002F\u002Fapi.siliconflow.cn\u002Fv1`，如果后面有completions等后缀，请删除。\u003Cbr \u002F>2. 此服务免费版支持的线程数较低，建议设置为6左右 |\n| 具有优惠\u002F赠送的翻译服务 | zhipu            | 智谱部分模型可支持免费调用                                   | 免费服务的并发数不要设置过高，建议设置为6以内                |\n| 高质量服务              | aliyunDashScope  | 翻译效果较好，新用户有赠送额度，可以尝试                     | 选择LLM API配置管理中的默认模型选项                          |\n| 高质量服务              | deepseek（推荐） | 翻译效果好，有缓存命中机制                                   | 使用deepseek v3服务即可                                      |\n\n-   除了免费服务，您均需要配置自己的API Key和URL才可以使用翻译服务（某些服务不需要配置URL，可以忽略）\n-   您可以根据实际情况自行调整并发数\n\n- **openailiked服务选项**可以填写所有兼容openai格式的LLM服务, 您需要填写您的LLM服务供应商提供的URL, API Key, Model名称等信息。\n\n    - 示例: 火山引擎url填写为`https:\u002F\u002Fark.cn-beijing.volces.com\u002Fapi\u002Fv3`\n\n\n## 第六步： 关于翻译选项\n\n在Zotero中对条目\u002FPDF右键，选择PDF2zh-翻译选项，进行翻译。\n\n对条目\u002F附件单击右键, 可以看到四个翻译选项:\n\n\u003Cdiv align=center>\n\u003Cimg src=\".\u002Fimages\u002Fmenu.png\" width=\"400\"\u002F>\n\u003C\u002Fdiv>\n\n**💡 翻译选项解析**\n\n| 翻译选项                              | 解释                                                         | 示例图片                                                     |\n| ------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |\n| **翻译PDF (translate PDF)**           | 点击原文PDF或论文条目, 将会生成在Zotero插件设置端所选择的默认生成文件 | \u003Cimg src=\".\u002Fimages\u002Fimage3.png\" alt=\"image3\" style=\"width: 400px\" align=\"center\"\u002F> |\n| **裁剪PDF (crop PDF)**                | 选择dual\u002Fmono类型附件, 将会对选择的附件在宽度1\u002F2处裁剪, 然后上下拼接, 此功能适合手机阅读\u003Cbr \u002F>注意事项: \u003Cbr \u002F>1. 本选项会将页面两侧空白处进行裁剪\u003Cbr \u002F>2. 若产生截断了原文内容的情况, 可将`server\u002Futils\u002Fconfig.py`中的`config.pdf_w_offset`值降低 | \u003Cimg src=\".\u002Fimages\u002Fimage4-1.png\" alt=\"image4\" style=\"width: 400px\" align=\"center\"\u002F> |\n| **双语对照 (compare PDF)**                | 点击此选项, 会生成左边为原文, 右边为翻译后文本的PDF\u003Cbr \u002F>1. 选择\"Dual文件翻译页在前\"可以交换生成顺序\u003Cbr \u002F>2. 此选项等同于翻译引擎为pdf2zh_next, 且`双语(Dual)文件显示模式`为**Left&Right**时生成的文件 | \u003Cimg src=\".\u002Fimages\u002Fimage4-3.png\" alt=\"image4\" style=\"width: 400px\" align=\"center\"\u002F> |\n| **双语对照(裁剪) (crop-compare PDF)** | 此选项仅针对**双栏PDF论文**。它会先将PDF**竖向裁剪为单栏文件**，再左右拼接。 | \u003Cimg src=\".\u002Fimages\u002Fimage4-2.png\" alt=\"image4\" style=\"width: 400px\" align=\"center\"\u002F> |\n\n**您可以多选条目，右键菜单，然后进行批量PDF翻译**\n\n## 第七步: 关于包更新\n\nzotero插件和server脚本均具有自动更新功能, 但是为了使用最新版本babeldoc和pdf2zh_next, 您需要进行下列操作:\n\n0. 进入server文件夹\n\n1. 进入虚拟环境: 名称为`zotero-pdf2zh-next-venv`\n```shell\n# conda\nconda activate zotero-pdf2zh-next-venv\n\n# uv\n## MacOS\u002FLinux\nsource .\u002Fzotero-pdf2zh-venv-next\u002Fbin\u002Factivate\n## Windows\n.\\zotero-pdf2zh-next-venv\\Scripts\\activate\n```\n\n2. 更新\n```shell\n# conda\npip install --upgrade pdf2zh_next babeldoc\n# uv\nuv pip install --upgrade pdf2zh_next babeldoc\n```\n\n## 其他安装方法\n\n### Windows exe 版本安装（仅限Windows用户）\n\n如果您不想配置Python虚拟环境，可以直接使用pdf2zh_next 提供的预编译exe版本。\n\n**安装步骤：**\n\n1. 下载exe包：访问 [pdf2zh_next Release](https:\u002F\u002Fgithub.com\u002FPDFMathTranslate-next\u002FPDFMathTranslate-next\u002Freleases) 页面，下载 `pdf2zh-v2.x.x-BabelDOC-v0.x.x-win64.zip`（选择 `with-assets` 版本）\n\n2. 解压文件：将下载的zip文件解压到 `server` 目录下，   \n  - 解压后目录结构：`server\u002Fpdf2zh-v2.x.x-BabelDOC-v0.x.x-win64\u002Fpdf2zh\u002Fpdf2zh.exe`\n\n3. 运行服务：\n```shell\npython server.py --enable_winexe=True --winexe_path='.\u002Fpdf2zh-v2.x.x-BabelDOC-v0.x.x-win64\u002Fpdf2zh\u002Fpdf2zh.exe'\n```\n\n**注意事项：**\n- exe版本**不需要配置Python虚拟环境**，- 确保exe路径正确，路径相对于 `server` 目录\n- 如果遇到DLL相关错误，请安装 [Visual C++ Redistributable](https:\u002F\u002Faka.ms\u002Fvs\u002F17\u002Frelease\u002Fvc_redist.x64.exe)\n- exe模式目前可能存在一些兼容性问题，如果遇到问题建议使用虚拟环境方式\n\n### Docker 部署\n\n- zotero-pdf2zh [docker链接](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fvanxv\u002Fzotero-pdf2zh) by [@xucongyong](https:\u002F\u002Fgithub.com\u002Fxucongyong)\n- 请参考：[Docker部署方法一](.\u002Fdocker\u002FREADME.md) by [@Rosetears520](https:\u002F\u002Fgithub.com\u002FRosetears520)\n- 请参考：[Docker部署方法二](.\u002Fdocker2\u002FREADME.md) by [@taozhe6](https:\u002F\u002Fgithub.com\u002Ftaozhe6)\n\n### Homebrew\u002FLinuxbrew 部署（MacOS\u002FLinux用户）\n\n- 参考：[做了一个 homebrew 的 tap，便于 mac 用户直接使用 #187](https:\u002F\u002Fgithub.com\u002Fguaguastandup\u002Fzotero-pdf2zh\u002Fissues\u002F187) by [@NightWatcher314](https:\u002F\u002Fgithub.com\u002FNightWatcher314)\n- 仓库链接: [NightWatcher314\u002Fzotero-pdf2zh-server](https:\u002F\u002Fgithub.com\u002FNightWatcher314\u002Fzotero-pdf2zh-server)\n\n### 不使用虚拟环境管理\n\n如果您只想使用 pdf2zh_next\u002Fpdf2zh 引擎中的一个，并且全局 Python 版本为 3.12.0，可以不使用虚拟环境管理。\n\n> ⚠️ **注意**：不使用虚拟环境管理时，您需要确保：\n> - 全局 Python 版本为 3.12 或更高\n> - 已手动安装所需的依赖包\n\n#### uv 用户（推荐）\n\n```shell\n# 创建固定主虚拟环境（只需执行一次）\nuv venv zotero-pdf2zh-server --python 3.12\n\n# 激活环境\n# Windows\n.\\zotero-pdf2zh-server\\Scripts\\activate\n# macOS\u002FLinux\nsource .\u002Fzotero-pdf2zh-server\u002Fbin\u002Factivate\n\n# 安装依赖\npip install -r requirements.txt\n\n# 启动服务\npython server.py --enable_venv=False\n```\n\n#### conda 用户\n\n```shell\n# 创建主虚拟环境（只需执行一次）\nconda create -n zotero-pdf2zh-server python=3.12 -y\n\n# 激活环境\nconda activate zotero-pdf2zh-server\n\n# 安装依赖\npip install -r requirements.txt\n\n# 启动服务\npython server.py --env_tool=conda --enable_venv=False\n```\n\n#### 手动安装依赖（如果只需要特定引擎）\n\n```shell\n# 如果只使用 pdf2zh:\npip install pdf2zh==1.9.11 numpy==2.2.0\n\n# 如果只使用 pdf2zh_next:\npip install pdf2zh_next\n```\n\n### 一键启动脚本\n\n每次翻译都需要打开终端执行启动命令，为了方便日常使用，您可以配置一键启动：\n\n**方式一：使用 uv 的用户**\n\n**Windows 用户 - 创建桌面快捷脚本：**\n\n1. 先在当前终端输入 `cd` 命令查看完整路径\n```shell\ncd\n```\n终端会显示类似：`D:\\zotero-pdf2zh\\server` 的路径\n\n2. 在桌面新建一个文本文件，右键编辑，写入以下内容：\n```bat\n@echo off\ncd \u002Fd \u003C粘贴刚才复制的路径>\nuv run --python 3.12 --with-requirements requirements.txt server.py\npause\n```\n\n3. 将 `\u003C粘贴刚才复制的路径>` 替换为您复制的实际路径\n\n4. 重命名为 `start-pdf2zh.bat`（后缀名必须是 `.bat`）\n\n5. 保存后双击即可启动\n\n**macOS \u002F Linux 用户 - 配置别名（alias）：**\n\n1. 打开终端，编辑 shell 配置文件：\n\n```shell\n# 如果使用 zsh（macOS 默认）\nnano ~\u002F.zshrc\n# 如果使用 bash\nnano ~\u002F.bashrc\n```\n\n2. 在文件末尾添加别名（请根据实际路径修改）：\n\n```shell\nalias pdf2zh-start='cd \u002Fpath\u002Fto\u002Fzotero-pdf2zh\u002Fserver && uv run --python 3.12 --with-requirements requirements.txt server.py'\n```\n\n3. 保存后执行：\n\n```shell\nsource ~\u002F.zshrc\n# 或\nsource ~\u002F.bashrc\n```\n\n4. 之后只需在终端输入 `pdf2zh-start` 即可一键启动\n\n**方式二：使用 conda 的用户**\n\n**Windows 用户 - 创建桌面快捷脚本：**\n\n1. 先在当前终端输入 `cd` 命令查看完整路径\n```shell\ncd\n```\n终端会显示类似：`D:\\zotero-pdf2zh\\server` 的路径\n\n2. 在桌面新建一个文本文件，右键编辑，写入以下内容：\n```bat\n@echo off\ncd \u002Fd \u003C粘贴刚才复制的路径>\npython server.py --env_tool=conda\npause\n```\n\n3. 将 `\u003C粘贴刚才复制的路径>` 替换为您复制的实际路径\n\n4. 重命名为 `start-pdf2zh-conda.bat`（后缀名必须是 `.bat`）\n\n5. 保存后双击即可启动\n\n**macOS \u002F Linux 用户 - 配置别名（alias）：**\n\n1. 打开终端，编辑 shell 配置文件：\n\n```shell\n# 如果使用 zsh（macOS 默认）\nnano ~\u002F.zshrc\n# 如果使用 bash\nnano ~\u002F.bashrc\n```\n\n2. 在文件末尾添加别名（请根据实际路径修改）：\n\n```shell\nalias pdf2zh-start='cd \u002Fpath\u002Fto\u002Fzotero-pdf2zh\u002Fserver && python server.py --env_tool=conda'\n```\n\n> 💡 注意：使用此别名前，请确保已初始化 conda（通常在安装 conda 后会自动添加到 `.bashrc` 或 `.zshrc` 中）\n\n3. 保存后执行：\n\n```shell\nsource ~\u002F.zshrc\n# 或\nsource ~\u002F.bashrc\n```\n4. 之后只需在终端输入 `pdf2zh-start` 即可一键启动\n\n# 常见问题（FAQ）\n\n### 关于网络\n\n-   **[🔥高频问题]Q：我遇到了网络问题（NetworkError when attempting to fetch resource），该怎么办？**\n-   A：\n    -   **首先点击插件设置页面中\"Python Server IP\"旁边的\"检查连接\"按钮**，查看连接状态\n    -   若显示连接失败，请按以下步骤排查：\n        -   确保插件是最新版：版本号4.0.x，而不是旧版本：3.0.x或2.4.3\n        -   翻译过程中需要保证server.py脚本开启\n        -   请检查8890端口是否被其他程序占用\n        -   切换端口重试（可以多次尝试更换新的端口）\n            -   切换端口需要修改两个地方（以新端口号为9999为例）\n                -   zotero插件配置里的python server ip里的8890修改为9999\n                -   执行脚本时的指令修改为：`python server.py --port=9999`\n        -   检查防火墙是否开启\n        -   关闭杀毒软件并重启电脑\n    -   另外如果您执行翻译时，终端有日志输出\u002F正在尝试翻译，此后报网络错误，则不符合上述情况，应该优先解决终端中提示的报错。\n\n-  **[🔥高频问题]Q: 翻译卡在某个地方不动了 \u002F pdf2zh_next第一次翻译时进度条一直卡在某一处（例如10\u002F100）\u002F 出现assets download failed问题**\n-   A：\n    -   这是因为pdf2zh_next在首次启动时，需要远程下载字体和模型文件，这个过程比较慢。\n    -   您可以：\n        -   访问pdf2zh_next的最新release: https:\u002F\u002Fgithub.com\u002FPDFMathTranslate-next\u002FPDFMathTranslate-next\u002Freleases, 下载其中的exe包，例如：pdf2zh-v2.6.4-BabelDOC-xxx-with-assets-win64.zip\n            -   如果由于网络问题无法下载, 请加入QQ群下载群文件\n        -   解压后打开其中的pdf2zh.exe，然后打开命令行中提示的gui路径(`http:\u002F\u002F127.0.0.1:7860\u002F`)，翻译一篇文章后退出。\n        -   回到插件重新翻译。\n\n    **为什么这样做是有效的：**\n    -   **资源已下载并加入缓存**：通过exe包完成一次翻译后，字体和模型文件会被下载并缓存到系统中。之后再次使用插件时，就可以直接使用缓存的资源，无需重新下载。\n    -   **网络环境检查**：如果依然出现下载失败的情况，请检查您的网络环境是否能够正常访问GitHub或相关资源服务器。您可以尝试切换网络、使用代理工具，或者加入QQ群下载群文件中的离线资源包。\n    \n\n### 关于环境\n\n-   **[🔥高频问题]Q：我遇到了““动态链接库(DLL)初始化例程失败”的错误，但是我尝试安装了提示中指定的[vs_redist.x64.exe](https:\u002F\u002Faka.ms\u002Fvs\u002F17\u002Frelease\u002Fvc_redist.x64.exe)包，依然报错，该怎么办？**\n-   A：\n    -   您需要进入虚拟环境，将onnx包降级到`1.16.1`版本\n        -   pdf2zh 对应的虚拟环境名为`zotero-pdf2zh-venv`\n        -   pdf2zh_next对应的虚拟环境名为`zotero-pdf2zh-next-venv`\n        -   如果您依然不会操作，可以把这段内容发送给AI，并且告诉它您正在使用uv还是conda进行虚拟环境管理。\n    -   您也许缺少的是x86或其他版本的Visual C++ Redistributable，可以尝试安装以下三个文件：\n        -   [VC_redist.x86.exe](https:\u002F\u002Faka.ms\u002Fvs\u002F17\u002Frelease\u002Fvc_redist.x86.exe)（32位版本）\n        -   [VC_redist.x15.x64.exe](https:\u002F\u002Faka.ms\u002Fvs\u002F16\u002Frelease\u002Fvc_redist.x64.exe)（64位版本，2015-2019）\n        -   [VC_redist.x17.x64.exe](https:\u002F\u002Faka.ms\u002Fvs\u002F17\u002Frelease\u002Fvc_redist.x64.exe)（64位版本，2015-2022）\n        -   如果您在QQ群中，也可以直接在群文件中下载这三个文件\n    -   也许您正在使用macOS旧版本系统（这个问题大部分发生在windows系统中），您需要在安装时python虚拟环境指定为3.11而不是3.12\n    -   另有群友贡献的方法供您尝试:\n        - \u003Cimg src=\".\u002Fimages\u002Fonnx-solution.png\" style=\"width: 100px\"\u002F>\n\n-  **[🔥高频问题]Q: 我的命令行中提示: Failed to canonicalize script path**\n-  A: 删除`server`路径下的`zotero-pdf2zh-next-venv`或者`zotero-pdf2zh-venv`文件夹, 然后重新配置。使用uv方法在安装配置后不可以修改路径名\u002F移动文件夹。\n\n### 关于翻译服务\n\n-   **Q：我没配置API，可以用吗？**\n-   A：不可以，除非您使用的是免费的服务。\n    -   例如，如果您选择pdf2zh_next引擎，并且使用siliconflowfree服务，就可以获得免费的服务，但是本服务可能会漏翻译一些内容。建议您优先自己配置API。\n\n-   **[🔥高频问题]Q：我正在使用bing\u002Fgoogle，也是免费的，但是翻译到一半就报错了\u002F卡住了\u002F中止了**\n-   A：因为bing\u002Fgoogle的限流较为严重，您需要把线程数设置得非常低。建议您最好换到更加稳定的服务，以便长期使用。\n\n-   **Q：我感觉这个翻译消耗的Token很多，怎么办？**\n-   A：\n    -   通常一篇10页的英文文献消耗Token量在7～10w左右，单页在5k左右，您可以先基于此数据进行检查\n    -   如果您正在使用pdf2zh_next引擎，可以尝试在zotero插件配置中，把提取术语表选项关闭，这个选项会消耗较多Token\n\n-   **[🔥高频问题]Q：翻译后部分段落缺失（未被翻译），该怎么办？**\n-   A：\n    -   **原因说明**：为了保证PDF能够正常生成，当翻译失败时，程序会使用原文替代翻译后的位置，因此会出现部分段落未翻译的情况。\n    -   **解决方法**：\n        1.  尝试更换翻译引擎（pdf2zh\u002Fpdf2zh_next）\n        2.  检查您的API是否超限（查看终端报错信息或API服务商后台）\n        3.  如果使用的是免费服务（如bing\u002Fgoogle），可能是限流导致，建议切换到更稳定的服务\n\n\n### 关于OCR\u002F扫描件\n\n-   **[🔥高频问题]Q1：翻译界面提示 Scanned PDF detected, 翻译失败**\n-   A：\n    -   pdf2zh和pdf2zh_next不直接提供文档OCR功能, 您需要用其他工具对自己的扫描版文件进行OCR处理, 再调用插件的翻译功能。\n    -   推荐使用 Adobe Acrobat Pro、ABBYY FineReader 或其他OCR工具对扫描版PDF进行文字识别处理，然后再使用本插件进行翻译。\n\n-   **Q2：pdf2zh_next服务中的ocr模式与兼容模式是指什么？**\n-   A：\n    -   OCR选项并不是直接提供OCR服务的，它只是一个对于OCR后的文件进行兼容的临时方案，您保持自动开启OCR临时方案的选项开启即可。\n    -   兼容模式生成的文件大小会更大，您在非必要的时候不需要开启。（如果您翻译功能正常，但是某一次失败了\u002F并且确定不是远程翻译服务的问题，那您可以尝试开启）\n\n### 关于翻译效果\n\n-   **Q：为什么会出现段落缺失、断行或重影的情况？**\n-   A：\n    -   **扫描件问题**：如果文档本身是扫描件，必须先经过OCR处理后再进行翻译。若未进行OCR识别，会导致断行或段落缺失问题。\n    -   **重影现象**：出现的重影通常是由于OCR识别不准确或PDF文件本身的问题导致的。建议使用高质量的OCR工具重新处理文档。\n    -   **段落缺失**：如前文所述，翻译失败时程序会用原文替代，建议先排查API服务是否正常。\n\n### 关于插件功能\n\n-   **Q：我不知道zotero插件里的各个功能是什么意思**\n-   A：您可以自由尝试，请尽量不要对这些问题进行提问，翻译引擎具有缓存的设置，也就是说您重复对同一篇文献进行翻译时，可能不会消耗过多的Token（不能保证完全不消耗）\n\n\n### 关于提问\n\n**提问前请先尝试以下方法：**\n  - 将终端报错信息发送给AI（ChatGPT、Gemini、DeepSeek等）进行分析\n  - 在本文档中搜索错误关键词或查阅相关章节\n\n**如需在群内提问，请提供：**\n  - 终端完整输出（复制到txt文件）\n  - Zotero设置截图\n  - Zotero弹窗截图\n  - 说明您已尝试过的解决方法\n\n-   **Q：我在群里问问题，怎么没人回复我？**\n-   A：\n    -   请确认您的问题不属于常见问题，或在问题描述中说明\"已查阅常见问题但仍未解决\"\n    -   请提供终端输出、Zotero设置截图和弹窗截图，以便定位问题\n    -   如果被漏看，可以稍后重新发或@群主\n\n-   **Q：可是我给作者打赏了，希望能得到优先支持。**\n-   A：非常感谢您的支持！打赏是对项目的肯定和鼓励，如果打赏后遇到问题，欢迎私聊群主，我会尽力协助您解决。\n\n\n### 关于支持本插件\n\n-   **Q：我很喜欢这个插件，想要提供支持，让这个插件更好地长期运行，我该怎么做？**\n-   A：\n    -   您可以继续下滑，找到支持本项目开发者的方式（支付码\u002F爱发电等方式，您的昵称将出现在赞助者名单）\n    -   您可以参与本项目的开发\n    -   您可以为本项目点一个star\n    -   您可以在issue区提出您期望的未来功能（需是合理的功能建议）\n    -   您可以将本插件推荐给身边的朋友，并且在他们的安装过程中给出一些指导\n\n\n# 致谢\n\n- [PDF2zh](https:\u002F\u002Fgithub.com\u002FByaidu\u002FPDFMathTranslate) by [@Byaidu](https:\u002F\u002Fgithub.com\u002FByaidu) \n-  [PDF2zh_next](https:\u002F\u002Fgithub.com\u002FPDFMathTranslate-next\u002FPDFMathTranslate-next) by [@awwaawwa](https:\u002F\u002Fgithub.com\u002Fawwaawwa)\n- [zotero-plugin-template](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-plugin-template) by [@windingwind](https:\u002F\u002Fgithub.com\u002Fwindingwind)\n- [沉浸式翻译](https:\u002F\u002Fimmersivetranslate.com)为本项目的活跃贡献者赞助每月Pro会员兑换码，详情请见：[CONTRIBUTOR_REWARD.md](https:\u002F\u002Fgithub.com\u002Ffunstory-ai\u002FBabelDOC\u002Fblob\u002Fmain\u002Fdocs\u002FCONTRIBUTOR_REWARD.md)\n\n# 贡献者\n\n感谢各位贡献者对项目的付出!!\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fguaguastandup\u002Fzotero-pdf2zh\u002Fgraphs\u002Fcontributors\"> \u003Cimg src=\"https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=guaguastandup\u002Fzotero-pdf2zh\" \u002F>\u003C\u002Fa>\n\n**贡献者名单**：\n\n[![guaguastandup](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=@guaguastandup&message=Author&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27)](https:\u002F\u002Fgithub.com\u002Fguaguastandup)\n[![Aphcity](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=@Aphcity&message=Contributor&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27)](https:\u002F\u002Fgithub.com\u002FAphcity)\n[![Bocheng-L](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=@Bocheng-L&message=Contributor&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27)](https:\u002F\u002Fgithub.com\u002FBocheng-L)\n[![htyxyt](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=@htyxyt&message=Contributor&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27)](https:\u002F\u002Fgithub.com\u002Fhtyxyt)\n[![Rosetears520](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=@Rosetears520&message=Contributor&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27)](https:\u002F\u002Fgithub.com\u002FRosetears520)\n[![taozhe6](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=@taozhe6&message=Contributor&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27)](https:\u002F\u002Fgithub.com\u002Ftaozhe6)\n[![Norhua](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=@Norhua&message=Contributor&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27)](https:\u002F\u002Fgithub.com\u002FNorhua)\n[![KANIKIG](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=@KANIKIG&message=Contributor&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27)](https:\u002F\u002Fgithub.com\u002FKANIKIG)\n[![Snowflake-Pink](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=@Snowflake-Pink&message=Contributor&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27)](https:\u002F\u002Fgithub.com\u002FSnowflake-Pink)\n[![LinHuanli](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=@LinHuanli&message=Contributor&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27)](https:\u002F\u002Fgithub.com\u002FLinHuanli)\n[![chunzhimoe](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=@chunzhimoe&message=Contributor&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27)](https:\u002F\u002Fgithub.com\u002Fchunzhimoe)\n[![tcpsoftware](https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=@tcpsoftware&message=Contributor&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27)](https:\u002F\u002Fgithub.com\u002Ftcpsoftware)\n\n# 如何支持我\n\n💐 免费开源插件，您的支持是我继续开发的动力～祝您科研\u002F工作\u002F学习顺利!\n- 赞助时, 请在备注中留下您希望出现在赞助者名单的姓名或昵称💗\n- ☕️ [Wechat微信\u002FAlipay支付宝](https:\u002F\u002Fgithub.com\u002Fguaguastandup\u002Fguaguastandup)\n- 🐳 [爱发电](https:\u002F\u002Fafdian.com\u002Fa\u002Fguaguastandup)\n- 🤖 【SiliconFlow邀请链接】: https:\u002F\u002Fcloud.siliconflow.cn\u002Fi\u002FWLYnNanQ\n- 🤖 【方舟Coding Plan邀请链接】: 方舟 Coding Plan 支持 Doubao、GLM、DeepSeek、Kimi 等模型，工具不限，现在订阅折上9折，低至8.9元，订阅越多越划算！立即订阅：https:\u002F\u002Fvolcengine.com\u002FL\u002FnVFMmMWNd6U\u002F  邀请码：8EYCPKHC\n- 🤖 【GLM Coding Plan邀请链接】: 🚀 速来拼好模，智谱 GLM Coding 超值订阅，邀您一起薅羊毛！Claude Code、Cline 等 20+ 大编程工具无缝支持，“码力”全开，越拼越爽！立即开拼，享限时惊喜价！链接：https:\u002F\u002Fwww.bigmodel.cn\u002Fglm-coding?ic=44Y4L3RHPG\n\n- 赞助者名单(持续更新), 按照时间先后排序:\n  - 我会定期重复检查，但如果仍然有统计遗漏, 请您联系我, QQ: 546409178\n  - 如果您希望在赞助者名单中补充您的昵称和您的个人主页链接，也请联系我~\n\u003Cdiv align=\"center\">\n  \u003Ch3>赞助者名单\u003C\u002Fh3>\n  \u003Cp>感谢您的支持! 您的支持是我开发的动力~\u003C\u002Fp>\n  \u003Cbr>\n  \u003Cdiv style=\"display: flex; flex-wrap: wrap; justify-content: center; gap: 4px;\">\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fawwaawwa\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=awwaawwa&message=GitHub%20x8&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27\" alt=\"awwaawwa\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fhtyxyt\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=htyxyt&message=GitHub&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27\" alt=\"htyxyt\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fspace.bilibili.com\u002F347580558\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=jiajia&message=Bilibili&color=fb7299&labelColor=f5fbf0&style=flat-square&logo=bilibili&logoColor=fb7299\" alt=\"jiajia\">\u003C\u002Fa>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=bibiu77&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"bibiu77\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%2A%E7%90%B0&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"*琰\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%2A%E5%86%AC%E8%90%8D&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"*冬萍\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%E9%98%BF%E8%B5%9F&message=x4&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"阿赟\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%2A%E5%A3%B0&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"*声\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=h%2Au&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"h*u\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%E7%88%B1%E5%8F%91%E7%94%B5%E7%94%A8%E6%88%B7&message=96598&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"爱发电用户\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=soooda&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"soooda\">\n    \u003Ca href=\"https:\u002F\u002Frosetears.cn\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%E6%B3%AA%E8%8A%B1%E8%8A%B1&message=Roseteaers%20x2&color=fb7299&labelColor=f5fbf0&style=flat-square&logo=roseteaers&logoColor=fb7299\" alt=\"泪花花\">\u003C\u002Fa>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%E7%8B%90%E7%8B%B8&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"狐狸\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%E5%B1%B1%E9%97%B4%E7%81%AB&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"山间火\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=Angus&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"Angus\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%E7%A0%94%E7%A9%B6%E6%89%80&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"研究所\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=Henrietta&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"Henrietta\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%E5%8C%BF%E5%90%8D&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"匿名\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%E6%9F%BF%E5%8D%81&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"柿十\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%2A%E5%B7%9D&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"*川\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=Milse&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"Milse\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=n%2Ar&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"n*r\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%2A%E7%B3%96&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"*糖\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%E5%B0%8F%E9%A9%AC&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"小马\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%2A%2A%E9%BE%99&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"**龙\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%2Au&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"*u\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=prprprprpprpr&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"prprprprpprpr\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=Lstar&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"Lstar\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%2A%E5%A4%B4&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"*头\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=YoungEmperorCaesar&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"YoungEmperorCaesar\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=Yuriart&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"Yuriart\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=J%2Ah&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"J*h\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=GeorgeXiaobinRen&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"GeorgeXiaobinRen\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=Keeptg&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"Keeptg\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=h%2Ao&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"h*o\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=C%2Au&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"C*u\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%E8%8E%AB%E6%9E%97&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"莫林\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%2A%E8%90%8C&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"*萌\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%2A%E5%B7%9D&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"*川\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%2A%E5%8D%9A&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"*博\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=Sine%E7%92%87&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"Sine璇\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%F0%9F%90%91H-Yang%E7%8B%AC%E8%A7%92%E5%85%BD%E5%85%88%E7%94%9F&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"🐑H-Yang独角兽先生\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%2A%E6%B4%8B&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"*洋\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=kylinduu&message=Sponsor&color=e8f5e0&labelColor=ffffff&style=flat-square\" alt=\"kylinduu\">\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FGavin-Meskin-Chen\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fstatic\u002Fv1?label=%E5%8D%97%E6%96%B9%E5%98%89%E6%9C%A8&message=GitHub&color=2d5a27&labelColor=f5fbf0&style=flat-square&logo=github&logoColor=2d5a27\" alt=\"南方嘉木\">\u003C\u002Fa>\n  \u003C\u002Fdiv>\n  \u003Cdiv style=\"margin-top: 20px;\">\n    \u003Cimg src=\".\u002Fimages\u002Fchii.jpg\" alt=\"感谢\" width=\"150\" style=\"border-radius: 10px;\" \u002F>\n  \u003C\u002Fdiv>\n\u003C\u002Fdiv>\n# Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=guaguastandup\u002Fzotero-pdf2zh&type=Date)](https:\u002F\u002Fwww.star-history.com\u002F#guaguastandup\u002Fzotero-pdf2zh&Date)\n\n# 开源协议与使用声明\n\n本项目采用开源协议发布，所有开发者在使用本插件代码时必须遵循以下原则：\n\n1. **遵守开源协议**：使用本项目的代码必须遵循本项目所采用的AGPL开源协议（详见 [LICENSE](.\u002FLICENSE) 文件），包括但不限于保留版权声明、开源修改后的代码等。\n\n2. **禁止商业倒卖**：本插件为**免费开源项目**，严禁任何形式的商业倒卖行为，包括但不限于：\n   - 将本插件打包后以收费形式出售\n   - 以\"代安装\"、\"技术服务\"等名义收取高额费用后交付本插件\n   - 将本插件作为付费产品的一部分进行销售\n\n   > ⚠️ **特别提醒**：商业贩子请勿加入QQ群提问，不要消耗维护者的精力。一旦发现，将直接移出群聊并拉黑。\n\n3. **合理使用**：欢迎个人学习、研究、非商业用途的使用。如需商业使用，请联系作者获取授权。\n\n4. **尊重开源精神**：我们鼓励开发者基于本项目进行改进和贡献，但请尊重原作者的劳动成果，遵守开源社区的基本准则。\n\n如发现违反上述原则的行为，作者保留追究法律责任的权利。\n","Zotero PDF2zh 是一个用于 Zotero 的插件，旨在帮助用户将PDF文档中的内容翻译成中文。它利用了 PDF2zh 和 PDF2zh_next 两个项目来实现这一功能。该插件支持Zotero 7和8版本，并基于Python语言开发，易于安装且兼容性强。其核心优势在于能够直接在Zotero环境中对选定的PDF文件进行全文翻译，极大地提高了研究者处理外文文献时的效率。此工具非常适合需要频繁阅读英文或其他非中文语种学术资料的研究人员、学生以及任何希望无障碍访问多语言信息的人士使用。",2,"2026-06-11 03:40:46","high_star"]