Device Hub：安装、配对与打印

浏览器应用与仓库硬件之间的本地桥：工作站安装、一次配对、接打印机/秤，在打印中心看打印队列。

Device Hub 是什么#

浏览器沙盒开不了 raw TCP / USB / 串口，所以网页版 WMS 无法直连 ZPL 打印机、电子秤。Device Hub 是装在仓库每台工作站电脑（Windows PC / Mac）上的托盘常驻应用，作为"浏览器 ↔ 硬件"的桥：开机自启，后台无感运行。Tauri v2 构建，一套代码出 Windows + macOS（Intel/Apple Silicon）。

下载与安装#

1. 从官网下载页获取（/zh/download 或 /en/download）：按系统自动推荐 Mac DMG / Windows MSI（Universal 通用版）。
2. 下载 → 安装 → 一路 next-next-finish。全程零手动步骤：不用手装驱动、不用敲命令、不用改配置文件。
3. 首次运行 setup wizard：① 显示配对码 → ② 自动发现打印机（mDNS + USB），勾选设备、设默认 label 打印机 → ③ 完成。
4. 开机自启动，后台无感运行。

配对#

1. Hub 托盘图标显示 6 位配对码。
2. 在网页端输入一次完成配对：打印时弹出的配对框，或 Admin → 打印设备页（Hub 配对管理也在这里）。
3. 配对后下发 token（存浏览器 localStorage），之后每次 WebSocket 握手都带 token。默认只绑 127.0.0.1，外网扫不到；局域网模式（手机/平板打印用）为 opt-in，开启后仍要求 token。

连接打印机#

• ZPL 打印机（Zebra 等）：USB / 网口 9100；Hub 裸发 ZPL，并轮询打印机状态（缺纸/缺碳带/开盖）。
• 网页端打印按钮统一走 SDK 发给 Hub。未安装 Hub 时，打印按钮弹"未检测到 Device Hub"卡片，按平台给下载链接；保留下载 ZPL 兜底。
• 默认标签打印机：在打印设备页设默认标记（is_default_label_printer），打印按钮就知道往哪发任务。
• 电子秤走串口 / USB串口接入，可配置波特率、前缀/后缀、单位；支持常见连续输出协议（如 Mettler Toledo、CAS、AND）。在打印设备页登记为 scale 类型设备。

手机云打印链路#

1. 手机网页点打印 label → POST /api/wms/print-jobs → print_jobs 表（queued，含 zpl_content）。
2. 仓库电脑 Device Hub 订阅 Supabase Realtime（兜底 3 秒轮询）→ 原子领取（UPDATE … WHERE status='queued'，0 行 = 任务已被取消，就不打，防打错）。
3. 本地 Zebra 打印 → 回写 done/failed → 手机轮询状态反馈。

打印中心（Admin 应用）#

• 打印队列：print_jobs 全表；筛选状态/仓库/打印机/标签类型/时间；>5 分钟未处理高亮；queued 可取消、failed 可补打；Realtime 实时刷新；WMS 打印按钮提交后给跳转链接。
• 打印设备：devices 全表；在线/离线按 last_seen_at 心跳算（阈值 2 分钟）；连接方式、默认标签打印机标记、所属 Hub；Hub 配对管理也在这里。