AI 占卜 - ChatGPT 塔罗牌占卜

基于 ChatGPT 的 AI 算命、占卜应用，支持多种占卜方式，提供流式输出体验和历史记录管理。

功能列表

• 塔罗牌占卜 - 通过塔罗牌探索内心，洞察未来可能性
• 生辰八字 - 根据出生时间分析命理运势
• 姓名五格 - 通过姓名笔画分析性格和命运
• 周公解梦 - 解析梦境含义，探索潜意识
• 起名取名 - 根据生辰八字和五行推荐吉祥名字
• 梅花易数 - 传统易学占卜方法
• 姻缘占卜 - 分析感情运势和姻缘走向 @alongLFB

特色功能：

• 🌊 流式输出 - AI 占卜结果以打字机效果实时呈现
• 📚 历史记录 - 每种占卜类型自动保存最近 10 条记录
• 📱 响应式设计 - 完美适配手机、平板、电脑
• 🌙 暗色模式 - 支持明暗主题切换

---

四种部署方式

方式一：Vercel 一键部署（推荐）⭐

最简单快捷的部署方式，无需服务器，完全免费。

1. 点击下方按钮开始部署：

   

2. 在部署时配置环境变量：

   • api_key：必填，你的 OpenAI API Key
   • api_base：可选，API 地址（默认为 OpenAI 官方地址）
   • 其他可选参数：model、github_client_id、github_client_secret 等

3. 部署完成后，Vercel 会自动分配一个访问域名

4. 也可以绑定自己的域名

方式二：下载 EXE 安装包（Windows 用户）

1. 点击下载 EXE 安装包
2. 安装并运行程序
3. 在设置中配置：
   • API BASE URL（OpenAI API 地址）
   • API KEY（你的 API 密钥）
4. 返回主页即可开始使用

方式三：Docker 部署

创建 docker-compose.yml 文件：

services:
  chatgpt-tarot-divination:
    image: ghcr.io/dreamhunter2333/chatgpt-tarot-divination:latest
    container_name: chatgpt-tarot-divination
    restart: always
    ports:
      - 8000:8000
    environment:
      - api_key=sk-xxx                    # 必填：OpenAI API Key
      # - api_base=https://api.openai.com/v1  # 可选：API 地址
      # - model=gpt-3.5-turbo              # 可选：模型名称
      # - rate_limit=10/minute             # 可选：速率限制
      # - user_rate_limit=600/hour         # 可选：用户速率限制
      - github_client_id=xxx               # 可选：GitHub OAuth
      - github_client_secret=xxx           # 可选：GitHub OAuth
      - jwt_secret=secret                  # 可选：JWT 密钥
      - ad_client=ca-pub-xxx               # 可选：广告客户端
      - ad_slot=123                        # 可选：广告位

启动服务：

docker-compose up -d

访问 http://localhost:8000 即可使用。

方式四：本地运行（开发者）

前置要求：

• Node.js 16+
• Python 3.8+
• pnpm

步骤：

1. 创建配置文件 - 在项目根目录创建 .env 文件：

api_key=sk-xxxx                         # 必填：OpenAI API Key
api_base=https://api.openai.com/v1      # 可选：API 地址
github_client_id=xxx                     # 可选：GitHub OAuth
github_client_secret=xxx                 # 可选：GitHub OAuth
ad_client=ca-pub-xxx                     # 可选：广告客户端
ad_slot=123                              # 可选：广告位

2. 构建前端：

cd frontend
pnpm install
pnpm build --emptyOutDir
cd ..

3. 部署前端文件：

rm -r dist
cp -r frontend/dist/ dist

4. 安装并运行后端：

python3 -m venv ./venv
./venv/bin/python3 -m pip install -r requirements.txt
./venv/bin/python3 main.py

5. 访问应用 - 打开浏览器访问 http://localhost:8000

---

License

MIT License

chatgpt-tarot-divination 快速上手指南

基于 ChatGPT 的 AI 算命与占卜应用，支持塔罗牌、生辰八字、姓名五格、周公解梦等多种功能，提供流式输出体验。

环境准备

在开始部署前，请确保满足以下系统要求：

• 操作系统：Windows / macOS / Linux
• Node.js：版本 16 或更高（用于构建前端）
• Python：版本 3.8 或更高（用于运行后端）
• 包管理器：推荐安装 pnpm (前端依赖管理)
• API 密钥：有效的 OpenAI API Key (api_key)

安装步骤

本项目提供多种部署方式，请根据需求选择一种：

方式一：Vercel 一键部署（推荐，无需服务器）

适合希望快速上线且无服务器维护成本的用户。

1. 点击下方的部署按钮：

2. 在部署页面配置环境变量：

   • api_key: 必填，填入你的 OpenAI API Key。
   • api_base: 可选，自定义 API 地址（默认使用官方地址）。

3. 部署完成后，获取自动分配的域名即可访问。

方式二：Docker 部署

适合拥有服务器环境的用户。

1. 创建 docker-compose.yml 文件：

services:
  chatgpt-tarot-divination:
    image: ghcr.io/dreamhunter2333/chatgpt-tarot-divination:latest
    container_name: chatgpt-tarot-divination
    restart: always
    ports:
      - 8000:8000
    environment:
      - api_key=sk-xxx                    # 必填：OpenAI API Key
      # - api_base=https://api.openai.com/v1  # 可选：API 地址
      # - model=gpt-3.5-turbo              # 可选：模型名称
      - github_client_id=xxx               # 可选：GitHub OAuth
      - github_client_secret=xxx           # 可选：GitHub OAuth
      - jwt_secret=secret                  # 可选：JWT 密钥

2. 启动服务：

docker-compose up -d

3. 访问 http://localhost:8000。

方式三：本地源码运行（开发者模式）

适合需要二次开发或调试的用户。

1. 创建配置文件：在项目根目录创建 .env 文件并填入配置：

api_key=sk-xxxx                         # 必填：OpenAI API Key
api_base=https://api.openai.com/v1      # 可选：API 地址
github_client_id=xxx                     # 可选：GitHub OAuth
github_client_secret=xxx                 # 可选：GitHub OAuth

2. 构建前端：

cd frontend
pnpm install
pnpm build --emptyOutDir
cd ..

3. 部署前端文件：

rm -r dist
cp -r frontend/dist/ dist

4. 安装依赖并启动后端：

python3 -m venv ./venv
./venv/bin/python3 -m pip install -r requirements.txt
./venv/bin/python3 main.py

Windows 用户提示：也可前往 Releases 页面 下载 EXE 安装包，安装后直接在设置中配置 API Key 即可使用。

基本使用

1. 访问应用：打开浏览器访问部署后的地址（本地默认为 http://localhost:8000）。
2. 选择功能：在主页选择所需的占卜类型，例如：
   • 塔罗牌占卜
   • 生辰八字分析
   • 周公解梦
   • 起名取名
3. 输入信息：根据提示输入相关问题或出生信息。
4. 查看结果：AI 将以打字机效果流式输出占卜解析结果。
5. 历史记录：每种占卜类型会自动保存最近 10 条记录，可在界面中随时查看。