使用手册

一、安装与登录

• Windows：双击绿色免安装版 .exe，同级目录自动生成 ReturnVerifyData（数据库 / 凭证 / 备份 / 日志）。
• macOS：dmg 里的程序拖进「应用程序」，首次打开提示无法验证开发者 → 系统设置 → 隐私与安全性 →「仍要打开」。
• 首次登录：主账号 admin 的一次性口令写在程序目录 logs/boot.log（只显示一次），登录后强制改密码。忘了可在登录页「忘记密码」本机重置。
• 绑定本机：换电脑会登录失败 —— 先在原电脑「系统设置 → 关于本机 → 解除设备绑定」。

界面结构（五个一级目录）

数据获取	平台登录、手动兜底采集、配置定时任务
包裹核验	核验扫描、待核验包裹、已核验包裹、核收看板
售后工单	拦截订单、异常包裹、仅退款、售后跟踪
数据统计	看板、差异对账、明细导出
系统设置	界面风格、定时提醒、数据管理、AI 助手、平台与店铺、局域网服务、站内消息、操作日志、关于本机

二、采集售后单

日常采集靠「定时任务」，手动获取只在抓不到时兜底。

1. 配一条定时任务（推荐）

1. 进入 数据获取 → 右上角「配置自动化任务」→ 新建任务。
2. 选平台（可细到店铺）、时间范围、最大页数、频率、抓取方式，保存。
3. 点「立即抓取」验证一次，能抓到就保持启用，之后自动跑。

2. 先登录平台账号（只做一次）

在 数据获取 页点平台入口，用商家账号登录即可，之后自动抓取都复用它。同平台多家店：先用「选择店铺」选好店铺再打开，登录态按店铺隔离。

3. 手动获取（兜底）

1. 打开平台售后列表页，地址栏右侧出现 可采集 后点 手动获取。
2. 系统弹出 采集数据比对 —— 此时还没写库。
3. 核对「可新增 / 已在库 / 字段有变化 / 重复无效」四类，再点 只导入新增（默认，已在库跳过）或 覆盖更新已在库。

三、包裹核验

包裹状态只有三态：待核验 → 已核验 / 核验异常。

1. 核验扫描

1. 进入 包裹核验 → 核验扫描，光标点进顶部输入框。
2. 扫码枪连续扫面单（也可手输单号），命中即入库，输入框自动清空、保持聚焦。
3. 扫到「没有这个单号 / 重复扫描」只提示、不写记录；语音播报开关在右上角。

2. 待核验 / 已核验包裹

• 顶部搜索可按 快递单号 / 平台订单号 / 退货编号 / 店铺名 查询（只查不核验）。
• 筛选支持平台、店铺、快递公司、售后类型、异常包裹、已发货退款、标记结果，以及 售后申请时间。
• 列表默认只看近 30 天，找不到单子先把时间改「不限」。
• 线下 / 电话通知的退货：直接点 手动添加 或 批量导入 建单。

3. 核收看板

回答三个问题：应核多少、实际收到多少、平台知不知道我收到了。

四、售后工单（四类）

四类单据由系统自动分流，无需人工分类，你只要在对应页面跟进。

1. 拦截订单

拦截件是平台已拦截、尚未回仓的退货包裹。勾选后标记：

• 标记自发货：货回到我们手里 → 同步到「待核验包裹」等回仓扫码。
• 标记代发货：货不经我们手 → 只在本列表跟进回收单号。

2. 异常包裹

核验发现实物与订单不符（丢件 / 错货 / 破损 / 少件 / 空包）时的集中管理页。

• 标记异常：选类型、处理人、处理状态（待处理 / 处理中 / 已解决），填备注。
• 当场拍照 / 录像上传凭证，提交后推站内消息给责任人并写操作日志。
• 可「导出异常清单」。

3. 仅退款

买家退款、不用寄回商品的单。默认只看「未处理」，勾选后点 标记处理 即闭环。

4. 售后跟踪

专盯「货钱两空」：买家没收到货就退款、又没做拦截，包裹仍被签收。与拦截订单互补。

五、统计与导出

• 数据统计：核验总单量、完成率、异常单量、超期未闭环、拦截量与回仓率，含趋势与分布图。
• 导出报表：导出当前筛选范围的明细 CSV（UTF-8 带 BOM，Excel 不乱码）。
• 退货差异对账：按平台汇总「应退 / 实收 / 差异（漏拿）/ 差异率 / 差异金额」。

六、手机扫码核验

1. 手机与电脑连同一局域网，在「系统设置 → 局域网服务」查看地址（如 https://192.168.1.32:8090）。
2. 用手机自带浏览器 / Chrome / Safari 打开，别用微信；提示证书不安全 → 继续访问。
3. 用子账号登录（需主账号勾选「手机端扫码核验」权限），点 开始扫描。
4. 把面单条形码放大填满取景方框、镜头与面单平行（10~20cm），扫到自动核验，连续扫。

七、系统设置

左侧依次：界面风格、定时提醒、数据管理、AI 助手、平台与店铺、局域网服务、站内消息、操作日志、关于本机；「采集规则」为高级项。带锁的项仅主账号可用。

• 定时提醒：待核验提醒、超时预警、差异日报、仅退款提醒可分别启停；待核验超期预警天数默认 3 天。
• 数据管理：立即备份、每日自动备份、从备份恢复、批量删除历史单据（需预览 + 输入「删除」）、清理运行日志。
• 平台与店铺：9 家平台可单独启停；登录态按店铺隔离。
• 关于本机：新增 / 停用子账号、勾选权限、切换数据模式、设备绑定管理。

八、常见问题

登录提示「账号未绑定当前电脑」	原电脑「关于本机 → 解除设备绑定」后在新电脑登录；主账号也可在登录页「重新绑定本机」。
「手动获取」是灰的	当前不在平台售后列表页。它是兜底入口，日常采集请配定时任务。
定时任务「失败 / 未登录」	平台登录态过期，去「数据获取」页重新登录一次再点「立即抓取」。
采集不到数据	平台改版致选择器失效，到「系统设置 → 采集规则」自检 / 一键修复。
列表按时间筛对不上	所有列表按 售后申请时间 筛；拦截订单默认不限时间，其它默认近 30 天。
软件关了还自动抓吗	不会，定时任务需软件运行；它复用你手工登录的会话，不会自动登录。
扫码提示「未找到该退货单」	该单没入库：手动添加、批量导入，或回「数据获取」页采集。
扫码提示「已核验 / 重复」	已核对或已在异常流程，无需重复处理，这类未命中不写扫描记录。
手机端打不开	确认同一局域网、服务已启动、浏览器信任证书；检查电脑防火墙端口。
手机扫码没反应	用 https 地址、允许摄像头、把条形码放大填满方框；仍不行就上传诊断日志。
批量导入完没看到新单	只在比对弹窗点「只导入新增 / 覆盖更新」才写库；已在库的会跳过；列表默认近 30 天。
手动添加提示「已在库」	不会重复建单，想补字段点「补全空缺字段」（只填空位，不改已有内容）。

九、数据与隐私 · 使用约束

• 单据、凭证、账号、消息、日志全部保存在本机，不上传第三方，也不做云端自动备份。
• 密码本地加密存储；设备指纹只存哈希，硬件明文不落库。
• 采集通过内置浏览器访问你自己的商家后台：定时任务在你已登录的会话里翻页抓取，但不模拟登录、不绕验证码、不做后台爬虫。
• 物流查询仅自动填单号打开公开网页，不爬虫、不解析物流数据。
• 在内置浏览器登录商家后台存在平台风控风险，请自行评估；手机扫码使用自签名证书，仅限可信局域网。