核心结论

跨平台交付需要“统一核心 + 平台后端 + 平台安装包 + 实机认证”。代码能编译不代表任意驱动和打印机已经完成生产验收。

01

跨平台能力如何分层?

TypeScript SDK、本机协议、任务状态、PIR 模型和许可证规则跨平台共享。打印机枚举、参数映射、PDF 输出和安装服务由各平台适配。

  • Windows:Winspool、DEVMODE、PDFium/GDI
  • Linux/麒麟:CUPS、IPP 与发行版服务管理
  • macOS:CUPS 与系统打印体系
  • Windows 7:独立有限兼容构建,不作为默认安全基线
02

为什么需要实体打印认证?

驱动会影响纸张枚举、硬件边距、双面、色彩、纸盒和任务状态。小票机还可能存在字符集、队列透传和切刀差异。每一个对外承诺的平台、系统版本、架构和打印机型号都应有实体样张与故障场景记录。

03

推荐的试点范围

首个试点建议固定一个操作系统版本、1 至 3 个目标打印机型号、A4 或 80mm 纸张、少量黄金模板以及明确的授权 SKU。通过安装、升级、重启、缺纸、离线和恢复测试后再扩大部署。

04

部署方需要准备什么?

需要提供操作系统与架构、打印机精确型号和连接方式、驱动版本、纸张规格、样张、业务 Origin、是否离线、预计设备与并发规模。涉及商业字体时还要确认字体文件、安装范围和授权条款。

FAQ

常见问题

国产麒麟可以部署吗?

架构支持 Linux/麒麟的 CUPS 路径,但需要针对发行版版本、x64/ARM64 架构、驱动与实体机型分别认证。

Windows 7 可以作为标准版本吗?

不建议。Windows 7 已不适合作为默认安全生产基线,仅在合同明确要求时提供独立有限兼容构建和验收范围。

安装包可以一个文件覆盖所有平台吗?

不可以。Rust 核心可以复用,但每个平台和 CPU 架构都需要独立构建、签名与安装包。

内容说明

本文依据 Print Agent 当前仓库实现、协议文档与交付边界整理。平台兼容性以实际签名安装包、目标驱动和打印机型号的验收记录为准。

最后复核:2026-09-01