Files
musk a8df3b5b7c 🐍 升级开发环境到Python 3.12.9 - 完美匹配ComfyUI环境
✨ 环境升级亮点:
- 成功升级到Python 3.12.9,与ComfyUI环境完全匹配
- 创建专用虚拟环境,确保依赖隔离
- 升级所有依赖到最新兼容版本 (torch 2.8.0, numpy 2.3.2等)

🔧 配置文件更新:
- 更新pyproject.toml支持Python 3.12
- 添加.python-version指定项目Python版本
- 优化black和mypy配置适配新版本

🛠️ 开发工具套件:
- verify_env.py: 完整环境验证脚本
- setup_dev_env.sh: 自动化环境设置脚本
- switch_to_python312.sh: 快速环境切换脚本
- PYTHON_UPGRADE_GUIDE.md: 详细升级指南

🩹 问题解决方案:
- fix_lzma.sh: lzma模块问题自动修复脚本
- FIX_LZMA_ISSUE.md: lzma问题详细解决指南
- 智能处理torchvision导入问题,不影响核心功能

🧪 验证结果:
- ✅ Python 3.12.9 - 完美匹配ComfyUI环境
- ✅ 虚拟环境正常运行
- ✅ 所有核心依赖正确安装
- ✅ ComfyUI兼容性验证通过 (3个节点正常注册)
- ✅ Git仓库状态正常

📊 代码统计:
- 新增文件: 7个 (配置、脚本、文档)
- 修改文件: 1个 (pyproject.toml)
- 新增脚本行数: ~400行
- 新增文档行数: ~200行

💡 开发体验改进:
- 一键环境验证和问题诊断
- 自动化环境设置流程
- 完善的问题解决方案
- 详细的升级和维护文档
- 智能错误处理和用户友好提示

🎯 兼容性保证:
- 完全匹配ComfyUI Python 3.12.9环境
- 向下兼容Python 3.8+的项目配置
- 优雅处理依赖问题,确保核心功能可用
- 提供多种问题解决方案

🚀 现在开发环境已完全准备就绪,支持高效的ComfyUI节点开发!
2025-08-27 16:52:51 +08:00

83 lines
2.1 KiB
Bash
Executable File

#!/bin/bash
# ComfyUI Popo Utility 开发环境设置脚本
set -e
echo "🚀 ComfyUI Popo Utility 开发环境设置"
echo "====================================="
# 检查Python版本
REQUIRED_PYTHON="3.12.9"
CURRENT_PYTHON=$(python --version 2>&1 | cut -d' ' -f2)
echo "📋 环境检查:"
echo " 需要 Python: ${REQUIRED_PYTHON}"
echo " 当前 Python: ${CURRENT_PYTHON}"
# 检查是否需要安装Python 3.12.9
if ! command -v python3.12 &> /dev/null; then
echo "⚠️ Python 3.12 未找到"
echo "🔧 安装建议:"
echo ""
echo " 方法1: 使用pyenv安装 (推荐)"
echo " pyenv install 3.12.9"
echo " pyenv local 3.12.9"
echo ""
echo " 方法2: 使用Homebrew安装"
echo " brew install python@3.12"
echo ""
echo " 方法3: 从官网下载"
echo " https://www.python.org/downloads/"
echo ""
else
echo "✅ Python 3.12 已安装"
python3.12 --version
fi
# 检查虚拟环境
if [ ! -d "venv" ]; then
echo ""
echo "📦 创建虚拟环境..."
if command -v python3.12 &> /dev/null; then
python3.12 -m venv venv
echo "✅ 使用 Python 3.12 创建虚拟环境"
else
python -m venv venv
echo "⚠️ 使用当前 Python 版本创建虚拟环境"
fi
else
echo "✅ 虚拟环境已存在"
fi
# 激活虚拟环境
echo ""
echo "🔄 激活虚拟环境..."
source venv/bin/activate
# 升级pip
echo "📦 升级pip..."
pip install --upgrade pip
# 安装依赖
echo "📦 安装项目依赖..."
pip install -e ".[dev]"
# 安装ComfyUI兼容的依赖
echo "📦 安装ComfyUI兼容依赖..."
pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu
echo ""
echo "🎉 开发环境设置完成!"
echo ""
echo "🔧 使用方法:"
echo " 1. 激活虚拟环境: source venv/bin/activate"
echo " 2. 运行测试: python test_nodes.py"
echo " 3. 开发新节点: 参考 node_template.py"
echo ""
echo "📚 文档:"
echo " - 开发指南: DEVELOPMENT_GUIDE.md"
echo " - 项目说明: README.md"
echo ""
echo "⚡ 快速验证:"
echo " python -c \"import __init__; print('✅ 插件加载成功')\""