guaguastandup/zotero-pdf2zh

Zotero PDF2zh – Zotero内蔵のAI PDF翻訳ツール

概要

• Zoteroライブラリから直接PDF論文を翻訳できるZoteroプラグイン（および軽量なPythonサーバー）です。
• オープンソースの PDFMathTranslate / PDFMathTranslate-next エンジンを使用し、LLM API（OpenAI、DeepSeek、SiliconFlowなど）を呼び出して、数式やレイアウト、オプションのバイリンガル表示を保持したまま中国語翻訳を生成します。

主な機能

機能	内容
2つの翻訳バックエンド	pdf2zh（旧版、高速、カスタムフォント）と pdf2zh_next（アクティブ保守、テーブル/OCRサポート、用語抽出）。
バイリンガルPDF出力	原文と翻訳文を左右または上下に配置した新しいPDFを生成します。
クロップ＆比較モード	2段組論文のページを半分にカットして結合し、スマホで読みやすくします。
一括翻訳	Zoteroで複数の項目を選択し、一度に翻訳できます。
進捗UI	Webダッシュボード (http://127.0.0.1:8890) でタスク状況や履歴を確認し、結果をダウンロードできます。
LLMサービス管理	プラグイン内のUIから、多くのプロバイダー（OpenAI互換、DeepSeek-V4、SiliconFlow-free、Bing/Google、智譜、阿里云 DashScopeなど）のAPIキー/URLを追加し、レート制限 (qps, poolsize) を設定できます。
Docker / Homebrew / Windows-exe	Pythonサーバーには、Windows実行ファイルやDockerイメージなど、複数のデプロイオプションがあります。
自動更新	プラグインは新リリースをチェックします。サーバーはGitHubやGiteeから更新を取得し、Pythonパッケージ自体を更新することも可能です。

仕組み

1. プラグインのインストール (.xpi) をZotero（バージョン7-10対応）に行います。
2. コンパニオンサーバーの実行 – 翻訳エンジンを読み込み、設定したLLM APIと通信する小さなPythonスクリプト (server.py) です。翻訳中はサーバーを起動しておく必要があります。
3. LLMの設定 – プラグインの「LLM API設定」パネルでURL、APIキー、モデル名、オプションの *_enable_json_mode を入力します。
4. PDFを右クリック（またはZotero項目）→ 4つのアクションから選択：
   • Translate PDF – 翻訳済みPDFを作成。
   • Crop PDF – スマホ読書用にワイドな論文を半分にカット。
   • Compare PDF – バイリンガル表示。
   • Crop-compare PDF – クロップして比較（2段組論文用）。
5. 進捗の確認 – ZoteroのステータスバーまたはWebダッシュボードで確認。完了すると新しいPDFがライブラリに表示されます。

インストールクイックスタート

• Python 3.12とZoteroをインストールします。
• 仮想環境マネージャー（uv推奨、またはConda）をインストールします。
• server.zip リリースをダウンロードし、zotero-pdf2zh/server に解凍します。
• サーバーを起動します（例: uv run --python 3.12 --with-requirements requirements.txt server.py またはConda相当のコマンド）。
• Zotero → ツール → アドオンから .xpi プラグインをインストールします。
• プラグイン設定を開き、「接続チェック」ボタンをテストし、LLM APIを追加すれば翻訳準備完了です。

対象ユーザー

• Zoteroで論文を管理し、リファレンスマネージャーを離れずに中国語翻訳が必要な研究者や学生。
• 元のPDFレイアウト（数式、表）を保持しつつ、読みやすいバイリンガル版を入手したい方。

制限事項 / 注意点

• サーバーを起動し続ける必要があります。ターミナルを閉じると翻訳が停止します。
• 無料サービス（例: SiliconFlow-free）では一部の文章が欠落する可能性があります。高品質な翻訳には有料のLLMキーを使用してください。
• Windowsユーザーはプロジェクトをシステムドライブに置かないようにし、ターミナルを管理者として実行する必要がある場合があります。
• 本プロジェクトは大幅な書き換え中です（2026年8月現在）。現在のバージョンは安定していますが、新リリースまで貢献は一時停止されています。

---

要約: Zotero PDF2zhは、実用的なオープンソースのZoteroプラグインと軽量なPythonサーバーの組み合わせです。LLM APIを使用してPDFを中国語に翻訳し、フォーマットを保持したままバイリンガルPDFの作成、一括処理、Web UIによる進捗監視を提供します。複数のデプロイ方法と多様なLLMプロバイダーをサポートしており、Zotero内でのAI支援による学術読書を実用的なものにします。