MCP HubMCP Hub
Retour aux compétences

troubleshoot-print-issues

pjt222
Mis à jour 5 days ago
9 vues
17
2
17
Voir sur GitHub
Designai

À propos

Cette Compétence Claude diagnostique et corrige les défaillances courantes de l'impression 3D, telles que les problèmes d'adhésion, les filaments résiduels et le gauchissement, grâce à une analyse systématique des symptômes. Elle est conçue pour être utilisée lorsque les impressions échouent en cours de processus, présentent des défauts de qualité, ou après des changements de matériel ou de matériaux. La compétence fournit des solutions de dépannage actionnables pour les imprimantes FDM et SLA.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add pjt222/agent-almanac -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternatif
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/troubleshoot-print-issues

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

排查列印問題

以系統化症狀分析,診斷並修復常見之 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(未來技能):皮帶張緊、軸承潤滑、噴嘴更換與預防性維護

Dépôt GitHub

pjt222/agent-almanac
Chemin: i18n/wenyan-lite/skills/troubleshoot-print-issues
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Compétences associées

executing-plans

Design

Utilisez la compétence executing-plans lorsque vous disposez d'un plan de mise en œuvre complet à exécuter par lots contrôlés avec des points de contrôle de revue. Elle charge et examine le plan de manière critique, puis exécute les tâches par petits lots (3 tâches par défaut) tout en rapportant la progression entre chaque lot pour une revue par l'architecte. Cela garantit une mise en œuvre systématique avec des points de contrôle de qualité intégrés.

Voir la compétence

requesting-code-review

Design

Cette compétence délègue un sous-agent réviseur de code pour analyser les modifications apportées au code par rapport aux exigences avant de poursuivre. Elle doit être utilisée après avoir terminé des tâches, implémenté des fonctionnalités majeures, ou avant une fusion vers la branche principale. La revue aide à détecter précocement les problèmes en comparant l'implémentation actuelle avec le plan initial.

Voir la compétence

connect-mcp-server

Design

Cette compétence fournit un guide complet permettant aux développeurs de connecter des serveurs MCP à Claude Code via les transports HTTP, stdio ou SSE. Elle couvre l'installation, la configuration, l'authentification et la sécurité pour intégrer des services externes tels que GitHub, Notion et des API personnalisées. Utilisez-la lors de la configuration d'intégrations MCP, de la configuration d'outils externes ou du travail avec le Protocole de Contexte de Modèle de Claude.

Voir la compétence

web-cli-teleport

Design

Cette compétence aide les développeurs à choisir entre les interfaces Web et CLI de Claude Code en fonction de l'analyse des tâches, puis permet une téléportation transparente des sessions entre ces environnements. Elle optimise le flux de travail en gérant l'état et le contexte de la session lors du passage entre le web, la CLI ou le mobile. Utilisez-la pour des projets complexes nécessitant différents outils à diverses étapes.

Voir la compétence