print

Drucken auf einem PT210

Verwende das gebündelte Hilfsprogramm aus dem vollständigen, geklonten Repository. Setze PRINT_SKILL_DIR auf das Verzeichnis dieser Fähigkeit und rufe auf:

bash "$PRINT_SKILL_DIR/scripts/print.sh" --help

Erfordert macOS, uv, einen eingeschalteten PT210 mit Papier und Bluetooth-Berechtigung für die aufrufende App. Markdown/Excalidraw erfordern ebenfalls lokal installiertes Google Chrome. Die erste Abhängigkeitsinstallation verwendet das Netzwerk; das Rendern selbst bleibt lokal. Gehe nicht davon aus, dass dieser Fähigkeitsordner funktioniert, wenn er ohne das Repository kopiert wird.

Einmal verbinden

bash "$PRINT_SKILL_DIR/scripts/print.sh" scan
bash "$PRINT_SKILL_DIR/scripts/print.sh" setup --address UUID_AUS_SCAN

macOS identifiziert BLE-Geräte über eine maschinenspezifische UUID, nicht über eine klassische Bluetooth-MAC. Die Einrichtung überprüft eine unterstützte beschreibbare Charakteristik und speichert die Auswahl in ~/.config/pt210/printer.json. Ein eindeutig gefundener PT210 kann ohne --address ausgewählt werden; bei mehreren Übereinstimmungen das gewünschte Gerät auflösen. Ein nicht vorhandenes gespeichertes Gerät fällt nie auf einen anderen Drucker zurück. --address überschreibt PT210_ADDRESS, dann die gespeicherte Auswahl. inspect verbindet ohne Drucken.

Vorbereiten, Vorschau, Drucken

Verwende genau den angeforderten Inhalt. Ein Druckauftrag autorisiert seinen Papiereinlauf; führe keine redundante Bestätigungsschleife ein. Vorschau unbekannter Layouts zuerst.

bash "$PRINT_SKILL_DIR/scripts/print.sh" preview --file /tmp/note.md --output /tmp/note-preview.png
bash "$PRINT_SKILL_DIR/scripts/print.sh" print --file /tmp/note.md

• Einfacher Text: stdin oder --file. ASCII druckt schnell mit der eingebauten Schriftart; Unicode, einschließlich Koreanisch, verwendet Bitmap-Text. --mode raster erzwingt Bitmap.
• Markdown: .md/.markdown automatische Erkennung; verwende --format markdown für stdin. Die angeforderte Formatierung beibehalten. Überschriften, Hervorhebungen, Listen, Aufgabenkontrollkästchen, Zitate, Code, Tabellen und Links werden dargestellt. Breite Tabellen werden zu beschrifteten Zeilen. Links enthalten Ziele; Bilder werden zu Alt-Text-Platzhaltern. Rohes HTML bleibt wörtlich, und externe Ressourcen werden blockiert.
• Excalidraw: .excalidraw/.excalidraw.json automatische Erkennung; verwende --format excalidraw für stdin oder generisches JSON. Einmal mit build-excalidraw erstellen (erfordert npm). Verwende die gespeicherte Szene, keine Freigabe-URL, Bibliothek, Obsidian-Wrapper oder PNG. Eine bearbeitete Szene nicht aus Mermaid neu generieren. Der offizielle lokale Renderer bewahrt die Geometrie und skaliert proportional zur Papierbreite. Warnungen bei kleinem Text erfordern Vorschauinspektion; nicht stillschweigend zuschneiden oder neu anordnen. Eingebettete PNG/JPEG/WebP/GIF werden unterstützt; Remote-Einbettungen und SVG-Bilder schlagen explizit fehl. Excalidraw und Markdown verwenden immer den Rastermodus.

Vorschauen greifen nie auf Bluetooth zu und weigern sich, eine vorhandene Datei zu überschreiben. Markdown/Excalidraw-Vorschauen stimmen mit dem Druck bei identischen Optionen überein. Für einfachen Text verwende print --mode raster, um die Vorschau zu treffen; native Schriftarten unterscheiden sich. Jeder Auftrag endet mit einer gestrichelten Führungslinie und einem 20 mm leeren Abreißrand. Anpassen mit --tear-margin-mm 0..50 oder die Führungslinie mit --no-tear-line weglassen. Der Standardhöhenlimit beträgt 2.400 Punkte (300 mm einschließlich Rand); verkürze große Ausgabe oder erhöhe explizit --max-height für eine angeforderte lange Quittung.

Auslieferung und Fehler

Warte, bis der Vorgang abgeschlossen ist. transmitted bedeutet, dass Bluetooth-Schreibvorgänge abgeschlossen wurden, kein unabhängiger Beweis für den Papiereinlauf. Hole für die Ersteinrichtung oder neues Transportverhalten Papierbestätigung ein. Lokale Sperrung verhindert überlappende Aufträge; umgehe sie nicht. Ein fehlgeschlagener/unterbrochener Sendevorgang kann teilweise gedruckt haben: überprüfe das Papier vor dem erneuten Versuch und sende nie automatisch neu.

Wenn kein Drucker gefunden wird, bitte den Benutzer, ihn in der Nähe einzuschalten und Handy-Drucker-Apps zu trennen. Verwende den genehmigten Berechtigungspfad der Laufzeitumgebung, wenn Bluetooth in einer Sandbox läuft. Eine Bluetooth-Verweigerung erfordert Benutzereingriff in macOS Datenschutz & Sicherheit; TCC-Einstellungen nicht bearbeiten. Varianten nur mit klassischem Bluetooth benötigen einen anderen verifizierten Transport; nicht serielle Ports raten oder den Büro-/Standarddrucker verwenden.

--transport conservative verwendet kleinere Pakete für den nächsten autorisierten Auftrag, wenn die Ausgabe beschädigt ist. Druckerkonfiguration, Sperrdateien und gerenderte Caches sind lokaler Laufzeitzustand; niemals übertragen. Vollständige Fähigkeiten, Einrichtung und Einschränkungen sind im README des Repositorys.