relational-database-web-cloudbase

兄弟技能（仅本地）

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

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

CloudBase 关系型数据库 Web SDK

激活约定

以下情况优先使用此技能

• 浏览器或 Web 应用必须继续使用 @cloudbase/js-sdk 连接已经配置了 CloudBase MySQL 的环境。
• 对于新的关系型应用，请勿选择此技能。新的关系型 Web 开发应使用 postgresql-development-cloudbase 和 app.rdb()。

编写代码前阅读（如果）

• 你需要区分浏览器 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 管理、架构更改或权限管理（MCP 不提供资源配置功能）。
• 后端/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 风格的查询知识进行表操作。
• 架构管理和特权管理应在浏览器代码之外进行。