Execute tarefas comuns do CopyDoc 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
Todo atalho exige uma licença válida verificada ou usos de teste 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 para abrir.
- 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.
- Procure 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 caixa de diálogo de salvamento.
Os atalhos de criação pedem nomes ou dimensões diretamente. Os atalhos de camadas selecionadas usam a seleção atual automaticamente. Esses atalhos do dia a dia não pedem Target nem JSON. Escolha Open CopyDoc para abrir o painel normal do plugin.
| Atalho | Campos |
|---|---|
| Export Selected Text (Custom Settings…) | Format (opcional) |
Os campos de opções fixas usam rótulos legíveis. Pesquise pelo rótulo exibido ou pelo valor subjacente; as entradas de agentes continuam usando os valores mostrados na referência de comandos.
Executar pelo menu de contexto
Selecione as camadas desejadas, clique com o botão direito e escolha Plugins → CopyDoc (os plugins em desenvolvimento aparecem em Development). Escolha uma ação e o formato ou a predefinição dela. Uma predefinição é executada na hora quando não precisa de nenhum campo obrigatório; conclua a caixa de diálogo de salvamento quando ela aparecer.
Cada predefinição define a opção correspondente ao nome dela. As opções compatíveis omitidas herdam as configurações salvas do plugin; uma ação ou opção explícita tem prioridade sobre um comportamento salvo conflitante. Só os campos preenchidos explicitamente ou a opção escolhida no menu substituem essas configurações naquela execução. Se uma configuração nunca foi salva, vale a configuração normal ou o valor padrão documentado. As substituições na exportação não são salvas 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 preencha os parâmetros. As ações que precisam de texto, URLs, nomes ou dimensões continuam pedindo esses campos obrigatórios. Open CopyDoc abre o painel normal.
| Opção do menu | Próximo passo |
|---|---|
| Export Selected Text → Use Saved Settings | Executa na hora |
| Export Selected Text → CSV Spreadsheet | Executa na hora |
| Export Selected Text → Excel Spreadsheet (.xlsx) | Executa na hora |
| Export Selected Text → JSON | Executa na hora |
| Export Selected Text → Markdown | Executa na hora |
| Export Selected Text → XLIFF 1.2 | Executa na hora |
| Export Selected Text → XLIFF 2.0 | Executa na hora |
| Export Selected Text → Export Selected Text (Custom Settings…) | Preencha Format (opcional) |
Edição detalhada
Use o painel normal do plugin para configurações detalhadas, conteúdos mais longos, criação em massa e para navegar 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 o texto colado nesse limite. Entradas mais longas devem ser feitas no painel normal.
Se um plugin mais antigo mostrar Action, Target e Options, atualize-o para usar estes atalhos nomeados. Um valor de Target é o ID de uma camada ou uma seleção, nunca o nome de um item novo.
Ações do CopyDoc
| Ação | O que faz | Target |
|---|---|---|
export | Exporta o texto dos frames selecionados | Uma ou mais camadas elegíveis |
export
Exporta o texto dos frames selecionados. Selecione uma ou mais camadas elegíveis.
| Opção | Tipo | Obrigatório / padrão | Significado e valores aceitos |
|---|---|---|---|
format | string | Valor padrão: "csv" | Formato da exportação de texto. csv, xlsx, json, markdown, xliff1, xliff2 |
Os campos obrigatórios aninhados valem quando o objeto pai ou o item de array correspondente é informado. Os valores opcionais omitidos seguem o comportamento atual da operação, a menos que haja um valor padrão indicado.
Escolha Export Selected Text (Custom Settings…). Preencha estes campos simples; não é preciso JSON:
- Format: CSV Spreadsheet
Entrada para o host do agente
{"command":"shortcut-export","parameters":{"format":"csv"}}Usar os 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 as definições de opções da Hypermatic em vez do JSON Schema padrão: min e max limitam o tamanho da string, o tamanho do array ou o valor numérico, conforme o tipo do campo; as definições aninhadas usam fields e item. Campos desconhecidos são rejeitados.
O agente precisa de um host que consiga acionar as Quick Actions do Figma e observar o resultado normal do plugin. Os parâmetros não adicionam um ponto de acesso 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 números e opções de formato. Nunca afirme que um atalho foi executado só com base na entrada preparada.
Confira 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 caixas de diálogo nativas de salvamento conforme 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 dele; 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 simples em campos individuais, com menos de 150 caracteres, e apenas os campos aceitos por esse atalho. |
| O Target está ausente ou não é elegível | Abra a página correta, confira os requisitos de camadas 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 não aparece nenhum arquivo salvo | Confira a caixa de diálogo nativa de salvamento e o local de download. Verifique o arquivo em si. |
| 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. Um erro não significa que tudo foi revertido. Repetir automaticamente uma criação, substituição ou upload pode duplicar ou sobrescrever 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
Os atalhos exportam o texto selecionado. A substituição de textos, a importação de traduções, a sincronização de planilhas e o preenchimento de componentes usam o painel normal.