Execute tarefas comuns do Favvy pelas Quick Actions do Figma sem abrir o painel do plugin. Escolha um dos atalhos nomeados abaixo. Use o painel normal do plugin para configurações detalhadas e criação de conteúdo.
Executar uma Quick Action
As Quick Actions não usam o nome do site, a cor de tema e as opções de plataforma que o painel do Favvy lembra para o arquivo. Informe os campos do atalho que você quer alterar; as demais opções usam os valores padrão documentados.
Todo atalho exige uma licença válida verificada ou testes restantes. Se a verificação falhar ou seus testes tiverem acabado, abra o painel normal do plugin para ativar sua licença. O painel continua disponível.
- Selecione as camadas com que você quer trabalhar, se o atalho usar uma seleção.
- Abra as Quick Actions do Figma com Command + / no Mac ou Ctrl + / no Windows.
- Pesquise o plugin e escolha um dos atalhos nomeados abaixo.
- Preencha os campos exibidos. Os campos opcionais podem ser pulados; use Tab para editá-los. Execute o atalho e confira o resultado ou conclua a janela de salvamento.
Os atalhos de criação pedem nomes ou dimensões diretamente. Os atalhos para camadas selecionadas usam a seleção atual automaticamente. Esses atalhos do dia a dia não pedem Target nem JSON. Escolha Open Favvy para abrir o painel normal do plugin.
| Atalho | Entradas |
|---|---|
| Export Selected Favicon (Custom Settings…) | Name (optional), Theme colour (hex) (optional) |
Os campos de escolha fixa usam rótulos legíveis. Pesquise pelo rótulo exibido ou pelo valor correspondente; as entradas de agentes continuam usando os valores mostrados na referência de comandos.
Use Default Settings usa os padrões de favicon documentados, e não as configurações que o painel do Favvy lembra para o arquivo.
Executar pelo menu de contexto
Selecione as camadas desejadas, clique com o botão direito e escolha Plugins → Favvy (os plugins em desenvolvimento aparecem em Development). Escolha uma ação e o formato ou predefinição. Uma predefinição é executada imediatamente quando não precisa de nenhuma entrada obrigatória; conclua a janela de salvamento quando ela aparecer.
Cada predefinição define a opção correspondente. As opções compatíveis omitidas herdam as configurações salvas do plugin; uma ação ou opção explícita tem prioridade sobre comportamentos salvos conflitantes. Apenas os campos inseridos explicitamente ou a opção de menu selecionada substituem essas configurações nessa execução. Se uma configuração nunca foi salva, vale a configuração normal ou o valor padrão documentado. As substituições de exportação não são salvas de volta nas suas preferências. Se um formato salvo não estiver disponível como atalho, escolha explicitamente um formato compatível ou use o painel normal. Para combinar opções, escolha Custom Settings… dentro da ação e insira os parâmetros. Ações que precisam de texto, URLs, nomes ou dimensões continuam pedindo esses campos obrigatórios. Open Favvy abre o painel normal.
| Opção do menu | Próximo passo |
|---|---|
| Export Selected Favicon → Use Default Settings | Executa imediatamente |
| Export Selected Favicon → Export Selected Favicon (Custom Settings…) | Insira Name (optional) e Theme colour (hex) (optional) |
Edição detalhada
Use o painel normal do plugin para configurações detalhadas, conteúdos mais longos, criação em massa e navegação por componentes ou templates. O menu de atalhos contém apenas os comandos do dia a dia listados acima.
Mantenha cada campo colado com menos de 150 caracteres: o Figma para desktop pode cortar entradas coladas nesse limite. Entradas mais longas devem ir para o painel normal.
Se um plugin mais antigo mostrar Action, Target e Options em vez disso, atualize-o para usar esses atalhos nomeados. Um valor de Target é um ID de camada ou uma seleção, nunca o nome de um novo item.
Ações do Favvy
| Ação | O que faz | Target |
|---|---|---|
export | Exporta um ZIP de favicons a partir de uma camada quadrada | Exatamente uma camada elegível |
export
Exporta um ZIP de favicons a partir de uma camada quadrada. Selecione exatamente uma camada elegível.
| Opção | Tipo | Obrigatório / padrão | Significado e valores aceitos |
|---|---|---|---|
name | string | Valor padrão: "My Website" | Nome do site para o manifesto web. Máximo de 120 caracteres |
theme | string | Valor padrão: "#ffffff" | Cor de tema com seis dígitos. Padrão ^#[0-9a-fA-F]{6}$ |
Os campos obrigatórios aninhados se aplicam quando o objeto pai ou o item de array correspondente é informado. Os valores opcionais omitidos usam o comportamento atual da operação, a menos que um padrão esteja indicado.
Escolha Export Selected Favicon (Custom Settings…). Insira estes campos simples; nenhum JSON é necessário:
- Name:
My Website - Theme colour (hex):
#ffffff
Entrada do host do agente
{"command":"shortcut-export","parameters":{"name":"My Website","theme":"#ffffff"}}Usar atalhos com um agente
Leia o registro legível por máquina indicado abaixo e escolha uma ação oferecida na lista de Quick Actions do plugin instalado. O registro usa definições de opções da Hypermatic em vez do JSON Schema padrão: min e max limitam o comprimento da string, o tamanho do array ou o valor numérico, de acordo com o tipo do campo; as definições aninhadas usam fields e item. Campos desconhecidos são rejeitados.
O agente precisa de um host capaz de acionar as Quick Actions do Figma e observar o resultado normal do plugin. Os parâmetros não adicionam um inicializador REST ou MCP. Os exemplos expansíveis são dados de entrada para um host compatível, não chamadas de API executáveis; as entradas dos atalhos usam strings simples em parameters, inclusive para números e escolhas de formato. Nunca afirme que um atalho foi executado só porque a entrada foi preparada.
Verifique o resultado visível: as camadas do Figma alteradas, a exportação salva ou a página publicada. Leia a notificação normal de sucesso ou erro e qualquer aviso de exportação parcial. Conclua as janelas de salvamento nativas quando necessário; o início de um download não prova que o arquivo foi salvo. Os usuários não precisam abrir as ferramentas de desenvolvedor nem ler um console.
Solução de problemas
| Sintoma | Próximo passo |
|---|---|
| A ação não está disponível | Atualize o plugin e confira a lista de Quick Actions; use o painel normal se a ação não estiver disponível. |
| As opções são inválidas ou podem ter sido cortadas | Use valores de campo simples e individuais com menos de 150 caracteres, apenas com os campos aceitos por aquele atalho. |
| O Target está ausente ou não é elegível | Abra a página correta, confira os requisitos de camada da ação e selecione de novo as camadas desejadas. |
| Aparece um erro de licença ou de teste | Conclua o fluxo normal de ativação do plugin antes de executar de novo. |
| O download foi solicitado, mas nenhum arquivo salvo aparece | Confira a janela de salvamento nativa e o local de download. Inspecione o arquivo real. |
| Um comando falha, excede o tempo limite ou é cancelado | Confira o documento e o destino remoto antes de tentar de novo; alterações ou uploads anteriores podem já existir. |
Os comandos têm um prazo de cinco minutos. Erros não significam que tudo foi revertido. Repetir automaticamente uma criação, substituição ou upload pode duplicar ou sobrescrever o trabalho.
O registro de comandos legível por máquina contém os mesmos IDs de ação e definições de opções.
Limites atuais
O comando de favicon expõe as opções de exportação existentes. As restrições atuais do plano gratuito continuam definindo quais assets são incluídos.