fusion-studio은(는) 무엇을 하나요?
Fusion의 MCP 서버에 Python 스크립트를 전송하여 모델링합니다. 사용자는 사진, 측정값 및 취향을 제공합니다. 당신은 모델을 빌드하고, 살펴보고, 수정합니다.
0. 연결 (항상 먼저)
python <skill>/scripts/fusion_mcp.py ping
Fusion 버전과 열려 있는 문서를 출력합니다. fusion_mcp_* MCP 도구가 로드되어 있으면 해당 도구를 사용하고(fusion_mcp_execute with featureType: "script", fusion_mcp_read for screenshots and API docs, fusion_mcp_update for undo), 그렇지 않으면 클라이언트가 셸에서 동일한 작업을 수행합니다. ping이 연결할 수 없으면 사용자에게 Fusion을 시작하고 MCP 서버를 활성화하도록 알리십시오. 추측하지 마십시오.
사용자의 작업을 보호하는 규칙:
- 이미 열려 있는 문서는 절대 편집하지 마십시오.
fx_lib.py의new_design()은 새 문서를 엽니다. 열려 있는 문서는--ro로만 읽으십시오. - 요청하지 않는 한 저장, 닫기 또는 덮어쓰지 마십시오. 내보내기는 프로젝트 폴더로 이동합니다.
run()을 try/except로 감싸지 마십시오. 발생한 오류는 무엇이 실패했는지 배우는 방법입니다.- 명령 대화 상자가 열려 있는 동안 스크립트는 수정할 수 없습니다. 사용자에게 닫도록 요청하거나
--ro를 사용하여 검사하십시오.
1. 모드 선택 (선택기)
한 가지 질문으로 물어보고, 설명에 달리 명시되지 않는 한 Print를 권장합니다. 이 질문에 답변하기 전에 모델링을 시작하지 마십시오.
| 모드 | 용도 | 제작 방식 | 완료 시 파일 |
|---|---|---|---|
| 사용자 프린터로 인쇄할 부품: 홀더, 브래킷, 인클로저, 키체인 | 끼워맞춤 공차, 벽 규칙, 방향, 인쇄 부품당 하나의 컴포넌트 | 부품당 3MF + STEP | |
| Showcase | 인쇄되지 않고 표시되는 항목: 크라우드 펀딩 페이지용 아크릴 키체인, 비디오용 폭발도 | 외관 우선: 레이어드 파트, 실제 재료 두께, 폭발된 레이아웃 | 투명 배경 PNG, OBJ, STEP |
| Apparel | 의류 브랜드 목업: 행택, 라벨, 트리밍, 버튼, 지퍼 풀, 포장재, 디스플레이 조각 | 3D 트리밍 위의 평면 아트워크, 실제 재료 두께 | PNG 뷰, STEP, 아트워크 배치 메모 |
세부 정보: references/modes.md. Print의 경우 필라멘트(PLA, PETG, ABS, ASA, TPU, 나일론, PC 또는 탄소 충전 버전)도 물어보고, 달리 명시되지 않는 한 Bambu Lab H2C를 사용하십시오. 필라멘트는 끼워맞춤과 벽 두께, 오버행 각도, 브리지 길이에 대한 제한을 설정합니다: references/materials.md, references/print-rules.md.
그런 다음 python <skill>/scripts/new_project.py <이름> --mode print|showcase|apparel [--material PETG]를 실행하여 프로젝트 폴더(project.json, build/, shots/, exports/)를 만듭니다.
2. 브리핑 및 측정값
스스로 알아낼 수 없는 것을 물어보십시오: 모델이 맞춰야 할 실제 크기(캔, 전화기, 열쇠), 재료, 벽 스타일 및 참조 사진. 어떤 숫자가 가정되었는지 말하고 project.json의 assumptions 아래에 넣으십시오. 누락된 치수는 명백한 기본값을 가진 명명된 매개변수가 되며, 절대 숨겨진 숫자가 되지 않습니다.
3. 파라미터 우선
측정 가능한 모든 것은 주석이 있는 사용자 파라미터가 되며, 세 그룹으로 나뉩니다: measured(캔 직경), fit(간극, 벽), derived(다른 항목으로 구성된 표현식). Print 모드에서는 먼저 print_profile("PETG")를 호출하십시오: 재료의 fit_press, fit_close, fit_free, min_wall, min_feature 및 hole_comp 파라미터를 생성하며, 끼워맞춤은 지름 방향(양쪽 합계)입니다. 직접 간극을 만들지 말고 이것들을 사용하십시오. 이름은 3자 이상이고 밑줄이 있어야 합니다(can_dia): w, h, t와 같은 단일 문자는 단위 이름과 충돌하여 Fusion이 거부합니다. 스케치 치수 및 돌출 거리는 파라미터 표현식을 사용하므로 하나의 숫자를 변경하면 모델이 변경됩니다. 첫 번째 스크립트를 작성하기 전에 references/fusion-api.md를 읽으십시오.
4. 작은 스크립트로 빌드
--lib로 헬퍼 라이브러리를 추가하십시오:
python <skill>/scripts/fusion_mcp.py run build/01_body.py --lib
python <skill>/scripts/fusion_mcp.py shot shots/01.png --dir iso-top-right
fx_lib.py는 new_design, param, component, sketch, rect, circle, extrude, box, fillet, chamfer, edges_where, appearance, view, health, report, export를 제공하며, Print 모드(fx_print.py)의 경우 print_profile, print_check, fit_coupon을 제공합니다. 물리적 부품당 하나의 컴포넌트로, 이름은 <Part> - PRINT 또는 - SHOWCASE로 지정합니다. 필렛은 마지막에 넣습니다. 다음 단계로 넘어가기 전에 모든 스크린샷을 확인하십시오. 그림과 숫자가 일치하지 않으면 그림을 신뢰하고 버그를 찾으십시오.
API를 모르시겠습니까? fusion_mcp.py api "ExtrudeFeatures" --filter adsk.fusion는 실시간 문서를 반환합니다. 기억보다는 이것을 선호하십시오.
5. 완료했다고 말하기 전에 확인
health()가 0개의 문제를 보고합니다.- 파라메트릭 테스트: 주요 측정 파라미터를 변경하고,
health()와report()를 다시 확인하고, 원래대로 되돌립니다. 여기서 깨지는 모델은 완료된 것이 아닙니다. - 최소 아이소 메트릭, 정면 및 하나의 단면 또는 하단 뷰에서 스크린샷을 찍고, 사용자가 읽습니다.
- Print 모드:
print_check("PETG")(얇은 벽과 오버행, 긴 브리지, 작거나 수평인 구멍, 베드 적합성)를 실행한 다음 방향, 지지대 및 첫 번째 레이어 가장자리를 명시합니다. 모든 WARN을 수정하거나 허용 가능한 이유를 설명하십시오. 중요한 끼워맞춤이 있는 경우 먼저fit_coupon()을 실행하고 인쇄하십시오: 몇 분이 소요되며 이 필라멘트와 프린터의 실제 간극을 설정합니다. - Print 모드: 3MF를 내보내고
python <skill>/scripts/slicer_check.py exports/part.3mf --material PETG를 실행하십시오. H2C 프로파일로 OrcaSlicer를 헤드리스로 구동하고 워터타이트 여부, 인쇄 시간, 필라멘트, 지지대 필요 여부 및 사용자의 방향이 슬라이서의 최적 방향인지 보고합니다. 결과를 모델에 다시 반영하십시오. GUI와 선택적 orcaslicer-mcp 서버는 대안입니다: references/slicer.md. - 입증되지 않은 것이 무엇인지 말하십시오. 올바르게 보이는 모델은 테스트 인쇄되지 않은 것입니다. 첫 번째 테스트 인쇄와 그 후에 조정할 파라미터를 지정하십시오.
6. 내보내기 및 인계
Print: 각 부품에 대해 export(body, path, "3mf") + step. Showcase: 각도별 투명 PNG(shot은 요청 시 투명 배경 사용), 비디오 도구용 OBJ. Apparel: PNG 뷰 및 STEP. 그런 다음 사용자에게 파일, 파라미터 목록, 가정, 실행할 첫 번째 테스트를 제공하십시오.
이 스킬이 하지 않는 일
- 프린터로 작업을 보내거나 온도와 속도를 선택하지 않습니다. 모델을 확인(지지대 필요 여부, 시간, 방향)하기 위해서만 슬라이싱하며, 지지대 선택을 시작점으로 명시합니다.
- 테스트 인쇄를 대체하지 않습니다. 간극은 0.4mm 노즐에 대한 시작 값일 뿐이며 보장되지 않습니다.
- 사용자가 공유하지 않는 한 사용자의 사진을 볼 수 없습니다. 사진에서 추정하기보다는 치수를 물어보십시오.
- 직물을 모델링하지 않습니다. Apparel 모드는 트리밍, 라벨, 태그, 하드웨어 및 포장재를 다룹니다.