NocoBase 3 评测 从创建项目到离线配置检查
固定 beta 创建器、模板与 CLI,实测项目生成、重复初始化、数据库类型保护和 YAML 错误恢复,区分 Core、Studio 与完整业务验收。
AgentIndex · 发布于 2026-11-04 · 更新于 2026-11-04
NocoBase 为业务系统提供现成的应用基础,目标是让开发者和智能体把精力放在具体业务逻辑上。本次阅读的默认分支已转向 NocoBase 3;官方仍提供独立的 NocoBase 2 文档,因此选型时应先确认版本,再理解安装入口和开发方式。
我们的验证聚焦 NocoBase 3 的项目准备:官方模板是否能生成、配置是否有清楚状态、重复操作会不会覆盖已有文件,以及错误能否恢复。结果支持把它作为可脚本化的项目起点,但没有证明一套业务系统已经可上线,也没有测试商业 Studio 中的智能体协作。
先分清产品与版本
当前文档把 Core 定义为业务应用基础,把 Studio 定义为商业版本中的团队与智能体治理工作区;v3 包仍处于 beta。这里的产品代际、创建器版本、应用 CLI 版本和模板版本不是同一个数字。官方文档入口
2026-11-04 的核验使用 Node.js 26.6.0、独立安装的 pnpm 11.7.0、@nocobase/create-app 0.1.0-beta.34、默认模板 1.0.0-beta.87,以及 @nocobase/app-cli 1.0.0-beta.32。主仓库参考提交固定为 87f1ea54aebbf25ca0de3481125e6902f1426325。固定版本 README
不要把仍有发行的旧 @nocobase/cli 与本次应用 CLI 混为一谈。它们的包名和命令入口不同。复查一个安装案例时,应记录实际包名、版本和模板,而不是仅写“NocoBase 最新版”。
项目生成返回了什么
我们从父目录传入项目名,使用固定模板和 --no-install --json 生成项目。返回结果清楚区分 projectCreated: true、dependenciesInstalled: false 和 configured: false,同时列出后续安装、配置检查及开发命令。创建应用说明
| 检查 | 实际结果 |
|---|---|
| 名称中带路径分隔符 | 返回 INVALID_USAGE,没有创建目录 |
| 固定版本官方模板 | 生成成功,存在 server/runtime.ts |
| 再次使用同一项目名 | 拒绝,原 package.json 未被覆盖 |
| SQLite 配置初始化 | 成功生成临时配置 |
| 精简生产依赖环境直接加载源码 | 配置加载失败,缺少 TS 导入映射 |
| 显式提供 tsx 4.21.0 | 离线配置检查通过,没有发现项 |
| 相同方言再次初始化 | success-noop,文件字节不变 |
| 请求改成 PostgreSQL | ALREADY_CONFIGURED,文件不变 |
| 写入无效 YAML | CONFIG_INVALID |
| 恢复原配置 | 再次离线检查通过 |
| 机器可读命令目录 | 能找到配置初始化与检查命令 |
脚本、精确版本和结果见本站可复现样本。初始化会生成密钥,样本只发布状态和错误类型,不保存生成的配置或密钥。
创建、配置和运行是不同阶段
一个项目目录存在,并不代表依赖安装完成;配置文件写入成功,也不代表数据库、迁移和业务路由都已通过验收。创建器把这些状态分别返回,有助于调用它的自动化程序决定下一步,而不是只根据退出时出现了“成功”继续发布。
例如网络中断导致依赖安装失败时,应先确认文件是否已创建,再决定在现有目录重试安装还是重新生成。我们的同名项目检查显示,已有目录会被拒绝覆盖;这个行为可避免把一次重试变成无意替换项目。
本次实际生成了官方模板,又在一次性副本中运行配置命令。没有启动业务服务、连接数据库或执行迁移,因此不把这张结果表扩展为认证、权限隔离、工作流和数据一致性的测试结论。
源码模式需要合适的加载环境
为缩小实验范围,我们只安装了模板的生产依赖,并跳过安装脚本。这个精简环境能运行配置初始化,但直接加载 TypeScript 源码时,.js 导入没有对应到 .ts 文件,离线检查报告 load-failed。显式加入 tsx 4.21.0 后,同一份配置通过检查。
这说明应区分源码开发环境和编译后的部署环境。它不是“官方完整安装会失败”的证据,也不建议把本次精简依赖方案直接用作部署方式。正常开发应按所选版本文档安装完整依赖;排障时记录当前是在源码还是构建产物中运行。项目创建与环境要求
官方要求 Node.js 24 及以上、pnpm 11,Windows 使用 WSL。本次只在 macOS arm64 运行,没有测试其他系统。项目初始化成功并不能替代这些环境条件的核对。
重复执行的保护更值得检查
同一配置、同一数据库方言再次初始化时,CLI 返回 success-noop,并保持配置文件完全不变。这对自动化有用:已完成的步骤可以被识别,而不必因为重试就重新生成密钥。
如果已有 SQLite 配置,却要求改成 PostgreSQL,CLI 则拒绝,并返回 ALREADY_CONFIGURED。两种返回需要分别处理:前一种是已经达到目标,后一种是请求改变现状,不能把它们都折叠成“命令没有写文件”。配置初始化实现
无效 YAML 的检查和恢复也很实用。我们确认错误可被识别,恢复原文件后可以重新通过;这只说明所测配置路径的可恢复性,不能证明任意升级或数据库变更都能自动回滚。
离线检查与业务验收之间还缺什么
所有配置检查都显式使用 --no-connect。它有意保留了网络与数据库之外的检查边界,因此结果不能证明连接可用、账号权限正确或数据迁移成功。进一步采用时,应为自己关心的业务场景建立独立验收:例如两个不同身份访问同一资源、写入失败后的事务状态,以及重启后的数据保留。配置文档
功能和许可也需要按具体组件核对。我们读取的创建器与应用 CLI 包声明 Apache-2.0,这不是对所有模板、插件和商业 Studio 条款的统一结论。所需插件、授权方式及维护成本应列进选型清单。创建器包声明
如果团队希望让智能体在一致的应用基础上开发业务功能,v3 值得先用一个小型项目试验。把“可重复创建并配置”作为第一道门槛,再继续验证真实业务。运营资料整理可结合 Claude Ads 评测,构建证据留存可参考 .NET Skills 的 MSBuild 流程。