SuperAPI AI 工具集

volcengine-db-supabase

部署与运维

查看项目

更新于 10-19 16:17

技能介绍

火山引擎 AI 原生 BaaS 平台(Supabase 版)是火山引擎自研的 AI 原生 BaaS 平台,在 Supabase 协议/生态基础上做了平台化适配,与官方开源 Supabase 存在差异。本 Skill 作为该平台的智能运维与开发代理,通过 byted-supabase-cli 命令行工具操作资源,支持自然语言识别需求、执行命令并解释结果。

用途与核心差异

本 Skill 主要用于管理火山引擎 Supabase 版平台,其核心差异包括:

  • 使用 byted-supabase-cli(非官方 supabase CLI),通过火山引擎账号或 AK/SK 鉴权。
  • 资源模型为 workspace(工作区)、branch(分支)、compute(算力),并有 endpoints、computes 等火山专有命令。
  • 部分命令、参数和行为与官方 Supabase CLI 不同,操作应以本 Skill 文档和 byted-supabase-cli <command> --help 为准。

主要能力

本 Skill 覆盖以下资源管理能力:

  • 工作区(workspace):列出、创建、查看详情、调整算力与休眠超时、暂停/恢复(高危)、删除、获取 API Keys、获取连接串等。
  • 分支(branch):列出、创建、删除、查看/设默认分支、重启分支算力、时间点恢复。
  • 数据库(database):执行 SQL(行内或文件)、生成 TypeScript 类型、运行安全/性能巡检(db advisors)、声明式 schema 管理等。
  • Auth:平台支持 Supabase Authentication,多在应用侧通过 SDK 使用,管理配置参见火山引擎文档。
  • Realtime:平台支持 Supabase Realtime(Postgres Changes / Broadcast / Presence),应用侧通过 SDK 订阅。
  • Edge Functions:列出、新建(本地脚手架)、部署、下载、删除函数。
  • Storage:管理 bucket(列表、创建、查看、删除),对象上传下载、移动删除等。
  • 前端静态站点部署:通过 pages 相关命令部署静态站点,可绑定现有 Supabase 后端或一键创建新后端。

使用方式

安装与鉴权

安装 CLI:

npm i -g @byted-supabase/cli

鉴权方式(优先使用 CLI 配置/登录):

byted-supabase-cli login --region cn-beijing
byted-supabase-cli configure set --access-key <AK> --secret-key <SK>

或使用环境变量:

export VOLCENGINE_ACCESS_KEY=<AK>
export VOLCENGINE_SECRET_KEY=<SK>
export VOLCENGINE_REGION=<region>
export VOLCENGINE_SESSION_TOKEN=<token>

目标定位

  • workspace:用 --workspace-id ws-... 指定(别名 --project-ref 兼容官方 CLI)。
  • branch:用 --branch-id br-... 指定;不传则落到默认分支。
  • 可通过 byted-supabase-cli link --workspace-id ws-... --region <region> 设置默认链接,之后可用 --linked。

标准流程

  1. 确认目标资源(workspace_id、branch_id)。
  2. 优先执行只读查询确认现状(如 projects list、db query "select ...")。
  3. 需要变更时执行写操作;破坏性操作(删除/停机)在非交互环境需加 --yes,执行前向用户确认。
  4. 变更后再次查询确认结果已生效。

适用场景

  • 用户提到 Supabase 或火山引擎 Supabase 相关操作需求。
  • 创建、查看、暂停或恢复 Supabase 工作区,或重启分支算力。
  • 对 Supabase 数据库执行 SQL 查询、建表、schema 变更。
  • 管理 Supabase 分支(创建、删除、恢复、设默认)。
  • 配置 Auth 或使用 Realtime。
  • 部署或管理 Edge Functions。
  • 操作 Storage Bucket(创建、删除、查看配置、上传/下载对象)。
  • 部署前端静态站点(并按需与 Supabase 后端打通)。
  • 获取 Supabase 项目的 API Key 或连接信息。
  • 为 Supabase 数据库生成 TypeScript 类型定义。
  • 当 volcengine-deploy 部署流程选择 AIDAP 作为数据库方案(database_product=aidap)时,按 references/deploy-provider.md 供给/复用数据库 workspace。

限制与注意事项

  • 不适用于:仅讨论通用数据库概念、操作非 Supabase 数据库(如 RDS MySQL、Redis)、纯前端/客户端代码编写不涉及 Supabase 后端资源管理、仅询问 Supabase 文档/概念无需调用 CLI。
  • 高危红线:projects stop(暂停 workspace)会让客户业务彻底不可用,且无法靠客户 IO/访问流量自动唤醒,必须人工 projects start 恢复;执行前必须向用户明确复述影响并取得二次确认。projects delete 同属不可逆高危操作,同样需先确认。
  • 安全 checklist:涉及 Auth、RLS、视图、Storage 或用户数据的任务,需逐一检查安全陷阱,如绝不用 user_metadata 做鉴权判断、service_role 密钥绝不出现在前端、视图默认绕过 RLS(PG15+ 用 security_invoker=true)、auth.role() 已弃用、UPDATE 策略需同时有 USING 和 WITH CHECK、UPDATE 需要 SELECT 策略、SECURITY DEFINER 函数绕过 RLS 等。
  • 新建的表不一定自动通过 Data API 暴露,需显式 GRANT 给 anon/authenticated 角色;对外暴露的 schema 内每张表都要启用 RLS。
  • 本 fork 无全局只读开关,写操作安全边界依赖 RLS 和操作纪律。
  • 本 fork 无独立 migration 子命令,schema 变更用 db query 直接执行,版本化演进可用 db schema declarative。
  • 列表命令支持分页(--limit 和 --offset),尤其 branches list 缺省返回全部,分支多时务必加 --limit 或用 --search 过滤。
  • 平台演进快,命令、参数可能变化,动手前应先查在线文档和发布记录,CLI 子命令用 --help 现查。
  • 权限被拒(AccessDenied)多为 IAM 授权不足,切勿编造策略名或权限项,应参考 references/iam-permission-guide.md 排查。