设计弹窗与模态呈现时如何选择 alert、sheet…

在 iOS/iPadOS/macOS/visionOS 上需要展示警告、确认、临时任务或选项列表时，按 Apple HIG 选择合适的呈现组件并组织内容与关闭行为。

适用场景

解决思路

1. 先检查是否存在 `.claude/apple-design-context.md`，复用已有上下文，只询问其中未覆盖的信息。
2. Alerts：仅在关键场景使用（需要关注的错误、破坏性操作确认、必须被确认的信息），因为它们会打断流程并要求响应。
3. Sheets：用于保持上下文的聚焦任务，从屏幕边缘滑入（macOS 上附着到窗口），适合创建条目、编辑设置、多步表单。
4. Popovers：在 iPad 和 Mac 上做非模态呈现，出现在触发元素旁边，点击外部即关闭，用于补充信息、选项或控件而不占满屏幕。
5. Action sheets：用于在多个操作中选择，尤其当其中一个是破坏性操作时；iPhone 上从底部滑出，iPad 上以 popover 形式出现。
6. 尽量减少打断：在动用模态之前，先考虑内联呈现，或把该操作改为可撤销。
7. Alert 文案要简洁可执行：标题简短描述性，必要时加简短正文，按钮标签用具体动词（如 "Delete"、"Save"），不要用 "OK"。
8. 明确标记破坏性操作：使用破坏性按钮样式（红色文字），并把破坏性按钮放在用户不易反射性点击的位置。
9. 为含多个操作的 alert 和 action sheet 提供取消选项；在 action sheet 上，取消按钮放在底部并与其他项分隔。
10. Digit entry：输入框尺寸合适，数字之间自动前进，支持粘贴和自动填充。
11. 按平台适配呈现方式：同一交互在 iPhone、iPad、Mac 和 visionOS 上可能使用不同组件。
12. 输出时先给出推荐的呈现类型及理由，并说明为什么其他替代方案不太合适。
13. 输出内容规范：按 Apple 的语气与简洁规则给出标题、正文和按钮标签。
14. 输出关闭行为：说明用户如何关闭以及关闭后发生什么（保存、丢弃、取消）。
15. 输出替代方案：说明该场景是否根本不需要模态（内联反馈、撤销、渐进式披露）。
16. 向用户确认四个问题：该呈现需要传达什么信息或操作、是否阻塞、面向哪些平台、出现频率如何。
17. 参考索引文件获取细节：alerts.md（按钮顺序、标题/正文、确认、破坏性操作）、action-sheets.md（多操作、取消、破坏性处理）、popovers.md（非模态、点击外部关闭、iPad/Mac）、sheets.md（模态任务、上下文保持）、digit-entry-views.md（PIN 输入、自动填充、自动前进）。

适用边界 · 注意事项

• 不要为日常、非关键的操作使用 alert，它会打断流程并强制用户响应。
• 不要在能用内联呈现或可撤销操作解决时使用模态。
• 不要在所有平台上套用同一种呈现组件，需按 iPhone、iPad、Mac、visionOS 分别适配。