@nocobase/cli 2.1.0-beta.44.test.3 → 2.1.0-beta.45

package/dist/commands/install.js

@@ -16,12 +16,12 @@ import { runPromptCatalog, } from "../lib/prompt-catalog.js";
 import { applyCliLocale, localeText, resolveCliLocale, translateCli } from "../lib/cli-locale.js";
 import { resolveConfiguredEnvPath, resolveDefaultConfigScope, resolveEnvRoot, resolveEnvRelativePath, } from '../lib/cli-home.js';
 import { defaultDockerContainerPrefix, defaultDockerNetworkName } from '../lib/app-runtime.js';
-import { resolveDockerContainerPrefix, resolveDockerNetworkName } from '../lib/cli-config.js';
+import { resolveDefaultApiHost, resolveDockerContainerPrefix, resolveDockerNetworkName } from '../lib/cli-config.js';
 import { DEFAULT_DOCKER_VERSION, resolveDockerImageRef } from "../lib/docker-image.js";
-import { findAvailableTcpPort, validateAvailableTcpPort, validateTcpPort, validateEnvKey, } from "../lib/prompt-validators.js";
+import { findAvailableTcpPort, validateAppPublicPath, validateAvailableTcpPort, validateTcpPort, validateEnvKey, } from "../lib/prompt-validators.js";
 import { validateExternalDbConfig, validateMysqlLowerCaseTableNamesCompatibility } from "../lib/db-connection-check.js";
 import { formatMissingManagedAppEnvMessage } from '../lib/app-runtime.js';
-import { commandOutput, commandSucceeds, run, runNocoBaseCommand } from '../lib/run-npm.js';
+import { commandOutput, commandSucceeds, ensureDockerDaemonRunning, run, runNocoBaseCommand } from '../lib/run-npm.js';
 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';
@@ -31,6 +31,7 @@ import { startDockerLogFollower } from '../lib/docker-log-stream.js';
 import { areConfiguredPathsEquivalent, deriveConfiguredSourcePath, deriveConfiguredStoragePath, inferConfiguredAppPathFromLegacyConfig, } from '../lib/env-paths.js';
 import Download, { defaultDockerRegistryForLang } from './download.js';
 import EnvAdd from "./env/add.js";
+import { resolveAppUrlFromApiBaseUrl } from "./env/shared.js";
 const DEFAULT_INSTALL_ENV_NAME = 'local';
 const DEFAULT_INSTALL_LANG = 'en-US';
 const DEFAULT_INSTALL_APP_PORT = '13000';
@@ -61,10 +62,19 @@ const DEFAULT_INSTALL_ROOT_USERNAME = 'nocobase';
 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';
 function toOptionalPromptString(value) {
     const text = String(value ?? '').trim();
     return text || undefined;
 }
+function buildInstallApiBaseUrl(appResults, defaultApiHost = DEFAULT_INSTALL_API_HOST) {
+    const appPort = String(appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT;
+    const appPublicPath = String(appResults.appPublicPath ?? '').trim();
+    return `http://${defaultApiHost}:${appPort}${appendAppPublicPath(appPublicPath, 'api', { trailingSlash: false })}`;
+}
+function formatInstallDisplayUrl(apiBaseUrl) {
+    return resolveAppUrlFromApiBaseUrl(apiBaseUrl) || apiBaseUrl.replace(/\/api\/?$/, '');
+}
 const APP_HEALTH_CHECK_INTERVAL_MS = 2_000;
 const APP_HEALTH_CHECK_TIMEOUT_MS = 600_000;
 const APP_HEALTH_CHECK_REQUEST_TIMEOUT_MS = 5_000;
@@ -268,6 +278,15 @@ function optionalEnvBoolean(value) {
     }
     return Boolean(value);
 }
+function resolveExtractClientAssetsDefaultEnabled(value) {
+    const text = String(value ?? '')
+        .trim()
+        .toLowerCase();
+    if (!text) {
+        return true;
+    }
+    return !['0', 'false', 'no', 'off'].includes(text);
+}
 function pushOptionalEnvArg(args, key, value) {
     if (typeof value === 'string') {
         if (!value) {
@@ -490,8 +509,11 @@ export default class Install extends Command {
             },
             appPublicPath: {
                 type: 'text',
-                message: '',
-                hidden: () => true,
+                message: installText('prompts.appPublicPath.message'),
+                placeholder: installText('prompts.appPublicPath.placeholder'),
+                initialValue: '/',
+                yesInitialValue: '/',
+                validate: validateAppPublicPath,
             },
         };
     }
@@ -1068,6 +1090,7 @@ export default class Install extends Command {
         const appPort = Install.toOptionalPromptString(config.appPort);
         const storagePath = Install.toOptionalPromptString(config.storagePath);
         const appPublicPath = Install.toOptionalPromptString(config.appPublicPath);
+        const apiBaseUrl = Install.toOptionalPromptString(config.apiBaseUrl);
         const downloadVersion = Install.toOptionalPromptString(config.downloadVersion);
         const dockerRegistry = Install.toOptionalPromptString(config.dockerRegistry);
         const dockerPlatform = Install.toOptionalPromptString(config.dockerPlatform);
@@ -1132,6 +1155,9 @@ export default class Install extends Command {
             ...(rootNickname ? { rootNickname } : {}),
         };
         const envAddPreset = {};
+        if (apiBaseUrl) {
+            envAddPreset.apiBaseUrl = apiBaseUrl;
+        }
         if (savedAuthType === 'token') {
             envAddPreset.authType = 'token';
             if (Install.toOptionalPromptString(auth.accessToken)) {
@@ -1613,6 +1639,7 @@ export default class Install extends Command {
         if (this.ensuredDockerNetworks.has(name)) {
             return;
         }
+        await ensureDockerDaemonRunning('prepare Docker resources for this environment');
         printVerbose(`Checking Docker network: ${name}`);
         const exists = await commandSucceeds('docker', ['network', 'inspect', name]);
         if (exists) {
@@ -1751,7 +1778,7 @@ export default class Install extends Command {
         const dbSchema = optionalEnvString(params.dbResults.dbSchema);
         const dbTablePrefix = optionalEnvString(params.dbResults.dbTablePrefix);
         const dbUnderscored = optionalEnvBoolean(params.dbResults.dbUnderscored);
-        const extractClientAssets = Install.toOptionalPromptString(process.env.NOCOBASE_EXTRACT_CLIENT_ASSETS);
+        const extractClientAssets = resolveExtractClientAssetsDefaultEnabled(process.env.NOCOBASE_EXTRACT_CLIENT_ASSETS);
         const appKey = Install.resolveManagedAppKey(params.appResults.appKey);
         const appPublicPath = Install.toOptionalPromptString(params.appResults.appPublicPath);
         const timeZone = Install.resolveManagedTimeZone(params.appResults.timeZone);
@@ -2059,10 +2086,8 @@ export default class Install extends Command {
         };
     }
     static resolveApiBaseUrl(params) {
-        const appPort = String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT;
-        const appPublicPath = String(params.appResults.appPublicPath ?? '').trim();
         return (String(params.envAddResults.apiBaseUrl ?? '').trim() ||
-            `http://127.0.0.1:${appPort}${appendAppPublicPath(appPublicPath, 'api', { trailingSlash: false })}`);
+            buildInstallApiBaseUrl(params.appResults, params.defaultApiHost));
     }
     static buildHealthCheckUrl(apiBaseUrl) {
         return `${apiBaseUrl.replace(/\/+$/, '')}/__health_check`;
@@ -2154,7 +2179,10 @@ export default class Install extends Command {
         }
     }
     async saveInstalledEnv(params) {
-        await upsertEnv(params.envName, Install.buildSavedEnvConfig(params), { scope: resolveDefaultConfigScope() });
+        const defaultApiHost = await resolveDefaultApiHost();
+        await upsertEnv(params.envName, Install.buildSavedEnvConfig(params, { defaultApiHost }), {
+            scope: resolveDefaultConfigScope(),
+        });
         await setCurrentEnv(params.envName, { scope: resolveDefaultConfigScope() });
     }
     async syncInstalledEnvConnection(params) {
@@ -2183,7 +2211,7 @@ export default class Install extends Command {
         }
         await this.config.runCommand('env:update', [params.envName]);
     }
-    static buildSavedEnvConfig(params) {
+    static buildSavedEnvConfig(params, options = {}) {
         const appPath = resolveConfiguredAppPathValue(params.appResults);
         const appRootPath = Install.toOptionalPromptString(params.appResults.appRootPath);
         const storagePath = Install.toOptionalPromptString(params.appResults.storagePath);
@@ -2195,6 +2223,7 @@ export default class Install extends Command {
         const apiBaseUrl = Install.resolveApiBaseUrl({
             appResults: params.appResults,
             envAddResults: params.envAddResults,
+            defaultApiHost: options.defaultApiHost,
         });
         const authType = String(params.envAddResults.authType ?? 'oauth').trim() || 'oauth';
         const authUsername = authType === 'basic' ? String(params.envAddResults.username ?? params.rootResults.rootUsername ?? '').trim() : '';
@@ -2239,6 +2268,7 @@ export default class Install extends Command {
     }
     async collectPromptResults(parsed, yes) {
         const commandArgv = this.argv ?? process.argv.slice(2);
+        const defaultApiHost = await resolveDefaultApiHost();
         const resumePreset = await this.resolveResumePresetValues(parsed, yes);
         const envPreset = {
             ...(resumePreset?.envPreset ?? {}),
@@ -2334,7 +2364,7 @@ export default class Install extends Command {
         };
         const resolvedEnvAddAuthType = String(envAddPreset.authType ?? '').trim();
         const envAddInitialValues = {
-            apiBaseUrl: `http://127.0.0.1:${appResults.appPort ?? DEFAULT_INSTALL_APP_PORT}${appendAppPublicPath(String(appResults.appPublicPath ?? ''), 'api', { trailingSlash: false })}`,
+            apiBaseUrl: buildInstallApiBaseUrl(appResults, defaultApiHost),
             ...envAddResumePreset,
             ...(!parsed['skip-auth'] && resolvedEnvAddAuthType === 'basic'
                 ? {
@@ -2381,6 +2411,7 @@ export default class Install extends Command {
         const parsed = {
             ...flags,
         };
+        const defaultApiHost = await resolveDefaultApiHost();
         if (parsed['skip-auth'] && (parsed['access-token'] !== undefined || parsed.token !== undefined)) {
             this.error('--skip-auth cannot be used with --access-token or --token.');
         }
@@ -2518,11 +2549,17 @@ export default class Install extends Command {
             await this.waitForAppHealthCheck(Install.resolveApiBaseUrl({
                 appResults,
                 envAddResults,
+                defaultApiHost,
             }), {
                 containerName: dockerAppPlan?.containerName,
                 verbose: parsed.verbose,
             });
-            printInfo(`NocoBase is ready at http://127.0.0.1:${dockerAppPlan?.appPort ?? localAppPlan?.appPort}`);
+            const displayApiBaseUrl = Install.resolveApiBaseUrl({
+                appResults,
+                envAddResults,
+                defaultApiHost,
+            });
+            printInfo(`NocoBase is ready at ${formatInstallDisplayUrl(displayApiBaseUrl)}`);
         }
         if (dockerAppPlan || localAppPlan || builtinDbPlan) {
             await this.saveInstalledEnv({

package/dist/commands/source/test.js

@@ -14,7 +14,7 @@ import Install from '../install.js';
 import { defaultWorkspaceName } from '../../lib/app-runtime.js';
 import { resolveCliLocale } from '../../lib/cli-locale.js';
 import { findAvailableTcpPort, validateAvailableTcpPort } from '../../lib/prompt-validators.js';
-import { commandSucceeds, resolveProjectCwd, run, runNocoBaseCommand } from '../../lib/run-npm.js';
+import { commandSucceeds, ensureDockerDaemonRunning, resolveProjectCwd, run, runNocoBaseCommand, } from '../../lib/run-npm.js';
 import { failTask, printInfo, setVerboseMode, startTask, succeedTask } from '../../lib/ui.js';
 const DEFAULT_DB_HOST = '127.0.0.1';
 const DEFAULT_DB_DATABASE = 'nocobase-test';
@@ -48,11 +48,11 @@ const DEFAULT_DB_PORTS = {
 };
 const TCP_PORT_READY_SCRIPT = [
     "const net = require('node:net');",
-    "const port = Number(process.argv.at(-1));",
+    'const port = Number(process.argv.at(-1));',
     "const socket = net.createConnection({ host: '127.0.0.1', port });",
     "socket.once('connect', () => { socket.end(); process.exit(0); });",
     "socket.once('error', () => process.exit(1));",
-    "setTimeout(() => { socket.destroy(); process.exit(1); }, 200).unref();",
+    'setTimeout(() => { socket.destroy(); process.exit(1); }, 200).unref();',
 ].join('\n');
 function inferTestEnv(paths) {
     const first = String(paths[0] ?? '').trim();
@@ -60,9 +60,7 @@ function inferTestEnv(paths) {
         return undefined;
     }
     const normalized = first.split('\\').join('/');
-    if (normalized.includes('/client/')
-        || normalized.includes('/client-v2/')
-        || normalized.includes('/flow-engine/')) {
+    if (normalized.includes('/client/') || normalized.includes('/client-v2/') || normalized.includes('/flow-engine/')) {
         return 'client-side';
     }
     return 'server-side';
@@ -77,9 +75,7 @@ function defaultTestDbPort(dbDialect) {
     return String(DEFAULT_DB_PORTS[dbDialect] ?? DEFAULT_DB_PORTS.postgres);
 }
 function defaultTestDbImage(dbDialect) {
-    const defaults = resolveCliLocale(process.env.NB_LOCALE) === 'zh-CN'
-        ? DEFAULT_TEST_DB_IMAGES_ZH_CN
-        : DEFAULT_TEST_DB_IMAGES;
+    const defaults = resolveCliLocale(process.env.NB_LOCALE) === 'zh-CN' ? DEFAULT_TEST_DB_IMAGES_ZH_CN : DEFAULT_TEST_DB_IMAGES;
     return defaults[dbDialect] ?? defaults.postgres;
 }
 function delay(ms) {
@@ -174,9 +170,11 @@ async function startTestDbDistributor(params) {
         if (code === 0) {
             return;
         }
-        childError = childError ?? new Error(signal
-            ? `test DB distributor exited due to signal ${signal}`
-            : `test DB distributor exited with code ${code ?? 'unknown'}`);
+        childError =
+            childError ??
+                new Error(signal
+                    ? `test DB distributor exited due to signal ${signal}`
+                    : `test DB distributor exited with code ${code ?? 'unknown'}`);
     });
     try {
         await waitForTcpPortReady(port);
@@ -194,6 +192,7 @@ async function startTestDbDistributor(params) {
     };
 }
 async function ensureDockerNetwork(networkName, options) {
+    await ensureDockerDaemonRunning('prepare Docker resources for the built-in test database');
     if (await commandSucceeds('docker', ['network', 'inspect', networkName])) {
         return;
     }
@@ -440,8 +439,8 @@ export default class SourceTest extends Command {
                 server: flags.server,
                 client: flags.client,
                 paths: args.paths ?? [],
-            })
-                && supportsTestDbDistributor(testDbConfig.env.DB_DIALECT)) {
+            }) &&
+                supportsTestDbDistributor(testDbConfig.env.DB_DIALECT)) {
                 testDbDistributor = await startTestDbDistributor({
                     cwd,
                     env: testDbConfig.env,

package/dist/lib/app-managed-resources.js

@@ -13,13 +13,14 @@ import { deriveBuiltinDbConnection, resolveBuiltinDbConnection } from './builtin
 import { resolveConfiguredStoragePath } from './env-paths.js';
 import { resolveDockerEnvFileArg } from "./docker-env-file.js";
 import { DEFAULT_DOCKER_REGISTRY, DEFAULT_DOCKER_VERSION, resolveDockerImageRef, } from "./docker-image.js";
-import { commandSucceeds, run } from './run-npm.js';
+import { commandSucceeds, ensureDockerDaemonRunning, run } from './run-npm.js';
 import Install from '../commands/install.js';
 const DOCKER_APP_STORAGE_DESTINATION = '/app/nocobase/storage';
 function commandStdio(verbose) {
     return verbose ? 'inherit' : 'ignore';
 }
 async function ensureDockerNetwork(networkName) {
+    await ensureDockerDaemonRunning('prepare Docker resources for this environment');
     if (await commandSucceeds('docker', ['network', 'inspect', networkName])) {
         return;
     }
@@ -45,6 +46,16 @@ function pushOptionalEnvArg(args, key, value) {
         args.push('-e', `${key}=${String(value)}`);
     }
 }
+function resolveDockerClientAssetsExtractEnabled(envValue) {
+    const text = trimValue(envValue).toLowerCase();
+    if (!text) {
+        return true;
+    }
+    if (['0', 'false', 'no', 'off'].includes(text)) {
+        return false;
+    }
+    return true;
+}
 function normalizeDockerPlatform(value) {
     const text = trimValue(value);
     if (!text || text === 'auto') {
@@ -123,7 +134,7 @@ export async function buildSavedDockerRunArgs(runtime) {
     const dbSchema = trimValue(config.dbSchema);
     const dbTablePrefix = trimValue(config.dbTablePrefix);
     const dbUnderscored = typeof config.dbUnderscored === 'boolean' ? config.dbUnderscored : undefined;
-    const extractClientAssets = trimValue(process.env.NOCOBASE_EXTRACT_CLIENT_ASSETS);
+    const extractClientAssets = resolveDockerClientAssetsExtractEnabled(process.env.NOCOBASE_EXTRACT_CLIENT_ASSETS);
     const dockerRegistry = trimValue(config.dockerRegistry) || DEFAULT_DOCKER_REGISTRY;
     const version = trimValue(config.downloadVersion) || DEFAULT_DOCKER_VERSION;
     const imageRef = resolveDockerImageRef(dockerRegistry, version, {
@@ -184,7 +195,7 @@ export async function buildSavedDockerRunArgs(runtime) {
     pushOptionalEnvArg(args, 'DB_SCHEMA', dbSchema || undefined);
     pushOptionalEnvArg(args, 'DB_TABLE_PREFIX', dbTablePrefix || undefined);
     pushOptionalEnvArg(args, 'DB_UNDERSCORED', dbUnderscored);
-    pushOptionalEnvArg(args, 'NOCOBASE_EXTRACT_CLIENT_ASSETS', extractClientAssets || undefined);
+    pushOptionalEnvArg(args, 'NOCOBASE_EXTRACT_CLIENT_ASSETS', extractClientAssets);
     args.push(imageRef);
     return {
         appPort: appPort || undefined,

package/dist/lib/auth-store.js

@@ -89,11 +89,25 @@ function normalizeEnvConfigEntry(entry) {
 function normalizeAuthConfig(config) {
     const settings = config.settings ?? {};
     const locale = normalizeOptionalCliLocale(settings.locale);
+    const defaultUiHost = normalizeOptionalString(settings.init?.defaultUiHost);
+    const defaultApiHost = normalizeOptionalString(settings.init?.defaultApiHost);
     const updatePolicy = normalizeOptionalCliUpdatePolicy(settings.update?.policy);
+    const logRetentionDays = typeof settings.log?.retentionDays === 'number' && Number.isInteger(settings.log.retentionDays)
+        ? settings.log.retentionDays
+        : undefined;
+    const logEnabled = typeof settings.log?.enabled === 'boolean' ? settings.log.enabled : undefined;
     return {
         name: config.name || config.dockerResourcePrefix,
         settings: {
             ...(locale ? { locale } : {}),
+            ...(defaultUiHost || defaultApiHost
+                ? {
+                    init: {
+                        ...(defaultUiHost ? { defaultUiHost } : {}),
+                        ...(defaultApiHost ? { defaultApiHost } : {}),
+                    },
+                }
+                : {}),
             ...(updatePolicy ? { update: { policy: updatePolicy } } : {}),
             ...(settings.license?.pkgUrl ? { license: { pkgUrl: normalizeOptionalString(settings.license.pkgUrl) } } : {}),
             ...(settings.docker?.network || settings.docker?.containerPrefix
@@ -131,6 +145,14 @@ function normalizeAuthConfig(config) {
                     },
                 }
                 : {}),
+            ...(logEnabled !== undefined || logRetentionDays !== undefined
+                ? {
+                    log: {
+                        ...(logEnabled !== undefined ? { enabled: logEnabled } : {}),
+                        ...(logRetentionDays !== undefined ? { retentionDays: logRetentionDays } : {}),
+                    },
+                }
+                : {}),
         },
         lastEnv: config.lastEnv ||
             config.currentEnv ||

package/dist/lib/cli-config.js

@@ -20,10 +20,14 @@ export const PROXY_PROVIDER_OPTIONS = ['nginx', 'caddy'];
 export const DEFAULT_PROXY_PROVIDER = 'nginx';
 export const DEFAULT_PROXY_HOST = '127.0.0.1';
 export const DEFAULT_YARN_BIN = 'yarn';
+export const DEFAULT_LOG_RETENTION_DAYS = 14;
+export const DEFAULT_LOG_ENABLED = true;
 export const CLI_UPDATE_POLICY_OPTIONS = ['prompt', 'auto', 'off'];
 export const DEFAULT_UPDATE_POLICY = 'prompt';
 export const SUPPORTED_CLI_CONFIG_KEYS = [
     'locale',
+    'default-ui-host',
+    'default-api-host',
     'update.policy',
     'license.pkg-url',
     'docker.network',
@@ -35,6 +39,8 @@ export const SUPPORTED_CLI_CONFIG_KEYS = [
     'proxy.nb-cli-root',
     'proxy.upstream-host',
     'bin.yarn',
+    'log.enabled',
+    'log.retention-days',
 ];
 function trimValue(value) {
     const text = String(value ?? '').trim();
@@ -71,17 +77,23 @@ export function normalizeProxyProvider(value) {
 function cloneSettings(config) {
     return {
         ...(config.settings?.locale ? { locale: trimValue(config.settings.locale) } : {}),
+        init: config.settings?.init ? { ...config.settings.init } : undefined,
         update: config.settings?.update ? { ...config.settings.update } : undefined,
         license: config.settings?.license ? { ...config.settings.license } : undefined,
         docker: config.settings?.docker ? { ...config.settings.docker } : undefined,
         bin: config.settings?.bin ? { ...config.settings.bin } : undefined,
         proxy: config.settings?.proxy ? { ...config.settings.proxy } : undefined,
+        log: config.settings?.log ? { ...config.settings.log } : undefined,
     };
 }
 function pruneSettings(config) {
     if (config.settings && !trimValue(config.settings.locale)) {
         delete config.settings.locale;
     }
+    const init = config.settings?.init;
+    if (init && !trimValue(init.defaultUiHost) && !trimValue(init.defaultApiHost)) {
+        delete config.settings?.init;
+    }
     const update = config.settings?.update;
     if (update && !normalizeCliUpdatePolicy(update.policy)) {
         delete config.settings?.update;
@@ -107,13 +119,19 @@ function pruneSettings(config) {
     if (proxy && !trimValue(proxy.nbCliRoot) && !trimValue(proxy.upstreamHost)) {
         delete config.settings?.proxy;
     }
+    const log = config.settings?.log;
+    if (log && typeof log.enabled !== 'boolean' && (!Number.isInteger(log.retentionDays) || log.retentionDays < 0)) {
+        delete config.settings?.log;
+    }
     if (config.settings &&
         !config.settings.locale &&
+        !config.settings.init &&
         !config.settings.update &&
         !config.settings.license &&
         !config.settings.docker &&
         !config.settings.bin &&
-        !config.settings.proxy) {
+        !config.settings.proxy &&
+        !config.settings.log) {
         delete config.settings;
     }
 }
@@ -121,6 +139,10 @@ export function getExplicitCliConfigValue(config, key) {
     switch (key) {
         case 'locale':
             return trimValue(config.settings?.locale);
+        case 'default-ui-host':
+            return trimValue(config.settings?.init?.defaultUiHost);
+        case 'default-api-host':
+            return trimValue(config.settings?.init?.defaultApiHost);
         case 'update.policy':
             return normalizeCliUpdatePolicy(config.settings?.update?.policy);
         case 'license.pkg-url':
@@ -143,6 +165,12 @@ export function getExplicitCliConfigValue(config, key) {
             return trimValue(config.settings?.proxy?.upstreamHost);
         case 'bin.yarn':
             return trimValue(config.settings?.bin?.yarn);
+        case 'log.enabled':
+            return typeof config.settings?.log?.enabled === 'boolean' ? String(config.settings?.log?.enabled) : undefined;
+        case 'log.retention-days':
+            return Number.isInteger(config.settings?.log?.retentionDays)
+                ? String(config.settings?.log?.retentionDays)
+                : undefined;
     }
 }
 export function getEffectiveCliConfigValue(config, key) {
@@ -153,6 +181,10 @@ export function getEffectiveCliConfigValue(config, key) {
     switch (key) {
         case 'locale':
             return resolveCliLocale(undefined, { configuredLocale: trimValue(config.settings?.locale) });
+        case 'default-ui-host':
+            return '127.0.0.1';
+        case 'default-api-host':
+            return '127.0.0.1';
         case 'update.policy':
             return explicit ?? DEFAULT_UPDATE_POLICY;
         case 'license.pkg-url':
@@ -175,6 +207,10 @@ export function getEffectiveCliConfigValue(config, key) {
             return explicit ?? DEFAULT_PROXY_HOST;
         case 'bin.yarn':
             return DEFAULT_YARN_BIN;
+        case 'log.enabled':
+            return explicit ?? String(DEFAULT_LOG_ENABLED);
+        case 'log.retention-days':
+            return explicit ?? String(DEFAULT_LOG_RETENTION_DAYS);
     }
 }
 export function normalizeCliConfigValue(key, value) {
@@ -199,6 +235,19 @@ export function normalizeCliConfigValue(key, value) {
         }
         return policy;
     }
+    if (key === 'log.retention-days') {
+        const retentionDays = Number.parseInt(normalized, 10);
+        if (!Number.isInteger(retentionDays) || retentionDays < 0) {
+            throw new Error(`Config key "${key}" must be a non-negative integer.`);
+        }
+        return String(retentionDays);
+    }
+    if (key === 'log.enabled') {
+        if (normalized !== 'true' && normalized !== 'false') {
+            throw new Error(`Config key "${key}" must be either "true" or "false".`);
+        }
+        return normalized;
+    }
     return normalized;
 }
 export async function loadCliConfig(options = {}) {
@@ -228,6 +277,18 @@ export async function setCliConfigValue(key, value, options = {}) {
         case 'locale':
             config.settings.locale = normalized;
             break;
+        case 'default-ui-host':
+            config.settings.init = {
+                ...(config.settings.init ?? {}),
+                defaultUiHost: normalized,
+            };
+            break;
+        case 'default-api-host':
+            config.settings.init = {
+                ...(config.settings.init ?? {}),
+                defaultApiHost: normalized,
+            };
+            break;
         case 'update.policy':
             config.settings.update = {
                 ...(config.settings.update ?? {}),
@@ -294,6 +355,18 @@ export async function setCliConfigValue(key, value, options = {}) {
                 yarn: normalized,
             };
             break;
+        case 'log.enabled':
+            config.settings.log = {
+                ...(config.settings.log ?? {}),
+                enabled: normalized === 'true',
+            };
+            break;
+        case 'log.retention-days':
+            config.settings.log = {
+                ...(config.settings.log ?? {}),
+                retentionDays: Number.parseInt(normalized, 10),
+            };
+            break;
     }
     pruneSettings(config);
     await saveAuthConfig(config, scope);
@@ -311,6 +384,16 @@ export async function deleteCliConfigValue(key, options = {}) {
         case 'locale':
             delete config.settings.locale;
             break;
+        case 'default-ui-host':
+            if (config.settings.init) {
+                delete config.settings.init.defaultUiHost;
+            }
+            break;
+        case 'default-api-host':
+            if (config.settings.init) {
+                delete config.settings.init.defaultApiHost;
+            }
+            break;
         case 'update.policy':
             if (config.settings.update) {
                 delete config.settings.update.policy;
@@ -366,6 +449,16 @@ export async function deleteCliConfigValue(key, options = {}) {
                 delete config.settings.bin.yarn;
             }
             break;
+        case 'log.enabled':
+            if (config.settings.log) {
+                delete config.settings.log.enabled;
+            }
+            break;
+        case 'log.retention-days':
+            if (config.settings.log) {
+                delete config.settings.log.retentionDays;
+            }
+            break;
     }
     pruneSettings(config);
     await saveAuthConfig(config, scope);
@@ -374,6 +467,12 @@ export async function deleteCliConfigValue(key, options = {}) {
 export async function resolveDockerNetworkName(options = {}) {
     return await getCliConfigValue('docker.network', options);
 }
+export async function resolveDefaultUiHost(options = {}) {
+    return await getCliConfigValue('default-ui-host', options);
+}
+export async function resolveDefaultApiHost(options = {}) {
+    return await getCliConfigValue('default-api-host', options);
+}
 export async function resolveDockerContainerPrefix(options = {}) {
     return await getCliConfigValue('docker.container-prefix', options);
 }

package/dist/lib/cli-entry-error.js

@@ -42,3 +42,11 @@ export function formatCliEntryError(error, argv) {
         `If \`${attemptedCommand}\` should be a runtime command from your NocoBase app, check whether the connected app exposes it, then retry the command.`,
     ].join('\n');
 }
+export function appendDiagnosticLogPath(message, logFile) {
+    const normalizedMessage = String(message ?? '').trim();
+    const normalizedLogFile = String(logFile ?? '').trim();
+    if (!normalizedLogFile) {
+        return normalizedMessage;
+    }
+    return [normalizedMessage, `Diagnostic log: ${normalizedLogFile}`].filter(Boolean).join('\n\n');
+}