【免费下载链接】HIGAgentSkills
Apple Human Interface Guidelines for Agents
同一套业务,放到 iPhone、iPad、Mac、Apple TV、Vision Pro 和 Apple Watch 上,界面却必须长得"不一样":观看距离从手腕边的一脚,到客厅里的 8 英尺,再到无限延伸的 3D 空间;输入方式从手指触控、指针键盘,变成遥控器焦点和眼球+手势。HIGAgentSkills 是一个面向 AI Agent 的 Apple Human Interface Guidelines(HIG)参考库,收录157 份经过源码核对的平台设计指南,专门帮你回答"同一个 App 在六大平台该如何区分设计"这类问题。
为什么一个 App 不能"一套 UI 走天下"
苹果官方 HIG 把每个平台单独成篇,核心原因就是:平台的物理形态、使用场景和输入方式完全不同。HIGAgentSkills 把这六篇指南提炼成六个 Tier-2 平台参考文件,每个文件都包含"设备特征 + 最佳实践"两部分:
| 平台 | 参考文件 | 典型使用距离 | 主要输入方式 |
|---|---|---|---|
| iOS | designing-for-ios.md | 一两英尺内,单手持握 | 多指触控、虚拟键盘、语音 |
| iPadOS | designing-for-ipados.md | 约 3 英尺内,手持或立放 | 触控 + 键盘/触控板 + Apple Pencil |
| macOS | designing-for-macos.md | 1–3 英尺,固定桌前 | 物理键盘、指针、游戏手柄 |
| tvOS | designing-for-tvos.md | 8 英尺或更远("lean-back") | Siri Remote、手柄、语音 |
| visionOS | designing-for-visionos.md | 无限 3D 空间,相对头部定位 | 注视 + 间接手势 / 直接触控 |
| watchOS | designing-for-watchos.md | 手腕抬起约一脚内 | Digital Crown、抬腕、另一只手操作 |
💡 注意:表里的每一个事实(距离、输入方式、系统特性)都能在这些参考文件中溯源到 Apple HIG 原文(2026-09-12 快照),而不是 AI 的"大概印象"。
六大平台的关键设计差异
iOS:内容优先,控制精简
手机屏幕中等尺寸、单手操作,所以指南要求:限制屏幕上的控件数量,让主内容突出;次要操作"一两下就能发现";中下部控件更易够到;并支持方向、Dark Mode 和 Dynamic Type 自适应。
iPadOS:大屏不是放大版手机
iPad 的关键词是"大屏 + 多输入":抬高重要内容,减少模态界面和全屏跳转;根据观看距离和输入模式调整内容密度;同时要支持触控、物理键盘/触控板、Apple Pencil 的组合输入,并考虑向 macOS 形态的过渡。
macOS:桌面级的效率与自由度
Mac 用户任务动辄数小时、多应用同开,设计要点是:用大屏减少嵌套层级和模态;窗口可自由缩放、移动、支持全屏;用菜单栏暴露全部命令;支持键盘快捷键和高精度选择,允许用户自定义工具栏与窗口。
tvOS:焦点系统与"影院感"
电视 App 是"远距离观看 + 遥控器操作":必须拥抱 tvOS 的焦点系统——项目在移动间柔和地高亮和放大,让用户清楚"现在选的是什么、我在哪";配合无边 artwork、流畅动效和沉浸式音频,并让登录少而简单、随观看者自动切换资料库。
visionOS:先找"最小沉浸"
visionOS 的 App 运行在真实环境里的 3D 空间中:应用默认启动在多应用Shared Space,可移入单应用Full Space;Digital Crown 调节 passthrough。设计上要优先舒适度(内容相对头部定位、避免眩晕式运动、手势让手能放松);UI 密集型体验用带标准控件的窗口承载;并且"不要假设每个时刻都需要全沉浸"——为每个关键时刻找到最小沉浸等级即可。
watchOS:抬腕一瞥,一两步完成
手表屏幕极小、交互是"一天抬腕几十次、每次不到一分钟":信息要简短关键,操作一两个手势完成;导航层级尽量浅,用 Digital Crown 滚动或换屏;而且complications、通知、Siri 往往比 App 本体被用得更多——App 必须能独立工作,但也得为抬腕场景设计好"钩子"。
📌 HIGAgentSkills 的底线规则:当同一行为在不同平台不一致时,必须逐平台写明各自的规则,禁止偷懒说"通常如此"。这正是多平台设计最容易踩的坑。
路由机制:Agent 如何"知道"你在问哪个平台
光有 157 份参考还不够——关键是怎么在提问时只加载需要的那几份,而不是把整个语料塞进上下文。HIGAgentSkills 用 routing-index.md 把参考文件分成四级:
- Tier 1(必载的 16 个基础):accessibility、color、typography、layout、motion 等跨平台通用的设计基础;
- Tier 2(平台映射):按关键词命中平台,例如
iphone → designing-for-ios、apple tv → designing-for-tvos、apple watch → designing-for-watchos; - Tier 3(组件触发词):如
siri remote、digital crown、menu bar等,精确命中对应组件指南; - Tier 4(按需加载):小众主题(CareKit、AirPlay、NFC 等),只有直接命中才加载。
SKILL.md 定义了完整的 7 步加载协议:解析平台 → 载入 Tier 1 → 匹配平台文件 → 关键词扫描 → 一跳关联扩展 → 按需加载 Tier 4 → 引用原文作答。有 Python 3.10+ 时可用 scripts/hig_route.py 路由助手自动解析匹配。
这套机制带来的直接好处是:当你问"我的记账 App 在 watchOS 上怎么展示收支"时,Agent 只加载 watchOS 平台文件、complications、notifications 等少量相关参考,就能给出引用原文条款、保留精确数值和推荐强度(must / prefer / consider)的答案。
进阶:让现有 App 适配新形态
除了六大平台的差异化指南,2026-09-27 版还内置了/duo引导式工作流(commands/duo.md),帮你把已经上线的 iOS App适配到折叠屏 iPhone Duo:评估现有界面 → 对照 Apple 的 Duo 指南 → 给出建议待你确认 → 在 SwiftUI/UIKit 中原生实现 → 在模拟器中验证。折叠状态下列表与详情并排展开,正是"同一 App 随形态自适应"的最佳示例。
小结:用"平台参考文件"取代拍脑袋
- 一个 App 六个平台,差异的根源是距离、输入与场景——先看清这三点,UI 差异自然水到渠成;
- HIGAgentSkills 的 references/hig/ 目录把六大平台指南 + 150 余份组件指南按关键词路由组织,回答可溯源到 Apple HIG 原文;
- 记住它的三条铁律:引用精确数值、逐平台区分行为、保留推荐强度——多平台设计评审时可以直接拿来当检查清单用 ✅
【免费下载链接】HIGAgentSkills
Apple Human Interface Guidelines for Agents
相关推荐
HIGAgentSkills 覆盖 6 大苹果平台:iOS/iPadOS/macOS/tvOS/visionOS/watchOS 设计规范全解析
HIGAgentSkills 覆盖 6 大苹果平台:iOS/iPadOS/macOS/tvOS/visionOS/watchOS 设计规范全解析 HIGAgen
ZipArchive跨平台兼容性终极指南:iOS/macOS/tvOS/watchOS/visionOS全面支持
ZipArchive跨平台兼容性终极指南:iOS/macOS/tvOS/watchOS/visionOS全面支持 ZipArchive是一个简单实用的压缩解压工
开发工具SwiftUI-Introspect 多平台支持:iOS、macOS、tvOS、visionOS 统一方案
SwiftUI Introspect 多平台支持:iOS、macOS、tvOS、visionOS 统一方案 SwiftUI Introspect 是一个强大的
开发工具
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考