hig-foundations

Apple HIG：设计基础

提问前，先检查 .claude/apple-design-context.md。利用已有上下文，只询问其中尚未涵盖的信息。

核心原则

1. 内容优先于界面装饰。 减少视觉杂乱。使用系统提供的材质和细微的分隔线，而不是厚重的边框和背景。

2. 从一开始就融入无障碍设计。 从设计之初就考虑 VoiceOver、动态字体、减弱动态效果、增强对比度和切换控制。每个交互元素都需要无障碍名称；复用语义控件标签，避免手动添加冗余标签。

3. 使用系统颜色和材质。 系统颜色会适配浅色／深色模式、增强对比度和材质效果。优先使用语义颜色（label、secondaryLabel、systemBackground），而非硬编码的值。

4. 使用平台字体和图标。 通过语义文本样式使用平台系统字体。SF Pro、SF Compact、SF Mono 和 New York 均可选用，但受平台和许可限制；并非所有平台都默认使用这些字体。按照推荐字号遵循字体层级。使用 SF Symbols 作为图标。

5. 遵循平台惯例。 外观和行为应符合系统标准。提供直接、灵敏的操作方式，并为每项操作提供清晰反馈。

6. 尊重隐私。 仅在需要时请求权限，清楚说明原因，并在索取数据前先提供价值。设计时尽量减少数据收集。

7. 支持国际化。 适应文本扩展、从右向左书写的文字，以及不同的日期和数字格式。使用 Auto Layout 动态调整内容尺寸。

8. 有目的地使用动态效果。 动画应传达含义和空间关系。遵循减弱动态效果设置，并根据具体情况采用精简或静态替代方案；交叉淡化是一种选择，并非每个动画都必须采用。

参考索引

参考资料	主题	主要内容
accessibility.md	无障碍功能	VoiceOver、Dynamic Type、色彩对比度、运动无障碍功能、Switch Control、音频描述
app-icons.md	App 图标	图标网格、特定平台的尺寸、单一视觉焦点、不透明背景和特定平台的前景透明度
branding.md	品牌塑造	在 Apple 的设计语言中融入品牌标识、低调的品牌呈现、自定义色调
color.md	颜色	系统颜色、动态颜色、语义颜色、自定义调色板、对比度
dark-mode.md	深色模式	抬升表面、语义颜色、适配的调色板、活力效果、在两种模式下测试
icons.md	图标	字形图标、集成 SF Symbols、自定义图标设计、图标字重、视觉对齐
images.md	图像	图像分辨率、@2x/@3x 资源、矢量资源、图像无障碍功能
immersive-experiences.md	沉浸式体验	AR/VR 设计、空间沉浸、舒适区、渐进式沉浸等级
inclusion.md	包容性	多元化呈现、非性别化语言、文化敏感性、包容性默认设置
layout.md	布局	页边距、间距、对齐、安全区域、自适应布局、易读内容指南
materials.md	材质	活力效果、模糊、半透明、系统材质、材质厚度
motion.md	动效	动画曲线、过渡、连续性、Reduce Motion 支持、基于物理的动效
privacy.md	隐私	权限请求、使用说明、隐私营养标签、最少化数据收集
right-to-left.md	从右到左	RTL 布局镜像、双向文本、可翻转的图标、例外情况
sf-symbols.md	SF Symbols	符号类别、渲染模式、可变颜色、自定义符号、字重匹配
spatial-layout.md	空间布局	visionOS 窗口放置、深度、人体工学区域、Z 轴设计
typography.md	排版	SF Pro、Dynamic Type 字号、文本样式、自定义字体、字体字重层级、行间距
writing.md	文案	UI 文案指南、语气、大小写规则、错误消息、按钮标签、简洁性

综合应用基础原则

请考虑各项原则之间的相互作用：

1. 颜色 + 深色模式 + 无障碍功能 —— 自定义调色板必须在两种模式下均可正常使用，同时符合 WCAG 对比度要求。请从系统语义颜色入手。

2. 排版 + 无障碍功能 + 布局 —— Dynamic Type 必须能够缩放而不破坏布局。请使用文本样式和 Auto Layout，以适配完整的字号范围。

3. 图标 + 品牌塑造 + SF Symbols —— 自定义图标应与 SF Symbols 的字重和视觉尺寸相匹配。品牌元素应融入设计，而不覆盖系统规范。

4. 动效 + 无障碍功能 + 反馈 —— 每个动画都必须提供 Reduce Motion 替代方案。动效应强化空间关系，而非仅作装饰。

5. 隐私 + 文案 + 引导流程 —— 权限请求需要清晰、具体的使用说明。请在用户能够理解其益处时再提出请求。

输出格式

1. 引用具体的 HIG 基础原则，注明文件和章节。
2. 指出目标平台之间的差异。
3. 提供具体的代码模式（SwiftUI/UIKit/AppKit）。
4. 说明无障碍功能的影响（对比度、Dynamic Type 缩放、VoiceOver 行为）。

要询问的问题

1. 你的目标平台有哪些？
2. 你是否已有品牌指南？
3. 你的无障碍目标等级是什么？（WCAG AA、AAA、Apple 基线？）
4. 使用系统颜色还是自定义颜色？

相关技能

• hig-platforms -- 基础规范如何应用于各个平台（例如，watchOS 与 macOS 上的字体比例差异）
• hig-patterns -- 写作和无障碍等基础规范至关重要的交互模式
• hig-components-layout -- 实现布局原则的结构组件
• hig-components-content -- 使用颜色、字体排印和图像展示内容

---

由 Raintree Technology 构建 · 更多开发者工具

适用场景

当需要执行概述中所述的工作流或操作时，可使用此技能。

示例

用户请求：

在此任务中使用 @hig-foundations：Apple 人机界面指南设计基础规范。

限制

• 仅当任务明确符合上述范围时才使用此技能。
• 不要将输出视为对特定环境进行验证、测试或专家审查的替代。
• 如果缺少必要的输入、权限、安全边界或成功标准，请暂停并请求澄清。

参考资料状态

随附的 Markdown 参考资料是注明出处的文档快照，并不能证明其中引用的所有规范仍然有效。实施前，请检查链接中的 Apple 原始资料以及目标 OS/SDK，以确认图标格式、系统颜色、符号可用性、字体度量和 API。保留来源归属；仅仅链接到第三方文档、字体、媒体和商标，并不意味着它们可以自由复用。远程图像和视频仅作引用，不包含在内，也未经过运行时测试。

仅凭对比度不足以证明符合 WCAG。普通文本通常要求 AA 级对比度至少为 4.5:1，大号文本为 3:1（至少为常规字重 18pt 或粗体 14pt）；低于大号文本阈值的粗体文本不能一概适用 3:1 的例外。APCA 是另一种评估方法，不能替代 WCAG 2.x 对比度标准。目标尺寸、字体排印默认设置和平台指南也需要通过设备及辅助技术进行测试。