513 lines
22 KiB
Python
513 lines
22 KiB
Python
"""One editorial definition with per-node exact versions. No execution contract."""
|
||
|
||
from __future__ import annotations
|
||
|
||
import hashlib
|
||
import json
|
||
from pathlib import Path
|
||
|
||
REPO = Path(__file__).resolve().parents[3]
|
||
OUT = Path(__file__).resolve().parent
|
||
PATHS = [
|
||
"example_ComfyUI_workflows/0-基础处理:图像合并-音频分离-视频截取合并-图像视频放大/截取视频每一帧.json"
|
||
]
|
||
|
||
|
||
def canonical(value):
|
||
return json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":")).encode()
|
||
|
||
|
||
def build(index=0):
|
||
path = PATHS[index]
|
||
raw = (REPO / path).read_bytes()
|
||
graph = json.loads(raw)
|
||
entries = json.loads((OUT.parent / "frames-reference/sources.json").read_bytes())["sources"]
|
||
refs = []
|
||
|
||
def ref(key, file, first, last, claim):
|
||
e = next(e for e in entries if e["id"] == key and e["file"] == file)
|
||
data = (OUT.parent / "frames-reference" / e["local_file"]).read_bytes()
|
||
assert hashlib.sha256(data).hexdigest() == e["sha256"]
|
||
assert 1 <= first <= last <= len(data.decode().splitlines())
|
||
refs.append(
|
||
{
|
||
**e,
|
||
"local_file": "../frames-reference/" + e["local_file"],
|
||
"lines": [first, last],
|
||
"claim": claim,
|
||
}
|
||
)
|
||
return len(refs) - 1
|
||
|
||
load = ref(
|
||
"vhs177",
|
||
"videohelpersuite/load_video_nodes.py",
|
||
22,
|
||
168,
|
||
"VHS1.7.7 LTXV格式、32对齐、采样、跳过、上限",
|
||
)
|
||
run = ref(
|
||
"vhs177",
|
||
"videohelpersuite/load_video_nodes.py",
|
||
293,
|
||
420,
|
||
"VHS1.7.7尺寸/内存/8n+1帧数裁切、音频起点与时长",
|
||
)
|
||
schema = ref(
|
||
"vhs177",
|
||
"videohelpersuite/load_video_nodes.py",
|
||
423,
|
||
477,
|
||
"VHS1.7.7上传加载schema与四输出槽",
|
||
)
|
||
utils = ref("vhs177", "videohelpersuite/utils.py", 19, 56, "BIGMAX、DIMMAX与floatOrInt")
|
||
lreg = ref("vhs177", "videohelpersuite/nodes.py", 1020, 1050, "VHS1.7.7准确加载注册")
|
||
ljs = ref("vhs177", "web/js/VHS.core.js", 41, 168, "VHS1.7.7保存恢复回调,不证明未知宿主次序")
|
||
lp = ref(
|
||
"vhs177", "web/js/VHS.core.js", 915, 970, "VHS1.7.7包内预览状态回调;历史对象非运行证明"
|
||
)
|
||
combine = ref(
|
||
"vhs179", "videohelpersuite/nodes.py", 235, 420, "VHS1.7.9合成schema、目录、独立首帧PNG"
|
||
)
|
||
video = ref(
|
||
"vhs179", "videohelpersuite/nodes.py", 420, 625, "VHS1.7.9视频编码、音频混流与中间文件条件"
|
||
)
|
||
template = ref(
|
||
"vhs179", "videohelpersuite/nodes.py", 48, 165, "VHS1.7.9格式模板、str(False)与元数据条件"
|
||
)
|
||
fmt = ref("vhs179", "video_formats/h264-mp4.json", 1, 15, "VHS1.7.9 H264像素/CRF/音频模板")
|
||
cjs = ref("vhs179", "web/js/VHS.core.js", 915, 970, "VHS1.7.9合成预览保存回调")
|
||
dyn = ref(
|
||
"vhs179", "web/js/VHS.core.js", 1222, 1282, "VHS1.7.9格式改变重建控件;未知宿主恢复不保证"
|
||
)
|
||
creg = ref("vhs179", "videohelpersuite/nodes.py", 1023, 1050, "VHS1.7.9准确合成注册")
|
||
batch = ref(
|
||
"kj",
|
||
"nodes/image_nodes.py",
|
||
2391,
|
||
2447,
|
||
"精确ImageBatchMulti:按输入顺序沿批次合成,双线性尺寸匹配与缺输入分支",
|
||
)
|
||
bjs = ref(
|
||
"kj",
|
||
"web/js/jsnodes.js",
|
||
36,
|
||
66,
|
||
"精确KJ Update inputs按钮;null槽仅按钮候选,宿主恢复未知",
|
||
)
|
||
breg = ref("kj", "__init__.py", 1, 100, "精确KJ ImageBatchMulti注册")
|
||
p16 = ref("core16", "nodes.py", 1629, 1700, "core0.16.3 PreviewImage继承临时PNG与UI输出链")
|
||
r16 = ref("core16", "nodes.py", 2045, 2055, "core0.16.3准确PreviewImage注册")
|
||
p03 = ref("core03", "nodes.py", 1561, 1629, "core0.3.71 PreviewImage继承临时PNG与UI输出链")
|
||
r03 = ref("core03", "nodes.py", 1960, 1970, "core0.3.71准确PreviewImage注册")
|
||
for key in ["vhs177", "vhs179", "kj", "core16", "core03"]:
|
||
e = next(e for e in entries if e["id"] == key and e["file"] == "LICENSE")
|
||
ref(
|
||
key,
|
||
"LICENSE",
|
||
1,
|
||
len((OUT.parent / "frames-reference" / e["local_file"]).read_text().splitlines()),
|
||
"准确版本许可原文",
|
||
)
|
||
|
||
# Each tuple is label, schema type/default, unit/range, source-derived effect.
|
||
load_specs = {
|
||
"video": (
|
||
"视频文件引用",
|
||
"COMBO",
|
||
"动态input目录枚举,无固定默认",
|
||
"文件引用",
|
||
"普通文件webm/mp4/mkv/gif/mov;目标枚举未知",
|
||
"保存素材引用,不证明存在、上传完成或有音轨。",
|
||
),
|
||
"force_rate": (
|
||
"加载采样帧率",
|
||
"floatOrInt",
|
||
"0",
|
||
"帧/秒",
|
||
"0~60,step1;0关闭强制采样",
|
||
"保存25表示按1/25秒采样;不是原片FPS,也不保证读取全部原始帧。",
|
||
),
|
||
"custom_width": (
|
||
"自定义宽度",
|
||
"INT",
|
||
"0",
|
||
"像素",
|
||
"0~8192;0按原尺寸或另一维比例",
|
||
"保存832;LTXV无VAE时按32对齐,832满足对齐。两维非零会指定目标尺寸,不保证素材读取成功或实际产物。",
|
||
),
|
||
"custom_height": (
|
||
"自定义高度",
|
||
"INT",
|
||
"0",
|
||
"像素",
|
||
"0~8192;0按原尺寸或另一维比例",
|
||
"保存480;LTXV无VAE时按32对齐,480满足对齐。两维非零不承诺保持原片宽高比;动态环境/实际尺寸待核。",
|
||
),
|
||
"frame_load_cap": (
|
||
"帧数读取上限",
|
||
"INT",
|
||
"0",
|
||
"帧",
|
||
"0~9007199254740991,step1;0不设此上限",
|
||
"节点1保存505,节点10保存1;上限不等于产物帧数。短素材、内存限制或失败会影响结果。LTXV帧数按8n+1截短;505与1本身均满足,但不是保证。",
|
||
),
|
||
"skip_first_frames": (
|
||
"跳过起始采样帧",
|
||
"INT",
|
||
"0",
|
||
"采样帧",
|
||
"0~9007199254740991,step1",
|
||
"保存0;在强制采样时间轴上跳过。音频起点为skip_first_frames×target_frame_time,本图条件为0秒,未读取音轨。",
|
||
),
|
||
"select_every_nth": (
|
||
"抽帧间隔",
|
||
"INT",
|
||
"1",
|
||
"采样帧间隔",
|
||
"1~9007199254740991,step1",
|
||
"保存1表示采样后不再间隔抽帧;loaded_fps按采样帧时间乘此值计算,不代表原片FPS。",
|
||
),
|
||
"format": (
|
||
"加载格式约束",
|
||
"COMBO",
|
||
"AnimateDiff",
|
||
"格式选择",
|
||
"本版LTXV:target_rate24、dim(32,0,768,512)、frames(8,1);外部动态扩展未知",
|
||
(
|
||
"保存LTXV是加载尺寸/帧数约束,不是合成编码格式或模型节点。target_rate24为"
|
||
"格式提示,服务端加载不据此覆盖force25;本图meta_batch/vae均未接,不证"
|
||
"明需要LTX模型。"
|
||
),
|
||
),
|
||
"videopreview": (
|
||
"历史加载预览对象",
|
||
"前端嵌套对象",
|
||
"无服务端默认",
|
||
"历史状态",
|
||
"整对象保留,不递归增保存位置",
|
||
"含hidden/paused/params与旧文件名、25fps及尺寸等缓存;不请求api/view/媒体,不当作实际产物、原片帧率或已上传证明。",
|
||
),
|
||
}
|
||
combine_specs = {
|
||
"frame_rate": (
|
||
"合成播放帧率",
|
||
"floatOrInt",
|
||
"8",
|
||
"帧/秒",
|
||
"min1,step1;schema未设max",
|
||
"保存25且无外线覆盖;按合成批次帧数/25形成视频时间轴。若头部加入另一素材帧,不能称时长不变或自动同步。",
|
||
),
|
||
"loop_count": (
|
||
"附加循环次数",
|
||
"INT",
|
||
"0",
|
||
"次",
|
||
"0~100,step1",
|
||
"保存0;视频分支不添加额外循环,不代表GIF循环语义。",
|
||
),
|
||
"filename_prefix": (
|
||
"文件名前缀",
|
||
"STRING",
|
||
"AnimateDiff",
|
||
"路径/前缀",
|
||
"目录和权限由目标环境决定",
|
||
"保存video/Comfyui用于生成文件名前缀,不是固定产物文件名;不访问路径。",
|
||
),
|
||
"format": (
|
||
"合成编码格式",
|
||
"COMBO",
|
||
"schema动态格式列表;函数回退image/gif",
|
||
"格式选择",
|
||
"动态ffmpeg格式;本图video/h264-mp4",
|
||
"保存H264 MP4,准确1.7.9模板使用libx264与AAC音频条件;实际编码器和动态选项未知。",
|
||
),
|
||
"pix_fmt": (
|
||
"像素格式",
|
||
"COMBO",
|
||
"yuv420p(模板首项)",
|
||
"像素格式",
|
||
"yuv420p或yuv420p10le",
|
||
"保存yuv420p;编码前可能按格式dim_alignment补边,实际编码能力未知。",
|
||
),
|
||
"crf": (
|
||
"恒定质量因子",
|
||
"INT",
|
||
"19",
|
||
"CRF",
|
||
"0~100,step1",
|
||
"保存19传给libx264 -crf;一般较小值质量更高、文件更大,不保证码率/大小或编码成功。",
|
||
),
|
||
"save_metadata": (
|
||
"保存元数据",
|
||
"BOOLEAN",
|
||
"true",
|
||
"开关",
|
||
"true/false;prompt/extra_pnginfo与环境开关有条件",
|
||
"保存true;格式模板控制视频元数据写入,独立首帧PNG还受VHS_MetadataImage条件控制,不能把此开关当全部图片保存开关。",
|
||
),
|
||
"trim_to_audio": (
|
||
"音频裁切策略",
|
||
"BOOLEAN",
|
||
"false",
|
||
"开关",
|
||
"有效audio及waveform存在才进入混流",
|
||
(
|
||
"保存false并不关闭音频。本版模板str(False)触发apad=whole_dur("
|
||
"总帧数/合成帧率+1)并带-shortest;不保证声音与前插帧自动同步或素材有声。"
|
||
),
|
||
),
|
||
"pingpong": (
|
||
"往返追加",
|
||
"BOOLEAN",
|
||
"false",
|
||
"开关",
|
||
"true/false",
|
||
"保存false不追加逆序中间帧,不改变原批次顺序。",
|
||
),
|
||
"save_output": (
|
||
"保存正式输出",
|
||
"BOOLEAN",
|
||
"true",
|
||
"开关",
|
||
"true取output;false取temp,权限未知",
|
||
(
|
||
"保存true选择正式输出目录;不等于已生成。可能有独立首帧PNG、无声视频及混流文件,中间"
|
||
"保留依VHS_KeepIntermediate条件;VHS_FILENAMES输出未接,不"
|
||
"新增出口。"
|
||
),
|
||
),
|
||
"videopreview": (
|
||
"历史合成预览对象",
|
||
"前端嵌套对象",
|
||
"无服务端默认",
|
||
"历史状态",
|
||
"整对象保留,不递归增保存位置",
|
||
(
|
||
"含旧E盘fullpath、workflow PNG、audio文"
|
||
# 分段保持原文,不插入换行。
|
||
"件名和缓存25fps,仅纯文本;不访问api/view/文件,不证明混流成功或当前产物。"
|
||
),
|
||
),
|
||
}
|
||
fields = []
|
||
for i, n in enumerate(graph["nodes"]):
|
||
values = n["widgets_values"]
|
||
for key, value in values.items() if isinstance(values, dict) else enumerate(values):
|
||
name = key if isinstance(values, dict) else ["inputcount", "saved_position_1"][key]
|
||
role = "scalar"
|
||
if n["type"] == "VHS_LoadVideo":
|
||
spec = load_specs[name]
|
||
ev = [load, run, schema, utils, lreg, ljs]
|
||
if name == "videopreview":
|
||
ev = [lp, ljs]
|
||
role = "frontend_history"
|
||
elif n["type"] == "VHS_VideoCombine":
|
||
spec = combine_specs[name]
|
||
ev = [combine, video, template, fmt, creg, dyn]
|
||
if name == "videopreview":
|
||
ev = [cjs]
|
||
role = "frontend_history"
|
||
elif name == "inputcount":
|
||
spec = (
|
||
"批次输入数量",
|
||
"INT",
|
||
"2",
|
||
"路",
|
||
"2~1000,step1",
|
||
(
|
||
"保存2;先完整image_1(视频10),再完整image_2(视频1),沿批次维合成,不"
|
||
"是上下/左右空间拼接。后输入尺寸不同按第一输入宽高bilinear/center匹配,通道"
|
||
"不足补1。缺键输入按首批帧数补零图;显式None不保证可用。不是短批重复末帧。"
|
||
),
|
||
)
|
||
ev = [batch, breg, bjs]
|
||
else:
|
||
spec = (
|
||
"保存位置1(按钮候选,未确认)",
|
||
"null/前端状态",
|
||
"无服务端参数默认",
|
||
"无",
|
||
"源数组[2,null];未知宿主/frontendVersion",
|
||
(
|
||
"本版KJ JS创建Update inputs按钮且值为null;"
|
||
# 分段保持原文,不插入换行。
|
||
"该槽仅按钮候选,缺宿主序列化/恢复和UE次序证据,不能作为服务端参数或执行标量。"
|
||
),
|
||
)
|
||
ev = [bjs, batch]
|
||
role = "frontend_state_unknown"
|
||
label, typ, default, unit, limits, effect = spec
|
||
fields.append(
|
||
dict(
|
||
field=name,
|
||
label=label,
|
||
type=typ,
|
||
schema_default=default,
|
||
unit=unit,
|
||
limits=limits,
|
||
effect=effect,
|
||
evidence=ev,
|
||
role=role,
|
||
node_id=str(n["id"]),
|
||
definition_node_id=str(n["id"]),
|
||
class_type=n["type"],
|
||
scope="root",
|
||
pointer=f"/nodes/{i}/widgets_values/{key}",
|
||
value=value,
|
||
json_type=type(value).__name__,
|
||
execution_note=(
|
||
f"源mode={n['mode']};"
|
||
+ (
|
||
"声明版本逐节点分列;无frontendVersion,UE 7.5.1字段/空映射不证明身"
|
||
"份或无影响,宿主恢复次序和动态选项未知;保存值不是最终prompt或运行证明。"
|
||
)
|
||
),
|
||
)
|
||
)
|
||
assert len(fields) == 31
|
||
overview = (
|
||
"这张图读取两路视频,把视频10的起始采样帧批次放在视频1帧批次前,再合成为25帧/秒的视频"
|
||
";不是把每帧永久另存成单图。视频10上限1、视频1上限505都不是保证帧数。Preview"
|
||
"11只接视频10,Preview8处于mode4;图内没有SaveImage。音频另从视频"
|
||
"1接入,前插帧不保证音画自动同步。三份预览只是历史缓存;未实跑、环境未知、转换保持关闭。"
|
||
)
|
||
flow = [
|
||
overview,
|
||
(
|
||
"视频1/10都保存force25、832×480、skip0、nth1和LTXV,但素材不"
|
||
"同、帧上限分别505/1。按1.7.7采样/内存/尺寸与8n+1裁切条件解释;25不是原片"
|
||
"FPS,832×480与505/1不是实际产物保证。无模型节点,不编模型依赖。"
|
||
),
|
||
(
|
||
"KJ ImageBatchMulti13按精确a9ab19d2实现:image_1来自10"
|
||
"、image_2来自1,沿批次维依次合成;不空间拼接、不按时刻交错、不重复短批末帧。后输入"
|
||
"尺寸不符按第一输入bilinear/center匹配,通道补1;缺键输入补首批长度的零图,"
|
||
"显式None未获保证。"
|
||
),
|
||
(
|
||
"数组[2,null]的2是inputcount;null仅与本版Update inputs"
|
||
"按钮相符的候选。无frontendVersion,不能确证宿主恢复/UE身份或次序,不作服"
|
||
"务端参数。"
|
||
),
|
||
"Combine9帧率保存25且无外线,音频从1槽2来,图像从13来;若视频10前插一帧,画面时间轴增加约1/25秒的条件不等于音频自动后移。源素材有声、时长和实际混流成功均未知。",
|
||
(
|
||
"VHS1.7.7音频起点为skip×target_frame_time,本图0;时长参数为"
|
||
"cap×抽帧后frame_time,条件值1为505/25秒、10为1/25秒,但10音频"
|
||
"槽未接。参数不是已读音频长度或实际视频时长。"
|
||
),
|
||
(
|
||
"VHS1.7.9合成H264 MP4/yuv420p/crf19、loop0、pingpo"
|
||
"ng=false、save_output=true、save_metadata=true。"
|
||
"正式output与temp、独立首帧PNG、视频元数据分别受条件控制;有效waveform"
|
||
"才混流,trim_to_audio=false触发apad/-shortest条件,不保证"
|
||
"同步。"
|
||
),
|
||
(
|
||
"Preview11 core0.16.3为mode0,只接10槽0;Preview8 co"
|
||
"re0.3.71为mode4旁路,只接1槽0。两者widgets_values=[]均零位"
|
||
"置,准确各版Preview继承SaveImage循环保存批次到temp PNG并返回UI "
|
||
"images,RETURN_TYPES为空;不是正式逐帧SaveImage导出。未知宿主旁"
|
||
"路/恢复行为不能由服务端源码补证。"
|
||
),
|
||
(
|
||
"1/10加载、9合成的meta_batch/vae均未接;1和10帧计数/视频信息未接,1"
|
||
"0音频未接,9 VHS_FILENAMES未接。不构造新prompt、不新增输出映射或执行"
|
||
"出口。"
|
||
),
|
||
(
|
||
"三个videopreview原嵌套对象完整保留,包括历史E盘路径、缓存25fps、work"
|
||
"flow PNG;只纯文本回读,不递归计数,不访问api/view、媒体或文件。目标安装、"
|
||
"素材、目录权限、编码器、动态选项和真实效果未知。"
|
||
),
|
||
(
|
||
"源无frontendVersion;包JS和节点JS只证明自身代码,UE属性中7.5.1不"
|
||
"是身份或次序的完整证据;空映射也不等于无影响。VHS两个版本Git绑定分别未知,不混成同版"
|
||
"本。"
|
||
),
|
||
]
|
||
flow += ["源物理边:" + json.dumps(e, ensure_ascii=False) for e in graph["links"]]
|
||
flow += [
|
||
f"节点{n['id']} {n['type']} mode={n['mode']};"
|
||
f"保存位置={len(n['widgets_values'])};原properties="
|
||
+ json.dumps(n["properties"], ensure_ascii=False)
|
||
for n in graph["nodes"]
|
||
]
|
||
versions = [
|
||
(
|
||
"加载1/10声明VHS1.7.7,复用官方准确包f845b43edc8342439c428"
|
||
"09524669f8aceecfb9eca946d660e351364d341d9b1;G"
|
||
"it绑定未知。"
|
||
),
|
||
(
|
||
"合成9声明VHS1.7.9,复用官方准确包ac63991d8b237afe5b2cd2b2"
|
||
"87a14b4a4d40ff203c0f2ee9d5fe61059f57cdf8;Git绑"
|
||
"定未知,不能套加载版本。"
|
||
),
|
||
(
|
||
"ImageBatchMulti13声明KJ a9ab19d2a7933e03f72bc00"
|
||
"103863f06b9483300,固定准确注册/schema/实现/JS/许可,不套Im"
|
||
"ageConcatMulti或近版。"
|
||
),
|
||
(
|
||
"Preview11声明core0.16.3,准确tag v0.16.3→1c2182823"
|
||
"69a6cc80651d878fc51fa33d7bf34e2;Preview8声明cor"
|
||
"e0.3.71,tag v0.3.71→c55fd7481626d8bee8044ea75"
|
||
"12ea996d13a1b90;注册/继承/许可分别固定。"
|
||
),
|
||
"无frontendVersion,宿主恢复、UE身份/次序和目标安装未知;固定源码不等于目标可执行或运行证明。",
|
||
]
|
||
return dict(
|
||
source_path=path,
|
||
source_sha1=hashlib.sha1(raw).hexdigest(),
|
||
source_sha256=hashlib.sha256(raw).hexdigest(),
|
||
canonical_sha256=hashlib.sha256(canonical(graph)).hexdigest(),
|
||
notice="固定版本仅作参考;没有逐帧永久单图导出,旁路/采样/音画同步有限制,未实跑、环境未知、转换保持关闭。",
|
||
user_overview=overview,
|
||
versions=versions,
|
||
counts=dict(
|
||
saved_fields=31,
|
||
scalar_saved_positions=28,
|
||
history_objects=3,
|
||
source_nodes=6,
|
||
physical_edges=6,
|
||
source_notes=0,
|
||
linked_saved_fields=0,
|
||
frontend_only=4,
|
||
final_scalars=0,
|
||
final_prompt_constructed=False,
|
||
),
|
||
fields=fields,
|
||
sources=refs,
|
||
comments=[],
|
||
flow=flow,
|
||
flow_evidence=list(range(len(refs))),
|
||
zero_saved_nodes=[
|
||
dict(
|
||
node_id="11",
|
||
class_type="PreviewImage",
|
||
evidence=[p16, r16],
|
||
effect="原[]零位置;mode0,只接视频10;core0.16.3临时PNG/UI继承链,非正式逐帧导出。",
|
||
),
|
||
dict(
|
||
node_id="8",
|
||
class_type="PreviewImage",
|
||
evidence=[p03, r03],
|
||
effect="原[]零位置;mode4旁路,只接视频1;core0.3.71临时PNG/UI继承链,未运行。",
|
||
),
|
||
],
|
||
steps=[
|
||
overview,
|
||
"素材要求:两路可读取视频,10用作前插采样帧、1为主帧批次与音频来源;这里只显示引用,不读取/上传素材,无模型节点。",
|
||
"操作1:先逐节点核VHS1.7.7加载、1.7.9合成、精确KJ与两core版本及素材;保持停用。",
|
||
"操作2:核25采样、LTXV尺寸/帧数约束与上限1/505;不要把文件名当作逐帧永久导出承诺。",
|
||
"操作3:核10→13.image_1、1→13.image_2、13→9与1→9.audio;前插图像不会自动移动音频,Preview11只看10,Preview8旁路。",
|
||
"常见问题:帧数少可能来自上限/8n+1截短/短素材,尺寸变化看LTXV32对齐与批次尺寸匹配;只看到一帧预览不代表主视频只一帧。",
|
||
(
|
||
"常见问题:没有永久单图是因为图中没有SaveImage;历史PNG/视频路径不证明当前输出"
|
||
"。声音错位要核前插帧与主素材音轨,不把trim_to_audio=false当静音或同步。"
|
||
),
|
||
"实际输出、目录权限、动态选项、环境与真实效果待获准验证;本轮未执行插件或媒体、未构造prompt,未定稿、未实跑。",
|
||
],
|
||
)
|