SuperAPI AI 工具集

nocobase-create-app

编程与开发

查看项目

更新于 10-16 07:24

技能介绍

用途:在本地创建并运行一个 NocoBase 3 项目,得到的是可继续开发的源代码,而不是用于部署的构建产物。若当前目录已存在 NocoBase 应用(含 nocobase 字段的 package.json 与 AGENTS.md),应直接读其 AGENTS.md,不要使用本技能;部署到生产环境属于 nocobase-app-installer。

前置检查:需 Node.js 24 或更高、pnpm 11。缺失或版本不符时先停止并告知用户安装方式(如 nvm install 24、corepack enable && corepack prepare pnpm@11 --activate),不要自行安装。Windows 需在 WSL 的 POSIX shell 中操作。

创建:目标目录必须新建或为空,名称以小写字母或数字开头,仅含小写字母、数字、点、短横线和下划线。命令为 (cd <parent-directory> && PNPM_CONFIG_MINIMUM_RELEASE_AGE=0 npm_config_registry="${NOCOBASE_REGISTRY:-https://registry.npmjs.org}" pnpm create @nocobase/app@beta <name> --template-tag=beta --json)。工具与模板都使用 beta 通道;探索示例功能可加 --template=examples。--json 只解析 stdout,按 ok、result 或 error.code、error.details.stage 判断结果;失败时不要删除目录重试。

配置:进入应用目录后先读其 AGENTS.md。依次执行 pnpm nocobase config init --dialect <dialect> --json、pnpm nocobase config set key=value … --json、pnpm nocobase config check --json,均需加 --json。SQLite 无需额外安装;其他数据库需先装驱动,如 pnpm add @nocobase/db-postgres@beta。密码只能通过环境变量设置:pnpm nocobase config set --from-env database.connections.main.password=<VARIABLE> --json,不得在对话或命令行中出现密码,也不要打印 config.yml。

启动:运行 pnpm dev(不退出,需后台运行),等待其打印含应用路径的 Local: URL,并用 curl -I 验证可访问。

限制:不负责应用开发指导,项目生成后由其自带 AGENTS.md 与 .agents/skills/ 接管;不负责生产部署;不要使用 NocoBase 2 或 nb CLI 的旧说明;不要用 --force 覆盖配置或删库来通过检查。首次登录账号来自 users.initialAdmin,默认用户名 nocobase、邮箱 admin@nocobase.com、密码 admin123,应读取该配置而非假定,并提醒登录后修改。