Plugin Meshy para 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 um chat.


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 de UV, auto-rigging e animação para personagens humanoides, e exportação para GLB, FBX, OBJ, STL ou USDZ.
  • meshy-3d-printing: análise e reparo de imprimibilidade, 3MF de cor única e multicolorido, ajuste de tamanho para dimensões reais, produtos do Creative Lab como estatuetas, luminárias, chaveiros e ímãs de geladeira, e transferência para um fatiador instalado.

O plugin inclui o Meshy CLI, que é o pacote meshy-cli no npm. As skills o executam e salvam os arquivos no seu projeto. Você entra 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 configurações Meshy e uma pré-visualização 3D para arquivos GLB.

O plugin é o pacote meshy-dsh no npm, e o dsh o exibe como Meshy em Plugins. O plugin é open source no repositório meshy-dsh no GitHub, e as skills vêm do repositório meshy-3d-agent.


Antes de começar

  • Você precisa do DeepSeek Harness.

  • Para gerar modelos, você precisa de um plano Meshy pago. Toda 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 as etapas locais de impressão, como redimensionar um modelo ou abri-lo em um fatiador, não exigem login.


Instalar o plugin

Você pode instalar o plugin de qualquer uma das seguintes formas:

  • Pergunte ao agente: em uma sessão do dsh, pergunte Instale o plugin Meshy. O agente o instala para você.

  • Página de Plugins: no dsh, abra Plugins, selecione Add plugin e digite meshy-dsh. Na China continental, escolha o registro Mainland China mirror.

  • Linha de comando: execute o comando a seguir. 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 em outro 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 digite /. A lista mostra meshy-3d-generation e meshy-3d-printing. O dsh carrega as skills apenas em sessões iniciadas após a instalação.

O plugin inclui o Meshy CLI, então você não precisa instalar mais nada.


Entrar

Você entra uma vez, e toda sessão, nova ou antiga, usa esse login. No dsh Web e Desktop, você pode entrar pela página Meshy ou por Settings > Meshy. Em um chat, o agente mostra um link e um código na primeira vez que você solicitar um modelo.

Para entrar pela página Meshy, siga estas etapas:

  1. Na barra lateral do dsh, selecione Meshy.

  2. Em Site, escolha Global · meshy.ai. Na China continental, escolha China · meshy.cn. Você usa 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 login, Open in browser e Waiting for your approval

  4. Escaneie o código QR com seu celular ou clique em Open in browser.

  5. Se o Meshy pedir para você entrar, faça login na sua conta Meshy.

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

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

  7. Volte ao dsh. A página finaliza sozinha e mostra Signed in.

O código expira após 10 minutos. Se expirar, inicie o login novamente.

O login é do próprio Meshy CLI, e seu sistema operacional mantém a chave que o criptografa, então o meshy no seu terminal usa o mesmo login. O dsh mantém um MESHY_API_KEY exportado fora do shell do agente, e o plugin não o repassa, então entre pelo seu navegador.


Página Meshy e pré-visualização 3D

O dsh Web e Desktop exibem as seguintes páginas Meshy. O dsh tui e o modo headless não as exibem, mas as skills funcionam da mesma forma.

  • Página Meshy: selecione Meshy na barra lateral esquerda. A página mostra sua conta Meshy e quatro solicitações de exemplo em Start creating.

    Página Meshy na barra lateral do dsh com o card da conta Meshy, a escolha de site Global e China, Sign in to Meshy, e quatro solicitações de exemplo

    Selecione um exemplo para iniciar uma nova sessão com a solicitação já preenchida. Você pode editar a solicitação antes de enviá-la.

    Nova sessão do dsh com a solicitação de exemplo Photo to 3D preenchida

  • Página de configurações: abra Settings e, em seguida, selecione Meshy. Você também pode abrir a página a partir do plugin Meshy em Plugins. Quando estiver conectado, a página mostra sua conta, seus créditos, como você entrou (navegador ou chave de API), o site e a versão do Meshy CLI. Nessa página, você pode sair ou obter mais créditos. O site da China ainda não exibe o nome da conta.

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

  • Pré-visualização 3D: selecione um arquivo .glb na barra lateral direita, ou selecione o card de um modelo entregue pelo agente. A pré-visualização mostra o modelo em 3D com seu tamanho de arquivo e contagem de triângulos. Arraste para orbitar, role para dar zoom e use os botões para redefinir a visualização ou girar o modelo. A pré-visualização abre modelos de até 256 MB.


Exemplos de prompts

Descreva a tarefa com suas próprias palavras. Por exemplo:

  • Crie um baú do tesouro cartoon low-poly para o meu jogo e exporte como GLB.
  • Transforme a foto que anexei em um modelo 3D texturizado. (anexe a imagem)
  • Crie um cavaleiro cartoon, faça o rigging, adicione uma animação de caminhada e exporte em FBX.
  • Crie uma estatueta de shiba inu de 10 cm de altura e prepare um 3MF pronto para impressão.
  • Crie três frascos de poção low-poly para o meu jogo, cada um com menos de 1.500 triângulos.

As solicitações de acompanhamento reutilizam o resultado anterior, por exemplo crie um LOD de 1.500 faces, agora em FBX, ou redimensione para 150 mm. Antes de gastar créditos, o agente informa o custo e aguarda sua confirmação.


Solução de problemas

A tabela a seguir lista problemas comuns, suas causas e como corrigi-los.

ProblemaCausaCorreção
Digitar / não lista as skills MeshyA sessão começou antes da instalação, ou você instalou o plugin em um perfil diferente.Inicie uma nova sessão. Se as skills ainda estiverem ausentes, instale o plugin no perfil que você usa, por exemplo dsh plugin --profile desktop add meshy-dsh.
A barra lateral não tem entrada MeshyVocê está usando o dsh tui ou o modo headless, que não têm páginas Meshy.Use o dsh Web ou Desktop. As skills funcionam em todos os modos.
A página Meshy mostra Needs attentionO login salvo não pôde ser verificado.Clique no ícone de atualizar. Se a mensagem persistir, saia e entre novamente.
O Meshy CLI não usa sua MESHY_API_KEYO dsh mantém variáveis de credenciais fora do shell do agente.Entre pelo seu navegador. Nunca cole uma chave de API em um chat.
O código de login expirouUm código é válido por 10 minutos.Inicie o login novamente, ou peça ao agente um novo código.
O agente não consegue gerar por causa do seu plano ou créditosA geração exige um plano pago e créditos suficientes.Verifique seu plano e saldo na página Subscription no aplicativo web Meshy.
A pré-visualização 3D diz que o modelo é muito grandeA pré-visualização abre modelos de até 256 MB.Peça ao agente para fazer remesh do modelo para menos faces e abra-o novamente.
Você está conectado à conta Meshy erradaO plugin mantém o último login que você fez.Na página Meshy, clique em Sign out e entre novamente.

FAQ

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. Em seguida, inicie uma nova sessão.
Preciso de uma chave de API Meshy?
Não. Você entra pelo seu navegador uma vez, e toda sessão do dsh usa esse login. O dsh não repassa um MESHY_API_KEY exportado ao agente.
Preciso instalar o Node.js ou o Meshy CLI?
Não. O plugin inclui o Meshy CLI e o executa 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 configurações e a pré-visualização 3D estão apenas no dsh Web e Desktop.
Posso usar na China continental?
Sim. Escolha China · meshy.cn ao entrar. Você usa a mesma conta Meshy e os mesmos créditos, e as solicitações seguintes vão 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 usam todos meshy-3d-generation e meshy-3d-printing do repositório open source meshy-3d-agent.
É gratuito?
O plugin é gratuito e open source. Gerar modelos 3D exige um plano Meshy pago e gasta créditos Meshy às taxas da API. A análise de imprimibilidade é gratuita.