火山引擎 Supabase 正式融入 Agent Plan，CLI + Skills 保姆级上手教程来了

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

火山引擎 Supabase 是以 AI 原生数据库管理平台（AI Native Database Platform，简称 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 抵扣

1. 在方舟控制台，开通"Agent Plan 个人版"或"Agent Plan 企业版"，按需选择套餐。

1. 在 Harness 页面，找到"火山引擎 Supabase"卡片，开启"开启抵扣"，开启"超额后付费"（强烈建议），并点击"配置使用"进行授权。

1. 开通后，通过 Agent Plan 购买 Supabase，即可在 Agent Plan 的用量统计页面查看 Supabase 消耗的 AFP，如下所示。

安装 / 更新 Supabase CLI 及 Skills

方式一：直接安装 / 更新 Supabase CLI 及 Skills

1. 本地安装 node.js（含 npm 和 npx）

参考node.js 官方网站 ，按照网站指引安装 node.js 包（含 npm 管理器和 npx 工具）。

1. 本地安装火山引擎 Supabase CLI 及 Skills：

npx @byted-supabase/cli@latest install

1. 本地更新火山引擎 Supabase CLI 及 Skills：

byted-supabase-cli update

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

参考 Ark CLI 帮助文档 (www.volcengine.com/docs/82379/...%25EF%25BC%258C%25E4%25B8%2580%25E9%2594%25AE%25E5%25AE%2589%25E8%25A3%2585 "https://www.volcengine.com/docs/82379/2373740)%EF%BC%8C%E4%B8%80%E9%94%AE%E5%AE%89%E8%A3%85") 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 的 profilebyted-supabase-cli configure list

效果如下：

使用 CLI

Supabase CLI 的使用说明

可以通过 help 命令查询 CLI 的使用说明；或查阅火山引擎官网 Supabase CLI 文档 。

登录认证

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

支持如下 3 种登录认证方式。登录一次后，CLI 会自动将凭据写入 ~/.volcengine/config.json，可长期复用。

1. 途径 1：通过默认方式（浏览器 OAuth）进行登录（推荐）。 命令如下，其中，profile 缺省为 default，示例中指定为 dev；地域（region）缺省为 cn-beijing。执行后，就会自动在浏览器中弹出火山引擎 OAuth 登录页，输入账号信息登录即可。

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

效果如下：

1. 途径 2：采用火山 AK/SK 配置 profile。 其中，profile 缺省为 default，示例中指定为 dev；地域（region）缺省为 cn-beijing。

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

1. 途径 3：复用 volcengine-cli 的 profile。 如果用户已经通过 volcengine-cli 登录过，则可以直接复用其 profile，无需再次配置。可以通过如下命令查看 profile 列表：

   byted-supabase-cli configure list

方式二：通过 Ark CLI 登录

如 "通过 Ark CLI 登录并安装 Harness 工具集" 小节所述，如果已安装了 Harness 工具集，则可以通过 Ark CLI 进行登录。命令如下：

# 登录火山账号（推荐浏览器SSO登录），并按提示选择消费模式（推荐agent-plan）arkcli auth login# 查看 Supabase CLI 的 profile，会发现有一个名为 ark_login 的 profilebyted-supabase-cli configure list

效果如下：

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

对于独立使用 Supabase CLI 的场景，需要配置 Agent Plan 信息。如果是通过 Ark CLI 安装 Harness 工具集并登录的，则无需再进行配置，可跳过本小节。

1. 对于"Agent Plan 个人版"，需要指定 --is-agent-plan=true。

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

1. 对于"Agent Plan 企业版"，除了指定 --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 工作区（Workspace）。示例命令如下，可以通过两种方式来指定 Agent Plan 信息。

1. 方式 1：指定上述已配置 Agent Plan 信息的 profile。同时可以通过 --suspend-timeout-seconds 来指定自动休眠时间（秒数），缺省值为 -1（关闭自动休眠）。

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

效果如下：

1. 方式 2：单独指定 --is-agent-plan=true 和 --agent-plan-seat-id，会覆盖 profile 中已配置的 Agent Plan 信息。

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 CLI 及 Skills" 小节执行安装命令后，会自动将 Supabase 的 Skills 安装到全局目录下，会被 Trae 自动识别。因此，用户可以在 Trae 中通过自然语言来查阅和执行 Skills，如下所示。

登录认证（2 种途径）

Supabase Skills 是基于 CLI 实现的，因此也支持 2 种登录方式：OAuth 方式、配置 AK / SK 方式。强烈建议在首次使用前先登录；如果未登录，执行操作时受限，并会引导用户进行登录。

1. 途径 1：通过默认方式（浏览器 OAuth）进行登录（推荐）。 在 Trae 中输入如下文字，就会自动在浏览器中弹出火山引擎 OAuth 登录页，输入账号信息即可登录。

   使用火山supabase skill进行登录

当然，也可明确指定登录方式、profile 等（可根据实际情况调整）。

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

效果如下：

自动弹出的浏览器登录页如下：

1. 途径 2：采用火山 AK / SK 配置 profile。 在 Trae 中输入如下文字（可根据实际情况调整），Trae 就会自动调用 CLI 命令进行配置。

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

效果如下：

配置 Agent Plan 信息

1. 对于"Agent Plan 个人版"，指定默认采用 Agent Plan 模式。在 Trae 中输入如下文字（请根据实际情况调整）。

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

效果如下：

1. 对于"Agent Plan 企业版"，指定默认采用 Agent Plan 模式，并需要同时指定席位 ID（请根据实际情况调整）。

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

效果如下：

创建 Supabase 工作区

在 Trae 中输入如下文字来创建 Supabase 工作区（Workspace）。可选指定自动休眠时间，默认关闭自动休眠。

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

或

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

效果如下：

开发 APP 示例

可以基于 Supabase Skill，通过自然语言从 0 到 1 快速开发 APP。

以下展示开发一个"待办事项"APP 的过程，总共分为四步：创建 Supabase 并开发后端、部署后端、开发前端、测试 APP。

1. 创建 Supabase 并开发后端

在 Trae 中输入如下文字（可根据实际情况调整）：

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

效果如下：

2. 部署后端（Edge Function）

在 Trae 中输入如下文字（可根据实际情况调整）：

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

效果如下：

3. 开发前端

在 Trae 中输入如下文字（可根据实际情况调整）：

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

效果如下：

4. 测试 APP

将第 3 步输出的地址复制到浏览器导航栏（本示例中是 http://localhost:5173/），即可看到应用页面。后续申请域名并把前端部署后（supabase skills 同样支持一键部署前端，本示例中省略），即可对外提供服务了。

进入 Supabase Dashboard 控制台后，可以看到 APP 用户数据已经在数据库中正确保存了。

至此，"待办事项 APP"就开发部署完成了。开发过程完全采用自然语言与 Trae 进行交互，通过 Supabase Skills 自动完成了后端开发、后端部署、前端开发等步骤，大幅提高了软件开发效率。