SuperAPI AI 工具集

neon-auth

编程与开发

查看项目

更新于 10-15 15:38

技能介绍

Neon Auth Integration 用于为应用添加身份认证。

用途 该技能适合以下场景:为新项目或已有项目添加认证;实现登录、注册和会话管理;配置社交认证(Google、GitHub)。

包说明 使用 @neondatabase/auth 包,该包仅包含认证功能,体积较小。如果同时需要数据库查询,官方建议改用 neon-js 技能,它提供 @neondatabase/neon-js,整合认证与数据 API。

代码生成规则 在生成 TypeScript/JavaScript 代码时需遵循以下规则:生成导入前检查 tsconfig.json 中的路径别名;如不确定或不存在别名,使用相对导入;BetterAuthReactAdapter 必须从 auth/react/adapters 子路径导入;适配器是工厂函数,需以 () 调用;CSS 导入方式只能选择一种(Tailwind 或 CSS,不可同时使用)。完整参考见 Code Generation Rules,涵盖导入路径处理、Neon 包导入(子路径导出、适配器模式)、CSS 导入策略(Tailwind 检测、单一导入方式)和文件结构模式。

可用指南 每份指南都是完整、自包含的分阶段操作说明:guides/nextjs-setup.md 为完整的 Next.js App Router 设置指南;guides/react-spa-setup.md 为结合 react-router-dom 的 React SPA 详细指南。该技能会自动检测上下文(包管理器、框架、现有配置),并根据请求选择合适的指南。故障排查见 references 中的 Troubleshooting Guide。

使用方式示例 只需描述正在构建的内容即可,例如:“为我的 Next.js 应用添加认证”会加载设置指南并配置认证路由;“设置 Google 登录”会配置社交认证提供商;“调试我的认证会话无法保持”会加载故障排查指南。

参考文档 主要资源:neon-auth.mdc,包含所有认证方式(邮箱密码、社交、魔法链接)、会话数据结构、UI 组件参考和错误处理。框架特定设置:Next.js、React SPA、Node.js。框架特定 UI:Next.js、React SPA。共享参考:Common Mistakes(导入路径、适配器模式、CSS)、Troubleshooting Guide(错误解决方案)、Code Generation Rules(导入与 CSS 策略)、Auth Adapters Guide(适配器对比)、Import Reference(完整导入路径)。

模板 templates/nextjs-api-route.ts 为 Next.js 的 API 路由处理程序;templates/auth-client.ts 为客户端认证配置。

相关技能 neon-js:含认证与数据库查询的完整 SDK;neon-drizzle:Drizzle ORM 设置;neon-serverless:直接数据库连接;add-neon-docs:将 Neon 最佳实践添加到项目文档(设置后运行)。

工作流程 自动检测项目上下文(Next.js、React SPA、Node.js);选择并加载合适的指南;按指南阶段依次执行;使用指南的工作流清单跟踪进度;仅在需要时加载参考文件;可选将 Neon 最佳实践添加到项目文档。

限制 资料未提供收费、价格、平台支持范围、性能效果等具体信息,暂未提供。