内容
# 🐾 布布 — 统一的运营大脑
> 将任何AI系统的数据转化为一个活着的、根植于现实的3D大脑 — **结构 + 知识 + 记忆 + 代理 + 自动化** 融合为一张图。可以通过 **REST 或 MCP** 查询，在 **浏览器或桌面壁纸** 中查看，并 **从中启动代理**。
以一只从不忘记食物藏在哪里的腊肠犬命名。很合适，因为布布正是关于这一点：**记忆和回忆** — 一次看到整个系统，获取埋藏的信息，永远不会失去线索。
*未经过处理：`booboo view --demo --nodes 50000` — 5万节点，4层，实时在浏览器标签页中，零控制台错误。尝试用一条命令自己试试。*
大多数工具只显示给你 **一个** 切片：知识图谱、代理流程图、记忆存储、轨迹查看器。布布将所有这些融合成 **一张图，以单个点为根**，这样你可以看到 — 并查询 — 整个系统是如何实际联系在一起的。
> **状态：** alpha — 六个软件包，均已发布：[`@booboo-brain/spec`](https://www.npmjs.com/package/@booboo-brain/spec)（合约），[`@booboo-brain/build`](https://www.npmjs.com/package/@booboo-brain/build)（配置驱动的postgres/json适配器），[`@booboo-brain/serve`](https://www.npmjs.com/package/@booboo-brain/serve)（REST + MCP查询层），[`@booboo-brain/viewer`](https://www.npmjs.com/package/@booboo-brain/viewer)（百万节点3D渲染），[`@booboo-brain/cli`](https://www.npmjs.com/package/@booboo-brain/cli)（统一的`booboo`命令），以及[`create-booboo`](https://www.npmjs.com/package/create-booboo)（项目脚手架）。MIT。
---
## 一个理念
布布的核心是一个微小的 **JSON规范**，带有 **适配器** 来为其提供数据，以及 **消费者** 来渲染/提供/查询它：
```
您的数据 ──▶ 适配器 ──▶ 图谱 JSON ──▶ 消费者
（postgres， （配置- （规范， （3D查看器 ·
json，neo4j， 驱动， ~1 KB REST API ·
mcp，…） ~50行） 合约） MCP服务器 · 壁纸）
```
发出JSON → 免费获取查看器、API和MCP服务器。特殊数据 → 一个~50行的适配器，而不是一个分支。参见`SPEC.md`。
## 快速开始
```bash
npx create-booboo my-brain # 脚手架一个项目（json启动 + postgres升级路径）
cd my-brain
npm install
npm run build # booboo.config.yaml → brain.json（快照）
npm run serve # REST API在 http://localhost:8787
npm run mcp # 通过stdio的MCP — 将Claude / Cursor / Claude Code指向它
```
编辑`booboo.config.yaml`以指向您自己的Postgres/Supabase（一个注释示例在脚手架中提供）。完整参考：[docs/CONFIG.md](docs/CONFIG.md) · 卡住了？ [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md).
> 广告重点：**布布在浏览器中以60fps渲染百万节点大脑。** 使用`booboo view --demo --nodes 1000000`试试（或查看器游乐场：`pnpm -F @booboo-brain/viewer dev`，然后用`?n=1000000`打开）。参见`SCALE.md`了解如何实现（实例化GPU字段 + 分层LOD）。
> **路线图：** 一个将构建 + REST + MCP + 3D查看器捆绑在一起的命令，一个交互式脚手架向导，以及一个 `--demo` 大图谱生成器 — 在 [LAUNCH_CHECKLIST.md](LAUNCH_CHECKLIST.md) 中跟踪。
## 今天有效的内容
```bash
booboo build --config booboo.config.yaml # 任意postgres/json → 一个图谱快照（隐私墙 + 父节点）
booboo serve --snapshot my.booboo.json --port 8787 # REST：/graph /stats /search /nodes/:id /neighbors/:id /path/:a/:b
booboo mcp --snapshot my.booboo.json # 通过stdio的MCP：booboo_stats/search/node/neighbors/path
booboo view --snapshot my.booboo.json # 浏览器中的3D查看器 — 无需单体仓库，无需构建步骤
```
`booboo view` 将 `@booboo-brain/viewer` 3D渲染器作为独立应用提供 — 任何快照（或 `?n=1000000` 合成）在您的浏览器中，无需单体仓库。构建引擎已在 **4469节点生产大脑** 上得到验证，该大脑直接由Supabase通过配置组装 — 具有隐私墙，验证，提供。有关详细信息，请参见每个软件包的README。
## 为什么它与众不同
GitHub上最接近的东西都只做 **一层** — 好的工具，但只适用于它们的切片：
| | 全系统视图 | REST API | MCP（代理查询） | 3D在100万节点 | 隐私墙 |
|---|:---:|:---:|:---:|:---:|:---:|
| **布布** | ✅ | ✅ | ✅ | ✅ | ✅ |
| 图谱查看器（`3d-force-graph`） | 仅渲染 | — | — | ✅ | — |
| 笔记图谱（Obsidian，Logseq） | 您的笔记，不是您的系统 | — | 插件 | — | — |
| 代理框架（LangGraph，traces） | 流程和运行 | ✅ | 部分 | — | — |
| 记忆存储（Graphiti，Cognee） | 仅记忆 | ✅ | ✅ | — | — |
没有一个能将 **线路 + 知识 + 事件记忆 + 代理 + 计划任务** 融合到一个有根的、实时的、**可启动** 的大脑中，它同时是一个视图、一个壁纸、一个API和一个MCP源。这种操作融合是新颖的部分。
## 交钥匙（可选 — 以上所有内容保持免费）
每个功能都是MIT许可的，并且永远如此。如果您不想自己设置：
- **[布布套件 — £29](https://fractionalhq.uk/#tiers)** · 交钥匙：一个文件夹 + 操作员提示，您将其粘贴到Claude Code或Cursor中 — 您的代理在您回答五个问题时部署您的脑图。
- **[代办](https://fractionalhq.uk/#tiers)** · 我们绘制 *您的* 堆栈 — 自定义适配器，托管快照，刷新管道。
两者都建立在此仓库上，使用相同的配置模式 — 从不分叉，从不设门。
## 许可证
MIT — 构建为分叉、适配和发布。由 [Fractional HQ](https://fractionalhq.uk) 构建。
