Skip to content

收款精灵:概览与链路 ​

更新时间:2026/11/10 10:51:10

收款精灵是运行在 Windows 收银电脑上的旁挂式收款助手。它不改造收银软件:扫码盒读取顾客付款码完成被扫收款,OCR 识别收银软件屏幕上的金额并带入收款,收款成功后语音播报、按需打印小票。适合有固定收银电脑的线下门店,支持多门店、多终端。

定位与工作方式 ​

收银电脑上同时运行原有收银软件和收款精灵。收款精灵负责三件事:

  1. 通过扫码盒读取顾客出示的付款码,或识别收银软件显示的应收金额;
  2. 调用 DaxPay 商户收银接口发起被扫收款,并等待支付结果;
  3. 收款成功后语音播报金额、按需打印小票,同时把交易流水记入本机账本。

收款精灵只负责「收钱」这一步。支付结果的真相源始终是平台,本机账本只做镜像和历史查看。

核心能力 ​

能力说明
被扫收款扫码盒支持 HID 键盘仿真与 HID POS(0x8C)两条通道,后台读取付款码后直接进入收银台;收银台另提供计算器式面板,可手工输入金额
OCR 金额识别框选收银软件的金额显示区,由本地模型识别,金额稳定后显示到悬浮条;识别失败时静默降级为手工输入,不猜金额
语音播报收款成功播报金额;系统中文语音包不可用时自动降级为内置 WAV 词表拼接
小票打印58 / 80mm ESC/POS 热敏小票机,支持 USB 免驱直发、网口 RAW TCP(默认 9100)与文件转储;1 至 4 联,二维码与条形码按位图渲染
退款 / 查单在交易记录中对收款行发起全额或部分退款,主动向平台查单同步状态;未支付订单到期由平台自动关单
多门店 / 多终端登录后拉取启用门店、应用与终端;单店自动选中,多店弹窗选择,门店跟机器走;终端号可在本机配置
重打上一笔全局热键重打今日最近一笔成功收款的小票,重启后仍可补打
本机账本本地保存收款、退款流水,断网也能查看历史;平台为交易真相源
悬浮金额条与托盘悬浮条可拖动、调整大小与透明度并记忆位置;托盘常驻,支持开机自启、检查更新与快捷入口

本版只做被扫收款,不包含主扫(商家出示收款码、顾客扫码付款);小票版式使用本机内置模板,不支持服务端模板管理。

运行环境 ​

项要求
操作系统Windows 10 1607 及以上(64 位)或 Windows 11
运行时标准版自带 .NET 10;轻量版需预装 .NET 10 Desktop Runtime
扫码盒HID 键盘仿真或 HID POS(0x8C),USB 接口
打印机58 / 80mm ESC/POS 热敏小票机,USB 或网口(RAW 9100)
服务端DaxPay 4.0.0-beta10 及以上,含 daxpay-payment-elf 模块
账号商户端创建的收银员账号,角色为「商户收银员」(merchant_cashier)

桌面程序当前版本为 0.1.x,使用独立版本线,不跟随平台 4.0 的版本号。

账号与安全 ​

  • 使用商户身份域登录,只能使用商户端账号,不能使用运营端账号;
  • 密码经 RSA 公钥加密后传输,并带 nonce 防重放;连续登录失败会要求图形验证码;
  • 支持 TOTP 两步验证,开启后登录需输入动态口令;
  • 登录凭证只保存在内存中;勾选「记住密码」时,账号密码经 Windows DPAPI(当前用户)加密后存本机;
  • 本机凭据文件为数据目录下的 credential.bin,token 不落盘。

获取方式 ​

收款精灵与收款播报 APP 均按 DaxPay 生态扩展包档位交付,以源码形式提供(含源码授权)。获取方式与授权条款以官网定价页为准。

继续阅读 ​