1. ComfyUI 节点式流处理引擎内核架构与调度体系深度剖析:工程图谱

备注

单一事实源说明 本文件是《ComfyUI 节点式流处理引擎内核架构与调度体系深度剖析》全书各章节编写状态与知识依赖的唯一权威图谱。所有自动化写作任务与调度器均以此文件的完成状态作为推进依据。

1.1. 总体进度概览

  • 总规划模块数:7 个核心模块

  • 总规划章节数:28 节深度专著章节

  • 已完成章节:28 节(全书 7 大模块全部 28 节已 100% 全部完工落盘!)

  • 当前写作状态:全书全部完结(Completed)


1.2. 模块详细进度与章节清单

1.2.1. 第 1 模块:有向无环图调度与执行引擎 (01_execution_and_scheduler) [已完工]

  • [x] 01_prompt_executor_and_dag.rst - PromptExecutor 执行状态机、动态 DAG 拓扑排序算法 (TopologicalSort/ExecutionList) 与节点调度执行闭环

  • [x] 02_node_caching_and_dirty_tracking.rst - 节点缓存哈希签名树 (CacheKeySetInputSignature)、IS_CHANGED 脏状态探测与 RAMPressureCache 内存压力回收

  • [x] 03_lazy_evaluation_and_subgraph_expansion.rst - 惰性计算机制 (check_lazy_status)、动态子图展开 (Subgraphs/Ephemeral Nodes) 与执行熔断器 (ExecutionBlocker)

  • [x] 04_prompt_queue_and_async_dispatcher.rst - PromptQueue 优先队列调度、线程安全条件变量、原子中断控制与异常熔断机制

1.2.2. 第 2 模块:动态显存管理与模型卸载机制 (02_vram_and_offload_management) [已完工]

  • [x] 01_vram_state_and_device_tracking.rst - GPU 显存物理布局探测 (vram_state)、显存预算阈值划分与异构计算设备分配策略

  • [x] 02_model_lifecycle_and_loaded_models.rst - LoadedModel 生命周期状态机、显存占用空间预估算法与动态 LRU 驱逐策略

  • [x] 03_dynamic_weight_streaming_and_cast.rst - 权重跨设备流式换入换出 (load_models_gpu/free_memory)、权重精度即时转换与 CastBuffer 机制

  • [x] 04_aimdo_and_memory_pressure_guard.rst - AIMDO 显存压感监控、PyTorch 显存碎片整理、OOM 异常拦截与主动垃圾回收

1.2.3. 第 3 模块:动态权重修补与 LoRA/Hook 注入体系 (03_model_patcher_and_hooks) [已完工]

  • [x] 01_model_patcher_core_architecture.rst - ModelPatcher 对象模型架构、底层 PyTorch 模型代理封装与浅拷贝克隆树机制

  • [x] 02_weight_patch_algebra_and_lora.rst - 权重差分注入代数 (add_patches/calculate_weight)、LoRA/DoRA 矩阵在线融合与动态去补丁

  • [x] 03_object_patches_and_forward_wrappers.rst - 模块级对象替换 (object_patches)、Forward 计算图函数拦截与链式 Hook 调度体系

  • [x] 04_model_options_and_transformer_options.rst - transformer_options 运行时上下文注入机制、注意力机制劫持与跨节点状态传递

1.2.4. 第 4 模块:扩散模型基类与 DiT 架构抽象 (04_model_base_and_architectures) [已完工]

  • [x] 01_base_model_and_unet_dit_taxonomy.rst - BaseModel 体系架构、DiffusionModel 骨干抽象与多代生成模型族谱分发

  • [x] 02_latent_diffusion_unet_internals.rst - SD 1.5 / SDXL UNet 拓扑:ResBlock、Spatial Transformer、CrossAttention 与时间步/文本条件注入

  • [x] 03_dit_architecture_and_mmdit.rst - MMDiT (SD3 / Flux) 双流/单流 Transformer 块、RoPE 旋转位置编码与自适应调制层 (AdaLN)

  • [x] 04_controlnet_and_guiding_mechanisms.rst - ControlNet 残差分支挂载、T2I-Adapter 浅层特征注入与跨架构模型级引导抽象

1.2.5. 第 5 模块:采样器数值解法与调度方程 (05_samplers_and_scheduling) [已完工]

  • [x] 01_samplers_and_kdiffusion_wrapper.rst - KSampler 采样调度框架、KSamplerImpl 状态机与 k-diffusion 数值积分器统一封装

  • [x] 02_noise_schedules_and_sigmas.rst - 连续与离散噪声时间表 (Beta/Cosine/Simple/Karras) 与 Sigmas 序列生成方程

  • [x] 03_cfg_and_guidance_computation.rst - 无分类器引导 (CFG) 数学计算、负向提示词对抗、动态阈值 (Dynamic Thresholding) 与 Rescale CFG

  • [x] 04_ode_sde_solvers_internals.rst - 经典 ODE/SDE 求解器内核:Euler, Heun, DPM-Solver++, UniPC 与 Ancestral 随机采样微分方程离散化

1.2.6. 第 6 模块:文本编码与潜空间重构 (06_text_encoding_and_latent) [已完工]

  • [x] 01_clip_and_t5_tokenization_pipeline.rst - 文本分词器 Tokenizer 管道、多权重加权语法解析 (Weight Parsing) 与 77-Token 长文本 Chunking

  • [x] 02_text_encoder_embeddings_and_pooling.rst - CLIP/T5 双编码器表征空间映射、Text Embeddings 提取与 Pooled Output 投影矩阵

  • [x] 03_vae_architecture_and_tiling.rst - 变分自编码器 (VAE) 卷积编解码拓扑、潜空间缩放因子 (scaling_factor) 与色彩通道对齐

  • [x] 04_tiled_vae_and_latent_preview.rst - 大图切块 VAE 编解码 (Tiled VAE) 边缘重叠羽化融合算法与 Latent 实时流式预览 (TAESD)

1.2.7. 第 7 模块:自定义节点协议与 WebSocket 通信体系 (07_custom_nodes_and_comms) [已完工]

  • [x] 01_custom_node_protocol_and_registration.rst - 自定义节点协议标准 (NODE_CLASS_MAPPINGS/INPUT_TYPES/RETURN_TYPES) 与动态注册机制

  • [x] 02_v3_api_and_typing_architecture.rst - ComfyUI V3 API 面向对象节点范式 (_ComfyNodeInternal/io.Combo/Schema 类型校验系统)

  • [x] 03_server_and_rest_api_layer.rst - aiohttp 异步 Web 服务端架构、路由注册与 RESTful 提示词提交控制流

  • [x] 04_websocket_streaming_and_client_sync.rst - WebSocket 异步二进制/JSON 事件流式广播 (executing/progress/executed) 与前端实时状态同步