Node packVerifiedExternal

ComfyUI-VideoActorExtract

ComfyUI Video Actor Extract

Sourcegithub.com/ahkimkoo/ComfyUI-VideoActorExtract

Maintainer@ahkimkooCgrade

Package profile

Status: Verified
Publisher: @ahkimkoo
Source: GitHub

README

ComfyUI-VideoActorExtract

从视频中自动检测、追踪、识别所有出场人物，输出每个人物的绿幕抠图视频和出镜元数据。

核心能力：

逐帧人物分割（YOLOv8-seg）
质心距离多目标追踪（MaskTracker）
基于人脸识别的身份聚类（InsightFace），支持跨时段合并 + 共现互斥
多种抠像背景可选（绿、蓝、黑、白），默认绿色
多段出场自动合并为单个视频

Sources

3 sources

GitHubPrimary

github.com/ahkimkoo/ComfyUI-VideoActorExtract

Verified Aug 6

GitHubSourceVersion 4912be31f39ef6baf18a124e71fb0f2251f599bb

github.com/ahkimkoo/ComfyUI-VideoActorExtract

Source excerpts

1 excerpt

NoteJul 16github.com/ahkimkoo/ComfyUI-VideoActorExtract

Source context: Repo ahkimkoo/ComfyUI-VideoActorExtract

┌─────────────────────────────────────────────────────────────────────┐ │ VideoActorExtractor Node │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ IMAGE batch (VHS LoadVideo) │ │ │ │ │ ▼ │ │ ┌──────────────┐ │ │ │ PersonSegmenter │ YOLOv8-seg, 逐帧人物分割 │ │ │ (每帧检测) │ 输出: [(detection_idx, bool_mask), ...] │ │ └──────┬───────┘ │ │ │ │ │ ▼ │ │ ┌──────────────┐ │ │ │ MaskTracker │ 质心距离追踪, 帧间关联 │ │ │ (帧间追踪) │ 输出: {actor_id: [(frame_idx, bool_mask, area)]} │ │ └──────┬───────┘ │ │ │ │ │ ▼ │ │ ┌──────────────┐ │ │ │ IdentityCluster│ InsightFace 人脸特征 + 贪心聚类 │ │ │ (身份合并) │ 约束: 共现互斥 + 跨时段合并 │ │ └──────┬───────┘ │ │ │ │ │ ▼ │ │ ┌──────────────┐ │ │ │ SegmentBuilder │ 连续段构建, 小间隙插值 │ │ │ (段构建) │ 输出: {actor_id: [segment_frames, ...]} │ │ └──────┬───────┘ │ │ │ │ │ ▼ │ │ ┌──────────────┐ │ │ │ Merger │ cv2.VideoWriter 编码 + JSON 生成 │ │ │ (视频输出) │ 输出: actor_X.mp4 + actor_info.json │ │ └──────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘

模块	文件	功能
PersonSegmenter	`pipeline/segmenter.py`	YOLOv8-seg 人物分割，输出像素级掩码
MaskTracker	`pipeline/mask_tracker.py`	质心距离追踪，将同一人的连续帧关联为 track
IdentityCluster	`pipeline/identity.py`	InsightFace 人脸识别 + 贪心聚类，合并同一个人
SegmentBuilder	`nodes/actor_extractor.py`	连续段构建，小间隙帧插值
Merger	`pipeline/merger.py`	视频编码 + JSON 元数据生成
VideoActorExtractor	`nodes/actor_extractor.py`	ComfyUI 主节点，编排整个管线

ComfyUI-VideoActorExtract

ComfyUI-VideoActorExtract

功能说明

它能做什么

典型使用场景

架构说明

处理管线

模块说明

身份聚类算法