pi-knowledge-search

为AI助手提供本地文件语义搜索能力

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-knowledge-search。
它的用途是:为AI助手提供本地文件语义搜索能力
完整的 Skill 内容见:https://321skill.com/skills/pi-knowledge-search/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我们项目的用户认证模块是怎么设计的?” AI会调用`knowledge_search`工具,在您索引的项目文档目录中查找与“用户认证模块设计”语义最相关的段落,并整合成答案回复您。

介绍

这个Skill解决了AI助手无法直接访问和查询用户本地知识库的问题。它通过索引指定目录下的文本文件,并实时监控文件变化,为LLM提供了一个名为knowledge_search的工具,使其能够理解并回答关于用户本地文档内容的问题。

使用时,您需要配置一个包含文本文件的目录路径。Skill启动后会自动建立索引,并在文件发生增删改时更新索引。当您向AI助手提问时,如果问题涉及您本地的知识库,AI助手会自动调用knowledge_search工具,在索引中执行语义搜索,找到最相关的文档片段来生成答案。

它非常适合拥有大量本地文档、笔记、代码注释或项目文档的开发者、研究员和知识工作者。通过将个人或团队的本地知识库与AI助手连接,可以极大地提升信息检索和知识问答的效率。

建议将非结构化的文档(如Markdown、TXT文件)放入索引目录以获得最佳效果。请注意,它主要处理文本内容,对图片、PDF等格式内的文字需要预先提取。初次建立大量文件的索引可能需要一些时间。

核心特点

与简单文件读取或关键词搜索不同,它提供基于嵌入向量的语义搜索,能理解问题意图,找到概念相关而非仅仅字面匹配的内容。同时,它具备文件系统监听功能,索引可随文件变化自动更新,无需手动重建。

注意事项

不适合需要实时搜索数据库或频繁变化API文档等非本地、非文件形式的动态数据源。

常见问题

支持哪些文件格式?

主要支持纯文本格式,如.txt, .md, .js, .py等,实质是读取文件中的文本内容。

搜索速度如何?

初次索引较慢,后续搜索很快。搜索速度取决于索引文件数量和大小。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-knowledge-search/raw/index.md 读取 pi-knowledge-search 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。