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

package/dist/locale/en-US.json

@@ -168,6 +168,150 @@
         "refusal": "Refusing to run against env \"{{requestedEnv}}\" because the current env is \"{{currentEnv}}\" and interactive confirmation is unavailable in the current agent session.\n\nFor safety, the agent will not switch envs automatically and will not add --yes on your behalf.\n\nTo continue:\n- run `nb env use {{requestedEnv}}` yourself and then re-run the command, or\n- re-run the same command with `--env {{requestedEnv}} --yes` to confirm this one-off cross-env operation."
       }
     },
+    "portalCreate": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "templateInvalidDirectory": "Portal template \"{{source}}\" is invalid: expected a directory.",
+        "localTemplateMissing": "Portal template directory does not exist: {{source}}",
+        "templateUnresolved": "Portal template \"{{source}}\" could not be resolved. {{details}}",
+        "templateDownloadFailed": "Failed to download portal template \"{{source}}\" with npm pack. {{details}}",
+        "templateExtractFailed": "Failed to extract portal template \"{{source}}\": {{details}}",
+        "templateMissingPackageJson": "Portal template \"{{source}}\" is invalid: package.json is missing.",
+        "npmPackNoTarball": "npm pack did not produce a local tarball for {{source}}.",
+        "npmPackMultipleTarballs": "npm pack produced multiple tarballs for {{source}}.",
+        "invalidPortalName": "Invalid portal name \"{{value}}\". Use lowercase letters, numbers, underscores, or hyphens, and start with a lowercase letter or number.",
+        "invalidPortalAppName": "Invalid portal app name \"{{value}}\" from apiBaseUrl. Use letters, numbers, underscores, or hyphens, and start with a letter or number.",
+        "missingApiBaseUrl": "Cannot create a portal because the selected env has no apiBaseUrl.",
+        "outsideParent": "Refusing to modify a portal outside {{parentDir}}: {{portalDir}}",
+        "sshUnsupported": "Cannot create a portal for ssh envs in the first version.",
+        "workspaceExists": "Portal already exists: {{portalDir}}\nPass --force to delete it and create a new portal."
+      },
+      "messages": {
+        "skipInstall": "Skipped pnpm install because package.json was not found in {{portalDir}}.",
+        "created": "Portal \"{{portal}}\" created at {{portalDir}}.",
+        "app": "App: {{app}}",
+        "base": "Base: {{base}}",
+        "sourceStorage": "Source storage: {{sourceStorage}}"
+      }
+    },
+    "portalConfig": {
+      "errors": {
+        "invalidSourceStorage": "Invalid source storage \"{{value}}\". Use \"nocobase\" or \"git\".",
+        "invalidGitPath": "--git-path must be a relative path inside the Git repository.",
+        "gitOptionsForNocobaseStorage": "--git-repo, --git-branch, and --git-path can only be used with --source-storage git.",
+        "gitRepoRequired": "--git-repo is required when --source-storage is git.",
+        "gitRepoInvalid": "--git-repo must be a full Git remote URL.",
+        "updateFailed": "Portal config update failed with status {{status}}\n{{details}}"
+      }
+    },
+    "portalConfigure": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "noChanges": "No portal configuration changes were provided. Pass --source-storage or a --git-* flag.",
+        "workspaceMissing": "Portal does not exist: {{portalDir}}\nRun `nb portal create {{portal}}` or `nb portal pull {{portal}}` first."
+      },
+      "messages": {
+        "updated": "Portal \"{{portal}}\" configuration updated at {{portalDir}}/portal.config.json.",
+        "remoteSynced": "Remote portal record: synced",
+        "remoteSkipped": "Remote portal record: not found; local config only"
+      }
+    },
+    "portalDeploy": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "workspaceMissing": "Portal does not exist: {{portalDir}}\nRun `nb portal create {{portal}}` first.",
+        "packageJsonMissing": "Portal is invalid: package.json is missing in {{portalDir}}.",
+        "distMissing": "Portal build did not produce {{distDir}}/index.html.",
+        "unsupportedEnvKind": "Cannot deploy a portal for {{kind}} envs in the first version.",
+        "uploadFailed": "Portal dist upload failed with status {{status}}\n{{details}}",
+        "recordSyncFailed": "Portal record sync failed with status {{status}}\n{{details}}"
+      },
+      "messages": {
+        "deployed": "Portal \"{{portal}}\" deployed.",
+        "mode": "Mode: {{mode}}",
+        "app": "App: {{app}}",
+        "base": "Base: {{base}}",
+        "record": "Record: synced",
+        "dist": "Dist: {{dist}}",
+        "localDist": "Local dist: {{dist}}",
+        "serverDist": "Server dist: {{dist}}"
+      }
+    },
+    "portalList": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "unsupportedEnvKind": "Cannot list portals for {{kind}} envs in the first version.",
+        "listFailed": "Portal list failed with status {{status}}\n{{details}}"
+      },
+      "messages": {
+        "empty": "No portal records found."
+      },
+      "table": {
+        "name": "Name",
+        "url": "URL",
+        "portalType": "Portal type",
+        "path": "Local path",
+        "enabled": "Enabled",
+        "localSynced": "Local synced"
+      }
+    },
+    "portalInfo": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "notFound": "Portal \"{{portal}}\" was not found."
+      },
+      "fields": {
+        "name": "Name",
+        "url": "URL",
+        "portalType": "Portal type",
+        "path": "Local path",
+        "enabled": "Enabled",
+        "localSynced": "Local synced"
+      }
+    },
+    "portalDestroy": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "confirmationRequired": "Refusing to destroy a portal in non-interactive mode without --yes.",
+        "outsideParent": "Refusing to delete a portal outside {{parentDir}}: {{portalDir}}",
+        "workspaceMissing": "Portal does not exist: {{portalDir}}\nPass --force to ignore missing local files.",
+        "unsupportedEnvKind": "Cannot destroy a portal for {{kind}} envs in the first version.",
+        "recordDestroyFailed": "Portal record destroy failed with status {{status}}\n{{details}}"
+      },
+      "prompts": {
+        "confirm": "Destroy portal \"{{portal}}\" and delete its storage directory?"
+      },
+      "messages": {
+        "destroyed": "Portal \"{{portal}}\" destroyed.",
+        "mode": "Mode: {{mode}}",
+        "app": "App: {{app}}",
+        "base": "Base: {{base}}",
+        "record": "Record: {{status}}",
+        "workspace": "Portal files: {{status}} ({{dir}})"
+      }
+    },
+    "portalDev": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "workspaceMissing": "Portal does not exist: {{portalDir}}\nRun `nb portal create {{portal}}` first.",
+        "packageJsonMissing": "Portal is invalid: package.json is missing in {{portalDir}}.",
+        "sshUnsupported": "Cannot start a portal in dev mode for ssh envs in the first version."
+      },
+      "messages": {
+        "starting": "Starting portal \"{{portal}}\"...",
+        "mode": "Mode: {{mode}}",
+        "app": "App: {{app}}",
+        "base": "Base: {{base}}",
+        "dir": "Dir: {{dir}}"
+      }
+    },
     "license": {
       "activate": {
         "interactive": {
@@ -341,6 +485,21 @@
           "message": "App subpath (for example, /nocobase/)",
           "placeholder": "/ or /nocobase/"
         },
+        "portalType": {
+          "message": "Portal type",
+          "noCodeLabel": "No-code portal",
+          "noCodeHint": "Create with visual configuration. AI can help adjust the configuration. Path: /v/<name>",
+          "aiLabel": "AI portal",
+          "aiHint": "Create with AI Agent and code. Users can request changes in natural language. Path: /x/<name>"
+        },
+        "portalName": {
+          "message": "Portal name",
+          "placeholder": "admin"
+        },
+        "portalTemplate": {
+          "message": "Starter template (copied to ./storage/portals/)",
+          "placeholder": "git@github.com:nocobase/admin-starter.git"
+        },
         "storagePath": {
           "message": "Uploads and local files directory",
           "placeholder": "./<env>/storage/"
@@ -440,6 +599,21 @@
         },
         "skipDownload": {
           "message": "Skip downloading NocoBase and reuse existing local app files or Docker images"
+        },
+        "portalType": {
+          "message": "Portal type",
+          "noCodeLabel": "No-code portal",
+          "noCodeHint": "Create with visual configuration. AI can help adjust the configuration. Path: /v/<name>",
+          "aiLabel": "AI portal",
+          "aiHint": "Create with AI Agent and code. Users can request changes in natural language. Path: /x/<name>"
+        },
+        "portalName": {
+          "message": "Portal name",
+          "placeholder": "admin"
+        },
+        "portalTemplate": {
+          "message": "Starter template (copied to ./storage/portals/)",
+          "placeholder": "git@github.com:nocobase/admin-starter.git"
         }
       },
       "webUi": {
@@ -462,6 +636,10 @@
           "title": "App source and version",
           "description": "Choose how to get the app and which source and version to use."
         },
+        "portalType": {
+          "title": "Configure portal",
+          "description": "Set the default portal name and type."
+        },
         "configureDatabase": {
           "title": "Configure the database",
           "description": "Use built-in or custom."

package/dist/locale/zh-CN.json

@@ -168,6 +168,150 @@
         "refusal": "拒绝对 env \"{{requestedEnv}}\" 执行该命令，因为当前 env 是 \"{{currentEnv}}\"，且当前 agent 会话无法进行交互确认。\n\n出于安全考虑，agent 不会自动切换 env，也不会替你自动补上 --yes。\n\n如果要继续：\n- 请先自行执行 `nb env use {{requestedEnv}}`，然后重新运行该命令，或\n- 使用相同命令并追加 `--env {{requestedEnv}} --yes`，以确认这是一次性的跨 env 操作。"
       }
     },
+    "portalCreate": {
+      "errors": {
+        "envNotConfigured": "env \"{{envName}}\" 尚未配置。请先运行 `nb env add {{envName}} --api-base-url <url>`。",
+        "noEnvConfigured": "还没有配置 NocoBase env。请先运行 `nb init --ui` 创建一个。",
+        "templateInvalidDirectory": "Portal 模板 \"{{source}}\" 无效：需要是一个目录。",
+        "localTemplateMissing": "Portal 模板目录不存在：{{source}}",
+        "templateUnresolved": "无法解析 Portal 模板 \"{{source}}\"。{{details}}",
+        "templateDownloadFailed": "无法通过 npm pack 下载 Portal 模板 \"{{source}}\"。{{details}}",
+        "templateExtractFailed": "解压 Portal 模板 \"{{source}}\" 失败：{{details}}",
+        "templateMissingPackageJson": "Portal 模板 \"{{source}}\" 无效：缺少 package.json。",
+        "npmPackNoTarball": "npm pack 没有为 {{source}} 生成本地 tarball。",
+        "npmPackMultipleTarballs": "npm pack 为 {{source}} 生成了多个 tarball。",
+        "invalidPortalName": "Portal 名称 \"{{value}}\" 无效。请使用小写字母、数字、下划线或连字符，并以小写字母或数字开头。",
+        "invalidPortalAppName": "从 apiBaseUrl 解析出的 Portal app 名称 \"{{value}}\" 无效。请使用字母、数字、下划线或连字符，并以字母或数字开头。",
+        "missingApiBaseUrl": "无法创建 Portal，因为当前 env 没有 apiBaseUrl。",
+        "outsideParent": "拒绝修改 {{parentDir}} 之外的 Portal：{{portalDir}}",
+        "sshUnsupported": "第一版暂不支持为 ssh env 创建 Portal。",
+        "workspaceExists": "Portal 已存在：{{portalDir}}\n如需删除并重新创建，请追加 --force。"
+      },
+      "messages": {
+        "skipInstall": "未找到 {{portalDir}}/package.json，已跳过 pnpm install。",
+        "created": "Portal \"{{portal}}\" 已创建：{{portalDir}}。",
+        "app": "App：{{app}}",
+        "base": "Base：{{base}}",
+        "sourceStorage": "源码存储：{{sourceStorage}}"
+      }
+    },
+    "portalConfig": {
+      "errors": {
+        "invalidSourceStorage": "源码存储 \"{{value}}\" 无效。请使用 \"nocobase\" 或 \"git\"。",
+        "invalidGitPath": "--git-path 必须是 Git 仓库内的相对路径。",
+        "gitOptionsForNocobaseStorage": "--git-repo、--git-branch 和 --git-path 只能与 --source-storage git 一起使用。",
+        "gitRepoRequired": "--source-storage 为 git 时必须提供 --git-repo。",
+        "gitRepoInvalid": "--git-repo 必须是完整的 Git remote URL。",
+        "updateFailed": "Portal 配置更新失败，状态码 {{status}}\n{{details}}"
+      }
+    },
+    "portalConfigure": {
+      "errors": {
+        "envNotConfigured": "env \"{{envName}}\" 尚未配置。请先运行 `nb env add {{envName}} --api-base-url <url>`。",
+        "noEnvConfigured": "还没有配置 NocoBase env。请先运行 `nb init --ui` 创建一个。",
+        "noChanges": "没有提供 Portal 配置变更。请传入 --source-storage 或 --git-* 参数。",
+        "workspaceMissing": "Portal 不存在：{{portalDir}}\n请先运行 `nb portal create {{portal}}` 或 `nb portal pull {{portal}}`。"
+      },
+      "messages": {
+        "updated": "Portal \"{{portal}}\" 配置已更新：{{portalDir}}/portal.config.json。",
+        "remoteSynced": "远端 Portal 记录：已同步",
+        "remoteSkipped": "远端 Portal 记录：未找到，仅更新本地配置"
+      }
+    },
+    "portalDeploy": {
+      "errors": {
+        "envNotConfigured": "env \"{{envName}}\" 尚未配置。请先运行 `nb env add {{envName}} --api-base-url <url>`。",
+        "noEnvConfigured": "还没有配置 NocoBase env。请先运行 `nb init --ui` 创建一个。",
+        "workspaceMissing": "Portal 不存在：{{portalDir}}\n请先运行 `nb portal create {{portal}}`。",
+        "packageJsonMissing": "Portal 无效：{{portalDir}} 中缺少 package.json。",
+        "distMissing": "Portal build 没有生成 {{distDir}}/index.html。",
+        "unsupportedEnvKind": "第一版暂不支持为 {{kind}} env 部署 Portal。",
+        "uploadFailed": "Portal dist 上传失败，状态码 {{status}}\n{{details}}",
+        "recordSyncFailed": "Portal 记录同步失败，状态码 {{status}}\n{{details}}"
+      },
+      "messages": {
+        "deployed": "Portal \"{{portal}}\" 已部署。",
+        "mode": "Mode：{{mode}}",
+        "app": "App：{{app}}",
+        "base": "Base：{{base}}",
+        "record": "记录：已同步",
+        "dist": "Dist：{{dist}}",
+        "localDist": "本地 dist：{{dist}}",
+        "serverDist": "服务端 dist：{{dist}}"
+      }
+    },
+    "portalList": {
+      "errors": {
+        "envNotConfigured": "env \"{{envName}}\" 尚未配置。请先运行 `nb env add {{envName}} --api-base-url <url>`。",
+        "noEnvConfigured": "还没有配置 NocoBase env。请先运行 `nb init --ui` 创建一个。",
+        "unsupportedEnvKind": "第一版暂不支持为 {{kind}} env 列出 Portal。",
+        "listFailed": "Portal 列表获取失败，状态码 {{status}}\n{{details}}"
+      },
+      "messages": {
+        "empty": "没有找到 Portal 记录。"
+      },
+      "table": {
+        "name": "名称",
+        "url": "访问 URL",
+        "portalType": "Portal 类型",
+        "path": "本地路径",
+        "enabled": "启用",
+        "localSynced": "本地已同步"
+      }
+    },
+    "portalInfo": {
+      "errors": {
+        "envNotConfigured": "env \"{{envName}}\" 尚未配置。请先运行 `nb env add {{envName}} --api-base-url <url>`。",
+        "noEnvConfigured": "还没有配置 NocoBase env。请先运行 `nb init --ui` 创建一个。",
+        "notFound": "Portal \"{{portal}}\" 不存在。"
+      },
+      "fields": {
+        "name": "名称",
+        "url": "访问 URL",
+        "portalType": "Portal 类型",
+        "path": "本地路径",
+        "enabled": "启用",
+        "localSynced": "本地已同步"
+      }
+    },
+    "portalDestroy": {
+      "errors": {
+        "envNotConfigured": "env \"{{envName}}\" 尚未配置。请先运行 `nb env add {{envName}} --api-base-url <url>`。",
+        "noEnvConfigured": "还没有配置 NocoBase env。请先运行 `nb init --ui` 创建一个。",
+        "confirmationRequired": "非交互模式下拒绝删除 Portal。请追加 --yes 后重试。",
+        "outsideParent": "拒绝删除 {{parentDir}} 之外的 Portal：{{portalDir}}",
+        "workspaceMissing": "Portal 不存在：{{portalDir}}\n如需忽略本地文件缺失，请追加 --force。",
+        "unsupportedEnvKind": "第一版暂不支持为 {{kind}} env 删除 Portal。",
+        "recordDestroyFailed": "Portal 记录删除失败，状态码 {{status}}\n{{details}}"
+      },
+      "prompts": {
+        "confirm": "删除 Portal \"{{portal}}\" 并移除它的 storage 目录？"
+      },
+      "messages": {
+        "destroyed": "Portal \"{{portal}}\" 已删除。",
+        "mode": "Mode：{{mode}}",
+        "app": "App：{{app}}",
+        "base": "Base：{{base}}",
+        "record": "记录：{{status}}",
+        "workspace": "Portal：{{status}}（{{dir}}）"
+      }
+    },
+    "portalDev": {
+      "errors": {
+        "envNotConfigured": "env \"{{envName}}\" 尚未配置。请先运行 `nb env add {{envName}} --api-base-url <url>`。",
+        "noEnvConfigured": "还没有配置 NocoBase env。请先运行 `nb init --ui` 创建一个。",
+        "workspaceMissing": "Portal 不存在：{{portalDir}}\n请先运行 `nb portal create {{portal}}`。",
+        "packageJsonMissing": "Portal 无效：{{portalDir}} 中缺少 package.json。",
+        "sshUnsupported": "第一版暂不支持为 ssh env 启动 Portal 开发服务。"
+      },
+      "messages": {
+        "starting": "正在启动 Portal \"{{portal}}\"...",
+        "mode": "Mode：{{mode}}",
+        "app": "App：{{app}}",
+        "base": "Base：{{base}}",
+        "dir": "目录：{{dir}}"
+      }
+    },
     "license": {
       "activate": {
         "interactive": {
@@ -341,6 +485,21 @@
           "message": "应用子路径（例如 /nocobase/）",
           "placeholder": "/ 或 /nocobase/"
         },
+        "portalType": {
+          "message": "Portal 类型",
+          "noCodeLabel": "无代码 Portal",
+          "noCodeHint": "通过可视化配置创建，AI 可以协助调整配置。访问路径：/v/<name>",
+          "aiLabel": "AI Portal",
+          "aiHint": "通过 AI Agent 和代码创建，可用自然语言提出修改要求。访问路径：/x/<name>"
+        },
+        "portalName": {
+          "message": "Portal 名称",
+          "placeholder": "admin"
+        },
+        "portalTemplate": {
+          "message": "起始模板（将复制到 ./storage/portals/）",
+          "placeholder": "git@github.com:nocobase/admin-starter.git"
+        },
         "storagePath": {
           "message": "上传文件和本地存储目录",
           "placeholder": "./<env>/storage/"
@@ -440,6 +599,21 @@
         },
         "skipDownload": {
           "message": "跳过下载 NocoBase，直接复用已有的本地应用文件或 Docker 镜像"
+        },
+        "portalType": {
+          "message": "Portal 类型",
+          "noCodeLabel": "无代码 Portal",
+          "noCodeHint": "通过可视化配置创建，AI 可以协助调整配置。访问路径：/v/<name>",
+          "aiLabel": "AI Portal",
+          "aiHint": "通过 AI Agent 和代码创建，可用自然语言提出修改要求。访问路径：/x/<name>"
+        },
+        "portalName": {
+          "message": "Portal 名称",
+          "placeholder": "admin"
+        },
+        "portalTemplate": {
+          "message": "起始模板（将复制到 ./storage/portals/）",
+          "placeholder": "git@github.com:nocobase/admin-starter.git"
         }
       },
       "webUi": {
@@ -462,6 +636,10 @@
           "title": "应用来源和版本",
           "description": "选择应用的获取方式，以及要使用的来源和版本。"
         },
+        "portalType": {
+          "title": "配置 Portal",
+          "description": "设置默认 Portal 的标识和类型。"
+        },
         "configureDatabase": {
           "title": "配置数据库",
           "description": "选择内置数据库或自定义数据库。"

package/nocobase-ctl.config.json

@@ -202,6 +202,117 @@
         }
       }
     },
+    "ai": {
+      "name": "ai",
+      "description": "Discover LLM providers and manage LLM services and AI employees.",
+      "include": true,
+      "resources": {
+        "includes": ["ai", "llmServices", "aiEmployees"],
+        "excludes": [],
+        "overrides": {
+          "ai": {
+            "name": "llm-providers",
+            "description": "Discover providers and models and test unsaved LLM settings.",
+            "topLevel": false,
+            "operations": {
+              "includes": [
+                "ai:listLLMProviders",
+                "ai:listProviderModels",
+                "ai:testFlight",
+                "ai:listModels",
+                "ai:listLLMServices"
+              ]
+            }
+          },
+          "llmServices": {
+            "name": "llm-services",
+            "description": "Manage saved LLM service configurations.",
+            "topLevel": false,
+            "operations": {
+              "includes": [
+                "llmServices:list",
+                "llmServices:get",
+                "llmServices:create",
+                "llmServices:update",
+                "llmServices:destroy"
+              ]
+            }
+          },
+          "aiEmployees": {
+            "name": "employees",
+            "description": "Manage AI employees.",
+            "topLevel": false,
+            "operations": {
+              "includes": [
+                "aiEmployees:list",
+                "aiEmployees:get",
+                "aiEmployees:create",
+                "aiEmployees:update",
+                "aiEmployees:destroy"
+              ]
+            }
+          }
+        }
+      }
+    },
+    "kb": {
+      "name": "kb",
+      "description": "Manage vector databases, knowledge bases, documents, vectorization, and retrieval tests.",
+      "include": true,
+      "resources": {
+        "includes": ["aiVectorDatabases", "aiKnowledgeBase", "aiKnowledgeBaseDocs"],
+        "excludes": [],
+        "overrides": {
+          "aiVectorDatabases": {
+            "name": "vector-databases",
+            "description": "Manage vector database connections.",
+            "topLevel": false,
+            "operations": {
+              "includes": [
+                "aiVectorDatabases:listProviders",
+                "aiVectorDatabases:testConnection",
+                "aiVectorDatabases:list",
+                "aiVectorDatabases:get",
+                "aiVectorDatabases:create",
+                "aiVectorDatabases:update",
+                "aiVectorDatabases:destroy"
+              ]
+            }
+          },
+          "aiKnowledgeBase": {
+            "name": "kb",
+            "segments": ["kb"],
+            "description": "Manage knowledge bases and retrieval tests.",
+            "topLevel": true,
+            "operations": {
+              "includes": [
+                "aiKnowledgeBase:list",
+                "aiKnowledgeBase:get",
+                "aiKnowledgeBase:create",
+                "aiKnowledgeBase:update",
+                "aiKnowledgeBase:destroy",
+                "aiKnowledgeBase:runHitTest",
+                "aiKnowledgeBase:listExternalVectorStoreProviders"
+              ]
+            }
+          },
+          "aiKnowledgeBaseDocs": {
+            "name": "documents",
+            "description": "Manage knowledge base documents and vectorization.",
+            "topLevel": false,
+            "operations": {
+              "includes": [
+                "aiKnowledgeBaseDocs:list",
+                "aiKnowledgeBaseDocs:get",
+                "aiKnowledgeBaseDocs:upload",
+                "aiKnowledgeBaseDocs:vectorization",
+                "aiKnowledgeBaseDocs:destroy"
+              ]
+            }
+          }
+        }
+      }
+    },
     "flow-engine": {
       "name": "flow-engine",
       "description": "Manage flow surface composition, configuration, layout, and mutation APIs.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nocobase/cli",
-  "version": "2.3.0-alpha.1",
+  "version": "3.0.0-alpha.1",
   "description": "NocoBase Command Line Tool",
   "type": "module",
   "main": "dist/generated/command-registry.js",
@@ -71,6 +71,9 @@
       "backup": {
         "description": "Create and restore NocoBase backups."
       },
+      "portal": {
+        "description": "Manage portals."
+      },
       "skills": {
         "description": "Inspect or synchronize NocoBase AI coding skills for the current workspace."
       },
@@ -144,5 +147,5 @@
     "type": "git",
     "url": "git+https://github.com/nocobase/nocobase.git"
   },
-  "gitHead": "2377df8ceb12549149017f7f14a61207bf6e49a2"
+  "gitHead": "22d8be8ece179cfa5c8a4ebb2c896c92bd418e03"
 }