> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Supabase 集成

[Supabase](https://supabase.com/) 是一个开源的 Firebase 替代方案，提供 PostgreSQL 数据库、用户认证、文件存储和实时数据同步等后端服务。Quest 支持直接授权并连接 Supabase 项目，让你在 IDE 内一站式完成前端开发与后端数据管理，无需在浏览器和编辑器之间来回切换。

你可以同时连接多个 Supabase 项目，并在 IDE 内直接预览数据库表结构（Schema），实时掌握后端数据模型。

**核心功能：**

* **多项目连接**：支持授权并连接多个 Supabase 项目，方便在不同环境（开发、测试、生产）或不同业务之间快速切换。
* **数据库表结构预览**：在 IDE 内直接查看已连接项目的数据库表结构，包括表名、字段、类型和关系等信息，无需打开 Supabase Dashboard。
* **增强的数据库能力**：AI 智能体可以感知你的数据库结构，根据任务需求自动生成建表语句、数据模式和查询逻辑，确保前后端数据模型一致。
* **一键授权**：通过 OAuth 授权流程安全连接 Supabase，无需手动配置 API Key 或连接字符串。

**支持的 Supabase 服务：**

* **数据库（PostgreSQL）** — 完整的 SQL 支持，用于存储和查询应用数据。AI 可根据你的指令自动生成所需的表和数据模式。详情参阅 [Supabase Database 文档](https://supabase.com/docs/guides/database/overview)。
* **用户认证** — 安全管理用户注册、登录和访问权限。支持多种认证方式，包括邮箱/密码登录以及 Google、GitHub 等 OAuth 登录。详情参阅 [Supabase Auth 文档](https://supabase.com/docs/guides/auth)。
* **文件存储** — 通过 Supabase Storage 上传和管理图片或其他文件，适用于用户头像、文件上传及各种静态媒体资源。详情参阅 [Supabase Storage 文档](https://supabase.com/docs/guides/storage)。
* **实时更新** — 将数据变更实时推送到应用，支持在线聊天、动态信息流、协作式仪表板等场景。详情参阅 [Supabase Realtime 文档](https://supabase.com/docs/guides/realtime)。

**如何使用：**

在 Quest 下构建项目时，如果 AI 判断有必要连接 Supabase，它会在聊天面板中给出提示。你也可以随时主动连接：

<Steps>
  <Step title="准备 Supabase 项目">
    前往 [Supabase](https://supabase.com/) 注册账号，并创建组织和项目。
  </Step>

  <Step title="授权连接">
    在 Quest 中，点击工具面板顶部的 **Supabase** 标签页，点击 **Authorize** 按钮，按照提示完成 OAuth 授权流程，选择你的 Supabase 组织并确认授权。
  </Step>

  <Step title="关联项目">
    授权完成后，面板中会显示你的组织和项目列表。找到目标项目，点击 **Connect** 按钮即可将当前 Quest 项目与 Supabase 项目关联。
  </Step>

  <Step title="开始开发">
    连接成功后，你可以直接在 Supabase 面板中预览数据库表结构，AI 也将基于这些结构信息辅助你的开发工作。
  </Step>
</Steps>

<Tip>Qoder 项目只能连接到处于活跃状态的 Supabase 项目。如需切换组织，可点击组织名称旁的切换按钮。</Tip>

**适用场景：**

* **全栈应用快速搭建**：在 Quest 中描述应用需求，AI 自动生成前端界面并配置 Supabase 后端，包括数据库建表、认证流程和存储策略。
* **数据模型设计与验证**：通过 IDE 内的表结构预览，实时检查 AI 生成的数据模型是否符合预期，及时调整后继续开发。
* **多环境管理**：同时连接开发和生产环境的 Supabase 项目，在不同环境之间方便地查看和对比数据结构。

<Warning>
  AI 生成的数据库操作（如建表、修改 Schema）会直接作用于已连接的 Supabase 项目。对生产环境的操作，请在确认无误后再执行。
</Warning>

<Note>
  * **权限安全**：授权过程通过 OAuth 进行，Qoder 不会存储你的 Supabase 密码。建议仅授权必要的组织和项目，遵循最小权限原则。
  * **网络依赖**：Supabase 集成需要网络连接以访问 Supabase 云端服务。请确保网络环境正常。
</Note>
