@nocobase/cli 3.0.0-alpha.1 → 3.0.0-alpha.11

package/dist/commands/api/resource/create.js

@@ -1,10 +1,19 @@
+/**
+ * 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 { Command } from '@oclif/core';
 import { buildCreateArgs, createFlags, runResourceCommand } from '../../../lib/resource-command.js';
 export default class ResourceCreate extends Command {
-    static summary = 'Create a record in a resource';
-    static description = 'Create a record in a generic resource. Pass record content through --values as a JSON object.';
+    static summary = 'Create one or more records in a resource';
+    static description = 'Create records in a generic resource. Pass record content through --values as a JSON object, or as a JSON array of objects to create multiple records in a single request.';
     static examples = [
         `<%= config.bin %> <%= command.id %> --resource users --values '{"nickname":"Ada"}'`,
+        `<%= config.bin %> <%= command.id %> --resource users --values '[{"nickname":"Ada"},{"nickname":"Grace"}]'`,
         `<%= config.bin %> <%= command.id %> --resource posts.comments --source-id 1 --values '{"content":"Hello"}'`,
     ];
     static flags = createFlags;

package/dist/commands/api/swagger/get.js

@@ -0,0 +1,96 @@
+/**
+ * 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 { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { Command, Flags } from '@oclif/core';
+import { translateCli } from '../../../lib/cli-locale.js';
+import { executeSwaggerRequest, swaggerRequestFlags } from '../../../lib/swagger-command.js';
+import { renderTable } from '../../../lib/ui.js';
+const swaggerText = (key, values, fallback) => translateCli(`commands.swagger.${key}`, values, { fallback });
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function unwrapData(value) {
+    if (!isRecord(value) || typeof value.openapi === 'string') {
+        return value;
+    }
+    return Object.prototype.hasOwnProperty.call(value, 'data') ? value.data : value;
+}
+function normalizeDocument(value) {
+    const document = unwrapData(value);
+    if (!isRecord(document) ||
+        typeof document.openapi !== 'string' ||
+        !isRecord(document.info) ||
+        !isRecord(document.paths)) {
+        return undefined;
+    }
+    return document;
+}
+export default class SwaggerGet extends Command {
+    static summary = 'Get a NocoBase OpenAPI document';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --json',
+        '<%= config.bin %> <%= command.id %> --namespace collections/orders --json',
+        '<%= config.bin %> <%= command.id %> --namespace plugins/ai --output ./openapi/ai.json',
+    ];
+    static flags = {
+        ...swaggerRequestFlags,
+        namespace: Flags.string({
+            aliases: ['ns'],
+            description: 'Document namespace, such as core, plugins/ai, or collections/orders',
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'Write the OpenAPI document to a file',
+        }),
+        'json-output': Flags.boolean({
+            char: 'j',
+            aliases: ['json'],
+            description: 'Print the complete OpenAPI document as JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SwaggerGet);
+        const namespace = flags.namespace?.trim() || undefined;
+        const response = await executeSwaggerRequest(this, flags, '/swagger:get', { ns: namespace });
+        if (!response) {
+            return;
+        }
+        if (!response.ok) {
+            const details = JSON.stringify(response.data, null, 2);
+            this.error(response.status === 404
+                ? swaggerText('errors.pluginDisabled', undefined, 'The API documentation plugin is not enabled. Enable it before requesting Swagger documents.')
+                : swaggerText('errors.requestFailed', { status: response.status, details }, `Swagger request failed with status ${response.status}\n${details}`));
+        }
+        const document = normalizeDocument(response.data);
+        if (!document) {
+            this.error(swaggerText('errors.invalidDocument', undefined, 'swagger:get returned an invalid OpenAPI document.'));
+        }
+        const json = `${JSON.stringify(document, null, 2)}\n`;
+        if (flags.output) {
+            const outputPath = path.resolve(flags.output);
+            await fs.mkdir(path.dirname(outputPath), { recursive: true });
+            await fs.writeFile(outputPath, json);
+            this.log(swaggerText('messages.saved', { output: outputPath }, `Saved Swagger document to ${outputPath}.`));
+            return;
+        }
+        if (flags['json-output']) {
+            this.log(json.trimEnd());
+            return;
+        }
+        this.log(renderTable([swaggerText('table.field', undefined, 'Field'), swaggerText('table.value', undefined, 'Value')], [
+            [swaggerText('fields.namespace', undefined, 'Namespace'), namespace ?? 'all'],
+            [swaggerText('fields.title', undefined, 'Title'), document.info.title ?? ''],
+            [swaggerText('fields.version', undefined, 'Version'), document.info.version ?? ''],
+            [swaggerText('fields.openapi', undefined, 'OpenAPI'), document.openapi],
+            [swaggerText('fields.paths', undefined, 'Paths'), String(Object.keys(document.paths).length)],
+        ]));
+    }
+}

package/dist/commands/api/swagger/index.js

@@ -0,0 +1,20 @@
+/**
+ * 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 { Command, loadHelpClass } from '@oclif/core';
+export default class Swagger extends Command {
+    static summary = 'Inspect the current NocoBase OpenAPI documentation';
+    async run() {
+        await this.parse(Swagger);
+        const Help = await loadHelpClass(this.config);
+        await new Help(this.config, this.config.pjson.oclif.helpOptions ?? this.config.pjson.helpOptions).showHelp([
+            this.id ?? 'api:swagger',
+            ...this.argv,
+        ]);
+    }
+}

package/dist/commands/api/swagger/list.js

@@ -0,0 +1,92 @@
+/**
+ * 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 { Command, Flags } from '@oclif/core';
+import { translateCli } from '../../../lib/cli-locale.js';
+import { executeSwaggerRequest, swaggerRequestFlags } from '../../../lib/swagger-command.js';
+import { renderTable } from '../../../lib/ui.js';
+const swaggerText = (key, values, fallback) => translateCli(`commands.swagger.${key}`, values, { fallback });
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function unwrapData(value) {
+    return isRecord(value) && Object.prototype.hasOwnProperty.call(value, 'data') ? value.data : value;
+}
+function readNamespace(url) {
+    try {
+        return new URL(url, 'http://localhost').searchParams.get('ns') || 'all';
+    }
+    catch {
+        return 'all';
+    }
+}
+function normalizeDestinations(value) {
+    const data = unwrapData(value);
+    if (!Array.isArray(data)) {
+        return undefined;
+    }
+    const destinations = [];
+    for (const item of data) {
+        if (!isRecord(item) || typeof item.name !== 'string' || typeof item.url !== 'string') {
+            return undefined;
+        }
+        destinations.push({
+            name: item.name,
+            namespace: readNamespace(item.url),
+            url: item.url,
+        });
+    }
+    return destinations;
+}
+export default class SwaggerList extends Command {
+    static summary = 'List available NocoBase OpenAPI document namespaces';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --json',
+        '<%= config.bin %> <%= command.id %> --env dev --yes --json',
+    ];
+    static flags = {
+        ...swaggerRequestFlags,
+        'json-output': Flags.boolean({
+            char: 'j',
+            aliases: ['json'],
+            description: 'Print namespaces as JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SwaggerList);
+        const response = await executeSwaggerRequest(this, flags, '/swagger:getUrls');
+        if (!response) {
+            return;
+        }
+        if (!response.ok) {
+            const details = JSON.stringify(response.data, null, 2);
+            this.error(response.status === 404
+                ? swaggerText('errors.pluginDisabled', undefined, 'The API documentation plugin is not enabled. Enable it before requesting Swagger documents.')
+                : swaggerText('errors.requestFailed', { status: response.status, details }, `Swagger request failed with status ${response.status}\n${details}`));
+        }
+        const destinations = normalizeDestinations(response.data);
+        if (!destinations) {
+            this.error(swaggerText('errors.invalidDestinations', undefined, 'swagger:getUrls returned an invalid destination list.'));
+        }
+        if (flags['json-output']) {
+            this.log(JSON.stringify(destinations, null, 2));
+            return;
+        }
+        if (!destinations.length) {
+            this.log(swaggerText('messages.empty', undefined, 'No Swagger document namespaces are available.'));
+            return;
+        }
+        this.log(renderTable([
+            swaggerText('table.name', undefined, 'Name'),
+            swaggerText('table.namespace', undefined, 'Namespace'),
+            swaggerText('table.url', undefined, 'URL'),
+        ], destinations.map((item) => [item.name, item.namespace, item.url])));
+    }
+}

package/dist/commands/env/add.js

@@ -11,6 +11,7 @@ import { setCurrentEnv, upsertEnv } from '../../lib/auth-store.js';
 import { resolveDefaultConfigScope } from '../../lib/cli-home.js';
 import { ENV_BOOLEAN_CONFIG_FLAG_MAP, ENV_STRING_CONFIG_FLAG_MAP } from '../../lib/env-command-config.js';
 import { buildStoredEnvConfig } from '../../lib/env-config.js';
+import { PUBLIC_APP_CLIENT_ENTRY_MODES } from '../../lib/app-client-entry-mode.js';
 import { runPromptCatalog, } from '../../lib/prompt-catalog.js';
 import { applyCliLocale, CLI_LOCALE_FLAG_DESCRIPTION, CLI_LOCALE_FLAG_OPTIONS, localeText, } from '../../lib/cli-locale.js';
 import { validateApiBaseUrl } from '../../lib/prompt-validators.js';
@@ -172,6 +173,11 @@ export default class EnvAdd extends Command {
             hidden: true,
             description: 'Docker env file saved with this env',
         }),
+        'app-client-entry-mode': Flags.string({
+            hidden: true,
+            description: 'UI entry mode saved with this env',
+            options: [...PUBLIC_APP_CLIENT_ENTRY_MODES],
+        }),
         'app-port': Flags.string({
             hidden: true,
             description: 'Application HTTP port saved with this env',

package/dist/commands/env/update.js

@@ -16,6 +16,8 @@ import { appendDiagnosticLogPath } from '../../lib/cli-entry-error.js';
 import { getActiveCommandLogFile } from '../../lib/command-log.js';
 import { ENV_BOOLEAN_CONFIG_FLAG_MAP, ENV_STRING_CONFIG_FLAG_MAP } from '../../lib/env-command-config.js';
 import { buildStoredEnvConfig } from '../../lib/env-config.js';
+import { PUBLIC_APP_CLIENT_ENTRY_MODES } from '../../lib/app-client-entry-mode.js';
+import { upsertManagedEnvFileValues } from '../../lib/managed-env-file.js';
 import { validateApiBaseUrl } from '../../lib/prompt-validators.js';
 import { failTask, printInfo, printVerbose, printWarningBlock, setVerboseMode, startTask, stopTask, succeedTask, } from '../../lib/ui.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -35,6 +37,7 @@ const UPDATE_STRING_FLAGS = [
     'app-public-path',
     'cdn-base-url',
     'env-file',
+    'app-client-entry-mode',
     'app-port',
     'app-key',
     'timezone',
@@ -68,6 +71,7 @@ const APP_RESTART_FIELDS = new Set([
     'storage-path',
     'app-public-path',
     'env-file',
+    'app-client-entry-mode',
     'app-port',
     'app-key',
     'timezone',
@@ -255,6 +259,10 @@ export default class EnvUpdate extends Command {
             hidden: true,
             description: 'Saved Docker --env-file path for this env',
         }),
+        'app-client-entry-mode': Flags.string({
+            description: 'Saved UI entry mode for this env',
+            options: [...PUBLIC_APP_CLIENT_ENTRY_MODES],
+        }),
         'app-port': Flags.string({
             description: 'Saved application HTTP port for this env',
         }),
@@ -423,6 +431,11 @@ export default class EnvUpdate extends Command {
         startTask(`Saving env config: ${envName}`);
         try {
             await replaceEnvConfig(envName, nextConfig, { scope: resolveDefaultConfigScope() });
+            if (providedFields.has('app-client-entry-mode') && nextConfig.appClientEntryMode) {
+                await upsertManagedEnvFileValues(envName, nextConfig, {
+                    APP_CLIENT_ENTRY_MODE: nextConfig.appClientEntryMode,
+                });
+            }
             succeedTask(`Saved env config for "${envName}".`);
         }
         catch (error) {

package/dist/commands/init.js

@@ -13,6 +13,7 @@ import { existsSync } from 'node:fs';
 import path from 'node:path';
 import { stdin as stdinStream, stdout as stdoutStream } from 'node:process';
 import { getEnv, upsertEnv } from "../lib/auth-store.js";
+import { defaultAppClientEntryModeForDownloadVersion, normalizePublicAppClientEntryMode, PUBLIC_APP_CLIENT_ENTRY_MODES, } from '../lib/app-client-entry-mode.js';
 import { runPromptCatalog, } from "../lib/prompt-catalog.js";
 import { applyCliLocale, localeText, translateCli } from "../lib/cli-locale.js";
 import { resolveConfiguredEnvPath, resolveDefaultConfigScope, resolveEnvRelativePath } from '../lib/cli-home.js';
@@ -106,9 +107,23 @@ function resolveInitDownloadVersion(results) {
     }
     return preset;
 }
+function resolveInitAppClientEntryMode(results, explicitValue) {
+    return (normalizePublicAppClientEntryMode(explicitValue) ??
+        normalizePublicAppClientEntryMode(results.appClientEntryMode) ??
+        defaultAppClientEntryModeForDownloadVersion(resolveInitDownloadVersion(results)));
+}
 function initVersionPromptValue(version) {
     return version === 'latest' || version === 'beta' || version === 'alpha' ? version : 'other';
 }
+export function defaultInitDownloadVersionForCliVersion(cliVersion) {
+    if (/-alpha(?:[.-]|$)/i.test(cliVersion)) {
+        return 'alpha';
+    }
+    if (/-beta(?:[.-]|$)/i.test(cliVersion)) {
+        return 'beta';
+    }
+    return 'latest';
+}
 function yesInitialValue(def, fallback) {
     if ('yesInitialValue' in def && def.yesInitialValue !== undefined) {
         return String(def.yesInitialValue);
@@ -409,8 +424,15 @@ Prompt modes:
         installAccessToken: installConnectionAccessTokenPrompt,
     };
     buildPromptCatalog(flags, options) {
+        const downloadVersion = defaultInitDownloadVersionForCliVersion(String(this.config.pjson?.version ?? '').trim());
+        const versionPrompt = Init.prompts.version;
         const prompts = {
             ...Init.prompts,
+            version: {
+                ...versionPrompt,
+                initialValue: downloadVersion,
+                yesInitialValue: downloadVersion,
+            },
             installApiBaseUrl: createInstallConnectionApiBaseUrlPrompt(options.defaultApiHost),
         };
         if (flags['skip-auth']) {
@@ -474,6 +496,10 @@ Prompt modes:
             description: 'Skip installing NocoBase AI coding skills during init',
             default: false,
         }),
+        'app-client-entry-mode': Flags.string({
+            description: 'UI entry mode for this app env: modern-only, modern-default, or legacy-default',
+            options: [...PUBLIC_APP_CLIENT_ENTRY_MODES],
+        }),
         'ui-host': Flags.string({
             description: 'Browser-accessible host for the --ui setup page URL (default: 127.0.0.1)',
         }),
@@ -874,6 +900,9 @@ Prompt modes:
         if (flags['app-public-path'] !== undefined && String(flags['app-public-path']).trim() !== '') {
             preset.appPublicPath = String(flags['app-public-path']).trim();
         }
+        if (flags['app-client-entry-mode'] !== undefined && String(flags['app-client-entry-mode']).trim() !== '') {
+            preset.appClientEntryMode = String(flags['app-client-entry-mode']).trim();
+        }
         if (flags['root-username'] !== undefined) {
             preset.rootUsername = String(flags['root-username'] ?? '').trim();
         }
@@ -1011,6 +1040,7 @@ Prompt modes:
         const existingEnv = await getEnv(envName, { scope: resolveDefaultConfigScope() });
         const appPort = String(results.appPort ?? '').trim();
         const appPublicPath = String(results.appPublicPath ?? '').trim();
+        const appClientEntryMode = resolveInitAppClientEntryMode(results, flags['app-client-entry-mode']);
         const source = String(results.source ?? '').trim();
         const version = resolveInitDownloadVersion(results);
         const dockerRegistry = String(results.dockerRegistry ?? '').trim();
@@ -1084,6 +1114,7 @@ Prompt modes:
             ...(storagePath && !areConfiguredPathsEquivalent(storagePath, derivedStoragePath) ? { storagePath } : {}),
             ...(appPort ? { appPort } : {}),
             ...(appPublicPath ? { appPublicPath } : {}),
+            ...(appClientEntryMode ? { appClientEntryMode } : {}),
             ...(appKey ? { appKey } : {}),
             ...(timeZone ? { timezone: timeZone } : {}),
             ...(!skipDownload && results.devDependencies !== undefined
@@ -1212,6 +1243,13 @@ Prompt modes:
         if (appPublicPath) {
             argv.push('--app-public-path', appPublicPath);
         }
+        const appClientEntryMode = normalizePublicAppClientEntryMode(flags['app-client-entry-mode']) ||
+            (results.setupMode === 'install-new' && results.hasNocobase === undefined
+                ? resolveInitAppClientEntryMode(results)
+                : undefined);
+        if (appClientEntryMode) {
+            argv.push('--app-client-entry-mode', appClientEntryMode);
+        }
         if (flags.force) {
             argv.push('--force');
         }

package/dist/commands/install.js

@@ -25,6 +25,7 @@ import { commandOutput, commandSucceeds, ensureDockerDaemonRunning, run, runNoco
 import { printInfo, printStage, printVerbose, printWarning, setVerboseMode } from '../lib/ui.js';
 import { omitKeys, upperFirst } from "../lib/object-utils.js";
 import { clearEnvRootSetup, getEnv, setCurrentEnv, upsertEnv } from '../lib/auth-store.js';
+import { defaultAppClientEntryModeForDownloadVersion, normalizePublicAppClientEntryMode, PUBLIC_APP_CLIENT_ENTRY_MODES, } from '../lib/app-client-entry-mode.js';
 import { buildStoredEnvConfig } from '../lib/env-config.js';
 import { resolveDockerEnvFileArg } from "../lib/docker-env-file.js";
 import { startDockerLogFollower } from '../lib/docker-log-stream.js';
@@ -54,10 +55,7 @@ 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 = 'ai';
-const DEFAULT_INSTALL_PORTAL_NAME = 'main';
 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;
@@ -185,9 +183,6 @@ 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';
@@ -412,15 +407,12 @@ 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',
+        'app-client-entry-mode': Flags.string({
+            description: 'UI entry mode for this app env: modern-only, modern-default, or legacy-default',
+            options: [...PUBLIC_APP_CLIENT_ENTRY_MODES],
         }),
         'portal-template': Flags.string({
-            description: 'Initial portal template npm package or local path when --portal-type ai is used',
+            description: 'Template npm package or local path for the default AI Portal "main"',
         }),
         'root-username': Flags.string({
             description: 'Initial admin username for the installed app',
@@ -531,39 +523,12 @@ 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,
+                initialValue: DEFAULT_INSTALL_PORTAL_TEMPLATE,
                 yesInitialValue: DEFAULT_INSTALL_PORTAL_TEMPLATE,
-                hidden: (values) => !isAiMode(values),
                 required: true,
             },
         };
@@ -825,16 +790,10 @@ 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 (flags['app-client-entry-mode'] !== undefined) {
+            const v = normalizePublicAppClientEntryMode(flags['app-client-entry-mode']);
             if (v) {
-                preset.portalName = v;
+                preset.appClientEntryMode = v;
             }
         }
         if (flags['portal-template'] !== undefined) {
@@ -934,8 +893,7 @@ export default class Install extends Command {
             'appPort',
             'storagePath',
             'appPublicPath',
-            'portalType',
-            'portalName',
+            'appClientEntryMode',
             'portalTemplate',
         ]);
     }
@@ -1186,8 +1144,6 @@ 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);
@@ -1198,8 +1154,6 @@ export default class Install extends Command {
             ...(appPort ? { appPort } : {}),
             ...(storagePath ? { storagePath } : {}),
             ...(appPublicPath ? { appPublicPath } : {}),
-            ...(portalType ? { portalType } : {}),
-            ...(portalName ? { portalName } : {}),
             ...(portalTemplate ? { portalTemplate } : {}),
             ...(hookScript ? { hookScript } : {}),
         };
@@ -1523,8 +1477,6 @@ export default class Install extends Command {
             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);
     }
@@ -1874,6 +1826,7 @@ export default class Install extends Command {
         const extractClientAssets = resolveExtractClientAssetsDefaultEnabled(process.env.NOCOBASE_EXTRACT_CLIENT_ASSETS);
         const appKey = Install.resolveManagedAppKey(params.appResults.appKey);
         const appPublicPath = Install.toOptionalPromptString(params.appResults.appPublicPath);
+        const appClientEntryMode = Install.toOptionalPromptString(params.appResults.appClientEntryMode);
         const timeZone = Install.resolveManagedTimeZone(params.appResults.timeZone);
         const containerName = Install.buildDockerAppContainerName(params.envName, params.dockerContainerPrefix ?? params.workspaceName);
         const configuredEnvFile = String(params.appResults.envFile ?? '').trim();
@@ -1901,6 +1854,7 @@ export default class Install extends Command {
         }
         args.push('-e', `APP_KEY=${appKey}`, '-e', `DB_DIALECT=${dbDialect}`, '-e', `DB_HOST=${dbHost}`, '-e', `DB_PORT=${dbPort}`, '-e', `DB_DATABASE=${dbDatabase}`, '-e', `DB_USER=${dbUser}`, '-e', `DB_PASSWORD=${dbPassword}`, '-e', `TZ=${timeZone}`, '-v', `${storagePath}:/app/nocobase/storage`);
         pushOptionalEnvArg(args, 'APP_PUBLIC_PATH', appPublicPath);
+        pushOptionalEnvArg(args, 'APP_CLIENT_ENTRY_MODE', appClientEntryMode);
         pushOptionalEnvArg(args, 'DB_SCHEMA', dbSchema);
         pushOptionalEnvArg(args, 'DB_TABLE_PREFIX', dbTablePrefix);
         pushOptionalEnvArg(args, 'DB_UNDERSCORED', dbUnderscored);
@@ -2161,6 +2115,7 @@ export default class Install extends Command {
             }),
         };
         setOptionalEnvVar(env, 'APP_PUBLIC_PATH', Install.toOptionalPromptString(params.appResults.appPublicPath));
+        setOptionalEnvVar(env, 'APP_CLIENT_ENTRY_MODE', Install.toOptionalPromptString(params.appResults.appClientEntryMode));
         setOptionalEnvVar(env, 'DB_SCHEMA', optionalEnvString(params.dbResults.dbSchema));
         setOptionalEnvVar(env, 'DB_TABLE_PREFIX', optionalEnvString(params.dbResults.dbTablePrefix));
         setOptionalEnvVar(env, 'DB_UNDERSCORED', optionalEnvBoolean(params.dbResults.dbUnderscored));
@@ -2402,8 +2357,7 @@ 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 appClientEntryMode = Install.toOptionalPromptString(params.appResults.appClientEntryMode);
         const portalTemplate = Install.toOptionalPromptString(params.appResults.portalTemplate);
         const derivedAppRootPath = appPath ? deriveConfiguredSourcePath(appPath) : undefined;
         const derivedStoragePath = appPath ? deriveConfiguredStoragePath(appPath) : undefined;
@@ -2437,10 +2391,9 @@ export default class Install extends Command {
             appPort,
             ...(storagePath && !areConfiguredPathsEquivalent(storagePath, derivedStoragePath) ? { storagePath } : {}),
             ...(appPublicPath ? { appPublicPath } : {}),
+            ...(appClientEntryMode ? { appClientEntryMode } : {}),
             ...(envFile ? { envFile } : {}),
             lang: params.appResults.lang,
-            portalType,
-            portalName,
             portalTemplate,
             appKey: params.appResults.appKey,
             timezone: params.appResults.timeZone,
@@ -2512,6 +2465,9 @@ export default class Install extends Command {
         };
         downloadOpts.yes = yes;
         const downloadResults = await runPromptCatalog(Download.prompts, downloadOpts);
+        appResults.appClientEntryMode =
+            normalizePublicAppClientEntryMode(appResults.appClientEntryMode) ??
+                defaultAppClientEntryModeForDownloadVersion(downloadResultsValue(downloadResults, 'version'));
         if (parsed['skip-download']) {
             delete downloadResults.outputDir;
             delete downloadResults.replace;

package/dist/commands/portal/config.js

@@ -7,7 +7,7 @@
  * 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 { getCurrentEnvName, getEnv, setEnvPortalPath } 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';
@@ -17,6 +17,7 @@ const portalConfigureText = (key, values, fallback) => translateCli(`commands.po
 export default class PortalConfig extends Command {
     static summary = 'Update portal source configuration';
     static examples = [
+        '<%= config.bin %> <%= command.id %> customer --path ./portals/customer',
         '<%= 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',
@@ -41,6 +42,9 @@ export default class PortalConfig extends Command {
             description: 'Where portal source code is managed',
             options: ['nocobase', 'git'],
         }),
+        path: Flags.string({
+            description: 'Portal development workspace directory',
+        }),
         'git-repo': Flags.string({
             description: 'Git repository URL used when --source-storage=git',
         }),
@@ -79,10 +83,17 @@ export default class PortalConfig extends Command {
             gitRepo: flags['git-repo'],
             gitBranch: flags['git-branch'],
             gitPath: flags['git-path'],
+            sourcePath: flags.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'));
+        if (flags.path) {
+            await setEnvPortalPath(envName, result.portal, result.portalDir, { scope });
+        }
+        printSuccess(portalConfigureText('messages.updated', { portal: result.portal }, `Portal "${result.portal}" configuration updated.`));
+        if (result.pathUpdated) {
+            printInfo(portalConfigureText('messages.pathUpdated', { portalDir: result.portalDir }, `Development path: ${result.portalDir}`));
+        }
+        if (result.config) {
+            printInfo(portalConfigureText('messages.remoteSynced', undefined, 'Remote portal record: synced'));
+        }
     }
 }