steven-jianhao-li/zotero-AI-Butler

【Zotero AI 管家】调用大模型，自动精读论文库里的论文，总结为Zotero笔记。支持主流大模型平台！您只需像往常一样把文献丢进 Zotero，管家会自动帮您精读论文，将文章揉碎了总结为笔记，让您“十分钟完全了解”这篇论文！

📚 Zotero‑AI‑Butler とは？

無料のオープンソース Zotero プラグインで、参考文献管理ツール内から大規模言語モデル（LLM）を呼び出すことができます。Zotero に追加した PDF を自動的に読み取り、設定したモデル（Gemini、OpenAI、Claude など）に送信し、構造化された Markdown ノート、マインドマップ、1 ページの「ポスター」画像、さらには文献レビューのドラフトを書き戻します。つまり、Zotero を AI 研究アシスタント に変えます。

🎯 中核機能（README の説明による）

機能	説明	トリガー方法
AI Butler Agent (v5.0)	ライブラリを検索し、証拠を引き出し、モデル生成の回答で返信することで研究質問に答えます。	Butler ダッシュボードの Agent タブを開き、クエリを入力します。
自動ノート生成	新しい PDF が追加されると、プラグインは完全なドキュメント（マルチモーダルモデル用の Base64）を抽出し、LLM に明確な Markdown 要約を生成するよう要求し、Zotero ノートとして保存します。	設定で新規アイテムを自動スキャンを有効にするか、手動スキャンを実行します。
深い読み取り / マルチラウンド要約	論文をセクション（背景、方法、実験、結論）に分割し、複数のモデル呼び出しを実行して、結果を詳細なノートにマージします。	右クリック → AI Butler マルチラウンド再読 → マルチラウンドスプライスまたはマルチラウンド要約を選択します。
1 画像要約	論文の要点を視覚化する単一の学術ポスタースタイル画像（「Nano Banana Pro」サービス経由）を生成します。	右クリック → 1 画像で要約（API キーが必要）。
マインドマップエクスポート	論文の構造のインタラクティブな階層マップを生成します。他のツール用に PNG または OPML としてエクスポートできます。	右クリック → マインドマップを生成。
バッチ文献レビュー	コレクション/フォルダを選択すると、プラグインはすべてのソース PDF にリンクする結合レビュードキュメントを作成します。	コレクションを右クリック → AI Butler 文献レビュー。
サイドバープレビュー	PDF の横に AI 生成ノートを表示し、KaTeX による LaTeX レンダリング、折りたたみ可能なセクション、フォントスケーリング、フォローアップ質問用のクイック質問ボックスを提供します。	サイドバーを開くか、AI‑Butler アイコンをクリックします。
プロンプトテンプレートマネージャー	シングルショット、マルチラウンド、または最終要約呼び出し用の組み込みおよびユーザー定義のプロンプトセット。変数置換のライブプレビュー。	設定 → プロンプトテンプレート。
マルチモデルサポート	Google Gemini、OpenAI（gpt‑5 を含む）、Anthropic Claude、SiliconFlow 互換 API、Volcano‑Argo、Ollama などで動作します。	設定 → API 設定。
テーマと UI 適応	Zotero のライト/ダークモードに一致。選択可能なノートレンダリングテーマ（GitHub、Redstriking）とカスタム CSS。	設定 → UI テーマ。

🛠️ 内部の仕組み（高レベル、README から）

PDF 処理 – プラグインはプレーンテキストを抽出するか、ファイル全体を Base64 エンコードされた blob として送信し、マルチモーダルモデル（例：Gemini 2.5 Pro）が図、表、数式を表示できるようにします。
タスクキュー – 論文はプロデューサー・コンシューマーキューに配置されます。タスクキュー ページでステータス（保留中、実行中、完了、失敗）を表示できます。
プロンプト駆動の LLM 呼び出し – 各機能はプロンプトテンプレートに対応しています。プラグインは {{title}}、{{authors}} などの変数を置換し、設定された API を呼び出します。
結果の保存 – LLM の応答は同じアイテムに添付された Zotero ノートとして保存され、オプションでサイドバーに表示されたり、画像/OPML としてエクスポートされたりします。
設定 – API キーはローカルに保存されます。プラグインは参考文献やキーをサードパーティのサーバーに転送することはありません。

🚀 はじめに

インストール – Releases ページから最新の .xpi をダウンロードし、Zotero の ツール → アドオン ウィンドウにドラッグします。
LLM を設定 – AI Butler → 設定 → API を開き、Gemini、OpenAI、Claude などのキーを貼り付けます。接続テスト をクリックします。
自動スキャンを有効にする（オプション）– 設定 → インターフェース → 新規文献を自動スキャン にチェックを入れます。
タスクを実行 – PDF を右クリック → AI Butler で要約（またはダッシュボードのバッチスキャナーを使用）。

🎓 誰が恩恵を受けるか？

研究者と学生：テキストをチャットウィンドウに手動でコピーせずに、迅速で一貫性のある論文要約が必要な方。
文献レビュー作成者：ソース PDF にすでにリンクしている初期ドラフトが必要な方。
Zotero を使用するすべての人：AI 強化されたノート作成、マインドマップ、またはビジュアルアブストラクトを希望する方。

⚠️ 制限と考慮事項（README による）

独自の API キーを提供する必要があります – プラグインはモデルをホストしません。
トークンコスト – マルチラウンドまたは画像生成モードは多くのトークンを消費する可能性があります。README は高額な API 料金を警告しています。
パフォーマンス – 自動スキャンは Zotero の速度低下を避けるためにデフォルトで無効になっています。有効にする必要があります。
モデル互換性 – Base64 モードはマルチモーダルモデルでのみ機能します。テキストのみのモデルはプレーンテキスト抽出パスが必要です。
プライバシー – すべてのリクエストはマシンからモデルエンドポイントに直接送信されます。プラグインはデータ収集を行わないと主張しています。

📚 さらに読む

完全なユーザーガイド：https://steven-jianhao-li.github.io/zotero-AI-Butler/
Agent の使用詳細：docs/agent.md
提供された BibTeX エントリ（DOI 10.5281/zenodo.20457937）でソフトウェアを引用してください。

Zotero‑AI‑Butler は、Zotero エコシステム内に存在する本格的で機能豊富な AI 拡張研究ツールであり、参考文献をインタラクティブでモデル駆動の学習パートナーに変えます。