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 Start_Run.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 requirements/requirements.txt

# 4. 运行项目
python Start_Run.py

📁 需要复制的文件

必须复制：

• main.py - 主程序
• environment.yml - Conda环境配置
• requirements.txt - 核心依赖

不要复制：

• .conda/ - 虚拟环境文件夹
• __pycache__/ - Python缓存
• conda-requirements.txt - 仅用于最小 Conda 环境说明

🔧 Cursor IDE 设置

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

📦 项目依赖说明

• Panda3D: 3D图形引擎
• imgui-bundle / p3dimgui: ImGui 编辑器界面与 Panda3D 桥接
• Pillow: 图像处理与网页截图纹理转换
• numpy: VR / SSBO 数值处理
• aiohttp: 异步资源与场景 IO
• openvr: VR 支持
• pyassimp: 模型转换辅助

🌍 跨平台注意事项

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

🐛 常见问题

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

Q: ImGui界面显示异常？ A: 检查显卡驱动/OpenGL支持，并确认已安装 imgui-bundle

Q: 导入错误？ A: 检查 Python 版本，当前项目统一使用 Python 3.11。