云上驱动打印

问题

在 Agent 非交互环境里，让模型直接执行“打印到某台打印机”往往不够：需要识别打印机型号、搜索或登记驱动、转换文档、调用云端渲染、再把二进制打印数据发到 9100 端口。如果绕过驱动渲染直接发送原始 PDF、DOCX 或图片，输出可能不可用。这个技能把这些参数、接口格式、降级路径和故障诊断压成一条可执行流程。

工作方式

• 非交互打印：围绕 print_file_for_skill.py 执行，适合配合 --no-config-prompt --json，并通过 CDF_PRINT_CONFIG_JSON 指定 copies、color、side、paperConfig。
• 驱动与打印机发现：用 search_driver.py 搜索型号，必要时加 --pick 1 --json，避免 input() 在无 stdin 时报 EOF；用 discover.py 登记 IP。型号无法识别时，可按 ipptool、HTTP、SNMP 的顺序探测，读取 printer-make-and-model、marker-levels 等字段。
• 云端渲染管道：请求 uploadFileMCP、convert_url_to_pdf、print_for_skill 等接口，统一携带 Accept: application/json、tid: cdf_ai_terminal、ttp: AI。_cvturl 和 _pfs 必须使用 JSON body，使用 form-encoded 可能导致 404。_pfs 成功后，客户端需要下载 fileUrl 指向的二进制数据，并发送到打印机 9100 端口。
• 降级与排障：_cvturl 超时可自动降级为 LibreOffice 本地转 PDF 并重新上传；如果 _pfs 返回成功但 fileUrl 下载为 0 字节，说明云端渲染产物为空，不能绕过 _pfs 直发原始文件。

边界

依赖 Python 3.10+、LibreOffice，可选 zeroconf 做 mDNS 发现；适合能访问云端服务与目标打印机内网的场景。它不是通用文档转换工具，也不替代驱动安装、打印机网络调试或特定 PDF 兼容性排查。