filter prompt builder refmods by authored tags

This commit is contained in:
2026-10-20 16:11:50 +00:00
parent d2fe5579b3
commit bacc2db407
2 changed files with 43 additions and 4 deletions
+25 -4
View File
@@ -48,11 +48,11 @@ def _visual_refmods(mods):
return result
def _refmod_directive(refmods, start_slot):
def _refmod_directive(refmods, start_slot, slots=None):
"""Build conservative default definitions for RefMods in the prompt."""
lines = []
for offset, (mod, _strength) in enumerate(refmods):
slot = start_slot + offset
slot = slots[offset] if slots is not None else start_slot + offset
name = str(getattr(mod, "name", "visual reference") or "visual reference").strip()
lines.append(
f"@R{slot} is the {name} visual reference; preserve its identity, "
@@ -252,7 +252,28 @@ class DumasH3SequencePromptBuilder:
refmods.extend(_visual_refmods(kwargs.get(f"ref_mod_{index}")))
if len(refmods) > 9:
raise ValueError("The prompt builder supports at most nine RefMod slots.")
generated = _refmod_directive(refmods, 1)
authored_text_by_chunk = []
for clip in active_sequence["clips"]:
authored_text_by_chunk.append("\n".join([
routing_directive,
*(str(slot.get("text", "")) for slot in clip["slots"]),
f"overall_soundscape: {sound}",
f"non_diegetic_music: {music_text}",
]))
# RefMod slots are defined by socket order, but only referenced slots
# should be passed to the sampler. Keep the original @R number in the
# generated definition so a sparse use such as @R2 remains accurate.
referenced_slots = {
index for index in range(1, len(refmods) + 1)
if any(re.search(rf"@R{index}(?![A-Za-z0-9_])", text, re.IGNORECASE)
for text in authored_text_by_chunk)
}
selected_refmods = [
refmod for index, refmod in enumerate(refmods, start=1)
if index in referenced_slots
]
selected_slots = [index for index in range(1, len(refmods) + 1) if index in referenced_slots]
generated = _refmod_directive(selected_refmods, 1, selected_slots)
if generated:
directive = "\n\n".join(part for part in (directive, generated) if part)
for reference_index in range(1, 10):
@@ -293,7 +314,7 @@ class DumasH3SequencePromptBuilder:
len(active_sequence["clips"]),
float(default_chunk_seconds),
reference_bundle,
refmods,
selected_refmods,
0,
)
+18
View File
@@ -139,6 +139,24 @@ class H3NodeTests(unittest.TestCase):
finally:
sys.modules.pop(reference_module.__name__, None)
def test_only_authored_refmod_tags_are_emitted(self):
reference_module = types.ModuleType("upstream.v3.reference_images_v39")
reference_module.ReferenceImagesV39Bundle = FakeReferenceBundle
sys.modules[reference_module.__name__] = reference_module
try:
result = PROMPT.DumasH3SequencePromptBuilder().build(
2, 4, "Shared @R2 definition.", '{"clips":['
'{"slots":[{"start":0,"end":4,"text":"Use @R2."}]},'
'{"slots":[{"start":0,"end":4,"text":"No extra reference."}]}]}',
"", "", ref_mod_1=[(FakeRefMod("unused"), 1.0)],
ref_mod_2=[(FakeRefMod("used"), 1.0)],
)
self.assertEqual([mod.name for mod, _strength in result[4]], ["used"])
self.assertIn("@R2 is the used visual reference", result[0])
self.assertNotIn("unused visual reference", result[0])
finally:
sys.modules.pop(reference_module.__name__, None)
def test_per_clip_upscale_uses_connected_sigmas(self):
original = UPSCALE._native_node
original_helper = UPSCALE._continuum_helper