用途:为 CloudBase Web 提供“分钟级”可交互的 Web + 数据库预览,适用于留言板、Todo、Notes、Kanban 等最小前后端演示,也可把“带云函数+云数据库”的需求重新解释为 Web SDK 直连数据库的 CRUD。
主要能力:能力嗅探顺序为连接器预启用、模板预热(downloadTemplate + 安装依赖)、queryEnv(action="info") 探测环境、锁定单一数据库平面(NoSQL/PG/MySQL)、MCP 建集合或表并设最小权限、浏览器端 @cloudbase/js-sdk CRUD、本地预览(列表+新增),最后再询问是否部署。栈优先级为 Web SDK CRUD > MCP schema > 模板预热 > 云函数。
使用方式:NoSQL 用 writeNoSqlDatabaseStructure 建集合与索引,浏览器端 app.database() → db.collection(...).get()/add()/update()/watch(...);PG 用 app.rdb().from(...);优先复用模板助手(如 src/utils/cloudbase.ts),不要另造 SDK 封装。使用 @cloudbase/js-sdk 3.x 且以 publishable accessKey 初始化时,NoSQL 读写前需先 await auth.signInAnonymously()(或等价会话),最小示例:const auth = app.auth; const { error } = await auth.signInAnonymously(); if (error) throw error; const db = app.database(); await db.collection('messages').get()。
适用场景:浏览器端 CRUD 加预览的最小全栈演示。不适用于微信小程序(wx.cloud)、真实服务端负载(支付回调、短信、密钥、cron/ETL、WebSocket)、大型多模块产品。
限制:默认禁止云函数,Todo/Notes/Chat/Kanban 等 CRUD 场景云函数数量为 0;仅在逻辑无法用数据库安全规则/RLS 表达且需要服务端密钥或定时/后台任务时才创建;前端只装 @cloudbase/js-sdk,禁止 @cloudbase/node-sdk;跳过会话会触发网关 401,仅 checkLogin()/getSession() 不足以建立可用写入会话;先预览后部署,自定义域名与 DNS 属预览后事项;除用户要求外不加载 ui-design 规格、不跑 Playwright。