WidgetKit 代码审查

快速参考

审查检查清单

• placeholder(in:) 立即返回，不执行任何异步操作
• Timeline entries 时间间隔至少为 5 分钟
• getSnapshot 检查 context.isPreview 以适配小组件图库预览
• 使用 containerBackground(for:) 保证 iOS 17+ 兼容性
• systemSmall 尺寸使用 widgetURL（而非 Link）
• 小组件视图中不使用 Button 视图（应改用 Link 或 widgetURL）
• 小组件视图中不使用 AsyncImage 或 UIViewRepresentable
• 图片已下采样至小组件显示尺寸（内存占用上限约 30MB）
• 已配置 App Groups，支持 App 与小组件间数据共享
• EntityQuery 实现了 defaultResult() 方法，用于处理非可选参数
• 新增的 intent 参数在更新后能正确处理已有小组件中的 nil 值
• reloadTimelines 被有策略地调用（不在每次数据变更时都触发）

何时查阅参考文档

• TimelineProvider 实现或刷新异常 → 查阅 timeline.md
• 小组件尺寸、锁屏小组件、containerBackground → 查阅 views.md
• 可配置小组件、AppIntent 迁移 → 查阅 intents.md
• 内存问题、缓存机制、配额管理 → 查阅 performance.md

审查问题

1. 当系统延迟刷新时，小组件是否提供了降级的 fallback entries？
2. 锁屏小组件家族（accessoryCircular / Rectangular / Inline）是否被正确处理？
3. 从 IntentConfiguration 迁移至 AppIntentConfiguration 是否会导致现有用户小组件失效？
4. Timeline 是预先填充了未来时间点的 entries，还是依赖高频刷新来维持最新状态？
5. 数据是否通过 App Groups 缓存并供小组件访问？

硬性准入条件（报告前必须满足）

对每个你计划报告的问题，请**严格按顺序**完成以下四项。任一条件未满足前，不得进入下一环节。

1. 位置定位 —— 问题描述中包含来自当前文件内容的 [FILE:LINE]（或行号范围）；该路径在本仓库中可解析。
2. 作用域通读 —— 你已完整阅读相关上下文实现：包括 TimelineProvider（必要时涵盖 placeholder、getSnapshot 和 getTimeline）、@main Widget / 小组件 bundle，或可配置小组件的 AppIntentConfiguration / intent 类型——而不仅限于 diff 片段或代码片段。
3. 平台或系统依据（仅当问题涉及刷新配额、约 30MB 内存指导原则、锁屏 accessory 家族、iOS 17+ 的 containerBackground、App Groups 数据共享，或从 IntentConfiguration 迁移至 AppIntentConfiguration 时）—— 你明确指出一项已查验的具体证据（例如项目中的 .entitlements 文件 / App Group ID、源码中 WidgetFamily 的处理逻辑、IPHONEOS_DEPLOYMENT_TARGET 设置，或所引用的具体文档子章节），或 主动将该问题降级为开放性问题（open question）。
4. 流程合规 —— 本技能所属审查类型的 review-verification-protocol 中所有预报告步骤均已满足（若未满足，则不得提出该问题）。

每个报告的问题须采用格式：[FILE:LINE] ISSUE_TITLE。第 4 条硬性准入条件即为此技能审查类型的完整预报告检查清单。