printer

name	printer
description	列印功能
allowed-tools	prepare_print_file mcp__printer__print_file mcp__printer__list_printers mcp__printer__printer_status mcp__printer__cancel_job mcp__printer__print_test_page
metadata	{"ctos":{"requires_app":"printer","mcp_servers":"printer ching-tech-os"}}

【列印功能】 列印分兩步驟，先轉換路徑再列印：

步驟 1 - 準備檔案（ching-tech-os 工具）：

• prepare_print_file: 將虛擬路徑轉換為絕對路徑，Office 文件自動轉 PDF · file_path: 檔案路徑（必填）
  • 虛擬路徑：ctos://knowledge/attachments/report.pdf、shared://projects/...
  • 絕對路徑：/mnt/nas/ctos/... · 回傳：可列印的絕對路徑

步驟 2 - 實際列印（printer-mcp 工具）：

• mcp__printer__print_file: 將檔案送至印表機列印 · file_path: 步驟 1 回傳的絕對路徑（必填） · printer: 印表機名稱（可選，預設使用系統預設） · copies: 份數（可選，預設 1） · page_size: 紙張大小（可選，A3/A4/A5/B4/B5/Letter/Legal） · orientation: 方向（可選，portrait/landscape） · color_mode: 色彩模式（可選，gray/color，預設 gray。除非用戶要求彩色列印，否則一律用 gray）
• mcp__printer__list_printers: 查詢可用印表機
• mcp__printer__printer_status: 查詢印表機狀態
• mcp__printer__cancel_job: 取消列印工作

⚠️ 重要：不要跳過步驟 1 直接呼叫 printer-mcp！ 虛擬路徑（ctos://、shared://）必須先經過 prepare_print_file 轉換。 只有當你已經有絕對路徑（/mnt/nas/...）時才能直接用 printer-mcp。

【支援的檔案格式】

• PDF：自動透過 Ghostscript 正規化（修復 AutoCAD 等軟體產生的格式問題，確保 RICOH 等嚴格 PDF 解譯器能接受）
• 純文字（.txt, .log, .csv）、圖片（PNG, JPG, JPEG, GIF, BMP, TIFF, WebP）：直接列印
• 自動轉 PDF：Office 文件（.docx, .xlsx, .pptx, .doc, .xls, .ppt, .odt, .ods, .odp）

【列印使用情境】

1. 用戶說「把知識庫的報告印出來」 → search_knowledge("報告") 找到檔案路徑 → prepare_print_file(file_path="ctos://knowledge/...") → mcp__printer__print_file(file_path="回傳的絕對路徑")
2. 用戶說「印 3 份 A3 橫式」 → prepare_print_file(file_path=...) → mcp__printer__print_file(file_path=..., copies=3, page_size="A3", orientation="landscape")
3. 用戶說「列出印表機」 → mcp__printer__list_printers()（不需要步驟 1）