Cloudbase

概述

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

核心用法

CloudBase Skill 是面向腾讯云开发（Tencent CloudBase）的完整开发指南与最佳实践集合，采用「探索-实现-收尾」三阶段标准化工作流。开发者需先通过MCP工具完成后端资源准备（认证、数据库、存储、安全规则），再进行前端实现，最后必须经过代码审查方可完成。

该Skill覆盖六大核心场景：
1. Web全栈开发（React/Vue/Next/Vite等）——优先读取web-development与auth-web
2. 微信小程序开发——使用miniprogram-development与wx.cloud原生SDK
3. 原生App/Flutter/React Native——通过HTTP API接入，禁用Web SDK
4. 云函数与CloudRun部署——支持Node.js原生HTTP函数（port 9000）及容器化部署
5. AI大模型集成——内置混元、DeepSeek、GLM等模型，支持流式输出与图片生成
6. PostgreSQL/MySQL/NoSQL数据库——PG模式采用app.rdb()与RLS权限，禁用旧版NoSQL语法

关键约束包括：必须使用MCP工具预配后端资源；禁止用any绕过类型检查；首次部署必须使用manageApps创建独立子域名；AI调用前必须执行DescribeEnvPostpayPackage资格检查。

显著优点

• 平台级生态整合：深度绑定腾讯云基础设施，提供从认证、数据库、存储到AI能力的完整BaaS方案
• 工程规范严格：内置「工程宪法」——强制类型安全、禁止空catch、要求双层验证（编译+运行时），显著降低生产故障
• 多终端统一：一套后端服务同时支撑Web、小程序、原生App，通过路由表精准分流不同SDK边界
• AI原生支持：内置大模型流式对话、图片生成、智能体开发（AG-UI协议），降低AI应用开发门槛
• MCP驱动运维：支持通过Model Context Protocol管理云资源，实现基础设施即代码

潜在局限

• 厂商锁定风险：深度依赖腾讯云生态，迁移至其他云厂商成本较高
• MCP前置依赖：所有管理操作必须预配置MCP，无MCP环境下能力受限
• 版本碎片化：文档提及大量版本细节（JS SDK v3、scf_bootstrap、TokenHub等），新手易产生混淆
• 平台差异复杂：Web/小程序/原生App三套认证体系互不相同，需严格遵循路由表避免踩坑
• 免费额度有限：仅1个免费环境（3000资源点/月），超出后需付费

适合人群

• 腾讯云用户：已使用或计划使用腾讯云基础设施的团队
• 小程序开发者：需要快速搭建微信云开发后端的小程序/小游戏团队
• 全栈工程师：追求前后端一体化部署、希望减少运维负担的Web开发者
• AI应用开发者：需要快速集成大模型能力（对话、生图、智能体）的创业者
• 中后台产品团队：需要快速搭建管理后台、 dashboard 的企业IT部门

常规风险

• 部署顺序风险：首次部署若误用manageHosting而非manageApps，将导致路径冲突，后续难以迁移
• 冷启动延迟：CloudRun默认实例数为0时存在冷启动，生产环境建议设置MinNum≥1
• 权限模型混淆：PG模式的RLS与后端权限需同时配置，仅前端校验会导致数据泄露
• AI资源包欠费：未开通Token Credits或小程序成长计划即调用大模型，会导致API失败
• CDN缓存刷新：前端更新后需添加随机参数强制刷新，否则用户可能看到旧版本