火山引擎 Supabase 已作为 Agent Plan 的内置 Harness 能力之一，支持通过 Agent 燃料值抵扣使用。对希望快速搭建 Agent 应用、业务后台或轻量 SaaS 的团队来说，这意味着数据库、认证、对象存储、函数能力与开发工具可以放到一条路径里完成接入，而不需要分别采购和拼装。本文从准备工作、开通服务、安装和使用 CLI 进行全流程的介绍，并给出一个基于 CLI 从 0 到 1 开发 APP 的示例。 ## 前提条件 1. 已注册火山引擎账号，并完成实名认证。账号注册和实名认证的方法，请参见[如何进行账号注册](https://www.volcengine.com/docs/6261/64925)和[实名认证](https://www.volcengine.com/docs/6261/64935)。 2. 已确认要使用 **Agent Plan 个人版**或 **Agent Plan 企业版**。 3. 本地开发环境可安装 Node.js；如果需要命令行操作，建议提前准备终端环境。 4. 若计划使用企业版抵扣，需要提前获取席位 ID。您可在控制台查看或调用 Open API 进行获取，更多详细信息，请参见[席位管理](https://www.volcengine.com/docs/82379/2374454?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.385_7652591191041508873#7520dda1)和 [ListSeatInfos](https://www.volcengine.com/docs/82379/2307201?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.385_7652591191041508873#.6L-U5Zue5Y-C5pWw)。 ## 注意事项 * 仅支持在北京地域使用 Agent Plan 套餐的 AFP 额度抵扣火山引擎 Supabase 资源的使用费用。 * 如您是首次使用火山引擎 Supabase，请注意： * 如您是主账号：请为账号授权 `ServiceRoleForAlDAP` 角色。 * 如您是子账号：请联系主账号授权 `ServiceRoleForAlDAP` 角色，并为您再授予 IAM 的 `AIDAPFullAccess` 预设策略或包含 AIDAP 权限点的自定义策略。 ## 开通 Agent Plan 及 Supabase 抵扣 1. 在[方舟控制台](https://www.volcengine.com/activity/agentplan)，开通**Agent Plan 个人版**或 **Agent Plan 企业版**，按需选择套餐。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6c62a3aab9afe5aabb10742851b3fce7.png) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_340b86f33d4cf724b2dbcbef37d6f850.png) 2. 在 Harness 页面，找到**火山引擎 Supabase**卡片，**开启抵扣**并开启**超额后付费**（强烈建议）后，单击**配置使用**进行授权。

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

## 安装/更新 Supabase CLI 及 Skills ### 方式一：直接安装/更新 Supabase CLI 及 Skills 1. 本地安装 node.js（含 npm 和 npx）参考 [node.js 官方网站](https://nodejs.org/zh-cn)，按照网站指引安装 node.js 包（含 npm 管理器和 npx 工具）。 2. 本地安装火山引擎 Supabase CLI 及 Skills： ```Bash npx @byted-supabase/cli@latest install ``` 3. 本地更新火山引擎 Supabase CLI 及 Skills： ```Bash byted-supabase-cli update ``` ### 方式二：通过 Ark CLI 登录并安装 Harness 工具集参考 [Ark CLI 帮助文档](https://www.volcengine.com/docs/82379/2373740)，一键安装 Ark CLI。然后运行arkcli helper，并按提示安装 Harness 工具集，就会自动安装 Supabase 的 CLI 和 Skills。 ```Bash # 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 文档](https://www.volcengine.com/docs/87275/2549800)。

### 登录认证 #### 方式一：通过 Supabase CLI 登录（3 种途径）支持如下 3 种登录认证方式。登录一次后，CLI 会自动将凭据写入 ~/.volcengine/config.json，可长期复用。 1. 途径 1：**通过默认方式（浏览器 OAuth）进行登录（推荐）** 。命令如下，其中，profile 缺省为 default，示例中指定为dev；地域（region）缺省为 cn\-beijing。执行后，就会自动在浏览器中弹出火山引擎 OAuth 登录页，输入账号信息登录即可。 ```Bash byted-supabase-cli login --profile dev --region cn-beijing ``` 效果如下：

2. 途径 2：采用火山 AK/SK 配置 profile。其中，profile 缺省为 default，示例中指定为dev；地域（region）缺省为 cn\-beijing。 ```Bash byted-supabase-cli configure set --profile dev --access-key --secret-key --region cn-beijing ``` 3. 途径 3：复用 volcengine\-cli 的 profile。如果用户已经通过 [volcengine-cli](https://github.com/volcengine/volcengine-cli) 登录过，则可以直接复用其 profile，无需再次配置。可以通过如下命令查看 profile 列表： ```JSON byted-supabase-cli configure list ``` #### 方式二：通过 Ark CLI 登录如 [通过 Ark CLI 登录并安装 Harness 工具集](https://www.volcengine.com/docs/87275/2557279#VfGfBCni) 小节所述，如果已安装了 Harness 工具集，则可以通过 Ark CLI 进行登录。命令如下： ```Bash # 登录火山账号（推荐浏览器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 工具集并登录的，则无需再进行配置，可跳过本小节。 1. 对于 **Agent Plan 个人版**，需要指定 `--is-agent-plan=true`。 ```JSON byted-supabase-cli configure agent-plan --profile dev --is-agent-plan=true ``` 效果如下：

2. 对于 **Agent Plan 企业版**，除了指定 `--is-agent-plan=true` 之外，还需要通过 `--agent-plan-seat-id` 指定席位 ID。 ```JSON 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`（关闭自动休眠）。 ```JSON byted-supabase-cli --profile dev projects create my-project-1 --suspend-timeout-seconds 3600 ``` 效果如下：

2. 方式 2：单独指定 `--is-agent-plan=true` 和 `--agent-plan-seat-id`，会覆盖 profile 中已配置的 Agent Plan 信息。 ```JSON byted-supabase-cli projects create my-project-2 --suspend-timeout-seconds -1 --is-agent-plan=true --agent-plan-seat-id seat-20260620212706-sxz2k ``` 效果如下：

## 示例以下是基于 Supabase Skill，在 Trae 中通过自然语言从 0 到 1 快速开发一个“待办事项”APP 的过程示例。该过程总共分为四步：创建 Supabase 并开发后端、部署后端、开发前端、测试 APP。 1. ### 创建 Supabase 并开发后端在 Trae 中输入如下文字（可根据实际情况调整）： ```Bash 请基于 Supabase skill，开发一个待办事项 APP 的完整后端，完成编码相关工作，后续我会部署到 Supabase Edge Function 中，具体包括：创建新的Supabase工作区、数据库表设计（todos 表）、RESTful API 接口开发。代码请放到 ~/todo-app-backend。 ``` 效果如下：

2. ### 部署后端（Edge Function）在 Trae 中输入如下文字（可根据实际情况调整）： ```Bash 请将上述待办 APP 后端代码 (~/todo-app-backend) 部署到新创建的Supabase工作区中，完成以下工作：执行数据库初始化 SQL、部署服务到Supabase中、验证各接口可正常访问。 ``` 效果如下：

3. ### 开发前端在 Trae 中输入如下文字（可根据实际情况调整）： ```Bash 后端已就绪，请开发配套的待办 APP 前端页面，要求：支持任务的增删改查、接入 Supabase 后端接口、界面简洁美观、并在本地直接部署运行。代码请放到 ~/todo-app-frontend。 ``` 效果如下：

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

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

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

AI 原生 BaaS 平台 Supabase 版