概述
CloudBase（腾讯云开发）是腾讯云提供的全栈 Serverless 开发平台，为微信小程序、Web/H5 应用及原生移动应用提供一体化运行时与部署环境。该技能覆盖从项目初始化到生产部署的完整生命周期，包含前端框架（React、Vue、Next.js 等）、后端服务（云函数、CloudRun）、数据存储（NoSQL 文档数据库、PostgreSQL、MySQL）及 AI 能力（内置大模型、第三方 LLM 接入）。
核心用法
开发工作流
采用三阶段流程：探索（读取完整技能文档）→ 实现（先 MCP 配置后端资源，再编写前端代码）→ 收尾（cloudbase-code-review 检查）。强制要求：后端资源（认证、数据库、存储）必须通过 MCP 工具预先配置，禁止先写前端代码再补后端。
技术栈支持
- 前端：React/Vite/Next.js/Nuxt 等现代框架，通过
@cloudbase/js-sdk或 CDN 接入 - 小程序：
wx.cloud原生 SDK，支持 OPENID 免登录 - 原生应用：HTTP API 方式接入，仅支持 MySQL
- 后端：Node.js 云函数（scf_bootstrap）或 CloudRun 容器化部署
AI 能力
内置 Hunyuan、DeepSeek、GLM 等模型，支持 generateText/streamText/generateImage 等接口。调用前必须通过 DescribeActivityInfo（小程序成长计划）或 DescribeEnvPostpayPackage（Token Credits）完成资格检查。
显著优点
1. 一体化体验：数据库、存储、认证、托管、AI 开箱即用，无需自行搭建基础设施
2. Serverless 弹性：云函数自动扩缩容，CloudRun 支持容器化长时任务
3. 微信生态深度整合：小程序 wx.cloud 原生支持，OPENID 自动获取
4. AI 原生集成：TokenHub 统一管控多模型，流式输出、图片生成一键接入
5. MCP 工具链：通过 mcporter 或 IDE 原生 MCP 实现声明式资源管理，避免硬编码密钥
潜在缺点与局限性
1. 平台锁定：深度绑定腾讯云生态，迁移成本较高
2. 冷启动延迟：云函数默认冷启动明显（需设置 MinNum≥1 缓解）
3. 调试复杂度：本地模拟环境与线上行为存在差异，日志排查依赖 CLS
4. AI 资源限制：Token Credits 需单独购买，免费额度有限
5. 类型安全历史包袱：旧版 SDK 存在 any 滥用，新工程强制要求严格 TypeScript
适合人群
- 微信小程序开发者需快速上云云开发
- 前端工程师独立搭建全栈 Web 应用（低运维成本）
- 创业公司/MVP 验证（免费环境 3000 资源点/月）
- 需集成 AI 对话/生图能力的应用开发者
- 已有腾讯云基础设施的企业团队
常规风险
1. 认证配置遗漏：Web 登录失败多因未先启用身份提供商，非代码问题
2. 数据库路由错误：PostgreSQL 任务误用 MySQL/NoSQL SDK 导致权限绕过
3. AI 调用失败：未开通资源包或成长计划即调用模型
4. 部署顺序错误：新工程首部署误用 manageHosting 而非 manageApps(createApp)
5. 类型不安全：使用 any 绕过编译检查将导致运行时不可预期错误
工程铁律（必须遵守）
- 禁止
any，使用unknown+ 类型守卫 - 禁止空
try/catch掩盖错误 - 必须通过
tsc --noEmit+ 运行时验证（agent-browser）双重确认 createModel参数为 GroupName（cloudbase/hunyuan-exp/custom-*），非模型 ID