Files
aigc-home/docs/hel-892/separation-reference/contract.json
T

439 lines
12 KiB
JSON

{
"authority": "public_reference_only_not_object_info",
"serialization_stage": "restored_saved_state_before_queue_hooks",
"source_path": "example_ComfyUI_workflows/0-基础处理:图像合并-音频分离-视频截取合并-图像视频放大/视频-音频分离.json",
"source_sha256": "4861e3e33291ed962d2215b1d8cc976a4706d19719e3541e9cbb2c636683afc3",
"frontend": {
"source_declaration": null,
"selected_tag": "1.37.11",
"selected_commit": "4bf6a1960028cc5cda57d48f9fb01a74dfaade43",
"selection": "explicit reference assumption only, not inferred source/target match",
"unmodified_frontend_and_widgets_assumed": true,
"ue_serializer_match": "unknown"
},
"node_versions": {
"17": {
"type": "SaveAudioMP3",
"provider": "comfy-core",
"version": "0.3.71",
"ue_version": "7.5.2",
"source_pointer": "/nodes/0/properties",
"target_installation_match": "unknown"
},
"10": {
"type": "LoadAudio",
"provider": "comfy-core",
"version": "0.3.68",
"ue_version": "7.4.1",
"source_pointer": "/nodes/1/properties",
"target_installation_match": "unknown"
},
"20": {
"type": "PreviewAudio",
"provider": "comfy-core",
"version": "0.3.68",
"ue_version": "7.4.1",
"source_pointer": "/nodes/2/properties",
"target_installation_match": "unknown"
},
"15": {
"type": "PreviewAudio",
"provider": "comfy-core",
"version": "0.3.68",
"ue_version": "7.4.1",
"source_pointer": "/nodes/3/properties",
"target_installation_match": "unknown"
},
"19": {
"type": "PreviewAudio",
"provider": "comfy-core",
"version": "0.3.68",
"ue_version": "7.4.1",
"source_pointer": "/nodes/4/properties",
"target_installation_match": "unknown"
},
"18": {
"type": "PreviewAudio",
"provider": "comfy-core",
"version": "0.3.68",
"ue_version": "7.4.1",
"source_pointer": "/nodes/5/properties",
"target_installation_match": "unknown"
},
"11": {
"type": "AudioSeparation",
"provider": "audio-separation-nodes-comfyui",
"version": "1.4.0",
"ue_version": "7.4.1",
"source_pointer": "/nodes/6/properties",
"target_installation_match": "unknown"
}
},
"core_versions": {
"0.3.68": {
"commit": "265adad858e1f31b66cd3523a02b16f5d34ced52",
"classes": [
"LoadAudio",
"PreviewAudio"
],
"schema": "comfy_extras/nodes_audio.py",
"registrations": {
"LoadAudio": [
586,
586
],
"PreviewAudio": [
587,
587
]
},
"license": "GPL-3.0",
"exact_rule_locations": {
"SaveAudio definition": [
196,
218
],
"SaveAudioMP3 definition": [
220,
243
],
"PreviewAudio definition": [
270,
281
],
"LoadAudio definition": [
319,
349
],
"SaveAudioMP3 registration": [
584,
584
],
"LoadAudio registration": [
586,
586
],
"PreviewAudio registration": [
587,
587
],
"save_audio UI descriptors": [
187,
194
],
"MP3 codec options": [
158,
173
]
},
"definitions": {
"LoadAudio": [
319,
349
],
"PreviewAudio": [
270,
281
]
}
},
"0.3.71": {
"commit": "c55fd7481626d8bee8044ea7512ea996d13a1b90",
"classes": [
"SaveAudioMP3"
],
"license": "GPL-3.0",
"exact_rule_locations": {
"SaveAudio definition": [
196,
218
],
"SaveAudioMP3 definition": [
220,
243
],
"PreviewAudio definition": [
270,
281
],
"LoadAudio definition": [
319,
349
],
"SaveAudioMP3 registration": [
584,
584
],
"LoadAudio registration": [
586,
586
],
"PreviewAudio registration": [
587,
587
],
"save_audio UI descriptors": [
187,
194
],
"MP3 codec options": [
158,
173
]
},
"definitions": {
"SaveAudioMP3": [
220,
243
]
},
"registrations": {
"SaveAudioMP3": [
584,
584
]
}
}
},
"plugin": {
"repository": "https://github.com/christian-byrne/audio-separation-nodes-comfyui",
"reference_commit": "5291831d7c321ab7a5192374482f9848dffee75b",
"declared_version": "1.4.0",
"version_definition": "pyproject.toml:4",
"class_definition": "src/separation.py:14",
"registration": "__init__.py:11",
"registry_source_match": "selected source, registration, project metadata, publish workflow and README match 1.4.0 artifact bytes exactly; see discovery.json",
"registry_commit_binding": "unknown; API supplies no commit, source-byte agreement is not a signed release mapping",
"license": "unknown; pyproject names LICENSE but pinned tree/package contain no license file. Do not copy later MIT declaration onto 1.4.0",
"no_plugin_js_at_reference_commit": true,
"target_installation_match": "unknown"
},
"widget_layouts": {
"LoadAudio": [
"audio COMBO",
"audioUI DOM hole (serialize=false)",
"upload button (options.serialize=false)"
],
"SaveAudioMP3": [
"filename_prefix STRING",
"quality COMBO",
"audioUI nonpersisted tail DOM"
],
"PreviewAudio": [
"audioUI nonpersisted tail DOM"
],
"AudioSeparation": [
"chunk_fade_shape COMBO",
"chunk_length FLOAT",
"chunk_overlap FLOAT"
]
},
"saved_shapes": {
"LoadAudio": [
"file string",
null,
null
],
"SaveAudioMP3": [
"audio/ComfyUI",
"320k"
],
"PreviewAudio": [],
"AudioSeparation": [
"half_sine",
20,
0.2
]
},
"numeric_contract": {
"plugin_min_max": "not declared for either FLOAT",
"frontend_constructor_range": [
0,
2048
],
"range_policy": "bounded reference profile restricts finite int/float to pinned frontend default UI limits; not a server/model-valid range claim",
"restore_policy": "LGraphNode.configure assigns widget.value directly, without float callback; do not round or replace source values with defaults",
"bool_policy": "reject; Python bool is not accepted as numeric",
"source_values": {
"chunk_length": {
"value": 20,
"parsed_type": "int"
},
"chunk_overlap": {
"value": 0.2,
"parsed_type": "float"
}
},
"units_reference": "source tooltip says seconds; target meaning/effect unverified. separate_sources uses sample_rate*segment*(1+overlap) and overlap*sample_rate; do not assert alternative units, safe cross-parameter ranges, or performance"
},
"enums": {
"chunk_fade_shape": [
"linear",
"half_sine",
"logarithmic",
"exponential"
],
"quality": [
"V0",
"128k",
"320k"
]
},
"output_order": {
"types": [
"AUDIO",
"AUDIO",
"AUDIO",
"AUDIO"
],
"reference_names": [
"Bass",
"Drums",
"Other",
"Vocals"
],
"actual_return_order": [
"bass",
"drums",
"other",
"vocals"
],
"source_labels": [
"低音",
"鼓",
"其他",
"人声"
],
"source_slot_to_preview": {
"0": "18",
"1": "19",
"2": "20",
"3": "15"
},
"mp3_source": [
"10",
0
],
"mp3_is_separated_stem": false
},
"protocol": {
"PreviewAudio": "inherits SaveAudio.save_flac, temp directory/type, random prefix; save_audio returns ui.audio file descriptors",
"SaveAudioMP3": "calls save_audio(format=mp3), output type; saved quality320k overrides function default128k; no actual codec run",
"descriptor_keys": [
"filename",
"subfolder",
"type"
],
"history_chain": "save_audio ui.audio -> get_output_from_returns UI merge -> UI cache -> history_result.outputs -> PromptQueue.task_done.history",
"audioUI": "frontend DOM getter returns empty string without getValue; not a file descriptor",
"downloads": "existing ComfyUIClient.extract_outputs and /view chain, synthetic protocol fixture only; strings/URLs/paths rejected",
"production_output_registration": "unchanged; reference profile never registers or auto-trusts PreviewAudio/unknown names"
},
"reused_frontend_rules": [
{
"manifest": "../serialization-evidence/sources.json",
"file": "src/services/litegraphService.ts",
"lines": [
[
305,
406
]
],
"purpose": "required then optional input constructor order"
},
{
"manifest": "../serialization-evidence/sources.json",
"file": "src/lib/litegraph/src/LGraphNode.ts",
"lines": [
[
867,
878
],
[
914,
921
]
],
"purpose": "restore skips widget.serialize=false; persist retains original widget indices"
},
{
"manifest": "../serialization-evidence/sources.json",
"file": "src/renderer/extensions/vueNodes/widgets/composables/useFloatWidget.ts",
"lines": [
[
12,
27
],
[
59,
85
]
],
"purpose": "constructor UI defaults and callback; no save-time callback"
},
{
"manifest": "../serialization-evidence/sources.json",
"file": "src/utils/executionUtil.ts",
"lines": [
[
85,
104
]
],
"purpose": "graphToPrompt tests options.serialize, then serializeValue or value"
},
{
"manifest": "../structure-reference/sources.json",
"file": "src/extensions/core/uploadAudio.ts",
"lines": [
[
76,
110
],
[
116,
138
],
[
161,
259
]
],
"purpose": "register nodes audioUI and load upload; two different serialize markers"
},
{
"manifest": "../structure-reference/sources.json",
"file": "src/scripts/domWidget.ts",
"lines": [
[
142,
148
]
],
"purpose": "getter empty string when getValue absent"
}
],
"fail_closed": [
"wrong provider or missing/conflicting node version",
"unsupported frontend version",
"missing/extra widgets or named overrides",
"wrong scalar type/bool-as-number/nonfinite/outside frontend range",
"unknown enum/dynamic prefix",
"duplicate/missing/extra/reordered sockets, changed widget binding",
"bad links, type/slot/reciprocal records, muted/bypass or unknown nodes",
"nonempty UE link/connectability overrides or custom serializer"
],
"unknowns": [
"source frontend version; explicit selected reference not source claim",
"UE7.4.1/7.5.2 behavior and actual modifications",
"registry commit binding/license at1.4.0",
"mixed core versions installed together",
"target core/plugin/frontend versions",
"input file availability/decoding; node package/model weights existence",
"real history, encoding, quality/effect/performance",
"no supplied true API: comparison_unavailable"
],
"execution_verified": false,
"production_state_changed": false
}