Créer des Motion Graphics
Plugin hôte et projet
Utilisez le serveur MCP chatcut et l'ID du projet à partir de l'URL de l'éditeur de l'utilisateur ou du résultat du projet du plugin. Ce plugin fonctionne avec l'éditeur Web, y compris les URL de développement local. N'ouvrez pas ChatCut Desktop et n'utilisez pas chatcut_desktop pour un projet Web. Si les outils chatcut ne sont pas disponibles, signalez l'échec de connexion ; ne soumettez pas la tâche à l'agent natif de l'éditeur comme substitut.
Trouver des références MG avant de concevoir
Parcourir et confirmer une direction visuelle
Pour la production, réutilisez un style de projet accepté ou une marque/référence fournie par l'utilisateur. Utilisez manage_design_style get lorsque ses spécifications complètes ne sont pas déjà connues. Les modifications de texte/placement de routine n'ont pas besoin de nouvelle sélection de style ou de nouvelle analyse du catalogue.
Lorsqu'une nouvelle direction est nécessaire ou que l'utilisateur demande à parcourir des alternatives, commencez par browse_library references: {view: "style-overview"}. Lisez TOUTES les planches contact numérotées, en suivant nextOffset jusqu'à complete. Elles contiennent des représentants de style publiés et activés par l'agent, y compris les Design Styles liées. list_presets n'est qu'un sous-ensemble de catalogue hérité ; il ne peut pas remplacer cette vue d'ensemble visuelle. Réessayez une page en échec ; signalez un aperçu incomplet au lieu de l'ignorer silencieusement.
Pour une vidéo avec discours, comprenez le contenu parlé et inspectez les images vidéo représentatives avant de présélectionner des styles. Réutilisez les preuves de transcription et d'images déjà en contexte. Tenez compte du sujet, du ton de la présentation, de la langue à l'écran, ainsi que de la couleur, du cadrage du sujet et de l'arrière-plan des séquences, en parallèle des aperçus de style.
Lorsque la direction visuelle n'est pas encore convenue, présélectionnez jusqu'à 6 choix distincts adaptés au contenu et aux séquences actuels, et lisez leurs parties hero. Chargez la compétence widget-forms de l'hôte et affichez les images heroPreview.url réelles avec des noms courts. Les images renvoyées par l'outil sont des preuves pour l'agent, pas un sélecteur destiné à l'utilisateur ; les choix textuels seuls ne montrent pas les différences visuelles. Gardez chaque choix mappé à son ID de référence ; utilisez la branche Autre du formulaire pour les préférences ou un autre lot sans répéter les choix ni ajouter une option "Afficher plus". Attendez la sélection avant d'appliquer un nouveau style et de produire le MG, sauf si l'utilisateur a déjà choisi une direction ou a explicitement délégué le choix du style. Une réponse "Autre" n'est pas une acceptation.
Appliquer le style sélectionné
Lisez le summary, hero et members du représentant sélectionné. Suivez son designStyleAction avec manage_design_style :
apply_preset: utilisez lepresetIdrenvoyé directement ; ne clonez pas et ne mettez pas à jour le préréglage uniquement pour enregistrer les métadonnées de référence.apply: réutilisez ledesignStyleIdrenvoyé pour un style utilisateur existant enregistré.create: seule une référence indépendante a besoin d'un nouveau style appartenant à l'utilisateur. Définissez et enregistrez sa palette, ses polices et ses règles visuelles réutilisables à partir de la référence sélectionnée. Réutilisez la palette documentée de la référence ; si absente, dérivez une palette cohérente de son image représentative. EnregistrezdesignSpec.referenceSources: [{id: "<ID de référence>"}]et l'heroPreview.urlindividuel à la fois dansthumbnailUrletdesignSpec.images: [{role: "référence de style", url: "<heroPreview.url>"}]. UtilisezapplyToProject: true; préservez les images existantes lors de la modification d'un tableau.
Après application, appelez get pour obtenir les spécifications complètes et les ID sources à jour ; ne conservez pas les règles mises en cache du style précédent. Pour un nouveau style, vérifiez que sa palette, ses polices, sa source, sa couverture et son image de référence ont été enregistrés. Un ID source seul n'enregistre pas une image.
Les images de référence sont des preuves visuelles, pas des séquences/arrière-plans à intégrer ni des exemples de texte à reproduire.
Utilisez fontRecommendations["zh-Hans"] / .en en fonction du texte réel à l'écran, y compris le texte bilingue et les chiffres latins. Réutilisez un plan de polices accepté ; un groupe de langues vide n'est pas résolu. Faites correspondre le caractère typographique de la référence et la hiérarchie titre/corps, et vérifiez la couverture des glyphes et la disponibilité à l'exécution. Enregistrez les familles/rôles sélectionnés dans designSpec.fonts, et la langue, le poids, l'italique et les axes requis dans styleGuide. Un exemple de formulaire multi-style ne peut pas remplacer ce plan. Uniquement lors de la curation de polices manquantes ou de l'adaptation explicite de la typographie, lisez Correspondance des polices ; la correspondance chinoise commence à partir d'une image d'effet chinois générée, pas de lettres anglaises.
Faire correspondre les instances aux formulaires MG requis
Utilisez le contenu parlé et les images cibles pour décider quels formulaires MG sont utiles ; laissez les aperçus de référence affiner ces choix. Maintenez le langage visuel confirmé dans toute la vidéo et trouvez des instances appropriées pour chaque formulaire nécessaire. Choisissez vous-même les instances, sauf si l'utilisateur demande à les comparer. Différents formulaires peuvent utiliser différentes instances ; les composants récurrents peuvent réutiliser une instance inspectée. Suivez nextReferenceSearch lorsqu'il est renvoyé :
- Avec des membres liés, parcourez
kind: "instance", styleId: "<UUID représentant>"ou lisez les ID de membres pertinents. - Si un formulaire nécessaire n'a pas de membre correspondant, recherchez l'INTÉGRALITÉ de la bibliothèque d'instances par
queryde contenu/formulaire oufacets.form, en omettantstyleId,facets.styleet les termes de nom de style, même si d'autres formulaires ont déjà des correspondances du même style. - Comparez le collage de couverture, puis lisez les ID sélectionnés avec
parts: ["summary", "hero"]. Ajoutezmotionpour l'animation etcodepour l'implémentation. Si une référence basée sur le code renvoietemplateInspection, utilisez son appel en lecture seule pour le schéma/les valeurs par défaut des propriétés enregistrées ; JSX peut lire les props sans déclarer leurs valeurs.legacyTemplateRefssont des ID de modèle :manage_template getlit les métadonnées, etlist_assetslit les propriétés MG. Ni l'un ni l'autre n'applique ou ne copie un modèle.inspect_assetest destiné aux médias/MG du projet actuel, pas aux ID de source du catalogue.
Adaptez la composition, la hiérarchie, l'espacement et la structure de révélation de l'instance aux polices fixes du projet, à la palette, aux matériaux et au plan réel. Si la recherche de formulaire plus large n'a également aucune correspondance, étendez le tableau de style et indiquez cette limitation. Regroupez les lectures de détails pertinentes ; trouver une instance ne couvre pas les formulaires non liés. Suivez pendingIds pour les réponses fractionnées ; known peut inclure uniquement les versions renvoyées et les parties toujours en contexte. Chaque planche de mouvement est UN design à des horodatages réels ; un montage n'est pas une mise en page, et une image statique n'établit pas d'animation.
Pour un nouveau/redessiné substantiellement un incrustateur de tête parlante, lisez Composition d'incrustateur. Importez uniquement les fichiers de production de materials qui apparaîtront dans le résultat ; utilisez leurs ID d'asset de projet. Examinez le MG composé avec les séquences cibles.
Utiliser les références lors de la rédaction
Lisez le code de l'instance sélectionnée lorsque vous empruntez son implémentation, ou lisez les propriétés du modèle lié avec manage_template list_assets. Utilisez-la comme référence dans le workflow de code ci-dessous tout en préservant le style du projet.
Inspectez également les images sélectionnées : une URL, un ID ou un résultat de recherche seul ne constitue pas une référence consultée. Conservez les preuves de STYLE pour l'apparence et les preuves de FORME multi-style pour la structure. Si une référence sélectionnée échoue, réessayez ou signalez les preuves manquantes plutôt que de prétendre qu'elles ont été inspectées.
Utilisez cette compétence lorsqu'une tâche du plugin ChatCut nécessite un asset Motion Graphic rédigé ou corrigé en tant que JSX en ligne. L'agent ChatCut intégré a son propre workflow motion-graphic-gen ; ne passez pas à celui-ci à partir de cette tâche de plugin.
Les Motion Graphics du plugin Codex sont rédigés directement. Utilisez create_motion_graphic_from_code pour les nouveaux assets JSX et edit_asset pour le JSX MG existant. Cette surface ne fournit pas submit_motion_graphic ; ne traduisez pas la demande en une invite Gemini ou un brief de génération. Si les outils de rédaction directe sont manquants, arrêtez-vous et signalez les outils de plugin ChatCut indisponibles.
Transmettez le code source du Motion Graphic en ligne via les outils MCP chatcut. Ne stockez pas de code dans le dépôt ChatCut, ai-working/, /tmp, un serveur HTTP local, des fichiers de code générés ou des chemins d'application devinés lorsque l'outil accepte directement le JSX en ligne.
Principes fondamentaux
- Inspectez l'état du projet lorsque la taille du canvas, les fps, le langage visuel existant, le placement ou les conflits de timeline ne sont pas déjà connus.
- Identifiez les entrées requises dans Avant de coder avant de rédiger le JSX.
- Créez ou mettez à jour les assets Motion Graphic via le workflow d'asset en ligne disponible ; utilisez les schémas d'outil actuels pour les formes exactes des charges utiles.
- Placez ou déplacez les assets via le workflow d'édition de timeline lorsque l'édition nécessite un placement dans la timeline.
- Relisez l'état du projet et vérifiez l'image visible après des modifications structurelles ou visuelles.
Avant de coder
Avant d'écrire du JSX, identifiez uniquement les informations nécessaires pour cette édition :
- Placement : heure de début, durée, calque cible si connu, et l'image cible avec laquelle le graphique doit composer.
- Rôle dans l'édition : quel travail ce Motion Graphic effectue dans la vidéo.
- Contenu : texte exact, nombres, médias ou faits visuels qui doivent apparaître.
- Timing : si le mouvement interne doit se synchroniser avec la parole, la musique ou un événement visuel.
- Source visuelle : style fourni par l'utilisateur, Design Style du projet, couleurs/polices de marque ou un Motion Graphic existant accepté.
- Champs modifiables : quelles valeurs de texte, couleurs, nombres, booléens, images ou vidéos doivent devenir des propriétés.
Ne demandez que les entrées manquantes à fort impact qui modifieraient matériellement le résultat.
Système visuel et placement
Utilisez le Design Style complet confirmé et les références inspectées ci-dessus. Pour une nouvelle direction personnalisée, établissez un résultat composé avant de traiter par lots ; les directions acceptées et les corrections courantes n'ont pas besoin de nouvelle confirmation de style.
Choisissez chaque composition, position, taille et temps de lecture à partir du plan réel et de la durée de parole. Maintenez une typographie, une palette, des matériaux et un mouvement partagés, tout en adaptant la forme de la référence au contenu. Un ancrage fixe à gauche/droite ou un conteneur de carte n'est approprié que lorsque la composition l'exige.
Réutilisez un asset avec des propriétés par élément pour un composant intentionnellement récurrent avec la même structure d'information. Les nouvelles structures ont besoin de leur propre référence d'instance et composition. Les limites de l'incrustateur doivent contenir étroitement le graphique ; utilisez les dimensions de la timeline uniquement pour un design qui s'étend visiblement sur le cadre.
Faites correspondre la durée de l'asset et les battements internes à la durée placée dans la timeline. Si le timing change matériellement, mettez à jour le MG au lieu de tronquer une animation inachevée. Examinez les images composées stabilisées côte à côte pour un lot, en corrigeant les collisions, la lisibilité et les répétitions involontaires avant de signaler l'achèvement.
Propriétés modifiables
Exposez les valeurs visibles par l'utilisateur et susceptibles de changer en tant que propriétés modifiables.
- Le texte visible, les couleurs principales, les couleurs d'accentuation et les valeurs numériques clés doivent être des propriétés.
- Les choix de polices doivent être des propriétés
fontlorsque les utilisateurs peuvent raisonnablement les modifier. - Les sources d'images et de vidéos doivent être des propriétés
image/video. - Les clés de code doivent correspondre exactement aux clés du schéma de propriétés.
- Lisez les valeurs à partir de
item.props; ne codez pas en dur le contenu visible que l'utilisateur pourrait raisonnablement vouloir modifier plus tard. - Utilisez les remplacements de propriétés au niveau de l'élément uniquement pour les composants intentionnellement récurrents avec la même tâche de visualisation, la même structure d'information et la même forme visuelle. Si l'un de ces éléments diffère, créez un autre asset MG et partagez la palette, le type et la logique de mouvement à la place.
Les entrées de propriétés doivent déclarer une clé stable, un libellé visible par l'utilisateur, un type et une valeur par défaut. Les types de propriétés pris en charge incluent text, number, color, boolean, select, font, image et video.
Polices
Les Motion Graphics doivent utiliser les polices disponibles dans le moteur de rendu de ChatCut afin que l'aperçu et l'exportation locale restent cohérents. Ne vous fiez pas aux polices système spécifiques à la machine telles que STKaiti, PingFang SC, Microsoft YaHei, Arial, Helvetica, Comic Sans MS, system-ui, -apple-system ou les familles CSS génériques comme police principale rendue ; la disponibilité diffère entre les machines et peut entraîner un repli.
Lorsque vous choisissez ou remplacez une police, appelez search_fonts et utilisez le nom de famille canonique renvoyé textuellement comme valeur fontFamily et la propriété font correspondante defaultValue. Utilisez Google Fonts ou les polices personnalisées du projet renvoyées par le catalogue. Si une police demandée spécifique à la machine n'est pas dans le catalogue, expliquez qu'un rendu local cohérent ne peut pas être garanti, recherchez une alternative prise en charge avec une sensation similaire, et utilisez-la sauf si l'utilisateur accepte explicitement le repli de police.
Assets et composition
Une instance de référence peut décrire une composition complète composée de plusieurs éléments de timeline. Cela n'implique pas un asset MG autonome. Gardez les captures d'écran de référence, les matériaux de production et les séquences du projet actuel distincts.
Par défaut, utilisez des éléments séparés lorsque le design combine des médias ordinaires avec des graphiques :
- Papier/texture/arrière-plan réutilisable : un élément image ou vidéo derrière la composition.
- Photo, image de produit ou séquence du projet actuel : son propre élément média. L'agent sélectionne/remplace, recadre, positionne et applique les effets pris en charge ; l'utilisateur n'est pas censé assembler les calques manuellement.
- Typographie, formes et décoration animée : élément(s) MG transparent(s). Séparez la décoration d'arrière-plan du texte de premier plan lorsque les médias doivent se situer entre eux.
Planifiez l'ordre des calques, le rectangle média cible, le début/la durée et le timing d'entrée avant de rédiger. Indiquez dans le brief/le scope du code MG quels calques existent déjà en dehors du MG, afin que la photo ou le papier de référence ne soit pas généré à nouveau. Appliquez le noir et blanc/la couleur/le grain à l'élément média prévu plutôt que d'affecter accidentellement le texte de premier plan. Vérifiez la prise en charge des effets sur la surface de lecture/exportation réelle ; diviser les calques ne prouve pas en soi la parité Web/Desktop.
- Réutilisez les assets de
browse_assetsdans le projet actuel. Importez uniquement les fichiers de production nécessaires dans la sortie dans Mes assets. Chargezasset-importet utilisez son assistant de session/téléchargementimport_media. L'enregistrement des médias du projet ne les publie pas dans la bibliothèque de ressources publiques. - Placez les médias de production normaux via
edit_item, en utilisant les ID d'asset du projet actuel renvoyés. L'agent gère le remplacement des personnes, des copies et des données d'exemple par le contenu de la tâche actuelle. N'utilisez pas les séquences de référence complètes comme substitut des images et des fichiers du projet en production. - Créez un asset MG en ligne distinct pour chaque calque de texte/de forme/d'animation qui partage un traitement visuel. Si le design a une photo entre une barre de fond et un titre, la photo doit être son propre élément image (pas un calque à l'intérieur du MG).