ComfyUI-SkinBeauty-CN v2.2.2

ComfyUI-SkinBeauty-CN v2.2.2

中文

P0 修复

• 精确预览不再读取 LoadImage 文件或先缩到 1600px 处理。
• 预览使用 ComfyUI 官方局部执行，运行处理节点和 IMAGE、参数、任意外部 MASK 的必要祖先；节点 186、视频生成、编码和保存下游不会进入预览 prompt。
• 正式处理与精确预览共用 run_skin_beauty：输入张量、原始分辨率、外部/语义蒙版、参数、批处理、设备选择、OOM 回退与结果张量同源。
• 完整分辨率结果生成后，内部终点才把第一张图缩放为最长边不超过 1600 的无 metadata 临时 PNG。三个正式 IMAGE 输出的批次、宽高、Alpha 与额外通道不变。
• 自动预览采用 650ms 防抖、single-flight、最新请求替换与过期结果丢弃。

安全与发布链

• 已移除独立文件读取预览路由；临时 PNG 使用原子替换，失败不会留下半文件或覆盖已知正常结果。
• GitHub Actions 固定到执行时核验的完整 commit SHA；GitHub Release 与 Registry 发布均必须先通过同一个完整 Quality Gate。
• 仓库已迁移到 chen-zhang-ai 组织；v2.2.1 的公开提交、Tag、Release 和资产未改写。
• 核心仍为 dependencies = []，没有根 requirements.txt、安装脚本或自动 pip。MediaPipe 始终可选，显式模式也只下载经 SHA256 验证的模型。

安装与升级

可下载 ComfyUI-SkinBeauty-CN_v2.2.2.zip 或执行：

cd ComfyUI/custom_nodes
git clone https://github.com/chen-zhang-ai/ComfyUI-SkinBeauty-CN.git

升级时请完整替换旧插件目录、重启 ComfyUI，并在浏览器按 Ctrl+F5。节点 class ID、Python 输入键、内部枚举值、输出顺序和 V1/V2.2 工作流保持兼容。

Registry/Manager 条目只会在真实 PublisherId、发布密钥和公共冷安装验证完成后公布；在此之前不要安装同名未知来源包。

校验

Get-FileHash .\ComfyUI-SkinBeauty-CN_v2.2.2.zip -Algorithm SHA256

与 SHA256SUMS.txt 对照。普通问题请提交到 Issues；安全问题请按 SECURITY.md 私下报告。

English

P0 fix

• Exact preview no longer reads a LoadImage file or processes a source pre-scaled to 1600 px.
• It uses ComfyUI's official partial execution and runs only the processor plus required IMAGE, settings, and arbitrary external-MASK ancestors. Node 186 and downstream video generation, encoding, and save nodes are absent from the preview prompt.
• Formal execution and exact preview share run_skin_beauty, including the input tensor, source resolution, external/semantic mask, settings, batch mode, device selection, OOM fallback, and result tensor.
• Only after the full-resolution result exists does the internal sink encode the first batch item as a metadata-free display PNG capped at 1600 px. All three formal IMAGE outputs preserve batch, dimensions, alpha, and extra channels.
• Automatic preview uses a 650 ms debounce, single-flight execution, latest-request replacement, and stale-result rejection.

Security and release chain

• The standalone file-reading preview route is removed. Temporary PNGs use atomic replacement so failures leave no partial file and do not overwrite a known-good result.
• Every GitHub Action is pinned to a verified full commit SHA. GitHub Release and Registry publishing both depend on the same complete Quality Gate.
• The repository moved to the chen-zhang-ai organization without rewriting the public v2.2.1 commits, tag, release, or assets.
• The core remains dependencies = [], with no root requirements file, installer, or automatic pip. MediaPipe stays optional; its explicit mode downloads only a SHA256-verified model.

Install and upgrade

Download ComfyUI-SkinBeauty-CN_v2.2.2.zip or run:

cd ComfyUI/custom_nodes
git clone https://github.com/chen-zhang-ai/ComfyUI-SkinBeauty-CN.git

For upgrades, replace the complete plug-in folder, restart ComfyUI, and press Ctrl+F5. Node class IDs, Python input keys, stored enum values, output order, and V1/V2.2 workflows remain compatible.

The Registry/Manager entry will be announced only after a real PublisherId, secure publishing key, and public cold-install verification are complete. Until then, do not install an unrelated similarly named package.

Verify

sha256sum ComfyUI-SkinBeauty-CN_v2.2.2.zip

Compare it with SHA256SUMS.txt. Use Issues for ordinary problems and SECURITY.md for private vulnerability reports.

ComfyUI-SkinBeauty-CN v2.2.1

ComfyUI-SkinBeauty-CN v2.2.1

中文

面向人物参考图的自然肤色美白节点：偏黄/偏暖转冷白皮，优先保护背景、高光、纹理和正式输出分辨率。

本版亮点

• 开源加固：标准治理文件、安全边界、CI、可复现打包和公开安装验证流程。
• 中英文 UI、Canvas 控件、节点文档、README 和处理报告。
• 三套清理后的工作流：纯算法最小示例、自动语义最小示例、MiniMax H3 集成示例。
• 核心 dependencies = []，无根 requirements/install 脚本、无自动 pip、无 cv2。
• MediaPipe 模型下载改为固定 HTTPS 版本和 SHA256，带超时、大小上限、.part、加载校验与原子替换。
• 删除浏览器近似美白，自动/手动预览都使用同一后端真实算法。
• 增加经授权、去 metadata 的界面截图；Release 附带 3 秒静音并排视频 skinbeauty-video-comparison.mp4 及独立 SHA256 文件。两路运动不逐帧锁定，仅作动态观感展示。

安装与升级

可通过 ComfyUI Manager/Registry（发布后）、Git clone，或下载 ComfyUI-SkinBeauty-CN_v2.2.1.zip。升级请完整替换旧文件夹、重启 ComfyUI 并按 Ctrl+F5。节点 ID、Python 输入键、内部枚举值、输出顺序和 V1/V2.2 工作流保持兼容。

先尝试 workflows/SkinBeauty_Minimal_Pure_Algorithm.json；自动语义示例在缺少 MediaPipe 时也会回退运行。

MediaPipe 风险提示

核心功能不需要 MediaPipe。不需要时不要安装。 手工安装可选包可能改变 ComfyUI 共享环境中的 NumPy/protobuf。插件从不执行 pip；明确下载模式只下载校验后的模型，不安装 Python 包。默认自动模式不下载。

校验

Get-FileHash .\ComfyUI-SkinBeauty-CN_v2.2.1.zip -Algorithm SHA256
Get-Content .\SHA256SUMS.txt

已知限制包括米色背景/衣物误选、轻量语义模型漏选，以及精确预览源需能追溯到 LoadImage。请在 Issues 报告普通问题。

English

Natural person-skin correction for ComfyUI: shift yellow/warm skin toward a cooler white tone while protecting the background, highlights, texture, and full-resolution outputs.

Highlights

• Open-source hardening with governance, security boundaries, CI, reproducible packaging, and public-install verification.
• English/Chinese UI, Canvas controls, node docs, READMEs, and reports.
• Three sanitized workflows: pure-algorithm minimal, auto-semantic minimal, and MiniMax H3 integration.
• Core dependencies = []: no root requirements/install script, runtime pip, or cv2.
• Fixed HTTPS MediaPipe model version and SHA256 with timeout, size limit, .part, load validation, and atomic replacement.
• Exact backend processing replaces the old approximate browser whitening preview.
• Authorized metadata-free screenshots are included. The Release adds a three-second silent side-by-side skinbeauty-video-comparison.mp4 and its own SHA256 file; the two motions are not frame-locked and are presented only as a dynamic visual example.

Install and upgrade

Install through ComfyUI Manager/Registry once published, Git clone, or ComfyUI-SkinBeauty-CN_v2.2.1.zip. Replace the old folder completely, restart ComfyUI, and press Ctrl+F5. Node IDs, Python keys, saved enum values, output order, and V1/V2.2 workflows remain compatible.

Start with workflows/SkinBeauty_Minimal_Pure_Algorithm.json. The auto-semantic example also works without MediaPipe by falling back.

MediaPipe warning

MediaPipe is not required. Do not install it unless needed. Manual installation can alter NumPy/protobuf in the shared ComfyUI environment. The plugin never runs pip; explicit download mode downloads a verified model only and never installs Python packages. Default automatic mode never downloads.

Verify

sha256sum ComfyUI-SkinBeauty-CN_v2.2.1.zip
cat SHA256SUMS.txt

Known limitations include beige-object false positives, lightweight semantic-model misses, and the LoadImage trace requirement for standalone exact preview. Report ordinary problems through Issues.