Files
aigc-home/docs/hel-892/frames-document-evidence/build_definition.py
T

513 lines
22 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""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,未定稿、未实跑。",
],
)