Zotero-OCR插件通过集成Tesseract和pdftoppm为扫描版PDF添加可搜索文本层，需先安装依赖、配置正确路径与语言（如eng+chi_sim），再右键执行OCR实现全文搜索与复制。
当你在Zotero里双击打开一篇扫描版PDF，发现无法用Ctrl+F搜到任何文字，说明它缺少可搜索文本层——这正是Zotero-OCR插件要解决的核心问题。它不改变原文件，而是在PDF内部嵌入一层隐藏的文本，让全文搜索、复制粘贴、引用提取全部变成现实。
确认系统已装好OCR底层工具
Zotero-OCR本身不自带识别能力，必须依赖外部命令行工具：Tesseract负责“看懂”图片里的字，pdftoppm负责把PDF每页转成清晰图像供识别。缺一不可，且路径必须准确指向可执行文件。
macOS用户打开终端，依次运行：
brew install tesseract poppler
Windows用户需手动下载Tesseract安装包（推荐tesseract-ocr-w64-setup-v5.4.0.20240803.exe），勾选“Add Tesseract to your system PATH”；同时从poppler官网下载Windows版poppler，解压后将bin目录加入系统环境变量。
【关键验证】在终端或命令提示符中分别输入tesseract --version和pdftoppm -v，两行都必须返回版本号，否则后续配置必然失败。
安装Zotero-OCR插件并重启
访问插件官方仓库（https://gitcode.com/gh_mirrors/zo/zotero-ocr），进入Releases页面，下载最新.xpi文件（如zotero-ocr-2.7.1.xpi）。
Zotero 7用户：顶部菜单栏→工具→插件→右上角齿轮图标→从文件安装插件→选中下载的.xpi文件→点击安装。
Zotero 6用户：顶部菜单栏→工具→附加组件→将.xpi文件直接拖入窗口空白处→确认安装。
安装完成后必须关闭并重新启动Zotero，否则插件不会加载进界面。
配置OCR路径与语言参数
第一步：打开Zotero→编辑→首选项→Zotero OCR选项卡。
第二步：在“Tesseract路径”框中填入完整绝对路径：
macOS/Linux示例：/usr/local/bin/tesseract
Windows示例：C:\Program Files\Tesseract-OCR\tesseract.exe
第三步：在“pdftoppm路径”框中填入对应路径：
macOS/Linux示例：/usr/local/bin/pdftoppm
Windows示例：C:\poppler\Library\bin\pdftoppm.exe（注意是bin目录下的exe，不是根目录）
第四步：语言设置默认为eng（英语），若处理中文PDF，必须在此处添加chi_sim（简体中文）或chi_tra（繁体中文），多个语言用加号连接，例如：eng+chi_sim。不填中文语言码，识别中文会基本失败。
【易错提醒】不要复制网上教程里的“/opt/homebrew/bin/tesseract”这类Homebrew Cellar路径——它随更新频繁变动，务必用which tesseract命令查到的真实路径。
对单个PDF执行OCR并验证效果
方法一：右键点击Zotero库中某篇扫描PDF条目→选择“OCR PDF”→等待进度条结束（首次可能需数秒至数分钟，取决于页数和DPI设置）。
方法二：选中PDF条目→顶部菜单栏→工具→OCR PDF。
OCR完成后，双击打开该PDF，在Adobe Reader或Zotero内置阅读器中按Ctrl+F输入任意原文关键词，应能立刻定位高亮；尝试选中一段文字复制，粘贴后应为可编辑文本而非乱码或空格。
若搜索失败或复制出□□□，说明OCR未生效——立即检查Tesseract路径是否正确、语言码是否包含对应语种、PDF是否被加密（加密PDF需先解密才能OCR）。
