火山引擎 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。
标准流程
- 确认目标资源(workspace_id、branch_id)。
- 优先执行只读查询确认现状(如
projects list、db query "select ...")。 - 需要变更时执行写操作;破坏性操作(删除/停机)在非交互环境需加
--yes,执行前向用户确认。 - 变更后再次查询确认结果已生效。
适用场景
- 用户提到 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 排查。