pi-adaptive-finder
基于本地搜索与智能重排的快速文件查找工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-adaptive-finder。 它的用途是：基于本地搜索与智能重排的快速文件查找工具 完整的 Skill 内容见：https://321skill.com/skills/pi-adaptive-finder/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“在我的项目里找所有处理用户认证的Python文件。” 它会先通过 rg 快速扫描出所有包含‘认证’、‘auth’等关键词的.py文件，然后调用你配置的智能模型，根据语义相关性对结果进行排序，最后将最可能相关的几个文件路径和片段优先呈现给你。
介绍
Pi-adaptive-finder 主要解决了在本地工作区中快速、精准定位文件或代码片段的效率问题。用户经常需要在庞大的项目目录中寻找特定文件或代码，传统搜索工具要么速度慢，要么结果不够相关，本工具通过结合高效的本地搜索与可配置的智能重排，显著提升了查找的准确性和速度。
使用方式非常直接。它首先利用 ripgrep (rg) 进行快速的本地全文检索，获取初步结果集。然后，用户可以配置并使用 OpenAI 兼容的 API 模型（如来自 OpenAI、DeepSeek 等提供方的模型）对初步结果进行智能重排，将最相关的结果排在前面，最终呈现给用户。整个过程可以通过命令行或集成到 Pi 等 AI 助手中完成。
这个工具非常适合需要频繁在大型代码库、文档集或项目文件中进行深度搜索的开发者、技术写作者和研究人员。对于处理复杂项目、遗留代码库或需要根据语义（而不仅仅是关键词）进行查找的场景尤其有用。
在使用时，建议用户根据自身网络环境和需求，选择合适的重排模型 API 端点和配置。由于重排步骤需要调用外部 API，请注意 API 调用可能产生的费用和网络延迟。对于纯本地、对延迟极其敏感或完全离线的场景，可以仅使用其前端的 rg 检索功能。
核心特点
核心区别在于“本地快速检索 + 云端智能重排”的两阶段设计，既保证了初始搜索的极速响应，又通过可配置的、兼容多种模型供应商的 API 进行语义重排，提升了结果的相关性，而非单纯依赖关键词匹配或单一的云端搜索服务。
注意事项
不适合要求完全离线、零网络延迟或对调用外部 API 有严格限制的场景。
常见问题
需要联网吗？
基础文件检索（rg）不需要，但使用智能重排功能需要联网调用配置的 API。
支持哪些重排模型？
支持任何提供 OpenAI 兼容 API 格式的模型服务，如 OpenAI、DeepSeek、Ollama 本地模型等。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-adaptive-finder/raw/index.md 读取 pi-adaptive-finder 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-adaptive-finder/raw/index.md（查看排版版本）