README.md

metadata

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 和 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. 环境配置（可选）

# 如果需要通过环境变量覆盖默认配置
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. 安装依赖

pip install -r requirements.txt
# 或手动安装
pip install gradio openai

3. 运行应用

python app.py

4. 开始使用 🎯

✅ 无需任何额外配置！ 系统已自动预加载 GDL 规范和 Prompt

• 直接在聊天框输入需求即可开始设计游戏
• 例如：设计一个适合3人的快节奏扑克游戏，时长10分钟

可选：如需自定义配置

• 上传自己的 GDL 规范文件（左侧面板）
• 输入自定义 System Prompt（左侧面板）

---

🔄 API迁移说明

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