fix: 优化体验

docs/API.md

@@ -328,6 +328,13 @@ url: /api/c/v1/asset/info
 URL：
 GET /api/c/v1/asset/info
 
+更新说明（2026-05-08）：
+* 本月流量展示以该接口返回字段为准
+* 总流量：`real_total_mb`
+* 已使用：`enable_virtual_data=true` 时取 `virtual_used_mb`，否则取 `real_used_mb`
+* 剩余：`real_total_mb - 已使用`
+* 进度条：`已使用 / real_total_mb`
+
 Query 参数：
 identifier（string，必填）- 资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）
 
@@ -374,6 +381,11 @@ data：
 URL：
 GET /api/c/v1/asset/package-history
 
+更新说明（2026-05-08）：
+* 涉及“本月流量”展示时，以 `/api/c/v1/asset/info` 的规则为准
+* 旧说明中“启用虚流量时总流量/剩余切换为虚流量”的规则已废弃
+* 当前规则：总流量固定取 `real_total_mb`，已使用按 `enable_virtual_data` 在 `virtual_used_mb` / `real_used_mb` 间切换，剩余和进度条按该结果计算
+
 Query 参数：
 - identifier（string，必填）- 资产标识符（SN/IMEI/虚拟号/ICCID/MSISDN）
 - page（integer，必填）- 页码