BiuMind — 你的 AI 工作台
写文档 · 跑 Agent · 写代码 · 做笔记 —— 把分散的 AI 工具收进同一个工作台,数据通在一起。
简体中文 · English
云端注册即用 · 一行命令自托管 · 桌面 / 手机 / 浏览器 / 命令行一个账号随时切换
快速开始 · 架构 · 官网 · 贡献指南
BiuMind 是什么?
BiuMind 是一个一体化 AI 工作平台:写文档、跑 Agent、写代码、做笔记这些原本分散在多个工具里的工作,被收进同一个工作台,并且数据互通——对话、剪藏、文档、创作产物都沉淀进同一个知识库,由 AI 连成知识图谱,供所有场景复用。
部署双轨:
核心功能
六大模块,覆盖一天的全部 AI 工作:
| 模块 | 能力 |
|---|
| 🧠 知识中枢 | 块编辑器 + 知识图谱 + AI 记忆;文档、对话、网页剪藏沉淀到同一个地方,语义搜索随时找回 |
| 💻 编码工作台 | 多个 AI 工程师并行写代码、跑测试、提 PR;改文件 / 跑命令前先征求你的确认;桌面 / 手机 / CLI 切换,任务云端续跑 |
| 🎨 创作 | 文生图、文生视频、爆款拆解;产物自动沉淀进知识库,可复用、二次创作 |
| ☁️ 云端工位 | 会话和记忆存云端,换设备上下文不丢 |
| 📮 消息接入 | AI 接入飞书 / Telegram / Slack / Discord / 邮件,自动回复 + 知识库召回 |
| 📦 应用中心 | RSS 订阅、邮件总结、股票动态、论文追踪等开箱即用的专业 AI 助手 |
多端覆盖
一个账号,四端随时切换,CLI 与 GUI 共享同一内核、会话互通:
- 桌面端(主力工作端):Flutter 单代码库,覆盖 macOS / Windows / Linux
- 移动端(伴随端):iOS / Android,随时随地审批 Agent 工作、看会话、查知识库;另有 uni-app 小程序(微信 / 支付宝 / 抖音 / 百度 / QQ / 快手 / 京东 / 飞书 / H5 共 9 端)
- 浏览器:网页剪藏扩展(Chrome / Edge),看到的一切一键沉淀进知识库
- 命令行:
biu CLI,终端内对话、跑 Agent、操作知识库
架构概览
BiuMind 是一个 monorepo,前后端与共享组件全部在一个仓库内:
- 后端:11 个 Go 微服务,HTTP + JWT 服务间通信,NATS JetStream 做异步消息,Postgres(pgvector + ltree)做统一数据层,每服务独立 schema + goose migration。
- Agent 协议:客户端 / CLI 与 Runtime 之间走 WebSocket 双向流的 SDK Protocol——JSON wire format + JSON Schema(
schema/sdk/v1/),Go 手写 struct / Dart json_serializable / TS Zod 三端实现。服务端业务 API 另由 buf 管理的 proto3 定义(packages/proto/)。
- 模型网关:
model-relay 是所有模型调用的唯一出口,支持 BYOK(自带 Key)与平台池,计费口径统一。
- 异步任务:Python workers 从 NATS 拉任务(文档解析、AIGC 生成、wiki 摄入、风控)。
后端服务(services/)
| 服务 | 职责 |
|---|
identity | 账号与认证:注册 / 登录 / 多端 token、额度与 BYOK 管理 |
authz | 鉴权策略引擎(policy + cache) |
realtime | 实时推送:WebSocket hub + NATS fanout |
model-relay | 模型网关:唯一出口、BYOK + 平台池、统一计费 |
runtime | Agent 运行时引擎(与 biu CLI 共享内核) |
brain | 知识层:Wiki / Graph / Memory / Search |
app_center | 应用中心:BiuApp 注册与运行(内置 RSS / 翻译 / 任务等参考应用) |
aigc | AIGC 接入层:文生图 / 视频 / 数字人(执行委托给 worker) |
channels | 多渠道分发:Telegram 等 driver,按环境开关 |
sandbox | 云沙箱:K8s Pod-per-sandbox,driver 可插拔 |
deploy | 一键部署:JWT-gated deploy API + 静态托管 |
billing 与 presence 服务在路线图中,尚未创建(见 go.work 注释)。
仓库结构
biumind/
├── apps/ # 前端产品
│ ├── client/ # Flutter 多端主端(桌面 / 移动 / Web)
│ ├── cli/biu/ # biu Go CLI(与服务端共享内核)
│ ├── webclip/ # 浏览器剪藏扩展(Chrome / Edge MV3)
│ └── miniapp/ # uni-app 跨端小程序(9 端)
├── web/site/ # 官网 biumind.ai(Astro + Tailwind,中英双语)
├── admin/ # 实例管理后台(Vue 3 + Element Plus)
├── services/ # 后端 Go 服务(见上表,11 个)
├── workers/ # Python workers:aigc / wiki-llm / wiki-parse / risk-control
├── packages/ # 跨产品共享:proto(buf)/ go-sdk / skills-stdlib
├── schema/ # SDK Protocol JSON Schema(sdk/v1)+ 发布 manifest(release/v1)
├── sdks/ # 公共集成 SDK(go / python / node,Apache-2.0)
├── extensions/vscode/ # VS Code 扩展
├── deploy/docker-compose/# 本地全栈:PG / MinIO / NATS + 服务 + workers
└── tools/ # bootstrap / schema 校验 / 架构不变量检查等脚本
快速开始
需要:Go 1.26+、Flutter (stable)、buf、uv (Python)、Docker。
task bootstrap # 一次性安装依赖(buf / goimports / dart / uv ...)
# 启动本地全栈(PG / MinIO / NATS + 各服务)
cd deploy/docker-compose
cp .env.example .env # ⚠️ 把 *_change_me 占位符全部换成强随机值
make up-infra && make health # 只起基础设施;make up / up-all 起完整栈
# 跑模型网关 + CLI
task model-relay:run
task cli:install # biu → ~/.local/bin/biu
biu # 进入 REPL
说明:deploy/docker-compose 是 dev/test 本地栈示例,非生产部署方案;sandbox 与 deploy 服务依赖 K8s / S3,不在本地栈内。私有化部署可直接拉取 CI 预构建镜像(.env 设 BIUMIND_REGISTRY=ghcr.io/biumind + BIUMIND_TAG=main 或 release 版本号),无需本地构建。
开发
task proto:generate # buf 生成 Go / Dart / TS
task test # 全量测试(Go + Dart + Python)
task lint # lint:go + lint:dart + lint:proto
task lint:invariants # 架构不变量校验(CI 强制)
task --list # 完整任务列表
贡献指引见 CONTRIBUTING.md。
安全
发现漏洞请按 SECURITY.md 私下上报,勿开公开 issue。
自托管前务必轮换 deploy/docker-compose/.env.example 里的占位密钥。
License
BiuMind 采用分层许可:
- 平台 / 产品(
apps/、admin/、services/、workers/、packages/、deploy/、schema/):BiuMind Community License —— source-available,允许个人 / 研究 / 教育 / 企业内部使用(含内部商用),但禁止把 BiuMind 作为公开 SaaS / 托管服务提供给第三方、禁止商业分发衍生品。商业使用联系 [email protected]。
- SDK + 扩展(
sdks/、extensions/):Apache-2.0 —— 鼓励嵌入集成。
自带(vendored)的第三方代码归属见各自目录的 LICENSE 文件(miniflux、webclip readability·turndown、rss_icons)。