Pdfsearch Zed

🚀 PDF 搜索 for Zed

この拡張機能は、Zed 用に設計されたドキュメント検索拡張機能です。PDF ドキュメントに対して意味検索を行い、その結果を Zed の AI アシスタントで利用することができます。

🚀 クイックスタート

前提条件

現在のバージョンでは、以下が必要です。

1. OpenAI API キー（埋め込みの生成に使用）
2. システムに uv がインストールされていること

⚠️ 重要提示

現在の実装では、埋め込みの生成に OpenAI API キーが必要ですが、将来のバージョンでは自己完結型の代替案を実装する予定です。コミュニティからのフィードバックを参考に、改善の優先順位を決定します。

手順

1. リポジトリをクローンします。

git clone https://github.com/freespirit/pdfsearch-zed.git

2. MCP サーバー用に Python 環境を設定します。

cd pdfsearch-zed/pdf_rag
uv venv
uv sync

3. 開発用拡張機能をインストールして Zed に追加します。
4. 検索データベースを構築します。

cd /path/to/pdfsearch-zed/pdf_rag

echo "OPENAI_API_KEY=sk-..." > src/pdf_rag/.env

# ドキュメントのサイズによっては、数分かかる場合があります。
# 複数のファイルやディレクトリを引数として指定することができます。
# - ファイルはチャンクに分割されます。
# - ディレクトリ内のファイルはチャンク化されたものと見なされます。
uv run src/pdf_rag/rag.py build "file1.pdf" "dir1" "file2.md" ...

5. Zed を設定します。

"context_servers": {
    "pdfsearch-context-server": {
        "settings": {
            "extension_path": "/path/to/pdfsearch-zed"
        }
    }
}

💻 使用例

基本的な使用法

1. Zed の AI アシスタントパネルを開きます。
2. /pdfsearch と検索クエリを入力します。
3. この拡張機能が PDF を検索し、関連する部分を AI アシスタントのコンテキストに追加します。

🔮 未来の改善点

• [x] 自己完結型のベクトルストレージ
• [ ] 自己完結型の埋め込み
• [ ] 初回実行時に自動的にインデックスを構築
• [ ] 結果のサイズを設定可能にする
• [x] 複数の PDF ファイルをサポート
• [x] オプション：PDF 以外の他のファイル形式をサポート

📁 プロジェクト構造

• pdf_rag/: Python ベースの MCP サーバーの実装
• src/: Zed 拡張機能のコード
• extension.toml と Cargo.toml: Zed 拡張機能の設定ファイル

⚠️ 既知の制限

• 初回使用前に手動でインデックスを構築する必要があります。
• 外部サービス（OpenAI）が必要です。