快速开始

1. 在首页点击「立即下载」，得到安装包（约 190 MB，文件名为 setup-X.Y.Z.exe 或「土豆收银前台 Setup X.Y.Z.exe」）。
2. 双击安装包，按提示完成安装，可选择安装目录（默认 D 盘 Program Files 下）。
3. 双击桌面图标「土豆收银前台」启动，使用工号 + 密码登录（初始账号请在首次部署时由管理员在后台「用户管理」创建）。
4. 进入收银台即可开始收银：底部扫码框扫条码，或用商品查询键盘输入拼音码。

日常收银

加购商品

• 扫码：扫商品条码，自动加入购物车（重复扫码数量 +1）。
• 拼音搜索：在商品查询键盘输入拼音首字母（如 hfs → 红富士），右侧商品区实时筛选，回车加入首个匹配；匹配多个时弹出候选列表，↑↓ 选择、回车 确定。
• 点选：直接点击商品网格中的商品卡片。

称重商品

商品设为「计重」后，加入购物车弹出电子秤读数窗口：串口 / 网口电子秤放上商品自动取稳定重量，点「称重」入车；手动改数量只允许输入大于 0 的数值（0 会被拦截并提示）。同一购物车里出现相同重量的重复行会弹窗确认，防止秤未归零重复计费。

改价与折扣

选中购物车行可「修改数量 / 修改单价」；整单折扣（经理折扣）由有权限的收银员输入金额。手动改过价的行在会员价 / 促销重新计算时保持不变。

挂单与取回

顾客临时短缺东西：点【挂单】暂存当前单，继续给下一位收银；顾客回来点顶栏【挂单 N 笔】打开列表，选中后【确定(F2)】取回继续结算。

结算

• 现金结算：输入实收金额，自动计算找零。
• 线上结算：扫顾客的微信 / 支付宝付款码，自动识别渠道。
• 组合结算：多种方式组合收款，每种方式输入本笔实收金额，可收一部分；线上结算只扫剩余部分。
• 卡结算：扫会员付款码 / 输入卡号 / 手机号，用储值余额支付（余额不足会被拦截，最多扣到本单待付金额）。

退货

在【交易查询】中找到对应单据，右键「整单退货」或在购物车对商品行退货，按反向流程退款，库存自动回库、会员余额与积分原路退回。

会员与储值

• 开卡：点【会员录入】，输入手机号即可开卡，系统自动生成 8 位卡号；同一手机号不能重复开卡。
• 核销：扫会员码 / 输入卡号 / 输入手机号均可找到会员，显示姓名、等级、余额、积分与最近消费。
• 储值：【会员充值】直达充值界面，按档位自动赠送金额（充 100 送 5 等，档位后台可改），实收 / 赠送 / 到账三行清晰。
• 积分：按实付金额累计（优惠不计积分），积分可抵现；积分规则（每元多少分、抵扣比例、门槛）在后台「积分设置」调整。
• 调账：后台人工调余额 / 加积分需超管二次验证并填原因，记录永久保留。

送货单

点右上角【送货单】进入管理：查询 / 处理、新建送货单、回收站三个页签。

• 新建：填会员卡号（可留空）、收货人、手机号（失焦自动带出历史配送记录）、地址、送货人；购物车有商品时点【外卖配送】可直接把当前商品带入。
• 流程：保存 →（需要时打印小票）→【开始发货】扣库存 →【收款】（可收一部分）→【送货完成】。
• 提醒：送达日早于今天且未完成的单会自动置顶并标注「跨天未完成」，避免漏送漏收。
• 右键菜单：单据行右键可移到明天配送 / 修改配送日期 / 修改送货员 / 打印小票 / 删除此单（授权操作需输入工号密码）。

收银后台

前台顶栏点【后台】用浏览器打开网页后台（默认地址 http://127.0.0.1:17888），主要模块：

• 商品档案：商品增删改、分类、计价方式（计数 / 计重）、售价 / 会员价 / 进价、拼音码自动生成；支持 CSV 导入导出。
• 进销存：进货单、退货管理、库存查询（多维筛选 + 滞销 / 积压标记）、库存盘点、报损出库、仓库管理（多仓库 + 分仓对账）。
• 营销活动：第 N 件优惠、特价、打折等商品级 / 整单级促销，可按时间段生效。
• 会员管理：会员列表、等级体系（普通 / 银卡 / 金卡 / 钻石，只升不降）、积分设置、会员操作日志。
• 零售管理：已结账单（含送货单合并视图）、送货单、收银汇总、交班对账。
• 报表中心：营业额、毛利、分类销售、热销榜、时段分析，可导出 Excel。
• 后台设置：门店管理、收银机绑定、用户与权限、硬件设置、支付方式、小票模板、数据备份与清理。

打印与硬件

• 小票模板：「小票模板」页可改标题、机号、是否打印标准价/实价、自定义三排内容、左右二维码、页脚文案；「打印预览」直接渲染打印机真实收到的指令，所见即所得。80mm 纸 48 列、58mm 纸 32 列，超长商品名自动折行，金额列对齐。
• 电子秤：硬件设置中选择串口（COM 口 + 波特率）或网口（IP + 端口），也提供模拟秤用于演示 / 测试。
• 扫码枪 / 钱箱 / 顾客屏：扫码枪即插即用（HID 模式）；钱箱通过小票机驱动或命令打开；顾客屏在主设置里选择主屏 / 副屏。

数据备份与恢复

• 前台 / 后台「数据备份」均可手动备份；可设每日自动备份（前台默认 02:00、后台 03:30 自动错开）与保留份数。
• 备份文件存放本机磁盘，可下载另存；磁盘空间不足时会暂停自动备份并弹窗提醒。
• 数据清理（仅店长可见）：自选时间段与内容，执行前预览影响条数，需二次输入工号密码；默认软删除可追溯，「商品档案 / 库存流水 / 会员」等基础资料受保护永不清空。
• 恢复：关闭软件后，把备份文件复制回数据库目录（%APPDATA%\cashier-pos）并重命名为当前库名，重新启动。

自动升级

它是怎么工作的

1. 软件每次启动，HTTPS 访问官网的 version.json（5 秒超时），读出线上版本号。
2. 线上版本高于本机版本时，弹出「发现新版本」提示：显示版本号与更新内容，可选【立即更新】或【稍后更新】。已是最新则不弹窗，直接进入收银系统。
3. 点【立即更新】后后台自动下载安装包（断点续传：下载中途断网，下次从断点继续）。
4. 下载完成校验 MD5 / SHA256：不匹配则删除并重试，仍失败会提示「文件损坏」并终止安装，绝不会安装被篡改的包。
5. 校验通过后静默安装，自动关闭收银界面，装完自动重启进入新版本。

手动检查与回滚

点左上角版本号旁的【检查更新】可随时手动检测；「系统设置 → 软件版本」里可查看更新记录，并回滚安装最近几个历史版本。

网络异常会怎样

• 官网访问超时 / 断网 / version.json 404：静默跳过更新检测，正常启动收银，不弹错误框。
• 下载中途断网：保留断点，网络恢复后可继续下载。
• MD5 校验不匹配：禁止安装，提示文件损坏。

常见问题

见首页 常见问题：断网收银、数据安全、升级方法、多机部署等。