@melite/models-h3 0.2.0-alpha → 0.2.2-alpha
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -16
- package/lib/actions.d.ts +10 -1
- package/lib/actions.js +343 -120
- package/lib/chainEdit.d.ts +12 -3
- package/lib/chainEdit.js +7 -3
- package/lib/extend.d.ts +8 -0
- package/lib/extend.js +53 -6
- package/lib/filmMix.d.ts +4 -2
- package/lib/filmMix.js +17 -2
- package/lib/finalize.js +6 -1
- package/lib/index.d.ts +2 -2
- package/lib/index.js +54 -29
- package/lib/mods/loras.js +15 -1
- package/lib/refine.d.ts +52 -5
- package/lib/refine.js +595 -121
- package/lib/reshoot.js +61 -14
- package/lib/schema.d.ts +10 -0
- package/lib/schema.js +81 -41
- package/lib/timelineContract.d.ts +11 -4
- package/lib/timelineContract.js +30 -9
- package/package.json +20 -9
package/lib/chainEdit.d.ts
CHANGED
|
@@ -146,9 +146,11 @@ export interface MaskedChainSeat {
|
|
|
146
146
|
readonly assemble: ChainAssembleSeat | null;
|
|
147
147
|
}
|
|
148
148
|
/** The spine's returned handles: the loop-trimmed window (the seat's
|
|
149
|
-
* file join consumes its streams)
|
|
150
|
-
*
|
|
151
|
-
*
|
|
149
|
+
* file join consumes its streams), the ChainAssemble node's video_path
|
|
150
|
+
* when the seat assembles, and the plan node's own width/height — the
|
|
151
|
+
* shot geometry every window renders at, engine-derived from the
|
|
152
|
+
* source frames (the seat-side consumer is the extend seat's raw
|
|
153
|
+
* prior join, the F34 shape-true cure). */
|
|
152
154
|
export interface ChainRender {
|
|
153
155
|
/** MiniMaxH3LoopTrim — out(0) frames, out(1) audio, out(2) the
|
|
154
156
|
* with-overlap images. */
|
|
@@ -157,6 +159,13 @@ export interface ChainRender {
|
|
|
157
159
|
};
|
|
158
160
|
/** ChainAssemble's video_path when the seat assembles; else null. */
|
|
159
161
|
readonly assemblePath: OutputHandle | null;
|
|
162
|
+
/** THE CHAIN PLAN'S SHOT GEOMETRY (the F34 cure): the plan node's
|
|
163
|
+
* width/height outputs — the canvas the chain renders, derived by
|
|
164
|
+
* the engine from the source's own frames under the stated tier. */
|
|
165
|
+
readonly planShape: {
|
|
166
|
+
width: OutputHandle;
|
|
167
|
+
height: OutputHandle;
|
|
168
|
+
};
|
|
160
169
|
}
|
|
161
170
|
|
|
162
171
|
|
package/lib/chainEdit.js
CHANGED
|
@@ -314,8 +314,9 @@ export function renderMaskedEditChain(g, seat) {
|
|
|
314
314
|
// ── the terminal: ChainAssemble when the seat assembles in-chain
|
|
315
315
|
// (the latent-seam machinery — blend_schedule 'plan' rides the
|
|
316
316
|
// policy's own overlaps); null when the seat joins by file. ──
|
|
317
|
-
if (seat.assemble === null)
|
|
318
|
-
return { trimmed, assemblePath: null };
|
|
317
|
+
if (seat.assemble === null) {
|
|
318
|
+
return { trimmed, assemblePath: null, planShape: { width: plan.out(1), height: plan.out(2) } };
|
|
319
|
+
}
|
|
319
320
|
const assemble = g.node('MiniMaxH3ChainAssemble', {
|
|
320
321
|
audio_source: seat.assemble.audioSource,
|
|
321
322
|
filename: seat.assemble.filename,
|
|
@@ -325,6 +326,9 @@ export function renderMaskedEditChain(g, seat) {
|
|
|
325
326
|
generated_audio_join: 'av_overlap',
|
|
326
327
|
manifest: loopEnd.out(0),
|
|
327
328
|
});
|
|
328
|
-
return {
|
|
329
|
+
return {
|
|
330
|
+
trimmed, assemblePath: assemble.out(0),
|
|
331
|
+
planShape: { width: plan.out(1), height: plan.out(2) },
|
|
332
|
+
};
|
|
329
333
|
}
|
|
330
334
|
//# sourceMappingURL=chainEdit.js.map
|
package/lib/extend.d.ts
CHANGED
|
@@ -1,6 +1,14 @@
|
|
|
1
1
|
import type { GraphBuilder } from '@melite/comfyui-card-kit/graph';
|
|
2
2
|
import type { H3Facts } from './actions.js';
|
|
3
3
|
export { solveWindowComposition, type WindowComposition } from './timelineContract.js';
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
export declare const LAST_FRAME_BATCH_INDEX = 16384;
|
|
4
12
|
/** The extend renderer: validates the bound entry, then composes the
|
|
5
13
|
* fresh-continuation chain plus the join. Like the swap and repair,
|
|
6
14
|
* the film path never reaches here (the card branches on a non-empty
|
package/lib/extend.js
CHANGED
|
@@ -2,6 +2,14 @@ import { chainSaveBoundaries, concatSavedFilms, filmJoinAudio } from './actions.
|
|
|
2
2
|
import { assertGridLength, solveWindowComposition, CONTEXT_OVERLAP_FRAMES, GRID_MAX_FRAMES, } from './timelineContract.js';
|
|
3
3
|
export { solveWindowComposition } from './timelineContract.js';
|
|
4
4
|
import { loadVideo, renderMaskedEditChain } from './chainEdit.js';
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
export const LAST_FRAME_BATCH_INDEX = 16384;
|
|
5
13
|
/** The extend entry's required seats (the reshoot/repair idiom: an
|
|
6
14
|
* armed doc with an empty seat refuses loud naming the seat). */
|
|
7
15
|
const REQUIRED_SEATS = [
|
|
@@ -53,10 +61,11 @@ export function renderH3Extend(entry, p, facts, g, runId) {
|
|
|
53
61
|
const clipSeconds = composition.windowFrames / 24;
|
|
54
62
|
// ── the staged media: the WHOLE prior clip on the VHS seat
|
|
55
63
|
// (force_rate 24 — the one clock) and its LAST FRAME as the
|
|
56
|
-
// in-graph anchor (
|
|
64
|
+
// in-graph anchor (a positive out-of-band index the engine clamps
|
|
65
|
+
// to the final row — see LAST_FRAME_BATCH_INDEX) ──
|
|
57
66
|
const [priorFrames, priorAudio] = loadVideo(g, str(entry, 'source_clip'));
|
|
58
67
|
const lastFrame = g.node('ImageFromBatch', {
|
|
59
|
-
image: priorFrames, batch_index:
|
|
68
|
+
image: priorFrames, batch_index: LAST_FRAME_BATCH_INDEX, length: 1,
|
|
60
69
|
}).out(0);
|
|
61
70
|
// ── THE SEAT'S OWN PLAN (clause 3): N continuation shots — the
|
|
62
71
|
// literal rules, plan_json_input stays UNWIRED (the plan node's
|
|
@@ -66,7 +75,7 @@ export function renderH3Extend(entry, p, facts, g, runId) {
|
|
|
66
75
|
id: `extend-${i + 1}`, prompt: str(entry, 'extend_prompt'),
|
|
67
76
|
}));
|
|
68
77
|
const planJson = JSON.stringify({ shots });
|
|
69
|
-
const { trimmed, assemblePath } = renderMaskedEditChain(g, {
|
|
78
|
+
const { trimmed, assemblePath, planShape } = renderMaskedEditChain(g, {
|
|
70
79
|
p, facts,
|
|
71
80
|
clipSeconds,
|
|
72
81
|
overlapFrames,
|
|
@@ -126,9 +135,47 @@ export function renderH3Extend(entry, p, facts, g, runId) {
|
|
|
126
135
|
mask_conversion: 'H3 exact (causal/token max)',
|
|
127
136
|
target_latent: edit, mask: whiteMask,
|
|
128
137
|
}).out(0);
|
|
129
|
-
|
|
138
|
+
|
|
139
|
+
// ref_image ride above is a SOFT prior — the model is free to
|
|
140
|
+
// introduce new content in the appended clip's FIRST frame, and
|
|
141
|
+
// the poncho burn did exactly that (a second figure at full
|
|
142
|
+
// size on the first extended frame: a hard pop, no entry). Pin
|
|
143
|
+
// the source's LAST frame at frame_idx 0 through the same
|
|
144
|
+
// H3-native guide lane the reshoot pins its warp with
|
|
145
|
+
// (MiniMaxH3AddGuide, one frame → guide_frames 1): the first
|
|
146
|
+
// appended frame is then FORCED to be the clip's last frame,
|
|
147
|
+
// so anything new must develop from it frame by frame instead
|
|
148
|
+
// of appearing whole.
|
|
149
|
+
const guided = g.node('MiniMaxH3AddGuide', {
|
|
150
|
+
positive: r2v.out(0),
|
|
151
|
+
vae: vaeVideo,
|
|
152
|
+
latent: target,
|
|
153
|
+
image: lastFrame,
|
|
154
|
+
frame_idx: 0,
|
|
155
|
+
}).out(0);
|
|
156
|
+
return { conditioning: guided, targetLatent: target };
|
|
130
157
|
},
|
|
131
158
|
});
|
|
159
|
+
|
|
160
|
+
// run-89976b95026b-8f22c399): the raw prior joins the chain's
|
|
161
|
+
// output at the CHAIN PLAN'S OWN SHOT GEOMETRY — the plan node
|
|
162
|
+
// derives the canvas from the SOURCE'S OWN FRAMES (its aspect)
|
|
163
|
+
// under the stated tier, so an extension whose tier short edge
|
|
164
|
+
// differs from the prior's own (the burn: a 1344×768 source under
|
|
165
|
+
// the default 736p tier rendered the extension at 1280×736 and the
|
|
166
|
+
// engine's concat refused `Expected size 768 but got size 736`)
|
|
167
|
+
// aligns HERE instead of crashing mid-render. The canvas is read
|
|
168
|
+
// off the plan's own width/height outputs — never assumed from a
|
|
169
|
+
// declared width/height row — and nearest-exact keeps the align
|
|
170
|
+
// pixel-verbatim when the plan canvas already equals the source's
|
|
171
|
+
// own (the extension never rewrites history). ──
|
|
172
|
+
const alignedPrior = g.node('ImageScale', {
|
|
173
|
+
image: priorFrames,
|
|
174
|
+
width: planShape.width,
|
|
175
|
+
height: planShape.height,
|
|
176
|
+
upscale_method: 'nearest-exact',
|
|
177
|
+
crop: 'disabled',
|
|
178
|
+
}).out(0);
|
|
132
179
|
// ── THE JOIN (the file-join primitive; the initial raw boundary
|
|
133
180
|
// is the exception the latent carry cannot cross — clause 4) ──
|
|
134
181
|
if (assemblePath !== null) {
|
|
@@ -139,7 +186,7 @@ export function renderH3Extend(entry, p, facts, g, runId) {
|
|
|
139
186
|
// saved-file path (ChainAssemble's video_path output, wired:
|
|
140
187
|
// the DAG itself proves the assembly completed before the join).
|
|
141
188
|
const priorCreated = g.node('CreateVideo', {
|
|
142
|
-
images:
|
|
189
|
+
images: alignedPrior, audio: filmJoinAudio(g, priorAudio), fps: 24, bit_depth: 8,
|
|
143
190
|
});
|
|
144
191
|
const priorSaved = g.node('SaveVideo', {
|
|
145
192
|
video: priorCreated.out(), filename_prefix: `${runId}/x0`,
|
|
@@ -162,7 +209,7 @@ export function renderH3Extend(entry, p, facts, g, runId) {
|
|
|
162
209
|
format: 'mp4', codec: 'h264',
|
|
163
210
|
}).out();
|
|
164
211
|
const priorCreated = g.node('CreateVideo', {
|
|
165
|
-
images:
|
|
212
|
+
images: alignedPrior, audio: filmJoinAudio(g, priorAudio), fps: 24, bit_depth: 8,
|
|
166
213
|
});
|
|
167
214
|
const priorSaved = g.node('SaveVideo', {
|
|
168
215
|
video: priorCreated.out(), filename_prefix: `${runId}/x0`,
|
package/lib/filmMix.d.ts
CHANGED
|
@@ -12,8 +12,10 @@ export interface FilmMixClip {
|
|
|
12
12
|
}
|
|
13
13
|
/** Parse raw audio_clips rows — the card's one law for what a clip
|
|
14
14
|
* IS: a src without a numeric start_frame refuses loud (never a
|
|
15
|
-
* silent misplacement); a row
|
|
16
|
-
*
|
|
15
|
+
* silent misplacement); a row that states anything without src
|
|
16
|
+
* refuses loud (never a silent phantom row); only the contentless
|
|
17
|
+
* row (no stated key at all) is junk and skips; the class auto law
|
|
18
|
+
* (text → dialogue, textless → music) rides here. */
|
|
17
19
|
export declare function parseFilmMixClips(rows: readonly unknown[]): FilmMixClip[];
|
|
18
20
|
/** One window's doc span + seam for the owner map. */
|
|
19
21
|
export interface FilmMixSpan {
|
package/lib/filmMix.js
CHANGED
|
@@ -20,8 +20,10 @@ import { DOC_FPS_DEFAULT, spanOverlap, spanStanzaFrames } from './timelineContra
|
|
|
20
20
|
export { spanOverlap, spanStanzaFrames } from './timelineContract.js';
|
|
21
21
|
/** Parse raw audio_clips rows — the card's one law for what a clip
|
|
22
22
|
* IS: a src without a numeric start_frame refuses loud (never a
|
|
23
|
-
* silent misplacement); a row
|
|
24
|
-
*
|
|
23
|
+
* silent misplacement); a row that states anything without src
|
|
24
|
+
* refuses loud (never a silent phantom row); only the contentless
|
|
25
|
+
* row (no stated key at all) is junk and skips; the class auto law
|
|
26
|
+
* (text → dialogue, textless → music) rides here. */
|
|
25
27
|
export function parseFilmMixClips(rows) {
|
|
26
28
|
const clips = [];
|
|
27
29
|
// THE ROW-LEVEL NUMERIC RESTORE (attempt-035's wire family, the
|
|
@@ -49,6 +51,19 @@ export function parseFilmMixClips(rows) {
|
|
|
49
51
|
if (positioned) {
|
|
50
52
|
throw new Error('audio_clips: a positioned clip row has no src — the film mix cannot place a source-less row');
|
|
51
53
|
}
|
|
54
|
+
// THE SOURCE-LESS ROW LAW (F3-06, R-P3-16): the old whitelist
|
|
55
|
+
// refused only six "positioning" keys and let every OTHER
|
|
56
|
+
// stated key take the silent `continue` — {gain: 0.5} beside a
|
|
57
|
+
// lawful film COMPOSED as a phantom no-op (the run completed,
|
|
58
|
+
// the row performed nothing, nothing said so). A row that
|
|
59
|
+
// states ANYTHING and carries no src places nothing and mixes
|
|
60
|
+
// nothing: refuse it in its own voice. The blank law stays the
|
|
61
|
+
// only tolerance — a row with NO stated key is still skippable
|
|
62
|
+
// authoring junk.
|
|
63
|
+
const stated = Object.keys(row).some((k) => row[k] !== undefined);
|
|
64
|
+
if (stated) {
|
|
65
|
+
throw new Error('audio_clips: a clip row has no src — the film mix cannot mix a source-less row; state src or drop the row');
|
|
66
|
+
}
|
|
52
67
|
continue;
|
|
53
68
|
}
|
|
54
69
|
if (typeof row.start_frame !== 'number' || !Number.isFinite(row.start_frame)) {
|
package/lib/finalize.js
CHANGED
|
@@ -17,9 +17,14 @@ export const H3_T4_STRIP = {
|
|
|
17
17
|
'attention_mode', 'blocks_to_swap', 'cache_model', 'offload_device',
|
|
18
18
|
'swap_io_components'
|
|
19
19
|
],
|
|
20
|
+
// decode_tiled is NOT stripped: the SR decode's memory law states
|
|
21
|
+
// it (a 90-frame 1080p decode OOM'd the estate card in one pass),
|
|
22
|
+
// and a strip entry would delete the law on the t4 lane — the very
|
|
23
|
+
// lane the final press derives. The sizes/overlap stay stripped:
|
|
24
|
+
// the node's own declared defaults own them.
|
|
20
25
|
SeedVR2LoadVAEModel: [
|
|
21
26
|
'cache_model', 'decode_tile_overlap', 'decode_tile_size',
|
|
22
|
-
'
|
|
27
|
+
'encode_tile_overlap', 'encode_tile_size',
|
|
23
28
|
'encode_tiled', 'offload_device', 'tile_debug'
|
|
24
29
|
],
|
|
25
30
|
SeedVR2VideoUpscaler: [
|
package/lib/index.d.ts
CHANGED
|
@@ -5,8 +5,8 @@ export declare const family: Plugin;
|
|
|
5
5
|
export { finalizeH3, H3_T4_STRIP } from "./finalize.js";
|
|
6
6
|
export { renderH3Swap } from "./swap.js";
|
|
7
7
|
export { renderH3Repair } from "./repair.js";
|
|
8
|
-
export { renderH3Extend } from "./extend.js";
|
|
9
|
-
export { refineArmed, renderH3Refine, renderH3RefineWindow, renderH3RefineWindows, refineWindowCount, refineWindowStarts, REFINE_UPSCALE_MODEL, REFINE_2X_OOM_FRAMES, REFINE_DEFAULT_CLIP_SECONDS } from "./refine.js";
|
|
8
|
+
export { renderH3Extend, LAST_FRAME_BATCH_INDEX } from "./extend.js";
|
|
9
|
+
export { refineArmed, renderH3Refine, renderH3RefineBag, renderH3RefineCarry, renderH3RefineWindow, renderH3RefineWindows, refineWindowCount, refineWindowStarts, tokenExactCarry, nextTokenExact, lawfulCarryStart, REFINE_UPSCALE_MODEL, REFINE_2X_OOM_FRAMES, REFINE_DEFAULT_CLIP_SECONDS, REFINE_DEFAULT_OVERLAP_FRAMES } from "./refine.js";
|
|
10
10
|
export { refinePlaneSchema, REFINE_PLANE_KEYS } from "./schema.js";
|
|
11
11
|
export { MAX_COMPOSED_WINDOWS, SEAM_OVERLAP_FRAMES } from "./timelineContract.js";
|
|
12
12
|
export type { RefineWindowSeat } from "./refine.js";
|
package/lib/index.js
CHANGED
|
@@ -182,11 +182,16 @@ export const DECL = {
|
|
|
182
182
|
]
|
|
183
183
|
},
|
|
184
184
|
|
|
185
|
-
//
|
|
186
|
-
//
|
|
187
|
-
//
|
|
188
|
-
//
|
|
189
|
-
//
|
|
185
|
+
// lora to the silveroxides merge" — SILVEROXIDES IS THE MERGE,
|
|
186
|
+
// LIGHTX2V IS NOT). The artifact is silveroxides' OFFICIAL
|
|
187
|
+
// `minimax_h3_fl2v_turbo_silver_dareties_comfy_pruned_v2.safetensors`
|
|
188
|
+
// (silver_official_releases/; catalog row h3_silver_dareties,
|
|
189
|
+
// labelled "Silveroxides DARE-TIES Merge", provisioned below
|
|
190
|
+
|
|
191
|
+
// experimental/ LightX2V-turbo × dareties file (row
|
|
192
|
+
// h3_lightx2v_turbo) as "the merge" — the F34b class again: a
|
|
193
|
+
// merge the catalog never held; that row stays PICK-ONLY under
|
|
194
|
+
// its honest experimental label.
|
|
190
195
|
|
|
191
196
|
|
|
192
197
|
|
|
@@ -202,33 +207,34 @@ export const DECL = {
|
|
|
202
207
|
// payload mirrors a hand pick exactly (declared keys only):
|
|
203
208
|
// SELECTION ONLY (#36). STEPS IS UNSTATED BY DESIGN — the row
|
|
204
209
|
// owns its married 8 (the marriage law: the bag resolves unstated
|
|
205
|
-
// steps, so the default run takes the
|
|
206
|
-
//
|
|
207
|
-
//
|
|
210
|
+
// steps, so the default run takes the merge's full 8-step count,
|
|
211
|
+
// the designed 6–8 band's top — the dareties settings thread);
|
|
212
|
+
// stamping steps would hard-pin what the bag resolves. The
|
|
213
|
+
// file's door is the lane gate (lane_inputs loras +
|
|
208
214
|
// the provision row below): absent on disk, the run refuses with
|
|
209
215
|
// the fetch hint — the web popup's install button and the agent
|
|
210
216
|
// seat both ride that one refusal.
|
|
211
217
|
{
|
|
212
218
|
"id": "standard",
|
|
213
219
|
"label": "Standard",
|
|
214
|
-
"hint": "The default — the
|
|
220
|
+
"hint": "The default — the Silveroxides DARE-TIES Merge at the calibrated 1344×768. Steps derive from the lora marriage (8).",
|
|
215
221
|
"group": "Recipe",
|
|
216
222
|
"wire_defaults": {
|
|
217
|
-
"loras": [{ "id": "
|
|
223
|
+
"loras": [{ "id": "h3_silver_dareties" }],
|
|
218
224
|
},
|
|
219
225
|
"cells": [],
|
|
220
226
|
},
|
|
221
227
|
// DRAFT (operator, this session: "for low resolution, that is
|
|
222
228
|
// good for the draft recipe"): the fast iteration tier — the
|
|
223
|
-
// same
|
|
229
|
+
// same merge bag at draft geometry 768×448. Steps stay
|
|
224
230
|
// unstated (the marriage law).
|
|
225
231
|
{
|
|
226
232
|
"id": "draft",
|
|
227
233
|
"label": "Draft",
|
|
228
|
-
"hint": "Fast iteration — the same merge bag at draft geometry (768×448). Steps derive from the lora marriage (8).",
|
|
234
|
+
"hint": "Fast iteration — the same Silveroxides merge bag at draft geometry (768×448). Steps derive from the lora marriage (8).",
|
|
229
235
|
"group": "Recipe",
|
|
230
236
|
"wire_defaults": {
|
|
231
|
-
"loras": [{ "id": "
|
|
237
|
+
"loras": [{ "id": "h3_silver_dareties" }],
|
|
232
238
|
"width": 768,
|
|
233
239
|
"height": 448,
|
|
234
240
|
},
|
|
@@ -247,10 +253,10 @@ export const DECL = {
|
|
|
247
253
|
{
|
|
248
254
|
"id": "final",
|
|
249
255
|
"label": "Final Cut",
|
|
250
|
-
"hint": "The finishing pass — the merge bag plus the spec's latent handoff: 2.0× 3D latent upscale with a 0.35 refine window on the un-distilled base. Pixel super-res and interpolation stay explicit picks.",
|
|
256
|
+
"hint": "The finishing pass — the Silveroxides merge bag plus the spec's latent handoff: 2.0× 3D latent upscale with a 0.35 refine window on the un-distilled base. Pixel super-res and interpolation stay explicit picks.",
|
|
251
257
|
"group": "Recipe",
|
|
252
258
|
"wire_defaults": {
|
|
253
|
-
"loras": [{ "id": "
|
|
259
|
+
"loras": [{ "id": "h3_silver_dareties" }],
|
|
254
260
|
"second_pass_enabled": true,
|
|
255
261
|
"upscale_route": "latent_2x",
|
|
256
262
|
},
|
|
@@ -286,12 +292,16 @@ export const DECL = {
|
|
|
286
292
|
|
|
287
293
|
|
|
288
294
|
|
|
289
|
-
|
|
290
|
-
//
|
|
291
|
-
//
|
|
295
|
+
|
|
296
|
+
// DEFAULT: the operator's order "switch the default lora to the
|
|
297
|
+
// silveroxides merge" — the official silver_official_releases
|
|
298
|
+
// DARE-TIES merge, not the experimental/ LightX2V file that row
|
|
299
|
+
// named): a run without the file refuses through the lane gate
|
|
300
|
+
// — the web popup's install button and the agent seat both key
|
|
301
|
+
// on that one refusal; "that is how it works".
|
|
292
302
|
// BARE NAME: the gate probes the provision row's own folder
|
|
293
303
|
// (loras/h3) as its last leg; the row below is the fetch truth.
|
|
294
|
-
"loras": "
|
|
304
|
+
"loras": "minimax_h3_fl2v_turbo_silver_dareties_comfy_pruned_v2.safetensors",
|
|
295
305
|
},
|
|
296
306
|
// THE LANE SURFACE (the z-image precedent): exactly the knobs the
|
|
297
307
|
// h3-timeline card serves — the window inputs, the shared render
|
|
@@ -301,13 +311,14 @@ export const DECL = {
|
|
|
301
311
|
// schema.ts and this surface drops it with it, else the claim law
|
|
302
312
|
// names a dead declaration the card cannot carry).
|
|
303
313
|
|
|
304
|
-
|
|
305
|
-
// contract module (one owner —
|
|
306
|
-
//
|
|
307
|
-
// the agreement). The
|
|
308
|
-
//
|
|
309
|
-
//
|
|
310
|
-
// the
|
|
314
|
+
|
|
315
|
+
// spelling, verbatim off the contract module (one owner —
|
|
316
|
+
// FAMILY_LAW IS the data deriveWindowFamily walks; the served
|
|
317
|
+
// copy cannot drift, the contract wall pins the agreement). The
|
|
318
|
+
// lanes still label the studio's family readouts; deadKeys is
|
|
319
|
+
// EMPTY since the t4r arm gained the post chain — no finish key
|
|
320
|
+
// is lane-dead, so the generic composeValidate clause admits
|
|
321
|
+
// every key on every lane.
|
|
311
322
|
"familyLaw": FAMILY_LAW,
|
|
312
323
|
|
|
313
324
|
// the round-48 sampler five): every row below either rides a graph
|
|
@@ -321,7 +332,7 @@ export const DECL = {
|
|
|
321
332
|
// sla_switch is NOT retired — the t4r arm reads it at the pick (31).
|
|
322
333
|
// attention_backend → ModelAttentionBackend (16). interp/sr → the
|
|
323
334
|
// FILM + SeedVR2 pairs behind the second-pass master (17);
|
|
324
|
-
// sharpen_* → the ImageSharpenKJ
|
|
335
|
+
// sharpen_* → the ImageSharpenKJ V3 combo wires (18 + U2 ARMs 48-50). refine_* → the
|
|
325
336
|
// rider loader/scheduler (4/4b/7). Media/refmod/duck/image_name →
|
|
326
337
|
// 19/20/22. k → the window save name (21); noise_seed → RandomNoise
|
|
327
338
|
// per stanza (2/34). STAND-DOWNS, named: fps_seconds is INTERNAL —
|
|
@@ -408,6 +419,20 @@ export const DECL = {
|
|
|
408
419
|
"sha256": "7c1f131492e7eddacaac9069a61b81bdd39de5cc96561e677c5eab1cdce5e522",
|
|
409
420
|
"size_bytes": 5207808496
|
|
410
421
|
},
|
|
422
|
+
|
|
423
|
+
// lora to the silveroxides merge" — the OFFICIAL
|
|
424
|
+
// silver_official_releases DARE-TIES merge, pruned v2; the
|
|
425
|
+
// operator named this exact file: "pruned. That one is the same
|
|
426
|
+
// and less file size"). Digest + size: downloaded and
|
|
427
|
+
// sha256-verified against the HF tree API's xet lfs oid
|
|
428
|
+
// (d90eed1d…) — the landed bytes in both trees ARE this pin.
|
|
429
|
+
{
|
|
430
|
+
"name": "minimax_h3_fl2v_turbo_silver_dareties_comfy_pruned_v2.safetensors",
|
|
431
|
+
"url": "https://huggingface.co/silveroxides/MiniMax-H3_tests/resolve/main/silver_official_releases/minimax_h3_fl2v_turbo_silver_dareties_comfy_pruned_v2.safetensors",
|
|
432
|
+
"folder": "loras/h3",
|
|
433
|
+
"sha256": "d90eed1d6b29c78851a8a9332c2581fa90cd2b10b46972a2a20e817f4180dbe9",
|
|
434
|
+
"size_bytes": 765591085
|
|
435
|
+
},
|
|
411
436
|
{
|
|
412
437
|
"name": "minimax_h3_fl2v_lightx2v_v0.1_dareties_v4_step600_comfy_fro.safetensors",
|
|
413
438
|
"url": "https://huggingface.co/silveroxides/MiniMax-H3_tests/resolve/main/minimax_h3_fl2v_lightx2v_v0.1_dareties_v4_step600_comfy_fro.safetensors",
|
|
@@ -559,8 +584,8 @@ export const family = {
|
|
|
559
584
|
export { finalizeH3, H3_T4_STRIP } from "./finalize.js";
|
|
560
585
|
export { renderH3Swap } from "./swap.js";
|
|
561
586
|
export { renderH3Repair } from "./repair.js";
|
|
562
|
-
export { renderH3Extend } from "./extend.js";
|
|
563
|
-
export { refineArmed, renderH3Refine, renderH3RefineWindow, renderH3RefineWindows, refineWindowCount, refineWindowStarts, REFINE_UPSCALE_MODEL, REFINE_2X_OOM_FRAMES, REFINE_DEFAULT_CLIP_SECONDS } from "./refine.js";
|
|
587
|
+
export { renderH3Extend, LAST_FRAME_BATCH_INDEX } from "./extend.js";
|
|
588
|
+
export { refineArmed, renderH3Refine, renderH3RefineBag, renderH3RefineCarry, renderH3RefineWindow, renderH3RefineWindows, refineWindowCount, refineWindowStarts, tokenExactCarry, nextTokenExact, lawfulCarryStart, REFINE_UPSCALE_MODEL, REFINE_2X_OOM_FRAMES, REFINE_DEFAULT_CLIP_SECONDS, REFINE_DEFAULT_OVERLAP_FRAMES } from "./refine.js";
|
|
564
589
|
export { refinePlaneSchema, REFINE_PLANE_KEYS } from "./schema.js";
|
|
565
590
|
export { MAX_COMPOSED_WINDOWS, SEAM_OVERLAP_FRAMES } from "./timelineContract.js";
|
|
566
591
|
export { H3_DEFAULT_LORA_ID, h3DefaultLoraEntry } from "./actions.js";
|
package/lib/mods/loras.js
CHANGED
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
export const inject = ['comfyui'];
|
|
2
2
|
export const H3_LORA_ROWS = [
|
|
3
|
+
|
|
4
|
+
// silveroxides merge"; file named by the operator: the pruned v2,
|
|
5
|
+
// "That one is the same and less file size"): silveroxides'
|
|
6
|
+
// OFFICIAL silver_official_releases DARE-TIES merge — the v2
|
|
7
|
+
// attention-config build (his README: the v2 layers are optimized
|
|
8
|
+
// for inference, no attention backend patcher needed). 766 MB
|
|
9
|
+
// class (765,591,085 bytes), sha256 pinned in the provisions
|
|
10
|
+
// table (src/index.ts) — the two trees' bytes verified against
|
|
11
|
+
// the HF xet lfs oid. ──
|
|
12
|
+
{ id: 'h3_silver_dareties', filename: 'h3/minimax_h3_fl2v_turbo_silver_dareties_comfy_pruned_v2.safetensors', source_url: 'https://huggingface.co/silveroxides/MiniMax-H3_tests/resolve/main/silver_official_releases/minimax_h3_fl2v_turbo_silver_dareties_comfy_pruned_v2.safetensors', label: 'Silveroxides DARE-TIES Merge', category: 'distill', default_strength: 0.8, steps: 8, steps_min: 4, steps_max: 8, shift_video: 8 },
|
|
3
13
|
// ── THE MARRIED SHIFT COLUMN (SOTA limb 2, H3_TIMELINE_RESERACH
|
|
4
14
|
|
|
5
15
|
// training contract — the 8-step LightX2V variants and every
|
|
@@ -12,7 +22,11 @@ export const H3_LORA_ROWS = [
|
|
|
12
22
|
// native/default. shift_audio is 3.0 across every source — the
|
|
13
23
|
// schema's own declared default already speaks it (no column). ──
|
|
14
24
|
{ id: 'h3_lightx2v_dareties', filename: 'h3/minimax_h3_fl2v_lightx2v_v0.1_dareties_v4_step600_comfy_fro.safetensors', source_url: 'https://huggingface.co/silveroxides/MiniMax-H3_tests/resolve/main/minimax_h3_fl2v_lightx2v_v0.1_dareties_v4_step600_comfy_fro.safetensors', label: 'LightX2V dareties v4', category: 'distill', default_strength: 0.8, steps: 4, steps_min: 4, steps_max: 4, shift_video: 6 },
|
|
15
|
-
|
|
25
|
+
|
|
26
|
+
// this is silveroxides' EXPERIMENTAL/ LightX2V-turbo × dareties
|
|
27
|
+
// file — the label names it honestly; it is NOT the official
|
|
28
|
+
// silver_dareties merge the default seat holds.
|
|
29
|
+
{ id: 'h3_lightx2v_turbo', filename: 'h3/minimax_h3_fl2v_lightx2v_turbo_4to8step_v0.1-v1.0_768p_v4_step600_dareties.safetensors', source_url: 'https://huggingface.co/silveroxides/MiniMax-H3_tests/resolve/main/experimental/minimax_h3_fl2v_lightx2v_turbo_4to8step_v0.1-v1.0_768p_v4_step600_dareties.safetensors', label: 'LightX2V Turbo × Dareties (silveroxides experimental)', category: 'distill', default_strength: 0.6, steps: 8, steps_min: 4, steps_max: 8, shift_video: 12 },
|
|
16
30
|
{ id: 'h3_turbo4_v1', filename: 'h3/minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensors', source_url: 'https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/loras/minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensors', label: 'LightX2V Turbo 4-Step v1.0 (768p)', category: 'distill', default_strength: 1, steps: 4, steps_min: 4, steps_max: 4, shift_video: 6 },
|
|
17
31
|
{ id: 'h3_turbo8_v1', filename: 'h3/minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors', source_url: 'https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/loras/minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors', label: 'LightX2V Turbo 8-Step v1.0', category: 'distill', default_strength: 1, steps: 8, steps_min: 8, steps_max: 8, shift_video: 12 },
|
|
18
32
|
{ id: 'h3_ref2v_turbo4', filename: 'h3/minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors', source_url: 'https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/loras/minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors', label: 'LightX2V Ref Turbo 4-Step v0.1', category: 'distill', default_strength: 1, steps: 4, steps_min: 4, steps_max: 4, shift_video: 12 },
|
package/lib/refine.d.ts
CHANGED
|
@@ -18,6 +18,15 @@ export declare const REFINE_2X_OOM_FRAMES = 141;
|
|
|
18
18
|
|
|
19
19
|
|
|
20
20
|
export declare const REFINE_DEFAULT_CLIP_SECONDS = 3.75;
|
|
21
|
+
/** The refine auto-tile's default carried overlap, in frames at the
|
|
22
|
+
* film clock — the film's own seam (SEAM_OVERLAP_FRAMES), which is
|
|
23
|
+
* also token-exact (5, 22, 39 …), so the default auto-tile takes the
|
|
24
|
+
* carry face: the windows chain through the film's own latent
|
|
25
|
+
* continuation across every join. Imported, never hand-typed
|
|
26
|
+
* (refine-window audit D1: the card must never carry a hand-typed
|
|
27
|
+
* copy of a measured constant — and the overlap that matches the
|
|
28
|
+
* generation seam grid is the family contract's own number). */
|
|
29
|
+
export declare const REFINE_DEFAULT_OVERLAP_FRAMES = 22;
|
|
21
30
|
/** The arm predicate: BAG PRESENCE — the same law as the
|
|
22
31
|
* replace/repair/extend/reshoot arms (a commission is armed when
|
|
23
32
|
* its bag is a NON-EMPTY ARRAY). Absent or empty bag = the compose
|
|
@@ -38,9 +47,17 @@ export interface RefineWindowSeat {
|
|
|
38
47
|
/** this window's SaveVideo prefix (the run tree's own spelling) */
|
|
39
48
|
prefix: string;
|
|
40
49
|
}
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
50
|
+
/** THE FAMILY PLANE, the five seats every refine window rides: the
|
|
51
|
+
* film's own masked-edit plane (one unet stack with the lora bag,
|
|
52
|
+
* one clip, the two VAEs). The carry face composes it ONCE for the
|
|
53
|
+
* whole film; a standalone window builds its own. */
|
|
54
|
+
export interface RefinePlane {
|
|
55
|
+
readonly sigmaModel: OutputHandle;
|
|
56
|
+
readonly samplerSel: OutputHandle;
|
|
57
|
+
readonly clip: OutputHandle;
|
|
58
|
+
readonly vaeVideo: OutputHandle;
|
|
59
|
+
readonly vaeAudio: OutputHandle;
|
|
60
|
+
}
|
|
44
61
|
|
|
45
62
|
|
|
46
63
|
|
|
@@ -66,8 +83,13 @@ export declare function renderH3RefineWindow(entry: Record<string, unknown>, p:
|
|
|
66
83
|
* — the family plane this refine renders under)
|
|
67
84
|
* @param facts the family's lane facts (unet off the DECL row)
|
|
68
85
|
* @param g the run's graph builder
|
|
69
|
-
* @param runId the run tree's id (the refine filename rides it)
|
|
70
|
-
|
|
86
|
+
* @param runId the run tree's id (the refine filename rides it)
|
|
87
|
+
* @returns the window's SaveVideo passthrough (the bag carrier's
|
|
88
|
+
* N=1 delegate returns the same handle; statement callers ignore it) */
|
|
89
|
+
export declare function renderH3Refine(entry: Record<string, unknown>, p: Record<string, unknown>, facts: H3Facts, g: GraphBuilder, runId: string): OutputHandle;
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
|
|
71
93
|
|
|
72
94
|
|
|
73
95
|
|
|
@@ -79,6 +101,31 @@ export declare function renderH3Refine(entry: Record<string, unknown>, p: Record
|
|
|
79
101
|
|
|
80
102
|
|
|
81
103
|
|
|
104
|
+
export declare const tokenExactCarry: (frames: number) => boolean;
|
|
105
|
+
/** The next token-exact carry at or above a measured span — the rung
|
|
106
|
+
* a refusal names so the fix is a stated number, not a search.
|
|
107
|
+
* @param frames the measured carry in frames
|
|
108
|
+
* @returns the smallest token-exact carry ≥ `frames` */
|
|
109
|
+
export declare const nextTokenExact: (frames: number) => number;
|
|
110
|
+
/** The most truthful start for the next window: the film's own 22 f
|
|
111
|
+
* seam when the previous window can hold it, else the largest
|
|
112
|
+
* token-exact carry the window can still advance from. The refusal
|
|
113
|
+
* names this frame, so the fix is one edited Start seconds.
|
|
114
|
+
* @param prev the previous window's origin (cap + skip at the film clock)
|
|
115
|
+
* @returns the next window's start frame, or null when the window is
|
|
116
|
+
* too short for any carried join */
|
|
117
|
+
export declare const lawfulCarryStart: (prev: {
|
|
118
|
+
cap: number;
|
|
119
|
+
skip: number;
|
|
120
|
+
}) => number | null;
|
|
121
|
+
export declare function renderH3RefineCarry(entries: ReadonlyArray<Record<string, unknown>>, p: Record<string, unknown>, facts: H3Facts, g: GraphBuilder, windows: ReadonlyArray<{
|
|
122
|
+
cap: number;
|
|
123
|
+
skip: number;
|
|
124
|
+
}>, carries: readonly number[], runId: string): OutputHandle;
|
|
125
|
+
export declare function renderH3RefineBag(bag: Array<Record<string, unknown>>, p: Record<string, unknown>, facts: H3Facts, g: GraphBuilder, runId: string): OutputHandle;
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
|
|
82
129
|
|
|
83
130
|
|
|
84
131
|
|