kcode-pi 0.1.0

package/vendor/kingdee-skills/ok-cosmic/assets/snippets/botp/SampleConvertPlugin.java

@@ -0,0 +1,223 @@
+package kd.cd.common.snippets;
+
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.metadata.dynamicobject.DynamicProperty;
+import kd.bos.entity.ExtendedDataEntity;
+import kd.bos.entity.botp.plugin.AbstractConvertPlugIn;
+import kd.bos.entity.botp.plugin.args.AfterConvertEventArgs;
+import kd.bos.entity.botp.plugin.args.AfterCreateLinkEventArgs;
+import kd.bos.entity.botp.plugin.args.AfterCreateTargetEventArgs;
+import kd.bos.entity.botp.plugin.args.AfterFieldMappingEventArgs;
+import kd.bos.entity.botp.plugin.args.AfterGetSourceDataEventArgs;
+import kd.bos.entity.botp.runtime.ConvertConst;
+import kd.bos.logging.Log;
+import kd.bos.logging.LogFactory;
+import kd.cd.common.util.DynamicObjectUtils;
+import kd.cd.core.util.CollectionUtils;
+import kd.cd.core.util.ArrayUtils;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 转换插件示例 —— AbstractConvertPlugIn 内部生命周期全场景。
+ * <p>
+ * 适用插件：转换插件（下推/选单场景）
+ * 原生兜底：AbstractConvertPlugIn、ExtendedDataEntity、ConvertConst
+ * 相关 lint 规则：STYLE-003、STYLE-004、STYLE-015
+ * <p>
+ * 生命周期方法执行顺序：
+ * 1. afterGetSourceData  —— 转换执行前触发，拿到扁平化源数据行，适合源数据预校验/拦截；
+ * 2. afterCreateTarget   —— 目标单创建完成后触发（字段映射前），适合自动填充分录行；
+ * 3. afterFieldMapping   —— 每对"源→目标"映射完成后逐一触发，适合逐单补值/动态新增分录行；
+ * 4. afterCreateLink     —— 建立单据关联后触发，适合防止重复下推/关联数据清理；
+ * 5. afterConvert        —— 整批转换完成后触发，可拿到全部目标单 + 源单行，适合跨单汇总/补字段/校验。
+ * <p>
+ * <b>注意：本文件覆盖转换插件"内部"生命周期；外部编程式下推/链路追踪请看 BotpTracePushSample。</b>
+ */
+public class SampleConvertPlugin extends AbstractConvertPlugIn {
+    private static final Log log = LogFactory.getLog(SampleConvertPlugin.class);
+
+    // ===================================================================
+    //  一、afterGetSourceData —— 转换执行前触发，源数据预校验
+    // ===================================================================
+
+    /**
+     * 特点：在字段映射和目标单创建之前触发，只有「扁平化源数据行」可用。
+     * <p>
+     * 可用数据：
+     * - e.getSourceRows()    → 扁平化后的源数据行（分录字段以 entry.xxx 形式平铺）
+     * - e.getFldProperties() → 字段属性 Map，用于从扁平行安全取值
+     * <p>
+     * 适合操作：源数据预校验/拦截（throw KDBizException 可直接阻断转换流程）
+     * 不适合操作：修改目标单（此时目标单尚未创建）
+     * <p>
+     * 实战场景：支付安全校验、金额合规检查、源单状态前置校验
+     */
+    @Override
+    public void afterGetSourceData(AfterGetSourceDataEventArgs e) {
+        super.afterGetSourceData(e);
+
+        // ── 扁平化源数据行（不是完整 DynamicObject，需要完整数据要用 id 重新 load）
+        List<DynamicObject> sourceRows = e.getSourceRows();
+        Map<String, DynamicProperty> fldProperties = e.getFldProperties();
+
+        // ── 通过 fldProperties 从扁平行安全取值
+        for (DynamicObject row : sourceRows) {
+            Long srcId = (Long) fldProperties.get("id").getValue(row);
+            // TODO 校验源单数据，不满足条件 throw new KDBizException("...") 拦截下推
+        }
+    }
+
+    // ===================================================================
+    //  二、afterCreateTarget —— 目标单创建后、字段映射前触发
+    // ===================================================================
+
+    /**
+     * 特点：目标单 DynamicObject 已创建但字段映射尚未执行，映射字段此时为空。
+     * <p>
+     * 可用数据：
+     * - e.getTargetExtDataEntitySet().getExtDataEntityMap().get(entityName) → 目标单列表
+     * - ExtendedDataEntity.getDataEntity() → 目标单（字段值大多为空/默认值）
+     * <p>
+     * 适合操作：向目标单预填充分录行（查基础资料 → addNew）、设置系统字段（创建人等）
+     * 不适合操作：读取映射字段值（此时尚未映射）
+     * <p>
+     * 实战场景：自动填充扣款项/费用项分录、预设创建人/修改人
+     */
+    @Override
+    public void afterCreateTarget(AfterCreateTargetEventArgs e) {
+        super.afterCreateTarget(e);
+
+        String tgtEntityName = this.getTgtMainType().getName();
+        List<ExtendedDataEntity> targetBills = e.getTargetExtDataEntitySet()
+                .getExtDataEntityMap().get(tgtEntityName);
+        if (CollectionUtils.isEmpty(targetBills)) {
+            return;
+        }
+
+        for (ExtendedDataEntity targetExt : targetBills) {
+            DynamicObject targetBill = targetExt.getDataEntity();
+            // TODO 查询基础资料 → targetBill.getDynamicObjectCollection("entryKey").addNew()
+        }
+    }
+
+    // ===================================================================
+    //  三、afterFieldMapping —— 每对映射逐一触发，映射后补值
+    // ===================================================================
+
+    /**
+     * 特点：每对「源→目标」映射完成后逐一触发，目标单已有映射值，适合逐单补值。
+     * <p>
+     * 可用数据：
+     * - e.getTargetExtDataEntitySet().FindByEntityKey(entityName) → 目标单数组
+     * - e.getFldProperties()                                      → 源单字段属性 Map
+     * - 目标单字段已完成映射赋值
+     * <p>
+     * 与 afterConvert 的区别：
+     * - afterFieldMapping 逐对映射触发 → 逐单补值/动态新增分录行
+     * - afterConvert 整批触发 → 跨单汇总/拆分/合并
+     * <p>
+     * 适合操作：简单字段补值、清空并重建分录行、源单行程展开为目标多行
+     * <p>
+     * 实战场景：字段复制补值、委托报销自动带出收款人、出差申请行程展开为多行
+     */
+    @Override
+    public void afterFieldMapping(AfterFieldMappingEventArgs e) {
+        super.afterFieldMapping(e);
+        String tgtEntityName = this.getTgtMainType().getName();
+        ExtendedDataEntity[] targetBills = e.getTargetExtDataEntitySet().FindByEntityKey(tgtEntityName);
+
+        for (ExtendedDataEntity targetExt : targetBills) {
+            DynamicObject targetBill = targetExt.getDataEntity();
+
+            // TODO 补值：targetBill.set("fieldA", targetBill.get("fieldB"));
+            // TODO 动态新增分录：targetBill.getDynamicObjectCollection("entry").addNew().set(...);
+        }
+    }
+
+    // ===================================================================
+    //  四、afterCreateLink —— 建立单据关联后触发
+    // ===================================================================
+
+    /**
+     * 特点：源单→目标单关联关系（lk 表）已写入，可据此做去重/清理。
+     * <p>
+     * 可用数据：
+     * - e.getTargetExtDataEntitySet().getExtDataEntityMap().get(entityName) → 目标单列表
+     * - 关联关系已建立，可查询 lk 表判断是否重复下推
+     * <p>
+     * 适合操作：防止重复下推（查已下推记录 → removeIf 移除重复行）
+     * <p>
+     * 实战场景：暂估应付单多次下推时扣款项只需首次携带
+     */
+    @Override
+    public void afterCreateLink(AfterCreateLinkEventArgs e) {
+        super.afterCreateLink(e);
+
+        String tgtEntityName = this.getTgtMainType().getName();
+        List<ExtendedDataEntity> targetBills = e.getTargetExtDataEntitySet()
+                .getExtDataEntityMap().get(tgtEntityName);
+        if (CollectionUtils.isEmpty(targetBills)) {
+            return;
+        }
+
+        for (ExtendedDataEntity targetExt : targetBills) {
+            DynamicObject targetBill = targetExt.getDataEntity();
+            // TODO 查询已下推记录 → entries.removeIf(...) 移除重复行
+        }
+    }
+
+    // ===================================================================
+    //  五、afterConvert —— 整批转换完成后统一触发（最常用）
+    // ===================================================================
+
+    /**
+     * 特点：整批转换全部完成后触发，可同时拿到全部目标单 + 对应源单行，功能最强。
+     * <p>
+     * 可用数据：
+     * - e.getTargetExtDataEntitySet().FindByEntityKey(entityName)           → 目标单数组
+     * - ExtendedDataEntity.getDataEntity()                                  → 目标单 DynamicObject
+     * - ExtendedDataEntity.getValue(ConvertConst.ConvExtDataKey_SourceRows)  → 对应源单行列表
+     * - e.getFldProperties()                                                → 源单字段属性 Map
+     * - this.getSrcMainType().getName() / this.getTgtMainType().getName()    → 源/目标单标识
+     * <p>
+     * 适合操作：
+     * - 基础补值：从源单行取值补充目标单字段
+     * - 金额校验：校验后 throw KDBizException 拦截
+     * - 分录拆分：按维度将一行拆为多行（clone → clear → addAll）
+     * - 分录合并：按 groupKey 分组 + 金额汇总
+     * - 外部查询填值：查映射配置/基础资料 → 批量 set
+     * <p>
+     * 实战场景：付款金额校验、差旅明细按人拆分、账单分录合并汇总、映射资金用途
+     */
+    @Override
+    public void afterConvert(AfterConvertEventArgs e) {
+        super.afterConvert(e);
+
+        String tgtEntityName = this.getTgtMainType().getName();
+        ExtendedDataEntity[] targetBills = e.getTargetExtDataEntitySet().FindByEntityKey(tgtEntityName);
+        if (ArrayUtils.isEmpty(targetBills)) {
+            return;
+        }
+
+        for (ExtendedDataEntity targetExt : targetBills) {
+            DynamicObject targetBill = targetExt.getDataEntity();
+
+            // ── 获取当前目标单对应的源单行
+            @SuppressWarnings("unchecked")
+            List<DynamicObject> sourceRows = (List<DynamicObject>) targetExt.getValue(
+                    ConvertConst.ConvExtDataKey_SourceRows);
+            if (CollectionUtils.isEmpty(sourceRows)) {
+                continue;
+            }
+
+            // ── 从源单行安全取值
+            Long srcBillId = DynamicObjectUtils.nullSafeGet(sourceRows.get(0), "id");
+
+            // TODO 补值/校验/拆分/合并/映射填值
+            targetBill.set("sourcebilltype", this.getSrcMainType().getName());
+        }
+    }
+
+}

package/vendor/kingdee-skills/ok-cosmic/assets/snippets/cache/SampleCacheUsage.java

@@ -0,0 +1,218 @@
+package kd.cd.common.snippets;
+
+import kd.bos.cache.CacheFactory;
+import kd.bos.cache.DistributeSessionlessCache;
+import kd.bos.context.RequestContext;
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.entity.DynamicObjectCollection;
+import kd.bos.entity.cache.AppCache;
+import kd.bos.entity.cache.IAppCache;
+import kd.bos.logging.Log;
+import kd.bos.logging.LogFactory;
+import kd.bos.orm.query.QCP;
+import kd.bos.orm.query.QFilter;
+import kd.bos.servicehelper.BusinessDataServiceHelper;
+import kd.bos.servicehelper.QueryServiceHelper;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * 缓存使用示例 —— AppCache / DistributeSessionlessCache / loadFromCache。
+ * <p>
+ * 适用插件：操作插件、OpenAPI 控制器、表单插件、后台任务
+ * 优先封装：（暂无 commons 封装）
+ * 原生兜底：AppCache、DistributeSessionlessCache、CacheFactory、BusinessDataServiceHelper
+ * 相关 lint 规则：（暂无）
+ * <p>
+ * 使用场景：
+ * 1. AppCache：应用级别缓存，适合存储配置、票据、状态等轻量数据；
+ * 2. DistributeSessionlessCache：分布式无会话缓存，支持 TTL 自动过期，适合跨节点共享；
+ * 3. loadFromCache：基础资料查询走缓存通道，减少数据库访问。
+ * <p>
+ * <b>注意：缓存 key 应包含足够的业务区分度（如表单标识 + 业务编码），
+ * 避免不同业务场景互相覆盖。</b>
+ */
+public class SampleCacheUsage {
+    private static final Log log = LogFactory.getLog(SampleCacheUsage.class);
+
+    // ===================================================================
+    //  一、AppCache —— 应用级别缓存
+    // ===================================================================
+
+    /**
+     * AppCache 是基于命名空间的应用级缓存。
+     * 参数为命名空间名称，同一命名空间内共享 key 空间。
+     */
+    private static final IAppCache APP_CACHE = AppCache.get("DEV");
+
+    /**
+     * 场景：单点登录票据缓存。
+     * 票据只能使用一次，首次解析后缓存结果，后续直接取缓存。
+     */
+    public String getOrCacheTicket(String ticket) {
+        // 先查缓存
+        String cachedValue = APP_CACHE.get(ticket, String.class);
+        if (cachedValue != null) {
+            log.info("缓存命中：{}", ticket);
+            return cachedValue;
+        }
+
+        // 缓存未命中，执行实际解析
+        String resolvedValue = resolveTicket(ticket);
+
+        // 写入缓存（无 TTL，缓存随应用生命周期）
+        APP_CACHE.put(ticket, resolvedValue);
+        log.info("缓存写入：{}", ticket);
+
+        return resolvedValue;
+    }
+
+    /**
+     * 场景：存储临时状态（如异步操作的中间状态）。
+     */
+    public void cacheOperationStatus(String bizKey, String status) {
+        APP_CACHE.put(bizKey, status);
+    }
+
+    public String getOperationStatus(String bizKey) {
+        return APP_CACHE.get(bizKey, String.class);
+    }
+
+    // ===================================================================
+    //  二、DistributeSessionlessCache —— 分布式无会话缓存（支持 TTL）
+    // ===================================================================
+
+    /**
+     * 分布式缓存，跨节点共享，支持自动过期。
+     * 参数为缓存区域名，同一区域内共享 key 空间。
+     */
+    private final DistributeSessionlessCache distCache =
+            CacheFactory.getCommonCacheFactory().getDistributeSessionlessCache("kdcd_biz_cache");
+
+    /**
+     * 场景：缓存基础资料映射表（如维度成员数据）。
+     * 查询时先查缓存，未命中则从 DB 查询后回填。
+     *
+     * @param formId       表单标识（如 "bcm_model"、"bos_org"）
+     * @param selectFields 需要缓存的字段
+     * @param cacheKey     缓存 key（建议 formId + 业务标识）
+     * @param ttlSeconds   过期时间（秒），一般 180~600
+     * @return key=id, value=字段 JSON 串
+     */
+    public Map<String, String> getCachedModelData(
+            String formId, String selectFields, String cacheKey, int ttlSeconds) {
+
+        // 1. 先查缓存
+        Map<String, String> cached = distCache.getAll(cacheKey);
+        if (!cached.isEmpty()) {
+            return cached;
+        }
+
+        // 2. 缓存未命中，查询数据库
+        QFilter filter = new QFilter("status", QCP.equals, "C")
+                .and(new QFilter("enable", QCP.equals, "1"));
+
+        DynamicObjectCollection dataCollection = QueryServiceHelper.query(
+                formId, "id," + selectFields, new QFilter[]{filter});
+
+        // 3. 构建缓存 Map
+        Map<String, String> dataMap = new HashMap<>();
+        for (DynamicObject item : dataCollection) {
+            String id = item.getString("id");
+            // 可以存 JSON 或简单值
+            dataMap.put(id, item.getString(selectFields));
+        }
+
+        // 4. 写入缓存（带 TTL）
+        distCache.put(cacheKey, dataMap, ttlSeconds);
+        log.info("分布式缓存写入：key={}, size={}, ttl={}s", cacheKey, dataMap.size(), ttlSeconds);
+
+        return distCache.getAll(cacheKey);
+    }
+
+    /**
+     * 场景：缓存单个值（如用户 ID 反查）。
+     *
+     * @param userNumber 用户编码
+     * @return 用户 ID
+     */
+    public Long getCachedUserId(String userNumber) {
+        String cacheKey = "bos_user_" + userNumber;
+
+        // 先查缓存
+        String userId = (String) distCache.get(cacheKey);
+        if (userId != null) {
+            return Long.valueOf(userId);
+        }
+
+        // 查询数据库
+        DynamicObject userObj = QueryServiceHelper.queryOne(
+                "bos_user", "id", new QFilter[]{new QFilter("number", QCP.equals, userNumber)});
+
+        if (userObj == null) {
+            // 兜底：返回当前用户 ID
+            userId = String.valueOf(RequestContext.get().getCurrUserId());
+        } else {
+            userId = userObj.getString("id");
+        }
+
+        // 写入缓存，180 秒过期
+        distCache.put(cacheKey, userId, 180);
+
+        return Long.valueOf(userId);
+    }
+
+    // ===================================================================
+    //  三、loadFromCache —— 基础资料缓存查询
+    // ===================================================================
+
+    /**
+     * 场景：查询基础资料时走缓存通道，减少数据库压力。
+     * 适用于基础资料、辅助资料等不经常变更的实体。
+     *
+     * @param pk       主键
+     * @param entityId 实体标识（如 "bos_org"、"bd_currency"）
+     * @return 缓存中的 DynamicObject（如果缓存中没有会自动从 DB 加载并缓存）
+     */
+    public DynamicObject loadBaseDataFromCache(Object pk, String entityId) {
+        // loadSingleFromCache：平台内置缓存通道（单条查询）
+        // 首次调用从 DB 加载，后续直接从缓存返回
+        return BusinessDataServiceHelper.loadSingleFromCache(pk, entityId);
+    }
+
+    /**
+     * 场景：批量加载基础资料走缓存。
+     * 返回 Map&lt;主键, DynamicObject&gt;。
+     */
+    public Map<Object, DynamicObject> loadBaseDataBatchFromCache(Object[] pks, String entityId) {
+        return BusinessDataServiceHelper.loadFromCache(pks, entityId);
+    }
+
+    // ===================================================================
+    //  缓存选型速查
+    // ===================================================================
+    //
+    //  AppCache:
+    //  - 应用级缓存，同一 JVM 实例内共享
+    //  - 无 TTL（生命周期随应用）
+    //  - 适合：配置项、票据、临时状态
+    //  - 用法：AppCache.get("命名空间") → put/get
+    //
+    //  DistributeSessionlessCache:
+    //  - 分布式缓存，跨节点共享（底层 Redis）
+    //  - 支持 TTL 自动过期
+    //  - 适合：频繁查询的映射表、用户信息、维度成员
+    //  - 用法：CacheFactory...getDistributeSessionlessCache("区域") → put/get/getAll
+    //
+    //  loadFromCache:
+    //  - 平台内置基础资料缓存通道
+    //  - 自动管理缓存生命周期
+    //  - 适合：基础资料、辅助资料等标准实体
+    //  - 用法：BusinessDataServiceHelper.loadFromCache(pk, entityId)
+
+    private String resolveTicket(String ticket) {
+        // 模拟票据解析
+        return "resolved_" + ticket;
+    }
+}

package/vendor/kingdee-skills/ok-cosmic/assets/snippets/concurrent/SampleThreadPoolBatch.java

@@ -0,0 +1,156 @@
+package kd.cd.common.snippets;
+
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.entity.DynamicObjectCollection;
+import kd.bos.logging.Log;
+import kd.bos.logging.LogFactory;
+import kd.bos.orm.query.QCP;
+import kd.bos.orm.query.QFilter;
+import kd.bos.servicehelper.QueryServiceHelper;
+import kd.bos.threads.ThreadPools;
+import kd.cd.common.concurrent.ExecutorServiceUtils;
+
+import java.util.List;
+import java.util.concurrent.ExecutorService;
+import java.util.stream.Collectors;
+
+/**
+ * 线程池批量处理示例 —— 大批量数据并发处理的标准模式。
+ * <p>
+ * 适用插件：操作插件、后台调度任务、数据初始化
+ * 优先封装：ExecutorServiceUtils.shutdownAndAwaitTermination
+ * 原生兜底：ThreadPools、ExecutorService
+ * 相关 lint 规则：STYLE-019（禁 new Thread）、STYLE-020（禁 JDK Executors）
+ * <p>
+ * 使用场景：
+ * 1. 批量刷数据：查询大量单据后多线程并发修改；
+ * 2. 一次性任务：ThreadPools.executeOnce 执行一次后销毁；
+ * 3. 优雅关闭：shutdownAndAwaitTermination 等待所有任务完成再继续。
+ * <p>
+ */
+public class SampleThreadPoolBatch {
+    private static final Log log = LogFactory.getLog(SampleThreadPoolBatch.class);
+
+    // ===================================================================
+    //  一、标准批量处理模式（最常用）
+    // ===================================================================
+
+    /**
+     * 批量并发修改单据。
+     * 步骤：查询 → 创建线程池 → 循环提交任务 → 优雅关闭等待完成。
+     *
+     * @param formId     单据标识
+     * @param conditions 过滤条件
+     */
+    public void batchProcess(String formId, QFilter[] conditions) {
+        // ---------- Step 1: 查询待处理数据 ----------
+        DynamicObjectCollection coll = QueryServiceHelper.query(formId, "id", conditions);
+        List<Object> pks = coll.stream()
+                .map(o -> o.get("id"))
+                .distinct()
+                .collect(Collectors.toList());
+
+        if (pks.isEmpty()) {
+            log.info("无需处理的数据");
+            return;
+        }
+
+        // ---------- Step 2: 创建线程池 ----------
+        // 命名规则：业务标识 + 时间戳，方便运维排查
+        // 线程数：一般 50~100，根据单条任务耗时和总量调整
+        ExecutorService pool = ThreadPools.newExecutorService(
+                "kdcd_batch_" + System.currentTimeMillis(), 50);
+
+        // ---------- Step 3: 循环提交任务 ----------
+        for (Object pk : pks) {
+            pool.execute(() -> processSingleItem(formId, pk));
+        }
+
+        // ---------- Step 4: 优雅关闭并等待所有任务完成 ----------
+        // 参数：线程池、超时时间（秒）；一般 1800（30分钟）到 2400（40分钟）
+        ExecutorServiceUtils.shutdownAndAwaitTermination(pool, 1800);
+
+        log.info("批量处理完成，共 {} 条", pks.size());
+    }
+
+    /**
+     * 单条数据处理逻辑（每个线程执行一条）。
+     * 要点：捕获异常，避免单条失败导致整个线程池崩溃。
+     */
+    private void processSingleItem(String formId, Object pk) {
+        try {
+            // 此处编写具体业务逻辑（如修改单据、调接口等）
+            log.info("正在处理：{}", pk);
+        } catch (Exception e) {
+            log.error("处理失败：pk={}", pk, e);
+            // 根据业务需要决定：记录失败 or 更新状态字段 or 重试
+        }
+    }
+
+    // ===================================================================
+    //  二、ThreadPools.executeOnce —— 一次性异步任务
+    // ===================================================================
+
+    /**
+     * 场景：只执行一次的后台任务（如异步生成中间表、触发通知等）。
+     * ThreadPools.executeOnce 会创建单线程池执行后自动销毁。
+     *
+     * @param taskName 任务标识名（用于日志追踪）
+     */
+    public void executeOnceExample(String taskName) {
+        ThreadPools.executeOnce(taskName, () -> {
+            try {
+                // 执行一次性任务
+                log.info("一次性任务开始：{}", taskName);
+                doHeavyWork();
+                log.info("一次性任务完成：{}", taskName);
+            } catch (Exception e) {
+                log.error("一次性任务异常：{}", taskName, e);
+            }
+        });
+    }
+
+    // ===================================================================
+    //  三、带分片的批量处理（超大数据量场景）
+    // ===================================================================
+
+    /**
+     * 超大批量场景：先分片再并发。
+     * 适用于数十万条以上的数据处理，避免一次性查出所有 PK 占用过多内存。
+     *
+     * @param formId 单据标识
+     * @param pageSize 每页大小
+     */
+    public void batchProcessByPage(String formId, int pageSize) {
+        ExecutorService pool = ThreadPools.newExecutorService(
+                "kdcd_paged_" + System.currentTimeMillis(), 50);
+
+        while (true) {
+            // 分页查询
+            DynamicObjectCollection page = QueryServiceHelper.query(
+                    formId, "id",
+                    new QFilter[]{new QFilter("kdcd_processed", QCP.equals, false)},
+                    "id asc", pageSize);
+
+            if (page.isEmpty()) {
+                break;
+            }
+
+            for (DynamicObject row : page) {
+                Object pk = row.get("id");
+                pool.execute(() -> processSingleItem(formId, pk));
+            }
+
+            if (page.size() < pageSize) {
+                break; // 最后一页
+            }
+        }
+
+        ExecutorServiceUtils.shutdownAndAwaitTermination(pool, 2400);
+        log.info("分页批量处理完成");
+    }
+
+    private void doHeavyWork() {
+        // 模拟耗时操作
+    }
+}