PDF Search 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助手的上下文中

未来改进

• 自包含向量存储
• 自包含嵌入
• 首次运行时自动构建索引
• 可配置的结果大小
• 支持多个PDF
• 可选：支持PDF以外的其他文件格式

项目结构

• pdf_rag/：基于Python的MCP服务器实现
• src/：Zed扩展代码
• extension.toml 和 Cargo.toml：Zed扩展配置文件

已知限制

• 首次使用前需手动构建索引
• 需要外部服务（OpenAI）