火山引擎 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 抵扣
- 在方舟控制台，开通"Agent Plan 个人版"或"Agent Plan 企业版"，按需选择套餐。
- 在 Harness 页面，找到"火山引擎 Supabase"卡片，开启"开启抵扣"，开启"超额后付费"（强烈建议），并点击"配置使用"进行授权。
- 开通后，通过 Agent Plan 购买 Supabase，即可在 Agent Plan 的用量统计页面查看 Supabase 消耗的 AFP，如下所示。
安装 / 更新 Supabase CLI 及 Skills
方式一：直接安装 / 更新 Supabase CLI 及 Skills
- 本地安装 node.js（含 npm 和 npx）
参考node.js 官方网站 ，按照网站指引安装 node.js 包（含 npm 管理器和 npx 工具）。
- 本地安装火山引擎 Supabase CLI 及 Skills：
css
npx @byted-supabase/cli@latest install- 本地更新火山引擎 Supabase CLI 及 Skills：
sql
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。
ruby
# 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：通过默认方式（浏览器 OAuth）进行登录（推荐）。 命令如下，其中，profile 缺省为
default，示例中指定为dev；地域（region）缺省为cn-beijing。执行后，就会自动在浏览器中弹出火山引擎 OAuth 登录页，输入账号信息登录即可。
css
byted-supabase-cli login --profile dev --region cn-beijing效果如下：
- 途径 2：采用火山 AK/SK 配置 profile。 其中，profile 缺省为
default，示例中指定为dev；地域（region）缺省为cn-beijing。
css
byted-supabase-cli configure set --profile dev --access-key <AK> --secret-key <SK> --region cn-beijing-
途径 3：复用 volcengine-cli 的 profile。 如果用户已经通过 volcengine-cli 登录过，则可以直接复用其 profile，无需再次配置。可以通过如下命令查看 profile 列表：
byted-supabase-cli configure list
方式二：通过 Ark CLI 登录
如 "通过 Ark CLI 登录并安装 Harness 工具集" 小节所述，如果已安装了 Harness 工具集，则可以通过 Ark CLI 进行登录。命令如下：
shell
# 登录火山账号（推荐浏览器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 工具集并登录的，则无需再进行配置，可跳过本小节。
- 对于"Agent Plan 个人版"，需要指定
--is-agent-plan=true。
ini
byted-supabase-cli configure agent-plan --profile dev --is-agent-plan=true
- 对于"Agent Plan 企业版"，除了指定
--is-agent-plan=true之外，还需要通过--agent-plan-seat-id指定席位 ID。
css
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：指定上述已配置 Agent Plan 信息的 profile。同时可以通过
--suspend-timeout-seconds来指定自动休眠时间（秒数），缺省值为-1（关闭自动休眠）。
css
byted-supabase-cli --profile dev projects create my-project-1 --suspend-timeout-seconds 3600效果如下：
- 方式 2：单独指定
--is-agent-plan=true和--agent-plan-seat-id，会覆盖 profile 中已配置的 Agent Plan 信息。
css
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：通过默认方式（浏览器 OAuth）进行登录（推荐）。 在 Trae 中输入如下文字，就会自动在浏览器中弹出火山引擎 OAuth 登录页，输入账号信息即可登录。
使用火山supabase skill进行登录
当然，也可明确指定登录方式、profile 等（可根据实际情况调整）。
创建火山引擎supabase的profile dev；并通过OAuth方式进行登录。效果如下：
自动弹出的浏览器登录页如下：
- 途径 2：采用火山 AK / SK 配置 profile。 在 Trae 中输入如下文字（可根据实际情况调整），Trae 就会自动调用 CLI 命令进行配置。
swift
帮我配置supabase的profile，并作为后续操作的默认profile。* 名称：dev* AK：test-ak* SK：test-sk* region：cn-beijing效果如下：
配置 Agent Plan 信息
-
对于"Agent Plan 个人版"，指定默认采用 Agent Plan 模式。在 Trae 中输入如下文字（请根据实际情况调整）。
设置 profile dev 默认采用 agent plan 模式
效果如下：
-
对于"Agent Plan 企业版"，指定默认采用 Agent Plan 模式，并需要同时指定席位 ID（请根据实际情况调整）。
设置 profile dev 采用 企业版 agent plan 模式，席位ID 为 "seat-xxxx"
效果如下：
创建 Supabase 工作区
在 Trae 中输入如下文字来创建 Supabase 工作区（Workspace）。可选指定自动休眠时间，默认关闭自动休眠。
perl
使用 profile dev，创建一个 Supabase workspace，名称为 my-project-3。或
perl
使用 profile dev，创建一个 Supabase workspace，名称为 my-project-4，自动休眠时间为3600秒。效果如下：
开发 APP 示例
可以基于 Supabase Skill，通过自然语言从 0 到 1 快速开发 APP。
以下展示开发一个"待办事项"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 自动完成了后端开发、后端部署、前端开发等步骤，大幅提高了软件开发效率。