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

troubleshoot-print-issues

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

정보

이 Claude Skill은 접착 문제, 실타래 현상, 뒤틀림과 같은 일반적인 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%
翹曲附著不良、冷卻過快檢查角落翹起加 brim、密閉印表機、提升底床溫度
欠擠出阻塞、低溫、流量錯檢查擠出一致性清潔噴嘴、升溫 5°C、校準 e-steps
過擠出流速過高、e-steps 錯檢查團塊形成降流量 2-5%、校準 e-steps
象腳首層擠壓、底床過熱量測底寬Z 偏移 +0.05mm、底床降溫 5°C
牆面縫隙牆過薄、欠擠出檢查牆厚啟用薄牆偵測、增流量
層分離低溫、冷卻不佳、污染檢查層線升溫 5-10°C、檢查潮燈絲
團塊/疙瘩回抽、coast 設定檢查接縫對齊調整回抽、啟用 coasting
頂面粗糙頂層不足、缺熨平計算實心頂層加 2 頂層、啟用熨平
懸垂下垂冷卻不足、過熱檢查零件冷卻風扇增冷卻、降溫、加支撐

預期: 失敗已分類至 1-3 個最可能類別。

失敗時: 若症狀對應多個類別,依失敗時機優先排序(先處理首層問題,再中途,再頂面)。

三、執行根因分析

調查根本原因,而非僅症狀:

5 Whys 技巧

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(較慢 = 較佳附著)
  • 加 brim:小底面零件用 8-10mm
  • 加 raft:對極困難材料(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

附著增強

  • 加 brim:角落 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 偏移錯:多數首層失敗為 Z 偏移過高(擠壓不足)或過低(噴嘴刮底床)
  10. 環境忽視:ABS/ASA 於 15°C 通風車庫永不善印—材料需穩定溫暖環境

相關技能

  • prepare-print-model:確保模型妥善準備以避免可印性問題
  • select-print-material:選擇適合印表機能力與環境之材料
  • Calibrate 3D Printer(未來技能):e-steps、流速、溫度塔、PID 調整與底床網格調平
  • Maintain 3D Printer(未來技能):皮帶張緊、軸承潤滑、噴嘴更換與預防性維護

GitHub 저장소

pjt222/agent-almanac
경로: i18n/wenyan-lite/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 또는 모바일 환경 전환 시 세션 상태와 컨텍스트를 관리하여 워크플로를 최적화합니다. 다양한 단계에서 서로 다른 도구가 필요한 복잡한 프로젝트에 사용하세요.

스킬 보기