核心结论
设计器产出的是受控 Template IR,而不是任意网页截图。预览、PDF/PIR 打印和 ESC/POS 编译共享模板版本与业务数据。
设计器支持哪些排版能力?
组件可以从左侧拖入毫米画布,在落点创建并继续自由移动。属性面板负责尺寸、位置、字体、边框和字段绑定。
- 文本、线条、矩形与分隔线
- PNG/JPEG 图片
- Code 128 条码与二维码
- 表格重复行与字段绑定
- 分页、连续纸和常用纸张预设
- 撤销、重做、复制、方向键微调和导入导出
为什么不直接保存 HTML?
任意 HTML、CSS 和脚本难以保证跨平台渲染一致,也会扩大远程资源和脚本执行风险。Template IR 只允许已定义、可校验的节点和属性,因此能够建立能力矩阵和稳定的版本摘要。
模板如何进入生产环境?
模板从草稿开始,经过校验、送审、批准和签名发布后才能被业务系统调用。编辑者、审核者、发布者和运行身份可以分离。
- 草稿 revision 乐观锁,避免覆盖他人修改
- 四眼审核规则
- 发布版本设备签名与内容摘要
- 归档停止新任务使用
- 回滚会创建新草稿,不覆盖历史记录
业务前端应该传什么?
正式打印时,业务页面只传固定 templateId、templateVersion、printerName、data 和 idempotencyKey。页面不需要携带设计器,也不应上传任意生产脚本。
常见问题
设计器能像画图软件一样自由拖动吗?+
可以在毫米画布中拖拽、自由定位和调整尺寸,同时会执行边界与目标通道能力校验。
预览模板可以直接用于生产吗?+
草稿可以预览,但只有经过审核并签名发布的固定版本可以通过生产模板接口打印。
同一个模板能输出 PDF 和 ESC/POS 吗?+
业务数据可以复用;具体节点能否跨通道使用取决于能力矩阵,不支持的节点会返回结构化校验错误。
内容说明
本文依据 Print Agent 当前仓库实现、协议文档与交付边界整理。平台兼容性以实际签名安装包、目标驱动和打印机型号的验收记录为准。
最后复核:2026-09-01