退件登记
—
将快递面单条码对准取景框
点这里开启摄像头
PDA / 工业扫码枪模式
工业机扫描引擎会把条码内容当键盘快速敲入此框并自动提交；若设备设了「扫描后加回车 / Tab」后缀，把上方结束符改成对应项即可。分组下拉在下方常驻，照常生效。
连续扫不弹结果卡，攒一批后确认入库；停 2 分钟不确认将自动全部入库（不确定的登记为需核验）
所有快递都自动识别面单上【收件人】手机号的后 4 位；识别不到直接跳过（留空），不会打断扫码
扫码时自动抓取面单原图存档，图片上带扫描时间、单号和快递公司
扫码诊断
最近登记的退件（点「未处理」直接标记已处理，点「详情」修改）
—
0
今日登记
0
本月登记
0
累计登记
0
未处理
0
需核验
快递公司分布
近 7 日登记量
管理员验证
管理用户需要再次输入当前管理员账号的密码（仅本次会话有效）。
新增账号
账号列表
| 账号 | 姓名 | 角色 | 状态 | 创建时间 | 最后登录 | 操作 |
|---|
分组选项设置
在这里自定义扫码录入的分组选项。保存后，扫码页下拉和记录查询的分组筛选会自动同步（约半分钟内生效，切走页面再回来会立即刷新）。
手机号尾号设置
只识别面单上【收件人】的手机号后 4 位，寄件人/快递员/网点号码一律不用（填错查不到物流）。顺丰、中通查物流强制要这个号码。这里的设置对所有设备生效，保存后约半分钟内同步（切走页面再回来立即生效）。
关掉后，所有设备扫码都不再识别面单手机号；每台设备自己的开关也会一并停用。识别不到就留空，不会填任何默认值。
面单照片存档设置
手机相机扫码时，自动抓一张面单原图存档到你自己的 Cloudflare R2，图片上带扫描时间、快递单号和快递公司水印。拍照与上传都在后台异步完成，不会打断扫码节奏。这里的设置对所有设备生效，保存后约半分钟内同步。
关掉后，所有设备扫码都不再抓拍面单照片；每台设备自己的开关也会一并停用。照片存在你自己绑定的 R2 存储桶里，不经过平台。官方托管域名和自有域名都能用（会自动选通的那条通道）。
保留规则：waybills/（在册单号的面单）最多保留 3 个月；删除记录时照片会移到 trash/（已删除单号单独存放），最多保留 8 天；数据库里已无对应记录的超期照片（孤儿）同样 8 天后清除。系统每 6 小时自动清理一次。
版本更新提醒
系统更新上线后，仍停在旧页面的设备会在顶部看到「刷新」提示条。这里的开关对所有设备生效，约半分钟内同步。
关掉后所有设备都不再显示提示条，用户需自行刷新才能用上新版本。
API 密钥（外网查询）
给外部系统（ERP / 打单 / 客服系统）查询「单号是否在库、分组、入库时间」用。每个密钥独立统计调用次数，可随时停用或删除；密钥只在创建时显示一次，请立即复制保存。创建时可绑定分组（只返回该分组下的单号），不绑定则可查全部。
绑定分组后，这个密钥只能查该分组名下登记的单号；不绑定则可查全部。绑定关系创建后不可更改，如需变更请停用旧密钥、新建一个。
↓ 表格可左右滑动，操作按钮在最右侧
| 名称 | 绑定分组 | 状态 | 有效期 | 调用 （总/今） | 最近调用 | 操作 |
|---|
外网调用文档（点击展开，可直接发给对接方）
接口地址（POST）：
https://return-express.app.workbuddy.host/.cloud/database/rest/rpc/app_api_lookup
请求头：
x-wb-webapp-access-key: wbpk_66usf2DEFGtmFeNFLj86i0_a225js7lar1b0es5ppsmjtOqJaCmnD46 Content-Type: application/json
请求体（p_key 填上面创建的密钥，p_tracking_no 填要查的快递单号）：
{
"p_key": "rk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"p_tracking_no": "SF1234567890"
}
返回示例（查到，在库）：
{
"ok": true,
"in_db": true,
"count": 1,
"bound_group": null,
"records": [
{
"tracking_no": "SF1234567890",
"carrier": "顺丰速运",
"carrier_code": "SF",
"check_status": "", "check_detail": "",
"shop": "", "reason": "",
"status": "pending",
"group": "方",
"source": "scan",
"created_at": "2026-10-22 18:30:05"
}
]
}
不在库时：{"ok": true, "in_db": false, "count": 0, "records": []}； 同一个单号登记了多条（不同分组）时 records 会有多条，按登记时间倒序。
分组绑定：创建密钥时若绑定了分组（如「方」），bound_group 会返回该分组名， 且只会返回该分组名下登记的单号——其他分组下的同单号记录不会出现，查不到时 in_db 为 false； 未绑定的密钥 bound_group 为 null，可查全部。
错误码：INVALID_KEY（密钥不对）/ KEY_DISABLED（已停用）/ KEY_EXPIRED（已过期）/ RATE_LIMITED（超过每分钟 60 次）/ EMPTY_TRACKING_NO（单号为空）。出错时 ok 为 false。
说明：created_at 为北京时间（UTC+8）；status 为 pending（未处理）/ done（已处理）；接口只返回登记信息，不含操作人。
carrier 返回中文公司全称（如「中通快递」「顺丰速运」），carrier_code 返回公司缩写（如 ZTO、SF）；未收录的公司两个字段都返回原样保存的值。
group / bound_group 即「分组」字段；group 是这条记录的分组，bound_group 是该密钥绑定的分组。
WPS 云文档备份
手动把登记数据备份到 WPS 云文档表格（与每天 21:00 的自动备份写同一个表：按数据ID 去重、只追加不覆盖、不删除任何已有行）。
表格文字颜色：■ 最新一批（本次同步）
■ 上一次备份
■ 更早（默认黑色）
令牌获取（仅首次）：在电脑上进项目目录运行 node tools/wps-token.cjs，按提示登录后把打印出来的令牌粘贴到此，点旁边的「保存令牌上云」——
之后任何设备解锁后台都会自动带上它，不用重复粘贴。云端存取都经过管理员密码验证；本机浏览器也会缓存一份方便快速使用。