@nocobase/cli 2.1.0-alpha.26 → 2.1.0-alpha.28

package/dist/lib/run-npm.js

@@ -15,6 +15,8 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+import os from 'node:os';
 import path from 'node:path';
 import spawn from 'cross-spawn';
 const FORWARDED_SIGNALS = ['SIGINT', 'SIGTERM'];
@@ -178,6 +180,57 @@ export function commandOutput(name, args, options) {
         });
     });
 }
+async function readCommandOutputFile(filePath) {
+    try {
+        return await fsp.readFile(filePath, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+export async function commandOutputViaFile(name, args, options) {
+    const cwd = resolveCwd(options?.cwd);
+    const label = options?.errorName ?? name;
+    const command = resolveCommandName(name);
+    const captureDir = await fsp.mkdtemp(path.join(os.tmpdir(), 'nocobase-cli-output-'));
+    const stdoutPath = path.join(captureDir, 'stdout.log');
+    const stderrPath = path.join(captureDir, 'stderr.log');
+    const stdoutHandle = await fsp.open(stdoutPath, 'w');
+    const stderrHandle = await fsp.open(stderrPath, 'w');
+    try {
+        const result = await new Promise((resolve, reject) => {
+            const child = spawn(command, [...args], {
+                cwd,
+                env: {
+                    ...process.env,
+                    ...options?.env,
+                },
+                stdio: ['ignore', stdoutHandle.fd, stderrHandle.fd],
+                windowsHide: process.platform === 'win32',
+            });
+            child.once('error', reject);
+            child.once('close', (code, signal) => {
+                resolve({ code, signal });
+            });
+        });
+        await stdoutHandle.close();
+        await stderrHandle.close();
+        const stdout = await readCommandOutputFile(stdoutPath);
+        const stderr = await readCommandOutputFile(stderrPath);
+        if (result.code === 0) {
+            return stdout.trim();
+        }
+        if (result.signal) {
+            throw new Error(`${label} exited due to signal ${result.signal}`);
+        }
+        const details = stderr.trim() || stdout.trim();
+        throw new Error(details ? `${label} exited with code ${result.code}: ${details}` : `${label} exited with code ${result.code}`);
+    }
+    finally {
+        await Promise.allSettled([stdoutHandle.close(), stderrHandle.close()]);
+        await fsp.rm(captureDir, { recursive: true, force: true });
+    }
+}
 /** Run `yarn` with the given argument list, inheriting stdio (errors label as `npm` for compatibility). */
 export function runNpm(args, options) {
     return run('yarn', [...args], { ...options, errorName: 'npm' });

package/dist/lib/runtime-env-vars.js

@@ -0,0 +1,32 @@
+/**
+ * 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 { resolveBuiltinDbConnection } from './builtin-db.js';
+function put(out, key, value) {
+    if (value === undefined || value === null) {
+        return;
+    }
+    out[key] = String(value);
+}
+export async function buildRuntimeEnvVars(runtime) {
+    const config = runtime.env.config ?? {};
+    const out = {
+        ...runtime.env.envVars,
+    };
+    if (runtime.kind !== 'local' && runtime.kind !== 'docker') {
+        return out;
+    }
+    if (!config.builtinDb) {
+        return out;
+    }
+    const connection = await resolveBuiltinDbConnection(runtime);
+    put(out, 'DB_DIALECT', connection.dbDialect);
+    put(out, 'DB_HOST', connection.dbHost);
+    put(out, 'DB_PORT', connection.dbPort);
+    return out;
+}

package/dist/lib/runtime-generator.js

@@ -1,3 +1,11 @@
+/**
+ * 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.
+ */
 /**
  * This file is part of the NocoBase (R) project.
  * Copyright (c) 2020-2024 NocoBase Co., Ltd.
@@ -60,12 +68,59 @@ function toGeneratedParameter(parameter, usedFlagNames) {
         required: parameter.required,
         description: parameter.description,
         type: inferParameterType(parameter.schema),
+        format: parameter.schema?.format,
         isArray: parameter.schema?.type === 'array',
+        isFile: parameter.schema?.type === 'string' && parameter.schema?.format === 'binary',
     };
 }
 function getJsonRequestSchema(requestBody) {
     return requestBody?.content?.['application/json']?.schema;
 }
+function getMultipartRequestSchema(requestBody) {
+    return requestBody?.content?.['multipart/form-data']?.schema;
+}
+function getRequestContentType(requestBody) {
+    if (!requestBody || '$ref' in requestBody) {
+        return undefined;
+    }
+    if (requestBody.content?.['multipart/form-data']) {
+        return 'multipart/form-data';
+    }
+    if (requestBody.content?.['application/json']) {
+        return 'application/json';
+    }
+    return undefined;
+}
+function getRequestSchema(requestBody) {
+    return getMultipartRequestSchema(requestBody) ?? getJsonRequestSchema(requestBody);
+}
+function isBinarySchema(schema) {
+    if (!schema || typeof schema !== 'object') {
+        return false;
+    }
+    if (schema.type === 'string' && schema.format === 'binary') {
+        return true;
+    }
+    return [...(schema.oneOf ?? []), ...(schema.anyOf ?? []), ...(schema.allOf ?? [])].some(isBinarySchema);
+}
+function getResponseType(operation) {
+    for (const response of Object.values(operation.responses ?? {})) {
+        const content = response?.content ?? {};
+        const mediaTypes = Object.keys(content);
+        const hasJson = mediaTypes.some((mediaType) => mediaType.includes('json'));
+        if (hasJson) {
+            return 'json';
+        }
+        const hasBinary = mediaTypes.some((mediaType) => {
+            const schema = content[mediaType]?.schema;
+            return mediaType === 'application/octet-stream' || mediaType.includes('zip') || isBinarySchema(schema);
+        });
+        if (hasBinary) {
+            return 'binary';
+        }
+    }
+    return undefined;
+}
 function normalizeCompositeSchema(schema) {
     if (!schema || typeof schema !== 'object') {
         return schema;
@@ -139,7 +194,7 @@ function describeSchemaShape(schema, options = {}) {
     return type;
 }
 function extractBodyParameters(requestBody, usedFlagNames) {
-    const schema = getJsonRequestSchema(requestBody);
+    const schema = getRequestSchema(requestBody);
     const properties = normalizeCompositeSchema(schema)?.properties;
     const required = new Set(normalizeCompositeSchema(schema)?.required ?? []);
     return Object.entries(properties ?? {}).map(([name, propertySchema]) => ({
@@ -149,7 +204,9 @@ function extractBodyParameters(requestBody, usedFlagNames) {
         required: required.has(name),
         description: propertySchema.description,
         type: inferParameterType(propertySchema),
+        format: propertySchema.format,
         isArray: propertySchema.type === 'array',
+        isFile: propertySchema.type === 'string' && propertySchema.format === 'binary',
         jsonEncoded: propertySchema.type === 'object' || propertySchema.type === 'array',
         jsonShape: describeSchemaShape(propertySchema),
     }));
@@ -179,6 +236,9 @@ function formatFlagExample(parameter) {
     if (parameter.type === 'boolean') {
         return `--${parameter.flagName}`;
     }
+    if (parameter.isFile) {
+        return `--${parameter.flagName} <path>`;
+    }
     if (parameter.type === 'object' || parameter.jsonEncoded) {
         if (parameter.type === 'array' || parameter.isArray) {
             return `--${parameter.flagName} '[]'`;
@@ -216,12 +276,13 @@ export function buildExamples(commandId, operation) {
     const requiredParameters = operation.parameters.filter((parameter) => parameter.required);
     const requiredFlags = requiredParameters.map(formatFlagExample);
     const requiredNonBodyFlags = requiredParameters.filter((parameter) => parameter.in !== 'body').map(formatFlagExample);
-    const examples = [`nb api ${commandId}${requiredFlags.length ? ` ${requiredFlags.join(' ')}` : ''}`];
+    const outputFlag = operation.responseType === 'binary' ? ' --output <path>' : '';
+    const examples = [`nb api ${commandId}${requiredFlags.length ? ` ${requiredFlags.join(' ')}` : ''}${outputFlag}`];
     const firstOptional = operation.parameters.find((parameter) => !parameter.required);
     if (firstOptional) {
-        examples.push(`${examples[0]} ${formatFlagExample(firstOptional)}`);
+        examples.push(`${examples[0]} ${formatFlagExample(firstOptional)}`.trim());
     }
-    if (operation.hasBody) {
+    if (operation.hasBody && operation.requestContentType !== 'multipart/form-data') {
         const prefix = `nb api ${commandId}${requiredNonBodyFlags.length ? ` ${requiredNonBodyFlags.join(' ')}` : ''}`;
         examples.push(`${prefix} --body '${buildSampleBody(operation.parameters)}'`);
     }
@@ -248,9 +309,17 @@ function buildDescription(operation) {
     }
     if (operation.hasBody) {
         const bodyFlags = operation.parameters.filter((parameter) => parameter.in === 'body').map((parameter) => `--${parameter.flagName}`);
-        sections.push(bodyFlags.length
-            ? `Request body: use body field flags (${bodyFlags.join(', ')}) or pass raw JSON via \`--body\` / \`--body-file\`.`
-            : 'Request body: JSON via `--body` or `--body-file`.');
+        if (operation.requestContentType === 'multipart/form-data') {
+            sections.push(bodyFlags.length ? `Request body: multipart form fields (${bodyFlags.join(', ')}).` : 'Request body: multipart form data.');
+        }
+        else {
+            sections.push(bodyFlags.length
+                ? `Request body: use body field flags (${bodyFlags.join(', ')}) or pass raw JSON via \`--body\` / \`--body-file\`.`
+                : 'Request body: JSON via `--body` or `--body-file`.');
+        }
+    }
+    if (operation.responseType === 'binary') {
+        sections.push('Response body: binary download written to `--output`.');
     }
     return sections.join('\n\n');
 }
@@ -357,6 +426,8 @@ export async function generateRuntime(document, configFile, baseUrl) {
         const bodyParameters = extractBodyParameters(operation.requestBody, usedFlagNames);
         const allParameters = [...parameters, ...bodyParameters];
         const hasBody = Boolean(operation.requestBody && !('$ref' in operation.requestBody));
+        const requestContentType = getRequestContentType(operation.requestBody);
+        const responseType = getResponseType(operation);
         const moduleDisplayName = moduleConfig.name ?? moduleKey;
         const moduleDescription = moduleConfig.description;
         const resourceDisplayName = resourceConfig?.name ?? resourceKey;
@@ -366,9 +437,11 @@ export async function generateRuntime(document, configFile, baseUrl) {
             description: operation.description,
         });
         const resourceSegments = toResourceSegments(pathTemplate);
-        const mappedResourceSegments = resourceSegments.length && resourceConfig?.name
-            ? [toKebabCase(resourceConfig.name), ...resourceSegments.slice(1)]
-            : resourceSegments;
+        const mappedResourceSegments = resourceSegments.length && resourceConfig?.segments?.length
+            ? [...resourceConfig.segments.map(toKebabCase), ...resourceSegments.slice(1)]
+            : resourceSegments.length && resourceConfig?.name
+                ? [toKebabCase(resourceConfig.name), ...resourceSegments.slice(1)]
+                : resourceSegments;
         const segments = [
             ...(resourceConfig?.topLevel ? [] : [toKebabCase(moduleDisplayName)]),
             ...mappedResourceSegments,
@@ -397,15 +470,21 @@ export async function generateRuntime(document, configFile, baseUrl) {
                 tags: operation.tags,
                 description: operationText.description,
                 hasBody,
+                requestContentType,
+                responseType,
                 parameters: allParameters,
             }),
             examples: buildExamples(segments.join(' '), {
                 parameters: allParameters,
                 hasBody,
+                requestContentType,
+                responseType,
             }),
             parameters: allParameters,
             hasBody,
             bodyRequired: operation.requestBody && !('$ref' in operation.requestBody) ? operation.requestBody.required : undefined,
+            requestContentType,
+            responseType,
         });
     }
     const schemaHash = createHash('sha1').update(JSON.stringify(document)).digest('hex').slice(0, 8);

package/dist/lib/self-manager.js

@@ -7,11 +7,14 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import fs from 'node:fs';
+import fsp from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { resolveCliHomeDir } from './cli-home.js';
 import { commandOutput, run } from './run-npm.js';
 const DEFAULT_PACKAGE_NAME = '@nocobase/cli';
 const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
+const INSTALL_METHOD_CACHE_FILE = 'self-install-methods.json';
 function normalizePath(value) {
     return path.resolve(value);
 }
@@ -115,6 +118,38 @@ function detectInstallMethod(packageRoot, globalPrefix) {
     }
     return 'unknown';
 }
+function getInstallMethodCacheFile() {
+    return path.join(resolveCliHomeDir('global'), INSTALL_METHOD_CACHE_FILE);
+}
+function getInstallMethodCacheKey(packageRoot) {
+    return normalizePath(path.join(packageRoot, 'bin', 'run.js'));
+}
+async function readInstallMethodCache() {
+    try {
+        const raw = await fsp.readFile(getInstallMethodCacheFile(), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+async function writeInstallMethodCache(state) {
+    const filePath = getInstallMethodCacheFile();
+    await fsp.mkdir(path.dirname(filePath), { recursive: true });
+    await fsp.writeFile(filePath, JSON.stringify(state, null, 2));
+}
+async function readCachedInstallMethod(packageRoot) {
+    const state = await readInstallMethodCache();
+    return state.entries?.[getInstallMethodCacheKey(packageRoot)];
+}
+async function writeCachedInstallMethod(packageRoot, entry) {
+    const state = await readInstallMethodCache();
+    const entries = {
+        ...(state.entries ?? {}),
+        [getInstallMethodCacheKey(packageRoot)]: entry,
+    };
+    await writeInstallMethodCache({ entries });
+}
 async function readGlobalPrefix(commandOutputFn) {
     try {
         return (await commandOutputFn('npm', ['prefix', '-g'], {
@@ -177,14 +212,34 @@ export function formatSelfUpdateUnavailableMessage(status) {
 export function getSelfUpdatePackageSpec(status) {
     return `${status.packageName}@${status.channel}`;
 }
+export async function inspectSelfInstall(options = {}) {
+    const packageRoot = options.packageRoot ? normalizePath(options.packageRoot) : PACKAGE_ROOT;
+    const commandOutputFn = options.commandOutputFn ?? commandOutput;
+    const cachedInstallMethod = await readCachedInstallMethod(packageRoot);
+    const globalPrefix = cachedInstallMethod?.globalPrefix ?? await readGlobalPrefix(commandOutputFn);
+    const installMethod = cachedInstallMethod?.installMethod ?? detectInstallMethod(packageRoot, globalPrefix);
+    if (!cachedInstallMethod) {
+        await writeCachedInstallMethod(packageRoot, {
+            installMethod,
+            globalPrefix,
+        });
+    }
+    return {
+        packageRoot,
+        installMethod,
+        globalPrefix,
+    };
+}
 export async function inspectSelfStatus(options = {}) {
     const packageRoot = options.packageRoot ? normalizePath(options.packageRoot) : PACKAGE_ROOT;
     const packageName = options.packageName ?? DEFAULT_PACKAGE_NAME;
     const currentVersion = options.currentVersion ?? readCurrentVersion(packageRoot);
     const channel = options.channel && options.channel !== 'auto' ? options.channel : detectChannel(currentVersion);
     const commandOutputFn = options.commandOutputFn ?? commandOutput;
-    const globalPrefix = await readGlobalPrefix(commandOutputFn);
-    const installMethod = detectInstallMethod(packageRoot, globalPrefix);
+    const { installMethod, globalPrefix } = await inspectSelfInstall({
+        packageRoot,
+        commandOutputFn,
+    });
     let latestVersion;
     let registryError;
     try {

package/dist/lib/skills-manager.js

@@ -10,7 +10,7 @@ import fsp from 'node:fs/promises';
 import path from 'node:path';
 import { resolveCliHomeDir } from './cli-home.js';
 import { compareVersions } from './self-manager.js';
-import { commandOutput, run } from './run-npm.js';
+import { commandOutput, commandOutputViaFile, run } from './run-npm.js';
 export const NOCOBASE_SKILLS_SOURCE = 'nocobase/skills';
 export const NOCOBASE_SKILLS_PACKAGE_NAME = '@nocobase/skills';
 const NOCOBASE_SKILLS_NAME_PREFIX = 'nocobase-';
@@ -57,7 +57,7 @@ async function writeManagedSkillsState(workspaceRoot, state) {
 export async function listGlobalSkills(options = {}) {
     const globalRoot = resolveSkillsRoot(options);
     await ensureSkillsWorkspaceRoot(globalRoot);
-    const output = await (options.commandOutputFn ?? commandOutput)('npx', ['-y', 'skills', 'list', '-g', '--json'], {
+    const output = await (options.commandOutputFn ?? commandOutputViaFile)('npx', ['-y', 'skills', 'list', '-g', '--json'], {
         cwd: globalRoot,
         errorName: 'skills list',
     });

package/dist/lib/startup-update.js

@@ -8,8 +8,9 @@
  */
 import fs from 'node:fs/promises';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import * as p from '@clack/prompts';
-import { inspectSelfStatus, } from './self-manager.js';
+import { inspectSelfInstall, inspectSelfStatus, } from './self-manager.js';
 import { inspectSkillsStatus } from './skills-manager.js';
 import { resolveCliHomeDir } from './cli-home.js';
 import { isInteractiveTerminal, printWarning } from './ui.js';
@@ -19,8 +20,37 @@ const NB_SKIP_STARTUP_UPDATE_ENV = 'NB_SKIP_STARTUP_UPDATE';
 function getStateFile() {
     return path.join(resolveCliHomeDir('global'), STARTUP_UPDATE_STATE_FILE);
 }
+function getCurrentInstallBinPath() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'bin', 'run.js');
+}
+function getCurrentInstallEntry(state) {
+    return state.entries?.[getCurrentInstallBinPath()];
+}
 function todayStamp(now = new Date()) {
-    return now.toISOString().slice(0, 10);
+    const timeZone = String(process.env.TZ ?? '').trim();
+    if (timeZone) {
+        try {
+            const parts = new Intl.DateTimeFormat('en-CA', {
+                timeZone,
+                year: 'numeric',
+                month: '2-digit',
+                day: '2-digit',
+            }).formatToParts(now);
+            const year = parts.find((part) => part.type === 'year')?.value;
+            const month = parts.find((part) => part.type === 'month')?.value;
+            const day = parts.find((part) => part.type === 'day')?.value;
+            if (year && month && day) {
+                return `${year}-${month}-${day}`;
+            }
+        }
+        catch {
+            // Fall back to the host local timezone.
+        }
+    }
+    const year = now.getFullYear();
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const day = String(now.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
 }
 function shouldSkipByArgv(argv) {
     const tokens = argv.filter((token) => token && !token.startsWith('-'));
@@ -46,8 +76,46 @@ async function writeState(state) {
     await fs.mkdir(path.dirname(filePath), { recursive: true });
     await fs.writeFile(filePath, JSON.stringify(state, null, 2));
 }
+function readCurrentInstallLastCheckedDate(state) {
+    return getCurrentInstallEntry(state)?.lastCheckedDate ?? state.lastCheckedDate;
+}
+async function writeCurrentInstallEntry(updater) {
+    const state = await readState();
+    const installBinPath = getCurrentInstallBinPath();
+    const nextEntry = updater(getCurrentInstallEntry(state), state);
+    await writeState({
+        ...state,
+        entries: {
+            ...(state.entries ?? {}),
+            [installBinPath]: nextEntry,
+        },
+    });
+}
 async function markChecked(now = new Date()) {
-    await writeState({ lastCheckedDate: todayStamp(now) });
+    await writeCurrentInstallEntry((current, state) => {
+        return {
+            policy: current?.policy ?? 'daily',
+            lastCheckedDate: todayStamp(now),
+        };
+    });
+}
+async function disableStartupUpdateForCurrentInstall() {
+    await writeCurrentInstallEntry((current, state) => {
+        return {
+            policy: 'disabled',
+            lastCheckedDate: current?.lastCheckedDate
+                ?? state.lastCheckedDate,
+        };
+    });
+}
+async function enableDailyStartupUpdateForCurrentInstall() {
+    await writeCurrentInstallEntry((current, state) => {
+        return {
+            policy: 'daily',
+            lastCheckedDate: current?.lastCheckedDate
+                ?? state.lastCheckedDate,
+        };
+    });
 }
 export async function shouldRunStartupUpdateCheck(argv, now = new Date()) {
     if (process.env[NB_SKIP_STARTUP_UPDATE_ENV] === '1') {
@@ -57,7 +125,20 @@ export async function shouldRunStartupUpdateCheck(argv, now = new Date()) {
         return false;
     }
     const state = await readState();
-    return state.lastCheckedDate !== todayStamp(now);
+    const currentEntry = getCurrentInstallEntry(state);
+    if (currentEntry?.policy === 'disabled') {
+        return false;
+    }
+    if (currentEntry?.policy === 'daily') {
+        return readCurrentInstallLastCheckedDate(state) !== todayStamp(now);
+    }
+    const selfInstall = await inspectSelfInstall();
+    if (!shouldEnableStartupUpdateForInstallMethod(selfInstall.installMethod)) {
+        await disableStartupUpdateForCurrentInstall();
+        return false;
+    }
+    await enableDailyStartupUpdateForCurrentInstall();
+    return readCurrentInstallLastCheckedDate(state) !== todayStamp(now);
 }
 export function shouldEnableStartupUpdateForInstallMethod(installMethod) {
     return installMethod === 'npm-global';
@@ -173,9 +254,6 @@ export async function maybeRunStartupUpdatePrompt(argv) {
         return { kind: 'skipped' };
     }
     const selfStatus = await inspectSelfStatus();
-    if (!shouldEnableStartupUpdateForInstallMethod(selfStatus.installMethod)) {
-        return { kind: 'skipped' };
-    }
     const skillsStatus = await inspectSkillsStatus();
     if (!hasPendingUpdates(selfStatus, skillsStatus)) {
         await markChecked();

package/dist/locale/en-US.json

@@ -62,6 +62,13 @@
       "allocateNotDockerPublished": "Failed to allocate an available TCP port that is not already published by Docker.",
       "alreadyInUse": "Port {{port}} is already in use. Choose another port.",
       "alreadyInUseByDocker": "Port {{port}} is already in use by a Docker container. Choose another port."
+    },
+    "dbConnection": {
+      "unreachable": "Can't reach the database at {{host}}:{{port}}. Check the host, port, and network connectivity. Details: {{details}}",
+      "timeout": "Timed out connecting to the database at {{host}}:{{port}} after about {{seconds}} seconds.",
+      "authenticationFailed": "Failed to sign in to database \"{{database}}\" with user \"{{user}}\". Check the username and password.",
+      "databaseNotFound": "Database \"{{database}}\" does not exist or is not accessible with the current connection settings.",
+      "connectionFailed": "Database connection check failed. Details: {{details}}"
     }
   },
   "commands": {
@@ -73,10 +80,6 @@
         },
         "scope": {
           "message": "Where should this connection be saved?",
-          "autoLabel": "Auto",
-          "autoHint": "project if this repo already has .nocobase, otherwise global",
-          "projectLabel": "Project",
-          "projectHint": ".nocobase in this repo",
           "globalLabel": "Global",
           "globalHint": "user-level config"
         },
@@ -273,7 +276,7 @@
         "envExists": "Env \"{{envName}}\" already exists. Choose another env name."
       },
       "messages": {
-        "title": "Set Up Your NocoBase AI Workspace",
+        "title": "Set Up NocoBase for Coding Agents",
         "appNameRequiredWhenSkipped": "Env name is required when prompts are skipped.",
         "appNameEnvHelp": "Use `nb init --yes --env <envName>` to continue.",
         "resumeEnvRequired": "Env name is required when resuming setup.",
@@ -303,24 +306,24 @@
         }
       },
       "webUi": {
-        "pageTitle": "Set Up Your NocoBase AI Workspace",
-        "documentHeading": "Set Up Your NocoBase AI Workspace",
-        "documentHint": "Connect an existing NocoBase app, or install a new one and connect it, so coding agents can work with NocoBase in this workspace.",
+        "pageTitle": "Set Up NocoBase for Coding Agents",
+        "documentHeading": "Set Up NocoBase for Coding Agents",
+        "documentHint": "Connect an existing NocoBase app, or install a new one, so coding agents can access and work with NocoBase.",
         "gettingStarted": {
           "title": "Getting started",
-          "description": "Pick your setup path."
+          "description": "Choose whether to connect an existing app or install a new one."
         },
         "connectExistingApp": {
           "title": "Connect an existing app",
-          "description": "Add your app connection."
+          "description": "Save your app connection."
         },
         "createNewApp": {
-          "title": "Create a new app",
-          "description": "Set project basics."
+          "title": "Install a new app",
+          "description": "Set app basics and install options."
         },
         "downloadAppFiles": {
           "title": "Download app files",
-          "description": "Choose source and options."
+          "description": "Choose how to get the app files."
         },
         "configureDatabase": {
           "title": "Configure the database",

package/dist/locale/zh-CN.json

@@ -62,6 +62,13 @@
       "allocateNotDockerPublished": "分配未被 Docker 占用的可用 TCP 端口失败。",
       "alreadyInUse": "端口 {{port}} 已被占用，请更换其他端口。",
       "alreadyInUseByDocker": "端口 {{port}} 已被 Docker 容器占用，请更换其他端口。"
+    },
+    "dbConnection": {
+      "unreachable": "无法连接到数据库 {{host}}:{{port}}。请检查主机、端口和网络连通性。详情：{{details}}",
+      "timeout": "连接数据库 {{host}}:{{port}} 超时，约 {{seconds}} 秒内未成功建立连接。",
+      "authenticationFailed": "无法使用用户 \"{{user}}\" 登录数据库 \"{{database}}\"。请检查用户名和密码。",
+      "databaseNotFound": "数据库 \"{{database}}\" 不存在，或当前连接配置无权访问该数据库。",
+      "connectionFailed": "数据库连接检查失败。详情：{{details}}"
     }
   },
   "commands": {
@@ -73,10 +80,6 @@
         },
         "scope": {
           "message": "这个连接要保存到哪里？",
-          "autoLabel": "自动",
-          "autoHint": "当前仓库已有 .nocobase 时保存到项目内，否则保存到全局",
-          "projectLabel": "项目内",
-          "projectHint": "保存在当前仓库的 .nocobase 中",
           "globalLabel": "全局",
           "globalHint": "保存在用户级配置中"
         },
@@ -273,7 +276,7 @@
         "envExists": "Env \"{{envName}}\" 已存在，请换一个 env name。"
       },
       "messages": {
-        "title": "初始化你的 NocoBase AI 工作区",
+        "title": "配置供 Coding Agents 使用的 NocoBase",
         "appNameRequiredWhenSkipped": "跳过 prompts 时必须提供 Env name。",
         "appNameEnvHelp": "请使用 `nb init --yes --env <envName>` 继续。",
         "resumeEnvRequired": "恢复安装时必须提供 Env name。",
@@ -303,24 +306,24 @@
         }
       },
       "webUi": {
-        "pageTitle": "初始化你的 NocoBase AI 工作区",
-        "documentHeading": "初始化你的 NocoBase AI 工作区",
-        "documentHint": "连接已有的 NocoBase 应用，或安装一个新的应用后再完成连接，让 Coding Agents 可以在当前工作区中结合 NocoBase 协同工作。",
+        "pageTitle": "配置供 Coding Agents 使用的 NocoBase",
+        "documentHeading": "配置供 Coding Agents 使用的 NocoBase",
+        "documentHint": "连接已有的 NocoBase 应用，或安装一个新的应用，让 Coding Agents 可以在当前工作区中访问和操作 NocoBase。",
         "gettingStarted": {
           "title": "开始设置",
-          "description": "选择你的配置路径。"
+          "description": "选择连接已有应用，或安装一个新应用。"
         },
         "connectExistingApp": {
           "title": "连接已有应用",
-          "description": "添加现有应用连接。"
+          "description": "保存现有应用连接。"
         },
         "createNewApp": {
-          "title": "创建新应用",
-          "description": "设置项目基础信息。"
+          "title": "安装新应用",
+          "description": "设置应用基础信息和安装选项。"
         },
         "downloadAppFiles": {
           "title": "下载应用文件",
-          "description": "选择来源和下载选项。"
+          "description": "选择获取应用文件的方式。"
         },
         "configureDatabase": {
           "title": "配置数据库",