Plugin Meshy para o DeepSeek Harness
Instale o plugin Meshy no DeepSeek Harness para gerar modelos 3D, texturas e animações, e preparar impressões 3D, a partir de uma conversa.
Visão geral
O plugin Meshy adiciona duas skills ao DeepSeek Harness (dsh):
meshy-3d-generation: Texto para 3D, Imagem para 3D e Multi-imagem para 3D, texturização e retexturização por IA, remesh para um orçamento de polígonos, desdobramento UV, rigging automático e animação para personagens humanoides, e exportação para GLB, FBX, OBJ, STL ou USDZ.meshy-3d-printing: análise e reparação de imprimibilidade, 3MF monocromático e multicolor, dimensionamento para medidas reais, produtos Creative Lab como figuras, candeeiros, porta-chaves e ímanes de frigorífico, e transferência para um software de corte instalado.
O plugin inclui a CLI do Meshy, que é o pacote meshy-cli no npm. As skills executam-na e guardam os ficheiros no seu projeto. Inicia sessão uma vez no seu navegador e não precisa de uma chave de API.
No dsh Web e Desktop, o plugin também adiciona uma página Meshy à barra lateral, uma página de definições Meshy, e uma pré-visualização 3D para ficheiros GLB.
O plugin é o pacote meshy-dsh no npm, e o dsh apresenta-o como Meshy em Plugins. O plugin é de código aberto no repositório meshy-dsh no GitHub, e as skills provêm do repositório meshy-3d-agent.
Antes de começar
-
Precisa do DeepSeek Harness.
-
Para gerar modelos, precisa de um plano Meshy pago. Cada tarefa de geração gasta créditos Meshy às taxas da API. Para o custo de cada tarefa, consulte Preços. A análise de imprimibilidade é gratuita, e os passos de impressão locais, como redimensionar um modelo ou abri-lo num software de corte, não requerem início de sessão.
Instalar o plugin
Pode instalar o plugin de qualquer uma das seguintes formas:
-
Pedir ao agente: numa sessão do dsh, peça Instalar o plugin Meshy. O agente instala-o por si.
-
Página Plugins: no dsh, abra Plugins, selecione Add plugin e introduza
meshy-dsh. Na China continental, escolha o registo Mainland China mirror. -
Linha de comandos: execute o seguinte comando. Para instalar a partir do GitHub, use
github:meshy-dev/meshy-dsh.dsh plugin --profile web add meshy-dshO dsh instala plugins por perfil. Para instalar o plugin noutro perfil, como
desktopoutui, substituawebpelo nome desse perfil.
Para confirmar a instalação, abra Plugins no dsh. O plugin Meshy aparece listado e em execução. Em seguida, inicie uma nova sessão e escreva /. A lista mostra meshy-3d-generation e meshy-3d-printing. O dsh só carrega as skills nas sessões que iniciar depois da instalação.
O plugin inclui a CLI do Meshy, pelo que não precisa de instalar mais nada.
Iniciar sessão
Inicia sessão uma vez, e todas as sessões, novas ou antigas, utilizam esse início de sessão. No dsh Web e Desktop, pode iniciar sessão a partir da página Meshy ou de Settings > Meshy. Numa conversa, o agente mostra-lhe um link e um código quando pede um modelo pela primeira vez.
Para iniciar sessão a partir da página Meshy, siga estes passos:
-
Na barra lateral do dsh, selecione Meshy.
-
Em Site, escolha Global · meshy.ai. Na China continental, escolha China · meshy.cn. Utiliza a mesma conta Meshy e os mesmos créditos em ambos os sites.
-
Clique em Sign in to Meshy. A página mostra um código QR, um link e um código.

-
Digitalize o código QR com o seu telemóvel, ou clique em Open in browser.
-
Se o Meshy lhe pedir para iniciar sessão, inicie sessão na sua conta Meshy.
-
Na página Connect Meshy CLI, verifique se o código corresponde ao código no dsh, e depois clique em Connect.

-
Volte ao dsh. A página termina automaticamente e mostra Signed in.
O código expira ao fim de 10 minutos. Se expirar, inicie o processo de início de sessão novamente.
O início de sessão é próprio da CLI do Meshy, e o seu sistema operativo guarda a chave que o encripta, pelo que o comando meshy no seu terminal utiliza o mesmo início de sessão. O dsh mantém uma variável MESHY_API_KEY exportada fora da shell do agente, e o plugin não a transmite, pelo que deve iniciar sessão através do navegador.
Página Meshy e pré-visualização 3D
O dsh Web e Desktop mostram as seguintes páginas Meshy. O dsh tui e o modo headless não as mostram, mas as skills funcionam da mesma forma.
-
Página Meshy: selecione Meshy na barra lateral esquerda. A página mostra a sua conta Meshy e quatro pedidos de exemplo em Start creating.

Selecione um exemplo para iniciar uma nova sessão com o pedido já preenchido. Pode editar o pedido antes de o enviar.

-
Página de definições: abra Settings e depois selecione Meshy. Também pode abrir a página a partir do plugin Meshy em Plugins. Quando tem sessão iniciada, a página mostra a sua conta, os seus créditos, a forma como iniciou sessão (navegador ou chave de API), o site e a versão da CLI do Meshy. A partir desta página, pode terminar sessão ou obter mais créditos. O site da China ainda não mostra o nome da conta.

-
Pré-visualização 3D: selecione um ficheiro
.glbna barra lateral direita, ou selecione o cartão de um modelo que o agente entrega. A pré-visualização mostra o modelo em 3D com o seu tamanho de ficheiro e contagem de triângulos. Arraste para orbitar, use o scroll para aproximar/afastar, e use os botões para repor a vista ou rodar o modelo. A pré-visualização abre modelos até 256 MB.
Exemplos de prompts
Descreva o trabalho com as suas próprias palavras. Por exemplo:
- Cria um baú do tesouro low-poly em estilo cartoon para o meu jogo e exporta-o como GLB.
- Transforma a foto que anexo num modelo 3D texturizado. (anexe a imagem)
- Cria um cavaleiro cartoon, faz o rigging, adiciona uma animação de caminhada e exporta FBX.
- Cria uma figura de shiba inu com 10 cm de altura e prepara um 3MF pronto a imprimir.
- Cria três frascos de poção low-poly para o meu jogo, cada um com menos de 1500 triângulos.
Os pedidos de seguimento reutilizam o resultado anterior, por exemplo faz um LOD com 1500 faces, agora em FBX, ou dimensiona-o para 150 mm. Antes de o agente gastar créditos, informa-o do custo e aguarda a sua confirmação.
Resolução de problemas
A tabela seguinte lista problemas comuns, as suas causas e como resolvê-los.
| Problema | Causa | Solução |
|---|---|---|
Escrever / não lista as skills Meshy | A sessão começou antes da instalação, ou instalou o plugin num perfil diferente. | Inicie uma nova sessão. Se as skills continuarem em falta, instale o plugin no perfil que utiliza, por exemplo dsh plugin --profile desktop add meshy-dsh. |
| A barra lateral não tem a entrada Meshy | Está a utilizar o dsh tui ou o modo headless, que não têm páginas Meshy. | Utilize o dsh Web ou Desktop. As skills funcionam em todos os modos. |
| A página Meshy mostra Needs attention | Não foi possível verificar o início de sessão guardado. | Clique no ícone de atualizar. Se a mensagem persistir, termine sessão e inicie sessão novamente. |
A CLI do Meshy não utiliza a sua MESHY_API_KEY | O dsh mantém as variáveis de credenciais fora da shell do agente. | Inicie sessão através do navegador. Nunca cole uma chave de API numa conversa. |
| O código de início de sessão expirou | Um código é válido durante 10 minutos. | Inicie o processo de início de sessão novamente, ou peça ao agente um novo código. |
| O agente não consegue gerar devido ao seu plano ou créditos | A geração requer um plano pago e créditos suficientes. | Verifique o seu plano e saldo na página Subscription na aplicação web do Meshy. |
| A pré-visualização 3D indica que o modelo é demasiado grande | A pré-visualização abre modelos até 256 MB. | Peça ao agente para fazer remesh do modelo para menos faces, e depois abra-o novamente. |
| Tem sessão iniciada na conta Meshy errada | O plugin mantém o último início de sessão que fez. | Na página Meshy, clique em Sign out e depois inicie sessão novamente. |
Perguntas frequentes
- Como adiciono o Meshy ao DeepSeek Harness?
- Peça ao agente para instalar o plugin Meshy, adicione meshy-dsh em Plugins > Add plugin, ou execute dsh plugin --profile web add meshy-dsh. Depois inicie uma nova sessão.
- Preciso de uma chave de API do Meshy?
- Não. Inicia sessão através do navegador uma vez, e todas as sessões do dsh utilizam esse início de sessão. O dsh não transmite ao agente uma MESHY_API_KEY exportada.
- Preciso de instalar o Node.js ou a CLI do Meshy?
- Não. O plugin inclui a CLI do Meshy e executa-a para as skills.
- Funciona no dsh tui?
- Sim. As skills funcionam em todos os modos do dsh. A página Meshy, a página de definições e a pré-visualização 3D só existem no dsh Web e Desktop.
- Posso utilizá-lo na China continental?
- Sim. Escolha China · meshy.cn ao iniciar sessão. Utiliza a mesma conta Meshy e os mesmos créditos, e os pedidos seguintes são enviados para o site da China.
- São as mesmas skills do plugin do Codex?
- Sim. Os plugins para Codex, Claude Code, Cursor, OpenClaw, Hermes Agent e DeepSeek Harness utilizam todos meshy-3d-generation e meshy-3d-printing do repositório de código aberto meshy-3d-agent.
- É gratuito?
- O plugin é gratuito e de código aberto. Gerar modelos 3D requer um plano Meshy pago e gasta créditos Meshy às taxas da API. A análise de imprimibilidade é gratuita.
Próximos passos
-
Para utilizar as mesmas skills no Codex, consulte Plugin Meshy para o Codex.
-
Para utilizar as mesmas skills no Hermes Agent, consulte Skills Meshy para o Hermes Agent.
-
Para chamar a Meshy API a partir de um agente de IA com a sua própria chave de API, consulte Integração de IA.