## 项目概述

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。

## 安装与快速开始

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

# 初始化应用
nb init --ui

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

详细步骤请参考官方文档：[安装 NocoBase 应用](https://docs.nocobase.com/ai/install-nocobase-app) 和 [AI 代理集成指南](https://docs.nocobase.com/ai/quick-start)。

## 典型使用方法

- **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 代理操作需严格权限控制，防止越权；数据安全需关注审计日志。
- **商业版**：部分功能（如发布管理、版本控制）需要专业版及以上授权。

## 官方链接

- 官网：https://www.nocobase.com/
- 在线演示：https://demo.nocobase.com/new
- 文档：https://docs.nocobase.com/
- 论坛：https://forum.nocobase.com/c/english-forum/5
- 用户故事：https://www.nocobase.com/en/blog/tags/customer-stories
- 发布说明：https://www.nocobase.com/en/blog/timeline

## 信息来源和分析时间

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