用途：这是一份 Supabase 知识补丁，基线为 2025 年初（supabase-js v2、CLI v1、PostgREST v12、旧版 JWT API key、Deno Edge Functions、Realtime、S3 兼容 Storage、pgvector），覆盖 2025-04-04 至 2026-07-12 的变更。
主要能力：按主题汇总认证与密钥、数据库与 Data API、平台管理与安全、Edge Functions、Realtime、Storage/AI/向量、本地 CLI 与分支、自托管、cron/队列/集成、客户端工具与 MCP 等参考索引。
关键破坏性改动：新项目默认不再自动暴露 public 新表，需显式授权，例如 grant select on table public.catalog to anon, authenticated;；pg_graphql 默认关闭，需 create extension pg_graphql;。托管项目支持 sb_publishable_... 与 sb_secret_... 密钥，放入 apikey 头，并非 bearer JWT。Realtime 自 supabase-js 2.101.0 起必须在 subscribe() 前注册全部 postgres_changes 绑定。.returns() 弃用，改用 .overrideTypes<T>()。Postgres 17 不再支持 TimescaleDB，升级前需禁用 plcoffee、plls、plv8、pgjwt。npm CLI 需 Node 20+ 且不支持全局安装；本地栈升级前先 dump 并运行 supabase stop --no-backup。
使用方式：涉及 Auth、暴露 schema、RLS、签名密钥、网络、备份、分支、自托管 Compose、Realtime 限制或 Storage alpha 功能前，应先阅读对应参考文档。
限制：OAuth 2.1 服务器仅支持授权码加 PKCE 与刷新令牌；重定向 URI 精确匹配、授权码一次性且十分钟有效、不支持自定义 scope，openid 需非对称签名。Broadcast Replay 处于 alpha，仅私密频道。Vector buckets 的维度、float32 类型与距离度量不可变更。Edge Functions 托管 worker 为 256 MB、每请求 2 秒 CPU。