@nocobase/cli 2.1.0-beta.17 → 2.1.0-beta.19

package/README.md

@@ -147,6 +147,8 @@ In non-interactive mode, pass these setup-only flags again because they are not
 | `nb env` | Manage saved CLI env connections. |
 | `nb api` | Call NocoBase API resources from the CLI. |
 | `nb pm` | Manage plugins for the selected NocoBase env. |
+| `nb self` | Check or update the installed NocoBase CLI. |
+| `nb skills` | Check, install, or update NocoBase AI coding skills for the current workspace. |
 
 Recommended style: use `--env` explicitly for app/runtime commands. `-e` is the short form:
 
@@ -166,6 +168,35 @@ nb upgrade -e app1
 nb db start -e app1
 ```
 
+## CLI And Skills Updates
+
+Check whether the installed CLI itself is up to date:
+
+```bash
+nb self check
+nb self check --json
+```
+
+Update the CLI when it is installed globally with npm:
+
+```bash
+nb self update
+```
+
+Check whether the current workspace already has the NocoBase AI coding skills:
+
+```bash
+nb skills check
+nb skills check --json
+```
+
+Install the skills for the first time, or update an existing `nocobase/skills` install:
+
+```bash
+nb skills install
+nb skills update
+```
+
 ## Runtime Types
 
 ### Docker

package/bin/run.js

@@ -38,18 +38,20 @@ function reexecWithTsx() {
     process.exit(1);
   }
 
-  const result = spawnSync(
-    process.execPath,
-    ['--import', pathToFileURL(tsxEntry).href, '--disable-warning=ExperimentalWarning', ...process.argv.slice(1)],
-    {
-      stdio: 'inherit',
-      env: {
-        ...process.env,
-        _NOCO_CLI_TSX_CHILD: '1',
-        NODE_ENV: 'development',
-      },
+  const reexecArgs = ['--import', pathToFileURL(tsxEntry).href];
+  const supportedFlags = Array.from(process.allowedNodeEnvironmentFlags);
+  if (supportedFlags.some((flag) => flag === '--disable-warning' || flag.startsWith('--disable-warning='))) {
+    reexecArgs.push('--disable-warning=ExperimentalWarning');
+  }
+
+  const result = spawnSync(process.execPath, [...reexecArgs, ...process.argv.slice(1)], {
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      _NOCO_CLI_TSX_CHILD: '1',
+      NODE_ENV: 'development',
     },
-  );
+  });
   process.exit(result.status === null ? 1 : result.status);
 }
 

package/dist/commands/download.js

@@ -12,12 +12,13 @@ import * as p from '@clack/prompts';
 import path from 'node:path';
 import { stdin as stdinStream, stdout as stdoutStream } from 'node:process';
 import { runPromptCatalog, } from "../lib/prompt-catalog.js";
-import { applyCliLocale, CLI_LOCALE_FLAG_DESCRIPTION, CLI_LOCALE_FLAG_OPTIONS, localeText, translateCli, } from "../lib/cli-locale.js";
+import { applyCliLocale, CLI_LOCALE_FLAG_DESCRIPTION, CLI_LOCALE_FLAG_OPTIONS, localeText, resolveCliLocale, translateCli, } from "../lib/cli-locale.js";
 import { run } from "../lib/run-npm.js";
 import { printVerbose, setVerboseMode, startTask, stopTask, updateTask } from '../lib/ui.js';
 const DEFAULT_DOCKER_REGISTRY = 'nocobase/nocobase';
 const DEFAULT_DOCKER_REGISTRY_ZH_CN = 'registry.cn-shanghai.aliyuncs.com/nocobase/nocobase';
 const DEFAULT_DOCKER_PLATFORM = 'auto';
+const DEFAULT_DOWNLOAD_VERSION = 'beta';
 const downloadText = (key, values) => localeText(`commands.download.${key}`, values);
 const downloadTranslatedText = (key, values, fallback) => translateCli(`commands.download.${key}`, values, { fallback });
 function defaultOutputDirForVersion(versionTag) {
@@ -34,10 +35,13 @@ async function pathExists(target) {
     }
 }
 export function defaultDockerRegistryForLang(lang) {
-    return String(lang ?? '').trim() === 'zh-CN'
+    return resolveCliLocale(String(lang ?? '').trim() || undefined) === 'zh-CN'
         ? DEFAULT_DOCKER_REGISTRY_ZH_CN
         : DEFAULT_DOCKER_REGISTRY;
 }
+function defaultDockerRegistryForPromptValues(_values) {
+    return defaultDockerRegistryForLang(process.env.NB_LOCALE);
+}
 function argvHasToken(argv, tokens) {
     return tokens.some((t) => argv.includes(t));
 }
@@ -119,6 +123,27 @@ function formatDownloadFailure(message, verbose) {
 }
 const EXTERNAL_COMMAND_LOADING_DELAY_MS = 8_000;
 const EXTERNAL_COMMAND_LOADING_UPDATE_MS = 15_000;
+function normalizeVersionPreset(value) {
+    const text = String(value ?? '').trim();
+    if (text === 'latest' || text === 'beta' || text === 'alpha') {
+        return text;
+    }
+    return 'other';
+}
+function versionPresetForValue(value) {
+    return normalizeVersionPreset(value);
+}
+function otherVersionValue(value) {
+    const text = String(value ?? '').trim();
+    return normalizeVersionPreset(text) === 'other' ? text : '';
+}
+function resolveVersionFromResults(results, fallback) {
+    const preset = normalizeVersionPreset(results.version ?? fallback);
+    if (preset === 'other') {
+        return String(results.otherVersion ?? fallback ?? '').trim();
+    }
+    return preset;
+}
 export default class Download extends Command {
     _flags;
     preparationTaskActive = false;
@@ -212,30 +237,72 @@ export default class Download extends Command {
     static prompts = {
         source: {
             type: 'select',
+            variant: 'radio',
             message: downloadText('prompts.source.message'),
             options: [
-                { value: 'npm', label: downloadText('prompts.source.npmLabel') },
-                { value: 'git', label: downloadText('prompts.source.gitLabel') },
-                { value: 'docker', label: downloadText('prompts.source.dockerLabel') },
+                {
+                    value: 'docker',
+                    label: downloadText('prompts.source.dockerLabel'),
+                    hint: downloadText('prompts.source.dockerHint'),
+                },
+                {
+                    value: 'npm',
+                    label: downloadText('prompts.source.npmLabel'),
+                    hint: downloadText('prompts.source.npmHint'),
+                },
+                {
+                    value: 'git',
+                    label: downloadText('prompts.source.gitLabel'),
+                    hint: downloadText('prompts.source.gitHint'),
+                },
             ],
             yesInitialValue: 'docker',
             initialValue: 'docker',
             required: true,
         },
         version: {
-            type: 'text',
+            type: 'select',
+            variant: 'radio',
             message: downloadText('prompts.version.message'),
-            placeholder: downloadText('prompts.version.placeholder'),
-            initialValue: 'alpha',
-            yesInitialValue: 'alpha',
+            options: [
+                {
+                    value: 'latest',
+                    label: downloadText('prompts.version.latestLabel'),
+                    hint: downloadText('prompts.version.latestHint'),
+                    disabled: true,
+                },
+                {
+                    value: 'beta',
+                    label: downloadText('prompts.version.betaLabel'),
+                    hint: downloadText('prompts.version.betaHint'),
+                },
+                {
+                    value: 'alpha',
+                    label: downloadText('prompts.version.alphaLabel'),
+                    hint: downloadText('prompts.version.alphaHint'),
+                },
+                {
+                    value: 'other',
+                    label: downloadText('prompts.version.otherLabel'),
+                    hint: downloadText('prompts.version.otherHint'),
+                },
+            ],
+            initialValue: DEFAULT_DOWNLOAD_VERSION,
+            yesInitialValue: DEFAULT_DOWNLOAD_VERSION,
             required: true,
         },
+        otherVersion: {
+            type: 'text',
+            message: downloadText('prompts.otherVersion.message'),
+            placeholder: downloadText('prompts.otherVersion.placeholder'),
+            required: true,
+            hidden: (values) => normalizeVersionPreset(values.version) !== 'other',
+        },
         dockerRegistry: {
             type: 'text',
             message: downloadText('prompts.dockerRegistry.message'),
             placeholder: downloadText('prompts.dockerRegistry.placeholder'),
-            initialValue: (values) => defaultDockerRegistryForLang(values.lang),
-            yesInitialValue: DEFAULT_DOCKER_REGISTRY,
+            initialValue: defaultDockerRegistryForPromptValues,
             required: true,
             hidden: (values) => values.source !== 'docker',
         },
@@ -275,7 +342,10 @@ export default class Download extends Command {
             type: 'text',
             message: downloadText('prompts.outputDir.message'),
             placeholder: downloadText('prompts.outputDir.placeholder'),
-            initialValue: (values) => defaultOutputDirForVersion(String(values.version ?? 'latest').trim() || 'latest'),
+            initialValue: (values) => {
+                const version = resolveVersionFromResults(values, DEFAULT_DOWNLOAD_VERSION) || DEFAULT_DOWNLOAD_VERSION;
+                return defaultOutputDirForVersion(version);
+            },
             required: true,
             hidden: (values) => {
                 const s = values.source;
@@ -351,7 +421,7 @@ export default class Download extends Command {
         return outputAbs;
     }
     dockerTarPath(flags, outputAbs) {
-        const image = flags['docker-registry'] ?? DEFAULT_DOCKER_REGISTRY;
+        const image = String(flags['docker-registry'] ?? '').trim() || defaultDockerRegistryForLang(process.env.NB_LOCALE);
         const tag = flags.version ?? 'latest';
         const safeBase = `${image.replace(/[/:]/g, '-')}-${tag.replace(/[/\\]/g, '-')}`;
         return path.join(outputAbs, `${safeBase}.tar`);
@@ -362,12 +432,15 @@ export default class Download extends Command {
      */
     buildInitialValuesFromParsed(flags, preset) {
         const initialValues = {};
+        const localeDefaultDockerRegistry = defaultDockerRegistryForLang(flags.locale ?? process.env.NB_LOCALE);
         const source = flags.source?.trim();
         if (source) {
             initialValues.source = source;
         }
         if (flags.version !== undefined) {
-            initialValues.version = flags.version.trim() || 'latest';
+            const version = flags.version.trim() || 'latest';
+            initialValues.version = versionPresetForValue(version);
+            initialValues.otherVersion = otherVersionValue(version);
         }
         initialValues.replace = flags.replace;
         initialValues.devDependencies = flags['dev-dependencies'];
@@ -382,6 +455,9 @@ export default class Download extends Command {
         if (flags['docker-registry'] !== undefined) {
             initialValues.dockerRegistry = String(flags['docker-registry'] ?? '').trim();
         }
+        else {
+            initialValues.dockerRegistry = localeDefaultDockerRegistry;
+        }
         initialValues.dockerPlatform = normalizeDockerPlatform(flags['docker-platform']);
         initialValues.dockerSave = flags['docker-save'];
         if (flags['npm-registry'] !== undefined) {
@@ -406,7 +482,11 @@ export default class Download extends Command {
             preset.source = String(flags.source).trim();
         }
         if (flags.version !== undefined) {
-            preset.version = String(flags.version).trim() || 'latest';
+            const version = String(flags.version).trim() || 'latest';
+            preset.version = versionPresetForValue(version);
+            if (normalizeVersionPreset(version) === 'other') {
+                preset.otherVersion = version;
+            }
         }
         if (flags['docker-registry'] !== undefined) {
             const v = String(flags['docker-registry'] ?? '').trim();
@@ -460,7 +540,7 @@ export default class Download extends Command {
     }
     mapCatalogResultsToResolved(results, flags) {
         const source = String(results.source);
-        const version = String(results.version ?? '').trim() || 'latest';
+        const version = resolveVersionFromResults(results, flags.version) || 'latest';
         const devDependencies = source === 'npm' ? Boolean(results.devDependencies) : undefined;
         const effectiveBuild = this.resolveEffectiveBuild(source, results, flags);
         const buildDtsWant = results.buildDts !== undefined ? Boolean(results.buildDts) : flags['build-dts'];
@@ -471,9 +551,11 @@ export default class Download extends Command {
         const gitUrl = results.gitUrl !== undefined
             ? String(results.gitUrl).trim() || undefined
             : flags['git-url']?.trim() || undefined;
-        const dockerRegistry = results.dockerRegistry !== undefined
-            ? String(results.dockerRegistry).trim() || undefined
-            : flags['docker-registry']?.trim() || undefined;
+        const dockerRegistry = source === 'docker'
+            ? (results.dockerRegistry !== undefined
+                ? String(results.dockerRegistry).trim() || undefined
+                : flags['docker-registry']?.trim() || defaultDockerRegistryForLang(flags.locale ?? process.env.NB_LOCALE))
+            : undefined;
         const dockerPlatform = source === 'docker'
             ? normalizeDockerPlatform(results.dockerPlatform !== undefined
                 ? results.dockerPlatform
@@ -526,9 +608,13 @@ export default class Download extends Command {
             },
         });
         const source = String(results.source ?? '').trim();
+        const version = resolveVersionFromResults(results, flags.version);
         if (!source || !['docker', 'npm', 'git'].includes(source)) {
             this.error('Download source is required. Choose npm, git, or docker.');
         }
+        if (!version) {
+            this.error('Version is required. Choose alpha, beta, latest, or enter another version.');
+        }
         if (flags['docker-save'] && source !== 'docker') {
             this.error('--docker-save is only available when --source docker is selected.');
         }
@@ -622,7 +708,7 @@ export default class Download extends Command {
         return argv;
     }
     async downloadFromDocker(flags) {
-        const image = flags['docker-registry'] ?? DEFAULT_DOCKER_REGISTRY;
+        const image = String(flags['docker-registry'] ?? '').trim() || defaultDockerRegistryForLang(process.env.NB_LOCALE);
         const tag = flags.version ?? 'latest';
         const imageRef = `${image}:${tag}`;
         const platform = dockerPlatformArg(flags['docker-platform']);

package/dist/commands/init.js

@@ -17,7 +17,7 @@ import { runPromptCatalog, } from "../lib/prompt-catalog.js";
 import { applyCliLocale, localeText, translateCli } from "../lib/cli-locale.js";
 import { runPromptCatalogWebUI, } from "../lib/prompt-web-ui.js";
 import { validateApiBaseUrl, validateEnvKey } from "../lib/prompt-validators.js";
-import { run } from "../lib/run-npm.js";
+import { installNocoBaseSkills } from '../lib/skills-manager.js';
 import Download from "./download.js";
 import EnvAdd from "./env/add.js";
 import Install, { defaultDbPortForDialect } from "./install.js";
@@ -48,6 +48,13 @@ function downloadInNewInstallOnly(def) {
 function argvHasToken(argv, tokens) {
     return tokens.some((token) => argv.includes(token));
 }
+function resolveInitDownloadVersion(results) {
+    const preset = String(results.version ?? '').trim();
+    if (preset === 'other') {
+        return String(results.otherVersion ?? '').trim();
+    }
+    return preset;
+}
 function shouldAllowExistingInitEnv() {
     return argvHasToken(process.argv.slice(2), ['--force', '-f']);
 }
@@ -177,6 +184,7 @@ Prompt modes:
         fetchSource: newInstallOnly(Install.appPrompts.fetchSource),
         source: downloadInNewInstallOnly(Download.prompts.source),
         version: downloadInNewInstallOnly(Download.prompts.version),
+        otherVersion: downloadInNewInstallOnly(Download.prompts.otherVersion),
         dockerRegistry: downloadInNewInstallOnly(Download.prompts.dockerRegistry),
         dockerPlatform: downloadInNewInstallOnly(Download.prompts.dockerPlatform),
         dockerSave: downloadInNewInstallOnly(Download.prompts.dockerSave),
@@ -276,8 +284,8 @@ Prompt modes:
             p.intro(initTitle());
             if (Boolean(normalizedFlags['install-skills'])) {
                 try {
-                    p.log.step('Installing NocoBase agent skills (npx -y skills add nocobase/skills)');
-                    await run('npx', ['-y', 'skills', 'add', 'nocobase/skills', '-y']);
+                    p.log.step('Installing NocoBase agent skills (nb skills install)');
+                    await installNocoBaseSkills();
                 }
                 catch (error) {
                     const message = error instanceof Error ? error.message : String(error);
@@ -367,8 +375,8 @@ Prompt modes:
         }
         if (installSkills) {
             try {
-                p.log.step('Installing NocoBase agent skills (npx -y skills add nocobase/skills)');
-                await run('npx', ['-y', 'skills', 'add', 'nocobase/skills', '-y']);
+                p.log.step('Installing NocoBase agent skills (nb skills install)');
+                await installNocoBaseSkills();
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
@@ -472,6 +480,7 @@ Prompt modes:
                 catalog: {
                     source: c.source,
                     version: c.version,
+                    otherVersion: c.otherVersion,
                     dockerRegistry: c.dockerRegistry,
                     dockerPlatform: c.dockerPlatform,
                     dockerSave: c.dockerSave,
@@ -618,7 +627,7 @@ Prompt modes:
         const envName = String(results.appName ?? DEFAULT_INIT_APP_NAME).trim() || DEFAULT_INIT_APP_NAME;
         const appPort = String(results.appPort ?? '').trim();
         const source = String(results.source ?? '').trim();
-        const version = String(results.version ?? '').trim();
+        const version = resolveInitDownloadVersion(results);
         const dockerRegistry = String(results.dockerRegistry ?? '').trim();
         const dockerPlatform = String(results.dockerPlatform ?? '').trim();
         const gitUrl = String(results.gitUrl ?? '').trim();
@@ -706,7 +715,7 @@ Prompt modes:
             if (source) {
                 argv.push('--source', source);
             }
-            const version = String(results.version ?? '').trim();
+            const version = resolveInitDownloadVersion(results);
             if (version) {
                 argv.push('--version', version);
             }

package/dist/commands/install.js

@@ -15,7 +15,7 @@ import { mkdir } from 'node:fs/promises';
 import path from 'node:path';
 import { exit } from 'node:process';
 import { runPromptCatalog, } from "../lib/prompt-catalog.js";
-import { applyCliLocale, localeText, translateCli, } from "../lib/cli-locale.js";
+import { applyCliLocale, localeText, resolveCliLocale, translateCli, } from "../lib/cli-locale.js";
 import { findAvailableTcpPort, validateAvailableTcpPort, validateTcpPort, validateEnvKey, } from "../lib/prompt-validators.js";
 import { formatMissingManagedAppEnvMessage } from '../lib/app-runtime.js';
 import { run, runNocoBaseCommand } from '../lib/run-npm.js';
@@ -40,6 +40,12 @@ const DEFAULT_INSTALL_BUILTIN_DB_IMAGES = {
     mariadb: 'mariadb:11',
     kingbase: 'registry.cn-shanghai.aliyuncs.com/nocobase/kingbase:v009r001c001b0030_single_x86',
 };
+const DEFAULT_INSTALL_BUILTIN_DB_IMAGES_ZH_CN = {
+    postgres: 'registry.cn-shanghai.aliyuncs.com/nocobase/postgres:16',
+    mysql: 'registry.cn-shanghai.aliyuncs.com/nocobase/mysql:8',
+    mariadb: 'registry.cn-shanghai.aliyuncs.com/nocobase/mariadb:11',
+    kingbase: 'registry.cn-shanghai.aliyuncs.com/nocobase/kingbase:v009r001c001b0030_single_x86',
+};
 const DEFAULT_INSTALL_DB_DATABASE = 'nocobase';
 const DEFAULT_INSTALL_DB_USER = 'nocobase';
 const DEFAULT_INSTALL_DB_PASSWORD = 'nocobase';
@@ -141,9 +147,12 @@ export function defaultDbPortForDialect(value) {
 }
 function defaultBuiltinDbImageForDialect(value) {
     const dialect = String(value ?? 'postgres').trim();
+    const defaults = resolveCliLocale(process.env.NB_LOCALE) === 'zh-CN'
+        ? DEFAULT_INSTALL_BUILTIN_DB_IMAGES_ZH_CN
+        : DEFAULT_INSTALL_BUILTIN_DB_IMAGES;
     return supportsBuiltinDbDialect(dialect)
-        ? DEFAULT_INSTALL_BUILTIN_DB_IMAGES[dialect]
-        : DEFAULT_INSTALL_BUILTIN_DB_IMAGES.postgres;
+        ? defaults[dialect]
+        : defaults.postgres;
 }
 function defaultDbDatabaseForDialect(value) {
     return String(value ?? '').trim() === 'kingbase'
@@ -808,15 +817,15 @@ export default class Install extends Command {
         };
     }
     /**
-     * When install runs {@link Download.prompts} after app prompts, align language and
-     * output directory defaults with the app settings collected earlier in the flow.
+     * When install runs {@link Download.prompts} after app prompts, align the download
+     * output directory with app settings, while Docker registry defaults follow the CLI locale.
      */
     static buildDownloadPromptOptionsForInstall(appResults, envName) {
         const appRoot = String(appResults.appRootPath ?? '').trim() || defaultInstallAppRootPath(envName);
         const lang = String(appResults.lang ?? DEFAULT_INSTALL_LANG).trim() || DEFAULT_INSTALL_LANG;
         const initialValues = {
             lang,
-            dockerRegistry: defaultDockerRegistryForLang(lang),
+            dockerRegistry: defaultDockerRegistryForLang(process.env.NB_LOCALE),
             outputDir: appRoot,
         };
         const values = {
@@ -974,7 +983,7 @@ export default class Install extends Command {
                 ? dbHostInput
                 : containerName);
         if (dbDialect === 'postgres') {
-            const image = String(params.builtinDbImage ?? '').trim() || DEFAULT_INSTALL_BUILTIN_DB_IMAGES.postgres;
+            const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
             const dataDir = path.resolve(params.storagePath, 'db', 'postgres');
             const args = [
                 'run',
@@ -1018,7 +1027,7 @@ export default class Install extends Command {
             };
         }
         if (dbDialect === 'mysql') {
-            const image = String(params.builtinDbImage ?? '').trim() || DEFAULT_INSTALL_BUILTIN_DB_IMAGES.mysql;
+            const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
             const dataDir = path.resolve(params.storagePath, 'db', 'mysql');
             const dbUser = String(params.dbUser ?? DEFAULT_INSTALL_DB_USER).trim() || DEFAULT_INSTALL_DB_USER;
             const dbDatabase = String(params.dbDatabase ?? defaultDbDatabase).trim() || defaultDbDatabase;
@@ -1064,7 +1073,7 @@ export default class Install extends Command {
             };
         }
         if (dbDialect === 'mariadb') {
-            const image = String(params.builtinDbImage ?? '').trim() || DEFAULT_INSTALL_BUILTIN_DB_IMAGES.mariadb;
+            const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
             const dataDir = path.resolve(params.storagePath, 'db', 'mariadb');
             const dbUser = String(params.dbUser ?? DEFAULT_INSTALL_DB_USER).trim() || DEFAULT_INSTALL_DB_USER;
             const dbDatabase = String(params.dbDatabase ?? defaultDbDatabase).trim() || defaultDbDatabase;
@@ -1110,7 +1119,7 @@ export default class Install extends Command {
             };
         }
         if (dbDialect === 'kingbase') {
-            const image = String(params.builtinDbImage ?? '').trim() || DEFAULT_INSTALL_BUILTIN_DB_IMAGES.kingbase;
+            const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
             const dataDir = path.resolve(params.storagePath, 'db', 'kingbase');
             const dbUser = String(params.dbUser ?? DEFAULT_INSTALL_DB_USER).trim() || DEFAULT_INSTALL_DB_USER;
             const dbDatabase = String(params.dbDatabase ?? defaultDbDatabase).trim() || defaultDbDatabase;
@@ -1198,6 +1207,7 @@ export default class Install extends Command {
     async removeDockerContainer(name) {
         await run('docker', ['rm', '-f', name], {
             errorName: 'docker rm',
+            stdio: 'ignore',
         });
     }
     async removeDockerContainerIfForced(params) {
@@ -1229,7 +1239,7 @@ export default class Install extends Command {
         }
         return env;
     }
-    async ensureBuiltinDbContainer(plan) {
+    async ensureBuiltinDbContainer(plan, options) {
         const exists = await this.dockerContainerExists(plan.containerName);
         if (exists) {
             p.log.info(`Built-in ${plan.dbDialect} container already exists: ${plan.containerName}`);
@@ -1238,6 +1248,7 @@ export default class Install extends Command {
         await mkdir(plan.dataDir, { recursive: true });
         await run('docker', plan.args, {
             errorName: 'docker run',
+            stdio: options?.stdio ?? 'ignore',
         });
     }
     async startBuiltinDb(params) {
@@ -1269,13 +1280,15 @@ export default class Install extends Command {
                 throw new Error(`Built-in ${plan.dbDialect} needs host port ${plan.dbPort}, but ${portError}`);
             }
         }
-        await this.ensureBuiltinDbContainer(plan);
+        await this.ensureBuiltinDbContainer(plan, {
+            stdio: params.commandStdio ?? 'ignore',
+        });
         p.log.info(`Built-in ${plan.dbDialect} database is ready at ${plan.dbHost}:${plan.dbPort}`);
         return plan;
     }
     static buildDockerAppPlan(params) {
         const dockerRegistry = String(downloadResultsValue(params.downloadResults, 'dockerRegistry') ?? '').trim()
-            || defaultDockerRegistryForLang(params.appResults.lang);
+            || defaultDockerRegistryForLang(process.env.NB_LOCALE);
         const version = String(downloadResultsValue(params.downloadResults, 'version') ?? '').trim() || 'latest';
         const appPort = String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT;
         const storagePath = path.resolve(String(params.appResults.storagePath ?? '').trim()
@@ -1323,7 +1336,7 @@ export default class Install extends Command {
             args,
         };
     }
-    async ensureDockerAppContainer(plan) {
+    async ensureDockerAppContainer(plan, options) {
         const exists = await this.dockerContainerExists(plan.containerName);
         if (exists) {
             p.log.info(`App container already exists: ${plan.containerName}`);
@@ -1332,6 +1345,7 @@ export default class Install extends Command {
         await mkdir(plan.storagePath, { recursive: true });
         await run('docker', plan.args, {
             errorName: 'docker run',
+            stdio: options?.stdio ?? 'ignore',
         });
         return 'created';
     }
@@ -1354,7 +1368,9 @@ export default class Install extends Command {
             displayName: 'app container',
             force: params.force,
         });
-        const containerState = await this.ensureDockerAppContainer(plan);
+        const containerState = await this.ensureDockerAppContainer(plan, {
+            stdio: params.commandStdio ?? 'ignore',
+        });
         if (containerState === 'existing') {
             const env = await this.inspectDockerContainerEnv(plan.containerName);
             plan.appKey = env.APP_KEY || plan.appKey;
@@ -1408,12 +1424,24 @@ export default class Install extends Command {
             || defaultInstallAppRootPath(params.envName);
         return path.resolve(process.cwd(), outputDir);
     }
-    async downloadLocalApp(params) {
+    commandStdio(verbose) {
+        return verbose ? 'inherit' : 'ignore';
+    }
+    async downloadManagedSource(params) {
         const argv = Install.buildDownloadArgvFromResults(params.downloadResults, {
             verbose: params.verbose,
         });
-        p.log.step('Downloading local NocoBase app files');
-        const result = await this.config.runCommand('download', argv);
+        const source = String(params.downloadResults.source ?? '').trim();
+        p.log.step(source === 'docker'
+            ? 'Downloading Docker image'
+            : 'Downloading local NocoBase app files');
+        return await this.config.runCommand('download', argv);
+    }
+    async downloadLocalApp(params) {
+        const result = await this.downloadManagedSource({
+            downloadResults: params.downloadResults,
+            verbose: params.verbose,
+        });
         const projectRoot = Install.resolveLocalProjectRoot({
             envName: params.envName,
             appResults: params.appResults,
@@ -1467,6 +1495,7 @@ export default class Install extends Command {
             await runNocoBaseCommand(['pm2', 'kill'], {
                 cwd: params.projectRoot,
                 env,
+                stdio: params.commandStdio ?? 'ignore',
             });
         }
         catch (error) {
@@ -1477,6 +1506,7 @@ export default class Install extends Command {
         await runNocoBaseCommand(args, {
             cwd: params.projectRoot,
             env,
+            stdio: params.commandStdio ?? 'ignore',
         });
         p.log.info(`Local app is starting at http://127.0.0.1:${env.APP_PORT}`);
         return {
@@ -1752,6 +1782,7 @@ export default class Install extends Command {
         const parsed = {
             ...flags,
         };
+        const commandStdio = this.commandStdio(parsed.verbose);
         if (!parsed['no-intro']) {
             p.intro('Set Up NocoBase');
         }
@@ -1778,6 +1809,7 @@ export default class Install extends Command {
                 downloadResults,
                 dbResults,
                 force: parsed.force,
+                commandStdio,
             });
             dbResults.dbHost = builtinDbPlan.dbHost;
             dbResults.dbPort = builtinDbPlan.dbPort;
@@ -1790,6 +1822,10 @@ export default class Install extends Command {
         let localAppPlan;
         if (Boolean(appResults.fetchSource)) {
             if (source === 'docker') {
+                await this.downloadManagedSource({
+                    downloadResults,
+                    verbose: parsed.verbose,
+                });
                 dockerAppPlan = await this.installDockerApp({
                     envName,
                     workspaceName,
@@ -1799,6 +1835,7 @@ export default class Install extends Command {
                     rootResults,
                     builtinDbPlan,
                     force: parsed.force,
+                    commandStdio,
                 });
                 appResults.appKey = dockerAppPlan.appKey;
                 appResults.timeZone = dockerAppPlan.timeZone;
@@ -1817,6 +1854,7 @@ export default class Install extends Command {
                     appResults,
                     dbResults,
                     rootResults,
+                    commandStdio,
                 });
                 appResults.appKey = localAppPlan.appKey;
                 appResults.timeZone = localAppPlan.timeZone;