MCP HubMCP Hub
스킬 목록으로 돌아가기

troubleshoot-print-issues

pjt222
업데이트됨 6 days ago
18 조회
17
2
17
GitHub에서 보기
디자인ai

정보

이 스킬은 체계적인 증상 분석을 통해 접착 문제, 실타래 현상, 뒤틀림 같은 일반적인 3D 프린팅 실패를 진단하고 수정합니다. 이는 출력 과정 중 실패가 발생하거나, 품질 결함이 나타나거나, 하드웨어/재료 변경 후에 사용하도록 설계되었습니다. 이 도구는 FDM 및 SLA 프린터를 위한 구조화된 "증상 → 원인 → 해결" 방법론을 제공합니다.

빠른 설치

Claude Code

추천
기본
npx skills add pjt222/agent-almanac -a claude-code
플러그인 명령대체
/plugin add https://github.com/pjt222/agent-almanac
Git 클론대체
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/troubleshoot-print-issues

Claude Code에서 이 명령을 복사하여 붙여넣어 스킬을 설치하세요

문서

排印疾

按徵診 3D 印之常敗、修之。涵 FDM、SLA:附敗、絲、層移、翹、欠擠、過擠、印疵。法為徵→因→修。

  • 印於首層或中敗→用
  • 印成而疵(絲、瘤、隙、表糙)→用
  • 尺誤(過大/小、翹、象足)→用
  • 層黏疾(剝、裂)→用
  • 支拆損或印中支敗→用
  • 印與切片預示異→用
  • 料行不一→用
  • 新料、新機、新環致疾→用

  • failure_description:何敗(首層、絲、翹)
  • failure_timing:何時(首、中、特高、頂)
  • material:絲/樹型、牌、齡、藏況
  • printer:機型、嘴徑、床、罩
  • recent_changes:新料、切片設、硬改、環
  • print_history:此模常成乎?此料前成乎?

一:集敗徵

具體錄可察徵:

目察

  • 攝敗影(全、近、特疵)
  • 記敗位(首層、特高、頂)
  • 述疵類:隙、瘤、絲、移、裂

環數

  • 印時室溫
  • 濕度
  • 風或冷氣擾機
  • 時辰(溫變)

印參

# Extract from G-code metadata
grep "^;MAXX\|^;MINX\|^;MAXZ" failed_print.gcode  # Print dimensions
grep "^;PRINT_TIME:" failed_print.gcode  # Estimated time
grep "^M104\|^M140" failed_print.gcode | head -5  # Temperatures
grep "^;generated by" failed_print.gcode  # Slicer version

得:詳徵附影、參、環。

敗:徵不明→印校驗(溫塔、絲試、benchy)以系統復現。

二:按徵分類

合徵於常敗式:

診表

速察速修
黏床差床污、溫誤、Z 過高拭床、平床清床、Z 偏移下 0.05mm
過熱、抽不足察嘴溫降 5°C、增抽 +0.5mm
層移帶鬆、過速、撞察帶緊緊帶、減速 20%
黏差、冷快察角抬加邊、罩機、增床溫
欠擠塞、低溫、流誤察擠均清嘴、增 5°C、校 e-steps
過擠流高、e-steps 誤察瘤生減流 2-5%、校 e-steps
象足首層壓、床過熱量底寬升 Z 偏移 +0.05mm、降床 5°C
壁隙壁薄、欠擠察壁厚啟薄壁辨、增流
層剝低溫、冷差、污察層紋增 5-10°C、察料濕
瘤/痘抽、滑設察縫對調抽、啟滑
頂糙頂層少、無熨數頂實層加 2 頂層、啟熨
垂懸冷不足、過熱察件冷扇增冷、降溫、加支

得:敗歸 1-3 類。

敗:多類合→按時序排(首層先、中次、頂後)。

三:根因析

察底因,非僅徵:

五問法

Symptom: Print warping and lifting from bed
Why? → Poor bed adhesion in corners
Why? → Corners cooling faster than center
Why? → Room draft from AC vent
Why? → No enclosure to maintain stable temperature
Why? → ABS requires heated chamber for uniform cooling

Root cause: Material choice (ABS) incompatible with open printer in drafty room

常根因按類

  • 帶、輪、止釘鬆
  • 軸承/軌污磨
  • Z 軸澀或失正
  • 擠輪磨或滑

  • 溫感漂或敗
  • 床功不足
  • 件冷不足
  • 環溫變

  • 濕絲(吸濕料)
  • 老絲
  • 污絲(塵、油)
  • 用誤

  • e-steps 校誤
  • 流乘誤
  • 切片病或檔誤
  • 韌速/震過高

得:根因辨明、有證(溫、帶緊、目察)。

敗:根因不明→消去法:先修最可能、復試、迭至解。

四:施一階修

黏床差

速修

# 1. Clean bed thoroughly
# Glass/PEI: Isopropyl alcohol 90%+
# BuildTak: Warm water and dish soap

# 2. Level bed (paper test at 4 corners + center)
# Paper should drag slightly

# 3. Adjust Z-offset down (squish first layer more)
# Start: -0.05mm increments until lines fuse

# 4. Increase bed temperature +5°C

# 5. Add adhesion aid:
# - Glue stick (PLA/PETG)
# - Hairspray (ABS)
# - ABS juice (ABS) - ABS dissolved in acetone
# - Magigoo/3D printing adhesive

切片設

  • 首層高:0.2-0.3mm(厚→壓佳)
  • 首層速:20mm/s(緩→黏佳)
  • 加邊:8-10mm 於小底件
  • 加筏:難料(TPU、Nylon)

得:首層全黏無抬。

敗:以塞尺或網平驗床平;床翹須玻/PEI 板或網補。

先溫法

1. Print temperature tower (180-220°C in 5° steps for PLA)
2. Identify lowest temperature that extrudes cleanly
3. Use that temperature -5°C to minimize stringing

抽調

# Direct drive extruder:
retraction_distance: 1.0-2.0mm
retraction_speed: 40-50mm/s

# Bowden extruder:
retraction_distance: 4.0-6.0mm
retraction_speed: 40-60mm/s

# If stringing persists:
- Enable z-hop: 0.2-0.4mm (lifts nozzle during travel)
- Reduce travel speed (paradoxically helps)
- Enable combing mode (travels within infill)

得:絲微,可手除細絲。

敗:察嘴半塞或料濕(皆致溢)。

層移

機察

# 1. Check belt tension (should twang like guitar string)
# Tighten if loose

# 2. Check pulley set screws (motor shafts)
# Must align with flat on motor shaft

# 3. Check for mechanical resistance
# Manually move X/Y axes - should glide smoothly
# Binding indicates dirty rods, worn bearings, or misalignment

# 4. Check stepper motor current (advanced)
# Too low → skipping; too high → overheating

降速

# Reduce these speeds:
perimeter_speed: 40mm/s (from 50)
travel_speed: 120mm/s (from 150)
acceleration: 500mm/s² (from 1000)
jerk: 8mm/s (from 15)

得:緊帶、降速後重印無移。

敗:察切片致撞(冷扇撞模)或電疾(驅過熱)。

熱管

# Increase bed temperature:
PLA: 60°C → 65°C
PETG: 80°C → 85°C
ABS: 100°C → 110°C

# Disable/reduce part cooling:
first_layer_fan: 0%
regular_fan: 25% max (ABS), 50% (PETG), 100% (PLA)

# Enclose printer (critical for ABS/ASA):
- Cardboard box (temporary)
- Acrylic panels (permanent)
- Target chamber temp: 40-50°C

增黏

  • 加邊:10-15mm 於角
  • 加「鼠耳」:15mm 圓於利角
  • 模底斜邊(45° × 1mm 除應力集中)

得:件平、無抬角。

敗:料於機本不宜(無罩印 ABS)→改 PETG 或 ASA。

欠擠

速修

# 1. Check for nozzle clog
# Heat to print temp, manually push filament
# Should extrude smoothly

# 2. Cold pull cleaning (if partial clog)
# Heat to 220°C, push cleaning filament through
# Cool to 90°C, pull sharply - should remove debris

# 3. Increase temperature +5-10°C
# Higher temp = better flow

# 4. Increase flow rate 2-5%
# Slicer: Filament settings → Flow → 102-105%

E-steps 校

# 1. Mark filament 120mm above extruder
# 2. Extrude 100mm: G1 E100 F100
# 3. Measure remaining distance to mark
# 4. Calculate: new_steps = current_steps × (100 / actual_extruded)
# 5. Set: M92 E<new_steps>; M500 (save to EEPROM)

得:擠均、壁與填無隙。

敗:察熱漂(冷扇敗)、擠輪磨、擠臂裂。

過擠

減流

# Reduce flow in 2% increments:
extrusion_multiplier: 0.98 → 0.96 → 0.94

# Signs of correct flow:
- Smooth top surface (not overstuffed)
- Perimeters don't bulge outward
- Infill doesn't overfill and push layers apart

尺驗

# Print 20mm calibration cube
# Measure with calipers:
# X/Y dimensions should be 20.0mm ± 0.1mm
# If consistently oversized → reduce flow
# If undersized → increase flow

得:尺準、表平、無凸。

敗:重校 e-steps(或設過高)。

五:以試印驗修

未全印前確認解:

試印擇

  • 黏疾:20mm 方 × 5 層(速首層試)
  • :絲試模(雙塔附移)
  • 層移:高瘦試(壓機系)
  • :大平面(200mm × 200mm × 0.4mm)
  • :20mm 校方(尺準)

得:試印成、疾解。

敗:試印敗→未全解或多疾並存→重診於餘徵。

六:錄解

錄成修以備來考:

疾錄式

date: 2026-02-16
issue: "Layer shifts at 50mm height"
symptoms: "X-axis shifts 10mm, happens consistently at same height"
printer: "Ender 3 V2"
material: "PETG, PolyMaker PolyLite"
root_cause: "Loose X-axis belt, pulley set screw not on flat"
solution:
  - "Tightened X-axis belt to 120Hz resonance"
  - "Realigned pulley set screw on motor shaft flat"
  - "Reduced print speed to 40mm/s perimeter"
verification: "Printed 100mm test cylinder - no shifts"
notes: "Check belt tension monthly, pulley tends to slip"

得:疾、根因、解皆錄入庫。

敗:不成之嘗試亦錄,免重蹈。

  • 敗徵附影與具察錄
  • 用診表分類
  • 根因辨明(機、熱、料、設)
  • 按根因施修
  • 全印前以試印驗
  • 解錄於疾錄附日、因、解
  • 環因錄(溫、濕、風)
  • 料況察(乾、無污、藏正)

  1. 多變並改:一參一改;否則不知何修
  2. 忽濕絲:吸濕料(Nylon、TPU、PETG)吸水致泡、絲、黏差→必先疑
  3. 略機察:帶鬆、件磨之疾,切片無計可施
  4. 網上溫:每機料合獨特→必行己之溫塔
  5. 帶過緊:→承過磨;如琴弦緊,非鋼纜
  6. 怪切片:切片病鮮;95% 為機、熱、料因
  7. 不清嘴:半塞致欠擠似流/e-step 疾
  8. 假床平:床久翹、簧壓、調滑→週重平
  9. Z 偏移誤:首層敗多為過高(壓不足)或過低(嘴刮床)
  10. 忽環:ABS/ASA 於 15°C 風車庫永不成→料須穩暖境

  • prepare-print-model:模備正以免印疾
  • select-print-material:擇料合機與境
  • 校 3D 印機(未來):e-steps、流、溫塔、PID 調、床網平
  • 養 3D 印機(未來):帶緊、軸潤、嘴換、預養

GitHub 저장소

pjt222/agent-almanac
경로: i18n/wenyan-ultra/skills/troubleshoot-print-issues
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

연관 스킬

executing-plans

디자인

executing-plans 스킬은 검토 체크포인트가 포함된 통제된 배치로 실행할 완전한 구현 계획이 있을 때 사용합니다. 이 스킬은 계획을 불러와 비판적으로 검토한 후, 소규모 배치(기본값 3개 작업)로 작업을 실행하면서 각 배치 사이에 진행 상황을 아키텍트 검토를 위해 보고합니다. 이를 통해 내재된 품질 관리 체크포인트를 갖춘 체계적인 구현이 보장됩니다.

스킬 보기

requesting-code-review

디자인

이 스킬은 코드 변경 사항을 요구 사항에 따라 분석하기 위해 코드 리뷰어 하위 에이전트를 호출합니다. 작업 완료 후, 주요 기능 구현 후, 또는 메인 브랜치에 병합하기 전에 사용해야 합니다. 이 리뷰는 현재 구현체와 원래 계획을 비교하여 문제를 조기에 발견하는 데 도움이 됩니다.

스킬 보기

connect-mcp-server

디자인

이 스킬은 개발자들이 HTTP, stdio 또는 SSE 전송 방식을 통해 MCP 서버를 Claude Code에 연결하는 포괄적인 가이드를 제공합니다. GitHub, Notion 및 사용자 정의 API와 같은 외부 서비스를 통합하기 위한 설치, 구성, 인증 및 보안을 다룹니다. MCP 통합 설정, 외부 도구 구성 또는 Claude의 모델 컨텍스트 프로토콜 작업 시 활용하세요.

스킬 보기

web-cli-teleport

디자인

이 스킬은 작업 분석을 기반으로 개발자가 Claude Code 웹 인터페이스와 CLI 인터페이스 중 선택할 수 있도록 돕고, 두 환경 간 원활한 세션 텔레포트를 가능하게 합니다. 웹, CLI 또는 모바일 환경 전환 시 세션 상태와 컨텍스트를 관리하여 워크플로를 최적화합니다. 다양한 단계에서 서로 다른 도구가 필요한 복잡한 프로젝트에 사용하세요.

스킬 보기