用途:在用户要求基于 robelest/convex-auth 实现、更新或调试认证时使用,可作为技能复制到其他仓库。任何认证改动前必须先核对上游:优先运行 bash .agents/skills/robel-auth/scripts/check-upstream.sh;脚本不可用时手动阅读官方文档、main 与 release 的 README、分支差异,涉及自托管再读 get-convex/self-hosting 集成文档。若 main 与 release 冲突,按用户指定分支;未指定时建议 release 并说明原因。
主要能力:支持 OAuth(GitHub、Google、Apple、Microsoft,及 custom() 自定义)、密码、邮件魔法链接、Passkey、TOTP、匿名、手机/SMS、群组 SSO(OIDC、SAML 2.0、SCIM 2.0);提供会话、JWT、登录限流、回调及基于 grants 的角色授权配置。
使用方式:先确认分支、框架、是否新建集成、是否需自托管、能否固定 commit。安装先查 npm view @robelest/convex-auth version;不可用则 npm install github:robelest/convex-auth#release 或固定 commit SHA。核心接线为 convex/convex.config.ts 注册组件、convex/auth.ts 用 createAuth 配置、convex/http.ts 用 auth.http.add 注册回调。客户端在 SPA 模式需 client({ convex, api: api.auth })。
限制:官方文档与 main 常超前于 npm 预览版(如 0.0.4-preview.25 实际导出 PascalCase,且无一方 provider 文件),写 import 前须检查 node_modules 内实际导出;不要假设 npm 包可用;正文未提供收费与效果信息,暂未提供。完成任务需报告上游检索时间、所用分支及原因、安装路径、改动文件、后续命令。