核心能力与定位
CloudBase（腾讯云开发，TCB）是面向小程序、Web/H5 及原生应用的一体化 Serverless 开发平台，提供从基础设施到 AI 能力的全栈支持。核心模块包括：
1. 前端与托管：静态网站托管（独立子域名）、Web 应用一键部署（React/Vue/Next/Nuxt 等）、小程序原生 SDK（wx.cloud）。
2. 数据库层：
3. 计算层：
4. AI 与大模型：
5. 身份与权限：匿名登录（默认关闭）、微信登录（小程序 OPENID）、OAuth、用户名密码、自定义 auth；Web 端 auth.getSession()，管理端 queryAppAuth / manageAppAuth。
- NoSQL 文档数据库（JS SDK v3
app.database()） - MySQL 关系型数据库（管理面
queryMysqlDatabase/ 应用面executeWriteSQL） - CloudBase PG（PostgreSQL，应用面
app.rdb()/queryPgDatabase/managePgDatabase，支持 PostgREST 与 RLS） - 云函数（SCF）：Event 触发（
exports.main）或 HTTP 函数（scf_bootstrap，端口 9000） - CloudRun 云托管：容器化部署，支持 Dockerfile 自定义运行时
- TokenHub 资源包（Token Credits）与小程序成长计划双重配额体系
- 内置模型：
generateText/streamText/generateImage，支持 Hunyuan、DeepSeek、GLM 等 - 智能体开发：AG-UI 协议、LangGraph/LangChain 集成、SSE 流式输出
显著优点
- 零运维 Serverless：自动扩缩容，按量计费，新用户 3000 资源点/月免费额度。
- 平台深度集成：小程序
wx.cloud原生无缝；Web SDK 支持 CDN 与 npm 双渠道。 - AI 原生：内置大模型调用链，TokenHub 统一管理多厂商配额，流式输出与图片生成开箱即用。
- 多数据库选型：同一环境可共存 NoSQL、MySQL、PG，PG 支持向量扩展（pgvector）与行级安全（RLS）。
- DevOps 闭环：MCP 工具链支持（
mcporter/ IDE 原生 MCP），基础设施即代码，支持巡检诊断与日志分析。
潜在局限与风险
| 局限 | 说明 |
|------|------|
AI 配额门槛 | 必须先开通 Token Credits 资源包或报名小程序成长计划，否则 generateText 等调用失败；需主动执行 DescribeEnvPostpayPackage / DescribeActivityInfo 前置检查。 |
| **认证域分离** | 管理端（`auth`）与应用端（`queryAppAuth`）API 易混淆；Web 端禁用 `getLoginState` 等废弃接口。 |
| **数据库路由陷阱** | PG 任务若误用 `app.database()` / `db.collection` 或 MySQL 路径会导致权限错误；必须区分 `app.rdb()`（PG）与 `executeWriteSQL`（MySQL）。 |
| **冷启动** | 云函数与 CloudRun 默认冷启动明显，需设置 `MinNum≥1` 或预置并发。 |
| **部署限制** | 新 Web 项目首次部署**禁止**使用 `manageHosting`（共享域名），必须用 `manageApps` 获取独立子域名。 |
适合人群
- 小程序开发者：需云数据库、云函数、AI 能力且免后端运维。
- Web 全栈团队：React/Vue 前端 + Serverless 后端，追求快速上线与自动扩缩容。
- AI 应用开发者：需要集成多厂商大模型、构建流式对话或 Agent 智能体。
- 原型/低代码场景：静态托管 + 云数据库 + 内置登录，小时级交付 MVP。
常规风险与合规建议
1. MCP 前置：所有管理操作（建表、部署、配 auth）必须先配置 CloudBase MCP，否则工具调用全失败。
2. EnvId 显式化：禁止依赖 CLI 隐式环境，代码与配置中必须显式写入 EnvId。
3. 类型安全：禁止用 any 绕过 TS 检查；AI 模型参数需区分 GroupName（cloudbase / hunyuan-exp / custom-*）与具体 model ID。
4. 安全规则：数据库访问需配置 resource policy 与 RLS，避免前端直接暴露高权限密钥。
5. 审计与回滚：利用 cloudbase-code-review 与 MCP 的 ops-inspector 做上线前巡检与日志诊断。