Zurück zu Fähigkeiten

troubleshoot-print-issues

pjt222
Aktualisiert 2 days ago
4 Ansichten
17
2
17
Auf GitHub ansehen
Designai

Über

Diese Fähigkeit diagnostiziert und behebt häufige 3D-Druckfehler durch systematische Symptomanalyse. Sie behandelt Probleme wie Haftungsprobleme, Fädenbildung, Layerverschiebungen und Extrusionsfehler sowohl für FDM- als auch SLA-Drucker. Nutzen Sie sie, wenn Drucke während des Prozesses scheitern, Qualitätsmängel aufweisen oder wenn neue Materialien oder Hardware zu inkonsistenten Ergebnissen führen.

Schnellinstallation

Claude Code

Empfohlen
Primär
npx skills add pjt222/agent-almanac -a claude-code
Plugin-BefehlAlternativ
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternativ
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/troubleshoot-print-issues

Kopieren Sie diesen Befehl und fügen Sie ihn in Claude Code ein, um diese Fähigkeit zu installieren

Dokumentation

排印之疾

以系統之症析診而修 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-offset 下調 0.05mm
拉絲過熱、回抽不足察嘴溫降溫 5°C、增回抽 +0.5mm
層偏帶鬆、過速、相撞察帶之張緊帶、減速 20%
翹曲附差、冷急察角之翹加 brim、罩機、增床溫
出料不足堵、溫低、流誤察出料一致否清嘴、增溫 5°C、校 e-steps
出料過剩流高、e-steps 誤察塊形減流 2-5%、校 e-steps
象足首層擠、床過熱量基寬升 Z-offset +0.05mm、降床溫 5°C
壁有隙壁薄、出不足察壁厚啟薄壁察、增流
層分溫低、冷劣、污察層紋增溫 5-10°C、察濕絲
塊/瘡回抽、coast 設察縫對齊調回抽、啟 coasting
頂面粗頂層少、熨之數實頂層加 2 頂層、啟 ironing
懸垂下垂冷少、過熱察件冷扇增冷、降溫、加支

得:敗已歸 1-3 最可能之類。

敗則:症合多類者,依敗時為先(首層先、中途次、頂面後)。

第三步:行根因之析

究其本,勿止於症:

5 Why 之術

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 校誤
  • 流率乘誤
  • 切片有訛或側檔誤
  • 韌之加速/jerk 過高

得:根因明,有證(量溫、帶張、目察)。

敗則:根因不明者,用排除之法:修最可能之因,再試,反覆至解。

第四步:施初級之修

行常見之疾之即解:

床附不良

即修

# 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-offset 誤:首層之敗多為 Z-offset 過高(擠不足)或過低(嘴刮床)
  10. 境之忽:ABS/ASA 於 15°C 風車庫永不能良印——材需穩暖之境

  • prepare-print-model:確模備正以免印之疾
  • select-print-material:擇與機與境合之材
  • 校 3D 印機(後出之術):E-steps、流率、溫塔、PID 調、床網平
  • 守 3D 印機(後出之術):帶張、軸承潤、嘴換、預修

GitHub Repository

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

Verwandte Skills

executing-plans

Design

Verwenden Sie die Fähigkeit "executing-plans", wenn Sie einen vollständigen Implementierungsplan zur Ausführung in kontrollierten Batches mit Überprüfungspunkten vorliegen haben. Sie lädt den Plan und überprüft ihn kritisch, führt dann Aufgaben in kleinen Batches (standardmäßig 3 Aufgaben) aus und meldet den Fortschritt zwischen jedem Batch zur Überprüfung durch den Architekten. Dies gewährleistet eine systematische Implementierung mit integrierten Qualitätskontrollpunkten.

Skill ansehen

requesting-code-review

Design

Diese Fähigkeit sendet einen Unteragenten für Code-Review, um Codeänderungen anhand der Anforderungen zu analysieren, bevor fortgefahren wird. Sie sollte nach dem Abschließen von Aufgaben, der Implementierung größerer Funktionen oder vor dem Zusammenführen in den Hauptzweig verwendet werden. Die Überprüfung hilft dabei, Probleme frühzeitig zu erkennen, indem die aktuelle Implementierung mit dem ursprünglichen Plan verglichen wird.

Skill ansehen

connect-mcp-server

Design

Diese Fähigkeit bietet Entwicklern eine umfassende Anleitung, um MCP-Server über HTTP-, stdio- oder SSE-Transports mit Claude Code zu verbinden. Sie behandelt Installation, Konfiguration, Authentifizierung und Sicherheit für die Integration externer Dienste wie GitHub, Notion und benutzerdefinierter APIs. Nutzen Sie sie beim Einrichten von MCP-Integrationen, bei der Konfiguration externer Tools oder bei der Arbeit mit Claude's Model Context Protocol.

Skill ansehen

web-cli-teleport

Design

Diese Fähigkeit unterstützt Entwickler bei der Wahl zwischen Claude Code Web- und CLI-Schnittstellen basierend auf Aufgabenanalysen und ermöglicht nahtloses Session-Teleporting zwischen diesen Umgebungen. Sie optimiert den Workflow, indem sie den Sitzungsstatus und Kontext beim Wechsel zwischen Web, CLI oder Mobilgeräten verwaltet. Nutzen Sie sie für komplexe Projekte, die in verschiedenen Phasen unterschiedliche Werkzeuge erfordern.

Skill ansehen