btg-store

BTG Store

一个为 AI Agent 和个人知识整理设计的轻量级记忆图谱存储。

先从怎么用开始

• 安装

  pnpm add btg-store
  

  或者直接从仓库体验：

  git clone <repo-url>
  cd btg-store
  pnpm install
  pnpm build
  

• 用 CLI 捕捉灵感

  # 全局安装一次
  npm install -g btg-store
  
  # 记录瞬时想法
  btg note "新的 WebGPU 想法"
  
  # 构建结构化知识并探索
  btg node @idea/webgpu "用 GPU 计算做布局"
  btg edge @me uses @idea/webgpu
  btg search "webgpu"
  btg stats
  

• 作为库调用

  import { BTGStore } from 'btg-store';
  
  const store = new BTGStore({ memoryFile: './my-memory.btg' });
  await store.open();
  
  const noteId = await store.putNoteRaw('捕捉一闪而过的想法');
  await store.putEdge('@me', 'captures', noteId);
  
  const result = store.searchText('一闪而过', 5);
  console.log(result.hits);
  
  await store.exportNDJSON('./memory.ndjson');
  store.close();
  

启动示例应用

pnpm install
pnpm dev

该命令会启动一个基于本地 BTG Store 的演示界面。

为什么选择 BTG Store

• 追加写入的数据包，稳定又快速
• 自带全文检索与图谱遍历能力
• 自动处理大段文本内容
• 完全离线可用，需要同步时也支持 HTTPS 客户端/服务端模式

想了解更多？

• QUICKSTART.md — 详细的上手教程
• DOCS_INDEX.md — 架构、路线图与 API 说明入口