@nocobase/plugin-ai 2.1.0-beta.29 → 2.1.0-beta.30

package/dist/ai/docs/nocobase/api/cli/api/dynamic.md

@@ -41,6 +41,13 @@ Dynamic commands with request bodies support:
 
 `--body` and `--body-file` are mutually exclusive.
 
+Dynamic API commands also support:
+
+- `--env`, `-e`: CLI env name to send the request to; when omitted, the current env is used
+- `--yes`, `-y`: When an explicitly passed `--env` targets a different env than the current env, skip the interactive confirmation prompt
+
+If you explicitly pass `--env` and it differs from the current env, the CLI asks for confirmation first. In non-interactive terminals or AI agent sessions, add `--yes` yourself or run `nb env use <name>` first and try again.
+
 ## Related Commands
 
 - [`nb env update`](../env/update.md)

package/dist/ai/docs/nocobase/api/cli/api/resource/index.md

@@ -32,6 +32,7 @@ nb api resource <command>
 | `--api-base-url` | string | NocoBase API URL, for example `http://localhost:13000/api` |
 | `--verbose` | boolean | Show detailed progress |
 | `--env`, `-e` | string | Env name |
+| `--yes`, `-y` | boolean | When an explicitly passed `--env` targets a different env than the current env, skip the interactive confirmation prompt |
 | `--role` | string | Role override sent as the `X-Role` request header |
 | `--token`, `-t` | string | API key override |
 | `--json-output`, `-j` / `--no-json-output` | boolean | Whether to output raw JSON; enabled by default |
@@ -49,6 +50,8 @@ nb api resource create --resource users --values '{"nickname":"Ada"}'
 nb api resource list --resource posts.comments --source-id 1 --fields id --fields content
 ```
 
+If you explicitly pass `--env` and it differs from the current env, the CLI asks for confirmation first. In non-interactive terminals or AI agent sessions, add `--yes` yourself or run `nb env use <name>` first and try again.
+
 ## Related Commands
 
 - [`nb api`](../index.md)

package/dist/ai/docs/nocobase/api/cli/app/down.md

@@ -6,7 +6,7 @@ keywords: "nb app down,NocoBase CLI,cleanup,remove containers,storage"
 
 # nb app down
 
-Stop and clean up local runtime resources for a selected env. Storage data and env configuration are kept by default; pass `--all --yes` explicitly to delete everything.
+Stop and clean up local runtime resources for a selected env. Storage data and env configuration are kept by default; pass `--all --force` explicitly to delete everything.
 
 ## Usage
 
@@ -20,16 +20,20 @@ nb app down [flags]
 | --- | --- | --- |
 | `--env`, `-e` | string | CLI env name to clean up; uses the current env if omitted |
 | `--all` | boolean | Delete all content for the env, including storage data and saved env configuration |
-| `--yes`, `-y` | boolean | Skip destructive-operation confirmation; usually used with `--all` |
+| `--yes`, `-y` | boolean | When an explicitly passed `--env` targets a different env than the current env, skip the interactive confirmation prompt |
+| `--force`, `-f` | boolean | Force destructive cleanup, such as `--all` or other high-risk cleanup in non-interactive mode |
 | `--verbose` | boolean | Show underlying stop and cleanup command output |
 
 ## Examples
 
 ```bash
 nb app down --env app1
-nb app down --env app1 --all --yes
+nb app down --env app1 --all --force
+nb app down --env app1 --force
 ```
 
+`--yes` only skips the interactive confirmation when an explicitly passed `--env` targets a different env than the current env. `--force` is for actually forcing destructive cleanup, such as `--all` or other high-risk cleanup in non-interactive mode.
+
 ## Related Commands
 
 - [`nb app stop`](./stop.md)

package/dist/ai/docs/nocobase/api/cli/app/index.md

@@ -32,7 +32,7 @@ nb app start --env app1
 nb app restart --env app1
 nb app logs --env app1
 nb app stop --env app1
-nb app down --env app1 --all --yes
+nb app down --env app1 --all --force
 ```
 
 ## Related Commands

package/dist/ai/docs/nocobase/api/cli/app/logs.md

@@ -19,6 +19,7 @@ nb app logs [flags]
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `--env`, `-e` | string | CLI env name to view logs for; uses the current env if omitted |
+| `--yes`, `-y` | boolean | When an explicitly passed `--env` targets a different env than the current env, skip the interactive confirmation prompt |
 | `--tail` | integer | Number of recent log lines to show before following, default `100` |
 | `--follow`, `-f` / `--no-follow` | boolean | Whether to keep following new log output |
 
@@ -31,6 +32,8 @@ nb app logs --env app1 --tail 200
 nb app logs --env app1 --no-follow
 ```
 
+If you explicitly pass `--env` and it differs from the current env, the CLI asks for confirmation first. In non-interactive terminals or AI agent sessions, add `--yes` yourself or run `nb env use <name>` first and try again.
+
 ## Related Commands
 
 - [`nb app start`](./start.md)

package/dist/ai/docs/nocobase/api/cli/app/restart.md

@@ -19,6 +19,7 @@ nb app restart [flags]
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `--env`, `-e` | string | CLI env name to restart; uses the current env if omitted |
+| `--yes`, `-y` | boolean | When an explicitly passed `--env` targets a different env than the current env, skip the interactive confirmation prompt |
 | `--quickstart` | boolean | Start the app in quickstart mode after stopping |
 | `--port`, `-p` | string | Override the `appPort` saved in env config |
 | `--daemon`, `-d` / `--no-daemon` | boolean | Whether to run in daemon mode after stopping; enabled by default |
@@ -36,9 +37,12 @@ nb app restart --env local --port 12000
 nb app restart --env local --no-daemon
 nb app restart --env local --instances 2
 nb app restart --env local --launch-mode pm2
+nb app restart --env local --verbose
 nb app restart --env local-docker
 ```
 
+If you explicitly pass `--env` and it differs from the current env, the CLI asks for confirmation first. In non-interactive terminals or AI agent sessions, add `--yes` yourself or run `nb env use <name>` first and try again.
+
 ## Related Commands
 
 - [`nb app start`](./start.md)

package/dist/ai/docs/nocobase/api/cli/app/start.md

@@ -19,6 +19,7 @@ nb app start [flags]
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `--env`, `-e` | string | CLI env name to start; uses the current env if omitted |
+| `--yes`, `-y` | boolean | When an explicitly passed `--env` targets a different env than the current env, skip the interactive confirmation prompt |
 | `--quickstart` | boolean | Start the app in quickstart mode |
 | `--port`, `-p` | string | Override the `appPort` saved in env config |
 | `--daemon`, `-d` / `--no-daemon` | boolean | Whether to run in daemon mode; enabled by default |
@@ -37,9 +38,12 @@ nb app start --env local --daemon
 nb app start --env local --no-daemon
 nb app start --env local --instances 2
 nb app start --env local --launch-mode pm2
+nb app start --env local --verbose
 nb app start --env local-docker
 ```
 
+If you explicitly pass `--env` and it differs from the current env, the CLI asks for confirmation first. In non-interactive terminals or AI agent sessions, add `--yes` yourself or run `nb env use <name>` first and try again.
+
 ## Related Commands
 
 - [`nb app stop`](./stop.md)

package/dist/ai/docs/nocobase/api/cli/app/stop.md

@@ -19,6 +19,7 @@ nb app stop [flags]
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `--env`, `-e` | string | CLI env name to stop; uses the current env if omitted |
+| `--yes`, `-y` | boolean | When an explicitly passed `--env` targets a different env than the current env, skip the interactive confirmation prompt |
 | `--verbose` | boolean | Show underlying local or Docker command output |
 
 ## Examples
@@ -30,6 +31,8 @@ nb app stop --env local --verbose
 nb app stop --env local-docker
 ```
 
+If you explicitly pass `--env` and it differs from the current env, the CLI asks for confirmation first. In non-interactive terminals or AI agent sessions, add `--yes` yourself or run `nb env use <name>` first and try again.
+
 ## Related Commands
 
 - [`nb app start`](./start.md)

package/dist/ai/docs/nocobase/api/cli/app/upgrade.md

@@ -19,7 +19,9 @@ nb app upgrade [flags]
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `--env`, `-e` | string | CLI env name to upgrade; uses the current env if omitted |
+| `--yes`, `-y` | boolean | When an explicitly passed `--env` targets a different env than the current env, skip the interactive confirmation prompt |
 | `--skip-code-update`, `-s` | boolean | Restart from the saved local source or Docker image without downloading updates |
+| `--version` | string | Override the saved `downloadVersion`; when the upgrade succeeds, the new version is written back to the env config |
 | `--verbose` | boolean | Show underlying update and restart command output |
 
 ## Examples
@@ -28,10 +30,13 @@ nb app upgrade [flags]
 nb app upgrade
 nb app upgrade --env local
 nb app upgrade --env local -s
+nb app upgrade --env local --version beta
 nb app upgrade --env local --verbose
 nb app upgrade --env local-docker -s
 ```
 
+If you explicitly pass `--env` and it differs from the current env, the CLI asks for confirmation first. In non-interactive terminals or AI agent sessions, add `--yes` yourself or run `nb env use <name>` first and try again.
+
 ## Related Commands
 
 - [`nb source download`](../source/download.md)

package/dist/ai/docs/nocobase/api/cli/env/add.md

@@ -1,13 +1,20 @@
 ---
 title: "nb env add"
-description: "nb env add command reference: save a NocoBase API URL and authentication method, then switch to it as the current env."
-keywords: "nb env add,NocoBase CLI,add environment,API URL,authentication"
+description: "nb env add command reference: save a NocoBase API URL and authentication method, then switch to that env."
+keywords: "nb env add,NocoBase CLI,add environment,API Base URL,authentication"
 ---
 
 # nb env add
 
 Save a named NocoBase API endpoint and switch the CLI to use that env. When `oauth` authentication is selected, [`nb env auth`](./auth.md) is started automatically.
 
+This command does two things:
+
+- Save the env configuration
+- Switch the current env to the newly added env
+
+When session mode is enabled for the current shell or runtime, it updates the session `current env`. It also updates the global `last env` as the fallback for shells or runtimes without session mode.
+
 ## Usage
 
 ```bash
@@ -18,7 +25,7 @@ nb env add [name] [flags]
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `[name]` | string | Env name; prompted in TTY when omitted, required in non-TTY mode |
+| `[name]` | string | Environment name to save; prompted in TTY when omitted, required in non-TTY mode |
 | `--verbose` | boolean | Show detailed progress when writing config |
 | `--locale` | string | CLI prompt language: `en-US` or `zh-CN` |
 | `--api-base-url`, `-u` | string | NocoBase API URL, including the `/api` prefix |
@@ -37,5 +44,6 @@ nb env add local --api-base-url http://localhost:13000/api --auth-type token --a
 ## Related Commands
 
 - [`nb env auth`](./auth.md)
+- [`nb env current`](./current.md)
 - [`nb env update`](./update.md)
 - [`nb env list`](./list.md)

package/dist/ai/docs/nocobase/api/cli/env/auth.md

@@ -18,7 +18,7 @@ nb env auth [name]
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `[name]` | string | Env name; uses the current env if omitted |
+| `[name]` | string | Configured environment name to sign in to; uses the current env if omitted |
 
 ## Notes
 

package/dist/ai/docs/nocobase/api/cli/env/current.md

@@ -0,0 +1,29 @@
+---
+title: "nb env current"
+description: "nb env current command reference: show the currently effective NocoBase CLI env."
+keywords: "nb env current,NocoBase CLI,current env,session env"
+---
+
+# nb env current
+
+Show the name of the currently effective env.
+
+By default, this command first reads the session env for the current `NB_SESSION_ID`. If session mode is not enabled for the current shell or runtime, it falls back to the global `last env`.
+
+## Usage
+
+```bash
+nb env current
+```
+
+## Examples
+
+```bash
+nb env current
+```
+
+## Related Commands
+
+- [`nb env use`](./use.md)
+- [`nb env status`](./status.md)
+- [`nb session setup`](../session/setup.md)

package/dist/ai/docs/nocobase/api/cli/env/index.md

@@ -1,13 +1,18 @@
 ---
 title: "nb env"
-description: "nb env command reference: manage NocoBase CLI envs, including add, refresh, inspect, switch, authenticate, and remove."
-keywords: "nb env,NocoBase CLI,environment management,env,authentication,OpenAPI"
+description: "nb env command reference: manage NocoBase CLI envs, including add, inspect current env, check status, switch, authenticate, and remove."
+keywords: "nb env,NocoBase CLI,environment management,env,current env,authentication,OpenAPI"
 ---
 
 # nb env
 
 Manage saved NocoBase CLI envs. An env stores API URL, authentication info, local app paths, database config, and runtime command cache.
 
+In the current model, the CLI separates two concepts:
+
+- `current env`: the env currently used by the active shell or agent runtime, isolated by `NB_SESSION_ID` when available
+- `last env`: the globally last-used env, used as a fallback when session mode is not enabled
+
 ## Usage
 
 ```bash
@@ -18,9 +23,11 @@ nb env <command>
 
 | Command | Description |
 | --- | --- |
-| [`nb env add`](./add.md) | Save a NocoBase API endpoint and switch to it as the current env |
+| [`nb env add`](./add.md) | Save a NocoBase API endpoint and switch to that env |
+| [`nb env current`](./current.md) | Show the currently effective env |
 | [`nb env update`](./update.md) | Refresh OpenAPI Schema and runtime command cache from the app |
-| [`nb env list`](./list.md) | List configured envs and API authentication status |
+| [`nb env list`](./list.md) | List configured envs |
+| [`nb env status`](./status.md) | Show status for the current env, one env, or all envs |
 | [`nb env info`](./info.md) | Show details for a single env |
 | [`nb env remove`](./remove.md) | Remove env configuration |
 | [`nb env auth`](./auth.md) | Run OAuth login for a saved env |
@@ -30,15 +37,26 @@ nb env <command>
 
 ```bash
 nb env add app1 --api-base-url http://localhost:13000/api
+nb env current
 nb env list
+nb env status
 nb env info app1
 nb env update app1
 nb env use app1
 nb env auth app1
 ```
 
+## Session mode
+
+Session mode is the default recommendation. It keeps `current env` isolated across different terminals, shells, and agent runtimes, so parallel work does not affect each other.
+
+When session mode is not enabled, `nb env use` updates the global `last env`, and other sessions without isolation may also be affected.
+
+See [`nb session setup`](../session/setup.md) to enable it.
+
 ## Related Commands
 
 - [`nb init`](../init.md)
 - [`nb api`](../api/index.md)
 - [`nb app`](../app/index.md)
+- [`nb session`](../session/index.md)

package/dist/ai/docs/nocobase/api/cli/env/info.md

@@ -18,20 +18,16 @@ nb env info [name] [flags]
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `[name]` | string | CLI env name to inspect; uses the current env if omitted |
-| `--env`, `-e` | string | CLI env name to inspect; alternative to the positional argument |
+| `[name]` | string | Configured environment name to inspect; uses the current env if omitted |
 | `--json` | boolean | Output JSON |
 | `--show-secrets` | boolean | Show tokens, passwords, and other secrets in plain text |
 
-If both `[name]` and `--env` are passed, they must match.
-
 ## Examples
 
 ```bash
 nb env info app1
 nb env info app1 --json
 nb env info app1 --show-secrets
-nb env info --env app1
 ```
 
 ## Related Commands

package/dist/ai/docs/nocobase/api/cli/env/list.md

@@ -1,12 +1,14 @@
 ---
 title: "nb env list"
-description: "nb env list command reference: list configured NocoBase CLI envs and API authentication status."
-keywords: "nb env list,NocoBase CLI,environment list,authentication status"
+description: "nb env list command reference: list configured NocoBase CLI envs."
+keywords: "nb env list,NocoBase CLI,environment list,API Base URL"
 ---
 
 # nb env list
 
-List all configured envs and check app API authentication status with saved Token/OAuth credentials.
+List all configured envs.
+
+This command only shows saved configuration. Use [`nb env status`](./status.md) when you want to check current runtime or API status.
 
 ## Usage
 
@@ -16,9 +18,11 @@ nb env list
 
 ## Output
 
-The output table includes the current env marker, name, type, App Status, URL, authentication type, and runtime version.
+The output table includes the current env marker, name, type, `API Base URL`, authentication type, and runtime version.
 
-`App Status` is the result of accessing the app API with the saved auth info, such as `ok`, `auth failed`, `unreachable`, or `unconfigured`. Use [`nb db ps`](../db/ps.md) to inspect database runtime status.
+- `Current` marks the currently effective env with `*`
+- `API Base URL` shows the saved raw API address
+- `Runtime` shows cached runtime version information
 
 ## Examples
 
@@ -28,6 +32,7 @@ nb env list
 
 ## Related Commands
 
+- [`nb env current`](./current.md)
+- [`nb env status`](./status.md)
 - [`nb env info`](./info.md)
 - [`nb env use`](./use.md)
-- [`nb db ps`](../db/ps.md)

package/dist/ai/docs/nocobase/api/cli/env/remove.md

@@ -8,6 +8,8 @@ keywords: "nb env remove,NocoBase CLI,delete environment,remove config"
 
 Remove a configured env. This command only deletes CLI env configuration; use [`nb app down`](../app/down.md) to clean up local apps, containers, and storage.
 
+If the removed env is also the current env, the CLI automatically selects a new current env from the remaining envs. If no envs remain, the current env is cleared.
+
 ## Usage
 
 ```bash
@@ -18,7 +20,7 @@ nb env remove <name> [flags]
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `<name>` | string | Env name to remove |
+| `<name>` | string | Configured environment name to remove |
 | `--force`, `-f` | boolean | Skip confirmation and delete directly |
 | `--verbose` | boolean | Show detailed progress |
 
@@ -32,4 +34,5 @@ nb env remove staging -f
 ## Related Commands
 
 - [`nb app down`](../app/down.md)
+- [`nb env current`](./current.md)
 - [`nb env list`](./list.md)

package/dist/ai/docs/nocobase/api/cli/env/status.md

@@ -0,0 +1,52 @@
+---
+title: "nb env status"
+description: "nb env status command reference: show status for the current env, one env, or all envs."
+keywords: "nb env status,NocoBase CLI,environment status,API Base URL"
+---
+
+# nb env status
+
+Show env status. By default it inspects the current env. You can also inspect one named env, or use `--all` to inspect all envs.
+
+This command prints a simplified status table with `Env`, `Status`, and `API Base URL`.
+
+## Usage
+
+```bash
+nb env status [name] [flags]
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `[name]` | string | Configured environment name to inspect; uses the current env if omitted; cannot be used with `--all` |
+| `--all` | boolean | Show status for all configured envs |
+| `--json-output` | boolean | Output the result as JSON |
+
+`[name]` and `--all` cannot be used together.
+
+## Status values
+
+`Status` is the result returned after the CLI checks the target env. Typical values include:
+
+- `ok`: the env is reachable and authenticated
+- `auth failed`: the API is reachable but authentication failed
+- `unreachable`: the target address could not be reached
+- `unconfigured`: the env configuration is incomplete
+- `missing`: the managed app for this env no longer exists
+
+## Examples
+
+```bash
+nb env status
+nb env status app1
+nb env status --all
+nb env status --all --json-output
+```
+
+## Related Commands
+
+- [`nb env current`](./current.md)
+- [`nb env list`](./list.md)
+- [`nb env info`](./info.md)

package/dist/ai/docs/nocobase/api/cli/env/update.md

@@ -18,7 +18,7 @@ nb env update [name] [flags]
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `[name]` | string | Env name; uses the current env if omitted |
+| `[name]` | string | Configured environment name to refresh; uses the current env if omitted |
 | `--verbose` | boolean | Show detailed progress |
 | `--api-base-url` | string | Override the NocoBase API URL and persist it to the target env |
 | `--role` | string | Role override sent as the `X-Role` request header |

package/dist/ai/docs/nocobase/api/cli/env/use.md

@@ -8,6 +8,10 @@ keywords: "nb env use,NocoBase CLI,switch environment,current env"
 
 Switch the current CLI env. Commands that omit `--env` will use this env by default afterward.
 
+When session mode is enabled for the current shell or runtime, this change only affects the current session.
+
+When session mode is not enabled, this falls back to updating the global `last env`. In that case, other terminals or agent runtimes without session isolation may also be affected.
+
 ## Usage
 
 ```bash
@@ -18,7 +22,7 @@ nb env use <name>
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `<name>` | string | Configured env name |
+| `<name>` | string | Configured environment name to switch to |
 
 ## Examples
 
@@ -26,7 +30,13 @@ nb env use <name>
 nb env use local
 ```
 
+## Recommendation
+
+The default recommendation is to run [`nb session setup`](../session/setup.md) once first. That makes `nb env use` behave more like `use dbname` in a database client: switch the current session context first, then run follow-up commands that depend on that env.
+
 ## Related Commands
 
+- [`nb env current`](./current.md)
+- [`nb env status`](./status.md)
 - [`nb env list`](./list.md)
 - [`nb env info`](./info.md)

package/dist/ai/docs/nocobase/api/cli/index.md

@@ -35,11 +35,12 @@ The root command mainly displays help and dispatches execution to command groups
 | [`nb app`](./app/index.md) | Manage NocoBase app runtimes: start, stop, restart, logs, and upgrades. |
 | [`nb config`](./config/index.md) | Manage CLI configuration defaults. |
 | [`nb db`](./db/index.md) | Manage the built-in database for the selected env. |
-| [`nb env`](./env/index.md) | Manage NocoBase project environments, status, details, and command runtimes. |
+| [`nb env`](./env/index.md) | Manage NocoBase project environments, current env, status, details, and command runtimes. |
 | [`nb license`](./license/index.md) | Manage commercial licensing and licensed plugins. |
 | [`nb plugin`](./plugin/index.md) | Manage plugins in the selected NocoBase env. |
 | [`nb scaffold`](./scaffold/index.md) | Generate NocoBase plugin development scaffolds. |
 | [`nb self`](./self/index.md) | Inspect or update the NocoBase CLI itself. |
+| [`nb session`](./session/index.md) | Configure `NB_SESSION_ID` so current env is isolated per shell or agent runtime. |
 | [`nb skills`](./skills/index.md) | Inspect or synchronize NocoBase AI coding skills for the current workspace. |
 | [`nb source`](./source/index.md) | Work with the local NocoBase source project: download, develop, build, and test. |
 
@@ -93,6 +94,8 @@ Connect an existing app:
 
 ```bash
 nb env add app1 --api-base-url http://localhost:13000/api
+nb env current
+nb env status
 ```
 
 Start the app and refresh runtime commands:
@@ -130,6 +133,7 @@ The following environment variables affect CLI behavior:
 | --- | --- |
 | `NB_CLI_ROOT` | Root directory where the CLI stores `.nocobase` config and local app files. Defaults to the current user's home directory. |
 | `NB_LOCALE` | Language for CLI prompts and the local setup UI. Supported values are `en-US` and `zh-CN`. |
+| `NB_SESSION_ID` | Session ID for the current shell or agent runtime. When set, `nb env use` and `nb env current` are isolated per session. |
 
 Example:
 
@@ -154,6 +158,14 @@ After setting `NB_CLI_ROOT=/your/workspace`, the config file path becomes:
 
 The CLI also keeps compatibility with legacy project config under the current working directory.
 
+Current env session cache is stored in:
+
+```text
+.nocobase/sessions/<NB_SESSION_ID>.json
+```
+
+The globally last-used env is stored in the `lastEnv` field in `config.json`. When `NB_SESSION_ID` is not set, the CLI falls back to that global value.
+
 Runtime command cache is stored in:
 
 ```text

package/dist/ai/docs/nocobase/api/cli/license/activate.md

@@ -25,7 +25,7 @@ nb license activate [flags]
 | `--account` | string | License service account for online activation |
 | `--password` | string | License service password for online activation |
 | `--desc` | string | Application name submitted for online activation |
-| `--yes` | boolean | Confirm that the submitted information is true and accurate |
+| `--yes`, `-y` | boolean | When an explicitly passed `--env` targets a different env than the current env, skip the interactive confirmation prompt |
 | `--json` | boolean | Output JSON |
 
 ## Examples
@@ -34,6 +34,7 @@ nb license activate [flags]
 nb license activate --env app1 --key <licenseKey>
 nb license activate --env app1 --key-file ./license.txt
 nb license activate --env app1 --online
+nb license activate --env app1 --online --account aa --password bb --desc test24
 nb license activate --env app1 --online --account aa --password bb --desc test24 --yes
 nb license activate --env app1 --json --key-file ./license.txt
 ```
@@ -42,6 +43,8 @@ nb license activate --env app1 --json --key-file ./license.txt
 
 When online activation is used, the CLI requests a license key from the license service with the current env's instance ID and app URL.
 
+If you explicitly pass `--env` and it differs from the current env, the CLI asks for confirmation first. In non-interactive terminals or AI agent sessions, add `--yes` yourself or run `nb env use <name>` first and try again.
+
 ## Related Commands
 
 - [`nb license id`](./id.md)

package/dist/ai/docs/nocobase/api/cli/license/id.md

@@ -19,6 +19,7 @@ nb license id [flags]
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `--env`, `-e` | string | CLI env name; when omitted, the current env is used |
+| `--yes`, `-y` | boolean | When an explicitly passed `--env` targets a different env than the current env, skip the interactive confirmation prompt |
 | `--force` | boolean | Regenerate the instance ID even when one is already saved |
 | `--json` | boolean | Output JSON |
 
@@ -27,10 +28,13 @@ nb license id [flags]
 ```bash
 nb license id
 nb license id --env app1
+nb license id --env app1 --yes
 nb license id --env app1 --force
 nb license id --env app1 --json
 ```
 
+`--force` only forces regeneration of the instance ID. It does not replace cross-env confirmation; if an explicitly passed `--env` targets a non-current env, you still need confirmation or `--yes`.
+
 ## Related Commands
 
 - [`nb license activate`](./activate.md)

package/dist/ai/docs/nocobase/api/cli/license/plugins/clean.md

@@ -19,8 +19,9 @@ nb license plugins clean [flags]
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `--env`, `-e` | string | CLI env name; when omitted, the current env is used |
+| `--yes`, `-y` | boolean | When an explicitly passed `--env` targets a different env than the current env, skip the interactive confirmation prompt |
 | `--dry-run` | boolean | Preview which plugins would be removed without deleting anything |
-| `--verbose`, `-V` | boolean | Show detailed per-plugin clean logs |
+| `--verbose` | boolean | Show detailed per-plugin clean logs |
 | `--json` | boolean | Output JSON |
 
 ## Examples
@@ -28,11 +29,14 @@ nb license plugins clean [flags]
 ```bash
 nb license plugins clean
 nb license plugins clean --env app1
+nb license plugins clean --env app1 --yes
 nb license plugins clean --env app1 --dry-run
 nb license plugins clean --env app1 --verbose
 nb license plugins clean --env app1 --json
 ```
 
+If you explicitly pass `--env` and it differs from the current env, the CLI asks for confirmation first. In non-interactive terminals or AI agent sessions, add `--yes` yourself or run `nb env use <name>` first and try again.
+
 ## Related Commands
 
 - [`nb license plugins sync`](./sync.md)

package/dist/ai/docs/nocobase/api/cli/license/plugins/list.md

@@ -19,6 +19,7 @@ nb license plugins list [flags]
 | Parameter | Type | Description |
 | --- | --- | --- |
 | `--env`, `-e` | string | CLI env name; when omitted, the current env is used |
+| `--yes`, `-y` | boolean | When an explicitly passed `--env` targets a different env than the current env, skip the interactive confirmation prompt |
 | `--json` | boolean | Output JSON |
 
 ## Examples
@@ -26,9 +27,12 @@ nb license plugins list [flags]
 ```bash
 nb license plugins list
 nb license plugins list --env app1
+nb license plugins list --env app1 --yes
 nb license plugins list --env app1 --json
 ```
 
+If you explicitly pass `--env` and it differs from the current env, the CLI asks for confirmation first. In non-interactive terminals or AI agent sessions, add `--yes` yourself or run `nb env use <name>` first and try again.
+
 ## Related Commands
 
 - [`nb license plugins sync`](./sync.md)