Lancez les tâches courantes de Crypto depuis les Quick Actions de Figma sans ouvrir le panneau du plugin. Choisissez l’un des raccourcis nommés ci-dessous. Utilisez le panneau habituel du plugin pour les réglages détaillés et la création de contenu.
Lancer une Quick Action
Chaque raccourci nécessite une licence valide vérifiée ou des essais restants. Si la vérification échoue ou si vos essais ont expiré, ouvrez le panneau habituel du plugin pour activer votre licence. L’ouverture du panneau reste toujours possible.
- Sélectionnez les calques sur lesquels vous voulez travailler, si le raccourci utilise une sélection.
- Ouvrez les Quick Actions de Figma avec Command + / sur Mac ou Ctrl + / sur Windows.
- Recherchez le plugin et choisissez l’un des raccourcis nommés ci-dessous.
- Remplissez les champs affichés. Les champs facultatifs peuvent être ignorés ; utilisez Tab pour les modifier. Lancez le raccourci, puis vérifiez le résultat ou terminez la boîte de dialogue d’enregistrement.
Les raccourcis de création demandent directement des noms ou des dimensions. Les raccourcis qui agissent sur les calques sélectionnés utilisent automatiquement la sélection actuelle. Ces raccourcis du quotidien ne demandent ni Target ni JSON. Choisissez Open Crypto pour ouvrir le panneau habituel du plugin.
| Raccourci | Champs |
|---|---|
| Upload Selected Designs | Aucun ; s’exécute immédiatement |
| Export Selected Designs as PDF (Custom Settings…) | Password protection (facultatif), PDF quality (facultatif) |
Les champs à choix fixe utilisent des libellés lisibles. Recherchez par le libellé affiché ou par la valeur sous-jacente ; les entrées des agents continuent d’utiliser les valeurs indiquées dans la référence des commandes.
Lancer depuis le menu contextuel
Sélectionnez les calques voulus, faites un clic droit et choisissez Plugins → Crypto (les plugins en développement apparaissent sous Development). Choisissez une action, puis son format ou son préréglage. Un préréglage s’exécute immédiatement s’il ne demande aucun champ obligatoire ; terminez la boîte de dialogue d’enregistrement si elle s’affiche.
Chaque préréglage définit l’option qui porte son nom. Les options compatibles omises reprennent les réglages enregistrés du plugin ; une action ou une option explicite l’emporte sur un comportement enregistré contradictoire. Seuls les champs saisis explicitement ou le choix de menu sélectionné les remplacent, et uniquement pour cette exécution. Si un réglage n’a jamais été enregistré, le réglage habituel ou la valeur de repli documentée s’applique. Les remplacements d’export ne sont pas enregistrés dans vos préférences. Si un format enregistré n’est pas disponible comme raccourci, choisissez explicitement un format pris en charge ou utilisez le panneau habituel. Pour combiner des options, choisissez Custom Settings… dans l’action et saisissez les paramètres. Les actions qui ont besoin d’un texte, d’URL, de noms ou de dimensions demandent toujours ces champs obligatoires. Open Crypto ouvre le panneau habituel.
| Choix de menu | Étape suivante |
|---|---|
| Upload Selected Designs | S’exécute immédiatement |
| Export Selected Designs as PDF → Use Saved Settings | S’exécute immédiatement |
| Export Selected Designs as PDF → Export Selected Designs as PDF (Custom Settings…) | Saisissez Password protection (facultatif), PDF quality (facultatif) |
Modifications détaillées
Utilisez le panneau habituel du plugin pour les réglages détaillés, les contenus longs, la création en masse et la consultation des composants ou des modèles. Le menu des raccourcis ne contient que les commandes du quotidien listées ci-dessus.
Gardez chaque champ collé sous 150 caractères : l’application de bureau Figma peut tronquer les saisies collées à cette limite. Les saisies plus longues se font dans le panneau habituel.
Si une ancienne version du plugin affiche plutôt Action, Target et Options, mettez-la à jour pour utiliser ces raccourcis nommés. Une valeur Target est un ID de calque ou une sélection, jamais le nom d’un nouvel élément.
Actions de Crypto
| Action | Ce qu’elle fait | Cible |
|---|---|---|
publish | Met en ligne les frames sélectionnés comme nouvelle version de design protégée | Un ou plusieurs calques compatibles |
pdf | Exporte les frames sélectionnés en PDF avec les réglages de protection enregistrés | Un ou plusieurs calques compatibles |
publish
Met en ligne les frames sélectionnés comme nouvelle version de design protégée. Sélectionnez un ou plusieurs calques compatibles.
Ce raccourci n’a aucun champ.
Il s’agit d’une écriture externe explicite vers les services Hypermatic existants du plugin. Elle réutilise la configuration de compte enregistrée et peut créer un compte via le workflow existant. Ne réessayez pas automatiquement après une erreur de mise en ligne ; vérifiez d’abord si la destination distante contient un résultat partiel.
Choisissez Upload Selected Designs. Le raccourci s’exécute immédiatement sur la sélection actuelle.
Entrée pour l’hôte de l’agent
{"command":"shortcut-publish","parameters":{}}pdf
Exporte les frames sélectionnés en PDF avec les réglages de protection enregistrés. Sélectionnez un ou plusieurs calques compatibles.
| Option | Type | Obligatoire / par défaut | Signification et valeurs acceptées |
|---|---|---|---|
protection | string | Valeur de repli : "saved" | Utilise un mot de passe enregistré précédemment, ou exporte explicitement sans protection. saved, none |
dpi | string | Valeur de repli : "ebook" | Préréglage de qualité PDF existant. screen, ebook, printer, prepress, default |
Les champs obligatoires imbriqués s’appliquent lorsque leur objet parent ou leur élément de tableau est fourni. Les valeurs facultatives omises reprennent le comportement actuel de l’opération, sauf si une valeur par défaut est indiquée.
Choisissez Export Selected Designs as PDF (Custom Settings…). Saisissez ces champs simples ; aucun JSON n’est nécessaire :
- Password protection : Use Saved Password
- PDF quality : eBook (150 dpi)
Entrée pour l’hôte de l’agent
{"command":"shortcut-pdf","parameters":{"protection":"saved","dpi":"ebook"}}Utiliser les raccourcis avec un agent
Lisez le registre lisible par machine indiqué ci-dessous et choisissez une action proposée dans la liste des Quick Actions du plugin installé. Le registre utilise les définitions d’options d’Hypermatic plutôt que le standard JSON Schema : min et max limitent la longueur d’une chaîne, la longueur d’un tableau ou une valeur numérique selon le type du champ ; les définitions imbriquées utilisent fields et item. Les champs inconnus sont refusés.
L’agent a besoin d’un hôte capable de lancer les Quick Actions de Figma et d’observer le résultat habituel du plugin. Les paramètres n’ajoutent pas de lanceur REST ou MCP. Les exemples dépliables sont des données d’entrée pour un hôte compatible, pas des appels d’API exécutables ; les entrées des raccourcis utilisent des chaînes simples dans parameters, y compris pour les nombres et les choix de format. N’affirmez jamais qu’un raccourci s’est exécuté sur la seule base de l’entrée préparée.
Vérifiez le résultat visible : les calques Figma modifiés, l’export enregistré ou la page publiée. Lisez la notification habituelle de réussite ou d’erreur et tout avertissement d’export partiel. Terminez les boîtes de dialogue d’enregistrement natives si nécessaire ; le démarrage d’un téléchargement ne prouve pas que le fichier a été enregistré. Les utilisateurs n’ont pas besoin d’ouvrir les outils de développement ni de lire une console.
Dépannage
| Symptôme | Étape suivante |
|---|---|
| L’action n’est pas disponible | Mettez le plugin à jour et vérifiez sa liste de Quick Actions ; utilisez le panneau habituel si l’action reste indisponible. |
| Les options ne sont pas valides ou ont peut-être été tronquées | Utilisez des valeurs de champ simples, individuelles, de moins de 150 caractères, avec uniquement les champs acceptés par ce raccourci. |
| La cible est manquante ou non compatible | Ouvrez la bonne page, vérifiez les exigences de l’action concernant les calques et sélectionnez de nouveau les calques voulus. |
| Une erreur de licence ou d’essai s’affiche | Terminez le processus d’activation habituel du plugin avant de relancer. |
| Le téléchargement a été demandé, mais aucun fichier enregistré n’apparaît | Vérifiez la boîte de dialogue d’enregistrement native et l’emplacement de téléchargement. Examinez le fichier lui-même. |
| Une commande échoue, expire ou est annulée | Vérifiez le document et la destination distante avant de réessayer ; des modifications ou des mises en ligne antérieures peuvent déjà exister. |
Les commandes ont un délai de cinq minutes. Une erreur n’implique pas une annulation complète. Relancer automatiquement une création, un remplacement ou une mise en ligne peut dupliquer ou écraser du travail.
Le registre des commandes lisible par machine contient les mêmes ID d’action et définitions d’options.
Limites actuelles
L’action publish crée une nouvelle version de design protégée à partir de la configuration de compte et de la fonctionnalité de mise en ligne existantes ; elle peut créer un compte distant. La publication de prototypes, la mise à jour de versions existantes et le changement de mot de passe restent interactifs. L’export PDF utilise l’état de protection par mot de passe et la qualité enregistrés. Choisir la protection none désactive la protection pour cet export uniquement. Un réglage de protection enregistré comme activé nécessite son mot de passe enregistré. Choisir explicitement Use Saved Password nécessite aussi un mot de passe enregistré et active la protection pour cette exécution.