feat(comfyui): 升级到 ComfyUI v0.19.4 并整理构建与插件配置

将 ComfyUI 核心钉到 v0.19.4，修正 Dockerfile 构建上下文与 pip 安装顺序；Makefile 对齐 v0.19.4 镜像与 OSS v0.19.4-alpha 上传及 LEGACY_SEED 种子拷贝。

custom_nodes.json 批量调整插件钉扎（短 SHA 等）；新增 update_custom_nodes_versions.py 与 README 说明；根 Makefile 支持向 agent 构建传入 COMFYUI_IMAGE；Agent 默认 COMFYUI 基础镜像 ARG 更新。

Change-Id: I1015fc870ff9afabc1321fd6e6c307fda65e4e4d
Co-developed-by: Cursor <noreply@cursor.com>

Author: yinsu.zs

Makefile

@@ -45,9 +45,11 @@ release:
 # ————————————————————————————————————————————————————————————————————————————————————————————————————————————————————
 # Agent镜像相关
 # 镜像构建
+# 可选: COMFYUI_IMAGE=... 传给 agent 的 docker build
+COMFYUI_BUILD_ARGS := $(if $(strip $(COMFYUI_IMAGE)),--build-arg COMFYUI_IMAGE=$(COMFYUI_IMAGE),)
 .PHONY: build
 build:
-	cd src/code/agent && docker build --platform linux/amd64 -t $(AGENT_IMAGE) .
+	cd src/code/agent && docker build --platform linux/amd64 $(COMFYUI_BUILD_ARGS) -t $(AGENT_IMAGE) .
 	docker tag $(AGENT_IMAGE) agent
 
 # 本地测试运行

src/code/agent/Dockerfile

@@ -1,4 +1,4 @@
-ARG COMFYUI_IMAGE=cap-demo-public-registry.cn-hangzhou.cr.aliyuncs.com/aliyunfc/funart-comfyui:v1.6.5
+ARG COMFYUI_IMAGE=cap-demo-public-registry.cn-hangzhou.cr.aliyuncs.com/cap-app/image-generation-comfyui-agent:v1.3.10
 FROM ${COMFYUI_IMAGE} AS comfyui_source
 
 FROM python:3.10.16-slim

src/code/comfyui/Dockerfile

@@ -9,10 +9,10 @@ ENV COMFYUI_DIR="/root/comfyui"
 
 RUN git clone https://github.com/comfyanonymous/ComfyUI.git ${COMFYUI_DIR} && \
     cd ${COMFYUI_DIR} && \
-    git checkout "v0.3.77"
+    git checkout "v0.19.4"
 
 # 复制插件列表配置文件
-COPY code/comfyui/custom_nodes_config/custom_nodes.json /tmp/custom_nodes.json
+COPY comfyui/custom_nodes_config/custom_nodes.json /tmp/custom_nodes.json
 
 # 批量安装自定义节点插件
 # 从 custom_nodes.json 读取插件列表，循环安装启用的插件
@@ -80,16 +80,18 @@ RUN cd ${COMFYUI_DIR}/custom_nodes && \
     fi
 
 # 拷贝自研插件（如果有）
-COPY code/comfyui/custom_nodes/ ${COMFYUI_DIR}/custom_nodes/
+COPY comfyui/custom_nodes/ ${COMFYUI_DIR}/custom_nodes/
 
 FROM python:3.10.16-slim AS dependencies
 
 WORKDIR /root
 
-# 安装系统依赖（git 等，PIPInstaller 可能需要）
+# 安装系统依赖（git、ffmpeg：ComfyUI>=0.19 的 PyAV/av 与部分插件构建需要）
 RUN \
     apt update && \
-    apt install -y --no-install-recommends git && \
+    apt install -y --no-install-recommends \
+        git ffmpeg pkg-config \
+        build-essential cmake && \
     rm -rf /var/lib/apt/lists/*
 
 # 升级pip并初始化venv虚拟环境
@@ -108,15 +110,16 @@ COPY --from=codes ${COMFYUI_DIR} ${COMFYUI_DIR}
 RUN --mount=type=cache,target=/root/.cache/pip \
     cd ${COMFYUI_DIR} && \
     if [ -f requirements.txt ]; then \
-        /root/venv/bin/pip install -r requirements.txt --no-cache-dir; \
+        /root/venv/bin/pip install -r requirements.txt --no-cache-dir \
+            --extra-index-url https://download.pytorch.org/whl/cu128; \
     else \
         echo "警告: ${COMFYUI_DIR}/requirements.txt 不存在"; \
     fi
 
 # 安装 ComfyUI 插件的依赖
 # 使用 ManagementService.install_custom_nodes - 智能合并依赖，处理冲突（需要 agent 代码）
 ENV AGENT_DIR="/root/agent"
-COPY code/agent ${AGENT_DIR}
+COPY agent ${AGENT_DIR}
 
 # 安装 agent 的依赖（供 ManagementService 运行，使用主 Python 环境）
 RUN --mount=type=cache,target=/root/.cache/pip \
@@ -132,10 +135,9 @@ RUN --mount=type=cache,target=/root/.cache/pip \
 
 # 重新安装 ComfyUI 依赖以修复被插件修改的版本，并修正特定版本冲突
 RUN --mount=type=cache,target=/root/.cache/pip \
-    # 重新安装 ComfyUI 依赖
-    /root/venv/bin/pip install -r ${COMFYUI_DIR}/requirements.txt --no-cache-dir && \
-    # 安装 transformers 依赖, transformers 5.0.0 与 comfyui0.3.77 不兼容
-    /root/venv/bin/pip install transformers==4.56.2 --no-cache-dir && \
+    # 与官方 requirements 一致使用 cu128 索引，避免 torch 被换成 CPU 版导致后续 wheel 失败
+    /root/venv/bin/pip install -r ${COMFYUI_DIR}/requirements.txt --no-cache-dir \
+        --extra-index-url https://download.pytorch.org/whl/cu128 && \
     /root/venv/bin/pip install setproctitle dill scikit-image -i https://mirrors.bfsu.edu.cn/pypi/web/simple/ && \
     # /root/venv/bin/pip install flash_attn && \
     # 再次强制安装指定版本的 PyTorch，防止被插件依赖覆盖
@@ -161,7 +163,7 @@ RUN \
     git curl wget jq ffmpeg gcc g++ build-essential zstd && \
     rm -rf /var/lib/apt/lists/*
 
-COPY code/agent ${AGENT_DIR}
+COPY agent ${AGENT_DIR}
 
 RUN python3 -m venv ${AGENT_DIR}/venv
 
@@ -187,6 +189,9 @@ COPY --from=dependencies ${VENV_DIR} ${VENV_DIR}
 COPY --from=codes ${COMFYUI_DIR} ${COMFYUI_DIR}
 COPY --from=agent ${AGENT_DIR} ${AGENT_DIR}
 
+# 与 aliyunfc/funart-comfyui 约定一致：agent 镜像构建时会 COPY --from=COMFYUI_IMAGE /root/built-in/custom_nodes
+RUN mkdir -p /root/built-in && cp -a "${COMFYUI_DIR}/custom_nodes" /root/built-in/custom_nodes
+
 ENV BACKEND_TYPE="comfyui"
 
 RUN chmod +x ${AGENT_DIR}/entrypoint.bash

src/code/comfyui/Makefile

@@ -1,10 +1,12 @@
 # 定义变量
 REGION ?= cn-hangzhou
-COMFYUI_IMAGE = comfyui:v1.6.5
-COMFYUI_DEEPGPU_IMAGE = comfyui:deepgpu-v1.6.5-v1
+COMFYUI_IMAGE = comfyui:v0.19.4
+COMFYUI_DEEPGPU_IMAGE = comfyui:deepgpu-v0.19.4-v1
 OSS_BUCKET ?= dipper-cache-$(REGION)
-OSS_COMFYUI_BASE_DIR = base/comfyui/v0.3.77-gamma
-OSS_COMFYUI_DEEPGPU_BASE_DIR = base/comfyui/v0.3.77-gamma-deepgpu
+OSS_COMFYUI_BASE_DIR = base/comfyui/v0.19.4-alpha
+OSS_COMFYUI_DEEPGPU_BASE_DIR = base/comfyui/v0.19.4-alpha-deepgpu
+# 上传新基线时，从旧基线拷贝 input/models（若你们 OSS 上旧路径不同，可 make OSS_COMFYUI_LEGACY_SEED=base/comfyui/xxx）
+OSS_COMFYUI_LEGACY_SEED ?= base/comfyui/v0.3.77-gamma
 
 .PHONY: upgrade
 upgrade: build upload-base
@@ -58,16 +60,16 @@ upload-base:
 
 	@echo "Creating .funart/VERSION.txt..."
 	@mkdir -p ./tmp/.funart
-	@echo "1.6.5" > ./tmp/.funart/dependency_version.txt
+	@echo "0.19.4" > ./tmp/.funart/dependency_version.txt
 
 	@echo "Uploading files to OSS..."
 	ossutil cp -r ./tmp/models oss://$(OSS_BUCKET)/$(OSS_COMFYUI_BASE_DIR)/models && \
 	ossutil cp -r ./tmp/custom_nodes oss://$(OSS_BUCKET)/$(OSS_COMFYUI_BASE_DIR)/custom_nodes && \
 	ossutil cp ./tmp/comfyui.tar.zst oss://$(OSS_BUCKET)/$(OSS_COMFYUI_BASE_DIR)/snapshots/$(SNAPSHOT_NAME)/comfyui.tar.zst && \
 	ossutil cp ./tmp/venv.tar.zst oss://$(OSS_BUCKET)/$(OSS_COMFYUI_BASE_DIR)/snapshots/$(SNAPSHOT_NAME)/venv.tar.zst && \
 	ossutil cp ./tmp/.funart/dependency_version.txt oss://$(OSS_BUCKET)/$(OSS_COMFYUI_BASE_DIR)/.funart/dependency_version.txt  && \
-	# 将 input 目录拷贝到 OSS 上
-	ossutil cp -r oss://$(OSS_BUCKET)/v0.3.77-alpha/input/ oss://$(OSS_BUCKET)/$(OSS_COMFYUI_BASE_DIR)/
+	# 将 input 目录从旧基线拷贝到新基线 OSS（源路径不存在时请先调整 OSS_COMFYUI_LEGACY_SEED）
+	ossutil cp -r oss://$(OSS_BUCKET)/$(OSS_COMFYUI_LEGACY_SEED)/input/ oss://$(OSS_BUCKET)/$(OSS_COMFYUI_BASE_DIR)/input/
 
 	@rm -rf tmp
 	@echo "Upload completed successfully"
@@ -98,16 +100,16 @@ upload-deepgpu-base:
 
 	@echo "Creating .funart/VERSION.txt..."
 	@mkdir -p ./tmp/.funart
-	@echo "1.6.5" > ./tmp/.funart/dependency_version.txt
+	@echo "0.19.4" > ./tmp/.funart/dependency_version.txt
 
 	@echo "Uploading files to OSS..."
 	ossutil cp -r ./tmp/custom_nodes oss://$(OSS_BUCKET)/$(OSS_COMFYUI_DEEPGPU_BASE_DIR)/custom_nodes && \
 	ossutil cp ./tmp/comfyui.tar.zst oss://$(OSS_BUCKET)/$(OSS_COMFYUI_DEEPGPU_BASE_DIR)/snapshots/$(SNAPSHOT_NAME)/comfyui.tar.zst && \
 	ossutil cp ./tmp/venv.tar.zst oss://$(OSS_BUCKET)/$(OSS_COMFYUI_DEEPGPU_BASE_DIR)/snapshots/$(SNAPSHOT_NAME)/venv.tar.zst && \
 	ossutil cp ./tmp/.funart/dependency_version.txt oss://$(OSS_BUCKET)/$(OSS_COMFYUI_DEEPGPU_BASE_DIR)/.funart/dependency_version.txt && \
-	# 将 input 目录拷贝到 OSS 上
-	ossutil cp -r oss://$(OSS_BUCKET)/v0.3.77-alpha/input/ oss://$(OSS_BUCKET)/$(OSS_COMFYUI_DEEPGPU_BASE_DIR)/ && \
-	ossutil cp -r oss://$(OSS_BUCKET)/v0.3.77-alpha/models/ oss://$(OSS_BUCKET)/$(OSS_COMFYUI_DEEPGPU_BASE_DIR)/
+	# 从旧基线拷贝 input / models 到新 deepgpu 基线路径
+	ossutil cp -r oss://$(OSS_BUCKET)/$(OSS_COMFYUI_LEGACY_SEED)/input/ oss://$(OSS_BUCKET)/$(OSS_COMFYUI_DEEPGPU_BASE_DIR)/ && \
+	ossutil cp -r oss://$(OSS_BUCKET)/$(OSS_COMFYUI_LEGACY_SEED)/models/ oss://$(OSS_BUCKET)/$(OSS_COMFYUI_DEEPGPU_BASE_DIR)/
 
 	@rm -rf tmp
 	@echo "Upload completed successfully"

src/code/comfyui/custom_nodes_config/README.md

@@ -9,6 +9,7 @@
 | 文件 | 类型 | 用途 |
 |------|------|------|
 | `get_topn.py` | 脚本 | 从网络拉取最新数据，生成 Top N 插件列表 |
+| `update_custom_nodes_versions.py` | 脚本 | 批量解析各插件仓库的 Git 引用，回写 `custom_nodes.json` 中的 `version` |
 | `custom_nodes.json` | 配置 | 镜像内置核心插件列表（49 个） |
 | `excluded_custom_nodes.json` | 配置 | 排除列表，记录不内置的插件及原因 |
 | `custom_nodes_top100.json` | 数据 | 按 Stars 排序的 Top 100 插件列表 |
@@ -135,6 +136,29 @@ cp custom_nodes_config/custom_nodes_top_150_2026-03-05.json \
 
 ---
 
+## update_custom_nodes_versions.py — 批量更新插件 `version`
+
+用 **`git ls-remote`** 查远程仓库（不克隆），按规则算出新的 `version` 写回 **`custom_nodes.json`**。镜像构建里会对 `version` 做 **`git checkout`**（`latest` / 空串除外），所以跑完脚本等于批量换钉的版本。
+
+**当前 `version` 怎么被改写：**
+
+| 你写的 `version` | 脚本会改成 |
+|------------------|------------|
+| `latest` 或空 | 远程默认分支最新提交的 **SHA 前 12 位** |
+| 其它（commit 前缀、tag 名、任意占位字符串等） | 远程若有 **semver 标签**，则改成 **版本号最大的 tag**；否则改成默认分支 **SHA 前 12 位** |
+
+说明：配置里只保留 **短 commit** 或 **版本号 tag** 即可；不要写分支名 `main` / `master`，否则也会按上表第二行被解析成 **tag 或 SHA**。
+
+依赖：**本机 `git`**、Python **`packaging`**（`pip install packaging`）。默认并行 8 个仓库；有解析失败的条目会跳过并 **退出码 1**。
+
+```bash
+cd custom_nodes_config
+python3 update_custom_nodes_versions.py           # 写回 custom_nodes.json
+python3 update_custom_nodes_versions.py --dry-run  # 只看变更，不写文件
+```
+
+---
+
 ## 相关设计文档
 
 详细的系统插件架构设计请参考：[系统插件设计文档](../../../system-plugins-design.md)