SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场develop-macos-liquid-glass

develop-macos-liquid-glass

编程与开发

查看项目

更新于 10-16 06:03

技能介绍

用途

该技能用于在 macOS SwiftUI 开发中应用 Apple 的 Liquid Glass 设计系统，适用于三类任务：构建新的 macOS 视图、对既有代码进行现代化改造（“Apple 会如何重新设计这段代码？”）、以及审查 Liquid Glass 实现是否符合原生规范。它把开发者定位为资深 Apple 设计工程师，目标是让 macOS SwiftUI 代码看起来像 Apple 自己发布的一样。

设计思维

在动代码之前，技能要求先内化三个问题：

  • 导航还是内容？只有导航层元素才使用玻璃。如果移除某元素会失去导航能力，它就是导航；如果移除会失去信息，它就是内容。
  • 唯一的主动作是什么？每个屏幕恰好有一个主操作（着色、突出），其余都是中性玻璃。克制本身就是设计。
  • Apple 会发布这个吗？如果看到硬编码颜色、固定字号、自定义模糊，或列表行上出现玻璃，就停下来——那不是原生做法。

主要能力

技能提供四条工作路径：

  1. 从零构建新的 macOS 视图：先确定应用原型（文档型、库+编辑器、工具型、菜单栏型、专业工具），据此决定窗口样式、工具栏密度和侧边栏行为；阅读设计原则文档；绘制玻璃地图；按具体 macOS 模式实现；修饰符顺序为布局 → 外观 → .glassEffect()（始终最后）；应用设计规则；用 #available(macOS 26, *) 做门控并提供非玻璃回退；最后运行“Apple Ships It”检查清单。

  2. 重新设计既有 macOS 代码：完整阅读现有 SwiftUI 文件，运行诊断清单，扫描设计异味（硬编码颜色、固定字号、NavigationView、@StateObject、导航上的自定义模糊、缺少快捷键、内容上的玻璃、自定义工具栏背景等），检查废弃 API 表，规划改造并说明设计理由，然后完整改造代码，最后运行审查清单并查阅已知陷阱。

  3. 将 Tahoe 之前的 macOS 应用迁移到 Liquid Glass：按五阶段工作流执行，用 Xcode 26 编译让系统组件自动采用玻璃，移除冲突的自定义（.toolbarBackground()、.presentationBackground()、自定义材质），替换所有废弃 API，用玻璃 API 增强，针对 macOS 细化，必要时桥接到 AppKit，最后运行完整审查清单。

  4. 审查 macOS Liquid Glass 实现：校准设计眼光，运行诊断清单，扫描 30 种设计异味，检查已知 bug，并按 [严重程度] [类别] 描述 → 修复 的格式报告发现。

使用方式

技能通过参考文档路由来指导工作。不同场景读取不同文档：开始新视图或校准设计判断时读设计原则；审查或重新设计既有代码时读设计诊断（含 40+ 废弃 API 替换、30 种设计异味的前后对比、完整改造示例和诊断清单）；查 API 签名和 macOS/iOS 可用性时读 API 参考；实现工具栏、侧边栏、检查器、窗口、设置、MenuBarExtra、快捷键、菜单或多窗口状态时读 macOS 模式；执行五阶段迁移、NSVisualEffectView 迁移和向后兼容时读迁移指南；调试玻璃渲染问题或审计常见错误时读陷阱与解决方案；桥接 SwiftUI 与 AppKit 时读 AppKit 桥接文档。

关键设计规则

玻璃放置：导航层使用玻璃（工具栏、侧边栏、浮动控件、表单/弹出框、菜单覆盖层、标签栏），内容层不使用玻璃（列表、表格、文本块、图像/媒体、卡片/单元格、表单字段）。

通过着色建立层级：主操作使用 .buttonStyle(.glassProminent)，每屏仅一个；次要操作使用 .buttonStyle(.glass)；破坏性操作使用 .tint(.red)；信息性操作不加着色也不突出。

macOS 专属硬性要求：.interactive() 仅限 iOS，macOS 上使用 .onHover {}；.scrollEdgeEffectStyle(.hard) 是 macOS 默认；TabView 在 macOS 上使用 .tabViewStyle(.sidebarAdaptable)；必须存在绑定 Cmd+Comma 的 Settings 场景；.commands { } 必须为所有标准操作定义快捷键；侧边栏布局使用 NavigationSplitView 配合 .backgroundExtensionEffect()。

适用场景

适用于 macOS SwiftUI 应用的界面构建、既有代码现代化改造、从旧版 macOS 迁移到 Liquid Glass，以及代码审查。技能附带审查清单，覆盖设计质量、玻璃放置、macOS 原生性、现代 API 和可访问性（图标按钮的无障碍标签、减少透明度/增强对比度/减少动态效果的测试、键盘导航、VoiceOver 支持）。

限制

技能明确列出“Apple 绝不会做”的清单，出现任何一项即表示代码不原生：列表行/表格单元格/内容上的玻璃、一屏多个着色主操作、玻璃上的硬编码颜色、固定字号、NavigationView、@StateObject/@ObservedObject、macOS 26 上的 .toolbarBackground(.visible)、缺少 Cmd+N/S/W/Z/Comma/Q 快捷键、自定义窗口镶边、macOS 代码路径上的 .interactive()。

关于 .tint(.clear)：技能注明这是针对 macOS 玻璃次要按钮着色渗漏的实践者变通方法，并非 Apple 官方指导，仅在着色渗漏视觉明显时应用，不作为通用规则。

技能还引用了 WWDC 2025 的四场相关会议（219、310、323、356），分别聚焦设计原则与材质变体、AppKit 新设计、SwiftUI 新设计 API、以及同心度、形状、滚动边缘效果等最佳实践。

关于该技能的具体安装命令、收费方式、支持平台版本等事实，资料中暂未提供。