核心能力
CloudBase（腾讯云开发）是面向现代全栈应用的一体化 Serverless 平台，核心能力覆盖四大领域：
1. 多端运行时支持
- Web 应用：React、Vue、Vite、Next、Nuxt 等现代框架，通过
@cloudbase/js-sdk或 CDN 集成 - 微信小程序：原生
wx.cloudSDK，天然获取 OPENID，免登录设计 - Native 应用：iOS、Android、Flutter、React Native 通过 HTTP API 接入，仅支持 MySQL 数据库
2. 数据与存储
- NoSQL 文档数据库：前端直连，适合小程序与 Web 实时场景
- CloudBase PostgreSQL：支持
app.rdb()、RLS 行级安全、pgvector向量扩展，需严格区分于 MySQL 路由 - MySQL 关系型数据库：通过 MCP 管理，支持
executeWriteSQL与 security rules - 云存储：文件上传下载、CDN 临时链接、静态托管
3. 计算与部署
- 云函数（SCF）：Event 函数（
exports.main）与 HTTP 函数（scf_bootstrap+ 9000 端口）双模式 - CloudRun 云托管：容器化部署，支持 Dockerfile，适合长连接、WebSocket、自定义运行时
- 静态托管：新 projects 必须使用
manageApps创建独立子域名，禁止首次部署使用manageHosting
4. AI 与智能体
- 内置大模型：TokenHub 托管池（
cloudbase）、混元实验版（hunyuan-exp）、自定义模型组（custom-*） - 多模型支持：DeepSeek、GLM、Kimi 等通过
generateText/streamText/generateImage调用 - 智能体开发：AG-UI 协议、LangGraph/LangChain 集成、流式输出支持
- 关键约束：
createModel参数为 GroupName 而非模型 ID；调用前必须检查DescribeEnvPostpayPackage（Token Credits）或DescribeActivityInfo（小程序成长计划）资格
工程规范与硬性约束
CloudBase 技能体系建立了严格的工程宪法（Engineering Constitution），适用于所有场景：
- MCP 优先：所有资源管理（Auth、DB、Storage、Function）必须通过 MCP 工具完成，前端代码编写前必须完成后端资源准备
- 禁止 `any`：类型错误必须使用
unknown+ type guard、精确interface或declare module解决 - 自验证要求：静态层（tsc/lint/build）与运行时层（
agent-browser用户可见流）双重验证 - 显式 EnvId：所有 SDK 初始化、配置、命令示例必须显式指定
EnvId，禁止依赖 CLI 选中状态或隐式默认 - 失败不掩盖：禁止空
try/catch、跳过失败测试、"编译通过即工作"的心态
典型使用流程
所有任务遵循三阶段工作流：Exploration → Implementation（2a 资源准备 → 2b 前端实现）→ Close-out
- Exploration：通过
searchKnowledgeBase(mode="skill")读取完整技能文档，禁止依赖搜索摘要 - Implementation 2a：使用 MCP 工具准备 Auth Provider、数据库表、存储域、安全规则
- Implementation 2b：编写前端代码、安装依赖、启动服务、测试
- Close-out：运行
cloudbase-code-review、修复错误、声明完成
路由决策表（关键路径）
| 场景 | 首读技能 | 禁止路由 | 必须检查 |
|------|---------|---------|---------|
| Web 登录/注册 | `auth-tool` → `auth-web` | `cloud-functions`, `http-api` | Provider 状态、publishable key |
| 小程序云开发 | `miniprogram-development` | `auth-web`, `web-development` | 确认使用 `wx.cloud` |
| Native App 接入 | `http-api` | `auth-web`, `no-sql-web-sdk` | SDK 边界、OpenAPI、认证方式 |
| CloudBase PG | `postgresql-development` | `relational-database-tool`, `no-sql-web-sdk` | PG schema、usernamePassword、RLS |
| AI 大模型调用 | `ai-model-web` | `cloudbase-agent`, `cloud-functions` | Token Credits / 小程序成长计划资格 |
| AI Agent 开发 | `cloudbase-agent` | `cloud-functions`, `cloudrun-development` | AG-UI 协议、scf_bootstrap、SSE |
潜在局限与风险
1. PG/MySQL 路由混淆：CloudBase PG 与 MySQL 在技能体系中是互斥路径，混用会导致权限模型与 SDK 调用错误
2. Native App 限制：无官方 SDK，必须走 HTTP API；仅支持 MySQL，NoSQL 与 PG 路径不可用
3. 首次部署陷阱：manageHosting 仅用于存量项目增量更新，新项目必须用 manageApps，否则影响子域名隔离
4. AI 资格前置：大量 AI 调用失败源于未开通 Token Credits 或未报名小程序成长计划，非代码问题
5. MCP 强依赖：无 MCP 无法执行任何管理操作，必须预先配置 mcporter 或 IDE native MCP
6. 冷启动延迟：云函数默认冷启动较高，生产环境建议 CloudRun MinNum ≥ 1
适合人群
- 需要快速交付全栈应用的独立开发者与中小团队
- 微信小程序开发者寻求免运维后端方案
- 需要内置 AI 能力（文本/图像/流式对话）的应用构建者
- 希望以 Serverless 架构降低运维复杂度的技术团队
- 具备 TypeScript/Node.js 基础，能接受严格工程规范的开发者
安全与可信度
- 来源可信度 T2：官方腾讯云产品，文档与 MCP 工具链由腾讯 CloudBase 团队维护
- 安全等级 S：MCP 支持设备码登录替代硬编码密钥；RLS 与 security rules 提供数据层防护；严格禁止
any与隐式默认值的工程约束降低运行时风险
版本信息
当前技能版本：2.23.2，支持 CloudBase AI、CloudRun、PostgreSQL、AG-UI 协议等最新特性。