relational-database-web-cloudbase

同级技能（仅本地）

同级 CloudBase 技能会与此技能一同提供。请使用 ../auth-tool-cloudbase/SKILL.md 这样的本地相对路径。

如果当前环境中缺少引用的同级技能文件，请让用户安装完整的 CloudBase 插件（或缺失的技能）。不要通过 HTTP 将远程技能或协议 Markdown 获取到 Agent 上下文中。

CloudBase 关系型数据库 Web SDK

激活约定

以下情况优先使用此技能

• 浏览器或 Web 应用必须通过 @cloudbase/js-sdk 访问 CloudBase 关系型数据库。
• 任务专门涉及前端初始化和浏览器端查询用法。

编写代码前请阅读

• 需要区分浏览器 SDK 用法与 MCP 数据库管理或后端 Node 访问。
• 请求提及 Supabase 迁移、共享前端数据库客户端或浏览器端表查询。

然后也请阅读

• MySQL SQL 管理和 MCP 操作 -> ../relational-database-mcp-cloudbase/SKILL.md
• Web 身份验证/登录 -> ../auth-web-cloudbase/SKILL.md
• 通用 Web 应用设置 -> ../web-development/SKILL.md

请勿用于

• 基于 MCP 的 SQL 配置、架构变更或权限管理。
• 后端/Node 服务访问。
• 文档数据库操作。

常见错误 / 注意事项

• 在 MCP 管理流程中初始化 SDK。
• 将 app 本身视为关系型数据库客户端。
• 在每个组件中重新初始化 CloudBase。
• 混用前端浏览器访问与管理员式架构变更。

最简检查清单

• 确认调用方是 Web 前端。
• 保留一个共享的 CloudBase 应用和一个共享的关系型数据库客户端。
• 将 MySQL 配置/架构工作交给 relational-database-mcp-cloudbase。如果任务提及 PostgreSQL、CloudBase PG、PG 模式、app.rdb()、queryPgDatabase、managePgDatabase 或 RLS，则改用 postgresql-development-cloudbase。
• 在访问数据前单独处理身份验证。

概述

此技能统一了 CloudBase 关系型数据库的浏览器端初始化模式。

初始化后，使用 db 和 Supabase 风格的查询模式。

安装

npm install @cloudbase/js-sdk

标准初始化

import cloudbase from "@cloudbase/js-sdk";

const app = cloudbase.init({
  env: "your-env-id"
});

const auth = app.auth;
// Handle login separately

const db = app.rdb();

初始化规则

• 同步初始化。
• 除非框架绝对要求，否则不要使用 import("@cloudbase/js-sdk") 延迟加载 SDK。
• 创建一个共享的 db 客户端并重复使用。
• 不要臆造不受支持的 cloudbase.init() 选项。

快速路由

以下情况使用此技能

• 将浏览器组件连接到关系型表
• 将 Supabase 浏览器客户端替换为 CloudBase
• 需要标准的共享前端 db 客户端

以下情况改用 relational-database-mcp-cloudbase

• 需要创建/销毁 MySQL
• 需要 MySQL DDL 或写 SQL 管理
• 需要通过 MCP 检查或更改 MySQL 表安全规则

以下情况改用 postgresql-development-cloudbase

• 任务提及 PostgreSQL、CloudBase PG、PG 模式、app.rdb()、queryPgDatabase、managePgDatabase、PostgREST 或 RLS
• 浏览器端表代码必须使用 PG 语义，而非旧版 NoSQL / MySQL 管理工具

示例：共享前端数据库客户端

import cloudbase from "@cloudbase/js-sdk";

const app = cloudbase.init({
  env: "your-env-id"
});

export const db = app.rdb();

示例：Supabase 风格查询

const { data, error } = await db
  .from("posts")
  .select("*")
  .order("created_at", { ascending: false });

if (error) {
  console.error("Failed to load posts", error.message);
}

示例：插入 / 更新 / 删除

await db.from("posts").insert({ title: "Hello" });
await db.from("posts").update({ title: "Updated" }).eq("id", 1);
await db.from("posts").delete().eq("id", 1);

核心原则

• app.rdb() 会提供关系型数据库客户端。
• 此后，使用 Supabase 风格的查询知识进行表操作。
• 将架构管理和特权管理操作留在浏览器代码之外。