用途:在设计或实现原生 macOS 应用时提供规范指导,目标是做出快速、优雅、可访问且深度融入 macOS 工作流的“好 Mac 公民”应用。触发场景包括菜单栏结构、键盘快捷键、多窗口行为等。
主要能力:给出两条核心原则——优先使用系统组件与约定而非自定义 UI;若自定义栏、背景、边框或控件外观,需先停下并说明理由。提供 Mac Citizen 检查清单,覆盖菜单栏(标准布局 App/File/Edit/View/Window/Help,⌘, 打开设置)、键盘(每个主要命令可用键盘触达,标准快捷键可用)、窗口(流畅缩放、支持多窗口、尊重全屏与最小化)、侧边栏(顶层导航、条目可扫读、内容延伸至其后)、工具栏(按功能与频率分组,次要操作降级到“更多”菜单)、文本(使用系统文本组件与标准编辑行为)、辅助功能(VoiceOver 标签、完整键盘导航、支持减弱动态效果)。
Liquid Glass 规则:用于导航/控件层(工具栏、侧边栏、栏),让系统组件提供内置行为;不要用于内容层(表格、列表、文档内容),不要“玻璃叠玻璃”。
应用原型:文档型(文件为主要单位,打开/保存/复制)、库+编辑器(侧边栏列条目,主区域显示详情)、工具型(单窗口,可选菜单栏)、菜单栏应用(驻留菜单栏,界面极简)、专业工具型(密集、面向高级用户工作流)。
构建前交付物:确定应用原型;信息架构(侧边栏结构、导航、窗口模型);命令映射(每个主要功能的菜单与快捷键);状态与数据模型(持久化、撤销/重做、并发);辅助功能方案(VoiceOver、键盘、对比度、减弱动态效果)。
完整参考:设计系统细节、Icon Composer 工作流、SF Symbols 指导、评估标准与完成定义见 references/macos-design-guide.md。
常见错误与修正:缺少菜单栏命令——每个功能都进菜单并配快捷键;设置不在 App 菜单——始终用 ⌘, 从 App 菜单打开;自定义文本组件——使用系统文本以融入 Mac 编辑生态;工具栏过载——降级次要操作并按功能分组;玻璃用于内容——Liquid Glass 仅限导航层;破坏标准快捷键——绝不覆盖 ⌘C、⌘V、⌘Z 等;仅支持单窗口——在有利于工作流时支持多窗口。
限制:资料未提供具体安装命令、收费或价格信息,暂未提供。