用途：在本机或经 SSH 在离线 Linux 服务器上安装并运行已经构建好的 NocoBase 3 应用，只负责运行，不做开发。发布记录放在 releases/<version>_<build time>/app 下，由 pm2 运行；config.yml、app.env、storage/、backups/、logs/ 位于 releases 旁并在每次升级后保留。
使用方式：在 Agent 所在机器执行 npx --yes --registry="${NOCOBASE_REGISTRY:-https://registry.npmjs.org}" @nocobase/app-installer@beta <command> … --json。使用发布版 @beta，不要退回无标签或 @latest；已安装环境或被要求时保留明确版本。--json 输出一份文档，需读取 ok、status、result 及失败时的 error.code、error.message、error.suggestions、error.details，不能只看退出码。退出码：0 完成或无需操作，1 失败且原运行实例未动，2 用法或预检失败，3 升级失败已回滚，4 回滚也失败。
安装前确认目标目录、公开 origin、是否前置反向代理、端口（默认 13000）、数据库（默认 SQLite）。本机需 Node 24+ 与全局 pm2 4.3+；Windows 用 WSL。归档在应用项目中构建（如 pnpm build --target linux-x64 --node-version 24 --tar），产物为 storage/exports/dist.tar.gz，安装命令形如 install <dir> --archive <file> --origin <origin> --json。
适用场景：生产部署、离线服务器、多实例共存、升级与回滚。限制：不创建项目、不跑开发模式；归档目标平台须匹配；非 SQLite 需先在项目加入驱动；外部数据库需用户自行备份与恢复；origin/端口只能改 app.env 中三行并 pm2 restart；config.yml 含密钥，不要读出到对话中。部分细节以资料为准，未提供的功能暂不展开。