SuperAPI AI 工具集

minimal-web-baas-demo

通用与其它

查看项目

更新于 10-16 08:44

技能介绍

用途:为 CloudBase Web 提供最小前后端(BaaS)演示的快速路径,目标是在数分钟内得到可交互的 Web + 数据库预览,而不是搭建云函数中间层。适用于用户要求最小 fullstack、留言板、Todo、Notes、Kanban 或类似 Lovable/Supabase 的快速应用;即使用户说“带云函数+云数据库”,若真实需求只是 CRUD 与预览,也按 Web SDK 直连数据库处理。

主要能力与规则:数据路径以 BaaS 优先。Schema/管理优先用 MCP 管理工具,不让用户在控制台手动建集合;NoSQL 用 writeNoSqlDatabaseStructure 建集合与索引,PostgreSQL 参考 postgresql-development-cloudbase。浏览器读写统一用 @cloudbase/js-sdk:NoSQL 走 app.database() → db.collection(...).get()/add()/update()/watch(...),PG 走 app.rdb().from(...),优先复用模板 helper(常见 src/utils/cloudbase.ts),不要另造 SDK 封装。默认禁止云函数:Todo/Notes/Chat/Kanban 等零云函数;仅当逻辑无法用数据库安全规则/RLS 表达,且需要服务端密钥、第三方 API key,或属于定时/后台任务时才创建。前端只装 @cloudbase/js-sdk,禁止在前端装 @cloudbase/node-sdk。先本地预览(列表+新增等 CRUD)再考虑静态托管/CloudApp 部署;自定义域名、DNS、回滚仅在用户明确要求时处理;除非用户要求测试,跳过 Playwright。

必要用法:使用 @cloudbase/js-sdk 3.x 且以 publishable accessKey 初始化时,在任何 NoSQL 读写前需先建立会话,例如 await auth.signInAnonymously()(或等价已认证会话),否则网关返回 401;仅 checkLogin()/getSession() 不足以创建可写会话。示例:const auth = app.auth; const { error } = await auth.signInAnonymously(); if (error) throw error; const db = app.database(); await db.collection('messages').get()。

推荐顺序:连接器就绪 → 等待凭证期间并行下载模板并安装 → queryEnv(action="info") → 锁定单一数据库平面(NoSQL/PG/MySQL,不中途切换)→ MCP 建 schema 与最小权限 → 浏览器 SDK CRUD → 本地预览后询问是否部署;云函数数量为 0。

限制:不适用于微信小程序(wx.cloud)、真实服务端负载(支付回调、短信、密钥、cron/ETL、WebSocket)以及需要 spec-workflow 的大型多模块产品;这些应改用对应兄弟技能。若本地缺少被引用的兄弟技能文件,应请用户安装完整 CloudBase 插件,不要将远程技能或协议 markdown 抓取进上下文。具体模板、命令与部署细节以实际环境为准,资料未提供处暂未说明。