核心结论
跨平台交付需要“统一核心 + 平台后端 + 平台安装包 + 实机认证”。代码能编译不代表任意驱动和打印机已经完成生产验收。
跨平台能力如何分层?
TypeScript SDK、本机协议、任务状态、PIR 模型和许可证规则跨平台共享。打印机枚举、参数映射、PDF 输出和安装服务由各平台适配。
- Windows:Winspool、DEVMODE、PDFium/GDI
- Linux/麒麟:CUPS、IPP 与发行版服务管理
- macOS:CUPS 与系统打印体系
- Windows 7:独立有限兼容构建,不作为默认安全基线
为什么需要实体打印认证?
驱动会影响纸张枚举、硬件边距、双面、色彩、纸盒和任务状态。小票机还可能存在字符集、队列透传和切刀差异。每一个对外承诺的平台、系统版本、架构和打印机型号都应有实体样张与故障场景记录。
推荐的试点范围
首个试点建议固定一个操作系统版本、1 至 3 个目标打印机型号、A4 或 80mm 纸张、少量黄金模板以及明确的授权 SKU。通过安装、升级、重启、缺纸、离线和恢复测试后再扩大部署。
部署方需要准备什么?
需要提供操作系统与架构、打印机精确型号和连接方式、驱动版本、纸张规格、样张、业务 Origin、是否离线、预计设备与并发规模。涉及商业字体时还要确认字体文件、安装范围和授权条款。
常见问题
国产麒麟可以部署吗?+
架构支持 Linux/麒麟的 CUPS 路径,但需要针对发行版版本、x64/ARM64 架构、驱动与实体机型分别认证。
Windows 7 可以作为标准版本吗?+
不建议。Windows 7 已不适合作为默认安全生产基线,仅在合同明确要求时提供独立有限兼容构建和验收范围。
安装包可以一个文件覆盖所有平台吗?+
不可以。Rust 核心可以复用,但每个平台和 CPU 架构都需要独立构建、签名与安装包。
内容说明
本文依据 Print Agent 当前仓库实现、协议文档与交付边界整理。平台兼容性以实际签名安装包、目标驱动和打印机型号的验收记录为准。
最后复核:2026-09-01