troubleshoot-print-issues
О программе
Этот навык Claude диагностирует и исправляет типичные проблемы 3D-печати, такие как плохое сцепление с поверхностью, "волосы" (стрингинг) и коробление, с помощью системного анализа симптомов. Он предназначен для использования, когда печать прерывается в процессе, проявляются дефекты качества или после изменения оборудования/материалов. Навык предоставляет конкретные рекомендации по устранению неполадок как для FDM, так и для SLA принтеров.
Быстрая установка
Claude Code
Рекомендуетсяnpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit 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"
預期: 問題已記錄,含根因與解決方案,加入知識庫。
失敗時: 即便不成功之排查嘗試亦應記錄,以避免重複失敗解法。
驗證清單
- 失敗症狀已記錄,含照片與具體觀察
- 問題已用診斷參考表分類
- 根因已辨識(機械、熱、材料或配置)
- 已依根因類別應用適當修復
- 完整列印前先以測試列印驗證修復
- 解決方案已記錄於問題日誌,含日期、原因與解決
- 環境因素已記錄(溫度、濕度、氣流)
- 材料狀態已檢查(乾燥、無污染、儲存得當)
常見陷阱
- 同時更動多個變數:一次調一參數,否則無從知曉何者修好(或弄糟)
- 忽略潮燈絲:吸濕材料(Nylon、TPU、PETG)吸濕致冒泡、拉絲、附著差—先疑潮燈絲
- 跳過機械檢查:皮帶鬆與磨損零件之問題,任何切片器調整皆無法修復
- 取網路上之溫度:每組印表機/材料皆獨特—永遠跑自己的溫度塔
- 皮帶過緊:過緊 = 軸承提早磨損;目標為吉他弦張力,非鋼纜
- 歸咎切片器:切片器錯誤罕見;95% 之問題為機械、熱或材料相關
- 不清潔噴嘴:部分阻塞致間歇性欠擠出,似流量/e-step 問題
- 假設底床平整:底床久而翹曲、彈簧壓縮、調整滑動—每週重新調平以獲可靠結果
- Z 偏移錯:多數首層失敗為 Z 偏移過高(擠壓不足)或過低(噴嘴刮底床)
- 環境忽視:ABS/ASA 於 15°C 通風車庫永不善印—材料需穩定溫暖環境
相關技能
- prepare-print-model:確保模型妥善準備以避免可印性問題
- select-print-material:選擇適合印表機能力與環境之材料
- Calibrate 3D Printer(未來技能):e-steps、流速、溫度塔、PID 調整與底床網格調平
- Maintain 3D Printer(未來技能):皮帶張緊、軸承潤滑、噴嘴更換與預防性維護
GitHub репозиторий
Похожие навыки
executing-plans
ДизайнИспользуйте навык executing-plans, когда у вас есть полный план реализации для выполнения контролируемыми партиями с контрольными точками проверки. Он загружает и критически анализирует план, затем выполняет задачи небольшими партиями (по умолчанию 3 задачи), сообщая о прогрессе между каждой партией для проверки архитектором. Это обеспечивает систематическую реализацию со встроенными контрольными точками проверки качества.
requesting-code-review
ДизайнЭтот навык запускает суб-агента для ревью кода, который анализирует изменения в коде на соответствие требованиям перед дальнейшими действиями. Его следует использовать после завершения задач, реализации крупных функций или перед слиянием с основной веткой. Ревью помогает выявить проблемы на ранней стадии, сравнивая текущую реализацию с исходным планом.
connect-mcp-server
ДизайнЭтот навык предоставляет разработчикам подробное руководство по подключению серверов MCP к Claude Code с использованием транспортов HTTP, stdio или SSE. Он охватывает установку, конфигурацию, аутентификацию и безопасность для интеграции внешних сервисов, таких как GitHub, Notion и пользовательские API. Используйте его при настройке интеграций MCP, конфигурации внешних инструментов или работе с Model Context Protocol от Claude.
web-cli-teleport
ДизайнЭтот навык помогает разработчикам выбирать между веб-интерфейсом Claude Code и CLI на основе анализа задачи, а также обеспечивает бесшовное перемещение сессий между этими средами. Он оптимизирует рабочий процесс, управляя состоянием и контекстом сессии при переключении между веб-интерфейсом, CLI или мобильным приложением. Используйте его для сложных проектов, требующих различных инструментов на разных этапах работы.
