busabase/busabase

Open-source database & workspace for AI agents — structured data, durable knowledge, reusable skills, runnable apps, and human review on the writes that matter. Local-first and self-hostable.

Busabase – 面向 AI 代理的共享、版本控制工作区

它是什么 – Busabase 是一个开源数据库 + UI，让大语言模型代理（如 Claude Code、Codex、Cursor、Gemini 等）和人类能够读写相同的结构化记录、文档、技能和小型应用。代理所做的每次更改都会作为变更请求存储，包含差异、作者和历史记录，因此工作持久、可审计，并且可以在合并前进行审查。

为什么重要 – 如今，大多数基于 LLM 的工具将其输出保存在临时聊天或个人笔记中。当您切换工具时，会丢失上下文，不得不重新解释项目。Busabase 为代理提供了一个永久的“记录系统”，使它们能够从相同的知识库开始，提出更新，并让您（或策略）决定是否接受。

快速开始（5 分钟）

# 运行本地服务器（内置 PGlite + 文件存储）
npx busabase server

打开 http://localhost:15419/dashboard/local。无需数据库、账户或配置。

通过向任何 LLM 代理提供 Agent Skill 文件的 URL 来指向服务器，例如：

http://localhost:15419/SETUP_SKILL.md

代理将按照说明操作，读取工作区，并将其输出作为变更请求写回。

您也可以通过 Docker 运行 Busabase，安装 CLI（npm i -g busabase），或下载桌面应用（macOS/Windows/Linux）以获得离线、本地优先的体验。

核心功能（如 README 中所述）

统一工作区 – 类型化记录（Bases）、文档、文件、技能、AirApps、白板和工作流都是单一树中的一等节点。
共享技能 – SKILL.md 剧本和自定义提示词位于工作区中；任何连接的代理都可以在操作前查阅它们。
变更请求 – 每次写入都是带有作者、消息和时间戳的差异。权限决定它是自动合并还是等待审查。
数据上的实时应用 – 小型“AirApps”在 Busabase 内运行，读取工作区数据以提供仪表板、CRM、内容台等。
代理无关 – 无内置模型。通过 Agent Skill、MCP、OpenAPI 或简单 CLI 连接 Claude Code、Codex、Cursor、Gemini CLI、n8n 或任何自定义进程。
模板 – 一键安装完整工作区（模式、示例数据、应用和代理手册）。
本地优先且开源 – MIT 许可，运行在嵌入式 PGlite 数据库或外部 Postgres/S3 上，支持离线工作，并支持托管 SaaS 版本（Busabase Cloud）。

典型用例

领域	代理做什么	留在 Busabase 中的内容
软件交付	将反馈转化为任务，编写/测试代码，发布版本	反馈、任务、规格、约定、发布说明
SEO 与内容	跟踪趋势，起草文章，发布	关键词研究、简报、草稿、已发布页面
CRM	研究潜在客户，记录访问，跟进	公司、联系人、笔记、跟进历史
团队记忆	捕获决策、来源、上下文	可供未来代理搜索的知识库
数据集	标记示例，附加证据，评分质量	经过整理和审查的训练/评估数据

从模板开始，例如现成的 CRM 工作区：

busabase-cli install https://github.com/busabase/templates/tree/main/templates/busa-crm

架构概览

前端 – apps/busabase – 一个 Next.js UI，可在本地（桌面）或云端运行。
引擎 – packages/busabase-core – 实现节点、关系、文件树、审查原语、搜索、代理集成和公共 API。
API 表面 – 通过 MCP、OpenAPI 和 busabase-cli 客户端暴露。
存储 – 默认嵌入式 PGlite（类似 SQLite 的 Postgres）和文件存储；可替换为外部 Postgres 和兼容 S3 的对象存储。
安全模型 – 作用域凭据（changeRequest 级别、autoMerge 标志等）和审查收件箱；开源服务器旨在用于受信任的本地或私有网络。

参与其中

本地运行 – pnpm install && pnpm --filter busabase dev
贡献 – 通过 GitHub 仓库进行 lint、类型检查和提交 PR。
社区 – 网站、文档、论坛、YouTube 频道、X、LinkedIn。

许可证

MIT – 免费用于个人、商业或云使用。

TL;DR – Busabase 提供了一个持久、可查询且可审计的工作区，人类和 LLM 代理都可以读写。它让您将代理输出保留为结构化、版本控制的数据，而不是短暂的聊天日志，使多代理工作流、交接和长期知识保留变得实用。