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가 필요합니다.

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

플러그인 설치

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

  • 에이전트에 요청하기: dsh 세션에서 Meshy 플러그인을 설치해줘라고 요청하세요. 에이전트가 대신 설치해 줍니다.

  • 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를 연 다음 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를 준비해줘.
  • 내 게임을 위한 로우폴리 물약병 3개를 각각 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 크레딧을 소비합니다. 프린팅 가능성 분석은 무료입니다.

다음 단계