nocobase / nocobase

nocobase/nocobase

open_in_new前往仓库

NocoBase 是一个开源 AI + 无代码平台，用于快速构建业务系统。AI 基于生产级基础设施和所见即所得的无代码界面运行，兼顾速度与可靠性。

项目概览

项目概述

NocoBase 是一个开源的 AI + 无代码平台，用于快速构建业务系统。它结合了 AI 编码代理和所见即所得（WYSIWYG）的无代码界面，让 AI 和人类可以协作构建系统。AI 在成熟的生产级基础设施之上工作，而不是从头生成一切，从而兼顾速度和可靠性。

核心功能

  • AI 与人类协作构建：支持主流 AI 编码代理（如 Claude Code、Cursor、Codex、OpenCode、TRAE），可端到端处理安装、开发、迁移和发布；同时提供 WYSIWYG 无代码界面，支持一键切换使用/配置模式，可视化配置数据模型、页面、工作流和权限。
  • AI 员工：内置 AI 员工（如 Atlas、Dara、Dex、Ellis），可集成到业务流程中，自动获取业务上下文并执行任务，支持前端分析、问答、表单填写，后端文档识别、风险监控、任务路由等。
  • 开放接口：支持 MCP、HTTP API、CLI 和丰富的技能（Skills），外部代理可通过标准协议连接，如 OpenClaw、Hermes、Dify、Coze、n8n 等，并可连接 Telegram、WhatsApp、Slack、Gmail。
  • 权限控制：每个 AI 员工拥有独立角色，遵循与人类用户相同的细粒度权限，支持字段级读写权限，审计日志可追溯所有数据变更和工作流触发。
  • 数据模型驱动：业务数据存储在标准关系结构中，与 UI 解耦，支持主数据库、外部数据库和第三方 API 作为数据源，数据始终保留在自己的数据库中，无平台锁定。
  • 插件架构：微内核设计，一切皆插件，可通过可组合插件添加新功能，支持自定义插件和官方插件混合使用。

适用与不适用场景

适用场景：

  • 快速构建内部工具、CRM、ERP、项目管理等业务系统。
  • 需要 AI 辅助进行数据建模、页面配置、工作流编排的场景。
  • 需要 AI 员工参与业务流程执行和决策的场景。
  • 需要自托管、数据自主可控的企业应用。

不适用场景：

  • 需要高度定制化、非标准 UI 的复杂应用。
  • 对实时性要求极高的场景（AI 生成代码可能需要 review）。
  • 需要离线运行、无网络连接的环境。
  • 对 AI 生成代码质量有严格要求的场景（建议人工 review）。

技术架构与依赖

  • 语言：TypeScript
  • 架构：微内核插件架构，前后端分离，支持数据模型驱动。
  • 依赖：Node.js、Docker（推荐）、Yarn、PostgreSQL（默认数据库）。
  • AI 集成：支持主流 AI 编码代理，通过 CLI 和 Skills 集成。
  • 客户端：正在从 v1 迁移到 v2（client-v2），AI 生成的客户端代码基于 v2。

安装与快速开始

# 安装 NocoBase CLI
npm install -g @nocobase/cli
nb --version

# 初始化应用
nb init --ui

# 可选：与 AI 代理一起构建
codex # claude, opencode

详细步骤请参考官方文档：安装 NocoBase 应用 和 AI 代理集成指南。

典型使用方法

  • AI 搭建：使用自然语言描述需求，AI 自动完成数据建模、页面配置、权限设置等。例如："帮我创建一个客户管理页面，包含姓名搜索框和客户表格"。
  • AI 开发插件：使用自然语言描述插件需求，AI 生成完整的前后端代码。例如："帮我用 nocobase-plugin-development skill 开发一个水印插件"。
  • AI 员工：在业务界面中与 AI 员工对话，执行分析、数据整理、邮件处理等任务。
  • 工作流编排：描述业务流程，AI 自动创建触发器和节点链。例如："帮我编排一个订单创建之后自动扣减商品库存的工作流"。

配置与部署要点

  • 环境变量：APP_MODERN_CLIENT_PREFIX 可配置现代客户端 URL 前缀，运行时生效，无需重新构建。
  • Docker 部署：推荐使用 Docker 模式，镜像启动时自动生成 nginx 配置。
  • 数据库：默认使用 PostgreSQL，需注意 SQL 语法（如驼峰列名加双引号）。
  • 权限配置：为 AI 代理创建专用角色，遵循最小权限原则，避免直接绑定 root 或 admin。
  • 认证方式：支持 API key 和 OAuth 认证，推荐默认使用 OAuth，自动化任务使用 API key。

限制、风险与许可证

  • 许可证：仓库资料未提供明确的开源许可证（NOASSERTION）。
  • 限制：AI 生成的代码可能不完全正确，建议 review；client-v2 仍在开发中，不建议直接用于生产环境。
  • 风险：AI 代理操作需严格权限控制，防止越权；数据安全需关注审计日志。
  • 商业版：部分功能（如发布管理、版本控制）需要专业版及以上授权。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 README、文档目录（docs/）、AI 搭建/开发/员工相关文档。
  • 分析时间：2026-08-10（基于最新发布版本 v2.1.38 的日期）。