更新日志
约 3448 字大约 11 分钟
...
2026-10-10
安装包下载: https://pan.quark.cn/s/428f36751e92
在线API文档说明: https://celmpuecfz.apifox.cn/305982s0
2026-11-09
sv-print静默打印客户端@2.1.0
- 🌈 新增 打印机 原生能力 提供 getPrinters、exists、getPrinterStatus、openPrinterSettings、printFile、printBytes、printRaw、getJob、getActiveJobs、getJobHistory、getAllJobs、pauseJob、resumeJob、cancelJob、cleanupOldJobs、listSerialPorts、listUsbDevices、openDevice、writeDevice、closeDevice 等接口, http / socket / mqtt 三种方式事件名一致.
- 🌈 新增 指令测试窗口 & 模板转指令打印: 模板 JSON 直接转 ESC/POS、ZPL、TSPL、CPCL、EPL 指令并打印, 支持 协议 / DPI / 份数 / 模式(auto|raster) / 抖动 / 阈值 / 反转 / 介质间隙 / 旋转 / 镜像 / 位图分块 参数, 以及指令文本、十六进制、二值化预览与 .bin /.txt 下载.
- 🌈 新增 printType: raw 直接透传指令文本/字节打印, 不经过模板渲染窗口, 支持 waitForCompletion / buffer / jobName.
- 🌈 新增 打印机状态窗口: 展示打印机状态、原因、队列任务数、是否接受新任务, 支持任务列表(活跃/历史/全部)、暂停/恢复/取消任务、清理过期记录.
- 🌈 新增 纸张管理独立窗口: 纸张列表搜索/刷新、选中回填尺寸、自定义纸张名称与尺寸校验.
- 🌈 新增 打印请求 preview: true 打开客户端预览窗口(不进入打印队列), 预览窗口支持重打与打开开发者工具.
- 🌈 新增 打印机详情快捷操作: 打印机状态、指令测试、纸张管理 窗口按钮, 以及系统 打印首选项 / 打印机属性 / 打印机队列 入口.
- 🌈 新增 双击托盘图标 打开主窗口;
- ✨ 优化 socket / mqtt 事件分发: 新增 openCommandWindow、openPaperWindow、openPrinterStatusWindow 等窗口事件; MQTT 支持按客户端隔离监听、断线清理与断线重连后重建上下文.
- ✨ 优化 打印队列: 按 taskId 精确回执, 新增打印任务超时(默认 5 分钟, 0 为不限制)与任务终态去重, 避免队列永久占用.
- ✨ 优化 打印机状态判断(CUPS / Windows 状态码), 打印完成后同步刷新运行状态与队列数量.
- ✨ 优化 预览窗口: 新增最大预览窗口数(默认 6)与达到上限后销毁旧窗口/复用最新窗口的配置.
- ✨ 优化 云服务状态 展示, 修复云打印SaaS 上线后任务未打印问题; 优化 clientType 判断(区分 client / cloud).
- ✨ 优化 Windows 平台默认 禁用虚拟打印机(XPS、Fax、OneNote、WPS PDF、Adobe PDF 等).
- ✨ fix 打印传递 模板 json 时 printType: 'pdf' 无效问题.
- ✨ fix 打包后 在线设计 打开空白问题(file 协议路由与路径处理).
🎮 代码示例
原生打印接口
// http 服务方式
// 打印机列表
const printers = await fetch('http://127.0.0.1:7071/printer/getPrinters').then((r) => r.json());
// 打印机状态
const status = await fetch(
`http://127.0.0.1:7071/printer/getPrinterStatus?printerId=${encodeURIComponent('printerName')}`,
).then((r) => r.json());
// => { state, reasons: [], queuedJobCount, acceptingJobs, message? }
// 任务查询与操作
const jobs = await fetch(
`http://127.0.0.1:7071/printer/getActiveJobs?printerId=${encodeURIComponent('printerName')}`,
).then((r) => r.json());
const history = await fetch(
`http://127.0.0.1:7071/printer/getJobHistory?printerId=${encodeURIComponent('printerName')}&limit=20`,
).then((r) => r.json());
await fetch('http://127.0.0.1:7071/printer/cancelJob', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ jobId: 1 }),
}).then((r) => r.json());指令打印
// printType: 'raw' 直接透传已编码指令, 不打开模板渲染窗口
const text = '^XA^FO50,50^FDsv-print^FS^XZ';
const bytes = Array.from(new TextEncoder().encode(text));
const result = await fetch('http://127.0.0.1:7071/printer/print', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
printer: 'printerName',
printType: 'raw',
commandPages: [
{
protocol: 'zpl',
text,
bytes,
},
],
waitForCompletion: true,
jobName: 'sv-print指令打印',
buffer: true, // 回执返回 commandText / buffer
}),
}).then((r) => r.json());
// => { success: true, msg: '打印成功', data: { protocol, commandText, buffer, jobIds } }预览与窗口
// 打印前先打开客户端预览窗口, 确认后再打印
await fetch('http://127.0.0.1:7071/printer/print', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
printer: 'printerName',
printType: 'html',
html: '<h1>sv-print</h1>',
preview: true,
title: '打印预览',
}),
}).then((r) => r.json());
// socket / mqtt 打开管理窗口
socket.emit('openPrinterStatusWindow', { printerId: 'printerName' });
socket.emit('openCommandWindow', { printerId: 'printerName' });
socket.emit('openPaperWindow', { printerId: 'printerName' });
socket.emit('openPrinterSettings', { printerId: 'printerName', options: { page: 'preferences' } }); // preferences | properties | queue2026-10-10
sv-print静默打印客户端@2.0.9
- 🌈 新增 打印机 纸张管理 功能 & api: 打印机详情新增纸张管理面板(纸张列表/搜索/刷新/自定义纸张尺寸), 新增 paperSizes、validatePaper、customPaper 三个接口.
- 🌈 新增 适配 云打印SaaS 功能.
- 🌈 新增 自定义 http 服务端口 可配置(1024 ~ 65535, 默认 7071).
- 🌈 新增 openDevTools api, 打开指定打印窗口 / 模板渲染窗口的开发者工具; 预览窗口新增 调试 按钮.
- 🌈 新增 打印日志 刷新 按钮.数据 使用 codemirror 编辑器查看, 支持 编辑数据后重打; 打印机详情数据同样改用编辑器查看.
- 🌈 新增 任务栏显示 开关(是否在任务栏/dock中显示应用图标-显示窗口后).
- 🌈 新增 自定义渲染设置 开启模板渲染窗口 开关, 关闭后传模板json打印不可用, 减少内存占用.
- 🌈 新增 capture 打印支持传递 captureOptions(snapdom 参数, 默认 dpr: 2).
- 🌈 新增 设计器插件升级: 骑缝章、word文档、excel、组合框、表格、pdf、textAuto、formatter 等元素/插件.
- 🌈 新增 渲染器资源更新(在线定制下载), 新增 pdfjs、elePdf、eleSeal、textAuto、formatter、eleW2html、eleBox、eleStable 等插件资源.
- ✨ 优化 http 调用 print 时返回 执行结果(success / msg / data), 需等待队列任务完成.
- ✨ 优化 最小化/关闭窗口 逻辑: 关闭不退出应用, 按 showInTaskbar 决定最小化到任务栏或隐藏到托盘; 协议唤醒时自动显示窗口.
- ✨ 优化 pdf-to-printer 升级到 5.8.1, windows pdf 打印支持 paperKind 参数.
- ✨ fix 渲染器异常 & 部分 UI 问题.
🎮 代码示例
纸张管理
// http 服务方式
// 纸张列表(单位: 微米, 同时返回 mm)
const list = await fetch(
`http://127.0.0.1:7071/printer/getPaperSizes?printerName=${encodeURIComponent('printerName')}`,
).then((r) => r.json());
// => { ok: true, printerId, papers: [{ name, widthMm, heightMm, widthMicrons, heightMicrons, paperCode? }] }
// 校验自定义纸张尺寸是否受驱动支持
const validate = await fetch('http://127.0.0.1:7071/printer/validatePaper', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
printerName: 'printerName',
widthMicrons: 210000,
heightMicrons: 297000,
}),
}).then((r) => r.json());
// => { ok: true, supported: true, orientation, reason?, validatedWidthMicrons?, validatedHeightMicrons? }
// 构造一个打印任务可用的自定义纸张描述并校验
const custom = await fetch('http://127.0.0.1:7071/printer/customPaper', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
printerName: 'printerName',
widthMicrons: 80000,
heightMicrons: 60000,
}),
}).then((r) => r.json());
// => { ok: true, supported, custom: true, driverWidthMicrons?, driverHeightMicrons?, reason? }打印选项
// http 调用 print, 现在会等待队列任务完成并返回执行结果
const result = await fetch('http://127.0.0.1:7071/printer/print', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
printer: 'printerName',
printType: 'html',
html: '<h1>sv-print</h1>',
copies: 2,
landscape: false,
duplexMode: 'longEdge',
// capture 打印可透传 snapdom 参数
captureType: 'jpeg',
captureOptions: { dpr: 3, backgroundColor: '#fff' },
}),
}).then((r) => r.json());
// => { success: true, msg: '', data: ... }调试工具
// 打开打印窗口 / 模板渲染窗口 的开发者工具 (已打开则关闭)
await fetch('http://127.0.0.1:7071/printer/openDevTools', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ printerName: 'printerName', isRenderer: false }),
});2026-06-30
sv-print静默打印客户端@2.0.8
- 🌈 新增 支持 自定义渲染器 在线更新.
- 🌈 新增 支持 socket服务 https 开关设置 和 http 服务开关设置.
- 🌈 新增 sv-print:// 协议打开客户端.
- 🌈 新增 sv-print://route?page=/setting&query=tabIndex=1 (记得转码!)打开应用内对应页面.
- 🌈 优化 新增 应用内更新开关 地址配置.
- 🌈 优化 托盘菜单 新增设置,显示渲染窗口,软件日志,渲染器资源等入口.
- 🌈 优化 显示 连接数量数据 & 新增 获取连接信息,连接数量的 API.
- 🌈 新增 pdfPrintMethod: 2 使用新的pdf打印处理器.
- ✨ 优化 拖入 自定义渲染器、配置文件 时 提示是否重启应用.
- ✨ 优化 应用设置 保存逻辑(无需重启应用,重启服务相关配置).
- ✨ 优化 打包体积.
- ✨ fix 部分UI 问题.
🎮 代码示例
页面路由
// 例如: sv-print://route?page=/setting&query=tabIndex=1
// 将对象转为查询字符串
const queryString = new URLSearchParams({ tabIndex: 1 }).toString();
const encodedQuery = encodeURIComponent(queryString); // 对整个 query 值进行编码
const url = `sv-print://route?page=${encodeURIComponent('/settings')}&query=${encodedQuery}`;
// 支持的路由
const routes = {
'/desktop': '首页',
'/templates': '模板中心',
'/printer': '打印机',
'/history': '打印日志',
'/settings': '设置',
};连接数据
// http 服务方式 (get)
// 连接数量
const url = `https://127.0.0.1:7071/printer/clientsCount`;
// 连接信息
const url = `https://127.0.0.1:7071/printer/clients`;2025-12-21
sv-print静默打印客户端@2.0.7
- 🌈 客户端 新增 io 事件 处理 w2html 本地文件.
🎮 代码示例
w2html插件
import pluginEleW2html from '@sv-print/plugin-ele-w2html';
import pluginE2Table from '@sv-print/plugin-ele-e2table';
const plugins = [
pluginEleW2html({
// 需要借助 sv-print客户端^2.0.7 才能处理本地文件
type: 'base64', // 默认 base64. 上传类型 base64 | upload
options: {
// type:upload 时 axios 上传配置
url: 'http://localhost:3000/api/core/upload',
headers: {},
params: {},
timeout: 10000,
},
// placeholder: "<div>粘贴word文档内容</div>", // 元素占位 html
}),
pluginE2Table({
placeholder: '<div>粘贴excel表格内容</div>', // 元素占位 html
}),
];
hiprint.register({
authKey: '', // 授权key
plugins: plugins,
});2025-10-21
sv-print静默打印客户端@2.0.6
- ✨ 优化 更新最新版本在线设计器(sv-print@0.2.8).
- ✨ 新增 win7系统兼容版本.
- ✨ 优化 http服务 端口改为 0.0.0.0
- ✨ 优化 使用本地ee-core版本(功能优化:静态服务).
- ✨ fix 默认参数导致部分打印机无法正常打印问题.
2025-08-13
sv-print静默打印客户端@2.0.5
可应用内更新, 重启应用即可.
- ✨ 优化 更新最新版本在线设计器
- ✨ fix 新窗口打开在线设计BUG
2025-08-12
sv-print静默打印客户端@2.0.4
小程序-云打印、获取图片、pdf 测试:

- 🌈 新增支持 应用内更新(全量更新/增量更新).
- 🌈 新增支持 拖拽 config.json 更新配置, xxx.zip 更新渲染器.
- 🌈 新增支持 type: capture (兼容render-jpeg)返回图片.
- ✨ 优化 在线设计, 重写 Header: 保存顿号、编辑/导出.
- ✨ 优化 模板中心, 在线设计新增,编辑时 刷新列表.
- ✨ 优化 兼容中转服务, render-xxx API 和 回调 render-xxx-success、render-xxx-error.
- ✨ 优化 更新默认渲染器为最新版本.
- ✨ 优化 托盘菜单 新增:检查更新、重启.
- ✨ 优化 统一在队列执行完成事件中 处理回调事件(支持 socket.io、mqtt)
- ✨ 调整 原pdf缓存路径,改为缓存文件路径(pdfPath -> tempFilePath) 缓存pdf,图片.
🎮 代码示例
这里使用 sv-print 内置的 socket.io 对象, 默认连接 http://localhost:17521/
hiwebSocket.socket.on('success', (e) => {
console.log(e);
});
hiwebSocket.socket.on('error', (e) => {
console.log(e);
});
// 兼容 默认的 print2 方法
hiwebSocket.socket.emit('news', {
// "printer": "PDFwriter",
type: 'capture',
// capture 打印 返回的类型 canvas.toDataURL('image/' + captureType) 同时也是扩展名
captureType: 'jpeg',
buffer: true,
// "toNet": true, // 是否仅渲染返回 网络pdf地址
template: {}, // 模板json
printData: {}, // 打印数据
templateId: 'aec8bc1a-f53a-44d4-81dd-13c5a363f612', // 用于 success,error 回调中区分是哪个模板
});
// 可统一使用
hiwebSocket.socket.emit('print', {
// "printer": "PDFwriter",
type: 'capture',
// capture 打印 返回的类型 canvas.toDataURL('image/' + captureType) 同时也是扩展名
captureType: 'jpeg',
buffer: true,
// "toNet": true, // 是否仅渲染返回 网络pdf地址
template: {}, // 模板json
printData: {}, // 打印数据
templateId: 'aec8bc1a-f53a-44d4-81dd-13c5a363f612', // 用于 success,error 回调中区分是哪个模板
});📷 示例截图



2025-08-01
sv-print客户端@2.0.3
- ✨ 新增 MQTT服务,并提供了MQTT在线测试HTML.
- ✨ 新增 预览功能,打印日志支持预览打印的模板/html.支持自定义预览渲染器
- ✨ 优化 在线设计功能,支持新窗口打开,支持自定义设计器地址
- ✨ 优化 模板中心功能,支持自定义API请求
- ✨ fix 多打印机自动创建渲染窗口BUG, 默认最大 3 个渲染窗口.
版权所有
版权归属:sv-print
