|
| 1 | +# Release Notes - v0.1.0: Azure OpenAI Image Editing Enhancement |
| 2 | + |
| 3 | +## 🚀 Major Release: Enterprise-Grade Azure OpenAI Integration |
| 4 | + |
| 5 | +**发布日期**: 2025年7月16日 |
| 6 | +**版本**: v0.1.0 |
| 7 | +**兼容性**: ComfyUI, Azure OpenAI API 2025-04-01-preview |
| 8 | + |
| 9 | +--- |
| 10 | + |
| 11 | +## 🎯 发布概述 |
| 12 | + |
| 13 | +这是一个重大更新,将项目从基础的 HTTP 请求实现升级为使用官方 Azure OpenAI SDK 的企业级解决方案。新版本提供了更强大的功能、更好的错误处理和更简单的使用体验。 |
| 14 | + |
| 15 | +## ✨ 新功能特性 |
| 16 | + |
| 17 | +### 🔧 核心技术升级 |
| 18 | +- **最新 Azure OpenAI SDK**: 使用官方 OpenAI Python SDK 1.0+ |
| 19 | +- **API 版本更新**: 支持 2025-04-01-preview 版本 |
| 20 | +- **模块化架构**: 分离配置管理、图像处理和错误处理 |
| 21 | +- **类型安全**: 完整的 TypeScript 风格类型提示 |
| 22 | +- **企业级日志**: 结构化日志记录和错误追踪 |
| 23 | + |
| 24 | +### 🛠️ 用户体验改进 |
| 25 | +- **智能配置**: 自动检测和验证环境变量 |
| 26 | +- **批量处理**: 支持同时处理多张图像 |
| 27 | +- **错误恢复**: 自动重试和智能错误处理 |
| 28 | +- **安全管理**: 凭证隐藏和安全存储 |
| 29 | +- **丰富文档**: 详细的使用指南和示例 |
| 30 | + |
| 31 | +### 🎨 图像处理增强 |
| 32 | +- **高效转换**: 优化的张量和 PIL 图像转换 |
| 33 | +- **格式支持**: 支持多种图像格式 (PNG, JPEG, WEBP) |
| 34 | +- **尺寸验证**: 自动图像尺寸检查和调整 |
| 35 | +- **内存优化**: 更好的内存使用和垃圾回收 |
| 36 | + |
| 37 | +## 📁 新增文件 |
| 38 | + |
| 39 | +### 核心模块 |
| 40 | +- `src/openai_image_api/azure_config.py` - Azure 配置管理器 |
| 41 | +- `src/openai_image_api/image_utils.py` - 图像处理工具库 |
| 42 | + |
| 43 | +### 示例和测试 |
| 44 | +- `examples/azure_image_edit_example.py` - 完整使用示例 |
| 45 | +- `test_integration.py` - 集成测试套件 |
| 46 | + |
| 47 | +### 文档和配置 |
| 48 | +- `QUICK_START.md` - 快速开始指南 |
| 49 | +- `config.env.example` - 环境变量配置模板 |
| 50 | +- `TROUBLESHOOTING.md` - 故障排除指南 |
| 51 | +- `COMFYUI_INSTALLATION_GUIDE.md` - ComfyUI 安装指南 |
| 52 | + |
| 53 | +### 工具脚本 |
| 54 | +- `install_comfyui.sh` - ComfyUI 自动安装脚本 |
| 55 | +- `image_edit.py` - 独立图像编辑脚本 |
| 56 | + |
| 57 | +## 🔄 更新的文件 |
| 58 | + |
| 59 | +### 核心代码 |
| 60 | +- `src/openai_image_api/nodes.py` - 完全重构的主节点代码 |
| 61 | +- `pyproject.toml` - 更新依赖项和项目信息 |
| 62 | +- `README.md` - 全面更新的文档 |
| 63 | + |
| 64 | +### 配置 |
| 65 | +- `.gitignore` - 添加项目特定的忽略规则 |
| 66 | + |
| 67 | +## 💡 使用示例 |
| 68 | + |
| 69 | +### 基本用法 |
| 70 | +```python |
| 71 | +from src.openai_image_api.nodes import OpenAIImageAPI |
| 72 | + |
| 73 | +node = OpenAIImageAPI() |
| 74 | +result = node.generate_image( |
| 75 | + prompt="make it in the style of Studio Ghibli", |
| 76 | + model="gpt-image-1", |
| 77 | + size="1024x1024", |
| 78 | + quality="high", |
| 79 | + provider="azure", |
| 80 | + image=your_image_tensor |
| 81 | +) |
| 82 | +``` |
| 83 | + |
| 84 | +### 环境变量配置 |
| 85 | +```bash |
| 86 | +export AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com |
| 87 | +export AZURE_OPENAI_API_KEY=your-api-key |
| 88 | +export AZURE_OPENAI_API_VERSION=2025-04-01-preview |
| 89 | +export AZURE_OPENAI_DEPLOYMENT=gpt-image-1 |
| 90 | +``` |
| 91 | + |
| 92 | +## 🔧 安装和升级 |
| 93 | + |
| 94 | +### 从 GitHub 安装 |
| 95 | +```bash |
| 96 | +git clone https://github.com/cjj198909/comfy_openai_image_api_azure.git |
| 97 | +cd comfy_openai_image_api_azure |
| 98 | +pip install -e . |
| 99 | +``` |
| 100 | + |
| 101 | +### 更新现有安装 |
| 102 | +```bash |
| 103 | +git pull origin main |
| 104 | +pip install -e . |
| 105 | +``` |
| 106 | + |
| 107 | +### 测试安装 |
| 108 | +```bash |
| 109 | +python test_integration.py |
| 110 | +``` |
| 111 | + |
| 112 | +## 📋 环境要求 |
| 113 | + |
| 114 | +### 必需依赖 |
| 115 | +- Python 3.8+ |
| 116 | +- openai >= 1.0.0 |
| 117 | +- python-dotenv >= 1.0.0 |
| 118 | +- pillow >= 10.0.0 |
| 119 | +- numpy >= 1.21.0 |
| 120 | + |
| 121 | +### 可选依赖 |
| 122 | +- torch (ComfyUI 环境中自动提供) |
| 123 | +- requests >= 2.25.0 |
| 124 | + |
| 125 | +## 🚨 重要变更 |
| 126 | + |
| 127 | +### 配置变更 |
| 128 | +- 新增多种环境变量格式支持 |
| 129 | +- 推荐使用 `AZURE_OPENAI_*` 前缀的环境变量 |
| 130 | +- 配置验证和错误提示改进 |
| 131 | + |
| 132 | +### API 变更 |
| 133 | +- 从手动 HTTP 请求改为官方 SDK |
| 134 | +- 改进的错误处理和重试机制 |
| 135 | +- 更好的类型安全和代码补全 |
| 136 | + |
| 137 | +### 向后兼容性 |
| 138 | +- 保持与现有 ComfyUI 工作流的兼容性 |
| 139 | +- 现有的环境变量仍然支持 |
| 140 | +- 节点接口保持不变 |
| 141 | + |
| 142 | +## 🔍 故障排除 |
| 143 | + |
| 144 | +### 常见问题 |
| 145 | +1. **环境变量未设置**: 参考 `config.env.example` 配置 |
| 146 | +2. **API 密钥错误**: 检查 Azure 门户中的密钥状态 |
| 147 | +3. **端点格式错误**: 确保使用正确的 Azure OpenAI 端点格式 |
| 148 | + |
| 149 | +### 获取帮助 |
| 150 | +- 查看 `TROUBLESHOOTING.md` 详细故障排除指南 |
| 151 | +- 检查 `QUICK_START.md` 快速开始指南 |
| 152 | +- 运行 `python test_integration.py` 验证配置 |
| 153 | + |
| 154 | +## 🎯 下一步计划 |
| 155 | + |
| 156 | +- 添加更多图像编辑功能 |
| 157 | +- 支持其他 Azure 认知服务 |
| 158 | +- 性能优化和缓存机制 |
| 159 | +- 更多示例和教程 |
| 160 | + |
| 161 | +## 🙏 致谢 |
| 162 | + |
| 163 | +感谢所有贡献者和用户的支持!这个版本的改进基于社区反馈和 Azure OpenAI 的最新功能。 |
| 164 | + |
| 165 | +--- |
| 166 | + |
| 167 | +## 📞 支持和反馈 |
| 168 | + |
| 169 | +如有问题或建议,请: |
| 170 | +- 创建 GitHub Issue |
| 171 | +- 查看项目文档 |
| 172 | +- 参考示例代码 |
| 173 | + |
| 174 | +**🎉 享受全新的 Azure OpenAI 图像编辑体验!** |
0 commit comments