Booboo

🐾 Booboo — 统一的运营大脑

将任何 AI 系统的数据转化为一个鲜活、扎根的 3D 大脑——结构 + 知识 + 记忆 + Agent + 自动化融合为一张图谱。通过 REST 或 MCP 查询，在浏览器或桌面壁纸中查看，还能通过一次调用从中启动你的 Agent。

安装前先看看 → booboo.fractionalhq.uk · 在浏览器中体验一个实时大脑，无需注册，也无需克隆。

它的名字来自一只腊肠犬，它从不会忘记零食埋在哪里。这个名字再合适不过了，因为 Booboo 讲的正是：记忆与回忆——一眼看清整个系统，取出埋藏的信息，始终紧握脉络。

未经修饰：booboo view --demo --nodes 50000——5 万个节点、4 层结构，在浏览器标签页中实时运行，控制台错误为零。试试一条命令即可体验。

大多数工具只展示一个切面：知识图谱、Agent 流程图、记忆存储或追踪查看器。Booboo 将它们全部融合为一张根植于单一节点的图谱，让你看清并查询整个系统实际如何连为一体。

**状态：**Alpha——已发布 8 个包：@booboo-brain/spec（契约）、@booboo-brain/build（由配置驱动的 postgres/json 适配器）、@booboo-brain/serve（REST + MCP 查询层）、@booboo-brain/viewer（百万节点 3D 渲染）、@booboo-brain/panel（组织图）、@booboo-brain/vault（带 Wiki 链接的 Markdown 导出）、@booboo-brain/cli（统一的 booboo 命令），以及 create-booboo（项目脚手架生成器）。每个包各自遵循 semver——详见各自的 package.json。MIT。

---

核心理念

Booboo 的核心是一个精简的 JSON 规范，由适配器向其提供数据，再由使用方将其渲染、提供服务或查询：

  your data ──▶  ADAPTERS  ──▶  GRAPH JSON ──▶  CONSUMERS
  (postgres,     (config-       (the spec,       (3D viewer ·
   json, neo4j,   driven,        ~1 KB            REST API ·
   mcp, …)        ~50 lines)     contract)        MCP server · wallpaper)

生成 JSON → 免费获得查看器、API 和 MCP 服务。遇到特殊数据 → 编写约 50 行的适配器，而不是分叉项目。详见 SPEC.md。

快速开始

一条命令。无需数据库、配置或注册。 在你的机器上运行一个合成大脑：

npx @booboo-brain/cli view --demo --nodes 1000000

这就是最亮眼的卖点：在浏览器标签页中以 60fps 渲染 100 万个节点。 在配置不高的笔记本上，可将数量调低为 --nodes 50000。详见 SCALE.md，了解其性能表现（通过自定义着色器在单个点云上只需一次绘制调用，并对标签采用分级 LOD）。

如果它在你的机器上运行良好，点个星吧。这个仓库没有营销推广；星标能让下一位开发者发现它。

然后将它连接到你自己的技术栈：

# scaffold a project (json starter + postgres upgrade path)
npx create-booboo my-brain
cd my-brain
npm install
npm run build                    # booboo.config.yaml → brain.json (the snapshot)
npm run serve                    # REST API on http://localhost:8787
npm run mcp                      # MCP over stdio — point Claude / Cursor / Claude Code at it

编辑 booboo.config.yaml，将其指向你自己的 Postgres/Supabase（脚手架中附带一份注释示例）。完整参考：docs/CONFIG.md · 遇到问题？请查看 docs/TROUBLESHOOTING.md。

路线图： 将 build + REST + MCP + 3D 查看器打包在一起的一体化命令，以及交互式脚手架向导——进度见 LAUNCH_CHECKLIST.md。

当前可用功能

booboo build --config booboo.config.yaml    # any postgres/json → one graph snapshot (privacy walls + parent spines)
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 over stdio (+ booboo_boot: agents boot FROM the org)
booboo view  --snapshot my.booboo.json               # 3D viewer in your browser — no monorepo, no build step
booboo panel --org org.booboo.json --snapshot my.booboo.json  # THE ORGANIGRAM — see below
booboo vault --snapshot my.booboo.json --org org.booboo.json --out vault  # the brain as a markdown vault — see below

booboo view 会将 @booboo-brain/viewer 3D 渲染器作为独立应用提供服务——无需单体代码库，即可在浏览器中查看任意快照（或使用 ?n=1000000 生成合成数据）。构建引擎已在一个真实的 4,469 节点生产环境大脑上得到验证，该大脑完全通过配置直接从 Supabase 组装而成——经过隐私隔离和验证后提供服务。详情请参阅各个包的 README。

将其连接到 Claude / Cursor（MCP）

booboo mcp 通过 stdio 使用 MCP。将任意 MCP 客户端指向它即可——无需托管服务，它会按需运行：

// 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"]
    }
  }
}

现在，你的 Agent 可以查询整个系统——search、neighbors、path、stats——booboo_boot('<agent-id>') 会返回 Agent 的规则、记忆范围和报告，让它从组织中启动；booboo_remember / booboo_report 则让它写回可持久保存的记忆和报告，这些内容在重建后依然存在（即实时记忆系统）。如果客户端的工作目录不同，请将 --snapshot/--org 指向绝对路径。

工具

工具	功能
booboo_stats	整个图的节点/链接数量，按层细分。
booboo_count	仅统计数量，不拉取负载数据——查询前可用来估算规模。
booboo_search	按标签或 id 搜索节点（排序优先级：精确匹配 > 前缀匹配 > 子串匹配）。首先使用此工具查找节点的 id。
booboo_node	按确切 id 获取单个节点（所有字段和数据）。
booboo_neighbors	某个节点的邻域：与之相连的节点，以及最多延伸 depth 跳的链接。
booboo_path	两个节点 id 之间的最短路径（节点链）；若不可达则返回 null。
booboo_boot （需配合 --org）	Agent 在组织结构图中的启动切片：身份、权限链、继承的规则、存储桶访问权限、技能和子级。每次会话都首先调用此工具。
booboo_org （需配合 --org）	完整的组织结构图：所有 Agent、层级、存储桶和规则引用。
booboo_remember	写入可持久保存的记忆——一条与某个 Agent 关联的原子事实。追加到快照旁的日志中；在同一会话中可查询，并且在每次重建后都会保留。
booboo_report	写入报告——记录某个 Agent 刚刚完成的工作。报告会显示在面板的 Reports 时间线上。

默认启用 booboo_remember / booboo_report——它们是记忆系统的实时部分。传入 --no-write（或设置 BOOBOO_READONLY=1）可启动只读服务（适用于公开或受限部署）；它仍会读取日志，但会拒绝写入。

Organigram——像经营公司一样管理你的 Agent

booboo panel 会将你的 Agent 团队以真实的组织架构图呈现——这张图不是示意图，而是权威依据。每个 Agent 都是一张卡片，显示其规则、技能、记忆分区访问权限和最新报告。将 Agent 拖到新的上级下方，点击应用，组织文件就会随之更新——变更会在 git 中进行版本管理，并在每次写入前通过验证（绝不会形成循环）。通过 booboo_boot 启动的 Agent 会在下次会话中遵循新的组织架构。早餐时重组公司，第一杯咖啡还没喝完，整个团队就都知道了。

投资组合时间线	记忆，按分区查看

五个选项卡共用一个组织文件和一个快照：organigram（拖放式层级结构）· buckets（谁记得什么）· reports（团队完成了什么，按时间从新到旧排列）· rules（谁声明规则，谁继承规则）· graph（内嵌的 3D 大脑）。规则从上到下继承——在某个分支声明一次，其下所有成员都会受到约束；每份档案都会按启动顺序显示继承的规则栈。

报告和分区有两种填充方式：实时填充，即 Agent 调用 booboo_remember / booboo_report 时写入（写入持久化日志，无需重建）；或通过配置，从你自己的表格中批量导入——参见 docs/CONFIG.md § Wiring fleet reports & memory。

知识库——以纯 Markdown 形式呈现你的大脑（适用于 Obsidian）

booboo vault 会将同一份快照导出为带 Wiki 链接的 Markdown 知识库：每个节点对应一个页面，包含 frontmatter 及其链接；每个层级和集群都有索引页面；组织中的每个成员都有一份 Agent 档案（指挥链、继承的规则、分区、机器、契约）。将该文件夹作为 Obsidian 知识库打开，即可使用“LLM 第二大脑”模式——但内容来自你的真实系统，而非手动输入的笔记。纯文件具有极佳的可移植性：任何人类都能阅读，任何服务提供商的 Agent 也能阅读。每晚导出一次，知识库还能兼作保险备份。

你可以自行编写链接：在笔记文本中加入 [[node-id]]（或 [[exact label]]）引用，并在配置中设置 wikilinks: true——构建器会将它们转换为优先级高于采集关系的一级 authored 边，并在图谱、API、3D 视图和知识库中生效。每次构建还会打印一行摄取质量指标（authored · orphans · dump-suspects），让内容整理有据可依，而非凭感觉。

你的 Agent 知道该做什么——脚手架自带契约

npx create-booboo 会在项目中生成 AGENTS.md（由 CLAUDE.md 导入）：这是任何在该文件夹中工作的 AI Agent 都会自动读取的操作准则——从组织架构启动，每条笔记记录一个原子事实，为 [[links]] 编写来源，修正时替换旧内容，遵守边界，留意质量门禁，诚实地完成任务。全新安装后，你的 Agent 就已经熟悉大脑的约定；随着规则演进，你可以编辑该文件——它就是系统的章程，与组织文件一起进行版本管理。

它的独特之处

GitHub 上最接近的项目都只覆盖其中一层——它们各自的领域都做得很好：

	全系统视图	REST API	MCP（Agent 可查询）	支持 100 万个节点的 3D 可视化	隐私隔离
Booboo	✅	✅	✅	✅	✅
图形查看器（3d-force-graph）	仅渲染	—	—	✅	—
笔记图谱（Obsidian、Logseq）	仅限你的笔记，不包含你的系统（booboo 可生成 Obsidian 知识库：booboo vault）	—	插件	—	—
Agent 框架（LangGraph、跟踪记录）	流程与运行	✅	部分支持	—	—
记忆存储（Graphiti、Cognee）	仅记忆	✅	✅	—	—

没有任何项目将连接关系 + 知识 + 情节记忆 + Agent + 定时任务融合到一个有根、实时、可启动的大脑中，同时兼具视图、壁纸、API 和 MCP 数据源的功能。这种操作层面的融合才是它的新颖之处。

一站式交付（可选——以上所有功能始终免费）

所有功能均采用 MIT 许可，并将始终如此。如果你不想亲自完成设置， Fractional HQ 可以为你的技术栈量身定制：自定义适配器、 托管快照、刷新流水线。使用同一个仓库、同一套配置架构，永不分叉，也绝不设限。

许可证

MIT——旨在供人分叉、改编和交付。由 Fractional HQ 构建。