用途：在浏览器前端应用（React、Vue、原生 JS）中通过 @cloudbase/js-sdk 访问 CloudBase 关系型数据库，适合初始化前端数据库连接、用 CloudBase 替换已有 Supabase 客户端，或在 Web 应用中共享同一个 db 客户端。不适合后端/Node 访问、MCP/智能体数据库管理以及认证流程，这些应使用对应技能。
主要能力：提供规范的前端初始化模式。安装：npm install @cloudbase/js-sdk。初始化示例：import cloudbase from "@cloudbase/js-sdk"; const app = cloudbase.init({ env: "your-env-id" }); const auth = app.auth(); const db = app.rdb();。获取数据库客户端必须调用 app.rdb()，app 本身不是数据库客户端。
使用方式：初始化后把 db 当作 Supabase 客户端使用，方法名与模式一致，例如 db.from("posts").select("*").order("created_at", { ascending: false })，以及 insert、update、delete 配合 eq 等。查询写法与选项依赖模型自带的 Supabase 知识。
限制与规则：始终使用同步初始化，不要用 import("@cloudbase/js-sdk") 懒加载，也不要把初始化包进带内部缓存的异步辅助函数。只可修改 env 等值，不要改对象结构、不要新增 init 选项属性。创建单一共享 db 客户端并复用，避免重复初始化。需要向用户确认 env（CloudBase 环境 ID）。认证需单独处理。