@nocobase/cli 2.2.0-alpha.1 → 2.2.0-beta.2

package/bin/node-version.js

@@ -0,0 +1,35 @@
+const MINIMUM_NODE_MAJOR_VERSION = 22;
+
+export function getNodeMajorVersion(version = process.versions.node) {
+  const match = String(version ?? '')
+    .trim()
+    .match(/^v?(\d+)/);
+
+  if (!match) {
+    return Number.NaN;
+  }
+
+  return Number.parseInt(match[1], 10);
+}
+
+export function isSupportedNodeVersion(
+  version = process.versions.node,
+  minimumMajorVersion = MINIMUM_NODE_MAJOR_VERSION,
+) {
+  const majorVersion = getNodeMajorVersion(version);
+  return Number.isInteger(majorVersion) && majorVersion >= minimumMajorVersion;
+}
+
+export function formatUnsupportedNodeVersionMessage(
+  version = process.version,
+  minimumMajorVersion = MINIMUM_NODE_MAJOR_VERSION,
+) {
+  const currentVersion = String(version ?? '').trim() || 'unknown';
+
+  return [
+    `[nocobase cli]: Node.js ${minimumMajorVersion} or later is required to run nb.`,
+    `[nocobase cli]: Current version: ${currentVersion}. Please install Node.js ${minimumMajorVersion} or later and try again.`,
+  ].join('\n');
+}
+
+export { MINIMUM_NODE_MAJOR_VERSION };

package/bin/run.js

@@ -6,6 +6,7 @@ import { createRequire } from 'node:module';
 import path from 'node:path';
 import pc from 'picocolors';
 import { fileURLToPath, pathToFileURL } from 'node:url';
+import { formatUnsupportedNodeVersionMessage, isSupportedNodeVersion } from './node-version.js';
 import { normalizeNodeOptions, normalizeSessionEnv } from './session-env.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -18,6 +19,11 @@ if (process.env.NB_CLI_USE_DIST === '1') {
   isDev = false;
 }
 
+if (!isSupportedNodeVersion()) {
+  console.error(pc.red(formatUnsupportedNodeVersionMessage(process.version)));
+  process.exit(1);
+}
+
 normalizeSessionEnv();
 normalizeNodeOptions();
 

package/dist/commands/init.js

@@ -246,16 +246,12 @@ function formatBrowserOpenError(error) {
     return String(error);
 }
 export default class Init extends Command {
-    static summary = 'Set up NocoBase so coding agents can connect and work with it';
-    static description = `Set up NocoBase for coding agents in the current workspace.
+    static summary = 'Set up or connect a NocoBase environment in the current workspace';
+    static description = `Set up NocoBase in the current workspace.
 
-\`nb init\` prepares a NocoBase environment that coding agents can use. It supports three setup paths:
+\`nb init\` helps you install a new NocoBase app, take over managing one that already exists on this machine, or connect a remote NocoBase app and save it as a CLI env.
 
-- Install a new NocoBase app, then save it as a CLI env.
-- Take over managing an app that already exists on this machine by reusing its database.
-- Connect a remote NocoBase app and save it as a CLI env.
-
-It can also install NocoBase AI coding skills (\`nocobase/skills\`) so agents get the project-specific workflow guidance.
+You can use the saved environment directly, or let a coding agent access it later. It can also install NocoBase AI coding skills (\`nocobase/skills\`) when you want agent-specific workflow guidance.
 
 If setup was interrupted earlier, use \`--resume\` with an existing env name to continue from the saved workspace config.
 

package/dist/commands/skills/check.js

@@ -12,10 +12,7 @@ import { printInfo, renderTable } from '../../lib/ui.js';
 export default class SkillsCheck extends Command {
     static summary = 'Check the globally installed NocoBase AI coding skills';
     static description = 'Inspect the global NocoBase AI coding skills and report whether they are managed by the CLI and whether an update is available.';
-    static examples = [
-        '<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %> --json',
-    ];
+    static examples = ['<%= config.bin %> <%= command.id %>', '<%= config.bin %> <%= command.id %> --json'];
     static flags = {
         json: Flags.boolean({
             description: 'Output the result as JSON',
@@ -25,6 +22,7 @@ export default class SkillsCheck extends Command {
     async run() {
         const { flags } = await this.parse(SkillsCheck);
         const status = await inspectSkillsStatus();
+        const displaySkillNames = status.packageSkillNames.length ? status.packageSkillNames : status.installedSkillNames;
         if (flags.json) {
             this.log(JSON.stringify({
                 ok: true,
@@ -35,6 +33,7 @@ export default class SkillsCheck extends Command {
                 managedByNb: status.managedByNb,
                 sourcePackage: status.sourcePackage,
                 npmPackageName: status.npmPackageName,
+                packageSkillNames: status.packageSkillNames,
                 installedSkillNames: status.installedSkillNames,
                 installedVersion: status.installedVersion,
                 latestVersion: status.latestVersion,
@@ -50,7 +49,7 @@ export default class SkillsCheck extends Command {
             ['Skills home', status.globalRoot],
             ['Installed', status.installed ? 'yes' : 'no'],
             ['Managed by nb', status.managedByNb ? 'yes' : 'no'],
-            ['Installed skills', status.installedSkillNames.length ? status.installedSkillNames.join(', ') : '(none)'],
+            ['Installed skills', displaySkillNames.length ? displaySkillNames.join(', ') : '(none)'],
             ['Installed version', status.installedVersion ?? '(unknown)'],
             ['Latest version', status.latestVersion ?? '(unknown)'],
             ['Update available', status.updateAvailable === null ? 'unknown' : status.updateAvailable ? 'yes' : 'no'],

package/dist/commands/skills/install.js

@@ -16,6 +16,7 @@ export default class SkillsInstall extends Command {
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --yes',
+        '<%= config.bin %> <%= command.id %> --version 1.0.4',
         '<%= config.bin %> <%= command.id %> --json',
     ];
     static flags = {
@@ -32,6 +33,9 @@ export default class SkillsInstall extends Command {
             description: 'Show detailed install output',
             default: false,
         }),
+        version: Flags.string({
+            description: 'Install a specific @nocobase/skills version',
+        }),
     };
     async run() {
         const { flags } = await this.parse(SkillsInstall);
@@ -52,6 +56,7 @@ export default class SkillsInstall extends Command {
             }
         }
         const result = await installNocoBaseSkills({
+            targetVersion: flags.version,
             verbose: flags.verbose,
         });
         if (flags.json) {

package/dist/commands/skills/update.js

@@ -8,7 +8,7 @@
  */
 import { Command, Flags } from '@oclif/core';
 import { confirm } from "../../lib/inquirer.js";
-import { setVerboseMode } from '../../lib/ui.js';
+import { setVerboseMode, startTask, stopTask } from '../../lib/ui.js';
 import { updateNocoBaseSkills } from '../../lib/skills-manager.js';
 export default class SkillsUpdate extends Command {
     static summary = 'Update the globally installed NocoBase AI coding skills';
@@ -16,6 +16,7 @@ export default class SkillsUpdate extends Command {
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --yes',
+        '<%= config.bin %> <%= command.id %> --version 1.0.4',
         '<%= config.bin %> <%= command.id %> --json',
     ];
     static flags = {
@@ -32,6 +33,9 @@ export default class SkillsUpdate extends Command {
             description: 'Show detailed update output',
             default: false,
         }),
+        version: Flags.string({
+            description: 'Sync to a specific @nocobase/skills version',
+        }),
     };
     async run() {
         const { flags } = await this.parse(SkillsUpdate);
@@ -51,8 +55,19 @@ export default class SkillsUpdate extends Command {
                 return;
             }
         }
+        const shouldShowLoading = !flags.json && !flags.verbose;
+        if (shouldShowLoading) {
+            startTask(flags.version
+                ? `Syncing NocoBase AI coding skills to ${flags.version}...`
+                : 'Updating NocoBase AI coding skills...');
+        }
         const result = await updateNocoBaseSkills({
+            targetVersion: flags.version,
             verbose: flags.verbose,
+        }).finally(() => {
+            if (shouldShowLoading) {
+                stopTask();
+            }
         });
         if (flags.json) {
             this.log(JSON.stringify({
@@ -80,8 +95,6 @@ export default class SkillsUpdate extends Command {
                 : 'NocoBase AI coding skills are up to date.');
             return;
         }
-        this.log(flags.verbose
-            ? 'Updated the global NocoBase AI coding skills.'
-            : 'Updated NocoBase AI coding skills globally.');
+        this.log(flags.verbose ? 'Updated the global NocoBase AI coding skills.' : 'Updated NocoBase AI coding skills globally.');
     }
 }

package/dist/commands/source/download.js

@@ -16,7 +16,7 @@ import { DEFAULT_DOCKER_REGISTRY, DEFAULT_DOCKER_REGISTRY_ZH_CN, resolveDockerIm
 import { run } from "../../lib/run-npm.js";
 import { printVerbose, setVerboseMode, startTask, stopTask, updateTask } from '../../lib/ui.js';
 const DEFAULT_DOCKER_PLATFORM = 'auto';
-const DEFAULT_DOWNLOAD_VERSION = 'beta';
+const DEFAULT_DOWNLOAD_VERSION = 'latest';
 const downloadText = (key, values) => localeText(`commands.download.${key}`, values);
 const downloadTranslatedText = (key, values, fallback) => translateCli(`commands.download.${key}`, values, { fallback });
 function defaultOutputDirForVersion(versionTag) {
@@ -276,7 +276,6 @@ export default class SourceDownload extends Command {
                     value: 'latest',
                     label: downloadText('prompts.version.latestLabel'),
                     hint: downloadText('prompts.version.latestHint'),
-                    disabled: true,
                 },
                 {
                     value: 'beta',

package/dist/lib/api-command-compat.js

@@ -114,12 +114,22 @@ function compareWithOperator(version, operator, expected) {
 }
 function normalizeAppByChannelComparableVersion(version) {
     const normalized = String(version ?? '').trim();
-    const match = normalized.match(/^(\d+\.\d+\.\d+)-(alpha|beta|rc)(?:\.(\d+))?(?:\..+)?$/);
+    const match = normalized.match(/^(\d+\.\d+\.\d+)(?:-([0-9A-Za-z-.]+))?$/);
     if (!match) {
         return normalized;
     }
-    const [, base, channel, sequence] = match;
-    return sequence ? `${base}-${channel}.${sequence}` : `${base}-${channel}`;
+    const [, base, prerelease] = match;
+    if (!prerelease) {
+        return base;
+    }
+    const [channel, sequence] = prerelease.split('.');
+    if ((channel === 'alpha' || channel === 'beta') && sequence && /^\d+$/.test(sequence)) {
+        return `${base}-${channel}.${sequence}`;
+    }
+    if (channel === 'alpha' || channel === 'beta') {
+        return `${base}-${channel}`;
+    }
+    return base;
 }
 function normalizeAppByChannelCondition(condition) {
     if (!condition) {
@@ -134,6 +144,42 @@ function normalizeAppByChannelCondition(condition) {
     }
     return normalized;
 }
+function compareAppByChannelVersions(version, expected) {
+    const comparableVersion = normalizeAppByChannelComparableVersion(version);
+    const comparableExpected = normalizeAppByChannelComparableVersion(expected);
+    if (comparableVersion === comparableExpected ||
+        comparableVersion.startsWith(`${comparableExpected}.`) ||
+        comparableVersion.startsWith(`${comparableExpected}-`)) {
+        return 0;
+    }
+    return compareVersions(comparableVersion, comparableExpected);
+}
+function compareAppByChannelWithOperator(version, operator, expected) {
+    const compared = compareAppByChannelVersions(version, expected);
+    switch (operator) {
+        case 'eq':
+            return compared === 0;
+        case 'gt':
+            return compared > 0;
+        case 'gte':
+            return compared >= 0;
+        case 'lt':
+            return compared < 0;
+        case 'lte':
+            return compared <= 0;
+        default:
+            return false;
+    }
+}
+function matchesAppByChannelVersionCondition(version, condition) {
+    if (!condition) {
+        return true;
+    }
+    return ['eq', 'gt', 'gte', 'lt', 'lte'].every((operator) => {
+        const expected = condition[operator];
+        return expected ? compareAppByChannelWithOperator(version, operator, expected) : true;
+    });
+}
 function matchesVersionCondition(version, condition) {
     if (!condition) {
         return true;
@@ -168,10 +214,7 @@ function resolveAppChannel(version) {
     if (channel === 'beta') {
         return 'beta';
     }
-    if (channel === 'rc') {
-        return 'rc';
-    }
-    return 'unknownPrerelease';
+    return 'stable';
 }
 function evaluateAppByChannelCondition(version, condition) {
     if (!condition) {
@@ -208,7 +251,7 @@ function evaluateAppByChannelCondition(version, condition) {
     const comparableVersion = normalizeAppByChannelComparableVersion(version);
     const comparableCondition = normalizeAppByChannelCondition(channelCondition);
     return {
-        result: matchesVersionCondition(comparableVersion, comparableCondition) ? 'match' : 'mismatch',
+        result: matchesAppByChannelVersionCondition(comparableVersion, comparableCondition) ? 'match' : 'mismatch',
         channel,
         condition: channelCondition,
     };

package/dist/lib/skills-manager.js

@@ -154,10 +154,13 @@ export async function listGlobalSkills(options = {}) {
 export async function listProjectSkills(options = {}) {
     return await listGlobalSkills(options);
 }
-function pickInstalledNocoBaseSkillNames(installedSkills, state) {
+function pickInstalledNocoBaseSkillNames(installedSkills, state, sourceSkillNames = []) {
     const installedNames = new Set(installedSkills.map((skill) => String(skill.name ?? '').trim()).filter(Boolean));
-    if (state?.skillNames?.length) {
-        return state.skillNames.filter((name) => installedNames.has(name)).sort();
+    const managedNames = new Set([...sourceSkillNames, ...(state?.skillNames ?? [])]);
+    if (managedNames.size > 0) {
+        return Array.from(managedNames)
+            .filter((name) => installedNames.has(name))
+            .sort();
     }
     return Array.from(installedNames)
         .filter((name) => name.startsWith(NOCOBASE_SKILLS_NAME_PREFIX))
@@ -194,6 +197,31 @@ async function readCachedSkillsVersion(cacheRoot) {
         return undefined;
     }
 }
+async function readCachedPackageSkillNames(globalRoot) {
+    const skillsDir = path.join(getCachedSkillsPackageDir(getSkillsCacheRoot(globalRoot)), 'skills');
+    try {
+        const entries = await fsp.readdir(skillsDir, { withFileTypes: true });
+        const skillNames = await Promise.all(entries
+            .filter((entry) => entry.isDirectory())
+            .map(async (entry) => {
+            const skillName = entry.name.trim();
+            if (!skillName) {
+                return undefined;
+            }
+            try {
+                await fsp.access(path.join(skillsDir, skillName, 'SKILL.md'));
+                return skillName;
+            }
+            catch {
+                return undefined;
+            }
+        }));
+        return skillNames.filter((name) => Boolean(name)).sort();
+    }
+    catch {
+        return [];
+    }
+}
 async function resolvePackedSkillsTarball(packRoot) {
     const entries = await fsp.readdir(packRoot, { withFileTypes: true });
     const tarballs = entries
@@ -279,14 +307,16 @@ async function prepareLocalSkillsPackage(globalRoot, options = {}, targetVersion
 export async function inspectSkillsStatus(options = {}) {
     const globalRoot = resolveSkillsRoot(options);
     const stateFile = getManagedSkillsStateFile(globalRoot);
-    const [installedSkills, managedState] = await Promise.all([
+    const [installedSkills, managedState, cachedSkillNames] = await Promise.all([
         listGlobalSkills({
             globalRoot,
             commandOutputFn: options.commandOutputFn,
         }),
         readManagedSkillsState(globalRoot),
+        readCachedPackageSkillNames(globalRoot),
     ]);
-    const installedSkillNames = pickInstalledNocoBaseSkillNames(installedSkills, managedState);
+    const installedSkillNames = pickInstalledNocoBaseSkillNames(installedSkills, managedState, cachedSkillNames);
+    const packageSkillNames = cachedSkillNames;
     const managedByNb = managedState?.packageName === NOCOBASE_SKILLS_PACKAGE_NAME;
     let latestVersion;
     let registryError;
@@ -312,6 +342,7 @@ export async function inspectSkillsStatus(options = {}) {
         managedByNb,
         sourcePackage: managedState?.sourcePackage ?? NOCOBASE_SKILLS_SOURCE,
         npmPackageName: managedState?.packageName ?? NOCOBASE_SKILLS_PACKAGE_NAME,
+        packageSkillNames,
         installedSkillNames,
         latestVersion,
         installedVersion,
@@ -321,13 +352,18 @@ export async function inspectSkillsStatus(options = {}) {
         registryError,
     };
 }
-async function persistManagedSkillsState(globalRoot, options = {}) {
-    const installedSkills = await listGlobalSkills({
-        globalRoot,
-        commandOutputFn: options.commandOutputFn,
-    });
-    const managedState = await readManagedSkillsState(globalRoot);
-    const installedSkillNames = pickInstalledNocoBaseSkillNames(installedSkills, managedState);
+async function persistManagedSkillsState(globalRoot, options = {}, installedVersion) {
+    const [installedSkills, managedState, cachedSkillNames] = await Promise.all([
+        listGlobalSkills({
+            globalRoot,
+            commandOutputFn: options.commandOutputFn,
+        }),
+        readManagedSkillsState(globalRoot),
+        readCachedPackageSkillNames(globalRoot),
+    ]);
+    const installedSkillNames = pickInstalledNocoBaseSkillNames(installedSkills, managedState, cachedSkillNames);
+    const packageSkillNames = cachedSkillNames.length ? cachedSkillNames : installedSkillNames;
+    const cachedVersion = await readCachedSkillsVersion(getSkillsCacheRoot(globalRoot));
     const published = await readPublishedSkillsVersion({
         globalRoot,
         commandOutputFn: options.commandOutputFn,
@@ -338,8 +374,8 @@ async function persistManagedSkillsState(globalRoot, options = {}) {
         sourcePackage: NOCOBASE_SKILLS_SOURCE,
         installedAt: managedState?.installedAt ?? now,
         updatedAt: now,
-        installedVersion: published.version,
-        skillNames: installedSkillNames,
+        installedVersion: installedVersion ?? cachedVersion ?? published.version,
+        skillNames: packageSkillNames,
     });
     return await inspectSkillsStatus({
         globalRoot,
@@ -349,7 +385,7 @@ async function persistManagedSkillsState(globalRoot, options = {}) {
 async function reinstallManagedSkills(globalRoot, options = {}, targetVersion) {
     const prepared = await prepareLocalSkillsPackage(globalRoot, options, targetVersion);
     try {
-        await (options.runFn ?? run)('npx', ['-y', 'skills', 'add', prepared.packageDir, '-g', '-y'], {
+        await (options.runFn ?? run)('npx', ['-y', 'skills', 'add', prepared.packageDir, '-g', '-y', '--skill', '*'], {
             cwd: globalRoot,
             stdio: options.verbose ? 'inherit' : 'ignore',
             errorName: 'skills add',
@@ -360,23 +396,50 @@ async function reinstallManagedSkills(globalRoot, options = {}, targetVersion) {
         await prepared.cleanup();
     }
 }
+function pickObsoleteManagedSkillNames(installedSkillNames, packageSkillNames) {
+    if (!packageSkillNames.length) {
+        return [];
+    }
+    const packageSkillNameSet = new Set(packageSkillNames);
+    return installedSkillNames.filter((skillName) => !packageSkillNameSet.has(skillName)).sort();
+}
+async function removeObsoleteManagedSkills(globalRoot, installedSkillNames, options = {}) {
+    const packageSkillNames = await readCachedPackageSkillNames(globalRoot);
+    const obsoleteSkillNames = pickObsoleteManagedSkillNames(installedSkillNames, packageSkillNames);
+    for (const skillName of obsoleteSkillNames) {
+        await (options.runFn ?? run)('npx', ['-y', 'skills', 'remove', skillName, '-g', '-y'], {
+            cwd: globalRoot,
+            stdio: options.verbose ? 'inherit' : 'ignore',
+            errorName: 'skills remove',
+        });
+    }
+}
 export async function installNocoBaseSkills(options = {}) {
     const globalRoot = resolveSkillsRoot(options);
     const status = await inspectSkillsStatus({
         globalRoot,
         commandOutputFn: options.commandOutputFn,
     });
-    if (status.installed) {
+    const cachedSkillNames = await readCachedPackageSkillNames(globalRoot);
+    const missingCachedSkillNames = cachedSkillNames.filter((name) => !status.installedSkillNames.includes(name));
+    const obsoleteSkillNames = pickObsoleteManagedSkillNames(status.installedSkillNames, cachedSkillNames);
+    const targetVersion = String(options.targetVersion ?? '').trim() || undefined;
+    const targetVersionMatches = !targetVersion || status.installedVersion === targetVersion;
+    if (status.installed && targetVersionMatches && missingCachedSkillNames.length === 0 && obsoleteSkillNames.length === 0) {
         return {
             action: 'noop',
             status,
         };
     }
     await ensureSkillsWorkspaceRoot(globalRoot);
-    await reinstallManagedSkills(globalRoot, options, status.latestVersion);
+    if (!status.installed || !targetVersionMatches || missingCachedSkillNames.length > 0) {
+        const installVersion = targetVersion ?? status.latestVersion;
+        await reinstallManagedSkills(globalRoot, options, installVersion);
+    }
+    await removeObsoleteManagedSkills(globalRoot, status.installedSkillNames, options);
     return {
         action: 'installed',
-        status: await persistManagedSkillsState(globalRoot, options),
+        status: await persistManagedSkillsState(globalRoot, options, targetVersion),
     };
 }
 export async function updateNocoBaseSkills(options = {}) {
@@ -385,6 +448,10 @@ export async function updateNocoBaseSkills(options = {}) {
         globalRoot,
         commandOutputFn: options.commandOutputFn,
     });
+    const cachedSkillNames = await readCachedPackageSkillNames(globalRoot);
+    const missingCachedSkillNames = cachedSkillNames.filter((name) => !status.installedSkillNames.includes(name));
+    const obsoleteSkillNames = pickObsoleteManagedSkillNames(status.installedSkillNames, cachedSkillNames);
+    const targetVersion = String(options.targetVersion ?? '').trim() || undefined;
     if (!status.installed) {
         return {
             action: 'noop',
@@ -393,8 +460,11 @@ export async function updateNocoBaseSkills(options = {}) {
         };
     }
     if (status.managedByNb &&
+        !targetVersion &&
         status.latestVersion &&
         status.installedVersion &&
+        missingCachedSkillNames.length === 0 &&
+        obsoleteSkillNames.length === 0 &&
         compareVersions(status.latestVersion, status.installedVersion) <= 0) {
         return {
             action: 'noop',
@@ -402,10 +472,24 @@ export async function updateNocoBaseSkills(options = {}) {
             status,
         };
     }
-    await reinstallManagedSkills(globalRoot, options, status.latestVersion);
+    if (targetVersion &&
+        status.installedVersion === targetVersion &&
+        missingCachedSkillNames.length === 0 &&
+        obsoleteSkillNames.length === 0) {
+        return {
+            action: 'noop',
+            reason: 'up-to-date',
+            status,
+        };
+    }
+    if (!targetVersion || status.installedVersion !== targetVersion || missingCachedSkillNames.length > 0) {
+        const installVersion = targetVersion ?? status.latestVersion;
+        await reinstallManagedSkills(globalRoot, options, installVersion);
+    }
+    await removeObsoleteManagedSkills(globalRoot, status.installedSkillNames, options);
     return {
         action: 'updated',
-        status: await persistManagedSkillsState(globalRoot, options),
+        status: await persistManagedSkillsState(globalRoot, options, targetVersion),
     };
 }
 export async function removeNocoBaseSkills(options = {}) {

package/dist/locale/en-US.json

@@ -399,7 +399,7 @@
         "envExists": "Env \"{{envName}}\" already exists. Choose another env name."
       },
       "messages": {
-        "title": "Set up NocoBase for coding agents",
+        "title": "Set up NocoBase",
         "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.",
@@ -437,9 +437,9 @@
         }
       },
       "webUi": {
-        "pageTitle": "Set up NocoBase for coding agents",
-        "documentHeading": "Set up NocoBase for coding agents",
-        "documentHint": "Install a new app, manage one that already exists on this machine, or connect a remote app so coding agents can access and work with NocoBase.",
+        "pageTitle": "Set up NocoBase",
+        "documentHeading": "Set up NocoBase",
+        "documentHint": "Install a new app, manage an existing one, or connect a remote app. You can use it directly or let a coding agent access it later.",
         "gettingStarted": {
           "title": "Getting started",
           "description": "Choose whether to install a new app, manage a local app, or connect a remote app."

package/dist/locale/zh-CN.json

@@ -399,7 +399,7 @@
         "envExists": "Env \"{{envName}}\" 已存在，请换一个 env name。"
       },
       "messages": {
-        "title": "配置供 Coding Agents 使用的 NocoBase",
+        "title": "配置 NocoBase",
         "appNameRequiredWhenSkipped": "跳过 prompts 时必须提供 Env name。",
         "appNameEnvHelp": "请使用 `nb init --yes --env <envName>` 继续。",
         "resumeEnvRequired": "恢复安装时必须提供 Env name。",
@@ -437,9 +437,9 @@
         }
       },
       "webUi": {
-        "pageTitle": "配置供 Coding Agents 使用的 NocoBase",
-        "documentHeading": "配置供 Coding Agents 使用的 NocoBase",
-        "documentHint": "安装一个新的应用、接管本机已有应用，或连接远程应用，让 Coding Agents 可以在当前工作区中访问和操作 NocoBase。",
+        "pageTitle": "配置 NocoBase",
+        "documentHeading": "配置 NocoBase",
+        "documentHint": "安装一个新的应用、管理已有应用，或连接远程应用。你可以直接使用它，也可以稍后让 coding agent 访问它。",
         "gettingStarted": {
           "title": "开始设置",
           "description": "选择新安装、本机接管，或远程连接。"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nocobase/cli",
-  "version": "2.2.0-alpha.1",
+  "version": "2.2.0-beta.2",
   "description": "NocoBase Command Line Tool",
   "type": "module",
   "main": "dist/generated/command-registry.js",
@@ -12,6 +12,11 @@
   "keywords": [],
   "author": "",
   "license": "Apache-2.0",
+  "files": [
+    "bin",
+    "dist",
+    "nocobase-ctl.config.json"
+  ],
   "bin": {
     "nb": "./bin/run.js"
   },
@@ -138,5 +143,5 @@
     "type": "git",
     "url": "git+https://github.com/nocobase/nocobase.git"
   },
-  "gitHead": "303663aba6c6eefa27e6a6435b4c0352074ec40f"
+  "gitHead": "2fe3e6a86fc1d0cd039349a68b2e4d1d6945ce45"
 }

package/assets/env-proxy/nginx/app.conf.tpl

@@ -1,23 +0,0 @@
-# Rendered by `nb env proxy`.
-# Context:
-# publicBasePath={{publicBasePath}}
-# apiBasePath={{apiBasePath}}
-# wsPath={{wsPath}}
-# v2PublicPath={{v2PublicPath}}
-# backendUrl={{backendUrl}}
-# snippetsDir={{snippetsDir}}
-# uploadsDir={{uploadsDir}}
-# distRootDir={{distRootDir}}
-# entryDir={{entryDir}}
-# publicDir={{publicDir}}
-
-server {
-    listen 80;
-    server_name _;
-
-    # Add custom directives or locations above the managed block as needed.
-
-{{managedConfigBlock}}
-
-    # Add custom directives or locations below the managed block as needed.
-}

package/assets/env-proxy/nginx/nocobase.conf.tpl

@@ -1,5 +0,0 @@
-# Managed by `nb env proxy`. Changes will be overwritten.
-
-include {{snippetsDir}}/log-format-http.conf;
-include {{snippetsDir}}/maps-http.conf;
-include {{appConfigIncludePath}};

package/assets/env-proxy/nginx/snippets/dist-location.conf

@@ -1,5 +0,0 @@
-expires 365d;
-add_header Cache-Control "public" always;
-
-access_log off;
-autoindex off;

package/assets/env-proxy/nginx/snippets/gzip.conf

@@ -1,17 +0,0 @@
-gzip on;
-gzip_types
-    text/plain
-    text/css
-    text/xml
-    text/markdown
-    text/javascript
-    application/javascript
-    application/json
-    application/manifest+json
-    application/atom+xml
-    application/rss+xml
-    application/xml
-    application/xml+rss
-    application/xhtml+xml
-    application/wasm
-    image/svg+xml;

package/assets/env-proxy/nginx/snippets/log-format-http.conf

@@ -1,13 +0,0 @@
-log_format apm '"$time_local" client=$remote_addr '
-               'method=$request_method request="$request" '
-               'request_length=$request_length '
-               'status=$status bytes_sent=$bytes_sent '
-               'body_bytes_sent=$body_bytes_sent '
-               'referer=$http_referer '
-               'user_agent="$http_user_agent" '
-               'upstream_addr=$upstream_addr '
-               'upstream_status=$upstream_status '
-               'request_time=$request_time '
-               'upstream_response_time=$upstream_response_time '
-               'upstream_connect_time=$upstream_connect_time '
-               'upstream_header_time=$upstream_header_time';

package/assets/env-proxy/nginx/snippets/maps-http.conf

@@ -1,14 +0,0 @@
-map $http_upgrade $connection_upgrade {
-    default upgrade;
-    ""      close;
-}
-
-map $http_x_forwarded_proto $upstream_x_forwarded_proto {
-    default $http_x_forwarded_proto;
-    ""      $scheme;
-}
-
-map $http_host $final_host {
-    default $http_host;
-    ""      $host;
-}

package/assets/env-proxy/nginx/snippets/mime-types.conf

@@ -1,98 +0,0 @@
-types {
-    text/html                                        html htm shtml;
-    text/css                                         css;
-    text/xml                                         xml;
-    image/gif                                        gif;
-    image/jpeg                                       jpeg jpg;
-    application/javascript                           js mjs;
-    application/atom+xml                             atom;
-    application/rss+xml                              rss;
-
-    text/mathml                                      mml;
-    text/plain                                       txt;
-    text/vnd.sun.j2me.app-descriptor                 jad;
-    text/vnd.wap.wml                                 wml;
-    text/x-component                                 htc;
-
-    image/avif                                       avif;
-    image/png                                        png;
-    image/svg+xml                                    svg svgz;
-    image/tiff                                       tif tiff;
-    image/vnd.wap.wbmp                               wbmp;
-    image/webp                                       webp;
-    image/x-icon                                     ico;
-    image/x-jng                                      jng;
-    image/x-ms-bmp                                   bmp;
-
-    font/woff                                        woff;
-    font/woff2                                       woff2;
-
-    application/java-archive                         jar war ear;
-    application/json                                 json;
-    application/mac-binhex40                         hqx;
-    application/msword                               doc;
-    application/pdf                                  pdf;
-    application/postscript                           ps eps ai;
-    application/rtf                                  rtf;
-    application/vnd.apple.mpegurl                    m3u8;
-    application/vnd.google-earth.kml+xml             kml;
-    application/vnd.google-earth.kmz                 kmz;
-    application/vnd.ms-excel                         xls;
-    application/vnd.ms-fontobject                    eot;
-    application/vnd.ms-powerpoint                    ppt;
-    application/vnd.oasis.opendocument.graphics      odg;
-    application/vnd.oasis.opendocument.presentation  odp;
-    application/vnd.oasis.opendocument.spreadsheet   ods;
-    application/vnd.oasis.opendocument.text          odt;
-    application/vnd.openxmlformats-officedocument.presentationml.presentation
-                                                     pptx;
-    application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
-                                                     xlsx;
-    application/vnd.openxmlformats-officedocument.wordprocessingml.document
-                                                     docx;
-    application/vnd.wap.wmlc                         wmlc;
-    application/wasm                                 wasm;
-    application/x-7z-compressed                      7z;
-    application/x-cocoa                              cco;
-    application/x-java-archive-diff                  jardiff;
-    application/x-java-jnlp-file                     jnlp;
-    application/x-makeself                           run;
-    application/x-perl                               pl pm;
-    application/x-pilot                              prc pdb;
-    application/x-rar-compressed                     rar;
-    application/x-redhat-package-manager             rpm;
-    application/x-sea                                sea;
-    application/x-shockwave-flash                    swf;
-    application/x-stuffit                            sit;
-    application/x-tcl                                tcl tk;
-    application/x-x509-ca-cert                       der pem crt;
-    application/x-xpinstall                          xpi;
-    application/xhtml+xml                            xhtml;
-    application/xspf+xml                             xspf;
-    application/zip                                  zip;
-
-    application/octet-stream                         bin exe dll;
-    application/octet-stream                         deb;
-    application/octet-stream                         dmg;
-    application/octet-stream                         iso img;
-    application/octet-stream                         msi msp msm;
-
-    audio/midi                                       mid midi kar;
-    audio/mpeg                                       mp3;
-    audio/ogg                                        ogg;
-    audio/x-m4a                                      m4a;
-    audio/x-realaudio                                ra;
-
-    video/3gpp                                       3gpp 3gp;
-    video/mp2t                                       ts;
-    video/mp4                                        mp4;
-    video/mpeg                                       mpeg mpg;
-    video/quicktime                                  mov;
-    video/webm                                       webm;
-    video/x-flv                                      flv;
-    video/x-m4v                                      m4v;
-    video/x-mng                                      mng;
-    video/x-ms-asf                                   asx asf;
-    video/x-ms-wmv                                   wmv;
-    video/x-msvideo                                  avi;
-}

package/assets/env-proxy/nginx/snippets/proxy-location.conf

@@ -1,17 +0,0 @@
-proxy_http_version 1.1;
-
-proxy_set_header Upgrade $http_upgrade;
-proxy_set_header Connection $connection_upgrade;
-proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-proxy_set_header X-Forwarded-Proto $upstream_x_forwarded_proto;
-proxy_set_header Host $final_host;
-proxy_set_header Referer $http_referer;
-proxy_set_header User-Agent $http_user_agent;
-
-add_header Cache-Control "no-cache, no-store" always;
-proxy_cache_bypass $http_upgrade;
-
-proxy_connect_timeout 600;
-proxy_send_timeout 600;
-proxy_read_timeout 600;
-send_timeout 600;

package/assets/env-proxy/nginx/snippets/spa-location.conf

@@ -1,6 +0,0 @@
-add_header Cache-Control "no-store, no-cache, must-revalidate" always;
-add_header X-Robots-Tag "noindex, nofollow" always;
-
-if_modified_since off;
-expires off;
-etag off;

package/assets/env-proxy/nginx/snippets/uploads-location.conf

@@ -1,21 +0,0 @@
-add_header Cache-Control "public" always;
-add_header X-Content-Type-Options "nosniff" always;
-
-access_log off;
-autoindex off;
-
-# Force potentially renderable uploaded files to download.
-location ~* \.(?:htm|html|svg|svgz|xhtml)$ {
-    add_header Cache-Control "public" always;
-    add_header X-Content-Type-Options "nosniff" always;
-    add_header Content-Disposition "attachment" always;
-}
-
-# Let Markdown files render as plain Markdown text.
-location ~* \.md$ {
-    default_type text/markdown;
-
-    add_header Cache-Control "public" always;
-    add_header X-Content-Type-Options "nosniff" always;
-    add_header Content-Disposition "inline" always;
-}

package/scripts/build.mjs

@@ -1,34 +0,0 @@
-import { copyFileSync, mkdirSync, readdirSync, rmSync } from 'node:fs';
-import { createRequire } from 'node:module';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-
-const require = createRequire(import.meta.url);
-const scriptsDir = path.dirname(fileURLToPath(import.meta.url));
-const packageRoot = path.resolve(scriptsDir, '..');
-const distDir = path.join(packageRoot, 'dist');
-const srcLocaleDir = path.join(packageRoot, 'src', 'locale');
-const distLocaleDir = path.join(distDir, 'locale');
-const tscBin = require.resolve('typescript/bin/tsc');
-
-rmSync(distDir, { recursive: true, force: true });
-
-const compile = spawnSync(process.execPath, [tscBin, '-p', path.join(packageRoot, 'tsconfig.json')], {
-  cwd: packageRoot,
-  stdio: 'inherit',
-});
-
-if (compile.status !== 0) {
-  process.exit(compile.status ?? 1);
-}
-
-mkdirSync(distLocaleDir, { recursive: true });
-
-for (const entry of readdirSync(srcLocaleDir, { withFileTypes: true })) {
-  if (!entry.isFile() || !entry.name.endsWith('.json')) {
-    continue;
-  }
-
-  copyFileSync(path.join(srcLocaleDir, entry.name), path.join(distLocaleDir, entry.name));
-}

package/scripts/clean.mjs

@@ -1,9 +0,0 @@
-import { rmSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const scriptsDir = path.dirname(fileURLToPath(import.meta.url));
-const packageRoot = path.resolve(scriptsDir, '..');
-const distDir = path.join(packageRoot, 'dist');
-
-rmSync(distDir, { recursive: true, force: true });

package/tsconfig.json

@@ -1,19 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "rewriteRelativeImportExtensions": true,
-    "rootDir": "src",
-    "outDir": "dist",
-    "declaration": false,
-    "resolveJsonModule": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "types": ["node"],
-    "skipLibCheck": true,
-    "strict": false
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["src/**/__tests__/**"]
-}