# 项目部署指南

## 🚀 在新电脑上运行此项目

### 方法1：使用Conda（推荐）

```bash
# 1. 安装Miniconda
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh

# 2. 克隆项目
git clone <your-repo-url>
cd eg

# 3. 创建conda环境
conda env create -f environment.yml

# 4. 激活环境
conda activate eg-project

# 5. 运行项目
python main.py
```

### 方法2：使用virtualenv + pip

```bash
# 1. 克隆项目
git clone <your-repo-url>
cd eg

# 2. 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或 venv\Scripts\activate  # Windows

# 3. 安装依赖
pip install -r clean-requirements.txt

# 4. 运行项目
python main.py
```

## 📁 需要复制的文件

**必须复制：**
- `main.py` - 主程序
- `gui_preview_window.py` - GUI窗口
- `demo/` - 演示文件夹
- `environment.yml` - Conda环境配置
- `clean-requirements.txt` - 核心依赖

**不要复制：**
- `.conda/` - 虚拟环境文件夹
- `__pycache__/` - Python缓存
- `requirements.txt` - 包含系统包的混乱依赖

## 🔧 Cursor IDE 设置

1. **打开项目**：在Cursor中打开项目文件夹
2. **选择解释器**：
   - `Ctrl+Shift+P` → "Python: Select Interpreter"
   - 选择虚拟环境中的Python路径
3. **验证环境**：检查状态栏显示正确的Python版本

## 📦 项目依赖说明

- **Panda3D**: 3D图形引擎
- **PyQt5/PySide6**: GUI框架
- **Pillow**: 图像处理
- **python-dotenv**: 环境变量管理
- **pyassimp**: 3D模型加载

## 🌍 跨平台注意事项

- Linux/Mac: 使用 `source venv/bin/activate`
- Windows: 使用 `venv\Scripts\activate`
- 某些依赖可能需要系统级安装（如OpenGL库）

## 🐛 常见问题

**Q: 无法安装Panda3D？**
A: 确保系统有OpenGL支持，或使用conda安装

**Q: PyQt5无法运行？**
A: 可能需要安装系统级GUI依赖

**Q: 导入错误？**
A: 检查Python版本（需要3.10+）