CloudKit 代码审查

快速参考

审查清单

• 在执行私有数据库或共享数据库操作前，已检查用户 iCloud 账户状态
• 生产环境数据使用自定义分区（custom zones），而非默认分区（default zone）
• 所有 CloudKit 错误均已处理，并正确遵循 retryAfterSeconds 参数进行退避重试
• 正确处理 serverRecordChanged 冲突，采用合理的合并逻辑（merge logic）
• 对 CKErrorPartialFailure 进行解析，逐条检查各记录的错误详情
• 使用批量操作（如 CKModifyRecordsOperation），而非单条记录的独立保存
• 大型二进制数据以 CKAsset 形式存储（单条 CKRecord 大小上限为 1MB）
• 记录键（record keys）采用类型安全方式（如枚举类型），而非字符串字面量（string literals）
• UI 更新操作均从回调中派发至主线程（main thread）
• 已监听 CKAccountChangedNotification 以响应用户 iCloud 账户切换
• 订阅（subscriptions）具备唯一 ID，防止重复注册
• CKShare 使用自定义分区（sharing 功能要求必须使用自定义分区）

何时查阅参考文档

• 审查容器（container）/数据库（database）配置或分区（zones）设置 → 查阅 container-setup.md
• 审查记录（record）的增删改查（CRUD）或关联关系 → 查阅 records.md
• 审查推送通知或同步触发机制 → 查阅 subscriptions.md
• 审查共享（sharing）或协作（collaboration）功能 → 查阅 sharing.md

输出格式

报告问题时使用如下格式：[FILE:LINE] ISSUE_TITLE

示例：

• [AppDelegate.swift:24] CKContainer not in custom zone
• [SyncManager.swift:156] Unhandled CKErrorPartialFailure
• [DataStore.swift:89] Missing retryAfterSeconds backoff

审查问题

1. 当用户退出 iCloud 登录状态时，系统行为如何？
2. 错误处理逻辑是否尊重速率限制（rate limiting），即是否正确使用 retryAfterSeconds？
3. 冲突是否被显式解决，还是存在数据被静默覆盖的风险？
4. 数据模型（schema）是否已在 App Store 发布前部署至生产环境？
5. 共享记录（shared records）是否存放在自定义分区中（CKShare 要求必须使用自定义分区）？

硬性校验门（报告前必需完成）

对每个拟报告的问题，须**严格按顺序**完成以下四项校验。未满足当前项通过条件前，不得进入下一项。

1. 定位凭证（Location artifact） —— 问题描述中包含源自当前文件内容的 [FILE:LINE]（或行号范围）；该路径在本仓库中可准确解析。
2. 作用域通读（Scope read） —— 已完整阅读问题所在上下文单元：即承载 CloudKit 操作的类型或函数（例如 CKOperation 子类的使用方式、完成回调链（completion handler chain）、或 CKRecord 的生命周期管理），而不仅限于 diff 片段或孤立代码片段。
3. CloudKit 或部署声明（CloudKit or deployment claim）（仅当问题依赖于容器标识符、公有/私有数据库选择、自定义分区要求、iCloud 账户状态、授权配置（entitlements）或生产环境 schema 时适用）—— 明确指出一项你已查验的具体凭证（artifact），例如：com.apple.developer.icloud-container-environment 或 entitlements 文件中的容器 ID、源码中 CKContainer.default() 与自定义标识符的使用对比、Info.plist 或 Target Capabilities 配置、或 schema 已部署的证据；或 将该问题降级为“审查问题（Review Questions）”中的开放性问题。
4. 协议合规（Protocol） —— 本技能所属审查类型的《review-verification-protocol》中规定的预报告步骤均已满足（若不满足，则不得形成任何问题报告）。

每个报告的问题均须采用 [FILE:LINE] ISSUE_TITLE 格式。第 4 项即为本审查技能所对应的完整预报告检查清单。