核心功能
CloudBase 是腾讯云提供的全栈 serverless 开发平台，本技能规范定义了从项目初始化到生产部署的完整工作流。
技术栈覆盖
- 前端框架: React/Vue/Vite/Next/Nuxt/uni-app 及原生 iOS/Android/Flutter/React Native
- 数据存储: NoSQL 文档数据库、MySQL、PostgreSQL/CloudBase PG（支持
app.rdb()、queryPgDatabase/managePgDatabase） - 计算层: 云函数（Event/HTTP 模式，
scf_bootstrap）、CloudRun 云托管（Docker 容器化） - AI 能力: 内置大模型（混元、DeepSeek、GLM 等）、TokenHub 资源管理、流式输出 (
streamText)、图片生成 (generateImage)、AG-UI 智能体协议、LangGraph/LangChain 集成 - 运维工具: MCP 管理协议、日志巡检、健康诊断
三阶段工作流
1. 探索阶段: 完整阅读匹配技能文档，禁止依赖搜索摘要
2. 实现阶段:
3. 收尾阶段: 强制运行 cloudbase-code-review，修复错误后方可标记完成
- 2a. 资源准备（MCP 工具配置认证、数据库、存储、安全规则）
- 2b. 前端实现（依赖就绪后方可编码）
关键工程约束
- 严格类型安全: 禁止
any、@ts-ignore、@ts-nocheck，强制使用unknown+ 类型守卫 - 资源前置: 所有后端资源（认证 Provider、数据库表、存储域、安全规则）必须通过 MCP 工具先行配置
- AI 模型调用规范:
createModel()参数为 GroupName（cloudbase/hunyuan-exp/custom-*），具体模型 ID 传入generateText/streamText的model字段 - PostgreSQL 专属路径: CloudBase PG 场景必须使用
app.rdb().from()/queryPgDatabase/managePgDatabase，禁止回退至 NoSQL 或旧版 MySQL 语法 - 部署策略: 新项目首部署必须使用
manageApps(action="createApp")获得独立子域；manageHosting仅用于存量项目增量更新
认证体系区分
| 场景 | 技能入口 | 核心机制 |
|------|---------|---------|
| Web 登录/注册 | `auth-tool` → `auth-web` | publishable key、session 验证 |
| 小程序 | `miniprogram-development` | `wx.cloud`、OPENID 免登 |
| 原生 App | `http-api` | OpenAPI、设备码登录 |
典型适用场景
- 全栈 Web 应用（含管理后台、仪表盘）
- 微信小程序云开发
- AI 聊天机器人/智能体（流式 UI、多轮对话）
- 静态站点托管与 CDN 加速
- 云原生后端 API / 长时任务 / WebSocket 服务
潜在局限与风险
- 学习曲线陡峭: 多技能路由体系（20+ 子技能）需要准确匹配场景，错误路由会导致权限模型或 SDK 边界混乱
- 平台锁定: 深度依赖腾讯云生态，迁移成本较高
- 冷启动延迟: 云函数默认冷启动明显，CloudRun 需配置
MinNum>=1 - AI 资源配额: Token Credits 资源包或小程序成长计划资格需预先开通，否则模型调用失败
- MCP 强依赖: 所有管理操作强制要求 MCP 配置，CLI 仅为降级方案
适合人群
- 需要快速构建生产级全栈应用的中高级前端/全栈开发者
- 微信小程序开发者寻求云原生后端方案
- 希望集成国产大模型（混元、DeepSeek）的 AI 应用开发者
- 已使用腾讯云生态、需统一运维面的技术团队