v0.12.0

v0.12.0

中文

本版聚焦 拍摄方案卡：把场景、摄影和视觉表现保存为可选择应用的组合，方便保留灯光与机位，同时替换人物或穿搭。

• 两种保存来源：当前配置，或实际执行结果面板中选中的历史记录。跟随预设解析成具体值；未解析随机字段需先执行。保存不重抽、不自动应用或锁定。
• 按模块复用：应用前核对差异，只有勾选模块被覆盖；“不使用”也作为完整快照保存。应用并锁定会追加目标字段的随机锁，不移除其他锁。手动应用仍可更新已锁字段。
• 单卡和卡片包：JSON 导入先完整校验，再预览新增、覆盖、跳过和不适用项；默认跳过同名，替换需确认。独立节点只应用自身模块，但保存和导出完整组合卡。
• 保护与兼容：连接输入、TXT 替换、不完整历史及场景依赖冲突会明确提示。预览过期或节点会话变化不能继续写入。原人物／穿搭卡及其格式保持独立。

入口与限制

右键完整节点或场景／摄影／视觉表现独立节点 → 卡片管理 / 模块锁定 → 拍摄方案卡。保存后请保存工作流。

每节点最多 100 张拍摄方案卡，与人物／穿搭卡分别计数；名称最多 80 个 UTF-16 单位；文件最大 1 MiB，卡包包含 1–100 张。灯光属于视觉表现。卡片不包含人物、穿搭、动作、自由文本、画幅、分辨率或种子；不保证同一人物或图片一致。执行结果 JSON、工作流和卡片是不同格式。

保留 11 个节点和现有端口，无新增依赖、在线服务或生图步骤。已有工作流无须迁移；旧执行记录需重新运行才能得到新的拍摄候选数据。

验证与安装

已完成代表性的中英文 Classic／Nodes 2.0 交互、单卡／卡包下载回导、三个独立节点应用范围、工作流保存重开和 5 次宿主 CPU 纯文本执行。用户确认中文输入法、原生取消路径没有问题。公开范围干净副本通过 Python 3.10 的 215 项测试、Node 22 的 28 组前端回归、17 个 JS 语法检查、三份生成目录一致性及安装包内容合同检查。未进行生图或图像质量验收。

下载 ComfyUI-Z-Image-Prompt-Builder-v0.12.0.zip 并使用 SHA256SUMS.txt 校验，解压到 ComfyUI/custom_nodes；安装包内部目录固定为 ComfyUI-Z-Image-Prompt-Builder。也可在备份本地修改后更新 Git 安装。重启 ComfyUI，刷新或重新打开页面；不要同时启用多个安装副本。

拍摄方案卡使用说明 · 人物／穿搭卡说明

English

This release introduces Shoot Plan Cards: reusable combinations of Scene, Camera and Visual settings, with selective application. Keep lighting and camera settings while changing a person or outfit.

• Two capture sources: current settings or a selected actual execution record. Follow Preset resolves to concrete values; unresolved Random fields require an execution first. Saving does not reroll, apply or lock anything.
• Selective application: preview differences and replace only checked modules, including explicit unused values. Apply & Lock adds target fields to random locks without removing existing locks. Explicit card application may still update locked fields.
• Cards and packs: validate the whole JSON file before previewing additions, replacements, skipped names and inapplicable cards. Existing names are skipped by default; replacement requires confirmation. Standalone nodes apply only their own module while retaining and exporting the entire card.
• Safety and compatibility: linked inputs, TXT replacements, incomplete history and incompatible scene dependencies show reasons. Stale previews and changed node sessions cannot write back. Existing Person / Outfit Cards keep their separate format.

Entry point and limits

On the full builder or Scene / Camera / Visual node, use the context menu → Cards / Module Locks → Shoot Plan Cards. Save the workflow afterward.

Up to 100 shoot plan cards per node, separate from person/outfit cards; names up to 80 UTF-16 code units; files up to 1 MiB; packs contain 1–100 cards. Lighting belongs to Visual. Cards exclude person, outfit, pose, free text, canvas, resolution and seed. They do not guarantee identity or identical images. Result JSON, workflows and cards are different formats.

The package retains 11 nodes and existing ports, without new dependencies, online services or image-generation steps. Existing workflows need no migration; older execution records require another run to supply shoot-plan candidates.

Verification and installation

Representative bilingual Classic / Nodes 2.0 interactions, real card/pack download and import, all three standalone application scopes, workflow save/reopen and five host CPU-only text executions passed. The user reported successful native cancellation and Chinese IME checks. A public-scope clean copy passed 215 Python 3.10 tests, 28 Node 22 frontend suites, 17 JS syntax checks, consistency checks for three generated catalogs and the installation archive content contract. No image generation or image-quality evaluation was performed.

Download ComfyUI-Z-Image-Prompt-Builder-v0.12.0.zip, verify SHA256SUMS.txt, and extract into ComfyUI/custom_nodes; its internal root is ComfyUI-Z-Image-Prompt-Builder. Alternatively, update a Git installation after backing up local edits. Restart ComfyUI and refresh or reopen the page. Avoid duplicate active installations.

Shoot Plan guide · Person / Outfit guide

v0.11.0

v0.11.0

中文

本次聚焦 实际执行结果复用、卡片管理与 TXT 抽取结果导出，保留 11 个节点，不增加端口、依赖或在线服务。

• 结果保存为卡片：完整节点及对应独立模块可从已确认的历史执行记录保存人物卡／穿搭卡，保留该次实际解析字段，不重新随机，不自动应用或锁定。TXT 替代、空模块及不完整记录不会被猜测转换。
• 卡片管理增强：按模块和名称搜索、重命名、应用差异预览、选择性导出卡片包，以及整包校验和冲突预览。导入默认跳过同名，覆盖需确认，原单卡格式仍可用。
• TXT 结果复制／导出：两个 TXT 节点的“上次随机结果”支持“复制抽中正文”和“导出抽取记录”。只含该条正文与实际种子等信息，不含前置文本或完整词库；空候选可导出诊断但不能复制。
• 结果保护：校验提交归属和节点实例，处理缓存、早到／迟到回包；打开的面板使用冻结快照，不读取后来修改的草稿。TXT 结果只在会话内保留，不写入工作流。
• 场景逻辑修正：避免明确的户外／泳池场景随机出现“棚拍间隙调整姿态”；保留手动动作，不重新随机，不从自由提示词或 TXT 猜测场景。

使用与兼容

卡片和卡片包不是执行结果 JSON 或工作流，格式不能混用。卡片每节点最多 100 张，文件不超过 1 MB；名称最多 80 个 UTF-16 单位。保存工作流才能保留卡片、锁定、词库和草稿。记录固定字段不保证生成同一张脸。

下载 ComfyUI-Z-Image-Prompt-Builder-v0.11.0.zip 并用 SHA256SUMS.txt 校验，解压到 ComfyUI/custom_nodes；内部目录固定为 ComfyUI-Z-Image-Prompt-Builder。Git 安装先备份修改，再 git pull --ff-only。重启 ComfyUI，并完整刷新或重新打开浏览器页面；若仍见旧弹窗，先确认前端已重新加载。不要同时启用多个安装副本。

公开范围干净副本通过 208 项 Python 测试、26 组前端回归、15 份 JS 语法和三份生成目录一致性检查；另通过 39 次宿主 CPU 纯文本执行。中英文与 Classic／Nodes 2.0 代表流程、卡片人工审核及保存重开检查已完成。TXT 持久化边界通过新页面重开验证，原标签页同页刷新未证实生效；没有运行生图，不宣称图像质量验证。

卡片使用说明 · TXT 结果说明

English

This release focuses on execution-result reuse, card management and TXT selection exports. The package retains 11 nodes with no additional ports, dependencies or online services.

• Save results as cards: capture Person / Outfit Cards from confirmed execution records on the full builder and corresponding standalone modules. Save actual resolved fields without rerolling, applying or locking them automatically. TXT replacements, empty modules and incomplete records are not guessed into structured cards.
• Manage cards: search by module/name, rename, preview application differences, selectively export packs, and validate imports with conflict previews. Imports skip existing names by default; replacement requires confirmation. Single-card files remain supported.
• Copy/export TXT selections: both TXT nodes offer Copy Selected Text and Export Selection Record under Last Random Result. Only the selected entry and execution metadata are exported, not preceding prompts or the full library. Empty scopes allow diagnostic export but disable copying.
• Protect results: submission/node ownership checks handle cached and out-of-order events. Open panels use frozen snapshots, not later draft edits. TXT records remain session-only and are not saved in workflows.
• Improve scene consistency: omit a randomly selected studio-adjustment moment in known incompatible outdoor/pool scenes. Explicit actions remain intact; no rerolling or scene inference from free text/TXT.

Usage and compatibility

Cards, card packs, result JSON and workflows are different formats. Limits remain 100 cards per node, 1 MB per import, and 80 UTF-16 code units per name. Save the workflow to preserve cards, locks, libraries and drafts. Fixed fields do not guarantee face identity.

Download ComfyUI-Z-Image-Prompt-Builder-v0.11.0.zip, verify SHA256SUMS.txt, and extract into ComfyUI/custom_nodes. The internal root is ComfyUI-Z-Image-Prompt-Builder. Git users should back up edits before git pull --ff-only. Restart ComfyUI and fully refresh or reopen the page; an old dialog can indicate that the frontend has not reloaded. Avoid duplicate active installations.

Public-scope clean-copy coverage: 208 Python tests, 26 frontend suites, 15 JS syntax checks and three generated catalogs; additionally, 39 host CPU-only text executions passed. Representative bilingual Classic/Nodes 2.0 interactions, manual card acceptance and save/reopen checks were completed. TXT persistence was verified by opening a fresh page; the original tab's same-tab reload was not confirmed. No image generation or image-quality validation was performed.

Card guide · TXT result guide

v0.10.0

v0.10.0

中文

本次聚焦 人物卡／穿搭卡＋模块随机锁定，节点总数仍为 11 个。

• 右键完整节点或标准模块，打开“人物卡 / 穿搭卡 / 模块锁定”。无需增加节点高度。
• 人物卡保存人物模块的 20 个字段，含身形和妆容；穿搭卡保存服装模块的 21 个字段。发型保持独立，不保证生成人脸身份一致。
• 支持保存、应用、应用并锁定、导入导出和删除；完整节点与对应独立模块互通。卡片随工作流保存，每节点最多 100 张、名称最多 80 字符、导入不超过 1 MB。同类型同名覆盖需确认，导入不会自动应用。
• 完整节点支持八模块快捷锁定，独立节点锁定自身；原字段级锁定保留。跟随预设落实为具体值，未解析随机项需先选具体值。解锁不自动随机；手动编辑、切换预设和清空仍有效。
• 应用只影响所属模块，不覆盖其他模块、自由提示词或执行历史。已连接目标输入和 TXT 替换会阻止不生效的编辑；无新增端口、后端参数、依赖或在线调用。

安装与验证

下载 ComfyUI-Z-Image-Prompt-Builder-v0.10.0.zip，用 SHA256SUMS.txt 校验，解压到 ComfyUI/custom_nodes；包内目录固定为 ComfyUI-Z-Image-Prompt-Builder。Git 安装先备份本地修改，再 git pull --ff-only。更新后重启 ComfyUI 并刷新浏览器，勿同时保留多个有效安装副本。

195 项 Python 测试、23 组前端回归、15 份 JS 语法及三份生成目录检查；中英文和两种布局代表检查、纯文本执行与用户人工审核通过。没有运行生图。使用说明 · 验收范围。

English

This release adds Person / Outfit Cards and Module Locks, keeping the package at 11 nodes.

• Right-click the full builder or a standard module and choose Person / Outfit Cards / Module Locks. No additional node height.
• Person cards hold 20 person fields including physique and makeup; outfit cards hold 21 clothing fields. Hair remains independent. Fixed descriptions do not guarantee face identity.
• Save, apply, apply-and-lock, import/export and delete cards. Exchange cards between the full builder and the corresponding standalone module. Save the workflow to keep cards. Limits: 100 cards per node, 80-character names, 1 MB imports. Replacement requires confirmation; importing never applies automatically.
• Whole-module shortcuts supplement existing field locks. Follow Preset becomes a concrete value; choose concrete options for unresolved Random fields first. Unlocking does not reroll. Manual editing, preset changes and clearing remain available.
• Application changes only its module, preserving other modules, free text and execution history. Linked target inputs and TXT replacements are guarded. No new ports, backend inputs, dependencies or online services.

Install and verify

Download ComfyUI-Z-Image-Prompt-Builder-v0.10.0.zip, verify SHA256SUMS.txt, and extract into ComfyUI/custom_nodes. The fixed root is ComfyUI-Z-Image-Prompt-Builder. Git users should back up local edits before git pull --ff-only. Restart ComfyUI and refresh the browser. Avoid duplicate active installations.

Coverage: 195 Python tests, 23 frontend suites, 15 JS syntax checks and three generated catalogs; representative bilingual Classic/Nodes 2.0 interactions, text-only execution and user acceptance. No images generated. Usage · Acceptance scope.

v0.9.0

v0.9.0

中文

本次新增搜索反馈、实际结果快照导出和可选构图适配，节点总数仍为 11 个。

• 搜索更方便：25 组中英文别名、匹配数量、空词库／空模块／无匹配提示，以及收藏导入的新增、重复、匹配统计。修复空 TXT 模块误显示整库的问题。
• 结果可保存：完整节点和八个模块可选择最近五次执行、复制中英文并导出 JSON 内容快照。记录实际种子和解析字段，不受下一次种子影响；历史仅存内存。两个 TXT 节点的随机结果弹窗不含此导出。
• 构图适配：完整节点、服装和姿态模块新增默认关闭的开关。启用后按明确景别省略画外的独立下装、鞋袜和腿部动作，不清空原选项、不重新随机。坐姿半身保留下装和腿部动作，仅省略鞋袜；全身不额外省略。
• 兼容优先：旧工作流默认保持原规则，端口和随机池不变，无新增 Python 依赖或在线服务。独立模块需上游明确摄影上下文；复合动作、连体服、版型细节及用户 TXT／自由文本不强行拆解。

使用与安装

运行完整节点或标准模块后，点击节点内“随机 0 项 · 查看上次结果”（数字可能不同），在弹窗点击“导出此结果”。导出是内容快照，不是工作流，也不能作为用户预设导入。

下载 ComfyUI-Z-Image-Prompt-Builder-v0.9.0.zip，使用 SHA256SUMS.txt 校验，解压到 ComfyUI/custom_nodes。内部目录固定为 ComfyUI-Z-Image-Prompt-Builder。Git 安装可执行 git pull --ff-only；更新后重启 ComfyUI 并刷新浏览器。请先备份本地修改，勿同时保留多个有效安装副本。

验证

公开范围包含 195 项 Python 测试、22 组前端回归、15 个 JS 语法检查及三份生成目录检查。完成 ComfyUI 0.42.4 下中英文／经典／Nodes 2.0 代表操作、保存重开、7 次纯文本执行和用户实际导出文件核对；未生图。正式附件仅在发布 CI 通过后生成。完整验收范围与限制。

English

This release improves search feedback, adds actual-result snapshot export, and introduces opt-in framing adaptation. The package still has 11 nodes.

• Search feedback: 25 bilingual alias groups, match counts, distinct empty states, and favorite-import added/duplicate/matched counts. Empty TXT modules no longer fall back to the entire library.
• Reusable results: the full builder and eight standard modules offer the latest five execution records, Chinese/English copy, and JSON content snapshots. Records preserve actual seeds and resolved fields, independent of the next seed. History is memory-only. The two TXT random-result dialogs do not offer this export.
• Framing adaptation: an optional, default-off control in the full builder, Clothing and Pose modules. Explicit close framing omits independent lower-garment, legwear, footwear and leg-action fields without clearing selections or rerolling. Seated-half framing omits only legwear and shoes; full-body framing adds no omissions.
• Compatibility: legacy workflows keep existing rules; ports and random pools remain unchanged. No new Python dependencies or online calls. Standalone adaptation requires explicit upstream camera context; compound actions, dresses/bodysuits, fit details, free text and TXT content are not forcibly split.

Use and installation

Run the full builder or a standard module, click Random: 0 fields · Last result (the count may vary), then Export This Result. Exported JSON is content only, not an executable workflow or importable user preset.

Download ComfyUI-Z-Image-Prompt-Builder-v0.9.0.zip, verify SHA256SUMS.txt, and extract into ComfyUI/custom_nodes. The archive has the fixed root ComfyUI-Z-Image-Prompt-Builder. Git installations can use git pull --ff-only. Back up local edits, avoid duplicate active installations, restart ComfyUI, and refresh the browser.

Verification

The public scope includes 195 Python tests, 22 frontend suites, 15 JavaScript syntax checks, and three generated-catalog checks. Representative Chinese/English and Classic/Nodes 2.0 cases passed on ComfyUI 0.42.4, including save/reopen, seven text-only executions, and a user-downloaded snapshot matched against execution history. No images were generated. Official assets are built only after release CI passes. See the acceptance scope and limitations.

v0.8.0

v0.8.0

中文

新增双语“素材搜索与收藏”，覆盖完整节点、八个独立模块及两个 TXT 节点。节点数量仍为 11 个。

新功能

• 按中英文名称和实际短语搜索；多个关键词全部匹配，特殊字符按文字处理。完整节点搜索当前编辑模块，独立模块搜索其可用字段。
• 导入 TXT 后可搜索其条目，并使用标签、无标签和模块条件筛选。多个标签满足任一即可，再与关键词和模块条件共同筛选。
• 选择条目只预览；点击“应用所选条目”才更新原控件。关闭、取消及没有结果都不改已有内容；独立 TXT 节点需在手动模式应用。
• 收藏和最近 20 条成功应用记录保存在当前浏览器、当前站点；支持收藏 JSON 导出／导入，文件只有条目标识，不含 TXT 正文。恢复 TXT 收藏需重新导入相同文件名和内容的词库。
• 存储不可用时提示并降级为本页内存；补充异步关闭、删除节点关闭、事件隔离和中文输入法保护。

兼容与验证

筛选只影响列表，不改变随机候选、种子、后端参数、提示词或尺寸。字段、端口、TXT 格式和分段规则保持兼容，没有新增在线调用或 Python 依赖；用户 TXT 内容不自动翻译。

发布范围的干净副本在 Windows Python 3.10.11 通过 187 项 Python 测试，在 Node.js 22.20.0 通过 22 组前端回归；生成目录一致性和安装包必需文件检查通过。实机代表矩阵覆盖 ComfyUI 0.39.1／前端 1.53.10 的中文／英文及经典／Nodes 2.0，包含上传、搜索应用、保存恢复、收藏实际下载与导入；实体中文输入法由用户补验确认。未生图，未量化浏览器绘制时延，也不宣称覆盖全部宿主版本。

准确范围见验收记录。正式附件由发布流程在 Ubuntu Python 3.10／Node 22 CI 通过后生成。

安装

下载 ComfyUI-Z-Image-Prompt-Builder-v0.8.0.zip，用同页 SHA256SUMS.txt 校验后解压到 ComfyUI/custom_nodes。内部目录固定为 ComfyUI-Z-Image-Prompt-Builder，无需改名。Git 安装可在节点目录执行 git pull --ff-only；更新后重启 ComfyUI 并刷新浏览器。

English

This release adds bilingual Search & Favorites to the full builder, eight standalone modules, and both TXT nodes. The package still contains 11 nodes.

Features

• Search Chinese and English names and actual phrases. All space-separated keywords must match; special characters are literal. The builder searches its current module, while standalone modules search their available fields.
• After importing TXT, search entries and filter by tags, untagged entries, and module. Selected tags use OR, combined with the query and module restriction using AND.
• Selecting an entry previews it. Only Apply Selected Entry updates the original widget. Closing, cancelling, or finding no results leaves inputs unchanged. Standalone TXT nodes require Manual Selection to apply an entry.
• Favorites and the last 20 distinct successfully applied entries are stored per browser and site. Export/import JSON contains entry references only, not TXT bodies. Restore TXT favorites by reimporting the same filename and library content.
• Unavailable storage falls back to page memory with a warning. Added async-close and node-removal guards, event isolation, and Chinese input-method protection.

Compatibility and verification

Filters affect the list only, not random candidates, seeds, backend parameters, prompts, or dimensions. Fields, ports, TXT formats, and paragraph rules remain compatible. No online calls or Python dependencies were added; user TXT content is not automatically translated.

A clean copy of the release scope passed 187 Python tests on Windows Python 3.10.11 and 22 frontend suites on Node.js 22.20.0, plus generated-catalog consistency and required-package-file checks. Representative live cases covered Chinese/English and Classic/Nodes 2.0 on ComfyUI 0.39.1 / frontend 1.53.10, including uploads, search/apply, workflow restoration, and actual favorite-file download/import. The user confirmed physical Chinese IME behavior. No images were generated; browser paint latency and every host version were not verified.

See the acceptance record for exact scope. Official assets are built only after Ubuntu Python 3.10 / Node 22 release CI passes.

Installation

Download ComfyUI-Z-Image-Prompt-Builder-v0.8.0.zip, verify it with SHA256SUMS.txt, and extract it into ComfyUI/custom_nodes. The archive root is already named ComfyUI-Z-Image-Prompt-Builder. Git installations can run git pull --ff-only in the node directory. Restart ComfyUI and refresh the browser after updating.

v0.7.0

v0.7.0

中文

本次新增“随机状态与执行结果”面板，并修复现代前端保存工作流时可能出现的字段错位。节点数量仍为 11 个。

新功能与修复

• 完整节点和八个独立模块增加紧凑的只读结果入口，显示实际提交种子、解析字段、中英文正文及模块变化，方便判断随机设置是否生效。
• 最近五次执行保存在内存中；面板区分当前设置与上次执行结果，支持缓存回显。输入框中的下一次种子不会替代已执行种子。
• 按提交时的工作流、节点实例和任务编号关联结果，避免切图、删除节点或延迟结果造成串用；连接输入以实际执行值为准。
• 修复现代前端对已经压缩的保存数组再次过滤，导致字段错位的问题，覆盖完整节点、八个模块和两个 TXT 节点。已经损坏的旧文件不会自动猜测恢复。
• 补充双语界面说明、保存恢复和诊断回归，兼容旧宿主的纯文本验收脚本。

使用与兼容

Run 只抽取已设为“随机抽取”的字段。指定值、跟随预设和不使用保持各自语义；改变种子不会自动开启随机。详情是打开时的快照，运行或编辑后重新打开即可查看最新记录。

诊断历史不写入工作流，但 ComfyUI 自身的执行历史可能保存返回的 UI 数据。未知来源任务，以及多个实例共享同一个内部节点对象的子图，不显示诊断；提示词输出仍可正常使用。

提示词端口、随机算法、词库、TXT 格式和分辨率计算保持兼容，没有新增运行依赖或网络调用。

验证

已验收运行代码通过 187 项 Python 测试、21 组前端回归和 12 个 JavaScript 文件语法检查。真实界面补测覆盖经典／Nodes 2.0 删除撤销、固定种子复现、快速提交与诊断对应，以及 ComfyUI 0.31.1／前端 1.48.7 的运行、缓存和保存重开。当前宿主实测为 ComfyUI 0.39.0／前端 1.53.10。发布流程在 Python 3.10／Node 22 CI 通过后才生成正式附件。

范围与限制见验收记录。本轮使用纯文本工作流，没有生图。

安装

下载 ComfyUI-Z-Image-Prompt-Builder-v0.7.0.zip，用同页 SHA256SUMS.txt 校验后解压到 ComfyUI/custom_nodes。内部目录固定为 ComfyUI-Z-Image-Prompt-Builder。Git 安装可在节点目录执行 git pull --ff-only。更新后重启 ComfyUI 并刷新浏览器。

English

This release adds the Random Status and Execution Result panel and fixes shifted widget values when workflows are saved by modern frontends. The package still contains 11 nodes.

Features and fixes

• The full builder and eight standalone modules gain a compact read-only panel showing the submitted seed, resolved fields, Chinese/English output and changed modules.
• The last five executions remain in memory. The panel distinguishes current settings from the last result and supports cached execution data. The editor's next seed does not replace the seed used by an earlier job.
• Results are associated with the submitted workflow, node instance and job ID, preventing delayed responses from being assigned to another workflow or a deleted node. Connected inputs use executed values.
• Fixed repeated filtering of already compacted widget arrays, which could shift saved values in modern frontends. The fix covers the full builder, eight modules and both TXT nodes. Previously damaged workflows are not reconstructed by guesswork.
• Added bilingual guidance, serialization and diagnostic regressions, and compatibility with older host constructors in the text-only acceptance scripts.

Usage and compatibility

Run samples only fields set to Random. Fixed values, Follow Preset and Omit retain their meanings; changing a seed does not enable random fields. The details panel is a snapshot. Reopen it after executing or editing to see the latest record.

Diagnostic history is not serialized into workflows, but ComfyUI may retain returned UI data in its execution history. Diagnostics are omitted for unassociated jobs and subgraphs whose instances share a single internal node object; prompt output remains usable.

Prompt ports, sampling algorithms, phrase libraries, TXT formats and resolution calculations remain compatible. No runtime dependencies or network calls were added.

Verification

The accepted runtime passed 187 Python tests, 21 frontend suites and syntax checks for 12 JavaScript files. Live UI follow-up covered Classic/Nodes 2.0 deletion and undo, seed reproducibility, rapid submissions matched to diagnostics, and execution, caching and saved-workflow reopening on ComfyUI 0.31.1 / frontend 1.48.7. The current host was ComfyUI 0.39.0 / frontend 1.53.10. The release workflow creates official assets only after Python 3.10 / Node 22 CI passes.

See the acceptance record for scope and limitations. This round used text-only workflows without generating images.

Installation

Download ComfyUI-Z-Image-Prompt-Builder-v0.7.0.zip, verify it with SHA256SUMS.txt, and extract it into ComfyUI/custom_nodes. The archive root is already named ComfyUI-Z-Image-Prompt-Builder. Git installations can run git pull --ff-only in the node directory. Restart ComfyUI and refresh the browser after updating.

v0.6.1

v0.6.1

中文

本次为提示词渲染与随机场景修复版本。保留 v0.6.0 的 TXT 随机抽取及 69 条扩展短语，节点数量仍为 11 个，不增加运行依赖或网络调用。

修复

• 场景字段设为“不使用”时，不再把省略值当作场景匹配条件，避免随机切入不相关场景；非跨风格随机先使用主题或预设场景，再回退到大类。明确地点／天气仍保持锁定。
• 精简英文与中文保留的信息对齐，修复人物、发型、服装材质与配饰、摄影和视觉字段漏写；原有密度裁剪、妆容／服装隐藏分支及近景鞋袜省略继续生效。
• 校正族裔英文冠词与大小写、12 个摄影媒介的译法及四类衣物图案词组，同步英文界面显示。
• 空白穿搭结构下，仅选颜色、材质或图案时，英文不再补出未指定的衣物类型。
• 用户模块句末的问号、感叹号等不再叠加句号；英文拼接识别中文标点；纯空白自由提示词不参与连续拼接。
• 详细中文服装保留完整材质描述，但去掉衣物名前的重复材质；区分穿搭配方的未收录属性与明确空池。
• 未知预设回退时记录警告，保留旧名称迁移；清理不可达路由并避免提前读取未使用的随机池。

兼容与验证

节点端口、保存字段、TXT 格式和分辨率算法不变。新节点默认分段，旧工作流未保存排版参数时仍连续拼接。十套固定预设的选项不变；英文输出及部分详细中文措辞按上述修正规则变化。随机候选优先级修正后，同一种子的场景可能与旧版本不同，同一版本内仍可复现。

干净发布文件集通过 177 项 Python 测试、19 套前端测试、11 个 JavaScript 文件语法检查及 9 次隔离 CPU 纯文本执行，包括新增的 18 项审核回归。翻译与分辨率目录重新生成后逐字节一致。本轮没有重新进行真实浏览器点选或实际生图；自动前端测试不等于实机界面验收，也不保证模型严格遵循每个词句。逐项审核见 测试记录。

安装

下载 ComfyUI-Z-Image-Prompt-Builder-v0.6.1.zip，解压到 ComfyUI/custom_nodes。内部目录固定为 ComfyUI-Z-Image-Prompt-Builder，无需改名；使用同页的 SHA256SUMS.txt 校验安装包。先备份工作流和自定义词库，避免同时启用多个副本。Git 安装可在节点目录运行 git pull --ff-only。

更新文件不会让运行中的 ComfyUI 自动加载新代码。请重启 ComfyUI，并按 Ctrl+F5 刷新浏览器。

English

This patch release fixes prompt rendering and random scene selection. It retains v0.6.0's seeded TXT selection and 69 constrained phrases. The package still registers 11 nodes, with no added runtime dependencies or network calls.

Fixes

• Disabled scene fields no longer act as literal scene-matching constraints. Non-cross-style sampling prefers theme or preset scenes before category fallbacks, while explicit location and weather choices remain locked.
• Concise English preserves the information retained by Chinese, correcting missing person, hair, clothing fabric/accessory, camera and visual details. Existing density trimming, hidden makeup/clothing branches and close-up legwear omissions remain in effect.
• Corrected ethnicity articles and capitalization, all 12 capture-medium translations and garment-pattern phrases across four clothing branches; regenerated English UI labels.
• With an unspecified outfit structure, isolated color, fabric or pattern selections no longer invent an unselected garment type in English.
• User-module question and exclamation marks no longer receive an extra period. English joins recognize Chinese punctuation, and whitespace-only free text is ignored in continuous output.
• Detailed Chinese clothing describes fabric once while retaining its full description. Recipe selection distinguishes an uncurated property from an explicitly empty pool.
• Unknown presets log a fallback warning without breaking legacy-name migration. Unreachable routing and eager reads of unused random pools were removed.

Compatibility and verification

Ports, saved field identifiers, TXT formats and resolution arithmetic are unchanged. New nodes default to paragraphs; legacy workflows with no layout parameter still use continuous output. The ten fixed presets retain their selections, with the English output and some detailed Chinese wording corrected as described above. Scene-pool priority changes can alter an older version's seeded result; results remain reproducible within the same version.

The clean publication file set passed 177 Python tests, 19 frontend suites, syntax checks for 11 JavaScript files and 9 isolated CPU text executions, including 18 new review regressions. Regenerated translation and resolution catalogs were byte-identical. This round did not repeat live browser interaction or generate images; automated frontend tests are not a substitute for real UI acceptance or a guarantee of model output. See the review record.

Installation

Download ComfyUI-Z-Image-Prompt-Builder-v0.6.1.zip and extract into ComfyUI/custom_nodes. Its root is already named ComfyUI-Z-Image-Prompt-Builder. Verify the archive using SHA256SUMS.txt. Back up workflows and custom libraries first and avoid multiple enabled copies. Git installations can run git pull --ff-only in the node directory.

Updating files does not reload a running ComfyUI process. Restart ComfyUI and refresh the browser with Ctrl+F5.

v0.6.0

v0.6.0

中文

本次更新新增独立 TXT 词库随机抽取，扩充 69 条受约束短语，并修复组合兼容与 Nodes 2.0 界面问题。节点数量仍为 11 个。

新功能与修复

• 两个独立 TXT 词库节点提供“手动选择／随机抽取”和随机种子；同一词库、顺序、模块及种子可复现结果，不同种子允许抽到相同条目。
• TXT 模块词库只在当前模块内抽取，支持自定义模块；空库或空范围只保留前置文本，不跨模块补选。
• 手动草稿独立保留；只读“上次随机结果”显示实际执行种子、标题与正文，不误显示下一次种子。支持工作流保存恢复、缓存回显及 API 调用。
• 新增 69 条短语：姿态动作 40、服装 14、头饰 6、场景 9。手动选项与随机池共用，具备中文／英文输出和英文界面映射。
• 增加主题、场景、鞋履、景别和穿搭兼容筛选；修复部分单字段漏写、发型回退冲突及英文措辞。
• 修复 Nodes 2.0 动态按钮漏翻译、随机模块切换后禁用外观不一致的问题，保持控件内部名称及旧工作流字段兼容。

兼容与范围

• 旧工作流默认手动模式，原 STRING 端口、前置文本与分段行为保留。完整生成器内部的 TXT 面板不新增自动随机功能。
• 词库和规则扩充后，相同种子的随机组合可能与旧版不同；同一版本内可复现。固定预设除已说明的措辞修正外保持原输出。
• 编辑器种子上限为 9007199254740991，API 支持精确 uint64；API 客户端需自行更新后续种子。
• 用户 TXT 不自动翻译。词库会保存在工作流并发送给所连接的 ComfyUI 后端，不上传第三方服务；分享工作流前检查是否包含私人词库。
• 不包含参考照片、六条外部数据候选、本机记录或浏览器工具；不增加第三方运行依赖。

验证与安装

干净副本通过 159 项 Python、19 组前端及 9 次隔离 CPU 文本执行；中英文、经典与 Nodes 2.0 的真实界面验收、旧工作流、长文本安全显示和 API 重放已通过。验证不运行生图，也不保证所有宿主版本或模型输出效果。

下载 ComfyUI-Z-Image-Prompt-Builder-v0.6.0.zip，解压到 ComfyUI/custom_nodes。内部目录固定为 ComfyUI-Z-Image-Prompt-Builder，无需改名。先备份工作流和自定义词库，避免保留多个启用副本。Git 安装用户在节点目录运行 git pull --ff-only。重启 ComfyUI 后按 Ctrl+F5 刷新；使用 SHA256SUMS.txt 核对安装包。

English

This release adds seeded sampling to the standalone TXT libraries, 69 constrained phrases, compatibility corrections and Nodes 2.0 UI fixes. The package still registers 11 nodes.

Features and fixes

• Both standalone TXT nodes offer Manual / Random Selection with a seed. The same library, ordering, module and seed reproduce a result; different seeds may select the same entry.
• Module sampling stays within the selected module, including Custom. Empty libraries or scopes pass through upstream text only.
• Manual drafts are preserved separately. Last Random Result shows the executed seed, title and body rather than the next seed. Workflow restoration, cached results and headless API calls are supported.
• Added 69 bilingual phrases: 40 pose/action, 14 clothing, 6 headwear/accessories and 9 scene entries, shared by manual options and constrained random pools.
• Improved theme, scene, footwear, framing and clothing compatibility; corrected missing single-field output, conflicting hairstyle fallbacks and English wording.
• Fixed untranslated dynamic buttons and inconsistent disabled states in Nodes 2.0 while preserving stable widget identities and saved fields.

Compatibility and scope

• Existing workflows default to manual selection. Existing STRING ports, upstream text and paragraph behavior are preserved. The full builder's embedded TXT panels do not gain random sampling.
• Expanded libraries and rules may change an old seed's random result; results remain reproducible within the same version. Fixed presets retain their output except for documented wording corrections.
• Editor seeds are limited to 9007199254740991; the API supports exact uint64 values. API clients must update subsequent seeds themselves.
• User TXT content is not translated automatically. Libraries are saved in workflows and sent to the connected ComfyUI backend, not third-party services. Review private content before sharing a workflow.
• Reference photos, the six external-dataset candidates, machine-specific records and browser tooling are excluded. No third-party runtime dependencies were added.

Verification and installation

The clean snapshot passed 159 Python tests, 19 frontend suites and 9 isolated CPU text executions. Real Chinese/English UI checks in classic and Nodes 2.0 layouts, old workflows, safe long-text rendering and API replay passed. These checks did not generate images and do not guarantee every host version or model result.

Download ComfyUI-Z-Image-Prompt-Builder-v0.6.0.zip and extract into ComfyUI/custom_nodes. Its root is already named ComfyUI-Z-Image-Prompt-Builder. Back up workflows and custom libraries first; avoid multiple enabled copies. Git users can run git pull --ff-only in the node directory. Restart ComfyUI and refresh with Ctrl+F5. Verify the archive against SHA256SUMS.txt.

v0.5.1

v0.5.1

中文

本次更新简化分辨率设置，不改变提示词内容或输出端口顺序。

• 尺寸菜单仅保留 保持比例计算（推荐） 与 按像素计算，不再提供“推荐尺寸”选项。
• 分辨率相关界面按功能命名，不再用“新”“旧”区分计算方式。
• 已有工作流仍保留保存的固定尺寸；只有明确选择计算方式或修改 MP／整除倍数后，才重新计算。
• 修复英文 Nodes 2.0 中“使用已保存尺寸”状态未翻译的问题；中文、英文切换不会修改保存值或输出尺寸。
• 同步更新中英文 README、节点帮助和回归测试。

验证

• 完整节点和独立画面基础节点已完成隔离浏览器检查：Nodes 2.0 中英文下拉、实际切换及固定尺寸保存恢复通过；经典模式的中英文选项和紧凑布局通过。
• 自动回归覆盖尺寸算法、工作流兼容、双语界面、TXT 词库、模块串联及发布包完整性。
• 检查未运行生图，不改变用户工作流或设置。

安装与升级

下载 ComfyUI-Z-Image-Prompt-Builder-v0.5.1.zip，解压到 ComfyUI/custom_nodes。安装包内部目录固定为 ComfyUI-Z-Image-Prompt-Builder，无需改名。升级前备份工作流和自定义词库，不要同时保留多个启用的节点副本。

Git 安装用户在节点目录运行 git pull --ff-only。升级后重启 ComfyUI，并按 Ctrl+F5 刷新浏览器。可使用 SHA256SUMS.txt 核对安装包。

English

This patch simplifies resolution settings without changing prompt content or output-port order.

• The menu now offers only Preserve Aspect Ratio (Recommended) and Calculate from Pixels. Fixed recommended dimensions are no longer a selectable mode.
• Resolution controls use functional names rather than version-history terminology.
• Existing workflows retain their saved fixed dimensions until a calculation method is explicitly selected or MP / Divisible By is edited.
• Fixed the untranslated Use Saved Dimensions status in English Nodes 2.0. Language switching does not change saved values or output dimensions.
• Updated both READMEs, node help, and regression coverage.

Verification

The full builder and standalone Canvas node passed isolated browser checks for bilingual Nodes 2.0 dropdowns, mode selection, and saved-dimension restoration, plus classic-mode labels and compact layout. Automated regressions cover resolution arithmetic, workflow compatibility, bilingual UI, TXT libraries, module chains, and installation archive validation. No image generation was run, and user workflows/settings were not modified.

Install or update

Download ComfyUI-Z-Image-Prompt-Builder-v0.5.1.zip and extract it into ComfyUI/custom_nodes. The archive root is already named ComfyUI-Z-Image-Prompt-Builder. Back up workflows and custom libraries before updating; do not keep multiple enabled copies.

For Git installations, run git pull --ff-only in the node directory. Restart ComfyUI and refresh the browser with Ctrl+F5. Verify the download with SHA256SUMS.txt.

v0.5.0

v0.5.0

中文

• 新增百万像素（MP）与尺寸整除倍数设置，按所选画面比例换算宽高，修复分辨率控件遮挡。
• 完整节点、八个独立模块与两个 TXT 节点支持分段输出；旧工作流保留连续格式。
• 新增右键用户预设管理、JSON 导入导出、随机字段锁定与组合检查。
• 优化主题、服装、动作和摄影之间的随机兼容关系；补充动作链、配饰套组和场景选项，保留十套固定预设原文。
• 修复部分英文输出遗漏、TXT 重名和预设导入校验问题，以及经典模式和 Nodes 2.0 的中英文界面刷新问题。
• 提供四套无需生图模型的文本预览工作流。

安装与升级

下载附件 ComfyUI-Z-Image-Prompt-Builder-v0.5.0.zip，解压到 ComfyUI/custom_nodes。压缩包内部固定为 ComfyUI-Z-Image-Prompt-Builder，无需改名；不要同时保留多个启用的节点副本。升级前建议备份工作流和自定义词库，升级后重启 ComfyUI 并刷新浏览器。

Git 安装用户可在节点目录运行 git pull --ff-only。SHA256SUMS.txt 提供安装包校验值。GitHub 自动生成的 Source code 源码包仍带版本后缀，手动安装推荐使用上面的附件。

兼容说明

• 原输出端口顺序保留；旧尺寸设置及旧工作流兼容处理保留。
• 新版随机规则可能改变旧种子的组合结果，同版本内仍可复现。
• 自由提示词和 TXT 正文原样保留，不会自动翻译。
• 自动测试覆盖代码行为，不能代替全部动作及随机组合的多种子生图验收。

完整变更见 CHANGELOG。

English

• Set a megapixel budget and dimension divisibility while preserving the selected aspect ratio. Resolution controls no longer overlap.
• Paragraph output is available in the full builder, all eight module nodes, and both TXT nodes. Legacy workflows retain continuous output.
• Manage user presets, import/export JSON, lock random fields, and inspect combinations from the context menu.
• Improved random compatibility across themes, clothing, poses, and photography; expanded action chains, accessory sets, and scenes without rewriting the ten fixed presets.
• Fixed missing English fragments, duplicate TXT titles, preset validation, and bilingual UI refresh in classic mode and Nodes 2.0.
• Four text-preview example workflows require no image-generation model.

Install or update

Download ComfyUI-Z-Image-Prompt-Builder-v0.5.0.zip and extract it into ComfyUI/custom_nodes. Its root folder is already named ComfyUI-Z-Image-Prompt-Builder; do not keep multiple enabled copies. Back up your workflows and custom libraries before upgrading, then restart ComfyUI and refresh the browser. Git installations can use git pull --ff-only from the node directory.

Verify the archive against SHA256SUMS.txt. Prefer the attached installation ZIP over GitHub's automatically generated Source code archives, which include the version in their root folder name.

Existing output-port order and legacy resolution settings are preserved. Updated random rules may change results for old seeds, while remaining reproducible within this version. Free text and TXT content are preserved verbatim, not automatically translated. Automated tests validate code behavior, not image quality across every random combination.

See the full changelog for details.