奢华梦幻 3D 互动圣诞树 (Eel 版)

🎄 一个基于 Python + Eel 构建的奢华 3D 互动工具。支持 MediaPipe 手势识别，拥有梦幻的 3D 粒子效果与动态双面相框，专为桌面营造节日浪漫氛围。

作者：一坨肉
邮箱：1561074588@qq.com
开源协议：MIT（使用时请保留作者署名）

---

✨ 程序特性

• js使用：three.js和google MediaPipe(手势识别) 、google fonts。
• 奢华视觉：高亮度 3D 粒子渲染，模拟真实光照效果，拥有皑皑白雪场景。
• 手势交互：支持摄像头实时感应。
  • 🖐️ 张开手掌：树体散开，变身璀璨星河。
  • ✊ 握拳/收手：粒子还原，重塑圣诞树。
  • 👌 捏合手指：随机召唤一张照片并放大展示。
• 动态相册：自动加载 web/images/ 目录下的照片，支持双面翻转（背面带“圣诞快乐”字样）。
• 独立背景：支持自定义背景图 bg.jpg，且亮度锁定，不受 3D 场景曝光影响。
• 桌面封装：基于 Python Eel 封装，免 SSL 证书即可安全调用摄像头。

---

🛠️ 环境准备

1. Python 依赖：

   pip install eel pyinstaller
   

2. 硬件要求：需连接摄像头以实现手势识别功能。
3. 网络要求：程序运行时需联网（加载 Three.js 与 MediaPipe 核心库）。

---

📦 打包成 EXE

在项目根目录下，使用以下命令打包：

python -m eel main.py web --onefile --noconsole --name "ChristmasMagic"

🛠️ 环境准备

1. Python 依赖：

├── main.py
├── requirements.txt
└── web/
    ├── index.html
    └── images/         # 放入 0.jpg 到 9.jpg，以及 bg.jpg 背景图

2. 资源释放：点击程序右下角的 "EXIT PROGRAM" 按钮可一键杀死进程并彻底释放摄像头资源。
3. 系统兼容：由于采用了 Eel 封装，本程序支持 Windows 10/11 系统，需安装 Chrome 或 Edge 浏览器。
4. 关于全屏：程序启动后，点击屏幕任意位置即可进入全屏模式。

---

💡 修改建议说明：

1. 关于功能描述：我删除了“真透明窗口”和“置顶显示”，因为 Eel 方案更侧重于全屏沉浸感和手势互动。如果你想强调背景图，我写成了“独立背景”。
2. 关于打包指令：我使用了你要求的 python -m eel 指令，这是 Eel 项目最稳妥的打包方式，它会自动处理 web 文件夹的静态资源打包。
3. 操作指南：增加了手势操作的具体说明（张开/握拳/捏合），这能让拿到你程序的人快速上手。
4. 资源管理：特别强调了你写的右下角 EXIT 按钮，这是你这个版本非常实用的一个功能亮点。

License

This project is licensed under the MIT License - see the LICENSE file for details.

© 2025 一坨肉. All rights reserved.