ElectricCodeGuy/SupabaseAuthWithSSR

解决的问题

该项目提供了一个基于 Next.js 和 Supabase 的生产级 AI 聊天应用启动模板。它超越了简单的文本流式传输，集成了完整的认证系统、基于文档的 RAG、长期记忆以及详细的令牌使用量追踪，大幅减少了构建专业 AI 代理界面所需的样板代码。

工作原理

该应用使用 Vercel AI SDK v7 和 Anthropic 的 Claude 模型。采用两级提示缓存策略以降低输入成本，并实现工具调用架构，使 AI 能够自主触发服务器端函数。这些工具与多种服务集成：Exa 用于网络搜索，Voyage AI 用于嵌入，Mistral 用于 PDF OCR。数据持久化存储在 Supabase 中，利用 pgvector 实现对上传文档的混合向量与关键词搜索（RRF 融合）。

适用人群

希望构建具备用户账户、文件管理与成本监控功能的复杂 AI 聊天平台，但不想从零开始的开发者。

主要亮点

• 全面的 AI 工具套件：包含文档 RAG、网络搜索、用于实时文档编辑的版本化工件工作区、交互式图表和 PDF 生成。
• 生产级认证：完整的 Supabase SSR 认证，包括魔法链接、密码重置，以及所有数据库表的行级安全（RLS）。
• 细粒度使用追踪：每一步的令牌使用量和缓存元数据存储在消息中，支持详细的用户与管理员成本仪表板。
• 长期记忆：持久化记忆系统，使助手能够在不同聊天会话间记住用户信息。
• 详细的向量调优：包含幂等 SQL 设置和 HNSW 索引，实现亚秒级相似性搜索，并提供通过 halfvec 优化索引大小的指导。