Umiejętności Meshy dla Hermes Agent

Dodaj umiejętności Meshy do Hermes Agent, aby Twój agent mógł generować modele 3D, tekstury i animacje oraz przygotowywać wydruki 3D bezpośrednio z czatu.


Przegląd

Meshy udostępnia dwie umiejętności dla Hermes Agent:

  • meshy-3d-generation: Tekst na 3D, Obraz na 3D i Wiele obrazów na 3D, teksturowanie i retekstura za pomocą AI, remesh do zadanego budżetu wielokątów, rozwijanie UV, automatyczne riggowanie i animacja postaci humanoidalnych oraz eksport do GLB, FBX, OBJ, STL lub USDZ.
  • meshy-3d-printing: analiza i naprawa drukowalności, jedno- i wielokolorowy 3MF, dopasowanie do rzeczywistych wymiarów, produkty Creative Lab, takie jak figurki, lampy, breloki i magnesy na lodówkę, a także przekazywanie zadania do zainstalowanego slicera.

Każda umiejętność instaluje się niezależnie, więc możesz dodać tylko umiejętność związaną z drukiem, jeśli tylko jej potrzebujesz. Obie umiejętności uruchamiają CLI Meshy, czyli pakiet meshy-cli z npm. Logujesz się raz w przeglądarce i nie potrzebujesz klucza API.

Umiejętności są open source i znajdują się w repozytorium meshy-3d-agent na GitHubie.


Zanim zaczniesz

  • Potrzebujesz Hermes Agent. Aby pobrać aplikację desktopową dla macOS lub Windows albo uzyskać polecenie instalujące ją z terminala, przejdź na stronę Hermes Agent.

  • Na komputerze, na którym działa Hermes, potrzebujesz Node.js w wersji 22.12 lub nowszej wraz z npm.

  • Aby generować modele, potrzebujesz płatnego planu Meshy. Każde zadanie generowania zużywa kredyty Meshy według stawek API. Koszt każdego zadania znajdziesz w sekcji Cennik. Analiza drukowalności jest bezpłatna, a lokalne kroki druku, takie jak przeskalowanie modelu lub otwarcie go w slicerze, nie wymagają logowania.


Instalacja umiejętności

Aby Hermes sam wykonał konfigurację, wklej poniższy tekst na czacie:

Help me install Meshy CLI and the meshy-3d-agent skills:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

Hermes sprawdza Node.js, instaluje CLI Meshy oraz obie umiejętności, a następnie przeprowadza Cię przez proces logowania.

Aby samodzielnie zainstalować umiejętności, dodaj je z GitHuba za pomocą Hermes:

hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation
hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-printing

Możesz też zainstalować obie umiejętności za pomocą instalatora skills:

npx -y skills add meshy-dev/meshy-3d-agent --skill meshy-3d-generation --skill meshy-3d-printing -g -y -a hermes-agent

Nie musisz wykonywać globalnej instalacji npm install -g meshy-cli. Bez niej umiejętności uruchamiają CLI za pomocą npm exec. Globalna instalacja tylko przyspiesza uruchamianie.

Jeśli Hermes nie korzysta z umiejętności w rozmowie, która była otwarta podczas instalacji, rozpocznij nową sesję.


Logowanie

Przy pierwszej prośbie o model Hermes uruchamia proces logowania CLI Meshy i wysyła Ci link oraz jednorazowy kod.

Aby się zalogować, wykonaj następujące kroki:

  1. Otwórz link na dowolnym urządzeniu.

  2. Jeśli strona poprosi o kod, wpisz go w polu Device code dokładnie tak, jak pokazuje go Hermes, a następnie kliknij Continue.

  3. Jeśli Meshy poprosi o zalogowanie, zaloguj się na swoje konto Meshy.

  4. Na stronie Connect Meshy CLI kliknij Connect. Strona wyświetli komunikat Meshy CLI authorized.

    Strona Connect Meshy CLI z zalogowanym kontem, zakresem dostępu CLI oraz przyciskami Cancel i Connect

  5. Wróć do czatu. Hermes kontynuuje Twoje żądanie.

Kod wygasa po 10 minutach. Jeśli wygaśnie, poproś Hermes o nowy. Logowanie możesz zatwierdzić z dowolnej przeglądarki, więc działa to również wtedy, gdy Hermes działa na serwerze lub przez SSH.

CLI Meshy przechowuje sesję w pliku ~/.config/meshy/credentials.json. Każdy agent uruchomiony jako ten sam użytkownik na danym komputerze współdzieli tę sesję. Jeśli ustawiono zmienną MESHY_API_KEY, CLI używa tego klucza API zamiast sesji przeglądarki.


Przykładowe polecenia

Opisz zadanie własnymi słowami. Na przykład:

  • Stwórz model 3D szczeniaka husky i zapisz go jako GLB w ./assets.
  • Zamień to zdjęcie na teksturowany model 3D i zachowaj jego proporcje. (dołącz obraz)
  • Stwórz trzy butelki z eliksirem w stylu low-poly do mojej gry, każda poniżej 1500 trójkątów.
  • Zrig tę postać humanoidalną, dodaj animację chodu i wyeksportuj ją jako FBX.
  • Pomóż mi wydrukować w 3D małą figurkę smoka, 80 mm wysokości, jako wielokolorowy 3MF.

Kolejne prośby wykorzystują poprzedni wynik, na przykład stwórz LOD z 1500 ścian, teraz jako FBX lub przeskaluj do 150 mm. Aby samodzielnie zatwierdzać każdy płatny krok, dodaj do swojej prośby zapytaj mnie przed wydaniem kredytów.


Rozwiązywanie problemów

Poniższa tabela zawiera listę typowych problemów, ich przyczyn oraz sposobów ich rozwiązania.

ProblemPrzyczynaRozwiązanie
Hermes nie korzysta z umiejętności MeshyHermes nie załadował umiejętności w otwartej rozmowie lub nie dopasował Twojej prośby do nich.Rozpocznij nową sesję lub wspomnij o Meshy w swojej prośbie.
Nie znaleziono node lub npmNode.js nie jest zainstalowany lub Hermes nie może go znaleźć.Zainstaluj Node.js 22.12 lub nowszy ze strony Node.js, a następnie uruchom ponownie Hermes.
Hermes prosi o klucz APIUmiejętności go nie wymagają. Logowanie odbywa się przez przeglądarkę.Odmów i poproś Hermes o zalogowanie przez przeglądarkę. Nigdy nie wklejaj klucza API do czatu.
Kod logowania wygasłKod jest ważny przez 10 minut.Poproś Hermes o ponowne rozpoczęcie logowania.
Hermes nie może generować z powodu Twojego planu lub kredytówGenerowanie wymaga płatnego planu i wystarczającej liczby kredytów.Sprawdź swój plan i saldo na stronie Subscription w aplikacji webowej Meshy.
Jesteś zalogowany na niewłaściwe konto MeshyCLI Meshy ponownie wykorzystuje sesję zapisaną na Twoim komputerze.Poproś Hermes o uruchomienie meshy auth logout, a następnie zaloguj się ponownie.

FAQ

Jak dodać Meshy do Hermes Agent?
Poproś Hermes o wykonanie instrukcji z https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, albo uruchom hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation oraz analogiczne polecenie dla meshy-3d-printing. Potrzebujesz też Node.js 22.12 lub nowszego wraz z npm.
Czy potrzebuję klucza API Meshy?
Nie. Umiejętności logują się przez przeglądarkę za pomocą jednorazowego kodu, a CLI Meshy przechowuje sesję. Jeśli w Twoim środowisku jest już ustawiona zmienna MESHY_API_KEY, CLI Meshy używa jej zamiast tego.
Czy mogę zainstalować tylko umiejętność druku 3D?
Tak. meshy-3d-printing instaluje się i działa niezależnie, w tym kroki generowania potrzebne do wydruku.
Czy to działa, gdy Hermes uruchomiony jest na zdalnym serwerze?
Tak. Logowanie pokazuje link i kod, które możesz zatwierdzić z dowolnej przeglądarki.
Czy to te same umiejętności, co w wtyczce Codex?
Tak. Wtyczka Codex, Claude Code, Cursor oraz Hermes Agent korzystają z meshy-3d-generation i meshy-3d-printing z otwartoźródłowego repozytorium meshy-3d-agent.
Czy to jest darmowe?
Umiejętności są darmowe i open source. Generowanie modeli 3D wymaga płatnego planu Meshy i zużywa kredyty Meshy według stawek API. Analiza drukowalności jest bezpłatna.