用途:本技能用于本地创建、配置并运行一个 NocoBase 3 应用,产出的是可继续开发的源代码项目,而非用于部署的构建产物。项目生成后,其自带的 AGENTS.md 与 .agents/skills/ 接管后续开发,且与所安装版本一致,二者冲突时以项目内文档为准。
前置条件:Node.js 24 或更高,pnpm 11;Windows 需在 WSL 中以 Bash 等 POSIX shell 操作。若当前目录已存在含 nocobase 字段的 package.json 与 AGENTS.md,说明已有项目,应直接阅读其 AGENTS.md 继续,不再使用本技能。仅当用户希望安装 NocoBase Hub(--template hub)或部署到生产/服务器时,应改用 nocobase-app-installer。
创建:在父目录执行 pnpm create @nocobase/app,目标目录须为新目录或空目录,名称只含小写字母、数字、点、短横线和下划线;不要用 . 作名称。默认模板适合开发应用,探索示例可用 --template=examples,开发 Hub 自身代码用 --template=hub。NocoBase 3 包发布在 https://npm.nocobase.ai,需在 create 前指定 --registry。
配置与启动:依次执行 pnpm nocobase config init、config set、config check,再 pnpm dev 启动。SQLite 无需额外安装驱动,其他数据库需先装驱动并指定 --dialect。所有 config 命令建议加 --json 并按输出处理。密码只能通过环境变量设置,不要写入命令行或对话。
限制:本技能不涵盖应用开发方法;不要用 NocoBase 2 或 nb CLI 方式创建;不得删除目录重试或强制覆盖配置。具体功能与价格等信息资料未提供。