Doc2X Zotero Plugin User Guide
This document provides instructions on how to install and use the Doc2X Zotero plugin for intelligent parsing and translation of PDF documents.
Prerequisites
1. Install Better Notes for Zotero
Download Link: Better notes for Zotero
2. Install Doc2X Client and Plugin
You need to download the following two components:
- Doc2X Official Client Download Link
- Doc2X Plugin XPI File Download Link
Note: Some browsers don't recognize XPI files and may report them as corrupted. We recommend using Edge or Chrome browsers to resolve this issue.
3. Register Doc2X Account
Registration Link: doc2x.noedgeai.com
Video Tutorial
Detailed Operation Video: https://www.bilibili.com/video/BV19Yf5YXEDF
Usage Workflow
Step 1: Install Required Components
Ensure all the following components are installed:
- ✅ Zotero
- ✅ Doc2X Client
- ✅ Better Notes Plugin
- ✅ Doc2X Plugin
Step 2: Configure Plugin Settings
After installation, open the plugin and desktop client (ensure you're logged into your Doc2X account)
Windows System Settings
- Supported Versions: Only Win10 and Win11 supported
- Not Supported: Zotero6 version
- Access Path: Zotero7 → Edit → Settings
Mac System Settings
- Supported Versions: Currently only M-series chips supported
- Access Path: Zotero → Settings
Zotero System Settings
- Plugin version 1.0.18 and later supports Zotero7 and Zotero 8 Beta
Important Reminder: If you need to update the Zotero plugin, you must first uninstall the old version → close Zotero → reopen Zotero → install the new version, otherwise various issues may occur due to Zotero bugs.
Step 3: Get Token
- Open the Doc2X client
- Click "Get Token" in plugin settings
- Mac: Top-left status bar Zotero - Settings - Doc2X - Click Get Token
- Windows: [Same process]
- Check token status and parsing count display
Cost Information
- Paid Models: Consume points and parsing pages
- Free Models: Only consume parsing pages
Step 4: Start Using
Right-click on a PDF with a parent item to see Doc2X-related options.
Important Usage Notes
Large File Processing Recommendations
- Not recommended to translate PDFs with many pages (>100 pages) in Zotero
- Status updates may not be obvious during long PDF translations
- No progress updates doesn't mean translation is stuck - please be patient
- You can check real-time translation progress in the client
DeepSeek Model Special Notice
DeepSeek model takes longer during translation, please be patient.
Translation Error Handling
If you encounter translation stage errors (parsing completed and parsing pages deducted, but translation process failed):
Correct Approach:
- Select the related result in the client's left task bar
- Click "Continue Translation"
- This operation only deducts points and won't deduct parsing pages again
- In the client, use the export option in the top-right corner to export to Zotero
Incorrect Approach:
- ❌ Don't re-initiate translation in Zotero
System Compatibility
| Operating System | Supported Versions | Zotero Version | Status |
|---|---|---|---|
| Windows | Win10/Win11 | Zotero7, Zotero8 Beta | ✅ Supported |
| Windows | Win10/Win11 | Zotero6 | ❌ Not Supported |
| Mac | M-series Chips | Zotero7, Zotero8 Beta | ✅ Supported |
| Mac | Intel Chips | - | ❌ Not Yet Supported |
Issue Feedback
If you encounter any bugs or issues, please contact us through:
Frequently Asked Questions
Q: What to do when XPI file shows as corrupted?
A: Switch to Edge or Chrome browser for installation.
Q: Is it normal for translation progress to remain unchanged for long periods?
A: Yes, this is normal, especially when using DeepSeek model. Please be patient and check real-time progress in the client.
Q: How to avoid duplicate charges?
A: After translation failure, continue translation in the client rather than re-initiating in Zotero.
Q: Which Zotero versions are supported?
A: Currently only Zotero7 is supported; Zotero6 is not supported.