内容
# 🐾 布布 — 统一的运营大脑
[](https://www.npmjs.com/package/@booboo-brain/cli)
[](https://www.npmjs.com/package/@booboo-brain/spec)
[](#license)
[](#connect-it-to-claude--cursor-mcp)
[](#quickstart)
> 将任何AI系统的数据转化为一个活着的、根植的3D大脑 — **结构 + 知识 + 记忆 + 代理 + 自动化** 融合成一个单一的图。查询它通过 **REST 或 MCP**，在你的 **浏览器 或 作为桌面壁纸** 中查看，并 **从中启动你的代理**。
**在安装前先看看 → [booboo-black.vercel.app](https://booboo-black.vercel.app)** · 一个在浏览器中运行的大脑，无需注册，无需克隆。
以一只从不忘记食物藏匿地点的腊肠犬命名。很合适，因为布布就是关于 **记忆和回忆** — 看到整个系统，获取埋藏的信息，永远不会失去线索。
*未修饰：`booboo view --demo --nodes 50000` — 50k节点，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/panel`](https://www.npmjs.com/package/@booboo-brain/panel)（组织结构图），[`@booboo-brain/vault`](https://www.npmjs.com/package/@booboo-brain/vault)（wiki链接的markdown导出），[`@booboo-brain/cli`](https://www.npmjs.com/package/@booboo-brain/cli)（统一的`booboo`命令），和[`create-booboo`](https://www.npmjs.com/package/create-booboo)（项目脚手架）。每个软件包的semver — 见每个`package.json`。MIT。
---
## 一个理念
布布的核心是一个小的 **JSON规范**，带有 **适配器** 来馈送它和 **消费者** 来渲染/服务/查询它：
```
你的数据 ──▶ 适配器 ──▶ 图形JSON ──▶ 消费者
（postgres， （配置驱动， （规范， （3D查看器 ·
json，neo4j， ~50行） ~1 KB REST API ·
mcp，…） 合约） 服务器 · 壁纸）
```
发出JSON → 免费获得查看器、API和MCP服务器。奇怪的数据 → 一个~50行的适配器，而不是一个分支。参见`SPEC.md`。
## 快速开始
**一个命令。无需数据库，无需配置，无需注册。** 一个合成的大脑，在你的机器上运行：
```bash
npx @booboo-brain/cli view --demo --nodes 1000000
```
这是头条：**一百万个节点，60帧每秒，在浏览器标签中**。降低计数到`--nodes 50000`在中等笔记本电脑上。参见[SCALE.md](SCALE.md)了解它如何保持（一个绘制调用在一个点云上与自定义着色器，加上标签的分层-LOD）。
**然后指向你自己的堆栈：**
```bash
# 脚手架一个项目（json启动 + postgres升级路径）
npx create-booboo my-brain
cd my-brain
npm install
npm run build # booboo.config.yaml → brain.json（快照）
npm run serve # REST API 在 http://localhost:8787
npm run mcp # MCP 通过stdio — 将Claude / Cursor / Claude Code指向它
```
编辑`booboo.config.yaml`指向你自己的Postgres/Supabase（一个注释示例在脚手架中提供）。完整参考：[docs/CONFIG.md](docs/CONFIG.md) · 卡住了？[docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)。
> **路线图：** 一个将构建 + REST + MCP + 3D查看器捆绑在一起的单一全功能命令，以及一个交互式脚手架向导 — 在[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 --org org.booboo.json # MCP 通过stdio（+ booboo_boot：代理从组织启动）
booboo view --snapshot my.booboo.json # 3D查看器在你的浏览器中 — 无需单体仓库，无需构建步骤
booboo panel --org org.booboo.json --snapshot my.booboo.json # 组织结构图 — 见下文
booboo vault --snapshot my.booboo.json --org org.booboo.json --out vault # 大脑作为markdown仓库 — 见下文
```
`booboo view` 将 `@booboo-brain/viewer` 3D渲染器作为独立应用提供 — 任意快照（或 `?n=1000000` 合成）在你的浏览器中，无需单体仓库。构建引擎在 **4,469节点生产脑** 上得到验证，直接从Supabase通过配置组装 — 隐私墙，验证，服务。参见每个软件包的README获取详细信息。
### 连接到Claude / Cursor（MCP）
`booboo mcp` 通过stdio讲话MCP。将任何MCP客户端指向它 — 无需托管服务器，按需运行：
```jsonc
// Claude Desktop: claude_desktop_config.json · Cursor: .cursor/mcp.json · Claude Code: .mcp.json
{
"mcpServers": {
"booboo": {
"command": "npx",
"args": ["-y", "@booboo-brain/cli", "mcp",
"--snapshot", "my.booboo.json", "--org", "org.booboo.json"]
}
}
}
```
你的代理现在可以查询整个系统 — `search`, `neighbors`, `path`, `stats` — `booboo_boot('<agent-id>')` 返回一个代理的规则，内存范围和报告，以便它 **从组织启动**，而 `booboo_remember` / `booboo_report` 让它 **写回** 持久的记忆和报告，这些记忆和报告在重建后仍然存在（实时内存系统）。将 `--snapshot`/`--org` 指向绝对路径，如果客户端的工作目录不同。
## 工具
| 工具 | 它做什么 |
|---|---|
| `booboo_stats` | 节点/链接计数，整个图形，按层分解。 |
| `booboo_search` | 按标签或ID搜索节点（排名：精确 > 前缀 > 子字符串）。首先使用它来查找节点的ID。 |
| `booboo_node` | 通过其精确ID获取单个节点（所有字段 + 数据）。 |
| `booboo_neighbors` | 节点周围的邻域：连接的节点 + 链接到 `depth` 跳跃。 |
| `booboo_path` | 两个节点ID之间最短的路径（节点链）；如果无法到达，则为空。 |
| `booboo_boot` *(带 `--org`)* | 代理的启动切片的组织结构图：身份，权限链，继承的规则，桶访问，技能，子级。每次调用此命令，会话开始。 |
| `booboo_org` *(带 `--org`)* | 完整的组织结构图：每个代理，层次结构，桶和规则引用。 |
| `booboo_remember` | **写入** 持久记忆 — 一个原子事实，与代理绑定。附加到快照旁边的日志中；可在同一会话中查询，存活每次重建。 |
| `booboo_report` | **写入** 报告 — 代理刚刚关闭的内容。登陆面板的报告时间线。 |
> `booboo_remember` / `booboo_report` 默认启用 — 实时内存系统的半部分。传递 `--no-write` （或 `BOOBOO_READONLY=1`）以获取只读服务器（公共/锁定部署）；它仍然 *读取* 日志但拒绝写入。
## 组织结构图 — 以公司方式运行你的代理
`booboo panel` 将你的代理舰队打开为一个 **真实的组织结构图** — 而组织结构图不是一个图表，它是 **权限**。每个代理都是一个卡片：它的规则，技能，内存桶访问和最新的报告。 **将一个代理拖到一个新的父级下，点击应用，组织文件就会更改** — 版本控制在git中，在每次写入之前验证（一个循环永远不会落地）。通过 `booboo_boot` 启动的代理将遵守新的形状在下一个会话中。重新组织你的公司在早餐时；整个舰队在第一杯咖啡时就知道了。
| 投资组合时间线 | 内存，按桶 |
|---|---|
|  |  |
五个选项卡在一个组织文件 + 一个快照上：**组织结构图** （拖放层次结构）· **桶** （谁记得什么）· **报告** （舰队关闭了什么，按最新顺序）· **规则** （谁声明，谁继承）· **图形** （3D大脑，嵌入）。规则自上而下继承 — 在一个分支中声明一次，每个下面的继承；每个档案显示继承的堆栈以启动顺序显示。
报告和桶通过两种方式填充：**实时**，当代理调用 `booboo_remember` / `booboo_report` （持久日志写入，无需重建），或 **批量** 从您自己的表格通过配置 — 参见 [docs/CONFIG.md § 连接fleet报告和内存（面板的报告/桶选项卡）](docs/CONFIG.md#connecting-fleet-reports--memory-the-panels-reportsbuckets-tabs).
## 仓库 — 你的大脑作为纯markdown（Obsidian-ready）
`booboo vault` 将同一个快照作为一个 **wiki链接的markdown仓库**：一个节点一个页面，带有frontmatter及其链接，索引页面每个层和集群，一个代理档案每个组织成员（命令链，继承的规则，桶，机器，合约）。打开文件夹作为Obsidian仓库，你就有了“LLM第二大脑”模式 — 除了从你的 **真实** 系统生成，而不是手动输入的笔记。普通文件是最终的可移植性：任何人都可以阅读它们，任何提供商的代理也可以。每天发出它，仓库也作为你的保险副本。
作者链接自己：放入 `[[node-id]]` （或 `[[exact label]]`）引用在笔记的文本中，并设置 `wikilinks: true` 在配置中 — 构建器将它们转换为一级的 `authored` 边，在图形中，API，3D视图和仓库中优于收获的关系。每次构建还会打印一个 **摄取质量行** （`authored · orphans · dump-suspects`）以便管理是一个数字，而不是一种感觉。
## 你的代理知道该怎么做 — 合同随脚手架提供
`npx create-booboo` 为项目脚手架 **AGENTS.md** （由 **CLAUDE.md** 导入）：任何在该文件夹中工作的AI代理都会自动读取的操作教义 — 从组织启动，一个原子事实每个笔记，你的 `[[links]]`，纠正替换，尊重墙，监控质量门，诚实关闭。新的安装程序让你的代理已经熟悉大脑的约定；编辑文件作为你自己的规则演变 — 它是你的系统的 **宪法**，版本控制在组织结构旁边。
## 为什么它不同
GitHub上最接近的东西每个都做 **一层** — 好的工具，都适用于它们的部分：
| | 整个系统视图 | REST API | MCP（代理查询） | 3D节点数1M | 隐私墙 |
|---|:---:|:---:|:---:|:---:|:---:|
| **布布** | ✅ | ✅ | ✅ | ✅ | ✅ |
| 图形查看器（`3d-force-graph`） | 仅渲染 | — | — | ✅ | — |
| 笔记图（Obsidian，Logseq） | 你的笔记，不是你的系统（布布 *发出* Obsidian仓库：`booboo vault`） | — | 插件 | — | — |
| 代理框架（LangGraph，traces） | 流程和运行 | ✅ | 部分 | — | — |
| 内存存储（Graphiti，Cognee） | 仅内存 | ✅ | ✅ | — | — |
没有一个将 **布线 + 知识 + 片段记忆 + 代理 + 计划** 融合到一个根植的、实时的、 **可启动** 的大脑中，它同时是一个视图，一个壁纸，一个API和一个MCP源。这种操作融合是新颖的部分。
## 交钥匙（可选 — 以上所有内容保持免费）
每个功能都是MIT，并且永远是这样。如果你不想自己设置：
- **[布布的Drop — £29](https://fractionalhq.uk/#tiers)** · 交钥匙：一个文件夹 + 操作员提示你粘贴到Claude Code或Cursor — 你的代理在回答五个问题时部署你的大脑端到端。
- **[代办](https://fractionalhq.uk/#tiers)** · 我们绘制 **你的** 堆栈 — 自定义适配器，托管快照，刷新管道。
两者都建立在这个仓库上，相同的配置模式 — 从不分叉，从不门槛。
## 许可证
MIT — 构建为分叉、适配和发货。 由 [Fractional HQ](https://fractionalhq.uk) 构建。
