🛠️ PDF Search for Zed 是什么？
PDF Search for Zed 是一个为 Zed 编辑器开发的扩展工具，它把 PDF 文档变成可搜索的知识源。你不用再打开阅读器翻页查找，也不用靠记忆回忆“那段话好像在中间某处”。它直接让你在编码或写作时，快速从 PDF 中找出相关内容，整个过程就在编辑器里完成。
为什么需要它？
以往要查一份技术论文里的某个参数说明，或者回顾项目文档中的设计描述，通常得先找到文件、手动打开、滚动浏览，甚至反复切换窗口比对信息。这个过程不仅打断思路，还容易遗漏细节。如果你同时参考多个 PDF，问题更明显——每份都看一点，上下文来回跳，效率自然就低了。
有了 PDF Search for Zed，这些操作被压缩成一条命令。你正在写代码，突然想确认某个算法的实现细节，只需输入 /pdfsearch 算法名称，相关段落就会立刻出现在当前界面。不需要离开 Zed，也不需要重新定位上下文，信息获取变得和查变量定义一样直接。
💡 核心能力速览
语义级内容检索：不依赖关键词完全匹配。即使你记不清原文用词，只要描述清楚意图（比如“那个用梯度下降优化损失的方法”），工具也能找到最接近的段落。
统一索引管理：支持批量导入多个 PDF 文件。工具会自动解析内容并建立索引，把分散的资料整合成一个可查询的整体。你可以一次性搜索整个项目文档集，而不是逐个打开确认。
深度集成于 Zed 工作流：通过 /pdfsearch 命令调用，结果以自然方式嵌入对话或侧边栏。你不需要额外学习新界面，也不用手动复制粘贴结果，搜索输出可以直接用于后续提示或代码注释。
⚙️ 适合谁？怎么用？
这个工具特别适合经常处理技术文档、研究论文或项目资料的开发者和研究人员。如果你常遇到“我记得看过但找不到”的情况，它能减少重复查阅的时间成本。
使用前需要配置 Python 环境、安装 uv 包管理器，并提供 OpenAI API key 用于语义分析。虽然初始设置有一定门槛，但完成后日常操作基本零负担。未来版本计划加入本地嵌入模型支持，届时对数据隐私要求高的场景也能更安全地使用。
建议你在处理大型项目或文献综述类任务时尝试这个工具。当你的参考资料超过 5 个 PDF，且需要频繁交叉引用时，它的价值会明显体现出来。
