Gbrain 多智能体搜索

本地知识库，支持全文搜索、语义搜索与知识图谱功能。需已安装 gbrain，并已完成 brain 仓库的初始化。

前提条件

• 已安装 gbrain CLI（在 gbrain 仓库中执行 bun install）
• 已同步 Markdown 内容的 brain 仓库
• 已配置嵌入式 API（兼容 OpenAI 的接口端点）

配置 / 配置

设置以下环境变量，或直接在命令中替换：

一行式配置（可添加至 TOOLS.md）

export GBRAIN_DIR=~/gbrain
export BRAIN_DIR=~/brain
export OPENAI_API_KEY=your-key-here
export OPENAI_BASE_URL=https://api.openai.com/v1
alias gb="cd $GBRAIN_DIR && bun run src/cli.ts"

搜索 / 搜索

关键词搜索（快速、精确匹配） / 关键词搜索

cd $GBRAIN_DIR && bun run src/cli.ts search "" [--limit N]

最适合：精确的人名、术语、文件引用等场景。
适合：精确的人名、术语、文件名搜索。

语义搜索（混合模式，理解语义） / 语义搜索

cd $GBRAIN_DIR && bun run src/cli.ts query "" [--limit N]

最适合：自然语言提问、模糊概念、跨主题查询。
适合：自然语言提问、模糊概念、跨主题查询。

示例 / 示例:

query "When did I join company X"        / "什么时候加入的公司X"
query "Heart rate trends in 2024"         / "2024年心率趋势"
query "Email about project approval"      / "项目审批相关的邮件"

列出页面 / 列出页面

cd $GBRAIN_DIR && bun run src/cli.ts list [--type source|person|concept|company|project|deal|media|civic] [--tag T] [-n N]

读取页面 / 读取页面

cd $GBRAIN_DIR && bun run src/cli.ts get "" [--fuzzy]

使用 --fuzzy 参数启用 slug 的模糊匹配。
使用 --fuzzy 进行模糊匹配。

知识图谱 / 知识图谱

创建关联 / 创建关联

cd $GBRAIN_DIR && bun run src/cli.ts link "" "" [--link-type TYPE] [--context "description"]

遍历图谱 / 遍历图谱

cd $GBRAIN_DIR && bun run src/cli.ts graph "" [--depth N]

常用关联类型 / 常用关联类型

works_at, invested_in, related_to, wrote, attended, located_in, managed, friend_of, reported_to, parent_of, spouse_of

数据管理 / 数据管理

导入与嵌入 / 导入与嵌入

# 将仓库中的 Markdown 文件同步至 brain
cd $GBRAIN_DIR && bun run src/cli.ts sync --repo $BRAIN_DIR --no-pull --no-embed --full

# 为新增或变更的内容生成嵌入向量
cd $GBRAIN_DIR && OPENAI_API_KEY=... OPENAI_BASE_URL=... bun run src/cli.ts embed --stale

统计信息 / 统计信息

cd $GBRAIN_DIR && bun run src/cli.ts stats

健康检查 / 健康检查

cd $GBRAIN_DIR && bun run src/cli.ts doctor

工作流程 / 工作流程

添加新内容 / 添加新内容

1. 将 Markdown 文件添加至 $BRAIN_DIR/sources//
2. git add && git commit
3. 运行 sync --full --no-pull --no-embed
4. 运行 embed --stale

典型搜索模式 / 典型搜索模式

1. 优先使用 search 获取精确匹配结果
2. 若无结果，或需更深层理解，则改用 query
3. 使用 get 查看完整页面内容
4. 使用 graph 探索相关联的页面

提示 / 提示

• search 更快，query 更智能 —— 建议优先尝试 search
search 更快，query 更智能
• 添加 --limit 5 获取简洁结果
  加 --limit 5 获取简洁结果
• 不确定 slug 是否准确时，使用 --fuzzy
  不确定 slug 时用 --fuzzy
• 大文件（>64 个 chunk）嵌入失败时，请拆分为多个小文件
  大文件嵌入失败时，拆分为小文件
• 定期运行 stats 检查知识库健康状态
  定期运行 stats 检查知识库状态