简体中文
收款精灵:收款、播报与账务
屏幕金额识别(OCR)
首次使用时,在「收银设置 → 收款配置」框选收银软件的合计金额区域,之后自动识别:
- 显示器缩放或分辨率变化后需要重新框选;再次框选会回到上次的位置;
- 「测试识别」可即时验证当前框选区域;
- 识别失败时静默降级为手工输入,不会猜测金额;
- 自动收款默认关闭。开启后可设置置信度门槛,低于门槛仍要求人工确认;
- 同额连单抑制:收款成功后 10 秒内,同额自动收款会被拦回人工确认。
OCR 使用 OnnxRuntime 加载本地 v7 tiny 模型,识别在本机完成。
被扫收款
扫码盒读到顾客付款码后,付款码直接进入收银台。收银台也提供计算器式面板,可以手工输入金额。确认收款后调用平台发起被扫支付并等待结果:
- 支付成功:语音播报金额,按设置打印小票;
- 支付中:继续等待平台返回最终状态;
- 支付失败或订单关闭:提示失败原因,不把未知状态当作成功。
扫码盒支持 HID 键盘仿真与 HID POS 两种模式。插上设备后,在「收银设置 → 扫码盒」选择设备并扫一张付款码测试。精灵在后台运行也不影响扫码。
平台返回 wait / progress 时,按 1.5 秒间隔轮询,最长 20 秒,每第 3 次带 sync=true 强制同步。HTTP 响应丢失时按 bizOrderNo 回查恢复,不重复发起支付。
桌面形态
- 悬浮金额条:左键拖动,右下角手柄调整大小,双击打开收银台,右键菜单提供收银台、主界面、主题切换和退出;透明度与位置在「收银设置 → 通用」中调整并记忆;
- 全局热键:默认
Ctrl+Alt+D打开收银台、Ctrl+Alt+S打开主界面;「重打上一笔」与「打开 / 收起交易记录」默认未设置,可在「收银设置 → 热键」录入; - 收银台快捷键:
Enter在金额框且没有付款码时跳到收款码,否则确认收款;Esc隐藏;Tab/Shift+Tab在金额与付款码之间切换;Ctrl+Backspace清空金额;Ctrl+P重打上一笔;F1查看快捷键一览; - 托盘:程序常驻托盘,双击打开收银台,右键菜单提供收银台、打开主界面和退出;托盘「退出」是唯一完全退出程序的入口。
播报与小票
语音播报:收款成功后播报金额。系统中文语音包可用时用 TTS 合成,不可用时自动降级为内置 WAV 词表拼接。可在「收银设置 → 语音播报」调整开关、音量与输出设备。
小票打印:在「收银设置 → 打印机」启用打印并选择通道:
| 通道 | 说明 |
|---|---|
| USB 打印机(免驱动) | 直接选择 USB 小票机设备,无需安装打印机驱动 |
| 网络打印机 | 填写打印机 IP 与端口,端口默认 9100 |
| 文件转储 | 调试通道,打印指令写入数据目录的 print-dump,不在设置界面显示 |
纸宽可选 58mm 或 80mm,内置版式按纸宽自适应;联数可选 1 至 4 联,改动即时生效。设置页可打测试页;收款成功自动打印,打印失败只提示,不打断收银。
退款、查单与重打
在「交易记录 → 收款」中对收款行操作:
- 退款:支持全额或部分退款,本机账本校验可退余额,最终以平台为准;
- 查单:主动向平台查询并同步订单最新状态;
- 退款记录:在「交易记录 → 退款」中只读展示,并与原收款单关联;
- 重打上一笔:全局热键重打今日最近一笔成功收款的小票,重启后仍可补打。
未支付的订单到期后由平台自动关单,收银员不需要手工处理。
账务口径
- 平台是交易真相源:支付、退款、关单状态最终以平台为准;
- 本机账本只做镜像,用于断网查看历史、交易记录与重打小票;
- 退款金额的本机校验只是提前拦截,平台判定才生效;
- 小票版式为本机内置模板,不支持服务端模板管理。
现场问题
打印不出小票
先在「收银设置 → 打印机」打测试页,按顺序检查:打印机是否开机、USB 是否连接或网口是否连通;通道是否选对,USB 通道要选中正确设备,网络通道要确认 IP、端口(默认 9100)、与收银机同网段且防火墙放行;纸宽是否与实际纸张一致。打印失败只提示,可用重打上一笔补打。
OCR 金额识别不准
重新框选收银软件的金额区域,显示器缩放、分辨率或收银软件主题变化后都需重框;用「测试识别」验证当前区域。自动收款默认关闭,开启后低于置信度门槛仍要求人工确认;收款成功后 10 秒内的同额自动收款会被拦回人工确认。
扫码盒扫了没反应
在「收银设置 → 扫码盒」确认设备已被选中;换到 HID 模式后重新插拔;确认扫码监听已启用。不要同时开多个扫码监听工具,避免输入被收银软件或其他工具抢走。