@nocobase/cli 2.1.31 → 2.2.0-alpha.10

package/dist/commands/config/set.js

@@ -14,6 +14,7 @@ export default class ConfigSet extends Command {
     static description = 'Set a CLI configuration value for a supported configuration key.';
     static examples = [
         '<%= config.bin %> <%= command.id %> locale zh-CN',
+        '<%= config.bin %> <%= command.id %> default-portal-template @nocobase/portal-template-default',
         '<%= config.bin %> <%= command.id %> update.policy prompt',
         '<%= config.bin %> <%= command.id %> docker.network nocobase',
         '<%= config.bin %> <%= command.id %> docker.container-prefix nb',

package/dist/commands/init.js

@@ -32,8 +32,12 @@ import EnvAdd from "./env/add.js";
 import Install, { defaultDbPortForDialect } from "./install.js";
 const DEFAULT_INIT_API_BASE_URL = 'http://localhost:13000/api';
 const DEFAULT_INIT_APP_NAME = 'local';
+const DEFAULT_INIT_PORTAL_TYPE = 'no-code';
+const DEFAULT_INIT_PORTAL_NAME = 'admin';
+const DEFAULT_INIT_PORTAL_TEMPLATE = '@nocobase/portal-template-default';
 const DOWNLOAD_OUTPUT_DIR_PROMPT = Download.prompts.outputDir;
 const INIT_SETUP_MODES = ['install-new', 'manage-local', 'connect-remote'];
+const INIT_PORTAL_TYPES = ['no-code', 'ai'];
 const INIT_ENV_ADD_FLAG_NAMES = [
     'locale',
     'default-api-base-url',
@@ -80,6 +84,9 @@ function isInstallNewSetupMode(values) {
 function isInstallLikeSetupMode(values) {
     return !isRemoteSetupMode(values);
 }
+function isAiMode(values) {
+    return String(values.portalType ?? DEFAULT_INIT_PORTAL_TYPE).trim() === 'ai';
+}
 function remoteConnectionOnly(def) {
     return withExtraHidden(def, (values) => !isRemoteSetupMode(values));
 }
@@ -387,6 +394,42 @@ Prompt modes:
         devDependencies: installLikeDownloadExecutionOnly(Download.prompts.devDependencies),
         build: installLikeDownloadExecutionOnly(Download.prompts.build),
         buildDts: installLikeDownloadExecutionOnly(Download.prompts.buildDts),
+        portalType: installNewOnly({
+            type: 'select',
+            variant: 'radio',
+            message: initText('prompts.portalType.message'),
+            options: [
+                {
+                    value: 'no-code',
+                    label: initText('prompts.portalType.noCodeLabel'),
+                    hint: initText('prompts.portalType.noCodeHint'),
+                },
+                {
+                    value: 'ai',
+                    label: initText('prompts.portalType.aiLabel'),
+                    hint: initText('prompts.portalType.aiHint'),
+                },
+            ],
+            initialValue: DEFAULT_INIT_PORTAL_TYPE,
+            yesInitialValue: DEFAULT_INIT_PORTAL_TYPE,
+            required: true,
+        }),
+        portalName: installNewOnly({
+            type: 'text',
+            message: initText('prompts.portalName.message'),
+            placeholder: DEFAULT_INIT_PORTAL_NAME,
+            initialValue: DEFAULT_INIT_PORTAL_NAME,
+            yesInitialValue: DEFAULT_INIT_PORTAL_NAME,
+            required: true,
+        }),
+        portalTemplate: installNewOnly({
+            type: 'text',
+            message: initText('prompts.portalTemplate.message'),
+            placeholder: DEFAULT_INIT_PORTAL_TEMPLATE,
+            yesInitialValue: DEFAULT_INIT_PORTAL_TEMPLATE,
+            hidden: (values) => !isAiMode(values),
+            required: true,
+        }),
         dbDialect: installLikeOnly(Install.dbPrompts.dbDialect),
         builtinDb: installLikeOnly(Install.dbPrompts.builtinDb),
         builtinDbImage: installLikeOnly(Install.dbPrompts.builtinDbImage),
@@ -412,6 +455,13 @@ Prompt modes:
             ...Init.prompts,
             installApiBaseUrl: createInstallConnectionApiBaseUrlPrompt(options.defaultApiHost),
         };
+        const defaultPortalTemplate = String(options.defaultPortalTemplate ?? '').trim();
+        if (defaultPortalTemplate) {
+            prompts.portalTemplate = {
+                ...prompts.portalTemplate,
+                yesInitialValue: defaultPortalTemplate,
+            };
+        }
         if (flags['skip-auth']) {
             const accessTokenPrompt = {
                 ...EnvAdd.prompts.accessToken,
@@ -461,6 +511,16 @@ Prompt modes:
             description: 'Setup mode: install a new app, manage a local app by reusing its database, or connect a remote app',
             options: [...INIT_SETUP_MODES],
         }),
+        'portal-type': Flags.string({
+            description: 'Initial portal type: no-code or ai',
+            options: [...INIT_PORTAL_TYPES],
+        }),
+        'portal-name': Flags.string({
+            description: 'Initial portal name',
+        }),
+        'portal-template': Flags.string({
+            description: 'Initial portal template npm package or local path when --portal-type ai is used',
+        }),
         ui: Flags.boolean({
             description: 'Open the guided setup flow in a local browser form (not valid with --yes)',
             default: false,
@@ -578,7 +638,8 @@ Prompt modes:
         const dynamicInitialValues = await Init.buildDynamicInitialValuesForInstall(normalizedFlags, presetValues);
         const defaultUiHost = await resolveDefaultUiHost();
         const defaultApiHost = await resolveDefaultApiHost();
-        const promptCatalog = this.buildPromptCatalog(normalizedFlags, { defaultApiHost });
+        const defaultPortalTemplate = String(dynamicInitialValues.portalTemplate ?? '').trim();
+        const promptCatalog = this.buildPromptCatalog(normalizedFlags, { defaultApiHost, defaultPortalTemplate });
         if (useBrowserUi) {
             presetValues = await runPromptCatalogWebUI({
                 stages: Init.buildWebUiStages(promptCatalog),
@@ -607,6 +668,7 @@ Prompt modes:
                     ? { setupMode: normalizeInitSetupMode(presetValues.hasNocobase) }
                     : {}),
             },
+            yesInitialValues: pickKeys(dynamicInitialValues, ['portalTemplate']),
             values: presetValues,
             yes: normalizedFlags.yes || useBrowserUi || !interactive,
             hooks: {
@@ -679,7 +741,9 @@ Prompt modes:
     }
     static async buildDynamicInitialValuesForInstall(flags, presetValues) {
         const out = {};
-        if (!Object.prototype.hasOwnProperty.call(presetValues, 'appPort')) {
+        const shouldResolveAppInitialValues = !Object.prototype.hasOwnProperty.call(presetValues, 'appPort') ||
+            !Object.prototype.hasOwnProperty.call(presetValues, 'portalTemplate');
+        if (shouldResolveAppInitialValues) {
             const appInitialValues = await Install.buildAppPromptInitialValues({
                 envName: String(presetValues.appName ?? '').trim(),
                 flags: {
@@ -687,12 +751,20 @@ Prompt modes:
                     'app-path': flags['app-path'] ?? '',
                     'app-root-path': flags['app-root-path'] ?? '',
                     'storage-path': flags['storage-path'] ?? '',
+                    'portal-template': flags['portal-template'] ??
+                        (Object.prototype.hasOwnProperty.call(presetValues, 'portalTemplate')
+                            ? String(presetValues.portalTemplate ?? '')
+                            : undefined),
                 },
                 warnOnPortFallback: false,
             });
-            if (appInitialValues.appPort !== undefined) {
+            if (appInitialValues.appPort !== undefined && !Object.prototype.hasOwnProperty.call(presetValues, 'appPort')) {
                 out.appPort = appInitialValues.appPort;
             }
+            if (appInitialValues.portalTemplate !== undefined &&
+                !Object.prototype.hasOwnProperty.call(presetValues, 'portalTemplate')) {
+                out.portalTemplate = appInitialValues.portalTemplate;
+            }
         }
         const downloadSeed = { ...presetValues };
         if (flags.yes && !Object.prototype.hasOwnProperty.call(downloadSeed, 'source')) {
@@ -771,6 +843,14 @@ Prompt modes:
                     buildDts: c.buildDts,
                 },
             },
+            {
+                sectionTitle: initText('webUi.portalType.title'),
+                sectionDescription: initText('webUi.portalType.description'),
+                catalog: {
+                    portalName: c.portalName,
+                    portalType: c.portalType,
+                },
+            },
             {
                 sectionTitle: initText('webUi.configureDatabase.title'),
                 sectionDescription: initText('webUi.configureDatabase.description'),
@@ -871,6 +951,15 @@ Prompt modes:
         if (flags['app-public-path'] !== undefined && String(flags['app-public-path']).trim() !== '') {
             preset.appPublicPath = String(flags['app-public-path']).trim();
         }
+        if (flags['portal-type'] !== undefined && String(flags['portal-type']).trim() !== '') {
+            preset.portalType = String(flags['portal-type']).trim();
+        }
+        if (flags['portal-name'] !== undefined && String(flags['portal-name']).trim() !== '') {
+            preset.portalName = String(flags['portal-name']).trim();
+        }
+        if (flags['portal-template'] !== undefined && String(flags['portal-template']).trim() !== '') {
+            preset.portalTemplate = String(flags['portal-template']).trim();
+        }
         if (flags['root-username'] !== undefined) {
             preset.rootUsername = String(flags['root-username'] ?? '').trim();
         }
@@ -1008,6 +1097,9 @@ Prompt modes:
         const existingEnv = await getEnv(envName, { scope: resolveDefaultConfigScope() });
         const appPort = String(results.appPort ?? '').trim();
         const appPublicPath = String(results.appPublicPath ?? '').trim();
+        const portalType = String(results.portalType ?? '').trim();
+        const portalName = String(results.portalName ?? '').trim();
+        const portalTemplate = String(results.portalTemplate ?? '').trim();
         const source = String(results.source ?? '').trim();
         const version = resolveInitDownloadVersion(results);
         const dockerRegistry = String(results.dockerRegistry ?? '').trim();
@@ -1080,6 +1172,9 @@ Prompt modes:
             ...(storagePath && !areConfiguredPathsEquivalent(storagePath, derivedStoragePath) ? { storagePath } : {}),
             ...(appPort ? { appPort } : {}),
             ...(appPublicPath ? { appPublicPath } : {}),
+            ...(portalType && portalType !== DEFAULT_INIT_PORTAL_TYPE ? { portalType } : {}),
+            ...(portalName ? { portalName } : {}),
+            ...(portalTemplate ? { portalTemplate } : {}),
             ...(appKey ? { appKey } : {}),
             ...(timeZone ? { timezone: timeZone } : {}),
             ...(!skipDownload && results.devDependencies !== undefined
@@ -1204,6 +1299,18 @@ Prompt modes:
         if (appPublicPath) {
             argv.push('--app-public-path', appPublicPath);
         }
+        const portalType = String(results.portalType ?? '').trim();
+        if (portalType && portalType !== DEFAULT_INIT_PORTAL_TYPE) {
+            argv.push('--portal-type', portalType);
+        }
+        const portalName = String(results.portalName ?? '').trim();
+        if (portalName) {
+            argv.push('--portal-name', portalName);
+        }
+        const portalTemplate = String(results.portalTemplate ?? '').trim();
+        if (portalTemplate) {
+            argv.push('--portal-template', portalTemplate);
+        }
         if (flags.force) {
             argv.push('--force');
         }
@@ -1401,6 +1508,15 @@ Prompt modes:
             delete normalized.rootPassword;
             delete normalized.rootNickname;
         }
+        const portalType = normalizeConnectionString(normalized.portalType) || DEFAULT_INIT_PORTAL_TYPE;
+        normalized.portalType = portalType;
+        normalized.portalName = normalizeConnectionString(normalized.portalName) || DEFAULT_INIT_PORTAL_NAME;
+        if (portalType === 'ai') {
+            normalized.portalTemplate = normalizeConnectionString(normalized.portalTemplate);
+        }
+        else {
+            delete normalized.portalTemplate;
+        }
         delete normalized.installApiBaseUrl;
         delete normalized.installAuthType;
         delete normalized.installUsername;

package/dist/commands/install.js

@@ -53,6 +53,10 @@ const DEFAULT_INSTALL_ROOT_EMAIL = 'admin@nocobase.com';
 const DEFAULT_INSTALL_ROOT_PASSWORD = 'admin123';
 const DEFAULT_INSTALL_ROOT_NICKNAME = 'Super Admin';
 const DEFAULT_INSTALL_API_HOST = '127.0.0.1';
+const DEFAULT_INSTALL_PORTAL_TYPE = 'no-code';
+const DEFAULT_INSTALL_PORTAL_NAME = 'admin';
+const DEFAULT_INSTALL_PORTAL_TEMPLATE = '@nocobase/portal-template-default';
+const INSTALL_PORTAL_TYPES = ['no-code', 'ai'];
 function toOptionalPromptString(value) {
     const text = String(value ?? '').trim();
     return text || undefined;
@@ -180,6 +184,9 @@ function defaultBuiltinDbImageForDialect(value, options) {
 function defaultDbDatabaseForDialect(value) {
     return String(value ?? '').trim() === 'kingbase' ? 'kingbase' : DEFAULT_INSTALL_DB_DATABASE;
 }
+function isAiMode(values) {
+    return String(values.portalType ?? DEFAULT_INSTALL_PORTAL_TYPE).trim() === 'ai';
+}
 function supportsDbSchemaPrompt(value) {
     const dialect = String(value ?? '').trim();
     return dialect === 'postgres' || dialect === 'kingbase';
@@ -404,6 +411,16 @@ export default class Install extends Command {
         'app-public-path': Flags.string({
             description: 'Public path for the local app, for example / or /console/',
         }),
+        'portal-type': Flags.string({
+            description: 'Initial portal type for the installed app',
+            options: [...INSTALL_PORTAL_TYPES],
+        }),
+        'portal-name': Flags.string({
+            description: 'Initial portal name',
+        }),
+        'portal-template': Flags.string({
+            description: 'Initial portal template npm package or local path when --portal-type ai is used',
+        }),
         'root-username': Flags.string({
             description: 'Initial admin username for the installed app',
             required: false,
@@ -513,6 +530,41 @@ export default class Install extends Command {
                 yesInitialValue: '/',
                 validate: validateAppPublicPath,
             },
+            portalType: {
+                type: 'select',
+                message: installText('prompts.portalType.message'),
+                options: [
+                    {
+                        value: 'no-code',
+                        label: installText('prompts.portalType.noCodeLabel'),
+                        hint: installText('prompts.portalType.noCodeHint'),
+                    },
+                    {
+                        value: 'ai',
+                        label: installText('prompts.portalType.aiLabel'),
+                        hint: installText('prompts.portalType.aiHint'),
+                    },
+                ],
+                initialValue: DEFAULT_INSTALL_PORTAL_TYPE,
+                yesInitialValue: DEFAULT_INSTALL_PORTAL_TYPE,
+                required: true,
+            },
+            portalName: {
+                type: 'text',
+                message: installText('prompts.portalName.message'),
+                placeholder: DEFAULT_INSTALL_PORTAL_NAME,
+                initialValue: DEFAULT_INSTALL_PORTAL_NAME,
+                yesInitialValue: DEFAULT_INSTALL_PORTAL_NAME,
+                required: true,
+            },
+            portalTemplate: {
+                type: 'text',
+                message: installText('prompts.portalTemplate.message'),
+                placeholder: DEFAULT_INSTALL_PORTAL_TEMPLATE,
+                yesInitialValue: DEFAULT_INSTALL_PORTAL_TEMPLATE,
+                hidden: (values) => !isAiMode(values),
+                required: true,
+            },
         };
     }
     static dbPrompts = {
@@ -772,6 +824,24 @@ export default class Install extends Command {
                 preset.appPublicPath = v;
             }
         }
+        if (flags['portal-type'] !== undefined) {
+            const v = String(flags['portal-type'] ?? '').trim();
+            if (v) {
+                preset.portalType = v;
+            }
+        }
+        if (flags['portal-name'] !== undefined) {
+            const v = String(flags['portal-name'] ?? '').trim();
+            if (v) {
+                preset.portalName = v;
+            }
+        }
+        if (flags['portal-template'] !== undefined) {
+            const v = String(flags['portal-template'] ?? '').trim();
+            if (v) {
+                preset.portalTemplate = v;
+            }
+        }
         if (flags['root-username'] !== undefined) {
             preset.rootUsername = String(flags['root-username'] ?? '').trim();
         }
@@ -863,6 +933,9 @@ export default class Install extends Command {
             'appPort',
             'storagePath',
             'appPublicPath',
+            'portalType',
+            'portalName',
+            'portalTemplate',
         ]);
     }
     static buildDbPresetValuesFromFlags(flags, argv = process.argv.slice(2)) {
@@ -1112,6 +1185,9 @@ export default class Install extends Command {
         const rootPassword = Install.toOptionalPromptString(config.rootPassword);
         const rootNickname = Install.toOptionalPromptString(config.rootNickname);
         const lang = Install.toOptionalPromptString(config.lang);
+        const portalType = Install.toOptionalPromptString(config.portalType);
+        const portalName = Install.toOptionalPromptString(config.portalName);
+        const portalTemplate = Install.toOptionalPromptString(config.portalTemplate);
         const auth = config.auth;
         const savedAuthType = Install.toOptionalPromptString(config.authType) ?? Install.toOptionalPromptString(auth?.type);
         const appPreset = {
@@ -1121,6 +1197,9 @@ export default class Install extends Command {
             ...(appPort ? { appPort } : {}),
             ...(storagePath ? { storagePath } : {}),
             ...(appPublicPath ? { appPublicPath } : {}),
+            ...(portalType ? { portalType } : {}),
+            ...(portalName ? { portalName } : {}),
+            ...(portalTemplate ? { portalTemplate } : {}),
             ...(hookScript ? { hookScript } : {}),
         };
         const downloadPreset = {
@@ -1263,6 +1342,12 @@ export default class Install extends Command {
                 warn: params.warnOnPortFallback ?? true,
             });
         }
+        if (params.flags['portal-template'] === undefined) {
+            const defaultPortalTemplate = Install.toOptionalPromptString(await getCliConfigValue('default-portal-template'));
+            if (defaultPortalTemplate) {
+                initialValues.portalTemplate = defaultPortalTemplate;
+            }
+        }
         return initialValues;
     }
     static shouldPublishBuiltinDbPortForValues(values) {
@@ -1430,14 +1515,17 @@ export default class Install extends Command {
     static buildDockerAppContainerName(envName, containerPrefix) {
         return Install.sanitizeDockerResourceName(`${Install.buildBuiltinDbContainerPrefix(containerPrefix)}-${envName}-app`);
     }
-    static buildInitAppEnvVars(params) {
+    static buildInitAppEnvVars(params, options = {}) {
         return buildInitAppEnvVarsFromConfig({
             lang: String(params.appResults.lang ?? ''),
             rootUsername: String(params.rootResults.rootUsername ?? ''),
             rootEmail: String(params.rootResults.rootEmail ?? ''),
             rootPassword: String(params.rootResults.rootPassword ?? ''),
             rootNickname: String(params.rootResults.rootNickname ?? ''),
-        });
+            portalType: String(params.appResults.portalType ?? ''),
+            portalName: String(params.appResults.portalName ?? ''),
+            portalTemplate: String(params.appResults.portalTemplate ?? ''),
+        }, options);
     }
     static shouldPublishBuiltinDbPort(source) {
         return String(source ?? '').trim() !== 'docker';
@@ -2309,6 +2397,9 @@ export default class Install extends Command {
         const appRootPath = Install.toOptionalPromptString(params.appResults.appRootPath);
         const storagePath = Install.toOptionalPromptString(params.appResults.storagePath);
         const appPublicPath = Install.toOptionalPromptString(params.appResults.appPublicPath);
+        const portalType = Install.toOptionalPromptString(params.appResults.portalType);
+        const portalName = Install.toOptionalPromptString(params.appResults.portalName);
+        const portalTemplate = Install.toOptionalPromptString(params.appResults.portalTemplate);
         const derivedAppRootPath = appPath ? deriveConfiguredSourcePath(appPath) : undefined;
         const derivedStoragePath = appPath ? deriveConfiguredStoragePath(appPath) : undefined;
         const appPort = String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT;
@@ -2343,6 +2434,9 @@ export default class Install extends Command {
             ...(appPublicPath ? { appPublicPath } : {}),
             ...(envFile ? { envFile } : {}),
             lang: params.appResults.lang,
+            portalType,
+            portalName,
+            portalTemplate,
             appKey: params.appResults.appKey,
             timezone: params.appResults.timeZone,
             builtinDb: params.dbResults.builtinDb,
@@ -2394,6 +2488,7 @@ export default class Install extends Command {
                     'app-root-path': parsed['app-root-path'] ?? Install.toOptionalPromptString(appPreset.appRootPath),
                     'app-port': parsed['app-port'] ?? Install.toOptionalPromptString(appPreset.appPort),
                     'storage-path': parsed['storage-path'] ?? Install.toOptionalPromptString(appPreset.storagePath),
+                    'portal-template': parsed['portal-template'] ?? Install.toOptionalPromptString(appPreset.portalTemplate),
                 },
             }),
             values: appPreset,

package/dist/commands/portal/config.js

@@ -0,0 +1,88 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Args, Command, Flags } from '@oclif/core';
+import { getCurrentEnvName, getEnv } from '../../lib/auth-store.js';
+import { resolveDefaultConfigScope } from '../../lib/cli-home.js';
+import { translateCli } from '../../lib/cli-locale.js';
+import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../lib/env-guard.js';
+import { configurePortalWorkspace } from '../../lib/portal-configure.js';
+import { printInfo, printSuccess } from '../../lib/ui.js';
+const portalConfigureText = (key, values, fallback) => translateCli(`commands.portalConfigure.${key}`, values, { fallback });
+export default class PortalConfig extends Command {
+    static summary = 'Update portal source configuration';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> customer --source-storage nocobase',
+        '<%= config.bin %> <%= command.id %> customer --source-storage git --git-repo git@github.com:nocobase/customer-portal.git',
+        '<%= config.bin %> <%= command.id %> customer --git-branch main --git-path portals/customer',
+    ];
+    static args = {
+        portal: Args.string({
+            required: true,
+            description: 'Portal name',
+        }),
+    };
+    static flags = {
+        env: Flags.string({
+            char: 'e',
+            description: 'CLI env name; omitted uses the current env',
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Confirm using --env when it targets a different env than the current env',
+            default: false,
+        }),
+        'source-storage': Flags.string({
+            description: 'Where portal source code is managed',
+            options: ['nocobase', 'git'],
+        }),
+        'git-repo': Flags.string({
+            description: 'Git repository URL used when --source-storage=git',
+        }),
+        'git-branch': Flags.string({
+            description: 'Git branch used when --source-storage=git',
+        }),
+        'git-path': Flags.string({
+            description: 'Directory inside the Git repository for this portal; defaults to the repository root',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PortalConfig);
+        const requestedEnv = hasExplicitEnvSelection(this.argv) ? flags.env : undefined;
+        const confirmed = await ensureCrossEnvConfirmed({
+            command: this,
+            requestedEnv,
+            yes: flags.yes,
+        });
+        if (!confirmed) {
+            return;
+        }
+        const scope = resolveDefaultConfigScope();
+        const envName = requestedEnv ?? (await getCurrentEnvName({ scope }));
+        const env = await getEnv(envName, { scope });
+        if (!env) {
+            this.error(portalConfigureText(requestedEnv ? 'errors.envNotConfigured' : 'errors.noEnvConfigured', { envName }, requestedEnv
+                ? `Env "${envName}" is not configured. Run \`nb env add ${envName} --api-base-url <url>\` first.`
+                : 'No NocoBase env is configured yet. Run `nb init --ui` to create one first.'));
+        }
+        const result = await configurePortalWorkspace({
+            portal: args.portal,
+            env,
+            envName,
+            cliVersion: String(this.config.pjson.version ?? '').trim(),
+            sourceStorage: flags['source-storage'],
+            gitRepo: flags['git-repo'],
+            gitBranch: flags['git-branch'],
+            gitPath: flags['git-path'],
+        });
+        printSuccess(portalConfigureText('messages.updated', { portal: result.portal, portalDir: result.portalDir }, `Portal "${result.portal}" configuration updated at ${result.portalDir}/portal.config.json.`));
+        printInfo(result.remoteSynced
+            ? portalConfigureText('messages.remoteSynced', undefined, 'Remote portal record: synced')
+            : portalConfigureText('messages.remoteSkipped', undefined, 'Remote portal record: not found; local config only'));
+    }
+}

package/dist/commands/portal/create.js

@@ -0,0 +1,104 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Args, Command, Flags } from '@oclif/core';
+import { getEnv } from '../../lib/auth-store.js';
+import { resolveDefaultConfigScope } from '../../lib/cli-home.js';
+import { translateCli } from '../../lib/cli-locale.js';
+import { ensureCrossEnvConfirmed, hasExplicitEnvSelection } from '../../lib/env-guard.js';
+import { createPortalWorkspace } from '../../lib/portal-create.js';
+import { printInfo, printSuccess } from '../../lib/ui.js';
+const DEFAULT_PORTAL_TEMPLATE = '@nocobase/portal-template-default';
+const portalCreateText = (key, values, fallback) => translateCli(`commands.portalCreate.${key}`, values, { fallback });
+export default class PortalCreate extends Command {
+    static summary = 'Create a local portal from a template';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> customer',
+        '<%= config.bin %> <%= command.id %> customer --template @nocobase/portal-template-default',
+        '<%= config.bin %> <%= command.id %> customer --env dev --yes',
+        '<%= config.bin %> <%= command.id %> customer --source-storage git --git-repo git@github.com:nocobase/customer-portal.git',
+    ];
+    static args = {
+        portal: Args.string({
+            required: true,
+            description: 'Portal name',
+        }),
+    };
+    static flags = {
+        template: Flags.string({
+            description: 'Template package, local path, or file:// URL',
+            default: DEFAULT_PORTAL_TEMPLATE,
+        }),
+        env: Flags.string({
+            char: 'e',
+            description: 'CLI env name; omitted uses the current env',
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Confirm using --env when it targets a different env than the current env',
+            default: false,
+        }),
+        title: Flags.string({
+            description: 'Portal display title; defaults to a title generated from the portal slug',
+        }),
+        force: Flags.boolean({
+            description: 'Delete the existing portal and recreate it',
+            default: false,
+        }),
+        'source-storage': Flags.string({
+            description: 'Where portal source code is managed',
+            options: ['nocobase', 'git'],
+            default: 'nocobase',
+        }),
+        'git-repo': Flags.string({
+            description: 'Git repository URL used when --source-storage=git',
+        }),
+        'git-branch': Flags.string({
+            description: 'Git branch used when --source-storage=git',
+        }),
+        'git-path': Flags.string({
+            description: 'Directory inside the Git repository for this portal; defaults to the repository root',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PortalCreate);
+        const requestedEnv = hasExplicitEnvSelection(this.argv) ? flags.env : undefined;
+        const confirmed = await ensureCrossEnvConfirmed({
+            command: this,
+            requestedEnv,
+            yes: flags.yes,
+        });
+        if (!confirmed) {
+            return;
+        }
+        const env = await getEnv(flags.env, { scope: resolveDefaultConfigScope() });
+        if (!env) {
+            this.error(flags.env
+                ? portalCreateText('errors.envNotConfigured', { envName: flags.env }, `Env "${flags.env}" is not configured. Run \`nb env add ${flags.env} --api-base-url <url>\` first.`)
+                : portalCreateText('errors.noEnvConfigured', undefined, 'No NocoBase env is configured yet. Run `nb init --ui` to create one first.'));
+        }
+        const result = await createPortalWorkspace({
+            portal: args.portal,
+            title: flags.title,
+            template: flags.template,
+            env,
+            envName: flags.env,
+            cliVersion: String(this.config.pjson.version ?? '').trim(),
+            force: flags.force,
+            sourceStorage: flags['source-storage'],
+            gitRepo: flags['git-repo'],
+            gitBranch: flags['git-branch'],
+            gitPath: flags['git-path'],
+            onSkipInstall: (message) => printInfo(message),
+        });
+        printSuccess(portalCreateText('messages.created', { portal: result.portal, portalDir: result.portalDir }, `Portal "${result.portal}" created at ${result.portalDir}.`));
+        printInfo(portalCreateText('messages.app', { app: result.app }, `App: ${result.app}`));
+        printInfo(portalCreateText('messages.base', { base: result.portalBase }, `Base: ${result.portalBase}`));
+        printInfo(portalCreateText('messages.sourceStorage', { sourceStorage: result.sourceStorage }, `Source storage: ${result.sourceStorage}`));
+    }
+}