迅果 Apple 批量处理客户端，把重复操作一次跑完并逐条留下记录

客户端是桌面程序，安装包自带运行组件，不用另外装运行库、数据库或远端服务。安装前确认：

1. 操作系统是 Windows 10 及以上，或者 macOS 12 及以上；
2. 内存 4GB 以上，长期跑 32 路并发的话建议 8GB；
3. 磁盘上留出 1GB 给任务缓存和报表；
4. 网络能稳定访问 Apple 相关的服务；
5. 对工作目录有读写权限；
6. 屏幕分辨率 1280×720 以上，高分屏会自动缩放适配。

第一次启动会自动创建本地工作目录与初始配置，无需手工初始化。

按四步去定位，一般十分钟内就能判断是偶发波动还是规则本身有问题：

1. 在产出页筛选失败条目，读取原因码；
2. 抽两三条用单条模式重跑一次，看会不会复现；
3. 把并发档位降到 8 路复跑一次，排除瞬时失败是因为密度太高；
4. 仍复现则导出问题问题问题诊断包，连同任务配置一起留存备查。

失败条目能直接组成新清单重跑，已经成功的记录不会被执行第二次。

每条核验记录都会生成独立回执，包含核验时间、情形与失败原因代码。对账通常分四步：

1. 在产出页按情形筛选，先看失败与异常条目；
2. 核对面额字段跟既定规则对不对得上；
3. 一键导出 XLSX 报表，与对账台账逐列比对；
4. 有差额的条目单独另存一份，交给客服或者财务跟进。

报表里的差额列会把和台账对不上的记录单独标出来，省得人工一行一行地翻。

并发档位有 8、16、32 三档，选法上建议先用低档验证，再逐级往上调：

1. 第一次接触的清单先用 8 路试跑，看看失败原因怎么分布；
2. 失败率稳在千分之三以内的时候，再上调到 16 路；
3. 连续三批任务都稳了，再去考虑 32 路；
4. 碰上成片失败的批次，就退回一档再复跑一次；
5. 对情形敏感的清单长期保持 8 路，把稳定性放在吞吐之前。

并发越高单批完成越快，但瞬时请求密度也越大，请结合账号自身情形与业务节奏决定。

不会。导入的清单、任务队列、执行日志与导出报表都写进你指定的本地工作目录，客户端不以明文保存授权信息，也不会把任务数据回传服务器。具体可以这样确认：

1. 到设置页确认一下工作目录的真实路径；
2. 跑完一轮任务，直接打开那个目录看生成的回执文件；
3. 导出报表的时候确认保存位置在本机磁盘上；
4. 要清理的时候把工作目录删掉，全部记录跟着就没了。

整个链路没有远端服务中转环节，于是也不存在云端留存期限的问题。

内置 12 类批量动作，账号批量管理、礼品卡批量核验与本地资源批处理都覆盖在内。使用时按以下顺序操作：

1. 先在编排台把清单导进来，顺手确认字段映射没有错；
2. 勾选需要执行的动作，比如情形核验、分组打标、报表导出；
3. 用拖动的办法调顺序，序号就是执行先后；
4. 定好并发档位和失败重试的次数；
5. 先用小批量试跑一轮，确认回执正常；
6. 确认没问题再扩大批量，跑完把报表导出来。

所有动作都在本地进程里执行，不依赖云端排队，任务跑到一半可以暂停并把进度留住。