clerk-sdk-patterns

用途：整理 Clerk SDK 在服务端、客户端、中间件和第三方集成中的常见用法与最佳实践。主要能力包括：服务端用 @clerk/nextjs/server 的 auth() 做轻量认证与权限判断，用 currentUser() 获取完整用户资料；客户端用 @clerk/nextjs 的 useUser、useAuth、useClerk 等 Hook 获取用户、令牌与登录界面；用 clerkMiddleware 和 createRouteMatcher 保护路由并放行公开路径；用 orgId 做组织范围数据查询；用 getToken({ template: 'supabase' }) 生成自定义 JWT 供 Supabase 等外部服务使用。用法要点：在 Clerk Dashboard 的 JWT Templates 配置模板与 claims；确保 ClerkProvider 包裹组件树；服务端方法只用于服务端组件或 API 路由。限制：资料给出部分错误排查表，但未提供完整依赖版本、计费或平台细节；实际效果需以官方文档和运行环境为准。