webprint打印 0.6.3 · Windows / macOS 0.6.3 新增 USB / 系统驱动支持:选中打印机后点击“驱动与切纸”,查看厂商提示并打开当前队列的打印首选项。多份打印可选“每份单独发送”,配合驱动的任务结束切纸。需安装对应型号的厂商驱动,具体切刀能力以机型为准。详见附带的 USB驱动与切纸说明.txt。 0.6.2 新增切刀兼容:ESC/POS 全切/半切、每份或整批后切、切前走纸行数与基础/送纸切刀指令;TSPL 每张/整批全切;ZPL 每张全切。选中已保存的网口机后点击“切纸设置”即可修改,不必重新添加。未激活时仍可打印,输出带“webprint打印 · 未激活”水印;有效激活或试用后移除。 本版 Windows / Mac 均更新至 0.6.3。软件包不包含正式授权服务器或商户密钥,暂未开放购买。 历史 0.5.4 Windows 包内置 WebPrint JS SDK 0.6.0,示例使用 WebPrint.Printer、printer.init()、printer.addText()、await printer.print() 等新命名。旧接口继续兼容。安装目录 resources 中附带 HTTPS 自动打印接入说明与 WebPrint JS SDK 接入说明;业务网站需另外更新完整 SDK 静态目录。当时 Mac 安装包沿用 0.5.3。 0.5.3 将应用统一命名为“webprint打印”,同步更新窗口、托盘、桌面快捷方式、启动应用和安装包名称。升级保留原有配置及自启动开关;Windows 旧启动项会迁移到新名称,Mac 从新包打开“webprint打印.app”。 0.5.2 修复 Windows 开机自启动状态误报:系统返回值省略后台参数时,仍能正确识别已有启动项并开关设置。更新时先退出旧版软件,再覆盖安装,原有打印机、端口和连接配置会保留。 本版已内置网页打印测试和服务配置调试页面。首次启动自动选择可用随机端口并保存;旧版本升级会继续使用原有端口。 直接点击软件右上角“打开网页打印测试”或“服务配置与调试”,浏览器会自动连接,无须单独部署 HTML,也无须为内置页面配置允许来源。 网页地址与打印接口共用同一个端口,以软件界面显示的实际地址为准。 接入配置现可下拉选择本机/局域网地址,并保存多台打印端。网桥模式也可配置服务器地址、独立端桥编号和连接令牌。 新增“保存打印机”:网页或软件中选好设备后点击保存,下次连接会自动选中;各打印端分别记住,重启或修改本机端口后仍有效。 HTTPS 业务网页自动连接:首次在软件配置页开启“允许自动连接”,加入业务网页来源并保存打印机。旧版本升级后需首次手动开启。之后业务网页 JS 可自动查找本机服务并使用已保存设备;浏览器可能要求允许本地网络访问。该功能仅向授权来源提供临时打印凭据,不要求安装本地证书。网站接入步骤见开发方提供的 HTTPS 自动打印说明。 一、选择安装包 Windows 10/11 64位:运行 Windows 安装程序。也可使用免安装 ZIP,必须完整解压后打开 webprint打印.exe,不要只取出一个 EXE。 Mac 需要 macOS 13 或更高版本。 Mac Apple 芯片(M1/M2/M3/M4 等):使用 mac-arm64 版本。 Mac Intel 芯片:使用 mac-x64 版本。 Mac 打开 DMG 后,把 webprint打印 拖到 Applications(应用程序)再打开。 软件已带运行环境,不需要 Node、Python、Java 或开发工具。测试包没有 Windows 发行签名、Apple 公证;系统可能要求手动批准打开。请只使用由本次测试负责人发送的包,不要关闭系统整体安全防护。 二、首次测试本机打印机 1. 安装打印机厂商提供的系统驱动,先确认 Windows/macOS 系统测试页能打印。 2. 打开 webprint打印,选择“本机 / 网口”,在打印机列表中选择设备。 3. 选择 80mm 小票、58mm 小票、60×40mm 标签、尺寸校准或 A4 样张。 4. 确认页面宽高和打印机驱动中的纸张一致。小票或标签的自定义纸张,可能需要先在系统驱动中建立。 5. 点击“打印测试样张”。软件按100%尺寸提交,不主动缩放到纸张。 6. 用“尺寸与偏移校准”样张核对实际毫米尺寸,再按需要调整水平或垂直偏移。 记住打印机:在打印机下方点击“保存打印机”,看到“已保存”后生效。网页与桌面软件共用当前软件中的保存结果;点击“取消保存”可恢复默认选择。 保存只记住目标设备,不会自动打印,也不修改系统默认打印机。切换到其他打印端时分别恢复各自保存的设备;原设备被移除或未在列表中出现时,会要求重新选择,不会改投其他打印机。 纸张、份数及样张仍按当前页面设置。更新软件请保留原有应用数据,以继续使用已保存的端口、连接和打印机选择。 纸张宽度不等于打印头点宽:系统驱动模式填页面尺寸;网口指令模式填实际可打印宽度。80mm 小票机常见 576点/约72mm,58mm 常见384点/约48mm,最终以设备参数为准。 纸张设置如果被驱动覆盖、切纸留白过长、硬件存在不可打印边缘,请同时记录驱动纸张设置并反馈。 三、直接连接网口小票机或标签机 1. 打印机与电脑连接同一局域网,确认打印机的 IPv4 地址。 2. 点击“添加网口打印机”,填写设备 IP、端口(常见9100)和打印语言。 3. 小票常见 ESC/POS;标签常见 TSPL、ZPL 或 CPCL。必须按设备说明选择,不能只按品牌判断。 4. 设置实际 DPI、可打印宽度、标签间隙或黑标。设备确实有自动切刀时才启用切纸。ESC/POS 可选择全切/半切;TSPL 支持每张全切或整批后切;ZPL 支持每张全切,CPCL 暂须机型适配。 5. 保存后选择设备和样张,先打印1份。选中该网口机后可点击“切纸设置”,调整后保存;已有任务时请等其发送完成再修改。 6. ESC/POS 默认使用送到切刀位置后切纸;不支持的机型可改为基础切纸,并设置足够的额外走纸行数。确认单份无截断后,再用2份核对每份切或整批切一次。 7. USB/系统驱动模式请在厂商驱动的打印首选项里启用每页或任务结束切纸。本软件不另发切刀指令,不自动猜测协议或重发切纸。 此模式无须系统打印驱动。当前只连接局域网 IPv4,不自动扫描。通用蓝牙、USB串口或收银机内置私有接口不属于这个桌面版的直连范围;USB打印机可通过系统驱动打印。 网口直连按单页提交,多份标签用份数设置。CPCL通用适配为200/203dpi;黑标等机型专用设置仍需另行适配。 四、通过另一台电脑的局域网打印端打印 打印机所在电脑:打开 webprint打印,展开“本机局域网服务与网页接入”,点击“复制接入配置”。 测试电脑:打开同一软件,选择“局域网打印端”,把复制的整段配置粘贴到地址框,会自动填入地址和令牌,再点击连接。 两台电脑须能互相访问。首次出现系统网络/防火墙提示时,请根据实际局域网环境允许本软件连接。启动时原端口被占用,软件会改用并保存可用端口,以界面显示为准。 复制的配置含访问令牌,只发给参与测试的人员;反馈报告不包含令牌。不需要公网、云账号或路由器公网端口映射。 打印端软件必须保持运行;完全退出后本机服务停止。Windows 关闭主窗口会继续在右下角托盘运行。Mac 关闭窗口仍会退出。 五、使用内置网页与修改服务端口 1. 本机测试:点击“打开网页打印测试”,自动打开浏览器并连接,选择打印机和样张即可。 2. 其他电脑测试:点击“复制网页地址”,在另一台电脑浏览器打开,再粘贴“复制接入配置”的内容连接。 3. 点击“服务配置与调试”,可查看服务端口、打印机和最近任务,修改端口、局域网访问开关与其他业务网页来源。 4. 指定端口可填写1024–65535;点击“随机换端口”或填写0后保存,会选择一个新端口并显示新地址。 5. 随机分配的端口会保存,重启软件继续使用。其他业务系统更换端口后需要重新复制接入配置。 6. 保存时会等待当前打印任务处理完毕,再切换服务。端口冲突会明确提示并保留原地址;切换失败会恢复原设置。 7. 网页修改后会自动切换地址;关闭局域网访问后,其他电脑无法继续访问,需在打印机所在电脑从软件重新打开。 软件打开的浏览器链接采用单次使用的临时打开凭证,网页加载后立即从地址栏清除。复制或刷新该链接不会重复自动登录,请从软件重新打开或填写接入配置。 独立的 file:// HTML 仍只能离线预览;请使用本软件实际提供的 HTTP 网页地址。 六、选择并保存多台打印端 1. 从软件打开网页打印测试,在“接入配置”列表选择本机或局域网地址,点击连接。 2. 连接另一台电脑:选择“手动填写 / 粘贴其他打印端配置”,粘贴对方软件复制的配置,然后连接。 3. 填写连接名称,如“前台收银机”或“仓库标签机”,点击“保存当前连接”。之后可直接从下拉列表选择,再点击连接。 4. 选择保存项后可改名并保存,也可删除保存项。删除保存项不移除打印机,不取消已经提交的任务。 5. 连接列表保存在当前提供页面的打印软件里,最多50项。令牌使用操作系统凭据机制加密,不写入浏览器存储或测试报告。 6. 新安装包不包含任何客户连接配置。不同系统用户或不同电脑应分别保存凭据;系统加密不可用时仍可临时连接,保存功能会明确提示不可用。 7. Mac 保存/使用已保存的连接或启用网桥时,系统可能请求钥匙串授权,请只在 macOS 系统窗口输入密码。单纯打开页面、查看列表和局域网打印不会主动读取系统加密密钥。 七、配置云端网桥服务器 1. 打开“服务配置与调试”,找到“云端网桥服务器”,勾选启用。 2. 服务器地址填写如 wss://print.example.com/bridge 或 http://192.168.1.10:8000。 HTTP/HTTPS 会自动转换为 WS/WSS;省略路径时使用 /bridge。 本机随机服务端口和云端服务器端口分别配置,不能混用。 3. 填写服务器登记的端桥编号,如 store-01,以及服务器为它配置的端桥连接令牌。 每台端桥应使用独立编号;本机网页访问令牌、服务器业务 API 令牌和端桥连接令牌分别管理。 4. 服务器必须支持本项目的 WebPrint WebSocket 网桥协议,并登记相同编号和令牌。任意 HTTP 打印服务器不能直接当作本协议的网桥服务器。 5. 点击“保存网桥参数并应用”。状态应从连接/登记变为“已连接”;地址、编号、令牌或网络错误会显示重连状态与原因。 6. 保存后令牌框留空表示沿用当前令牌。修改服务器或端桥编号时,必须重新填写对应令牌。 7. 网桥接收云端任务后,仍由当前电脑上的驱动或网口设备打印。软件必须保持运行。关闭网桥后仍可局域网打印。 8. 有尚未完成的网桥任务时,需等待这些任务完成后再切换服务器、编号或关闭网桥,防止遗留任务。 八、检查并反馈打印效果 请检查: - 中文、数字、金额是否完整,字体是否清晰。 - 纸张宽高、方向、左右边距、整体偏移是否正确。 - 条码和二维码能否用真实扫码设备或手机识别。 - 标签每张是否定位正确,有没有连续空白、跨标签或黑标识别问题。 - 小票是否正常走纸、切纸,有没有多打或漏打。 在“测试反馈”填写观察结果,再点“导出测试反馈”。请把 JSON 报告与实际纸张照片一起发给测试负责人。 报告含系统、驱动、纸张、连接目标和任务结果,不含访问令牌或打印模板正文。 “已提交”表示软件/连接层已接收,不表示确认物理出纸。出现“结果待确认”时请先检查打印机,避免直接重复点击造成多打。 九、Windows 托盘、桌面快捷方式与开机自启动 1. 安装程序会创建“webprint打印”桌面快捷方式。双击快捷方式会打开软件;已经运行时恢复已有窗口,不会启动第二个打印服务。 2. 软件启动后显示右下角托盘图标。Windows 可能把图标放在“显示隐藏的图标”内,可按需要拖到任务栏通知区域。单击或双击图标可打开主窗口。 3. 关闭主窗口后,打印服务继续后台运行,网页和网桥仍可提交打印。需要完全停止时,右键托盘选择“退出打印服务”;软件会等待正在处理的任务再退出。 4. Windows 正式包首次运行默认设置开机自启动;在当前用户登录 Windows 后后台启动,不弹出主窗口。在软件底部“Windows 后台运行”或托盘菜单中可关闭/重新开启。软件尊重用户在 Windows 启动应用中作出的禁用选择,不会在每次打开时强行开启。 5. 桌面快捷方式丢失时,可在软件底部或托盘菜单点击“创建桌面快捷方式”。 6. 使用免安装 ZIP 时,请先完整解压到固定目录再打开。移动或删除该目录后,旧快捷方式和自启动路径会失效,需要从新目录打开软件后重新设置。 7. 卸载安装版会清理指向当前安装目录的开机启动项;正常升级保留原有启动选择。不安装 Windows 系统服务,不要求在登录前启动。 8. 以上三项为 Windows 功能,Mac 不写入开机启动项或桌面快捷方式。 十、当前验证边界 软件链路、PDF尺寸、二维码静区和网口字节发送经过开发机验证。开发机没有连接客户型号打印机;Windows安装运行、不同系统驱动、设备走纸/切刀/传感器/吞吐仍需要本次客户真机测试。 本包是局域网打印效果测试软件,功能范围以接入文档和实际验收为准。支持导入图片和本项目 JSON 模板,PDF可导出核对,暂不支持直接导入外部PDF打印。