fix: 修复顺运宝分页总数误判 (#60)

docs/admin/08-顺运宝接口.md

@@ -127,9 +127,13 @@ GET /am/user/get?id=<登录响应里的 user.id>
 
 ```text
 POST /am/stock/listTotal   → data 是裸整数，总条数
-POST /am/stock/list        → data.list 是数组
+POST /am/stock/list        → data.list 是数组，data.total 是当前页条数
 ```
 
+`[必须]` 不要把 `list.data.total` 当成筛选范围总数。实测 HAR 中范围总数为
+3846 时，第一页返回 20 行且 `list.data.total = 20`；范围总数只能以
+`listTotal.data` 为准。
+
 ### 4.1 请求体
 
 ```json
@@ -192,9 +196,11 @@ Admin 默认 `max_matches = 10000`，可以在配置中调整；上限针对整
 逐日总数合计，不是每天各算一次。任何一天的列表或明细都不得在容量预检通过前
 开始拉取，避免超限后已经产生部分写入。
 
-`[必须]` 每一页 `list` 响应里的 `total` 必须等于该日预检的 `listTotal`，
-全部页去重后的货运单 ID 数也必须完全相等。分页期间总数变化、短页造成缺失或
-重复 ID 都视为本次同步失败，不推进游标。
+`[必须]` 每一页 `list.data.total` 必须等于该页 `list` 数组长度。非最后一页
+必须返回 `length` 条，最后一页必须返回预检总数对应的剩余条数。每天翻页结束后
+再次调用 `listTotal`，前后总数必须一致；全部页去重后的货运单 ID 数还必须等于
+预检总数。前后总数变化、短页、重复 ID 或唯一 ID 不足都视为本次同步失败，
+不推进游标。
 
 ### 4.4 统一日期范围同步与覆盖游标