EG/requirements/DEPLOYMENT_README.md

项目部署指南

🚀 在新电脑上运行此项目

方法1：使用Conda（推荐）

# 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

# 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+）