インストールガイド
システム要件
- Zotero: 7.0以降（Zotero 9推奨）
- プラットフォーム: Windows 10以降、macOS 12以降、Linux（x86_64 / x86 / ARM64 / ARM）
Zoteroバージョンについて: 本プラグインはZotero 9で開発・テストされている。Zotero 8は理論上完全にサポートされている（プラグインフレームワークはZotero 8/9間で大きな変更なし）。Zotero 7も理論上サポートされるはずだが、リソースの制約により十分にテストされてはいない。今後のメンテナンスはZotero 9に注力する。Zotero 7で問題が発生した場合はIssuesで報告されたい。
プラグインのインストール
GitHub/Giteeリリースから（推奨）
- GitHub ReleasesまたはGitee Releasesミラーにアクセス
- 最新の
.xpiファイルをダウンロード - Zoteroでツール → アドオンを開く
- 歯車アイコンをクリックし、**ファイルからアドオンをインストール...**を選択
- ダウンロードした
.xpiファイルを選択
Zotero プラグインマーケットプレイス経由
Zotero プラグインマーケットプレイスプラグインをインストールしている場合、マーケットプレイスから直接 Zotero Agents を検索してインストールできます：
- Zotero ツールバーの
アイコンをクリックしてマーケットプレイスを開く - Zotero Agents を検索
- インストールをクリック
ソースからビルド
git clone https://github.com/leike0813/zotero-agents.git
cd zotero-agents
npm install
npm run build
ビルド出力は.scaffold/build/ディレクトリに配置される。
公式Workflowパッケージのインストール
本プラグインには組み込みのビジネスロジックはない。すべてのWorkflowは公式Workflowパッケージとして別途提供される。
方法1：メニューからのインストール（推奨）
- Zoteroを再起動後、任意のアイテムを右クリック → Zotero Agents → 📦 公式Workflowパッケージをインストール
- プラグインがGitHub / Giteeから最新の公式パッケージを自動的にダウンロード
- 完了すると成功の通知が表示される。ダッシュボードですべての公式Workflowが参照可能になる
方法2：環境設定からのインストール
- Zotero → 設定 → Zotero Agentsを開く
- Workflow設定セクションで公式Workflowパッケージをインストールをクリック
- 更新チャネル（stable / beta / dev）の切り替えや更新の確認もここで可能
更新メカニズム
- プラグインは起動時に公式パッケージの新バージョンを自動的にチェック
- 新バージョンが利用可能な場合は確認ダイアログが表示される
- 更新後にWorkflowリストが自動的にリロードされる
公式Workflowパッケージリポジトリ：GitHub · Giteeミラー
インストールの検証
- Zoteroを再起動
- ZoteroツールバーにZotero Agentsアイコンが表示される
- 任意のアイテムを右クリックすると、Zotero Agentsサブメニューが表示される（利用可能なWorkflowを含む）
右クリックメニューに📦 公式Workflowパッケージをインストールオプションのみが表示される場合、公式パッケージはまだインストールされていない。上記の手順に従ってインストールされたい。インストールが成功したら、はじめにに進み、バックエンドを設定して最初のWorkflowを実行する。