トラブルシューティング
リリースやダウンロードにアクセスできない
リリースの XPI と SHA256SUMS はログインせずにダウンロードできます。ソースアーカイブではなく XPI を取得してください。インストール失敗時は Zotero のバージョンと SHA256SUMS を確認します。
タスクがない、PDF が見つからない
解析が有効・保存済みで、PDF がローカルにあるか確認します。不足ファイルは自動取得しません。登録済み項目には添付ファイルを解析を使います。PDF 以外はメタデータのみ保持できます。
待機が続く、処理が失敗する
抽出段階と詳細を確認します。サービス側の待機はローカル処理と異なり、進捗不明は完了を意味しません。サービス、接続先、認証、利用枠、通信、制限を確認し、同じ文献を追加し直すより失敗段階を再試行します。
受理済みタスクは元のサービス情報を保持します。切替後も再開には元の接続先とキーが必要です。解析の無効化は実行済みの要求を取り消しません。
本文はあるが意味検索が使えない
モデルが有効・保存・適用済みで、埋め込みの接続テストが成功するか確認します。インポートタスクの意味検索段階と起動時復旧案内を確認し、モデルと次元数をベクトル空間に合わせてください。
既存の文献をベクトル化は不足する埋め込みを生成し、利用枠を消費する場合があります。保存済みベクトルからの再構築は検索索引を修復を使い、新しい埋め込みは生成しません。
Markdown が空または古い
公開完了後、処理対象 PDF を開き直して M を押します。既存内容には新しい解析規則が自動適用されず、明示的な再処理が必要です。閉じる前や再処理前に未保存内容を控えてください。
設定が保存できない
検証メッセージを確認します。別ウィンドウや外部編集で設定が変更された場合は、入力を控えて再読込みし、やり直してください。接続テスト成功は保存を意味しません。
MCP 接続失敗
- 稼働状態と実際のアドレスを確認します。
- Zotero を実行し、PC のスリープを避けます。
- クライアントを同じ PC で動かし、認証付き Streamable HTTP に対応しているか確認します。
- Bearer トークン、期限、対象ライブラリ、権限を確認します。
- ポート競合時は空きローカルポートを適用し、クライアントも変更します。
開発自動化中に PDF スクロールが遅い
Windows UI Automation クライアントは Zotero のアクセシビリティを有効にし、スクロールを妨げる場合があります。隔離検証で Codex computer-use ヘルパーとの干渉が確認されています。該当タスクのセッションとヘルパーを終了し、隔離 Zotero を再起動して比較してください。すべての環境に同じ問題がある証拠ではありません。
解決しない場合はサポートの手順で、最小再現と機密情報を除いた情報を提出してください。