增量

aliyun-sync/aliyun-aps-sync/README.md

@@ -23,9 +23,10 @@ cp .env.example .env
 
 ## 配置
 
-`.env` 里最重要的两个时间范围：
+`.env` 里最重要的时间范围：
 
 - `ALIYUN_APS_ORDER_START_DATE`: 订单查询的起始日期，会按月滚动抓取直到今天。
+- `ALIYUN_APS_INCREMENTAL_ORDER_START_DATE`: 订单/订单详情在增量模式下的指定起始日期；留空时仍默认只查昨天。
 - `ALIYUN_APS_BILL_START_MONTH`: 账单查询的起始佣金月份，会按月滚动抓取直到当前月。
 
 ## 使用
@@ -42,6 +43,18 @@ npm run login
 npm run sync
 ```
 
+如果需要在增量模式下让订单和订单详情从指定日期开始补抓，可以配置：
+
+```bash
+ALIYUN_APS_INCREMENTAL_ORDER_START_DATE=2026-01-01
+```
+
+或临时执行：
+
+```bash
+npm run sync -- --incremental-order-start-date=2026-01-01
+```
+
 3. 常驻定时同步
 
 ```bash