Agentic Video Editing

Primitive-First Boundary

ScreenKite mantiene l'editing agentico semplice: l'app espone primitive di editing deterministiche, e l'agent gestisce la pianificazione, il ragionamento sulla trascrizione e le politiche editoriali.

Questo confine è fondamentale. ScreenKite deve rispondere a domande come "qual è il layout attuale?", "taglia questo intervallo" o "applica questo layout scena da 12.5s a 17.0s". L'agent dovrebbe decidere quali sono i punti chiave, dove inserire un taglio, se un inserto visivo è utile e quando smettere di iterare.

Start With Facts

Usa queste letture come base:

• getProjectState(scope: "summary") come indice rapido per tempistiche, tracce e lo stato complessivo del progetto
• getProjectState(scope: "layout") come unica fonte di verità per la composizione delle scene
• getProjectResources() per confermare quali media esistono realmente
• exportTranscript(...) quando le tempistiche del parlato o i tagli sui confini delle parole sono cruciali

Quando la trascrizione include nomi di prodotti inglesi, API o altri nomi propri, rileggili e correggili prima di creare elementi visivi o sottotitoli. Un nome di prodotto errato si propagherebbe in tutti i file successivi.

Recommended Loop

1. Leggi summary, layout e le risorse prima di pianificare qualsiasi cosa.
2. Esporta e revisiona una trascrizione se i tempi o il contenuto narrato sono importanti.
3. Pianifica prima i momenti chiave, quindi decidi quali intervalli necessitano di tagli, modifiche del layout, didascalie o inserimenti visivi.
4. Esegui setCanvas(..., dryRun: true) prima di apportare cambiamenti alle proporzioni e setSceneLayout(..., dryRun: true) prima di lavori di layout complessi.
5. Applica le mutazioni temporali con editTimeline, setSceneLayout e manageEffects.
6. Verifica i risultati con getProjectState(scope: "visual") o tramite snapshot dopo ogni iterazione.
7. Rileggi lo stato del progetto prima di ritentare chiamate di mutazione andate in timeout.

When to Use Each Primitive

• editTimeline per tagli, rifiniture e pulizia dei confini di parole
• setSceneLayout per modifiche della composizione con un limite temporale, includendo il layout DSL avanzato
• manageEffects per sottotitoli, zoom e altri passaggi effettivi
• vfxExportVideoSegment più vfxOverlayProcessedClip per roundtrip di rendering esterni
• exportArtifact per esportazioni definitive, snapshot, SRT e range del video

Advanced Layout and B-Roll

Per gli elementi visivi su ScreenKite, la registrazione dello schermo rimane l'elemento principale. L'Advanced Layout e il B-roll dovrebbero solitamente corrispondere a brevi momenti di supporto, non all'acquisizione dell'intera visuale in modo predominante.

Se renderizzi una visuale esterna e la collochi con <ScreenKite.Visual />:

• renderizza l'asset con le esatte dimensioni (larghezza, altezza), fps e durata del frame del target
• tratta il file renderizzato come se fosse il frame PiP completo, non una piccola carta inserita in un video prevalentemente vuoto
• progetta l'animazione come entrata -> stazionamento fisso -> nessuna uscita interna
• lascia che le transizioni magicMove di ScreenKite gestiscano l'uscita fra i vari layout segmentati

Se applichi nuovamente una finestra di Advanced Layout più breve sopra un intervallo che prima era più lungo, riporta le eccedenze su pictureInPicture per "pulire". Altrimenti i vecchi segmenti di layout avanzato continueranno ad essere eseguiti oltre la loro finestra desiderata.

Guardrails

• Non tagliare mai a metà una parola. Usa i confini delle parole della trascrizione ogni qualvolta il tempismo della voce è importante.
• Rileggi sempre il project state prima di ritentare operazioni andate in timeout.
• Fai corrispondere le dimensioni dei render in overlay a larghezza, altezza, fps e frame target prima di posizionarli sulla timeline.
• Conserva gli output generati fuori dallo .skbundle.
• Metti un limite ai loop di autovalutazione. Se i controlli visivi falliscono anche dopo vari tentativi, interrompi o controlla manualmente i layout ed i media sorgenti.