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-dsh
    

    O dsh instala plugins por perfil. Para instalar o plugin noutro perfil, como desktop ou tui, substitua web pelo 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:

  1. Na barra lateral do dsh, selecione Meshy.

  2. 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.

  3. Clique em Sign in to Meshy. A página mostra um código QR, um link e um código.

    Página Meshy no dsh com um código QR, o código de início de sessão, Open in browser, e Waiting for your approval

  4. Digitalize o código QR com o seu telemóvel, ou clique em Open in browser.

  5. Se o Meshy lhe pedir para iniciar sessão, inicie sessão na sua conta Meshy.

  6. Na página Connect Meshy CLI, verifique se o código corresponde ao código no dsh, e depois clique em Connect.

    Página Connect Meshy CLI com a conta com sessão iniciada, o código a confirmar, e os botões Cancel e Connect

  7. 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.

    Página Meshy na barra lateral do dsh com o cartão da conta Meshy, a escolha de site Global e China, Sign in to Meshy, e quatro pedidos de exemplo

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

    Nova sessão do dsh com o pedido de exemplo Photo to 3D preenchido

  • 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.

    Página Meshy com sessão iniciada, mostrando a conta, os créditos, Signed in with Browser, e os botões Sign out e Get credits

  • Pré-visualização 3D: selecione um ficheiro .glb na 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.

ProblemaCausaSolução
Escrever / não lista as skills MeshyA 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 MeshyEstá 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 attentionNã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_KEYO 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 expirouUm 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éditosA 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 grandeA 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 erradaO 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.