GBrain Skill(Graph Brain)是一款基于代码语义图谱的智能搜索和索引工具。与传统基于关键词的搜索不同,GBrain 能够理解代码的语义关系,支持自然语言查询代码库,极大提升代码复用和理解效率。
与传统搜索的对比
| 特性 | grep/关键词搜索 | GBrain 语义搜索 |
|---|---|---|
| 搜索方式 | 精确字符串匹配 | 自然语言语义理解 |
| 结果质量 | 依赖关键词命中 | 理解意图,返回相关结果 |
| 上下文感知 | 单文件级 | 跨文件调用链级 |
| 学习能力 | 无 | 根据使用习惯优化索引 |
核心功能
- 语义索引:自动构建代码库的语义图谱,标记函数调用、数据流和依赖关系
- 自然语言查询:用"找到处理用户认证的相关代码"这样的描述来搜索
- 调用链追踪:从任意函数出发,自动追踪完整的调用链和数据流
- 相似代码发现:自动发现代码库中结构相似但命名不同的重复代码
- 快速定位:根据语义相似度快速定位目标代码片段
工作原理
GBrain 的核心技术是代码语义嵌入(Code Embedding):
1. 解析源代码 → AST(抽象语法树)
2. AST → 语义向量(通过 CodeBERT/GraphCodeBERT)
3. 语义向量入库 → 构建语义索引(Faiss)
4. 自然语言查询 → 向量化 → ANN 相似度搜索
安装使用
# 在 OpenClaw 中安装
/open skills
搜索 "gbrain"
点击安装
# 自然语言搜索
/gbrain search "处理支付回调的代码在哪里"
GBrain 将代码搜索从"找关键词"升级为"说你要什么",是大型代码库维护和代码复用场景下的利器。
安装指南
复制下方命令,在终端运行即可安装:
# 安装到当前项目
npx skills add gbrain-skill
# 全局安装 — 所有项目可用
npx skills add gbrain-skill -g
使用指南
安装完成后,在对话框中直接使用此技能。