README.md

---
title: PokerGameDesigner
emoji: 🃏
colorFrom: green
colorTo: pink
sdk: gradio
sdk_version: 5.44.1
app_file: app.py
pinned: false
short_description: AI-driven poker game designer agent
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

UI应用地址：https://huggingface.co/spaces/Estazz/PokerGameDesigner

## ✨ 最新更新 (v1.1)

🎉 **自动预加载功能** - 无需手动上传文件！
- ✅ 系统自动加载 GDL 规范和 System Prompt
- ✅ 启动后可直接开始对话
- ✅ 大幅降低使用门槛，更易推广
- 详见 [UPDATE_NOTES.md](UPDATE_NOTES.md) 和 [QUICKSTART.md](QUICKSTART.md)

## 📁 代码结构说明

```
DDZ_Designer_Web_UI_Huggingface/
├── app.py                       # 主应用文件（优化后）
├── config.py                    # 配置管理
├── styles.py                    # CSS样式定义
├── ai_service.py                # AI服务逻辑（支持自动加载）
├── file_handler.py              # 文件处理
├── cache_manager.py             # 缓存管理
├── security.py                  # 安全验证
├── default_content.py           # ⭐ 新增：默认内容加载模块
├── 牌型压制类游戏通用语法.txt    # ⭐ 必需：默认GDL规范
├── prompt.txt                   # ⭐ 必需：默认System Prompt
├── env_example.txt              # 环境变量示例
├── README.md                    # 本文件
├── QUICKSTART.md                # 快速开始指南
├── UPDATE_NOTES.md              # 更新说明
└── DEPLOY_TO_HF.md              # Hugging Face部署指南
```

## 🚀 快速开始
### 1. 环境配置（可选）
```bash
# 如果需要通过环境变量覆盖默认配置
export DEEPSEEK_API_KEY="your-api-key-here"
export DEEPSEEK_BASE_URL="your-base-url-here"
export MODEL_NAME="DeepSeek-V3-0324"
```
注：默认配置已在 `config.py` 中设置，无需额外配置环境变量即可运行。

### 2. 安装依赖
```bash
pip install -r requirements.txt
# 或手动安装
pip install gradio openai
```

### 3. 运行应用
```bash
python app.py
```

### 4. 开始使用 🎯
✅ **无需任何额外配置！** 系统已自动预加载 GDL 规范和 Prompt
- 直接在聊天框输入需求即可开始设计游戏
- 例如：`设计一个适合3人的快节奏扑克游戏，时长10分钟`

**可选**：如需自定义配置
- 上传自己的 GDL 规范文件（左侧面板）
- 输入自定义 System Prompt（左侧面板）

---

## 🔄 API迁移说明

本项目已从阿里云DashScope API迁移到DeepSeek V3 API（OpenAI兼容格式）。
详细迁移信息请查看 [MIGRATION_GUIDE.md](MIGRATION_GUIDE.md)