Cloudbase

核心用途

CloudBase 技能是面向腾讯云开发（Tencent CloudBase, TCB）的专业开发指南，支持 Web 应用（React/Vue/Next.js 等）、微信小程序、uni-app、原生移动端（iOS/Android/Flutter/React Native）的全栈开发与部署。

核心功能模块

• 身份认证：内置匿名、微信、邮箱、短信、OAuth 等多端登录方案，支持 Web SDK 与 HTTP API 双通道
• 数据库服务：NoSQL 文档数据库 + PostgreSQL/MySQL 关系型数据库双引擎，支持 SDK 直连、安全规则、RLS 行级权限
• 云函数（SCF）：事件驱动与 HTTP 双模式 Serverless 函数，支持 Node.js/Python/Go 等运行时
• CloudRun 云托管：容器化部署，自定义 Dockerfile，适合长连接、复杂依赖场景
• 云存储与静态托管：文件上传/下载/CDN、静态网站托管（SPA 支持）、独立子域名部署
• AI 能力集成：内置混元、DeepSeek、GLM 等大模型，支持流式输出、图片生成、TokenHub 资源包管理
• AI Agent 开发：AG-UI 协议、LangGraph/LangChain 智能体框架支持

显著优势

• 一体化体验：前端-后端-数据库-存储-AI 全链路开箱即用，无需自行搭建基础设施
• 多端统一：同一套 CloudBase 环境可服务 Web、小程序、原生 App 多端用户
• Serverless 免运维：自动扩缩容、按量计费，新用户享 3000 资源点/月免费额度
• AI 原生支持：内置大模型调用 SDK，支持流式对话与多模态生成，降低 AI 应用接入门槛
• 严格工程规范：强制 MCP 资源预配、TypeScript 零 any、双层级自验证（静态+运行时）

潜在局限与注意事项

• MCP 强依赖：所有管理操作（部署、数据库配置、权限设置）必须通过 MCP 工具完成，无法纯本地 CLI 绕过
• 部署路径限制：首次前端部署必须使用 manageApps(createApp)，禁止直接使用 manageHosting（后者仅用于存量项目更新）
• 数据库选型陷阱：PG 模式与 NoSQL/MySQL 的 SDK 路径完全不同，误用会导致权限与查询失败
• AI 资源前置：调用大模型前必须先确认 Token Credits 资源包或小程序成长计划资格，否则调用会失败
• 原生端限制：iOS/Android/Flutter 无官方 SDK，必须走 HTTP API + MySQL 路径

适用人群

• 快速搭建 MVP 的独立开发者与创业团队
• 需多端统一（Web+小程序+App）的中大型产品团队
• 希望低门槛接入 AI 能力的全栈开发者
• 追求 Serverless 免运维、快速上线的企业项目

常规风险提示

• 权限配置前置风险：若跳过 MCP 预配阶段直接写前端代码，会导致运行时权限不足
• 类型安全红线：禁止使用 any 绕过类型检查，需用 unknown+类型守卫或精确接口替代
• 冷启动延迟：Cloud Functions 默认冷启动明显，生产环境建议 CloudRun 最小实例设为 1
• CDN 缓存策略：静态部署后需加随机参数刷新缓存，SPA 需显式配置 indexDocument 与 errorDocument

核心用法

CloudBase（腾讯云开发/TCB）是面向小程序和 Web/H5 的一体化 Serverless 开发平台。该 Skill 提供完整的开发工作流指导：

开发流程三阶段：
1. 探索阶段 - 完整阅读匹配场景的 Skill 文档（如 Web 认证读 auth-tool + auth-web，小程序读 miniprogram-development）
2. 实现阶段 - 必须先通过 MCP 配置后端资源（认证提供商、数据库表、安全规则），再编写前端代码
3. 收尾阶段 - 强制运行 cloudbase-code-review，修复错误后完成

核心技术栈覆盖：

• 认证：Web SDK 内置登录（auth-web）、小程序无感知登录（auth-wechat）、HTTP API 原生应用接入
• 数据库：NoSQL 文档数据库（no-sql-web-sdk）、CloudBase PostgreSQL（app.rdb()）、MySQL 关系型数据库
• 计算：云函数（SCF，支持 Event/HTTP 模式）、CloudRun 容器托管（Dockerfile 部署）
• 存储：云存储文件上传、静态网站托管
• AI 能力：内置大模型（混元、DeepSeek、GLM 等）、流式输出（streamText）、图片生成（generateImage）、Token Credits 资源包管理
• 智能体开发：AG-UI 协议、LangGraph/LangChain 集成

关键约束：

• MCP 必需：所有管理操作（部署、数据库操作、资源查询）必须通过 CloudBase MCP 完成，支持设备码登录免硬编码密钥
• 禁止 `any`：类型错误需用 unknown + 类型守卫或精确接口，而非 as any
• 首次部署：必须用 manageApps(action="createApp") 获得独立子域名，禁止用 manageHosting 作为首次部署方式
• AI 调用前置检查：必须先用 DescribeEnvPostpayPackage/DescribeActivityInfo 确认资源包/成长计划资格

平台区分：

• Web 项目：auth.getSession() 做登录态校验，SDK CDN 或 npm 包引入
• 小程序：wx.cloud 原生集成，云函数自动获取 OPENID
• 原生 App（iOS/Android/Flutter/RN）：必须使用 HTTP API，不支持 CloudBase SDK

显著优点

1. 官方权威性：腾讯云官方维护，T1 级可信来源，持续更新与文档保障
2. 全栈一体化：前端框架（React/Vue/Vite/Next/Nuxt）+ 后端（函数/容器）+ 数据库 + 认证 + AI 单平台闭环
3. AI 原生集成：内置多模型支持、流式输出、智能体协议（AG-UI），降低大模型接入门槛
4. Serverless 免运维：自动扩缩容，按量计费，免费额度（3000 资源点/月）支撑原型验证
5. 严格工程规范：强制 MCP 优先、类型安全、自验证流程，减少生产事故

潜在缺点与局限性

1. 平台锁定：深度绑定腾讯云生态，迁移成本较高
2. MCP 依赖：非腾讯云原生 IDE 需额外配置 mcporter，增加上手门槛
3. PG/MySQL 区分复杂：同一平台多数据库类型需仔细路由，易误用 app.database() vs app.rdb()
4. 冷启动延迟：云函数和 CloudRun 存在冷启动，需设置 MinNum≥1 缓解
5. AI 资源包门槛：大模型调用需预购 Token Credits 或报名小程序成长计划，资格检查易遗漏

适合人群

• 需要快速构建小程序或 Web 全栈应用的开发者
• 希望集成 AI 能力（对话、图像生成、智能体）的产品团队
• 追求 Serverless 架构、减少运维投入的中小团队
• 已有腾讯云基础设施，需要统一技术栈的企业

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| MCP 未配置 | 直接调用 CloudBase 工具会失败 | 部署前必检 `npx mcporter list \| grep cloudbase` |

| 数据库路由错误 | PG 任务误用 NoSQL/MySQL 语法 | 严格按激活表路由，关键词触发 `postgresql-development` |

| 首次部署违规 | 用 `manageHosting` 替代 `manageApps` | 强制记忆：新独立子域名 → `createApp`，旧项目更新 → `updateApp` |

| AI 调用失败 | 资源包未开通或成长计划未报名 | 编码前先跑 `DescribeEnvPostpayPackage` + `DescribeActivityInfo` |

| 类型安全失守 | 用 `any` 掩盖编译错误 | Code Review 阶段必检，违规打回修复 |

| 认证域混淆 | `auth` 工具 vs `queryAppAuth` 误用 | 管理后台登录用 `auth`，应用端配置用 `queryAppAuth`/`manageAppAuth` |