screen-time-api-engineer

屏幕使用时间 API 工程师

使用此技能，基于文档优先的证据模型实现并强化屏幕使用时间 API 应用。

规则

• 按以下证据顺序做出决策：
  1. Apple 官方文档和 WWDC
  2. 本地 SDK 接口/头文件
  3. 项目中观察到的实现（Project Alpha/Project Beta）
  4. 现场记录（论坛/medium）
• 如果来源之间存在冲突，优先采用官方文档和 SDK 行为。
• 将不确定的结论标记为推断，并附上注意事项。

SDK 基准

• 已于 2026-10-21 根据 iOS 27.0 SDK（Xcode 27.0，build 27A266a）重新核验相关证据。
• iOS 26.2 至 26.5 新增了屏幕使用时间 API：选择器标题、数据访问（仅限 EU）、屏蔽子菜单、令牌刷新、商店生命周期。iOS 27.0 未新增任何 API。
• 对任何版本高于应用部署目标的 API，都使用 #available 进行检查，并注明其所需的 iOS 版本。

快速入门工作流

1. 确定用户目标类别。
2. 打开 references/guides 中相应的参考文档。
3. 在 references/evidence 中交叉核验关键 API 说明。
4. 如果需要关注实现质量或回归问题，请使用 references/rundowns。
5. 输出内容时明确标注来源和置信度。

目标与参考文档映射

• Entitlements、签名、分发审批：
  • references/guides/02-authorization-setup.md
  • references/guides/19-release-and-app-review-checklist.md
• 家庭活动选择器和令牌处理：
  • references/guides/03-familycontrols-selection-and-token-model.md
  • references/guides/04-displaying-activity-labels-and-real-app-icons.md
• 屏蔽策略和商店行为：
  • references/guides/05-managedsettings-enforcement-patterns.md
  • references/guides/06-web-blocking-and-webdomain-policy.md
• 自定义屏蔽界面/操作：
  • references/guides/07-managedsettingsui-custom-shield-systems.md
  • references/guides/08-shield-actions-and-response-strategies.md
• 计划安排和监控回调：
  • references/guides/09-deviceactivity-scheduling-thresholds-and-errors.md
  • references/guides/10-deviceactivity-monitor-extension-playbook.md
• 使用情况分析报告：
  • references/guides/11-deviceactivity-report-analytics-architecture.md
• 在宿主应用中读取使用数据（iOS 26.4+，仅限 EU）：
  • references/guides/02-authorization-setup.md
  • references/guides/11-deviceactivity-report-analytics-architecture.md
• 通过 ScreenTime 框架控制/报告网页使用情况：
  • references/guides/12-screentime-framework-web-usage-reporting.md
• 新手引导和权限体验：
  • references/guides/13-onboarding-and-permission-ui-blueprints.md
• 端到端实现参考：
  • references/guides/14-app-and-website-blocking-reference-implementation.md
• 项目深入分析和对比强化：
  • references/guides/15-project-alpha-implementation-analysis.md
  • references/guides/16-project-beta-implementation-analysis.md
  • references/rundowns/12-cross-project-rundown.md
• 缺陷预防、测试和预检：
  • references/guides/17-hardening-checklist-bug-prevention.md
  • references/guides/18-testing-matrix-device-only-edge-cases.md
  • references/guides/21-preflight-rundown.md

证据文件（用于核验 API 契约）

• references/evidence/01-familycontrols-sdk-signatures.md
• references/evidence/02-managedsettings-sdk-signatures.md
• references/evidence/03-managedsettingsui-sdk-signatures.md
• references/evidence/04-deviceactivity-sdk-signatures.md
• references/evidence/05-deviceactivity-report-sdk-signatures.md
• references/evidence/06-screentime-framework-headers.md
• references/evidence/07-claim-reconciliation.md
• references/evidence/00-source-url-inventory.md

输出要求

使用此技能提供实现指导时，请包含：

1. 选用的 API 路径及原因。
2. 风险/故障模式。
3. 验证清单。
4. 带置信度标签的来源引用。

边界

• 不要推测私有 API 或未经支持的令牌转换技术。iOS 26.4 数据访问 API 是主机应用读取某人所用应用和网站对应的捆绑包 ID 或域名的唯一有文档记录的方式。
• 除非明确说明限制，否则不要声称行为超出规范或 SDK 的支持范围。
• 讨论发布就绪情况时，不要跳过扩展签名一致性检查。