v0.6.0

ComfyUI-QG-tools v0.6.0

加了两个节点，并且把 QG 节点的外观补齐了。 节点数 4 → 6。

新节点

QG Run Timer（运行计时器）

整轮队列的秒表，直接画在画布上：开始跑就走字，跑完停住总时长。右键节点能看最近几次的
用时，改完设置好和上一次对比；时间跟着工作流一起保存，别人打开你的图就知道作者那次跑了多久。
无输入无输出、不进提示词 —— 纯靠监听队列状态工作。

QG Text Edit Output（文本编辑输出）

画布上的一块随手文本框：在这里敲的字，整段作为一路字符串输出，接给下游任何文本输入。
不按换行切分（整段是一个元素），纯 Python 节点，零依赖、不加载模型。

外观：徽章、配色、一键重刷

此前 QG 节点一直没有标题栏的 ? 徽章，也不参与配色 —— 这次把上游的外观全局扩展搬了过来：

• 新建 QG 节点时按当前配色方案自动上色，标题栏带 ? 徽章（点开是说明）。
• 右键任意 QG 节点 → QG 配色：单独改这一个节点，或者换整套配色方案。
• 已经手动挑过颜色的节点不会被自动覆盖（保护手选色）。想统一就点配色子菜单最后一项
  「把所有 QG 节点重刷为当前配色」（含子图；方案选 Theme default 即为清色）。

注意：QG Run Timer 的黑底读数窗是它自己设定的颜色，不是配色漏了 —— 想改也用上面那条。

两个已有节点跟上上游

• QG Image Crop + Rotate + Pad：拖动/缩放时不再闪尺寸提示，松手后稳定 200ms 才落定。
• QG Workflow Switches：新增胶囊模式（show: "pill"）—— 开关折叠成一排小胶囊，
  不占竖向空间；原来的分行模式照旧可选。

汉化

• 工作流开关的界面文案补全（pill 模式的新串 + 之前遗漏的历史拼接句），ui 词条 75 → 129 条。
• 两个新节点的官方语言包（locales/zh/nodeDefs.json）与汉化插件字典同步补齐。

其它

• 新增 licenses/ComfyUI-Muye-nodes-LICENSE.txt：文本编辑输出节点取自 ComfyUI-Muye-nodes（MIT），
  按 MIT 要求保留原许可证全文。
• 后端路由、依赖均无变化（仍为 11 条路由、零 pip 依赖）。

安装

解压到 ComfyUI/custom_nodes/ 下，完整重启 ComfyUI（这次加了新节点，必须重启不是刷新）。
控制台应出现：

[QG-tools] v0.6.0 加载完成 | 节点数 6

v0.5.1

ComfyUI-QG-tools v0.5.1

这是一个修复版本，强烈建议更新。 修掉了"每次启动 ComfyUI 都会自动重启一次"的问题
（KK 启动器表现为启动时 PID: --、进程被换掉）。

修复：打开页面不再触发 Manager 的重启队列

是什么问题：v0.4.0 起，"工作流说明卡"（QG_WorkflowNote）会在页面加载 2 秒后
自动去向 ComfyUI-Manager 拉取节点索引，而这个请求漏了 skip_update=true。
Manager 收到这种请求时会顺路对所有 git 插件跑一遍更新检查，凡是判定"有更新"的
就会往 ComfyUI/user/__manager/startup-scripts/install-scripts.txt 追加一条安装队列。
于是每打开一次 ComfyUI 页面，就等于替你点了一次「检查更新」，队列被反复重灌，
下一次启动 ComfyUI 就会 os.execv 自动重启一次。

即便插件被禁用也不会显得"修好了"——那是禁用动作本身把队列消费掉了，队列随后又会被
下一次页面加载写回来。

改了什么：

• 请求加上 &skip_update=true，变成纯缓存读取。实测 22.9 秒 → 2.6 秒，
  返回的 8455 个包的 reference / files 数据照旧，仓库地址识别功能不受影响。
• 删掉页面加载时的自动预热，改为只在"打开说明卡编辑器"或"点 Detect from this workflow"
  时才懒加载——顺带把每次开页面都要组装的约 5 MB 数据也省掉了。

验证：起独立实例真开页面观察 20 秒，队列写入 0 次、日志无 Start fetching、无重启；
同时用不带 skip_update 的旧地址做阳性对照，队列立刻出现（证明检测有效）。
（tools/verify_no_queue_on_load.py）

其它

• DEVELOPMENT.md 新增硬性约定：前端不得在页面加载时调用 Manager 接口，
  确需调用必须带 skip_update=true。
• 节点、界面文案、汉化词条均无变动（仍为 4 个节点 / 224 条 ui 词条）。

安装

解压到 ComfyUI/custom_nodes/ 下，重启 ComfyUI 即可（前端入口文件走 no-store，
普通刷新就能拿到新代码，不必强刷）。

提醒：ComfyUI-Manager 面板的 Update 视图本身仍会写队列（这是 Manager 的设计，
任何插件被启用/停用、或点了检查更新都会发生），与本插件无关。

v0.5.0

本版把 AusBoss 的 Image Crop + Rotate + Pad 搬进来，节点数 3 → 4。

新增节点

QG Image Crop + Rotate + Pad（图像裁剪 + 旋转 + 补边） —— 在节点上直接摆正画面

• 载入一张图，在节点内嵌的编辑面板里做一次旋转 / 裁切 / 补边，输出摆正并补好画布的画面
• 拖画面 = 平移取景框；拖角/拖边 = 改裁切框；拖画布边 = 给某一边补出底色边
• 可以锁裁切框比例（free 任意 / source 跟随原图，还能读自定义 qg_presets.json）
• 面板上的改动直接写回节点参数，保存、撤销、API 调用全走 ComfyUI 原生路径

输出：变换后的图像、待生成区域遮罩、缝合器、原图、输出宽高、给模型看的提示图。

• 遮罩白的地方就是「可以让模型画」的地方：补出来的边 + 旋转留下的空角 + 原图里透过去的地方
• 不想把透明区算进待生成区域，把 painted_area 设成 keep picture 即可
• stitcher 是一份「怎么把生成结果贴回原图」的说明，接下游缝合节点就能自动对齐贴回
• canvas_multiple（Divisible by）可把输出长宽凑成 8/16/32 的整数倍，出规则尺寸

中文界面

新节点的界面文案已并入 zh-CN/Nodes/ComfyUI-QG-tools.json（本节点 224 条 ui 词条），
节点标题与参数名同时进了插件自带的官方 locales/zh/nodeDefs.json。

汉化插件对文本和 title/placeholder 都是整串全等匹配，也不监听属性变化，所以
「拼出来的句子」（Pad to 4:3: …、已经是 4:3：…）、「插入之后重写的 title」以及
画布上画的字（尺寸状态栏、空画布提示、尺寸链读数）它都够不到。这一批把这些位置
改走插件自己的 zh() 通道按模板拼句子，并补上共享组件里同样拼出来的文案
（来源选择器的筛选框与提示、步进按钮、设置菜单）。编辑器右侧的尺寸状态栏此前因为
选择器写错一直是空的，本版一并修好。

安装

• 手动下载：下载下面的 ComfyUI-QG-tools-v0.5.0.zip，解压到 custom_nodes/ 下，确认目录名是 ComfyUI-QG-tools
• git clone：git clone https://github.com/live1617/ComfyUI-QG-tools
• 无需 pip install 任何东西；scipy / pymatting 用到了才用，缺了有内置回退

装完完整重启 ComfyUI，控制台应出现 [QG-tools] v0.5.0 加载完成 | 节点数 4。

许可

GPL-3.0-or-later（见 LICENSE）。本节点搬运自 AusBoss，其 MIT 许可证保留在
licenses/ComfyUI-AusBoss-LICENSE.txt。

v0.4.0

首个包含三个节点的版本。

新增节点

QG Workflow Note（工作流说明卡） —— 让别人打开你的工作流就知道怎么用

• 卡片式说明：大标题 + Markdown 正文 + 作者 + 链接，直接画在节点上
• 列出需要的模型和依赖的节点包，自动和本机安装对照，每行标出「✓ 已安装 / 缺失」，并给下载按钮
• 一键「从当前工作流检测」，把图里用到的所有自定义节点包列出来

QG Workflow Switches（工作流开关） —— 一张卡片集中开关工作流

• 选中若干节点 → 建一个开关，一键旁通 / 恢复这一整块（比如「放大 + 保存」这套）
• 也能当参数预设用：为「开」和「关」各存一套选中节点的设置值，一键切换
• 折叠后只剩标签和开关，不占画布

QG LoRA Loader（LoRA 加载器）

• 一个节点管整摞 LoRA —— 列表式的行编辑器，每行能搜文件、拖着调强度、随时开关、拖动排序
• 触发词自动汇总 —— 所有启用行的触发词去重后拼成一路字符串输出，直接接进提示词
• 整摞存成模板 —— 常用的 LoRA 组合存下来，在任何同类节点上一键套用
• 吸收模型链上的 LoRA —— 把串在模型链上下游的其它 LoRA 加载器全部并进来，原节点自动旁通，出图结果不变

安装

• 手动下载：下载下面的 ComfyUI-QG-tools-v0.4.0.zip，解压到 custom_nodes/ 下，确认目录名是 ComfyUI-QG-tools
• git clone：git clone https://github.com/live1617/ComfyUI-QG-tools
• 无需 pip install 任何东西，三个节点都在 QG-tools 分类下

装完完整重启 ComfyUI，控制台应出现 [QG-tools] v0.4.0 加载完成 | 节点数 3。

中文界面

节点定义自带官方 locales/zh/nodeDefs.json 中文翻译；前端界面文案的完整中文词条已整理成
zh-CN/Nodes/ComfyUI-QG-tools.json，提交给汉化插件
ComfyUI-Global-Translation 使用。

许可

GPL-3.0-or-later（见 LICENSE）。部分节点搬运自 AusBoss，其 MIT 许可证保留在
licenses/ComfyUI-AusBoss-LICENSE.txt。