diff --git a/doc/nacos/blade-dev.yaml b/doc/nacos/blade-dev.yaml
index 745bff6e..7607c247 100644
--- a/doc/nacos/blade-dev.yaml
+++ b/doc/nacos/blade-dev.yaml
@@ -259,16 +259,22 @@ thirdParty:
       batch-size: ${HCS_PUSH_BATCH_SIZE:50}
       # 推送失败自动重试上限，超限仅人工重推
       max-retry: ${HCS_PUSH_MAX_RETRY:5}
-      # 五类扫描任务独立开关（cron 有代码默认值错峰每5分钟，无需配置）
+      # 五类扫描任务独立开关（灰度逐类打开；扫描只认审批通过且未同步/失败未超限的单据，失败由下轮自动补偿，超限人工重推）
+      # 各任务 cron 有代码默认值每5分钟、分钟位 0/1/2/3/4 错峰，无需配置；多实例按任务 Redis 分布式锁防重扫（TTL 240s）
       project:
+        # 项目立项（C102）定时推送
         sync-enabled: ${HCS_PUSH_PROJECT_ENABLED:false}
       contract:
+        # 合同（C103）定时推送（含风险校验/附件转传/履约规则 C103-9，及特批 C103-4 结果查询兜底）
         sync-enabled: ${HCS_PUSH_CONTRACT_ENABLED:false}
       payment:
+        # 付款链定时推送（特批 C106-3 + 履约记录 C108）
         sync-enabled: ${HCS_PUSH_PAYMENT_ENABLED:false}
       invoice-application:
+        # 开票登记（C111）定时推送（含金蝶开票完成后回填）
         sync-enabled: ${HCS_PUSH_INVOICE_APP_ENABLED:false}
       invoice-receipt:
+        # 收票单（C109）定时推送
         sync-enabled: ${HCS_PUSH_INVOICE_RCV_ENABLED:false}
     # 项目立项（C102）
     project:
diff --git a/doc/nacos/third-party-api.yaml b/doc/nacos/third-party-api.yaml
index 7d46eb22..e9750a85 100644
--- a/doc/nacos/third-party-api.yaml
+++ b/doc/nacos/third-party-api.yaml
@@ -178,16 +178,22 @@ thirdParty:
       batch-size: ${HCS_PUSH_BATCH_SIZE:50}
       # 推送失败自动重试上限，超限仅人工重推
       max-retry: ${HCS_PUSH_MAX_RETRY:5}
-      # 五类扫描任务独立开关（cron 有代码默认值错峰每5分钟，无需配置）
+      # 五类扫描任务独立开关（灰度逐类打开；扫描只认审批通过且未同步/失败未超限的单据，失败由下轮自动补偿，超限人工重推）
+      # 各任务 cron 有代码默认值每5分钟、分钟位 0/1/2/3/4 错峰，无需配置；多实例按任务 Redis 分布式锁防重扫（TTL 240s）
       project:
+        # 项目立项（C102）定时推送
         sync-enabled: ${HCS_PUSH_PROJECT_ENABLED:false}
       contract:
+        # 合同（C103）定时推送（含风险校验/附件转传/履约规则 C103-9，及特批 C103-4 结果查询兜底）
         sync-enabled: ${HCS_PUSH_CONTRACT_ENABLED:false}
       payment:
+        # 付款链定时推送（特批 C106-3 + 履约记录 C108）
         sync-enabled: ${HCS_PUSH_PAYMENT_ENABLED:false}
       invoice-application:
+        # 开票登记（C111）定时推送（含金蝶开票完成后回填）
         sync-enabled: ${HCS_PUSH_INVOICE_APP_ENABLED:false}
       invoice-receipt:
+        # 收票单（C109）定时推送
         sync-enabled: ${HCS_PUSH_INVOICE_RCV_ENABLED:false}
     # 项目立项（C102）
     project: