Tarot Agent - 东方极简 AI 塔罗占卜

Tarot Agent 是一款融合了东方编辑部极简主义（Eastern Editorial Minimalism）美学与前沿 AI 技术的塔罗占卜应用。它不仅仅是一个电子抽牌工具，更是一个能够理解用户意图、动态设计牌阵并提供深度解读的 AI 塔罗导师。

✨ 核心特性

• 🤖 AI 智能规划 (Custom Mode)：Agent 会根据用户的具体问题，动态设计最适合的定制牌阵，而非死板的固定模板。
• 🎨 东方极简美学：遵循“疏朗、宁静、克制”的设计原则，采用大面积留白、精致的排版和柔和的动效，提供沉浸式的冥想体验。
• 🃏 交互式抽牌体验：支持动态牌阵展示、物理感抽牌交互以及实时流式解读输出。
• 💬 富交互对话流：将牌阵、抽牌、解读等功能组件无缝嵌入聊天流中，实现如同人生 K 线图般的富媒体交互。
• 🌍 多语言支持：内置国际化支持，提供中英文双语体验及专业的塔罗牌义库。
• 💳 商业化集成：集成 Stripe 支付系统，支持订阅制与兑换码，提供完善的用户鉴权与历史记录管理。

🛠️ 技术栈

• 框架: Next.js 14 (App Router)
• 语言: TypeScript
• 样式: Tailwind CSS + Framer Motion
• 组件库: Shadcn UI + Coss UI + AI Elements
• 运行时: Bun
• 数据库/ORM: PostgreSQL + Drizzle ORM
• AI 能力: Vercel AI SDK + OpenAI
• 支付: Stripe
• 认证: NextAuth.js

🚀 快速开始

1. 安装依赖

推荐使用 bun 以获得最佳性能：

bun install

2. 环境配置

复制 .env.example 为 .env 并填写相关配置：

cp .env.example .env

需要配置的关键变量包括：

• DATABASE_URL: PostgreSQL 连接字符串
• OPENAI_API_KEY: OpenAI API 密钥
• STRIPE_SECRET_KEY: Stripe 密钥
• NEXTAUTH_SECRET: NextAuth 密钥

3. 数据库初始化

运行以下命令进行数据库迁移和基础数据同步：

bun db:init
bun db:migrate

4. 启动开发服务器

bun dev

访问 http://localhost:3000 即可预览。

🎨 设计规范

本项目遵循严格的 设计规范：

• 色彩: 基于 OKLCH 空间，以纯白背景（#fff）和纯黑文字（#000）为主。
• 排版: 使用大字号标题（4xl-6xl），衬线体（font-serif）用于标题，细体（font-light）用于正文。
• 质感: 苹果风格液态玻璃感（Apple Liquid Glass），背景模糊，半透明表面。

📖 文档

• API 文档
• SEO 策略
• Tarot Agent 功能规格

---

Built with 🖤 by the Tarot Agent Team.