更新记录

1.1.0（2026-11-05）

• 1.0.0 首发：可视化小票模板编辑器（6 类元素、拖拽排序、属性面板、JSON 导出/导入）；所见即所得预览、打印前自检、模板变量自动填充、纸张预估、按纸宽折行；幂等打印队列；print 事件移交宿主调用 zl-pos-print。
• 1.1.0 付费化改造：改为 uni-app x（uvue）付费前端组件（HBuilderX 4.19+，云端编译加密）；组件 .vue→.uvue、逻辑 .ts→.uts；print 事件移交已生成字节（含图片位图上下文）；新增根 index.uts 统一导出。

平台兼容性

uni-app(4.19)

POS 小票模板编辑器 Pro（zl-pos-editor）

简介

uni-app x 付费小票模板编辑器（前端组件，云端编译加密）：可视化拖拽文本/二维码/条码/图片/分隔线元素，所见即所得预览、模板自检，模板可序列化 JSON 导出/导入。支持模板变量自动填充、按纸宽折行、纸张用量预估与幂等打印队列（Pro）。实际打印由配套付费 UTS 引擎插件 zl-pos-print 完成（本组件通过 print 事件移交已生成字节）。仅 App 端，HBuilderX 4.19+、uni-app x 项目。

本插件为付费前端组件（普通授权版 ¥19 / 源码授权版 ¥99），DCloud 云端编译自动加密全部 vue/uvue/uts/js/ts 文件（除 pages/hybrid/static），仅支持 uni-app x + easycom + 不混搭 utssdk。

功能特性

• 可视化拖拽文本/二维码/条码/图片/分隔线元素，属性面板编辑
• 所见即所得小票预览 + 打印前自检（纸宽/元素/条码/二维码/图片/id 校验）
• 模板变量（双花括号 + 默认值）自动填充、纸张用量预估、按纸宽折行
• 模板 JSON 导出 / 导入（serialize / deserialize 复用）
• 幂等打印队列：业务单号去重、人工重打（本地队列 UI）
• 打印动作通过 print 事件移交宿主（含已生成字节 bytes），由宿主调用 zl-pos-print.printBytes 完成实际连接与发送

平台兼容

uni-app x · App-Android、App-iOS（仅 App，不涉及 web/小程序/鸿蒙）

快速上手

<template>
  <zl-print-designer @print="onPrint" />
</template>

<script setup lang="uts">
import { printBytes } from '@/uni_modules/zl-pos-print'
function onPrint(p: { target: string; bytes: Uint8Array }) {
  // 使用编辑器已生成的字节发送（含图片位图上下文）；target 为蓝牙MAC 或 IP:端口
  printBytes({ target: p.target, bytes: p.bytes })
}
</script>

组件通过 easycom 直接使用 <zl-print-designer />；需安装 zl-pos-print（付费引擎）以获得打印能力。

付费与加密说明

• 本插件为付费前端组件，DCloud 云端编译加密；购买普通授权版可运行（不获源码），源码授权版可获全部源码。
• 购买时需绑定项目 appid 与包名；首次运行/发行到目标平台触发云端编译（需联网 + 已登录具备权限的 HBuilderX 账号），成功后走本地缓存。
• 仅支持 uni-app x 项目；不支持混搭 utssdk 目录；对外导出经根 index.uts。

合规声明

插件仅在用户本地编辑小票模板，不采集、不发送任何数据到插件作者服务器。打印由宿主调用 zl-pos-print 完成，其权限与合规声明见该插件。

更新说明

1.0.0 首发：可视化模板编辑器 + 预览 + 自检 + JSON 导出/导入（免费）；打印移交配套付费引擎 zl-pos-print。 1.1.0 付费化改造：改为 uni-app x（uvue）付费前端组件（HBuilderX 4.19+，云端编译加密）；组件 .vue→.uvue、逻辑 .ts→.uts；print 事件移交已生成字节（含图片位图上下文）。