↑

CloudBase 平台开发指南v1.0.0

cloudbase-references-cloudbase-platform5 KB

面向 CloudBase(云开发)全栈开发的知识库,覆盖 Web 与小程序的鉴权差异、数据库权限配置、云函数部署及数据模型操作。在需要初始化 CloudBase SDK、配置安全规则、调用 MySQL/NoSQL 数据模型或排查跨平台兼容性问题时触发使用。

0 0 0 0 更新于 2026-10-28 18:24

免责声明:本站部分 Skill 来源于公开渠道,使用前请注意识别相关风险,内容版权归原作者所有,如 Skill 涉及版权问题,请在线反馈,核实后予以下架处理。

概述

本 Skill 为 CloudBase(腾讯云开发)平台的全栈开发提供系统性知识指引,核心解决 Web 端与小程序端在鉴权机制、数据库权限、SDK 选型上的关键差异。涵盖静态托管与云存储的适用分界、匿名登录与免登录的实现路径、云函数的创建与部署规范,以及 MySQL 数据模型与 NoSQL 集合在调用方式上的根本区别。同时提供 CloudBase MCP 的接入配置与命令行工具链(mcporter)的完整使用范例,帮助开发者在 IDE 原生 MCP 不可用时仍能完成环境认证、工具发现与远程调用。

技能包含

  • SKILL.md(本文件):平台知识总览,含鉴权差异、数据库权限、数据模型、云函数、MCP 接入等核心规则与操作指引

核心能力

  • 平台鉴权区分:明确 Web 端(SDK 内置登录,禁止云函数绕接)与小程序端(天然免登录,禁止生成登录页)的完全不同的认证路径
  • 数据库权限前置配置:强制「先配权限再写代码」的工作流,覆盖 READONLY / CUSTOM / ADMINWRITE 等规则在 Web SDK 与云函数中的可用性差异
  • 数据模型精准调用:区分 MySQL 数据模型(必须用 app.models SDK)与 NoSQL 集合(db.collection API)的调用范式,避免方法混用
  • 云函数全生命周期:从 package.json 依赖声明、云端安装优化,到 createFunction / updateFunctionCode 的部署指令
  • MCP 备用通道:通过 mcporter CLI 配置 CloudBase MCP Server,支持设备码登录、环境 ID 动态获取及完整工具模式发现
  • 控制台直达链接:按环境 ID 拼接概览、模板中心、文档数据库、MySQL 数据库等核心管理页面的完整 URL

应用场景

用户怎么说本技能做什么
"Web 项目怎么接入 CloudBase 登录"给出同步初始化 SDK + 匿名/SMS 登录的代码范式,明确禁止动态导入与云函数代理登录
"小程序需要写登录页面吗"说明小程序天然免登录机制,指导通过 wxContext.OPENID 在云函数中识别用户,禁止生成任何登录流程代码
"数据库写入报权限错误"诊断 Web SDK 误用 ADMINWRITE/ADMINONLY 的问题,提供按场景(电商商品、购物车、订单、日志)匹配的安全规则配置方案
"MySQL 数据模型怎么查数据"纠正 db.collection 的误用,给出 app.models.model_name.list 的标准调用,并指引通过 MCP manageDataModel 获取字段定义与 SDK 文档
"没有 IDE 的 CloudBase MCP 怎么办"提供 mcporter 的完整配置片段与命令序列,包括设备码认证、环境设置、工具发现与带参调用