FAQ (Frequently Asked Questions)

This document collects common questions and solutions for Zotero PDF2zh plugin.

Coming Soon

English documentation is under construction. Please switch to Chinese for complete documentation.

Question Categories

• Virtual Environment - About conda/uv installation and virtual environment
• Network - About network connection, port occupation, download issues
• Environment - About DLL errors, path configuration
• Translation Service - About API configuration, Token consumption
• Plugin Features - About translation options, OCR
• Asking Questions - About how to ask questions effectively

Quick Troubleshooting

When encountering problems, please troubleshoot in the following order:

1. Check Version - Ensure plugin version is 3.0.x, not old version 2.4.3
2. Check Service - Ensure server.py script is running
3. Check Port - Confirm port 8890 is not occupied
4. View Logs - Read error messages in terminal
5. Search Documentation - Search error messages in this documentation

Get More Help

• 💬 GitHub Issues
• 👥 QQ Group: Group 5: 1064435415 (Answer: github)