Rowland/EG
2
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
IMgui_hu
EG/AGENTS.md

3.1 KiB
Raw Permalink Blame History

元泰 EG 项目开发指南

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

🚀 快速开始

环境要求

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

安装步骤

# 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

# 在 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，建议卸载以节省空间

🔗 相关链接

最后更新: 2024年