从 v1/v2 升级到 v3
CloudBase CLI v3.0 在 v1/v2 基础上进行了功能扩充和部分命令整合，同时完全兼容 v1/v2 中已有的命令格式。
升级操作
npm install -g @cloudbase/cli
查看当前版本：
tcb --version
v3.0 重要变更
新增模块
v3.0 新增了以下顶级命令模块：
| 新命令 | 说明 |
|---|---|
tcb cors | 安全域名管理（Web SDK 白名单） |
tcb domains | 自定义域名管理（HTTP 访问服务，需 SSL 证书） |
tcb routes | HTTP 服务路由管理 |
tcb agent | AI Agent 管理 |
tcb app | 应用部署管理 |
tcb logs | 日志搜索 |
tcb secrets | 密钥管理 |
tcb user | 用户管理 |
tcb permission | 权限管理 |
tcb role | 角色管理 |
tcb api | API 管理 |
tcb db | 数据库管理 |
环境 ID 解析优先级
v3.0 引入了 tcb env use 全局默认环境配置，环境 ID 的解析优先级为（低 → 高）：
全局配置（tcb env use）< 项目 cloudbaserc.json < 命令行 -e / --env-id
即：命令行参数 -e 始终优先，其次是项目配置文件，最后才是全局默认环境。
已移除模块
以下模块在 v3.0 中完全移除，不再支持：
tcb fun — 函数式托管（已移除）
tcb fun list、tcb fun deploy、tcb fun run 等命令已移除。函数式托管能力已整合进 tcb cloudrun：
| 旧命令（已移除） | 替代命令 |
|---|---|
tcb fun list | tcb cloudrun list |
tcb fun deploy | tcb cloudrun deploy |
tcb fun run | tcb cloudrun run |
tcb run standalonegateway — 独立网关（已移除）
tcb run standalonegateway create/destroy/list/package/turn 等命令已移除，无替代命令。相关能力请参考云托管控制台。
废弃命令（兼容保留，建议迁移）
以下命令仍可用，但已标记为废弃，未来版本可能移除：
云函数（fn）
| 旧命令格式（废弃） | 新命令格式（推荐） |
|---|---|
tcb functions:deploy | tcb fn deploy |
tcb functions:list | tcb fn list |
tcb functions:delete | tcb fn delete |
tcb functions:detail | tcb fn detail |
tcb functions:invoke | tcb fn invoke |
tcb functions:log | tcb fn log |
tcb functions:copy | tcb fn cp |
tcb functions:download | tcb fn code download |
tcb functions:code:update | tcb fn code update |
tcb functions:config:update | tcb fn config update |
tcb functions:trigger:create | tcb fn trigger create |
tcb functions:trigger:delete | tcb fn trigger delete |
tcb functions:run | tcb fn run |
云存储（storage）
| 旧命令格式（废弃） | 新命令格式（推荐） |
|---|---|
tcb storage:upload | tcb storage upload |
tcb storage:download | tcb storage download |
tcb storage:delete | tcb storage rm |
tcb storage:list | tcb storage list |
tcb storage:url | tcb storage url |
tcb storage:detail | tcb storage detail |
tcb storage:get-acl | tcb permission |
tcb storage:set-acl | tcb permission |
静态网站托管（hosting）
| 旧命令格式（废弃） | 新命令格式（推荐） |
|---|---|
tcb hosting:detail | tcb hosting detail |
tcb hosting:deploy | tcb hosting deploy |
tcb hosting:delete | tcb hosting delete |
tcb hosting:list | tcb hosting list |
HTTP 访问服务（service）
tcb service 系列命令已废弃，相关能力由以下命令取代：
| 旧能力 | 新命令 |
|---|---|
| 安全域名白名单 | tcb cors add/list/rm |
| 绑定/解绑自定义域名 | tcb domains add/ls/rm |
| 创建/管理路由规则 | tcb routes add/list/edit/delete |
数据模型（db）
| 旧命令（废弃） | 新命令（推荐） |
|---|---|
tcb db list | tcb db model list |
tcb db pull | tcb db model pull |
tcb db push | tcb db model push |
云托管（run）
以下顶层命令已标记为废弃，请使用 tcb cloudrun 系列命令：
| 旧命令（废弃） | 说明 |
|---|---|
tcb run list | 已废弃，使用 tcb cloudrun list |
tcb run delete | 已废弃，使用 tcb cloudrun delete |