BSAI Qwen Prompt Enhancer

基于千问（Qwen）家族系列大模型的 ComfyUI 提示词增强 / 图像反推插件。 把大白话提示词按官方规则增强为高质量出图提示词，或用多模态模型对图片进行反推描述。 三合一后端一键切换：官方PE / 本地LLaMA / API。

中文 | English

🚀 最新更新 / Latest Updates

v1.10.0 (2026-10-06) — 内置官方 Viggle Turbo 节点（Vendored）：工作流打开不再报缺 ViggleTurboSigmas / Vendored official Viggle Turbo nodes: workflows open without "missing ViggleTurboSigmas"

把 Viggle 官方 viggle_turbo.py（Qwen-Image-2.1 蒸馏节点的单文件 ComfyUI 实现）vendored 进本插件 official_viggle_vendor/，插件加载时自动注册 ViggleTurboSigmas 与 ViggleTurboLora。本机已独立安装官方节点时自动跳过，不重复注册、不互斥。任何电脑 git pull 本仓库后，含这两节点的 v5/viggle-turbo 工作流即可直接打开运行，无需再单独安装外部插件。

新增内容：

1. official_viggle_vendor/viggle_turbo.py：官方原版文件（保留原名与内容，MD5 与 HF Viggle/Qwen-Image-2.1-viggle-turbo comfyui/ 目录一致），提供 ViggleTurboSigmas（6 步固定调度，随 latent 分辨率动态 shift）与 ViggleTurboLora（unmerged 运行时侧支路挂载，避免 bf16/int8 下融合损失）。
2. __init__.py 自动注册：插件加载时检测——若本机已存在官方独立 viggle_turbo 模块且含节点 → 跳过（不冲突）；否则从 vendor 文件以独立模块名 bsai_vendored_viggle_turbo 加载并合并进 NODE_CLASS_MAPPINGS / NODE_DISPLAY_NAME_MAPPINGS。
3. 兼容性：无破坏性变更；BSAI_Qwen_Image21_Sampler 的 sigmas 输入直连 ViggleTurboSigmas 的 v5 工作流与 BSAI-Qwen-Image-2.1-viggle-turbo-t2i 工作流均可直接打开。

EN: v1.10.0 — Vendored Viggle's official viggle_turbo.py (the single-file ComfyUI implementation of the Qwen-Image-2.1 distillation nodes) into official_viggle_vendor/. On load the plugin auto-registers ViggleTurboSigmas and ViggleTurboLora; if an official standalone viggle_turbo is already installed it is skipped (no duplicates, no conflict). After git pull, any machine can open the v5 / viggle-turbo-t2i workflows that reference these two nodes without installing an extra plugin. The vendored file is the untouched official original (MD5-identical to the HF repo comfyui/ copy).

v1.08.0 (2026-10-05) — 全球全网检索同步：新增 2.1 专用蒸馏 LoRA 加速档，加速/质量指南全面更新 / Global research sync: new 2.1-specific distilled-LoRA speed presets + fully refreshed Acceleration & Quality Guide

全网检索 2026-09-23 ~ 09-29 发布的三大 2.1 蒸馏 LoRA 生态（Viggle Turbo v0.3 / Pruna 5·8步 / 阿里PAI Fun-Acc 4步），把插件加速档与指南从「Lightning 尚未发布」时代升级到「蒸馏加速已就绪」时代。

新增内容：

1. speed_preset 新增 5 个蒸馏 LoRA 加速档：Viggle Turbo 6步/CFG1 (官方节点,推荐)、Viggle Turbo 9步/CFG1 (仅diffusers)、Pruna 8步/CFG1 (质量优先,推荐)、Pruna 5步/CFG1 (极速)、官方Fun-Acc 4步/CFG1 (PAI,实验)——每档内置接线提示（对应 LoRA 仓库、固定 sigma 列表、Viggle Turbo Sigmas / ManualSigmas / PDD 用法），节点 UI 与纯预览模式对蒸馏档自动追加 ⚠ 蒸馏LoRA档 提示，防止误接到普通 KSampler 出噪图。
2. ACCELERATION_GUIDE.md 重写为 v1.08.0：新增「2.1 专用蒸馏 LoRA 详情」（精确 sigma、HF 仓库、ComfyUI 接线、质量/VRAM 实测）、「质量提升方案」（官方 cfg/steps 行为、Qwen-Image 2.1 Fix LoRA 20步工作流参数、社区细节增强 LoRA、官方 PE 双模型、Alpha/2K、编辑技巧）、「暂不可用」清单（lightx2v 2.1 仍未发布 / TeaCache 冻结 / Fun-Acc 仅实验 / Nunchaku INT4 暂无）、硬件实测数据表（Pruna H100、Viggle demo Space、消费级估算）。
3. 兼容性：旧档位 key（含 Lightning 占位档、旧 8/50 步档）全部保留，历史工作流不受影响；新档位仅新增、无破坏性变更。

EN: v1.08.0 — Globally researched the Qwen-Image-2.1 acceleration ecosystem released 2026-09-23~29 (Viggle Turbo v0.3 / Pruna 5·8-step / Alibaba PAI Fun-Acc 4-step) and upgraded the plugin from the "Lightning not yet released" era to the "distillation acceleration ready" era. New: 5 distilled-LoRA speed_preset options (Viggle 6/9-step, Pruna 5/8-step, PAI Fun-Acc 4-step) with built-in wiring hints (fixed sigmas, HF repos, node requirements) and automatic ⚠ warnings in UI/preview text; fully rewritten ACCELERATION_GUIDE.md v1.08.0 (distilled-LoRA details with exact sigmas, quality-playbook incl. Qwen-Image 2.1 Fix LoRA 20-step workflow, hardware benchmarks); all legacy preset keys preserved — no breaking changes.

v1.07.0 (2026-09-25) — 新增「节日祝福贺卡」模板 16 个（全球全网精选，缩略图含百声AI圆形logo）/ New: 16 Festival Greeting Card templates (globally curated, thumbnails with BSAI round logo)

全球全网搜索精选 16 个节日贺卡平面设计模板（type=card，新增第 13 大类「节日祝福贺卡」）：新年极简大字报 / 春节国潮剪纸 / 情人节水彩爱心 / 妇女节扁平花束 / 母亲节复古花艺 / 父亲节复古沉稳 / 儿童节3D卡通 / 端午新中式 / 七夕中式浪漫 / 教师节手绘插画 / 中秋水墨月圆 / 国庆红色喜庆 / 万圣节怪趣复古 / 感恩节暖调乡村 / 圣诞3D立体纸雕 / 生日派对气球。每个模板均为完整贺卡设计提示词（版式结构+风格锚点+文字规则），可直接用于 Qwen-Image 文生图生成贺卡。16 张缩略图全部带百声AI圆形logo，海报墙数量说明同步更新为 150 模板 / 13 分类。

新增内容：

1. 16 个贺卡模板：templates/templates.json + web/templates.json 双份同步（134 → 150），覆盖全年主流节日（元旦/春节/情人节/妇女节/母亲节/父亲节/儿童节/端午/七夕/教师节/中秋/国庆/万圣节/感恩节/圣诞/生日），每个模板含节日专属版式结构、配色/技法/元素/字体风格锚点与祝福语文字规则。
2. 缩略图全部带百声AI圆形logo：16 张 web/thumbnails/card_*.png（448×448），贺卡主题配色渐变+节日元素+中英标题+右下角百声AI圆形logo。
3. 海报墙同步：templates_wall.html 新增「节日贺卡」统计（stat-card），分类说明 12 → 13 大类，WALL_VER 升级 20260925-v107（新缩略图强制刷新缓存），数量说明同步修改。
4. 前端下拉 / 海报墙 / 三种后端（官方PE / 本地LLaMA / API）全部自动兼容，无需重启（动态加载）。

EN: v1.07.0 — 16 globally-curated Festival Greeting Card templates (type=card, new 13th category): Minimal New Year / Guochao Spring Festival paper-cut / Watercolor Valentine / Flat Floral Women's Day / Vintage Mother's Day / Retro Father's Day / 3D Children's Day / Neo-Chinese Dragon Boat / Romantic Qixi / Hand-drawn Teachers' Day / Ink Mid-Autumn / Red National Day / Playful Halloween / Warm Thanksgiving / 3D Paper-cut Christmas / Birthday Party. Each is a complete greeting-card design prompt (layout + style anchors + text rules) ready for Qwen-Image T2I. All 16 thumbnails carry the BSAI round logo; wall stats synced to 150 templates / 13 categories; WALL_VER=20260925-v107. Front-end dropdown / wall / all three backends auto-compatible, no restart needed.

v1.06.0 (2026-09-24) — 节点底部新增「保存为模板」「上传模板」按钮 / Two new buttons at node bottom: Save as Template + Upload Template

合并节点（BSAI_Qwen_Prompt_Enhancer）底部新增两个按钮，一键把自定义提示词 / 模板 JSON 直接写入「用户模板区 user_templates/」——保存后立即出现在 system_template 下拉与海报墙「用户模板」分类，无需重启、无需手动放文件。

新增内容：

1. 💾 保存为模板（左侧按钮）：自动读取当前节点「自定义系统提示词」（无则取「用户提示词」）→ 弹窗输入模板名称/描述 → 一键保存为 user_templates/{名称}.json，保存后下拉自动选中新模板。
2. ⬆ 上传模板（右侧按钮）：点击选择本地 .json 模板文件（支持单模板对象 / {"templates":[...]} 多条目自动拆分）→ 校验后直接写入 user_templates/ → 下拉自动刷新。
3. 配套新增后端 API：POST /bsai_save_user_template（JSON 保存）、POST /bsai_upload_user_template（multipart 文件上传）；load_user_templates() 每次实时扫描目录，保存/上传后即时生效，海报墙与下拉同步可见。

其他电脑更新：

cd ComfyUI/custom_nodes/BSAI_Qwen_Prompt_Enhancer && git pull
# 重启 ComfyUI，合并节点底部即出现「💾 保存为模板」与「⬆ 上传模板」两个按钮

v1.06.0 补丁1 — 海报墙缩略图缓存问题根治（Thumbnail cache root-fix）：

模板缩略图已换成真实风格示例图，但旧浏览器缓存会一直显示旧图（截图里卡片仍是"文字风格卡"）。本补丁给缩略图/logo URL 加了版本参数（?v=WALL_VER，URL 变化即强制重新下载），并为海报墙直达路由、模板 API 响应加 Cache-Control: no-store，每次打开海报墙都是最新版本。其他电脑 git pull 后重启 ComfyUI、重新打开海报墙即可，无需手动清缓存；以后每次换图只需把 templates_wall.html 里的 WALL_VER 改成新值。

v1.06.0 补丁2 — 旧工作流报「无效输入 / 输入值类型错误」（threads / timeout）一键自愈（Numeric self-heal）：

旧工作流存档里 threads、timeout 等数值参数若存成字符串/错误类型，选中模板预览时会红框报"无效输入"。本补丁在前端新增 autoFixNumericValues：加载工作流时自动把所有 INT/FLOAT 数值参数重置为正确的 number 并同步存档（后端另有 int() 强转双保险）。其他电脑 git pull 后重启 ComfyUI 即可，旧工作流打开即自动修复，无需手动改参数。

v1.06.0 补丁3 — 海报墙「🔄 刷新」按钮 + 模板 API 500 修复（Refresh button + template API 500 fix）：

海报墙分类栏新增绿色「🔄 刷新」按钮：一键重新拉取模板库（后端实时合并用户模板区），新保存/上传的模板无需关闭重开海报墙，点击刷新立即出现；刷新期间按钮置灰，完成弹出成功/失败提示。 同时修复一个被长期掩盖的隐藏 BUG：模板 API GET /api/bsai/templates 的 handler 缺少 request 参数（aiohttp 必传）导致该接口一直返回 HTTP 500——海报墙此前靠静态文件回退才正常显示。现已修复，刷新按钮可正常获取含用户模板区的完整模板库。 注意：升级后必须重启 ComfyUI 让新后端代码生效；若升级后首次点刷新仍提示 500，说明 ComfyUI 尚未重启（旧代码仍在内存）。

v1.06.0 补丁4 — 模板缩略图自动同步（Auto thumbnail sync for saved/uploaded templates）：

保存为模板时，自动把最近一张生成图作为模板缩略图下载到海报墙（web/thumbnails/{id}.png）；上传模板时自动同步 JSON 自带的缩略图（支持 base64 / http(s) URL / 本地路径，也可在 multipart 里带 thumbnail 文件字段）；上传模板无缩略图时，后端自动用 PIL 程序合成 448×448 占位卡（绿色分类条 + 模板名 + 描述 + 百声AI 底标），老用户模板首次打开海报墙时也会惰性补齐。其他电脑 git pull 后重启 ComfyUI 即可，保存/上传模板后缩略图自动出现在海报墙，无需手动放图。 When you click Save as Template, the latest generated image is automatically downloaded as the template thumbnail onto the wall (web/thumbnails/{id}.png). When you upload a template, any thumbnail embedded in its JSON (base64 / http(s) URL / local path, or a multipart thumbnail file field) is synced automatically; if there is no thumbnail, the backend programmatically renders a 448×448 placeholder card (green category bar + template name + description + "百声AI · BSAI" footer). Legacy user templates are lazily backfilled the first time the wall is opened. On other machines: git pull, restart ComfyUI, done — no manual steps. 新增后端接口 GET /bsai_latest_output（返回 output 目录最近一张生成图，供前端保存模板时自动取用）；前端「💾 保存为模板」按钮保存前自动请求该接口并把图片 URL 随保存请求一起提交。 New backend endpoint GET /bsai_latest_output (returns the newest image in the output folder for the Save button to pick up); the front-end Save button now fetches it and submits the image URL along with the save request.

---

v1.05.0 (2026-09-24) — 32 个新增模板缩略图升级为 AI 真实风格示例图 / Thumbnails of the 32 new templates upgraded to real AI style sample images

新增的 16 个排版设计 + 16 个艺术风格模板，缩略图已从程序合成的"文字风格卡"全部替换为 AI 生成的真实风格示例图 —— 与老模板（102 张）一致，每张缩略图都是一幅该风格的典型代表作品（瑞士国际主义海报、包豪斯几何构成、印象派睡莲、梵高星月夜、波普玛丽莲、蒸汽波雕塑、酸性设计金属星体……），海报墙观感统一、一眼识别风格。

升级内容：

1. 16 张排版设计缩略图：瑞士国际主义 / 包豪斯 / 苏联构成主义 / 新丑风 / 孟菲斯 / 复古雕花 / 极简大字报 / 杂志编辑 / 报纸版面 / 日式和风竖排 / 中国书法 / 故障艺术字 / 霓虹灯字 / 3D 立体字 / 像素字 / 手写涂鸦 —— 各对应一张该排版风格的 AI 作品示例图。
2. 16 张艺术风格缩略图：印象派 / 梵高式后印象 / 立体主义 / 超现实主义 / 波普 / 表现主义 / 抽象表现主义 / 装饰艺术 / 新艺术运动 / 巴洛克 / 洛可可 / 点彩 / 野兽派 / 未来主义 / 蒸汽波 / 酸性设计 —— 各对应一张该画派风格的 AI 作品示例图。
3. 全部统一裁剪为 448×448 PNG，与现有 134 张缩略图规格一致；海报墙无需改动，刷新即见。

其他电脑更新：

cd ComfyUI/custom_nodes/BSAI_Qwen_Prompt_Enhancer && git pull
# 然后 Ctrl+F5 强刷海报墙即可看到新缩略图

---

v1.04.0 (2026-09-24) — 海报墙打不开（ERR_INVALID_RESPONSE）一键修复 / Fix: template wall ERR_INVALID_RESPONSE with one-click repair

其他电脑点击「🖼 打开模板海报墙」报 ERR_INVALID_RESPONSE（网页似乎有问题 / 已永久移动）？ 这是 /extensions/ 前端静态路由在部分 ComfyUI 版本或系统代理环境下返回无效响应导致的。v1.04.0 已彻底修复：

修复内容：

1. 海报墙直达路由：插件新增 GET /bsai_templates_wall，由插件直接返回海报墙 HTML，完全绕开 /extensions/ 静态路由——任何 ComfyUI 版本、任何网络环境都能打开。
2. 按钮自动升级：插件升级后，节点上的「🖼 打开模板海报墙」按钮自动改用直达路由，无需任何手动操作。
3. 一键诊断自愈 fix_wall.bat：双击即完成——探测 ComfyUI 端口 → 测试直达路由 → 若系统代理拦截了 127.0.0.1/localhost 自动加入例外（原值备份为 fix_wall_proxy_backup.reg）→ 自动打开海报墙。
4. 手动访问地址（端口以实际为准）：http://127.0.0.1:8188/bsai_templates_wall

一键解决步骤（其他电脑）：

# 方式一（推荐）：更新插件后重启 ComfyUI，按钮直接可用
cd ComfyUI/custom_nodes/BSAI_Qwen_Prompt_Enhancer && git pull
# 方式二：双击插件目录里的 fix_wall.bat，自动诊断、自愈并打开海报墙
fix_wall.bat

---

v1.03.0 (2026-09-24) — 模板库三大新增：排版设计 + 全球画风扩展 + 用户模板区 / New: 16 Typography + 16 Art Styles + User Template Area

内置模板库从 102 个扩到 134 个（11 大分类），并新增「用户模板区」——把你自己的自定义模板 JSON 放进 user_templates/ 目录，自动汇聚成共享模板，所有工作流与海报墙即时可用。

新增内容：

1. 文字排版设计模板（16 个，新分类 typography）：全球经典与前沿排版风格—— 瑞士国际主义 / 包豪斯 / 苏联构成主义 / 新丑风 / 孟菲斯 / 复古雕花 / 极简大字 / 杂志编辑设计 / 报纸版面 / 日式和风排版 / 中国书法海报 / 故障艺术字 / 霓虹灯字 / 立体3D字 / 像素字 / 手写涂鸦字。
2. 全球画风模板（艺术风格 15 → 31 个）：新增印象派 / 后印象派(梵高式) / 立体主义 / 超现实主义 / 波普艺术 / 表现主义 / 抽象表现主义 / 装饰艺术 / 新艺术运动 / 巴洛克 / 洛可可 / 点彩 / 野兽派 / 未来主义 / 蒸汽波 / 酸性设计。
3. 用户模板区（新分类 user）：插件根目录新增 user_templates/。支持三种 JSON 格式（单个模板 / 模板+外部文件 / 模板列表），支持 {{KEY}} 变量占位，id 冲突自动加 user_ 前缀。其他电脑 git pull 后同样获得全部共享模板。
4. 动态模板 API GET /api/bsai/templates：海报墙优先走该接口（内置+用户实时合并，含全文），静态文件作为回退——新增模板无需改静态文件。
5. 缩略图：32 个新模板全部配好统一风格缩略图（深色渐变 + 分类标签 + 百声AI圆形 logo）。

用户模板区怎么用： 打开 custom_nodes/BSAI_Qwen_Prompt_Enhancer/user_templates/README.md（含格式说明），把模板 JSON 丢进该目录 → 完全重启 ComfyUI → 模板下拉与海报墙「用户模板」分类即可看到。示例见同目录 示例模板.json。

---

v1.02.0 (2026-09-24) — 新增 Jev 结构化并行决策 / New: Jev structured parallel decision nodes

新增 2 个节点：BSAI_Jev_Schema（Schema 构建器）+ BSAI_Jev_Decision（Jev 并行决策）。

Jev（llama.cpp 新技术的 ComfyUI 落地）不再让模型逐 token 手写 JSON，而是为每个字段构造 字段名: 前缀、只读取候选选项 token 的 logits，一次前向同时得到全部字段的值与置信度——类型安全、不可能产生 Schema 外的输出，毫秒级完成结构化决策。

• 如何用：BSAI_Jev_Schema 里每行写一个字段（字段名: 选项1|选项2|选项3）→ 接入 BSAI_Jev_Decision，选本地 GGUF 模型（与主节点"本地LLaMA"后端同一套加载通道）→ 填 context → 输出 result_json / confidence_json / text。
• batch_mode：勾选后按行拆分 context，每条记录一次遍历完成全部字段（工单路由、邮件分类、评论打标等批量场景）。
• 模型选择：llm_model_name / mmproj_name / chat_handler / n_ctx / n_gpu_layers / load_mtp 与主节点完全一致（含 MTP 自动剥离、handler 自动识别、模型缓存）。
• 说明：Jev 使用独立会话，决策前后自动 reset+memory_clear，不会污染后续对话；force_offload 可一键卸载全部缓存的本地模型。
• 局限：字段间互依赖的规则型任务（需要回看已写内容）不适合 Jev；记录间按顺序处理（同一条记录内字段并行）。

---

v1.02.0 (2026-09-24) — 示例工作流缺失节点一键装齐 / One-click install of all missing nodes for example workflows

其他电脑打开示例工作流报红框 node type not found / undefined（如 SetNode、GetNode、Image Comparer (rgthree)、QwenImage21_T2IPromptRewrite、DLSS5Settings、DLSS5EnhanceImages）？ 这些都不是 BSAI 插件缺失，而是示例工作流依赖了 5 个第三方节点插件。v1.02.0 已把潜空间放大示例收进插件，并提供一键安装脚本，双击即可装齐全部依赖：

v1.02.0 bundles the latent-upscale example workflow and ships a one-click dependency installer. If another PC reports missing/undefined nodes (SetNode / GetNode / Image Comparer (rgthree) / QwenImage21_T2IPromptRewrite / DLSS5Settings / DLSS5EnhanceImages), just double-click the installer:

# 在插件目录下双击（或运行）：
ComfyUI/custom_nodes/BSAI_Qwen_Prompt_Enhancer/install_example_deps.bat

该脚本自动 git clone 5 个依赖插件（已存在的跳过），装完完全重启 ComfyUI 即全部亮灯： The script auto-clones the 5 dependency plugins (skips existing ones); after a full ComfyUI restart every node lights up:

工作流里的节点	提供插件
SetNode / GetNode（无线隧道）	ComfyUI-KJNodes（前端虚拟连接）
Image Comparer (rgthree)	rgthree-comfy
QwenImage21_T2IPromptRewrite	ComfyUI-Qwen-Image-2.1-Prompt-Enhancer（需下载官方 PE-T2I 模型放 models/text_encoders/）
DLSS5Settings / DLSS5EnhanceImages（潜空间放大）	ComfyUI-DLSS5-Enhancer（NVIDIA DLSS5 神经渲染；需按需运行 install_runtime.py 下载运行时）
⚠️ install_runtime.py 内置 URL 已过时（404），请用 install_example_deps.bat 提示的 --url 命令（tag 为 v3.0）；国内网络不通时在 URL 前加镜像前缀 https://gh-proxy.com/ 或 https://ghfast.top/。
easy cleanGpuUsed / easy clearCacheAll	ComfyUI-Easy-Use
PathchSageAttentionKJ / GetImageSizeAndCount	ComfyUI-KJNodes

其它常见节点（ResolutionSelector、ComfyMathExpression、SaveImageAdvanced、QwenImage21Cache、TextEncodeQwenImage21）均为 ComfyUI 官方内置，无需安装。 The rest (ResolutionSelector / ComfyMathExpression / SaveImageAdvanced / QwenImage21Cache / TextEncodeQwenImage21) are built into ComfyUI — no install needed.

另外 v1.02.0 内置 MarkdownNote 兼容节点：新版 rgthree 已移除该注释节点，BSAI 插件自带同名节点，示例工作流开箱即用。 v1.02.0 also bundles a MarkdownNote-compatible node (removed from new rgthree builds), so BSAI example workflows load cleanly on any machine.

---

v1.01.2 (2026-09-24) — 兼容新旧两代 ComfyUI 的校验语义 / Compatible with old & new ComfyUI validation semantics

新版 ComfyUI 上报 Custom validation failed for node: backend - None（每个输入都报）？ 新版以 VALIDATE_INPUTS(**全部输入) 方式调用并要求返回 True（返回 None/False 都判失败）；旧版则以 VALIDATE_INPUTS(input_name, input_value) 两位置参调用、返回 None 表示通过。 v1.01.2 已按调用形态自动判别返回值（kwargs 形态返回 True、两位置参返回 None），新旧版 ComfyUI 全部通过校验，开图即用。请更新到 v1.01.2。

Newer ComfyUI shows Custom validation failed for node: backend - None (for every input)? New builds call VALIDATE_INPUTS(**all_inputs) and require True (None/False both count as failure); legacy builds call VALIDATE_INPUTS(input_name, input_value) and treat None as pass. v1.01.2 detects the calling convention and returns the right value (True for kwargs form, None for two-positional form), so both old and new ComfyUI pass validation cleanly on load. Update to v1.01.2.

---

v1.01.1 (2026-09-24) — 修复跨 ComfyUI 版本的校验签名兼容 / Fix VALIDATE_INPUTS signature across ComfyUI versions

v1.01 在部分 ComfyUI 版本上会报新错：Exception when validating inner node: BSAI_Qwen_Prompt_Enhancer.VALIDATE_INPUTS() missing 2 required positional arguments: 'input_name' and 'input_value'。 原因：这些版本以无参方式调用 VALIDATE_INPUTS()，v1.01 固定签名 (input_name, input_value) 因而抛错。 v1.01.1 已改为可变参数签名 VALIDATE_INPUTS(*args, **kwargs)，兼容无参 / 两参 / 带 kwargs 的所有调用方式，任何 ComfyUI 版本都开图即用、不再红框。 请把插件更新到 v1.01.1（git pull 或重新下载）。

v1.01 could fail on some ComfyUI builds with: Exception when validating inner node: ...VALIDATE_INPUTS() missing 2 required positional arguments: 'input_name' and 'input_value' — those builds call VALIDATE_INPUTS() with no arguments. v1.01.1 switches to a variadic signature VALIDATE_INPUTS(*args, **kwargs) that accepts any calling convention (no args / two args / kwargs), so every ComfyUI version loads cleanly with no red frame. Update the plugin to v1.01.1 (git pull or re-download).

---

v1.01 (2026-09-24) — 跨电脑打开工作流红框报错一键自愈 / One-click fix: validation errors when opening workflows saved on another PC

遇到 Value not in list: hf_model_name: 'Florence-2-base [...]' not in ['<未发现 HF 模型>']、节点红框「无效输入」、控制台刷 Output will be ignored？ 这是旧工作流存档的下拉值在本机不存在（例如另一台电脑选了 Florence-2，本机 models/LLM 下没这个模型）。 升级到 v1.01 后自动解决，无需任何手动操作：后端 VALIDATE_INPUTS 放行 combo 校验（不再红框/阻塞整图）+ 前端加载时自动把非法下拉值重置为列表首项。手动根治方法见文末「常见问题 / Troubleshooting」。

See Value not in list: hf_model_name: ... not in ['<未发现 HF 模型>'], a red "Invalid input" frame, or Output will be ignored spam? The workflow saved a dropdown value that does not exist on this machine (e.g. Florence-2 was selected on another PC but is not in this PC's models/LLM). v1.01 fixes this automatically — zero manual steps: backend VALIDATE_INPUTS pass-through (no red frame / no blocked graph) + frontend auto-reset of invalid combo values on load. Manual root-cause fix in "Troubleshooting" at the end of this README.

---

v0.9 (2026-09-23) — 后端稳定性修复 + 模板输出修复 / Backend Stability + Template Output Fixes

核心：彻底解决"本地 LLaMA 首次调用 Invalid chat handler: None"报错；清除模板后不再残留；预览选模板时 ENHANCED_PROMPT 正确走模板输出。 Fixes: "Invalid chat handler: None" on first local-LLaMA call; no stale output after clearing the template; ENHANCED_PROMPT now correctly follows the selected template in preview mode.

• keep_loaded 默认关闭 + 用后清理：修复 llama-cpp 在 keep_loaded=false 路径下加载后立即 _clear_cache() 提前 close LLM，导致 chat handler 被置空（Invalid chat handler: None）的问题。现在模型用完才清理，handler 始终有效 / keep_loaded now defaults off with post-use cleanup — the LLM is closed only after the call finishes, so the chat handler stays valid (fixes Invalid chat handler: None)
• 清理时机修复：_enhance_local 的缓存清理不再干扰本轮调用，多后端（官方PE / 本地LLaMA / 本地HF / API）首次调用均稳定 / Cleanup timing fixed so it never interrupts the current call; all backends (Official PE / Local LLaMA / Local HF / API) are stable on first call
• ENHANCED_PROMPT 模板优先：预览模式下选择模板后，ENHANCED_PROMPT 输出端口的预览正确显示模板拼接结果（有模板→模板，无模板→原文），不再出现"选了官方PE却直出原文" / In preview mode, ENHANCED_PROMPT now correctly shows the merged template (template if set, raw text otherwise) — no more "selected Official PE but got the raw text"
• 清除模板按钮新版：点击清除后预览与输出端口彻底清空，不再反复输出旧模板内容 / New "Clear Template" button: preview and output ports are fully cleared — no more repeated stale template output
• 角色卡模板升级（57 个模板）：完整设定总表融合 GPT Image 2 角色提示板方法论（自由排版 / 心理特质四要素 / 多套服装叠穿 / 参考图优先），新增「心理特质四要素」「多套服装+叠穿设定」2 个模板 / Character-sheet templates upgraded: the full reference sheet now follows the GPT Image 2 character-board methodology (free layout / psychology 4-element / multi-outfit layering / reference-first), plus 2 new templates (psychology profile, multi-outfit wardrobe)
• 角色卡模板再升级（59 个模板）：完整设定总表追加 剪影区 / 动作姿态区 / 局部细节放大区（Krea2 全能动态设计表方法论），新增「单图转多视角设计表」「剪影设计」2 个模板 / Character-sheet templates re-upgraded: the full reference sheet now adds silhouette / pose-action / detail-closeup zones (Krea2 all-in-one dynamic sheet methodology), plus 2 new templates (single-reference to multi-view, silhouette design)
• 艺术风格模板库（74 个模板）：参照 ComfyUI EasyUse 风格库体系新增 「艺术风格」分类 15 个风格模板（现代日式动漫 / 吉卜力治愈风 / 日漫黑白漫画 / 美式漫画 / 铅笔素描 / 炭笔素描 / 照片写实 / 电影感胶片 / 古典油画 / 水彩插画 / 中国水墨 / 浮世绘 / 赛博朋克霓虹 / 像素艺术 / 3D 皮克斯动画），海报墙同步新增「艺术风格」分类与动态统计 / Art-style template library (74 templates): new Art Styles category with 15 style templates (modern anime / Ghibli / manga B&W / US comic / pencil sketch / charcoal / photoreal / film still / classical oil / watercolor / Chinese ink wash / ukiyo-e / cyberpunk / pixel art / 3D Pixar), poster wall now has the Art Styles filter and live stats

---

✨ 功能特性

🔥 支持千问家族全部模型

本插件的 本地 LLaMA 后端 支持千问家族全系列多模态模型的本地推理与图像反推：

同时兼容其他主流多模态模型：

• Gemma 4 / Gemma 3 — Gemma4ChatHandler
• GLM-4.6V / 4.1V — 通用 mtmd handler
• MiniCPM-V4.5 / V2.6 — 专用 handler
• LFM 2.5V / 2V — 通用 mtmd handler
• Step 3V — 通用 mtmd handler
• LLaVA 1.5 / 1.6 — 专用 handler
• 以及更多 llama-cpp-python 支持的模型

💡 自动识别：chat_handler 选 auto 时，节点按模型名自动匹配对应 handler，开箱即用。

🎯 三大后端

📚 内置模板库（134 个模板，11 大分类 + 用户模板区）

Qwen Image 2.1 官方增强提示词模板 节点内置 134 个增强模板：

① 官方权威（5 个）

• Qwen-Image-2.1 官方 PE-T2I 系统规则（10KB 原文）
• Qwen-Image-2.1 官方 PE-I2I 系统规则（18KB 原文）
• 官方 API prompt_extend 改写风格（含示例）
• 官方 Prompt 公式：主体+场景+风格+镜头+氛围+细节
• 官方海报/幻灯片布局模板

② 社区最佳实践（4 个）

• 社区通用六要素模板（Tensor.Art 最佳实践）
• 中文高质量描述技巧（Qwen-Image-Lightning）
• 风格混合模板（社区）
• 细节控制模板（社区）

③ 设计模板（9 个，支持自定义变量）

• 短视频封面（9:16 竖版）
• 杂志封面（2:3 竖版）
• 书籍封面（2:3 竖版）
• 桌面壁纸（16:9 横版）
• 海报设计（2:3 竖版）
• 杂志内页跨页（3:2 横版）
• 宣传册封面（3:2 横版）
• 宣传册内页（3:2 横版）
• 户外广告看板（21:9 超宽）

④ 电影资产（13 个，支持自定义变量）

• 电影剧照（16:9 单帧）
• 电影分镜板（3x2 带标注）
• 4 宫格分镜（2x2）
• 6 宫格分镜（3x2）
• 9 宫格分镜（3x3）
• 12 宫格分镜（4x3）
• 角色三视图（正/侧/背）
• 角色四视图（正/3-4/侧/背）
• 角色六视图（全身+头部特写）
• 道具三视图（正/侧/背）
• 道具四视图（正/3-4/侧/背）
• 道具六视图（正/侧/背+细节特写）
• 场景资产概念图

⑤ 角色卡（16 个，支持自定义变量）

• 完整设定总表（三视图+表情+服装拆解+配色板）【已升级：融合 GPT Image 2 角色提示板 + Krea2 全能动态设计表方法论】
• 转面四视图（正/3-4/侧/背）
• 表情差分表（6/8 宫格）
• 服装与配饰细节拆解
• 角色配色板（含色卡）
• 一致性描述锚（50+词固定句，每次复用）
• 单张全身立绘
• 头像胸像特写
• 游戏卡牌/闪绘（splash art）
• 手游式 UI 角色卡（带信息面板）
• 姿势差分表（6 宫格动作）
• 古风/国风角色设定
• 心理特质四要素（心理特征/内在冲突/行为模式/情绪基线）【新增】
• 多套服装+叠穿设定（16:9 两套 / 21:9 三套）【新增】
• 单图转多视角设计表（参考图驱动补全）【新增】
• 剪影设计（轮廓/身材比例/外轮廓辨识）【新增】

⑥ 电影海报（12 个风格，支持自定义变量）

• 标准竖版 One-Sheet
• 群像 Ensemble Cast
• 极简 Minimalist
• 分屏对比 Split-Screen
• 环境焦点 Environment Focus
• 奥斯卡剧情片 Oscar Drama
• 复古黑色电影 Vintage Noir
• 暑期大片 Summer Blockbuster
• 恐怖片 Horror
• 爱情片 Romance
• 科幻片 Sci-Fi
• 动画电影 Anime Film

⑦ 艺术风格（15 个风格转换模板）【新增】

• 现代日式动漫（赛璐璐/清晰描线）
• 吉卜力治愈风（宫崎骏）
• 日漫黑白漫画（线稿+网点）
• 美式漫画（超级英雄漫画）
• 铅笔素描（排线明暗）
• 炭笔素描（浓黑氛围）
• 照片写实（photorealistic）
• 电影感胶片（cinematic film still）
• 古典油画（厚涂布面）
• 水彩插画（透明纸纹）
• 中国水墨（留白墨韵）
• 浮世绘（和风版画）
• 赛博朋克霓虹（未来都市）
• 像素艺术（16-bit 复古）
• 3D 皮克斯动画（渲染质感）

⑧ 人物动作姿势（16 个姿势锚点模板）【新增 · 全球全网姿势体系归纳】

• 自然站姿（Contrapposto 重心偏移）
• 双手叉腰站姿（自信开放）
• 英雄力量站姿（Power Stance 低角度）
• 椅坐（翘腿/叠腿从容）
• 地面盘坐（蝴蝶坐/正坐/割座）
• 悬坐翘腿（Figure Four 俏皮）
• 单膝跪姿 / 蹲匍（庄重/潜行）
• 侧卧躺姿（慵懒放松）
• 行走奔跑位移（动势引导）
• 跳跃腾空（动感对角线）
• 格斗战斗架势（拳击/武术）
• 手势特写（比耶/指向等）
• 情绪演绎（欢呼/庆祝等表演状态）
• 舞蹈体育（芭蕾阿拉贝斯克等）
• 动态瞬间（回眸抓拍/慢动作）
• 双人互动（背靠背/对视等）

⑨ 灵感精选（12 个 Web 灵感模板）【新增 · 全球全网真实提示词提取】

• 东方神话人物志百科海报（AI2Image #415）
• 中世纪复古旅行海报（AI2Image #418）
• 室内晨间写实摄影（AI2Image #414）
• 极简建筑地标海报（AI2Image #411）
• 日系手绘涂鸦半身插画（AI2Image #423）
• Cozy Academia 学习手记（AI2Image #408）
• 品牌户外广告信息图（Prompt123 #1223）
• 动漫数字海报网格（Prompt123 #975）
• 吉卜力田园治愈风（Prompt123 风格标签）
• 水墨工笔花鸟（Prompt123 风格标签）
• 极简现代主义版式（Prompt123 风格标签）
• 水彩植物图鉴（Prompt123 风格标签）

模板变量替换

设计/电影/角色类模板内置 {{TITLE}} {{SUBTITLE}} {{BRAND}} {{MAIN_SUBJECT}} {{COLOR}} {{STYLE}} 等占位符。 在节点的 variables 输入框按 KEY: value 逐行填写，节点自动替换并输出完整 SYSTEM_PROMPT：

TITLE: 夏日新品发布会
SUBTITLE: 2026 秋季系列
BRAND: BSAI
MAIN_SUBJECT: 一个穿红裙的女孩站在樱花树下
COLOR: 深蓝+橙金
STYLE: 商业摄影

• 变量 key 不区分大小写，支持中文冒号 ：
• 第 4 个输出 USED_VARS 报告实际替换了哪些 key、哪些未填
• 输出的 SYSTEM_PROMPT 接入增强节点的 system_template
• 若需用自己的照片作主视觉，把图片接到增强节点的 image_1 输入

💡 想修改模板内容（覆盖 / 追加要求 / 改库文件 / 新增模板）？详见 TEMPLATE_GUIDE.md。

🖼 模板海报墙（可视化选择器）

模板节点自带 可视化海报墙，点击节点上的「🖼 打开模板海报墙」按钮即可弹出：

海报墙路径：web/templates_wall.html

📦 安装

1. 将本插件放入 ComfyUI/custom_nodes/ 目录：

   ComfyUI/custom_nodes/BSAI_Qwen_Prompt_Enhancer/
   

2. 依赖：

   • 官方 PE 后端：ComfyUI 0.37.0 及以上（内置 Qwen Image 2.1 PE 支持）
   • 本地 LLaMA 后端：需安装 llama-cpp-python（推荐 0.3.36+，以支持 Qwen 3.5/3.6/3.8 全系列）

     pip install llama-cpp-python
     

   • API 后端：无额外依赖

3. 重启 ComfyUI

🚀 使用方法

方式一：官方 PE 后端（文生图 / 图生图增强）

1. 将 PE 权重放入 ComfyUI/models/text_encoders/：

   • qwen3.5_9b_qwen_image_2.1_pe_t2i.int8_convrot.safetensors（文生图）
   • qwen3.5_9b_qwen_image_2.1_pe_i2i.int8_convrot.safetensors（图生图）

2. 用 CLIPLoader 加载 PE 权重，接到节点的 clip 输入

3. backend 选 官方PE，填写提示词 → 运行

方式二：本地 LLaMA 后端（千问全系列反推 / 增强）

1. 将 GGUF 模型和 mmproj 投影器放入 ComfyUI/models/LLM/（相对路径）：

   ComfyUI/models/LLM/
   ├── Qwen3.8-27B-Instruct-Q6_K_L.gguf
   └── Qwen3.8/
       └── Qwen3.8-27B-f16_mmproj.gguf
   

2. 添加 BSAI Qwen Prompt Enhancer 节点：

   • backend 选 本地LLaMA (GGUF + mmproj)
   • llm_model_name 下拉选择主模型 GGUF
   • mmproj_name 选择对应的 mmproj（多模态反推必填）
   • chat_handler 选 auto（自动匹配千问系列专用 handler）
   • 接入 image_1 ~ image_16 进行图像反推（最多 16 张图）

3. 运行即可得到增强后的提示词或图片反推描述

💡 MTP 层自动处理：含 MTP/NextN 预测层的模型（如 Qwen 3.6/3.8 CRACK 版）会自动检测并生成去 MTP 版本（-noMTP.gguf），兼容各版本 llama-cpp-python。

方式三：API 后端

1. backend 选 API
2. 填写 api_base、api_key、api_model_name
3. 支持 OpenAI 兼容接口（阿里云百炼、本地 vLLM/Ollama 等）
4. 同样支持多图输入

方式四：Jev 结构化并行决策（新增，v1.02.0）

用于工单路由、邮件分类、评论打标、内容审核等结构化决策场景——不是生成文字，而是从你定义的合法选项中选值，并给出置信度。

1. 添加 BSAI_Jev_Schema 节点，每行定义一个字段：

   department: tech|billing|shipping
   priority: low|medium|high
   sentiment: positive|negative|neutral
   

   instruction（可选）填字段判断规则，如 You are a support ticket router. Classify each field strictly based on the context.

2. 添加 BSAI_Jev_Decision 节点并连接 jev_schema：

   • context：待决策的文本（客户信息 / 邮件 / 工单内容）
   • batch_mode：勾选后每行一条记录，逐条完成全部字段决策
   • llm_model_name / mmproj_name / chat_handler / n_ctx / n_gpu_layers / load_mtp：与"本地LLaMA"后端完全一致（MTP 自动剥离 / handler 自动识别 / 模型缓存）

3. 输出：

   • result_json：{"department": "billing", ...}（可直接接下游）
   • confidence_json：每个字段的值 + 置信度 + 全选项得分
   • text：人类可读摘要

💡 与逐 token 生成的区别：Jev 一次前向同时得到全部字段（同记录内并行），模型只能从选项里选，不可能产生 Schema 外的输出；配合 KV 前缀缓存，毫秒级返回。字段间互依赖的规则型任务（需要回看已写内容）不适合 Jev。

📁 目录结构

BSAI_Qwen_Prompt_Enhancer/
├── __init__.py                  # 节点注册
├── common.py                    # 公共工具：规则加载/消息构造/输出解析/图片转换
├── nodes_enhancer.py            # 三合一增强节点（官方PE / 本地LLaMA / API）
├── nodes_jev.py                 # Jev 结构化并行决策节点（Schema + Decision）
├── jev_mode.py                  # Jev 引擎（与 ComfyUI-llama-cpp_vlm 同步的独立副本）
├── nodes_template.py            # 模板库节点
├── system_prompts/              # 官方 PE-T2I/I2I system_prompt 原文
├── templates/                   # 模板库（cinema / design / 官方公式）
├── web/                         # 前端 JS + 缩略图
├── examples/                    # 示例工作流
└── README.md

🔧 节点输出

增强节点统一输出 10 路：

KSampler 上右键 steps/cfg → Convert to input，接上 RECOMMENDED_STEPS/RECOMMENDED_CFG，切换 speed_preset 档位即自动联动采样参数。

⚠️ 仅预览（preview_only）模式

preview_only（仅预览）开启时，所有后端都不会调用模型，节点直接输出文本预览，不做任何增强：

• ENHANCED_PROMPT = 你的原始 prompt_text（原文直出，不增强）
• MERGED_TEXT = 模板 + 用户要求拼接（无模板时为空）
• 开启时节点会变红并提示"未增强"，防止误用

适用场景：模板海报墙选卡时的快速预览、查看模板拼接效果。 正式出图必须关闭「仅预览」，否则官方PE / 本地LLaMA 不会真正增强，出图用的是你的原文。

提示：用模板海报墙选模板会自动勾选「仅预览」用于秒出预览，选完记得关闭再出图。

📝 说明

• 模型目录全部使用 相对路径（models/LLM/、models/text_encoders/），插件移动到任何位置都能正常工作
• 与 BSAI 系列其他插件的 Qwen 反推逻辑完全对齐，加载参数一致
• 支持 keep_loaded 保持模型驻留显存，批量处理时不用反复加载

⚡ 加速指南（Qwen Image 2.1 最新升级）

Qwen Image 2.1（7B DiT）为 CFG-distilled 架构，官方 day-0 推荐参数为 25步 / cfg=1.0 / euler / simple。 不要再用旧版 20B 的 cfg=3~4，否则会过饱和、过曝、构图僵硬，且每步要多跑一次模型前向。

内置 11 档加速预设（speed_preset）

选档后 RECOMMENDED_STEPS / RECOMMENDED_CFG 直接输出对应参数，KSampler 接线即可联动：

推荐模型与叠加加速（按收益排序）

1. 模型用官方 int8 convrot 版：qwen_image_2.1_int8_convrot.safetensors（显存减半、更快）
2. 启动参数：--fast --use-sage-attention（fused kernels + SageAttention 注意力加速，采样阶段快 20-40%）
3. TE-Speed QwenImage21 节点（第三方，输出预测缓存）：接线 UNETLoader → QwenImage21Cache → TE-Speed → KSampler，提速 30-40%
4. EasyCache / KV Cache：ComfyUI 内置 QwenImage21Cache，编辑工作流加速明显
5. torch.compile：TorchCompileModel 节点，10-30%（首次编译有冷启动）

参考速度

RTX 4090 / 1024×1024 / int8 / 25步 ≈ 7.5 秒/张；叠加 SageAttention + EasyCache 后约 4-5 秒。

⚠️ 注意事项

• 2.1 专用 Lightning LoRA 尚未发布（预计 2-6 周），当前选 8/4 步档会出噪图
• 勿用旧版 20B Lightning LoRA（如 Qwen-Image-Lightning-8steps-V2.0，架构不同，权重形状不匹配）
• 勿用 TeaCache（已冻结 14 个月，不兼容 2.1）
• ComfyUI 需 v0.37.0+ 才原生支持 2.1

详细加速方案与硬件实测见 ACCELERATION_GUIDE.md，技术调研见 RESEARCH_REPORT.md。模板机制与修改方法见 TEMPLATE_GUIDE.md。

---

❓ 常见问题 / Troubleshooting

Q：打开工作流报错 Value not in list: hf_model_name: 'Florence-2-base [...]' not in ['<未发现 HF 模型>']，节点弹红框「无效输入」，控制台刷 Output will be ignored？

原因：工作流是在另一台电脑保存的，hf_model_name（本地 HF 后端）选了 Florence-2-base [Florence2ForConditionalGeneration]；当前电脑的 ComfyUI/models/LLM 下没有该模型（未下载 / 目录不同），下拉列表只剩 <未发现 HF 模型>，ComfyUI 校验失败 → 红框 + 整图被忽略。

✅ 一键解决（v1.01.1+，无需任何手动操作）：升级到 v1.01.1，插件内置两层自愈：

1. 后端放行：VALIDATE_INPUTS 跳过 combo 的 value-in-list 校验 → 开图不再红框、不再阻塞整图；
2. 前端自动重置：加载工作流时把非法下拉值自动重置为当前列表首项，并在节点 tooltip 提示「下拉选项已自动重置」。

升级后打开工作流即恢复正常，在 hf_model_name 下拉里重新选择本机实际存在的模型即可。

手动解决（根治）：把 Florence-2 模型放入 ComfyUI/models/LLM/（目录结构：models/LLM/<模型目录>/model.safetensors + config.json 等 Transformers 目录格式）。下载参考：

pip install -U huggingface_hub
hf download microsoft/Florence-2-base --local-dir ComfyUI/models/LLM/Florence-2-base

Q：其他下拉也报 Value not in list？

同一原因（旧存档值不在当前选项列表，如模板库版本变化后的 system_template、模型目录变化后的 llm_model_name）。v1.01.1 对全部下拉统一做了自愈，重启 ComfyUI 后打开工作流即自动重置，无需手动改节点。

---

v1.01 (2026-09-24) — 一键兼容旧工作流 / One-click compatibility for saved workflows

• 修复跨电脑打开工作流红框报错：combo 存档值不在当前选项列表（典型：另一台电脑选了 Florence-2，本机未下载该模型）时，不再弹「无效输入」/ 刷 Value not in list / Output will be ignored。后端 VALIDATE_INPUTS 放行 + 前端加载时自动重置非法下拉值，开图即用 / Fixes red-frame validation errors when opening workflows saved on another PC (stored combo values missing on this machine, e.g. Florence-2 not downloaded): backend VALIDATE_INPUTS pass-through + frontend auto-reset of invalid combo values on load.
• README 双语新增疑难解答 / Bilingual troubleshooting added.

🔄 更新与自查（其他电脑务必看这里）/ Update & self-check (for other PCs)

症状：其他电脑打开工作流仍报 Custom validation failed for node: X - None 或 Value not in list。 99% 是因为插件没更新到 v1.02.0（或更新后没重启）。 请按下面两步确认：

第 1 步 — 更新插件到 v1.02.0（在插件目录 ComfyUI/custom_nodes/BSAI_Qwen_Prompt_Enhancer 执行）：

git pull origin main
# 或重新下载最新仓库 zip 覆盖（ComfyUI Manager 用户：点 UPDATE ALL 后选本插件）

第 2 步 — 完全重启 ComfyUI（不是刷新浏览器页面）：关掉 ComfyUI 进程，重新启动。

自查是否已生效：重启后看 ComfyUI 控制台第一屏，应有横幅：

[BSAI_Qwen_Prompt_Enhancer] 插件已加载 | 版本 v1.02.0 (2026-09-24) | ...

• 看到 v1.02.0 → 已更新，重新打开工作流即正常。
• 没有这行 / 版本号是 v1.01.2 或更早 → 插件没更新成功：检查插件目录里 git pull 是否成功、ComfyUI 是否完全重启、或从 G 盘/旧 zip 拷的是不是旧文件。

命令行确认版本：

git -C ComfyUI/custom_nodes/BSAI_Qwen_Prompt_Enhancer log --oneline -1
# 应显示本次 v1.02.0 提交或更新的提交