apple-web-app

Apple 设备上的网站和 Web 应用

选择范围

使用此技能，让任何网站或 Web 应用在 iPhone 和 iPad 上都能获得良好体验，无论是在 Safari 中使用，还是安装到主屏幕；也适用于 macOS Safari「添加到程序坞」界面。Service Worker、离线缓存、后台同步和推送实现属于其他范畴。

根据任务和项目推断平台、预期结果及现有架构。只有在缺少的信息会实质性影响解决方案时才询问。应用与平台和问题相关的指南。除非现有布局、身份验证和产品选择导致了用户提出的问题，否则应予以保留。用户指示优先于此技能的默认设置。

• 实现或调试： 阅读对应的参考文档，进行有针对性的修改，并检查受影响的行为和可能的回归问题。
• 审计： 对所有适用建议使用符合性检查清单。除非用户也要求修复，否则应先报告问题，再修改网站。
• 维护此技能： 按照 maintenance.md 执行。常规网站工作不需要更新技能或上游交接。

仅阅读相关参考文档

平台或问题	参考文档
Mac 程序坞图标、标题栏、显示模式、导航或存储	macos-add-to-dock.md
iOS head 标签、清单集成或图标	head-and-icons.md
iOS 安全区域、滚动根节点、冷启动或触控样式	layout-and-touch.md
iOS 状态栏、Safari 栏着色或浅色／深色外观	theme-color-and-status-bar.md
iOS 覆盖层、全屏变暗效果、键盘或滚动锁定	overlays-and-keyboard.md
iOS 启动图	splash-screens.md；生成或检查尺寸时阅读 ios-devices.md
安装提示、已安装应用的导航或存储连续性	install-ux.md
疑似 iOS 版本发布回归问题	ios-26-notes.md
将相关方案转换为现有 Tailwind v4 代码	tailwind-css-v4.md

仅针对 Mac 的任务应从 Mac 参考文档开始。不要为其生成 iOS 启动图，也不要添加 iOS 安全区域相关改动。来源：WebKit；Joe Bell，详见 macos-add-to-dock.md。

核心约束与证据

• 安全区域内边距为零是有效情况。确保控件仍可使用，不要假设顶部内边距大于零；切勿让应用一直等待内边距。来源：Joe Bell；WebKit 301994，见 sources.md。
• 保留双指缩放和文本选择。仅对控件或具有明确替代交互方式的媒体禁用触摸。来源：Firtman；React Spectrum，见 sources.md。
• 隐藏浏览器控件的已安装应用必须提供可用的返回或退出导航方式。来源：Firtman；Steiner，见 install-ux.md。

应区分文档记录的行为、设备观察结果、社区变通方案和可选的设计偏好。仅当症状和环境相符时，才应用特定版本的变通方案。报告的修复或 Bug 状态属于历史证据，并不保证适用于后续所有版本。如果某项可能变化的事实会影响修复方案，请阅读引用的来源，或重新检查目标构建版本。保留现有测试日期；不要将继承而来的发现重新标记为新测试结果。来源信息和保留的观察记录见： sources.md。

验证所请求的结果

使用符合性检查清单中的相关条目。在适用情况下，检查生成的 HTML、CSS、图像尺寸以及未经身份验证的资源传送。特定设备上的外观需要在真实设备上的目标已安装应用中进行观察。仅凭模拟器或桌面模拟无法确认安全区域时序、状态栏取样或启动画面选择。来源：Joe Bell，见 sources.md。

如果无法访问硬件或经过身份验证的运行时，请完成独立检查，并将剩余声明标记为未验证。说明已检查的内容、失败的项目，以及具体还需进行的设备检查。不要将范围明确的修复扩展成完整设备矩阵。相关检查通过后即可停止，除非出现故障或新的变更，需要进一步验证。