pi-neutrasearch
为Pi智能体提供高效的本地文件与路径搜索能力
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-neutrasearch。 它的用途是：为Pi智能体提供高效的本地文件与路径搜索能力 完整的 Skill 内容见：https://321skill.com/skills/pi-neutrasearch/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘在我的项目src目录下，帮我找到所有包含“utils”关键词的TypeScript文件路径。’，它会通过pi-neutrasearch快速查询已建立的索引，并返回一个精确的文件路径列表，而无需逐一读取文件内容，从而节省大量Token。
介绍
pi-neutrasearch 是一个专为Pi智能体设计的原生索引搜索工具，旨在解决智能体在处理本地文件系统时因遍历大量文件而产生的Token消耗过高问题。它通过建立本地索引，使智能体能够快速、精准地定位文件名和路径，而无需读取所有文件内容，从而显著降低对话成本并提升响应速度。
使用方式非常简单，开发者只需通过npm安装该包，并在智能体代码中集成其API。当智能体需要查找文件时，调用该工具提供的搜索函数即可获得匹配的文件路径列表，整个过程对用户透明，无需复杂的配置。
该工具特别适合需要频繁与本地文件系统交互的智能体开发者、全栈工程师以及运维人员。无论是开发需要读取项目结构的代码助手，还是构建需要访问特定配置文件的自动化脚本，都能从中受益。
建议在项目初期就集成此工具，以便尽早建立文件索引。需要注意的是，索引的更新并非完全实时，在文件频繁增删改的场景下，可能需要手动触发索引重建或设置合理的更新间隔，以确保搜索结果的准确性。
核心特点
与同类文件搜索工具相比，其核心优势在于专为AI智能体对话场景优化，通过建立索引实现极低的Token消耗，避免了传统文件遍历方式在长路径或大量文件时产生的高昂成本。
注意事项
不适合需要实时监控文件内容变化或进行全文内容搜索的场景。
常见问题
pi-neutrasearch 能搜索文件内容吗？
不能，它只针对文件名和路径建立索引并进行快速搜索，不涉及文件内部内容的检索。
这个工具会影响我现有的Pi智能体代码吗？
影响很小。它是一个独立的Node模块，通过API集成，不会破坏现有代码结构，只需在需要搜索的地方调用即可。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-neutrasearch/raw/index.md 读取 pi-neutrasearch 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-neutrasearch/raw/index.md（查看排版版本）