火山引擎Supabase融入Agent Plan CLI与Skills完全一步步保姆级上手教程

火山引擎 Supabase 及方舟 Agent Plan 概述

火山引擎 Supabase，简单来说，就是一款以AI原生数据库管理平台（AIDAP）为基础，专门面向企业应用和Agent研发推出的AI-Native BaaS产品。它的底层跑的是火山引擎的Serverless PostgreSQL，不光有完善的企业级BaaS能力，还带来了秒级Serverless、全栈分支管理、瞬间回溯、AI原生这些高级特性。作为企业级智能应用的Harness基座，再合适不过了。

Agent Plan 是火山方舟这边推出的业界首个订阅式“Agent套餐包”。它把多模态模型和Harness服务深度整合在了一起。模型层面，内置了字节Seed系列的SOTA模型（比如Doubao-Seed、Seedance、Seedream等），还有一批优秀的国产模型，覆盖了文本、代码、图像、视频等多模态需求。Harness层面呢，则提供了Supabase、联网搜索、专业数据集、Agent记忆、ArkClaw个人助手等一系列开箱即用的Agentic能力。这个组合拳，确实能给Agent场景带来全新的体验。

火山引擎 Supabase 是Agent Plan内置的Harness服务之一，支持用Agent燃料值（AFP）来抵扣。它能为Agent场景提供一个一站式的AI-Native BaaS底座。在Agent Plan套餐里，无论是个人用户还是企业用户，都可以通过Supabase控制台、OpenAPI、CLI、Skills、MCP等方式来购买和管理Supabase实例。

开通 Agent Plan 及 Supabase 抵扣

第一步，登录方舟控制台，开通“Agent Plan个人版”或“Agent Plan企业版”，按需选套餐就行。

第二步，在Harness页面找到“火山引擎 Supabase”这个卡片，开启“开启抵扣”和“超额后付费”——超额后付费强烈建议打开，然后点击“配置使用”进行授权。

第三步，开通之后通过Agent Plan购买Supabase，就可以在Agent Plan的用量统计页面查看Supabase消耗了多少AFP了。操作路径很清楚，跟着走就行。

安装 / 更新 Supabase CLI 及 Skills

方式一：直接安装 / 更新

先在本机装好node.js，这个没啥好说的，去官网下载安装包按指引操作就行，npm和npx都会一起装好。

然后运行下面的命令来安装火山引擎Supabase CLI和Skills：

npx @byted-supabase/cli@latest install

后面想更新的话，执行这条命令：

byted-supabase-cli update

方式二：通过 Ark CLI 登录并安装 Harness 工具集

先参考Ark CLI帮助文档安装好Ark CLI，然后运行arkcli helper，按提示安装Harness工具集，就会自动把Supabase的CLI和Skills都装上了。具体命令如下：

# 1. 通过 NPM 安装
npm install -g @volcengine/ark-cli@latest

# 2. 验证安装
arkcli --version

# 3. 登录火山账号（推荐浏览器 SSO 登录），并按提示选择消费模式（推荐 agent-plan）
arkcli auth login

# 4. 启动 arkcli helper，并按提示依次选择模型、选择 Agent 类型、安装 Harness 工具
arkcli helper

# 5. 查看 Supabase CLI 的 profile，会发现有一个 ark_login 的 profile
byted-supabase-cli configure list

效果

使用 CLI

Supabase CLI 的使用说明

可以用help命令查CLI的使用说明，或者直接去看火山引擎官网的Supabase CLI文档。

登录认证

方式一：通过 Supabase CLI 登录（3种途径）

登录一次之后，CLI会自动把凭据写到~/.volcengine/config.json里，后面就能长期复用了。

途径1：浏览器OAuth登录（推荐）

命令如下。其中的profile缺省为default，这里我们指定成dev；地域（region）缺省是cn-beijing。执行之后，浏览器会自动弹出火山引擎的OAuth登录页，输入账号信息登录就行。

byted-supabase-cli login --profile dev --region cn-beijing

途径2：使用火山AK/SK配置profile

profile缺省为default，这里指定为dev；地域也是cn-beijing。

byted-supabase-cli configure set --profile dev --access-key  --secret-key  --region cn-beijing

途径3：复用volcengine-cli的profile

如果你之前已经用volcengine-cli登录过，可以直接复用它的profile，不用再配一次。查看profile列表用这个命令：

byted-supabase-cli configure list

方式二：通过 Ark CLI 登录

这个方法前面提到过。如果已经通过Ark CLI安装了Harness工具集，就用Ark CLI来登录：

# 登录火山账号（推荐浏览器 SSO 登录），并按提示选择消费模式（推荐 agent-plan）
arkcli auth login

# 查看 Supabase CLI 的 profile，会发现有一个名为 ark_login 的 profile
byted-supabase-cli configure list

配置 Agent Plan 信息（独立使用 Supabase CLI 场景）

如果你是独立使用Supabase CLI的，就需要单独配置Agent Plan信息。如果已经通过Ark CLI安装Harness工具集并登录了，这步就跳过了。

个人版：需要指定--is-agent-plan=true

byted-supabase-cli configure agent-plan --profile dev --is-agent-plan=true

企业版：除了指定--is-agent-plan=true，还得通过--agent-plan-seat-id指定席位ID。

byted-supabase-cli configure agent-plan --profile dev --is-agent-plan=true --agent-plan-seat-id seat-20260620212706-sxz2k

创建 Supabase 工作区

通过projects子命令来管理Supabase工作区。看两个示例，可以指定自动休眠时间，缺省值为-1（关闭自动休眠）。

方式1：指定已配置Agent Plan信息的profile

byted-supabase-cli --profile dev projects create my-project-1 --suspend-timeout-seconds 3600

方式2：单独指定Agent Plan信息（会覆盖profile中的配置）

byted-supabase-cli projects create my-project-2 --suspend-timeout-seconds -1 --is-agent-plan=true --agent-plan-seat-id seat-20260620212706-sxz2k

使用 Skills（结合 Trae）

Skills 的使用说明

执行安装命令后，Supabase的Skills会自动装到全局目录下，Trae会自动识别。所以用户可以在Trae里通过自然语言来调用和执行Skills。

登录认证（2种途径）

Supabase Skills基于CLI实现，所以支持OAuth和配置AK/SK两种登录方式。强烈建议在第一次使用前先登录；如果没登录，操作会受限，系统也会引导你登录。

途径1：浏览器OAuth登录（推荐）

在Trae里输入下面这段文字，浏览器就会自动弹出火山引擎OAuth登录页：

使用火山supabase skill进行登录

也可以更精确地指定登录方式和profile：

创建火山引擎supabase的profile dev；并通过OAuth方式进行登录。

途径2：使用火山AK/SK配置profile

在Trae里输入：

帮我配置supabase的profile，并作为后续操作的默认profile。
* 名称：dev
* AK：test-ak
* SK：test-sk
* region：cn-beijing

Trae会自动调用CLI命令进行配置。

配置 Agent Plan 信息

个人版：指定默认采用Agent Plan模式，在Trae里输入：

设置 profile dev 默认采用 agent plan 模式

企业版：除了指定模式，还要同时指定席位ID：

设置 profile dev 采用 企业版 agent plan 模式，席位ID 为 "seat-xxxx"

创建 Supabase 工作区

在Trae里输入文字来创建Supabase工作区，可以指定自动休眠时间（默认关闭）：

使用 profile dev，创建一个 Supabase workspace，名称为 my-project-3。

或者指定自动休眠时间：

使用 profile dev，创建一个 Supabase workspace，名称为 my-project-4，自动休眠时间为3600秒。

开发 APP 示例

基于Supabase Skill，完全通过自然语言就能从0到1快速开发一个 APP。下面展示一个“待办事项”APP的开发过程，一共四步。

1. 创建 Supabase 并开发后端

在Trae里输入：

请基于 Supabase skill，开发一个待办事项 APP 的完整后端，完成编码相关工作，后续我会部署到 Supabase Edge Function 中，具体包括：创建新的Supabase工作区、数据库表设计（todos 表）、RESTful API 接口开发。代码请放到 ~/todo-app-backend。

2. 部署后端（Edge Function）

继续输入：

请将上述待办 APP 后端代码 (~/todo-app-backend) 部署到新创建的Supabase工作区中，完成以下工作：执行数据库初始化 SQL、部署服务到Supabase中、验证各接口可正常访问。

3. 开发前端

在后端就绪后，输入：

后端已就绪，请开发配套的待办 APP 前端页面，要求：支持任务的增删改查、接入 Supabase 后端接口、界面简洁美观、并在本地直接部署运行。代码请放到 ~/todo-app-frontend。

4. 测试 APP

把第三步输出的地址复制到浏览器导航栏（本例中是http://localhost:5173/），就能看到应用页面了。后面申请域名再把前端部署上去（Supabase Skills同样支持一键部署前端，这里就省略了），就能对外提供服务了。进入Supabase Dashboard控制台之后，可以看到APP用户数据已经在数据库里正确保存了。

整个开发部署过程完全用自然语言和Trae交互，通过Supabase Skills自动完成了后端开发、后端部署、前端开发等步骤，软件开发效率确实提升了不少。