帮助文档
一、商户：从零开始
在首页点「注册入驻」，填店铺信息与管理员账号，等待审核。
审核通过后用账号登录
/admin。准备盒子：一台装 Ubuntu 的设备，接好打印机，装 CUPS（
sudo apt install cups）。在盒子上部署 Agent：拷贝项目后执行
bash box/deploy_box.sh。配置
box/box.env：填平台地址、盒子名称、默认打印机、注册密钥。启动后盒子自动注册并连上云端，后台「盒子管理」里能看到它在线。
给盒子分配所属租户 → 下载二维码 → 打印贴在机器上。
二、顾客：怎么打印
用微信扫描盒子上的二维码（或在小程序里点「扫码」）。
选择要打印的文件（可从微信聊天记录里选 PDF / Word / 图片）。
设置份数、彩色/黑白、单双面、页码范围，有多台打印机时还能选打印机。
点「提交打印」，页面会显示 排队中 → 打印中 → 已完成。
三、盒子部署细节
| 开机自启 | 用 systemd 部署会自动拉起；WSL 环境需在 /etc/wsl.conf 开启 systemd=true |
|---|---|
| 心跳与离线 | 盒子每 30 秒心跳一次，超过 90 秒无心跳后台显示离线 |
| 远程操作 | 后台可远程查状态、刷新打印机、打测试页、改配置、重启盒子 |
| 多打印机 | 盒子自动发现并上报，顾客下单时可选择 |
| 盒子本地管理页 | 盒子自身还带一个局域网管理页 http://盒子IP:8080，用于现场调试 |
五、支持的文件格式
| PDF / 图片 / 文本 | 直接打印（pdf、png、jpg、txt 等） |
|---|---|
| Word / Excel / PPT | 盒子自动用 LibreOffice 转成 PDF 后打印 |
如果盒子没装 LibreOffice，传 Word 会提示"需要转换，请改传 PDF"——不会打出乱码。
建议顾客优先传 PDF，最稳妥。
四、常见问题
扫描后一直「排队中」不出纸？
说明盒子没收到任务：检查后台该盒子是否「在线」；离线就去看盒子网络与 Agent 进程。
提示「盒子不存在」？
盒子 ID 与后台不一致，通常是重新注册过。重新生成并打印新的二维码即可。
打印出来空白或乱码？
多为 CUPS 不支持该文件格式，建议用 PDF；Word 请先转成 PDF 再打印。
顾客打印报错但盒子正常？
到后台「打印订单」看失败原因，可一键「重投」；也可下载原文件排查。
盒子需要公网 IP 吗？
不需要。盒子主动连云端（WebSocket），只要能出网即可。