From 7f68798505c3b5b83f426192c98590644e90a186 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=88=98=E6=B3=89=E4=BD=B3?= <1107186916@qq.com>
Date: Fri, 23 Oct 2026 11:32:25 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85HCS=E6=8E=A8=E9=80=81?=
 =?UTF-8?q?=E4=BA=94=E7=B1=BB=E6=89=AB=E6=8F=8F=E4=BB=BB=E5=8A=A1=E7=8B=AC?=
 =?UTF-8?q?=E7=AB=8B=E5=BC=80=E5=85=B3=E9=85=8D=E7=BD=AE=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 doc/nacos/blade-dev.yaml       | 8 +++++++-
 doc/nacos/third-party-api.yaml | 8 +++++++-
 2 files changed, 14 insertions(+), 2 deletions(-)

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: