网页打印工具：无需 ActiveX 的本地打印方案

网页为什么不能直接稳定控制打印机？

浏览器的安全边界决定了网页无法任意枚举本地设备、控制打印驱动或静默操作切刀。直接调用浏览器打印对话框还会受到页边距、缩放、纸张和浏览器版本差异影响。

现代方案需要保留浏览器的安全模型，同时把设备相关操作放到用户明确安装、可审计的本机程序中。

Print Agent 的三层架构

业务前端只负责提供模板标识、业务数据、打印机名称和幂等键；Web SDK 负责配对、能力查询、提交与状态追踪；本机 Agent 负责渲染、许可证校验和系统队列调用。

• 浏览器层：现代 JavaScript / TypeScript SDK
• Agent 层：回环 API、权限、渲染和任务状态
• 系统层：Windows Spooler、CUPS、IPP 与实际打印驱动

与旧式打印控件的主要区别

Print Agent 不要求 Internet Explorer、ActiveX 或浏览器扩展。Origin 白名单与短期会话限制了可调用站点，结构化任务接口也避免业务页面发送任意原始打印字节。

• 无需旧浏览器兼容模式
• 打印任务支持稳定幂等键，避免重复提交
• 模板、设备、租户和角色可以分别授权
• 错误码和诊断信息可用于售后排查

适合哪些系统？

需要从网页稳定打印 A4 单据、小票、标签、条码或二维码，同时希望保留本地打印速度和离线能力的系统，适合采用本机 Agent 架构。典型系统包括 ERP、POS、WMS、OMS、医院窗口系统、政务内网和平台型 SaaS。