介绍
## ⚠️ Security Notice
此技能包含带有命令示例的 Supabase 文档。命令仅供参考，切勿在没有明确用户批准的情况下由代理自动执行。
# Supabase 文档
嵌入在 markdown 中的完整 Supabase 平台文档。请阅读 `references/` 以回答有关身份验证、数据库、存储、边缘函数和平台功能的问题。
## 文档结构
所有文档均位于 `references/guides/` 中，并按产品组织：
### 入门 (`references/guides/getting-started/`) - 快速入门指南 - 架构概览 - 框架集成 - 数据库基础
### 身份验证 (`references/guides/auth/`) 完整的身份验证系统文档： - 邮箱与密码认证 - OAuth 提供商（Google、GitHub 等） - 魔法链接 - 手机认证（SMS、WhatsApp） - SSO 与 SAML - 多因素身份验证 (MFA) - 行级安全 (RLS) - 用户管理 - 服务端认证 - 重定向 URL - 会话管理
### 数据库 (`references/guides/database/`) PostgreSQL 数据库功能： - 表和列 - 关系和外键 - 函数和触发器 - 扩展 - 全文搜索 - Postgres 角色 - 复制 - 连接池 - Webhooks - 迁移
### 存储 (`references/guides/storage/`) 文件存储和 CDN： - 上传文件 - 下载文件 - 删除文件 - 列出文件 - 转换图片 - CDN 和缓存 - 使用 RLS 进行访问控制 - 可恢复上传
### 边缘函数 (`references/guides/functions/`) 无服务器函数： - 入门 - 部署函数 - 环境变量 - 密钥管理 - 数据库访问 - 身份验证集成 - 日志和监控 - 冷启动优化
### 实时 (`references/guides/realtime/`) 实时订阅： - Postgres 变更（插入、更新、删除） - 广播消息 - 在线状态跟踪 - 授权
### AI 与嵌入 (`references/guides/ai/`) AI 和向量功能： - 嵌入和向量搜索 - pgvector 扩展 - 相似度搜索 - RAG 模式 - AI 集成（OpenAI 等）
### 平台 (`references/guides/platform/`) 平台管理： - 组织 - 项目 - 计费 - 日志和监控 - 性能调优 - 备份 - 自定义域名 - SSL 证书
### 自托管 (`references/guides/self-hosting/`) 自托管 Supabase： - Docker 设置 - 配置 - 监控 - 备份和恢复
### 定时任务 (`references/guides/cron/`) 使用 pg_cron 执行计划任务
### 队列 (`references/guides/queues/`) 使用 pgmq 处理后台作业队列
### 集成 (`references/guides/integrations/`) 第三方集成和工具
### 本地开发 (`references/guides/local-development/`) - CLI 设置 - 本地 Studio - 数据库迁移 - 测试 - CI/CD
### 故障排除 (`references/troubleshooting/`) 常见问题和解决方案
### 错误代码 (`references/errorCodes/`) API 和数据库错误参考
## 快速参考
### 常见任务
| 任务 | 检查目录 | |------|-------------------| | 设置 Supabase | `guides/getting-started/` | | 邮箱认证 | `guides/auth/` | | OAuth 提供商 | `guides/auth/` | | 数据库架构 | `guides/database/` | | RLS 策略 | `guides/auth/` + `guides/database/` | | 文件上传 | `guides/storage/` | | 边缘函数 | `guides/functions/` | | 实时订阅 | `guides/realtime/` | | 向量搜索 | `guides/ai/` | | 迁移 | `guides/database/` + `guides/local-development/` | | 框架集成 | `guides/getting-started/` | | 自托管 | `guides/self-hosting/` |
### 框架集成
Supabase 支持以下框架： - Next.js (App Router、Pages Router、Server Components) - React (Create React App、Vite) - SvelteKit - Nuxt - Vue - Angular - Flutter - React Native - 以及更多...
### 使用此技能的时机
- 设置 Supabase 身份验证 - 使用 PostgreSQL 进行数据库架构设计 - 行级安全 (RLS) 策略 - 文件存储和 CDN - 部署边缘函数 - 实时订阅 - 向量搜索和 AI 功能 - 从其他平台迁移 - 自托管 Supabase - 性能优化 - 排查错误
### 如何浏览
1. **从 `guides/getting-started/` 开始** 进行设置 2. **对于身份验证：** 浏览 `guides/auth/` 3. **对于数据库：** 查看 `guides/database/` 4. **对于存储：** 查看 `guides/storage/` 5. **对于函数：** 使用 `guides/functions/` 6. **对于实时：** 查看 `guides/realtime/` 7. **对于 AI：** 查看 `guides/ai/` 8. **对于错误：** 查看 `troubleshooting/` 和 `errorCodes/`
所有文件均为 `.mdx` (Markdown + JSX) 格式，但可作为纯 markdown 阅读。