SuperAPI AI 工具集

axiom-cloud-sync-diag

数据与分析

查看项目

更新于 10-15 20:11

技能介绍

用途:这是一个 iCloud 同步诊断技能,用于排查“文件不同步”“CloudKit 错误”“同步冲突”“iCloud 上传失败”“ubiquitous item 错误”“数据未出现在其他设备”等问题。核心观点是:绝大多数同步问题源于账号/权限、网络连接或对同步时机的误解,而非 iCloud 基础设施故障。

主要能力:提供强制性的首步检查(iCloud 账号状态、entitlements、网络连通性、设备存储),CloudKit 与 iCloud Drive 的决策树,常见 CKError(accountTemporarilyUnavailable、quotaExceeded、serverRecordChanged、networkUnavailable)的成因与修复思路,批量操作静默丢数据的排查,以及上传/下载错误检查、文件协调器死锁、冲突未解决等调试模式。还包含生产事故排查顺序与 CloudKit Console 监控建议。

使用方式:按资料中的检查函数与决策树逐项执行,例如先检查 FileManager.default.ubiquityIdentityToken 与 CKContainer.default().accountStatus(),再核对 Xcode 的 Signing & Capabilities → iCloud 配置;对 CloudKit 冲突优先采用“先取后改再存”的 fetch-then-modify-then-save 模式;批量保存时使用 perRecordSaveBlock 逐条检查错误。

适用场景:iOS/macOS 应用开发者排查 CloudKit 或 iCloud Drive 同步异常,包括模拟器正常但真机异常、WiFi 正常但蜂窝异常、更新后不同步等。

限制:资料未提供该技能的安装命令、收费方式、支持平台版本或效果保证;内容为诊断指导,不替代实际代码修复,具体实现需结合项目配置。