graph-search

FTS5全文搜索代码知识图谱

安装使用

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

帮我安装这个 AI Skill:graph-search。
它的用途是:FTS5全文搜索代码知识图谱
完整的 Skill 内容见:https://321skill.com/skills/graph-search-x-3/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'搜索代码知识图谱中所有名为 "calculate_total" 的函数,并返回其调用者列表',它会返回该函数的定义位置、参数签名以及所有调用该函数的位置和调用链路径。

对AI说:'查找类型 "UserService" 的继承关系',它会返回该类的父类、接口实现以及子类列表。

介绍

在大型代码库中,手动查找函数、类或类型的定义和引用往往耗时费力。graph-search 利用 SQLite 的 FTS5 全文搜索引擎,将代码知识图谱(函数、类、类型等节点和关系)索引为可高效检索的结构化数据,让你通过自然语言或关键词就能瞬间定位到目标代码片段及其关联信息。

使用方式非常简单:安装后,在终端或通过 API 调用 graph-search 命令,输入搜索词(如“find_user_by_email”或“UserService”),它会返回匹配的代码实体名称、所在文件路径、行号以及该实体与其他实体的关系(如调用链、继承关系等)。支持模糊匹配、排名排序,适合快速浏览和交叉引用。

适合后端开发、全栈开发、智能体开发等需要频繁阅读、理解和重构代码的开发者。尤其当面对数万行级别的遗留代码库或开源项目时,graph-search 比传统 grep 或 IDE 内置搜索更精准,因为它理解代码结构(函数、类、类型)而非纯文本。

建议在使用前先运行一次索引构建命令(针对目标项目),之后搜索即可实时返回结果。注意该工具仅针对代码知识图谱中的结构化实体,不适合搜索注释、文档字符串或非代码文件。若需搜索变量名、宏定义等,需确保它们已被纳入知识图谱构建策略。

核心特点

与 grep、IDE 搜索等纯文本搜索不同,graph-search 直接解析代码语法树构建知识图谱,并按函数、类、类型等实体分类索引,支持模糊匹配和关系查询,能返回调用链、继承关系等结构化结果。

注意事项

不适合搜索注释、文档字符串、图片等非代码内容,且需要先对目标项目构建知识图谱索引。

常见问题

graph-search 支持哪些编程语言?

取决于底层知识图谱构建工具,通常支持 Python、JavaScript、TypeScript、Java、Go 等主流语言,具体可查看仓库支持的语言列表。

如何安装 graph-search?

推荐使用 npm 全局安装:npm install -g graph-search,或者从 GitHub 仓库克隆后手动安装。安装前确保系统已安装 Node.js 和 SQLite(含 FTS5 支持)。

给 AI 助手的安装指引

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

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