主题
收款精灵：工具概览
收款精灵是运行在 Windows 收银电脑上的桌面应用（WPF / .NET 10）：常驻收银软件旁边，读取屏幕上显示的金额，顾客亮付款码即完成被扫收款；收款成功本机播报、自动打印小票，订单同步到 DaxPay 平台。不改造收银软件、不装驱动。
当前版本 v0.2.0，支持 Windows 10 1607 及以上（64 位）。
文档编写中
本页为工具概览；安装与登录、金额识别框选、扫码盒与小票打印、门店与终端、退款与关单、排障等完整章节仍在编写。当前请以交付包内说明与技术支持为准。
适用场景
| 场景 | 说明 |
|---|---|
| 已有收银软件 | 老收银软件稳定好用但缺扫码收款，旁挂精灵补齐，不动原系统 |
| 台卡收款靠盯 | 顾客扫码后盯手机等到账，高峰分不清哪单是谁付的 |
| 到账、小票、对账三头忙 | 到账播报、小票打印、订单核对由精灵统一完成 |
收款链路
- 登录即用 — 平台开好收银员账号、分好门店，电脑上登录即可收款；精灵不保存商户私钥；
- 认金额、扫付款码 — 在屏幕上框选一次金额位置，之后自动读取；顾客亮付款码即收；没有收银软件时可手输金额或直接扫码；
- 播报打印、同步平台 — 收款成功本机播报并打印小票，订单同步到平台。
核心能力
| 能力 | 说明 |
|---|---|
| 屏幕金额识别 | 框选一次金额位置后持续读取，连续多帧一致才采信；识别不准时提示手输 |
| 被扫收款 | 扫码盒（键盘仿真 / HID POS）扫顾客付款码完成收款 |
| 无收银软件也能收 | 手动输金额或直接扫码，适合临时收银与备用机 |
| 多门店 | 登录商户账号后自动带出门店，收款、流水、小票跟随当前门店 |
| 到账播报 | 本机语音播报金额与渠道，音箱与音量可调，支持预录语音兜底 |
| 小票打印 | 网口 9100 / USB 免驱，58mm 与 80mm；模板在平台设置、各门店共用 |
| 订单进平台 | 每笔订单同步平台，记录门店与终端；本地只保留镜像账，以平台订单为准 |
| 常驻桌面 | 待收金额悬浮在屏幕角落，热键唤出收银台，关窗驻留托盘，开机自启 |
运行环境
| 项 | 要求 |
|---|---|
| 操作系统 | Windows 10 1607+（64 位） |
| 技术形态 | .NET 10 / WPF 原生自绘，旁挂部署，不改造收银软件 |
| 扫码设备 | 键盘仿真 / HID POS 扫码盒 |
| 小票打印 | 网口 9100 / USB 免驱，58mm、80mm 热敏小票机 |
账号与安全
- 使用平台分配的收银员账号登录，权限由平台角色控制（查单、收款、退款等按角色授予）；
- 精灵不持有商户 RSA 私钥；「记住密码」由 Windows 加密保存；
- 同一笔重复提交只收一次（客户端单号幂等）；
- 支付处理中的订单不会直接入账，先记「待确认」，由后台向平台核对，成功补播报补打票，失败写明原因；待确认与失败不计入营业额。
获取与版本
收款精灵商业版 App 扩展版起随源码交付（含成品安装包），不单独销售；具体交付范围以商业版合同为准。