01
连接与发现看见系统里的每一台打印机
通过本机 Agent 读取操作系统队列，统一处理 CUPS、IPP 与 Windows Spooler；网页不再直接碰驱动。
状态发现默认队列能力协商
0ActiveX / 浏览器插件
3受控打印通道
PIR · PDF · ESC/POS
PIR · PDF · ESC/POS
4授权模型
单机 · 并发 · 站点 · 离线
单机 · 并发 · 站点 · 离线
1统一 SDK
连接、预览、提交、追踪
连接、预览、提交、追踪
PRODUCT CAPABILITIES
从“能打”到“可治理”
把浏览器不擅长处理的驱动、队列、纸张、切刀与设备授权，收敛到一个可观测、可控制的本地边界。
02
统一渲染一套数据，覆盖 A4、标签与小票
PIR、PDF 与受控 ESC/POS 共用任务模型，支持文本、图片、表格、条码、二维码、分页与连续纸。
PDF / PIR58 / 76 / 80mmA4 / A5 / 标签
03
模板设计器拖出来的模板，也能放心上生产
毫米级自由排版、字段绑定、预览与版本治理，让模板经历编辑、审核、签名发布、归档和回滚。
拖拽排版四眼审核版本审计
04
小票与切纸把危险的 RAW 指令关进能力边界
结构化 ESC/POS 接口支持文本、二维码、Code 128、走纸和切纸；仅对已认证机型与切刀能力放行。
自动走纸全切 / 半切机型 Profile
05
安全授权许可证绑定设备，而不是复制文件
签名许可证结合设备公钥、主机指纹、功能权益、有效期与离线宽限，复制到另一台电脑即失效。
设备绑定SKU 权益离线验签
06
开发者体验几行 SDK，接进现有 Web 项目
Origin 白名单、配对会话、幂等键、状态轮询与结构化错误都已封装，适配 ERP、POS、WMS 与 SaaS。
TypeScript SDK幂等提交可诊断
INTEGRATION FLOW
接入现有 Web 项目，只需一条清晰链路
业务前端不接触驱动、不下发任意 RAW 指令；它只提交受控内容、精确队列名和稳定幂等键。
01
安装 Agent
安装已签名的平台包，注册本机服务。
02
配对 Origin
授权业务站点，兑换短期会话凭据。
03
读取能力
获取许可证、打印机与纸张/切刀能力。
04
预览与提交
按 PIR、PDF、模板或 ESC/POS 创建任务。
05
追踪结果
轮询状态，记录任务、模板版本与错误码。
// 与本机 Agent 建立受控会话
const client = await PrintAgent.connect();
const printers = await client.printers();
const job = await client.printTemplate({
templateId: 'retail-receipt-80',
templateVersion: 3,
printerName: printers[0].name,
data: order,
idempotencyKey: order.printKey
});BUILT FOR REAL OPERATIONS
一套能力，进入不同业务现场
从桌面办公到门店切纸，从联网 SaaS 到隔离网络，按场景组合打印通道、模板治理与授权方式。
58 / 80mm
01↗
零售与餐饮
收银小票 · 排队号 · 自动切纸
A4 / A5
02↗
企业 ERP
合同 · 发票 · 对账单 · A4 报表
标签 / 连续纸
03↗
仓储物流
面单 · 箱标 · 条码 · 批量任务
私有化
04↗
医疗与政务
处方 · 凭条 · 隔离网部署 · 审计
Web SDK
05↗
平台型 SaaS
多租户模板 · 权限隔离 · 本地输出
多站点
06↗
连锁门店
统一模板发布 · 门店设备授权 · 回滚
CROSS-PLATFORM, HONESTLY跨平台不是一句口号，
跨平台不是一句口号，
而是一张认证矩阵
核心协议、SDK 与任务模型保持一致，平台打印后端、安装包、系统版本、驱动和实体机型分别验收。
获取目标环境评估清单 →WWindows 10 / 11Winspool · PDFium / GDI生产候选 · 待实机认证
LLinux / 国产麒麟CUPS · IPP · x64 / ARM64按发行版与架构认证
MmacOSCUPS · Intel / Apple Silicon按系统与驱动认证
7Windows 7独立兼容构建仅合同约定场景
COMMERCIAL PLANS
从一台电脑，到一个企业
不共享可复制的许可证文件。合同额度可以共享，但每台设备都获得独立、可审计、可撤销的授权身份。
单机版
按设备授权为每台电脑签发独立许可证，部署简单，成本边界清晰。
- ✓PIR / PDF 基础打印
- ✓打印机发现与状态
- ✓设备绑定与离线宽限
- ✓标准升级与诊断
并发版
按在线 Agent多台设备共享合同额度，由中心租约控制同时在线数量。
- ✓包含单机版能力
- ✓并发席位与租约
- ✓中心激活与撤销
- ✓部门级使用统计
站点版
按站点与配额站点内共享合同设备额度，适合门店、园区和多业务线。
- ✓模板治理与角色分权
- ✓站点设备配额
- ✓平台与机型认证包
- ✓企业级交付支持
离线专版
按预授权设备无需持续联网，每台设备使用预签发许可证完成本地验签。
- ✓离线签发与验签
- ✓受控宽限与可信时间
- ✓离线升级介质
- ✓专属验收与审计
最终报价依据设备规模、并发数量、目标平台、认证机型、私有化范围与服务等级确定。
FAQ在部署之前，
在部署之前，
把边界说清楚
打印是软硬件共同参与的最后一公里。我们坚持将“代码已支持”和“环境已认证”分开表达。
必须安装浏览器插件或 ActiveX 吗？＋
不需要。网页只集成现代 TypeScript / JavaScript SDK，本机 Agent 通过受限的回环 API 与操作系统打印体系通信。
预览和实际打印能保持一致吗？＋
PIR 与模板任务由同一渲染链路生成预览和打印 PDF，并固定纸张、边距、缩放与渲染器版本。最终仍需按目标驱动和机型完成实体打印验收。
客户电脑里的商业字体可以打印吗？＋
可以使用已合法安装并可被 Agent 进程访问的字体。为了跨设备稳定复现，建议交付时锁定字体清单与替代策略，并确认商业字体授权范围。
无线网络打印机可以发现吗？＋
可以，只要打印机已被添加到操作系统队列并对当前运行用户可见。Agent 读取系统队列，而不是在局域网内无边界扫描设备。
所有小票机都能自动切纸吗？＋
不能一概而论。只有已识别并配置 ESC/POS Profile、且声明支持相应全切或半切能力的型号才会发送切刀命令。
Windows、国产麒麟和 macOS 都能部署吗？＋
核心架构支持多平台适配。Windows 10/11、Linux/麒麟与 macOS 需要按系统版本、架构、驱动和打印机型号分别认证；Windows 7 仅建议提供合同约定的有限兼容包。
PRINTING KNOWLEDGE BASE
从选型到上线，查看完整指南
基于实际产品能力整理的原创技术内容，帮助产品、开发和交付团队明确网页打印的实现方式与边界。