DeepSeek Harness용 Meshy 플러그인

DeepSeek Harness에 Meshy 플러그인을 설치하면 채팅에서 3D 모델, 텍스처, 애니메이션을 생성하고 3D 프린트를 준비할 수 있습니다.


개요

Meshy 플러그인은 DeepSeek Harness(dsh)에 두 가지 스킬을 추가합니다:

  • meshy-3d-generation: 텍스트로 3D, 이미지로 3D, 멀티 이미지로 3D, AI 텍스처링 및 리텍스처링, 폴리곤 예산에 맞춘 리메시, UV 언래핑, 휴머노이드 캐릭터용 오토 리깅 및 애니메이션, 그리고 GLB, FBX, OBJ, STL 또는 USDZ로의 내보내기를 지원합니다.
  • meshy-3d-printing: 프린팅 가능성 분석 및 복구, 단색 및 다색 3MF, 실제 치수에 맞춘 크기 조정, 피규어·램프·키링·냉장고 자석 등 Creative Lab 제품, 설치된 슬라이서로의 전달을 지원합니다.

이 플러그인에는 npm의 meshy-cli 패키지인 Meshy CLI가 포함되어 있습니다. 스킬이 이를 실행하여 프로젝트에 파일을 저장합니다. 브라우저에서 한 번만 로그인하면 되며, API 키는 필요하지 않습니다.

dsh Web과 Desktop에서는 플러그인이 사이드바에 Meshy 페이지, Meshy 설정 페이지, GLB 파일용 3D 미리보기도 추가합니다.

이 플러그인은 npm의 meshy-dsh 패키지이며, dsh는 이를 Plugins 아래에 Meshy로 표시합니다. 이 플러그인은 GitHub의 meshy-dsh 저장소에서 오픈 소스로 제공되며, 스킬은 meshy-3d-agent 저장소에서 가져옵니다.


시작하기 전에

  • DeepSeek Harness가 필요합니다. macOS 또는 Windows용 데스크톱 앱을 다운로드하려면 DeepSeek Harness 페이지로 이동하세요. 대신 dsh Web을 실행하려면 Node.js를 설치한 다음 npx @deepseek-ai/dsh web을 실행하세요.

  • 모델을 생성하려면 유료 Meshy 플랜이 필요합니다. 모든 생성 작업은 API 요율에 따라 Meshy 크레딧을 소비합니다. 각 작업의 비용은 요금을 참고하세요. 프린팅 가능성 분석은 무료이며, 모델 크기 재조정이나 슬라이서에서 열기 같은 로컬 프린트 단계에는 로그인이 필요하지 않습니다.


플러그인 설치

다음 방법 중 하나로 플러그인을 설치할 수 있습니다:

  • 에이전트에게 요청: dsh 세션에서 Install the Meshy plugin이라고 요청하세요. 에이전트가 대신 설치해 줍니다.

  • Plugins 페이지: dsh에서 Plugins를 열고 Add plugin을 선택한 다음 meshy-dsh를 입력하세요. 중국 본토에서는 Mainland China mirror 레지스트리를 선택하세요.

  • 명령줄: 다음 명령을 실행하세요. GitHub에서 설치하려면 대신 github:meshy-dev/meshy-dsh를 사용하세요.

    dsh plugin --profile web add meshy-dsh
    

    dsh는 프로필별로 플러그인을 설치합니다. 플러그인을 desktop이나 tui 같은 다른 프로필에 설치하려면 web을 해당 프로필 이름으로 바꾸세요.

설치를 확인하려면 dsh에서 Plugins를 여세요. Meshy 플러그인이 목록에 표시되고 실행 중인 상태여야 합니다. 그런 다음 새 세션을 시작하고 /를 입력하세요. 목록에 meshy-3d-generation과 meshy-3d-printing이 표시됩니다. dsh는 설치 후에 시작한 세션에서만 스킬을 로드합니다.

플러그인에 Meshy CLI가 포함되어 있으므로 다른 것을 추가로 설치할 필요는 없습니다.


로그인

한 번만 로그인하면 새 세션이든 기존 세션이든 모든 세션에서 해당 로그인을 사용합니다. dsh Web과 Desktop에서는 Meshy 페이지 또는 Settings > Meshy에서 로그인할 수 있습니다. 채팅에서는 처음 모델을 요청할 때 에이전트가 링크와 코드를 보여줍니다.

Meshy 페이지에서 로그인하려면 다음 단계를 따르세요:

  1. dsh 사이드바에서 Meshy를 선택하세요.

  2. Site 아래에서 Global · meshy.ai를 선택하세요. 중국 본토에서는 China · meshy.cn을 선택하세요. 두 사이트 모두 동일한 Meshy 계정과 동일한 크레딧을 사용합니다.

  3. Sign in to Meshy를 클릭하세요. 페이지에 QR 코드, 링크, 코드가 표시됩니다.

    QR 코드, 로그인 코드, Open in browser, Waiting for your approval이 표시된 dsh의 Meshy 페이지

  4. 휴대폰으로 QR 코드를 스캔하거나 Open in browser를 클릭하세요.

  5. Meshy가 로그인을 요청하면 Meshy 계정으로 로그인하세요.

  6. Connect Meshy CLI 페이지에서 코드가 dsh에 표시된 코드와 일치하는지 확인한 다음 Connect를 클릭하세요.

    로그인된 계정, 확인할 코드, Cancel 및 Connect 버튼이 있는 Connect Meshy CLI 페이지

  7. dsh로 돌아가세요. 페이지가 자동으로 완료되고 Signed in이 표시됩니다.

코드는 10분 후 만료됩니다. 만료되면 로그인을 다시 시작하세요.

이 로그인은 Meshy CLI 고유의 로그인이며, 이를 암호화하는 키는 운영 체제가 보관하므로 터미널의 meshy도 동일한 로그인을 사용합니다. dsh는 내보낸 MESHY_API_KEY를 에이전트의 셸에 노출하지 않으며 플러그인도 이를 전달하지 않으므로, 브라우저를 통해 로그인하세요.


Meshy 페이지와 3D 미리보기

dsh Web과 Desktop은 다음과 같은 Meshy 페이지를 보여줍니다. dsh tui와 헤드리스 모드에서는 이 페이지들이 표시되지 않지만, 스킬은 동일하게 작동합니다.

  • Meshy 페이지: 왼쪽 사이드바에서 Meshy를 선택하세요. 페이지에 Meshy 계정과 Start creating 아래 네 가지 예시 요청이 표시됩니다.

    Meshy 계정 카드, Global 및 China 사이트 선택, Sign in to Meshy, 네 가지 예시 요청이 있는 dsh 사이드바의 Meshy 페이지

    예시를 선택하면 해당 요청이 채워진 새 세션이 시작됩니다. 보내기 전에 요청을 편집할 수 있습니다.

    Photo to 3D 예시 요청이 채워진 새 dsh 세션

  • Settings 페이지: Settings를 연 다음 Meshy를 선택하세요. Plugins 아래 Meshy 플러그인에서도 이 페이지를 열 수 있습니다. 로그인된 상태라면 페이지에 계정, 크레딧, 로그인 방식(브라우저 또는 API 키), 사이트, Meshy CLI 버전이 표시됩니다. 이 페이지에서 로그아웃하거나 크레딧을 더 받을 수 있습니다. China 사이트는 아직 계정 이름을 표시하지 않습니다.

    계정, 크레딧, Signed in with Browser, Sign out 및 Get credits 버튼이 표시된 로그인된 Meshy 페이지

  • 3D 미리보기: 오른쪽 사이드바에서 .glb 파일을 선택하거나 에이전트가 제공한 모델의 카드를 선택하세요. 미리보기는 파일 크기와 삼각형 수와 함께 모델을 3D로 보여줍니다. 드래그하면 회전하고, 스크롤하면 확대/축소하며, 버튼을 사용해 뷰를 재설정하거나 모델을 돌릴 수 있습니다. 미리보기는 최대 256MB까지 모델을 엽니다.


예시 프롬프트

원하는 작업을 자신의 말로 설명하세요. 예를 들면:

  • 게임에 쓸 로우폴리 만화풍 보물 상자를 만들고 GLB로 내보내 줘.
  • 첨부한 사진을 텍스처가 있는 3D 모델로 바꿔 줘. (이미지 첨부)
  • 만화풍 기사를 만들고, 리깅한 다음 걷기 애니메이션을 추가하고 FBX로 내보내 줘.
  • 10cm 높이의 시바견 피규어를 만들고 프린트 준비가 된 3MF를 만들어 줘.
  • 게임에 쓸 로우폴리 물약 병 세 개를 만들어 줘, 각각 1,500 삼각형 이하로.

후속 요청은 이전 결과를 재사용합니다. 예를 들어 1,500면 LOD로 만들어 줘, 이제 FBX로, 또는 150mm로 크기 조정해 줘 등입니다. 에이전트는 크레딧을 소비하기 전에 비용을 알려주고 확인을 기다립니다.


문제 해결

다음 표는 흔히 발생하는 문제, 원인, 해결 방법을 정리한 것입니다.

문제원인해결 방법
/를 입력해도 Meshy 스킬이 목록에 표시되지 않음세션이 설치 전에 시작되었거나, 플러그인을 다른 프로필에 설치했습니다.새 세션을 시작하세요. 그래도 스킬이 없다면 실제로 사용하는 프로필에 플러그인을 설치하세요. 예: dsh plugin --profile desktop add meshy-dsh.
사이드바에 Meshy 항목이 없음Meshy 페이지가 없는 dsh tui 또는 헤드리스 모드를 사용 중입니다.dsh Web 또는 Desktop을 사용하세요. 스킬은 모든 모드에서 작동합니다.
Meshy 페이지에 Needs attention이 표시됨저장된 로그인을 확인할 수 없습니다.새로고침 아이콘을 클릭하세요. 메시지가 계속 표시되면 로그아웃 후 다시 로그인하세요.
Meshy CLI가 MESHY_API_KEY를 사용하지 않음dsh는 에이전트의 셸에 자격 증명 변수를 노출하지 않습니다.브라우저를 통해 로그인하세요. 채팅에 API 키를 절대 붙여넣지 마세요.
로그인 코드가 만료됨코드는 10분 동안 유효합니다.로그인을 다시 시작하거나 에이전트에게 새 코드를 요청하세요.
플랜 또는 크레딧 문제로 에이전트가 생성할 수 없음생성하려면 유료 플랜과 충분한 크레딧이 필요합니다.Meshy 웹 앱의 Subscription 페이지에서 플랜과 잔액을 확인하세요.
3D 미리보기에 모델이 너무 크다고 표시됨미리보기는 최대 256MB까지 모델을 엽니다.에이전트에게 모델을 더 적은 면으로 리메시해 달라고 요청한 다음 다시 여세요.
잘못된 Meshy 계정으로 로그인되어 있음플러그인은 마지막으로 수행한 로그인을 유지합니다.Meshy 페이지에서 Sign out을 클릭한 다음 다시 로그인하세요.

FAQ

DeepSeek Harness에 Meshy를 어떻게 추가하나요?
에이전트에게 Meshy 플러그인을 설치해 달라고 요청하거나, Plugins > Add plugin 아래에서 meshy-dsh를 추가하거나, dsh plugin --profile web add meshy-dsh를 실행하세요. 그런 다음 새 세션을 시작하세요.
Meshy API 키가 필요한가요?
아니요. 브라우저를 통해 한 번만 로그인하면 모든 dsh 세션이 해당 로그인을 사용합니다. dsh는 내보낸 MESHY_API_KEY를 에이전트에 전달하지 않습니다.
Node.js나 Meshy CLI를 설치해야 하나요?
아니요. 플러그인에 Meshy CLI가 포함되어 있어 스킬을 위해 직접 실행합니다.
dsh tui에서도 작동하나요?
네. 스킬은 모든 dsh 모드에서 작동합니다. Meshy 페이지, 설정 페이지, 3D 미리보기는 dsh Web과 Desktop에서만 제공됩니다.
중국 본토에서도 사용할 수 있나요?
네. 로그인할 때 China · meshy.cn을 선택하세요. 동일한 Meshy 계정과 동일한 크레딧을 사용하며, 이후 요청은 China 사이트로 전송됩니다.
이것은 Codex 플러그인과 같은 스킬인가요?
네. Codex, Claude Code, Cursor, OpenClaw, Hermes Agent, DeepSeek Harness용 플러그인은 모두 오픈 소스 meshy-3d-agent 저장소의 meshy-3d-generation과 meshy-3d-printing을 사용합니다.
무료인가요?
플러그인은 무료이며 오픈 소스입니다. 3D 모델을 생성하려면 유료 Meshy 플랜이 필요하며 API 요율에 따라 Meshy 크레딧을 소비합니다. 프린팅 가능성 분석은 무료입니다.