PT210에서 인쇄하기
번들 헬퍼는 완전한 클론 저장소를 통해 사용하세요. PRINT_SKILL_DIR을 이 스킬의 디렉터리로 설정한 후 다음을 호출하세요:
bash "$PRINT_SKILL_DIR/scripts/print.sh" --help
macOS, uv, 켜져 있고 용지가 장착된 PT210, 그리고 호출 앱에 대한 블루투스 권한이 필요합니다. 마크다운/Excalidraw는 로컬에 설치된 Google Chrome도 필요합니다. 첫 번째 의존성 설치는 네트워크를 사용하며, 렌더링 자체는 로컬에서 이루어집니다. 이 스킬 폴더는 저장소 없이 복사되면 작동한다고 가정하지 마세요.
한 번 연결하기
bash "$PRINT_SKILL_DIR/scripts/print.sh" scan
bash "$PRINT_SKILL_DIR/scripts/print.sh" setup --address SCAN에서_얻은_UUID
macOS는 BLE 장치를 클래식 블루투스 MAC이 아닌 기기별 UUID로 식별합니다. 설정은 지원되는 쓰기 가능한 특성을 확인하고 선택 사항을 ~/.config/pt210/printer.json에 저장합니다. 고유하게 발견된 PT210 하나는 --address 없이 선택할 수 있습니다. 여러 개가 일치하는 경우 의도한 장치를 결정하세요. 저장된 장치가 없으면 다른 프린터로 대체되지 않습니다. --address는 PT210_ADDRESS를 재정의하고, 그 다음 저장된 선택을 재정의합니다. inspect는 인쇄 없이 연결만 합니다.
준비, 미리보기, 인쇄
정확히 요청된 내용을 사용하세요. 인쇄 요청은 종이 출력을 승인하므로, 중복된 확인 게이트를 추가하지 마세요. 익숙하지 않은 레이아웃은 먼저 미리보기로 확인하세요.
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
- 일반 텍스트: stdin 또는
--file. ASCII는 내장 폰트로 빠르게 인쇄되며, 한국어를 포함한 유니코드는 비트맵 텍스트를 사용합니다.--mode raster는 비트맵을 강제합니다. - 마크다운:
.md/.markdown이 자동 감지됩니다. stdin의 경우--format markdown을 사용하세요. 요청된 서식을 유지하세요. 제목, 강조, 목록, 작업 체크박스, 인용구, 코드, 표 및 링크가 렌더링됩니다. 넓은 표는 레이블이 있는 행이 됩니다. 링크에는 대상이 포함됩니다. 이미지는 대체 텍스트 자리 표시자가 됩니다. 원시 HTML은 그대로 유지되며, 외부 리소스는 차단됩니다. - Excalidraw:
.excalidraw/.excalidraw.json이 자동 감지됩니다. stdin 또는 일반 JSON의 경우--format excalidraw를 사용하세요.build-excalidraw로 한 번 빌드하세요 (npm 필요). 저장된 장면을 사용하고, 공유 URL, 라이브러리, Obsidian 래퍼 또는 PNG는 사용하지 마세요. Mermaid에서 편집된 장면을 다시 생성하지 마세요. 공식 로컬 렌더러는 기하학을 유지하고 종이 너비에 맞춰 비례적으로 크기를 조정합니다. 작은 텍스트 경고는 미리보기 검사가 필요합니다. 조용히 자르거나 재배열하지 마세요. 내장 PNG/JPEG/WebP/GIF는 지원되며, 원격 포함 및 SVG 이미지는 명시적으로 실패합니다. Excalidraw와 마크다운은 항상 래스터 모드를 사용합니다.
미리보기는 블루투스에 접근하지 않으며 기존 파일 덮어쓰기를 거부합니다. 마크다운/Excalidraw 미리보기는 동일한 옵션으로 인쇄와 일치합니다. 일반 텍스트의 경우 print --mode raster를 사용하여 미리보기와 일치시키세요. 기본 폰트는 다릅니다. 모든 작업은 점선 가이드와 20mm의 빈 찢는 여백으로 끝납니다. --tear-margin-mm 0..50으로 조정하거나 --no-tear-line으로 가이드를 생략하세요. 기본 높이 제한은 2,400도트(여백 포함 300mm)입니다. 큰 출력을 줄이거나 요청된 긴 영수증에 대해 명시적으로 --max-height를 높이세요.
전달 및 실패
프로세스가 끝날 때까지 기다리세요. transmitted는 블루투스 쓰기가 완료되었음을 의미하며, 독립적인 종이 출력 증명이 아닙니다. 초기 설정 또는 새로운 전송 동작의 경우 종이 확인을 받으세요. 로컬 잠금은 중복 작업을 방지합니다. 우회하지 마세요. 실패/중단된 전송은 부분 출력이 발생할 수 있습니다. 재시도 전에 종이를 검사하고 절대 자동으로 재전송하지 마세요.
프린터가 발견되지 않으면 사용자에게 근처에서 전원을 켜고 휴대폰 프린터 앱을 연결 해제하도록 요청하세요. 블루투스가 샌드박스 처리된 경우 런타임의 승인된 권한 경로를 사용하세요. 블루투스 거부는 macOS 개인정보 보호 및 보안에서 사용자 조치가 필요합니다. TCC 설정을 편집하지 마세요. 클래식 블루투스 전용 변형은 다른 검증된 전송이 필요합니다. 직렬 포트를 추측하거나 사무실/기본 프린터를 사용하지 마세요.
--transport conservative는 출력이 손상된 경우 다음 승인 작업에 더 작은 패킷을 사용합니다. 프린터 구성, 잠금 파일 및 렌더링된 캐시는 로컬 런타임 상태이므로 절대 커밋하지 마세요. 전체 기능, 설정 및 제한 사항은 저장소의 README에 있습니다.