LX ComfyUI Progress Panel

一个不增加工作流节点、只监听 ComfyUI 执行事件的悬浮任务进度面板。

功能

• 自动显示工作流总进度、当前节点、节点内部进度、已用时间和预计完成时间。
• 自动分析实际入队的 prompt，识别多个采样节点并显示“采样 1 / N”。
• 支持常见 KSampler、SamplerCustom，也识别同时具有 steps 与 sampler_name/sampler 输入的第三方采样节点。
• 保留 LX H3 的 lx_h3_v65_status 增强事件兼容，可显示分段、帧数和更准确的 ETA。
• 面板可拖动、自由缩放、折叠，并可调节背景透明度；布局设置保存在浏览器本地。
• 普通工作流只读取执行状态，不修改节点、参数或工作流。

安装

在 ComfyUI 的 custom_nodes 目录执行：

git clone https://github.com/lttlz/LX_ComfyUI_ProgressPanel.git

完整关闭并重新启动 ComfyUI，然后刷新浏览器页面。插件没有额外 Python 或前端依赖。

使用

任务开始执行后面板自动出现：

• 拖动标题栏移动位置，双击标题栏恢复默认位置。
• 拖动右下角调整面板大小。
• 点击标题栏的折叠按钮只保留摘要。
• 点击设置按钮调节背景透明度或重置布局。

多采识别边界

“采样次数”指实际入队 prompt 中识别出的采样节点数量，而不是采样器内部 steps 数量。节点类名完全不含采样语义、同时也不暴露 steps 与采样器输入的私有第三方节点，可能无法自动识别。动态节点在运行时生成额外采样实例时，静态总次数也可能低估；面板仍会继续显示节点和内部进度。

项目结构

LX_ComfyUI_ProgressPanel/
├── __init__.py
├── web/
│   ├── lx_comfyui_progress_panel.js
│   └── progress_core.js
└── tests/
    ├── progress_core.test.mjs
    └── test_package.py

验证

python -m unittest discover -s tests -v
node --test tests/progress_core.test.mjs
node --check web/lx_comfyui_progress_panel.js