24 KiB
24 KiB
Changelog
本项目的所有重要变更都将记录在此文件中。
格式基于 Keep a Changelog。
[1.10.3] - 2026-04-13
修复
- 香蕉节点修复返回2张图、灰色图片问题
- 修复 SSL 证书报错,统一由【保存图像】节点保存
新增
- 支持【立刻取消】生图请求,可立即重新运行
- 支持工作流历史记录恢复
- 并发上限提升,批量生图速度大幅提升
- 全能LLM新增视频/文档分析、流式实时预览
- Seedance 2.0 新增多图及视频URL参考(优化中)
[Unreleased]
Added ✨
- 快捷配置脚本
- 新增
设置API密钥(win).bat- Windows 一键配置工具 - 新增
设置API密钥(mac).sh- Mac/Linux 一键配置工具 - 自动生成
.config配置文件 - 交互式提示引导用户输入 API 密钥
- 自动检测并提示覆盖已存在的配置文件
- 彩色输出和友好的用户提示信息
- 新增
- 配置模板文件
- 新增
.config.example作为配置文件示例
- 新增
Changed
- 502 错误提示优化 (
clients/base_client.py)- 当 API 返回 502 时,弹框显示友好文案:「糟糕!请求到上游时遇到超时或过载!别担心,过会儿再次点击运行即可!」
- 在
request_async与request_get_async中均增加 502 专用分支
- 配置管理策略
.config文件现在完全忽略提交(添加到.gitignore)- 简化配置流程,用户通过快捷脚本自动创建本地配置
- 移除配置文件安全检查机制(不再需要)
- README 文档
- 更新配置章节,添加快捷脚本使用说明
- 调整配置方法优先级:快捷脚本 > 环境变量 > 手动配置
- 简化安全提示说明
Removed
- 安全检查工具(不再需要)
- 删除
check_config_safety.py配置安全检查脚本 - 删除
.git-hooks-install.batGit Hook 安装脚本 - 彻底杜绝配置文件泄密风险
- 删除
[1.9.1] - 2026-02-05
Security 🔐
- 错误信息伪装 - 极致隐蔽性
- 未配置情况下的错误信息伪装成商业授权提示
- 前端弹框显示:
未授权! - 控制台日志显示:
请联系作者授权后方可使用! - 完全隐藏真实的配置方式(环境变量)
- 让外部用户以为这是需要购买授权的商业插件
Changed
-
配置模块 (
utils/config.py)- 将未找到 API 密钥的错误消息改为简洁的"未授权!"
- 移除所有暴露配置方式的信息
-
节点异常处理 (所有节点)
NanoBananaPro- 添加授权错误检测,特殊处理授权失败日志BatchNanoBananaPro- 添加授权错误检测,特殊处理授权失败日志GoogleGemini- 添加授权错误检测,特殊处理授权失败日志- 其他 ValueError 类型仍正常显示详细错误信息
Benefits
- ✅ 极致隐蔽 - 完全看不出需要配置环境变量
- ✅ 伪装商业 - 外部用户以为需要付费授权
- ✅ 信息安全 - 不泄露任何配置相关信息
- ✅ 功能完整 - 其他错误类型仍正常提示
- ✅ 向后兼容 - 已配置用户完全不受影响
[1.9.0] - 2026-02-05
Security 🔐
- 配置方式优化 - 提升隐蔽性和安全性
- 移除所有配置相关文件(
setup_config.ps1,.config,.config.example) - 改为使用系统环境变量存储 API 密钥
- 避免在项目中留下配置痕迹,提高隐蔽性
- 配置方式对外部用户完全不可见
- 移除所有配置相关文件(
Changed
-
配置管理模块重构 (
utils/config.py)- 调整读取优先级:环境变量优先 > .config 文件(向后兼容)
- 简化错误提示:仅提示设置环境变量,不再提及配置文件
- 更新模块说明:从"处理 .config 文件"改为"处理环境变量"
-
文档更新
README.md- 简化配置说明,仅保留环境变量设置方法批量节点使用指南.md- 更新常见问题中的配置说明.gitignore- 注释配置文件规则(已弃用)
Benefits
- ✅ 高隐蔽性 - 项目中无任何配置相关文件
- ✅ 高安全性 - 敏感信息存储在系统级别,不在项目目录
- ✅ 简化维护 - 一行命令创建/更新/删除配置
- ✅ 多项目共享 - 环境变量可被其他项目复用
- ✅ 向后兼容 - 仍支持从 .config 文件读取(如果存在)
[1.8.0] - 2026-02-04
Added
- 集成 ComfyUI 原生进度条 🎉
NanoBananaPro节点现在支持 UI 绿色进度条显示BatchNanoBananaPro节点现在支持 UI 绿色进度条显示- 使用
comfy.utils.ProgressBar实现实时进度更新 - 进度条在节点上方显示,从 0% 平滑更新到 100%
- 兼容性检查:如果 ProgressBar 不可用,自动降级到终端进度显示
Improved
- 用户体验提升
- 生图过程中可视化进度反馈更直观
- 节点运行时自动显示绿色边框(ComfyUI 原生)
- 保留详细的终端进度日志,方便调试
- 批量提示词模式下进度条总数自动调整
Technical
- 在
nodes/nano_banana_pro.py中集成 ProgressBar- 创建进度条实例:
ProgressBar(生图数量) - 在
progress_callback中调用pbar.update(1) - 批量提示词模式重新创建进度条以匹配实际总数
- 创建进度条实例:
- 在
nodes/batch_nano_banana_pro.py中集成 ProgressBar- 将
pbar参数传递给_process_batch_async方法 - 每完成一个任务立即更新进度条
- 支持大批量任务的实时进度显示
- 将
- 添加
PROGRESS_BAR_AVAILABLE标志进行兼容性检测
Impact
- ✅ 所有图像生成节点现在都有 UI 进度条
- ✅ 后续新增的视频生成节点可直接复用此实现
- ✅ 不影响现有功能,完全向后兼容
[1.7.0] - 2026-02-03
Added
-
新增 Google Gemini 节点 (
GoogleGemini)- 用于调用 Gemini 3 Flash 模型进行多模态文本生成
- 输入支持:
- 提示词(必填):用户提示词,支持多行
- 系统指令(可选):系统级指令,引导模型行为
- 思考深度:不思考(默认)/ 高
- 图片(可选):支持 ComfyUI IMAGE 类型输入
- 视频(可选):支持 ComfyUI VIDEO 类型输入
- 输出:文本内容(STRING 类型)
- 支持的视频格式:mp4, mpeg, mov, avi, flv, webm, wmv, 3gpp
- 端点映射:
- 不思考 →
/v1beta/models/gemini-3-flash-preview-nothinking:generateContent - 高 →
/v1beta/models/gemini-3-flash-preview-high:generateContent
- 不思考 →
-
新增 Gemini Flash API 客户端 (
clients/gemini_flash_client.py)- 继承
BaseAPIClient基类 - 支持系统指令配置
- 支持图片和视频的 base64 编码发送
- 智能超时设置(视频请求 5 分钟,其他 3 分钟)
- 继承
Technical
- 新增
GeminiFlashClient类处理 Gemini Flash 模型 API 调用 - 新增
GoogleGemini节点类实现多模态文本生成 - 支持自动检测视频 MIME 类型
- 视频文件大小限制 20MB
[1.6.2] - 2026-02-02
Added
- 模型端点配置化 (
models_config.py)- 在模型配置中新增
endpoint字段,集中管理每个模型的 API 端点 - 新增
get_model_endpoint()工具函数,用于获取模型端点 - 添加新模型时只需在配置文件中填写端点,无需修改代码
- 在模型配置中新增
Changed
- 简化端点获取逻辑 (
clients/gemini_client.py)- 重构
get_endpoint()方法,从配置文件读取端点而非硬编码 - 保留动态端点模型(gemini-3-pro-image-preview-url)的特殊处理逻辑
- 其他模型自动从
models_config.py读取端点配置
- 重构
Improved
-
增强配置验证 (
models_config.py)- 验证非动态端点模型必须配置有效的
endpoint - 验证端点格式是否正确(应以
/v1beta/models/开头) - 更新必需字段列表,包含
endpoint字段
- 验证非动态端点模型必须配置有效的
-
更新开发文档 (
.cursorrules)- 更新模型配置示例,说明
endpoint字段的使用方法 - 更新添加新模型的指南,强调配置端点的方式
- 更新工具函数列表,添加
get_model_endpoint()说明 - 更新配置验证规则说明
- 更新模型配置示例,说明
Benefits
- 降低维护成本:添加新模型只需修改配置文件
- 提高可读性:端点集中管理,一目了然
- 减少错误:配置验证确保端点格式正确
- 保持灵活性:动态端点模型仍可使用代码逻辑
[1.6.1] - 2026-02-02
Fixed
- 修复 gemini-3-pro-image-preview-flatfee 模型 504 错误
- 暂时禁用
gemini-3-pro-image-preview-flatfee模型(端点返回 504 Gateway Timeout) - 更新模型描述标注"暂时不可用-504错误"
- 建议用户使用其他可用模型(如 gemini-3-pro-image-preview 或 gemini-3-pro-image-preview-url)
- 暂时禁用
Improved
- 增强 HTTP 错误处理 (
clients/base_client.py)- 新增针对 504 Gateway Timeout 的友好错误提示
- 说明原因:服务器响应超时或端点暂时不可用
- 提供解决建议:尝试其他模型、稍后重试、降低分辨率等
- 新增针对 503 Service Unavailable 的错误提示
- 说明原因:模型服务过载或维护中
- 提供解决建议:稍后重试或尝试其他模型
- 新增针对 429 Too Many Requests 的错误提示
- 说明原因:API 配额用尽或请求过于频繁
- 提供解决建议:等待后重试或检查配额
- 新增针对 404 Not Found 的错误提示
- 说明原因:端点路径错误或模型不存在
- 提供解决建议:检查模型名称或使用其他模型
- 统一错误信息格式:错误类型 + 原因 + 建议
- 同时优化 POST 和 GET 请求的错误处理
- 新增针对 504 Gateway Timeout 的友好错误提示
Technical
- 在
request_async()和request_get_async()中添加状态码判断逻辑 - 提供更详细的错误诊断信息,帮助用户快速定位和解决问题
[1.6.0] - 2026-02-02
Added
- 模型管理系统 (
models_config.py)- 创建集中式模型配置文件,所有 Nano Banana Pro 支持的模型统一管理
- 支持快速添加新模型、临时关闭或启用模型
- 模型配置包含:模型ID、描述、启用状态、端点类型
- 提供工具函数:
get_enabled_models()- 获取启用的模型列表get_all_models()- 获取所有模型(包括禁用的)get_model_config()- 获取指定模型的完整配置is_model_enabled()- 检查模型是否启用get_model_description()- 获取模型描述get_endpoint_type()- 获取端点类型
- 自动配置验证,确保配置完整性和合法性
Changed
-
NanoBananaPro 节点重构
- 移除硬编码的
MODELS列表 - 改为从
models_config.py动态加载模型列表 - 节点在 ComfyUI 中显示的模型列表自动同步配置文件
- 移除硬编码的
-
BatchNanoBananaPro 节点重构
- 移除硬编码的
MODELS列表 - 改为从
models_config.py动态加载模型列表 - 保持与 NanoBananaPro 节点的模型列表一致性
- 移除硬编码的
Improved
-
开发指南更新 (
.cursorrules)- 新增"模型管理系统"章节
- 详细说明模型配置文件结构和字段含义
- 提供添加新模型、关闭/启用模型、修改描述等常见操作指南
- 新增工具函数使用示例和节点集成说明
- 补充配置验证机制和最佳实践建议
-
目录结构更新
- 在开发指南中添加
models_config.py文件说明 - 标记为模型配置中心 ⭐
- 在开发指南中添加
Benefits
- ✅ 集中管理 - 所有模型定义在一个文件,易于维护
- ✅ 易于扩展 - 添加新模型只需在配置文件中添加一个字典
- ✅ 快速开关 - 修改
enabled字段即可临时关闭或启用模型 - ✅ 文档化 - 每个模型都有
description说明特点和适用场景 - ✅ 类型安全 - Python 文件支持代码提示和类型检查
- ✅ 自动同步 - 所有节点自动使用最新的模型配置
[1.5.7] - 2026-02-02
Performance 🚀
-
极致性能优化:彻底解决异步阻塞问题
- 将
parse_response()改为parse_response_async(),实现完全异步的图片下载 - 使用
aiohttp替代同步的requests.get()下载图片 - 问题:之前在异步事件循环中使用同步 HTTP 请求会阻塞整个事件循环
- 影响:虽然 API 请求是并发的,但图片下载变成了串行操作
- 效果:现在图片下载也是完全并发的,真正实现端到端的异步性能
- 将
-
性能提升幅度:
- 使用
gemini-3-pro-image-preview-url模型时提升最明显 - 批量生成 4 张图时,从"串行下载 4 张"变为"并发下载 4 张"
- 预计性能提升 2-4 倍(取决于网络延迟和图片大小)
- 使用
Changed
GeminiAPIClient.parse_response()→parse_response_async()- 新增
session参数,用于复用 aiohttp 会话 - 支持并发下载多个图片 URL
- 自动管理 session 生命周期
- 新增
GeminiAPIClient.generate_single_async()现在调用异步解析方法- 移除
requests依赖,统一使用aiohttp
Impact
- 所有节点自动受益:
- ✅
NanoBananaPro- 批量生成速度显著提升 - ✅
BatchNanoBananaPro- 大批量任务性能大幅改善 - ✅ 所有使用
gemini-3-pro-image-preview-url模型的场景
- ✅
[1.5.6] - 2026-02-02
Improved
- 优化批量生成实时进度显示 (
Nano Banana Pro)- 使用
asyncio.as_completed替代asyncio.gather,实现真正的实时进度 - 每完成一个请求立即显示进度,而非等待所有请求完成后批量显示
- 进度信息包含成功/失败状态:
- 成功:
✓ [1/4] 第 1 张生成成功 - 失败:
✗ [2/4] 生成失败 - 错误原因
- 成功:
- 最终统计显示成功和失败数量
- 使用
Fixed
- 修复批量生成失败信息丢失问题
- 之前:失败的请求被静默忽略,用户不知道哪些请求失败
- 现在:每个失败的请求都会显示错误原因,方便排查问题
Technical
- 更新
generate_batch_async()和generate_multi_prompts_async()方法 - 进度回调签名变更:
(current, total)→(current, total, success, error_msg) - 错误信息自动截取第一行,避免过长输出
[1.5.5] - 2026-02-02
Added
- 增强 API 错误处理机制
- 新增
candidatesTokenCount = 0检测(最高优先级)- 自动检测内容审核拒绝情况
- 提供明确的拒绝原因和改进建议
- 新增
finishReason异常检测(次优先级)- 支持检测
PROHIBITED_CONTENT(违禁内容) - 支持检测
SAFETY(安全过滤器) - 支持检测
RECITATION(版权问题) - 支持检测
MAX_TOKENS(Token 超限) - 针对每种错误类型提供具体的解决建议
- 支持检测
- 新增 API 文本响应拒绝检测
- 当 API 返回文本而非图像时,自动提取拒绝说明
- 直接展示 API 的拒绝理由给用户
- 新增
Improved
- 优化错误提示格式 (
clients/gemini_client.py)- 统一错误信息格式:错误类型 + 原因 + 建议
- 所有错误以
RuntimeError抛出,便于节点层面捕获 - 提供清晰的多行格式化错误信息
- 包含针对性的操作建议,帮助用户快速解决问题
Technical
- 在
GeminiAPIClient.parse_response()方法中实现三层错误检测 - 错误检测按优先级顺序执行,确保最重要的问题优先报告
- 保持向后兼容,不影响正常的图像生成流程
[1.5.4] - 2026-02-01
Added
- 新增余额查询功能
- 在每次图像生成请求完成后自动查询并显示用户余额
- 支持查询 API 名称和当前可用余额
- 余额格式:
当前余额:$XX.XX | API:xxx - 查询失败时显示警告信息,不影响主流程
- 适用于
NanoBananaPro和BatchNanoBananaPro节点
Changed
-
扩展 API 客户端功能 (
clients/base_client.py)- 新增
request_get_async()方法支持 GET 请求 - 扩展
get_headers()方法支持 Bearer Token 认证 - 兼容现有的 x-goog-api-key 认证方式
- 新增
-
增强 Gemini 客户端 (
clients/gemini_client.py)- 新增
query_balance_async()异步查询余额方法 - 新增
query_balance_sync()同步查询余额方法(用于节点) - 新增
format_balance_info()格式化余额信息方法 - 余额转换公式:实际显示 = total_available / 500000
- 新增
[1.5.3] - 2026-02-01
Changed
- 重大更新新手使用指南 (
GUIDE.md)- 新增批量提示词功能详细说明(节点详细说明部分)
- 新增场景 5:批量提示词生成(多提示词并发)
- 新增场景 6:批量提示词 + 图生图(共享参考图)
- 新增场景 7:批量提示词精准匹配规则详解
- 单提示词模式与批量提示词模式对比
- 详细的行为示例(纯文生图、图生图、多参考图)
- 常见误区与正确用法对照
- 使用决策树帮助用户选择合适的节点和模式
- 新增节点功能对比表和提示词模式对比表
- 新增 Q6-Q7:批量提示词相关常见问题
- 新增技巧 7:批量提示词最佳实践(4个子技巧)
- 更新场景编号(原场景 6-8 → 新场景 8)
- 修正批量提示词的描述(所有提示词共享输入图像,而非 1:1 匹配)
- 强化对
---分隔符格式要求的说明
[1.5.2] - 2026-02-01
Added
- 新增新手使用指南 (
GUIDE.md)- 详细的安装配置步骤
- 三个核心节点的完整文档和参数说明
- 六种常见使用场景的工作流示例
- 常见问题解答和解决方案
- 六个进阶使用技巧
- 面向初次使用插件的用户,提供从零到一的完整指导
Changed
- 更新开发规范 (
.cursorrules)- 新增"新手指南维护规则"章节
- 规定每次新增或变更节点时必须同步更新
GUIDE.md - 提供节点文档和使用场景的标准模板
- 明确文档维护的五大原则(用户视角、实用性、完整性、同步性、可读性)
[1.5.1] - 2026-02-01
Fixed
- 修复批量 Nano Banana Pro 节点事件循环冲突
- 修复
RuntimeError: Cannot run the event loop while another loop is running错误 - 使用
ThreadPoolExecutor在独立线程中运行异步事件循环 - 避免与 ComfyUI 主事件循环冲突
- 确保批量处理任务稳定执行
- 修复
[1.5.0] - 2026-02-01
Changed
- 批量 Nano Banana Pro 节点重构 (
BatchNanoBananaPro)- 参数重命名:
手动参考图→加载参考图预览图像→输出图像配对模式→图片配对模式
- 配对模式选项值重命名:
1:1索引配对→1:1笛卡尔积→1*N
- 参数顺序调整:
文件夹2-4移到文件夹1下方(从 optional 移至 required) - 固定并发控制:移除
最大并发数参数,默认自动管理(每批最多 100 并发) - 固定生成数量:移除
每组生成数量参数,每组配对固定生成 1 张图
- 参数重命名:
Added
- 批量 Nano Banana Pro 节点新增像素缩放功能
- 新增
像素缩放参数(BOOLEAN,默认 True) - 新增
分辨率像素参数(FLOAT,默认 1.0,范围 0.1-100.0) - 支持对文件夹加载的图片和手动参考图进行缩放
- 使用 Lanczos 重采样算法保持图片质量
- 缩放在发送 API 前应用
- 新增
Removed
- 批量 Nano Banana Pro 节点移除处理报告功能
- 移除返回值中的
处理报告字符串输出 - 简化返回类型为单一
IMAGE输出 - 统计信息仍通过控制台打印输出
- 移除返回值中的
Improved
- 输出图像优化
输出图像现在返回所有生成的图片(而非仅预览最后几张)- 提供完整的批处理结果输出
[1.4.0] - 2026-02-01
Added
-
批量 Nano Banana Pro 节点 (
BatchNanoBananaPro)- 支持从 1-4 个文件夹批量加载图片
- 两种配对模式:1:1 索引配对 / 笛卡尔积
- 支持手动参考图输入(可与文件夹图片混合使用)
- 智能命名保存(保留原始文件名 + 自动后缀)
- 并发控制(默认最大 100,超过自动分批)
- 完整的处理报告输出
- 预览最后生成的图片
-
文件处理工具模块 (
utils/file_utils.py)load_images_from_folder()- 从文件夹加载图片pair_images_indexed()- 1:1 索引配对pair_images_cartesian()- 笛卡尔积配对generate_output_filename()- 智能输出文件名生成save_image()- 保存图片到指定路径
Technical
- 新增
ImageInfo命名元组,携带图片元数据 - 支持 jpg/jpeg/png/webp/bmp/gif 图片格式
- 文件名按字母顺序排序,确保配对顺序一致
[1.3.0] - 2026-02-01
Added
- 批量提示词功能(Nano Banana Pro)
- 支持使用单行
---分隔符同时提交多个不同提示词 - 所有提示词并发生成,提高效率
- 每个提示词可生成指定数量的图像(提示词数量 × 生图数量)
- 示例:3个提示词 × 2张/提示词 = 6张图
- 触发条件:
---必须单独占据一行 - 自动过滤空提示词
- 支持使用单行
Changed
- 优化 Nano Banana Pro 节点日志输出
- 批量提示词模式显示 "X个提示词 × Y张/提示词 = Z张图"
- 单提示词模式保持原有输出格式
Technical
- 新增
parse_batch_prompts()工具函数(utils/image_utils.py) - 新增
generate_multi_prompts_async()方法(clients/gemini_client.py) - 新增
generate_multi_prompts_sync()方法(clients/gemini_client.py)
[1.2.1] - 2026-02-01
Changed
- 加载批次图像(Nano Banana Pro) 节点优化
- 节点显示名称改为 "加载批次图像(Nano Banana Pro)"
- 移除 "参考图数量" 参数,改为自动检测所有有效输入图像数量
- "开启像素缩放" 改名为 "像素缩放",类型改为 BOOLEAN 开关(默认开启)
- "目标像素数_百万" 改名为 "分辨率像素"
Improved
- 简化用户操作流程,无需手动设置图像数量
- 支持灵活的图像输入方式(1-14 张任意数量)
[1.2.0] - 2026-02-01
Added
- 加载批次图像 节点 (
BatchImageLoader)- 支持动态输入数量(1-14 张图像)
- 可选的像素缩放功能(保持纵横比)
- 使用 Lanczos 重采样算法进行高质量缩放
- 支持设置目标像素数(0.1-100 百万像素)
- 可与原生"加载图像"节点连接使用
- 输出批次张量供其他节点使用
[1.1.1] - 2026-02-01
Changed
- 将 Nano Banana Pro 节点的随机种子参数改为 ComfyUI 原生格式
随机种子→seed(参数名符合 ComfyUI 标准)- 移除
-1自动随机逻辑 - 种子默认值改为
0,取值范围[0, 2^64-1]
Removed
- 移除
control_after_generate参数(简化节点参数)
[1.1.0] - 2026-02-01
Changed
- 重构项目结构,模块化设计
- 新增
nodes/目录存放节点实现 - 新增
utils/目录存放工具函数 - 新增
clients/目录存放 API 客户端
- 新增
- 封装图像转换工具到
utils/image_utils.py - 封装配置管理到
utils/config.py - 重构 API 客户端,拆分为基类和具体实现
- 精简文档结构,整合为 README.md + CHANGELOG.md + .cursorrules
Added
BaseAPIClient抽象基类,支持快速开发新 API 客户端.cursorrules开发指导文档,统一开发规范get_api_key_or_raise()函数,简化密钥获取逻辑
[1.0.0] - 2026-02-01
Added
- 初始版本发布
- Nano Banana Pro 节点
- 文生图功能
- 图生图功能(最多 14 张输入图像)
- 批量并发生成(最多 1000 张)
- 多分辨率支持(1K / 2K / 4K)
- 10 种宽高比选项
- 可控随机种子
- 通过 api.o1key.com 调用 Gemini 3 Pro 模型
- 支持 .config 文件和环境变量配置 API 密钥
- 完善的错误处理和日志输出