SCROLLUCK/dark-channel-studio-public

shorts-from-peaks

Ordre des outils

1. search_videos(query, n, shorts) – recherche sur YouTube, classe les résultats (vues, viralité) et les stocke avec leurs meilleurs pics. list_sources montre ce qui est déjà stocké. Privilégiez les sources officielles ou autorisées.
2. get_peaks(video_id) – pics de la carte de chaleur d'une source stockée. Pas de carte de chaleur = dites-le ; proposez une autre source ou une fenêtre manuelle, n'inventez jamais de pics.
3. create_clip_project(video_id, peak_rank=1, hook_text) – brouillon d'éditeur à partir d'un pic, ou passez les secondes start/end pour une fenêtre manuelle (s'exécute directement).
4. render_project(video_id, hook_text, custom_script) – rend le brouillon en arrière-plan (s'exécute directement) ; interrogez get_job(job_id). Son checks_failed liste les contrôles de transformation échoués.
5. Corrigez les contrôles échoués, puis demandez à l'ajouter à la file d'attente avec queue_add(project_id) (nécessite confirmation). ui_open("editor", video_id) le montre à l'utilisateur.

• Pas de carte de chaleur, ou un long téléchargement/lien dont l'utilisateur est propriétaire : autoclip_source(url, length, max_clips, prompt, create_drafts) trouve les meilleurs moments à partir de la transcription et renvoie des clips classés (interrogez get_job) ; avec create_drafts=true ils atterrissent dans l'éditeur.

Lecture des pics

• Les valeurs sont normalisées entre 0 et 1. Un pic est un maximum local >= 0,8 ; les pics distants de moins de 10 s fusionnent en un seul.
• Ignorez un pic dans les 5 % premiers de la vidéo (artefact d'intro). Gardez les 3 premiers par valeur.
• Rapporter chaque pic sous la forme start-end, peak_value, rank depuis l'outil, avec le titre et l'URL de la vidéo.

Fenêtre de coupe

• Longueur totale 15-30 s (max dur 30 s : la porte de transformation rejette les plus longues).
• Commencez 3-5 s avant le pic pour que le spectateur ait le contexte ; terminez 2-4 s après le dénouement. Coupez à une limite de phrase ou d'action.
• Ajustez à la durée de la vidéo. N'utilisez jamais plus de 50 % de la durée d'un clip tiers : ajoutez des B-roll, images ou cartes de données.
• Un moment par Short. Deux pics seulement s'ils correspondent au même rebondissement narratif.

Accroche (3 premières secondes)

• Une question, un enjeu ou une affirmation surprenante lue sur la première image, plus un grand titre à l'écran (max 6 mots).
• Utilisez uniquement des faits présents dans le titre, la description ou la transcription ; étiquetez les rumeurs avec « RUMEUR ».
• Narration : phrases <= 8 mots, environ 2,5 mots/s, accroche -> contexte -> dénouement au pic -> court appel à l'action. L'audio source reste bas ou désactivé ; le narrateur mène.

Contrôles de transformation (les cinq doivent réussir ; voir docs/LEGAL.md)

• narration : narration originale présente.
• visual_layers : au moins 2 couches ajoutées (texte, images/autocollants, B-roll, carte de données).
• text_overlay : accroche ou texte à l'écran.
• duration : 30 s ou moins.
• source_credit : source créditée dans chaque légende de plateforme. Si l'un échoue, corrigez le projet et re-rendez ; un nouveau rendu invalide toute approbation antérieure.

Sous-titres et texte

• Sous-titres mot à mot, 2-4 mots par groupe, police sans empattement en gras, blanc avec contour noir, mot actif surligné.
• Gardez les sous-titres hors des ~12 % du bas et ~6 % des côtés (interface utilisateur de la plateforme). Émojis seulement si le style de la chaîne les utilise.

Titre, légende, hashtags

• Titre/première ligne = l'accroche, moins de 80 caractères. Une phrase de contexte.
• 3-5 hashtags : 1 de niche, 1-2 thématiques, 1 général. Pas de tags interdits ou trompeurs.
• Incluez toujours Source : <chaîne> - <URL>.
• Modèle : references/clip-brief.md.

Mention IA

La narration synthétique (TTS) ou les visuels IA nécessitent le drapeau de mention IA par publication avant approbation, plus l'étiquette IA propre à la plateforme lors de l'upload. Rappelez-le à l'utilisateur dans la carte de confirmation.

À ne pas faire

• Publier un clip brut, un clip de plus de 30 s, ou un clip sans narration.
• Utiliser une source que l'utilisateur a marquée comme bloquée ou qui est privée/membres uniquement/connexion obligatoire.
• Ajouter à la file d'attente, planifier ou supprimer sans la confirmation de l'utilisateur.