用途：为 Convex 后端首次搭建身份验证，实现用户管理（users 表、身份映射）、认证辅助函数，以及配置认证提供方（Convex Auth、Clerk、WorkOS AuthKit、Auth0、自定义 JWT）。不适用于非 Convex 后端、纯 OAuth/OIDC 文档、与认证无关的调试，或提供方已完全配置仅需一行修复的场景。
主要能力：先确定认证提供方，再按提供方官方指南与本地参考文件（references/convex-auth.md、clerk.md、workos-authkit.md、auth0.md）完成包安装、客户端提供方接线、环境变量、convex/auth.config.ts、登录登出 UI 及 React/Vite/Next.js 框架适配。共享认证行为以 Convex 官方文档为准，包括 ctx.auth.getUserIdentity()、用户存储与授权模式。核心模式是在后端函数中服务端校验身份，而非信任客户端传入的 userId。
使用方式：先询问用户选择哪个提供方，或从仓库依赖（@clerk/、@workos-inc/、@auth0/*、Convex Auth 包）、已有文件与环境变量推断；再确认是仅本地还是生产就绪配置。运行提供方初始化命令后需检查生成文件并完成初始化后接线。仅当应用确实需要 Convex 中的用户文档时才添加应用级用户存储；使用 Convex Auth 时遵循其内置认证表，不要另建 users 表加 storeUser 流程。按需添加所有权、角色或团队访问的授权检查，并使用清晰错误信息（Not authenticated、Unauthorized）。若流程卡在交互式提供方或部署设置，明确请用户完成该人工步骤后继续。
限制：提供方 CLI 与 Convex Auth 内部实现随版本变化，应以官方文档为准，避免凭记忆编造过时步骤。资料未提供具体安装命令、价格或平台支持细节。