# 元泰 EG 项目开发指南

元泰 EG 是基于 Panda3D 的 3D 编辑器和游戏引擎。

---

## 🚀 快速开始

### 环境要求

- **Python 3.11.x**（必须）
- Windows 10/11 64位
- Visual Studio Build Tools（用于构建）

### 安装步骤

```bash
# 1. 检查 Python 版本（必须是 3.11）
python --version

# 2. 验证版本
python build_scripts/check_python_version.py

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

# 4. 运行程序
python Start_Run.py
```

---

## 📦 构建安装程序

### Windows

```powershell
# 在 VS Dev Shell 中执行
.\build_scripts\build_windows.ps1 -Version "1.0.0"
```

详细步骤请参考 `build_scripts/BUILD_GUIDE.md`

---

## 🗂️ 项目结构

```
元泰 EG/
├── AGENTS.md                    # 本文件
├── main.py                      # 主程序入口
├── Start_Run.py                 # 启动脚本
├── requirements/                # 依赖配置
│   ├── requirements-minimal.txt # 最小依赖（推荐）
│   └── requirements.txt         # 完整依赖（旧）
├── build_scripts/               # 构建脚本和文档
│   ├── build_windows.ps1        # Windows 构建脚本
│   ├── build_linux.sh           # Linux 构建脚本
│   ├── BUILD_GUIDE.md           # 构建指南 ⭐
│   ├── BUILD_README.md          # 构建说明
│   ├── INSTALLER_GUIDE.md       # 完整指南
│   ├── QUICK_REFERENCE.md       # 快速参考
│   ├── ICON_GUIDE.md            # 图标准备
│   ├── PYTHON_VERSION_REQUIREMENT.md  # Python版本要求
│   └── PACKAGING_CHECKLIST.md   # 打包检查清单
├── core/                        # 核心模块
├── RenderPipelineFile/          # 渲染管线
├── Resources/                   # 资源文件
└── ...
```

---

## 🛠️ 技术栈

- **Python**: 3.11.x（必须）
- **渲染引擎**: Panda3D 1.10.16
- **UI框架**: imgui_bundle + p3dimgui
- **VR支持**: OpenVR 2.2.0
- **图像处理**: Pillow

### 已移除的依赖

为减少体积，已移除以下未使用的依赖：

- ❌ PyQt5 (~50MB)
- ❌ PySide6 (~100MB)
- ❌ 相关 Qt 配套库 (~20MB)

**总计节省 ~170MB**

---

## 📚 重要文档

| 文档 | 位置 | 用途 |
|------|------|------|
| 构建指南 | `build_scripts/BUILD_GUIDE.md` | 从零开始构建 ⭐ |
| Python版本要求 | `build_scripts/PYTHON_VERSION_REQUIREMENT.md` | Python 3.11 安装指南 |
| 快速参考 | `build_scripts/QUICK_REFERENCE.md` | 命令速查 |
| 打包检查清单 | `build_scripts/PACKAGING_CHECKLIST.md` | 构建前检查 |

---

## ⚠️ 重要提示

1. **Python 版本**: 必须使用 3.11，构建脚本会检查
2. **构建环境**: Windows 必须在 VS Dev Shell 中构建
3. **清理旧依赖**: 如果之前有安装 PyQt5/PySide6，建议卸载以节省空间

---

## 🔗 相关链接

- Python 3.11: https://www.python.org/downloads/release/python-3119/
- Visual Studio Build Tools: https://visualstudio.microsoft.com/visual-cpp-build-tools/

---

**最后更新**: 2024年
