用途：为在 Next.js 中实现 Supabase Auth 服务端渲染（SSR）提供编码规范，触发场景为“实现 Supabase 身份认证”时。
主要能力：给出必须遵循的客户端与中间件写法，并列出会破坏应用的废弃模式。
必要用法：
- 浏览器客户端使用 createBrowserClient，来自 @supabase/ssr。
- 服务端客户端使用 createServerClient，来自 @supabase/ssr，并配合 next/headers 的 cookies。
- cookies 只使用 getAll 与 setAll，禁止使用 get、set、remove。
- 中间件使用 createServerClient，必须调用 supabase.auth.getUser()，并原样返回 supabaseResponse，避免会话同步问题。
- 禁止从 @supabase/auth-helpers-nextjs 导入 createMiddlewareClient 或 createClientComponentClient。
常见操作：注册用 signUp，密码登录用 signInWithPassword，登出用 signOut，会话用 getSession，状态变化用 onAuthStateChange；OAuth 用 signInWithOAuth，魔法链接用 signInWithOtp。
限制与后果：错误实现会导致生产环境故障、无法维持会话状态、认证循环与安全漏洞。资料未提供安装命令、版本要求、收费与平台信息。