Comfyui-Moss-Image-Blockcache-T8
BlockCache acceleration for ComfyUI native MOSS-Image Base/SFT, with verified canvas workflows.
ComfyUI MOSS Image BlockCache T8
简体中文 · English
适用于 ComfyUI 官方原生 MOSS-Image Base / SFT 的实验性 BlockCache 加速节点。通过首块变化检测与尾部残差复用减少重复计算，保留原生模型加载、采样和 VAE，直接使用本地已有模型，无需新增推理依赖。
Comfy Registry · 实测报告 · 问题反馈
安装
需要 ComfyUI 0.42.0 或更新版本，且已支持原生 MOSS-Image。
在 ComfyUI Manager 中搜索 MOSS Image BlockCache T8（节点包 ID：moss-image-blockcache-t8），安装后重启。也可在 ComfyUI/custom_nodes 中手动安装：
git clone https://github.com/T8mars/Comfyui-Moss-Image-Blockcache-T8.git comfyui-moss-image-blockcache-T8
插件不下载、转换或修改模型。使用自定义节点白名单启动时，将安装目录名加入 --whitelist-custom-nodes。
工作流
Base、SFT 均已有真实 ComfyUI 画布运行记录。JSON 和 PNG 内嵌工作流已更新为当前默认参数；PNG 预览保留此前出图结果。
| 模型 | 画布工作流 | 内嵌工作流的图片 | |---|---|---| | Base | JSON | PNG | | SFT | JSON | PNG |
拖入 JSON 或 PNG，在加载器中选择本地原生 DiT、type=moss_image 的文本编码器和匹配 VAE。示例预选 T8 BF16 文件名，可按本机文件修改；*-api.json 是 API 格式。
Load Diffusion Model → MOSS Image Block Cache (T8)
→ SkipLayerGuidanceDiTSimple（负分支 skip22）→ KSampler
节点位于 T8/MOSS-Image 分类，输入、输出均为标准 MODEL。示例为 1024×1024、50 步、Euler / simple、CFG 3、seed 42。
保留 MOSS 原生 shift=5、timestep multiplier=1。不要添加通用 ModelSamplingSD3，它会改变时间尺度，导致错误结果。
参数
| 参数 | 默认值与说明 |
|---|---|
| enabled | 关闭后完整透传，便于与原生基线对照 |
| threshold | 0.08；越大越容易复用，也越可能改变文字、人物和细节 |
| start_percent / end_percent | 0.10 / 0.90；区间外完整计算 |
| max_consecutive_hits | 1；命中后强制刷新 |
| cache_device | gpu；cpu 用传输开销换取较低的缓存显存占用 |
| max_cache_mb / metric_stride | 512 MiB / 4；限制保留缓存与指标采样间隔 |
| threshold_mode | constant；可选 two_stage，配合 split_ratio、late_threshold 调整后段阈值 |
| split_ratio / late_threshold | 0.30 / 0.14；仅在 two_stage 模式生效 |
固定阈值模式下 threshold=0 禁用缓存；两段模式还需将 late_threshold 置零，或直接关闭 enabled。缓存预算不等于整条工作流的显存上限。
实测与兼容
已验证原生 dense BF16 Base/SFT 文生图及 JSON Layout。完整权重 SFT 零阈值输出与原生基线逐像素一致；实测条件、有限样本耗时和逐组差异见 BENCHMARKS.md。
0.1.4 按用户已测试的设置更新默认参数；未追加 GPU 跑图。既有画布图片与测速记录对应 0.1.0，不代表新默认参数的重新测量。此前修复见 检查记录。
缓存属于近似加速，可能改变面部、文字、手部、布局和细节。区域条件、Control、动态权重 hooks、外部 block patch 等不支持组合回退完整计算；原生负分支 skip22 保留，正分支仍可加速。请勿叠加其他缓存插件。量化、参考图编辑、编译、低显存 offload 和其他 GPU / dtype 不在本版实测范围。
社媒与资源
B站 · YouTube · Hugging Face
API · 免费画廊 · 在线 AI 应用 · ComfyUI 整合包
许可与致谢
Apache-2.0。参考 Qwen-Image-2.1 BlockCache T8，针对 MOSS-Image 与 ComfyUI 原生实现适配。模型权重不随插件分发，详见 NOTICE。