usage-insights

用途：这是一个面向 Apple 平台（iOS/macOS）的技能，用于在应用中搭建一套生产级的使用洞察系统——记录用户活动事件、计算个性化统计，并展示为仪表盘或可分享的回顾页。触发场景包括用户要求显示使用统计、活动摘要、周报/月报、年终回顾或 Spotify Wrapped 风格回顾。\n\n主要能力：数据层用 SwiftData 的 UsageEvent 模型记录事件；InsightCalculator 为纯函数聚合引擎，产出标题、数值、趋势、可视化类型；UI 侧生成 InsightsDashboardView（含周期选择器和洞察卡片网格）、InsightCardView（图标、数值、趋势指示、迷你折线），可选生成 UsageRecapView（分页摘要与分享图）和 UsageEventRecorder（批量写入辅助）。\n\n用法：技能会先检测项目上下文（要求 Swift 5.9+、iOS 17+/macOS 14+，Swift Charts 需 iOS 16+/macOS 13+），检查已有用量追踪或 SwiftData 代码以避免冲突，然后通过提问确认周期（日/周/月/年/全部）、可视化风格（仅卡片/仅图表/两者）、是否含分享卡片、数据来源（SwiftData 或自定义）。生成后需在 App 中用 .modelContainer(for: [UsageEvent.self]) 注册容器，在各处调用 recorder.record(...) 记录事件，并导航到 InsightsDashboardView。\n\n限制与注意：事件仅存于设备本地，不应上传服务器；大数据集需按日期范围谓词取数、预聚合并设保留策略；日期运算应使用 Calendar.current 而非假设 7 天一周；趋势要处理无上一周期、零事件和百分比误导等边界。具体收费、价格与平台支持未在资料中提供。