用途:把 macOS SwiftUI 应用迁移到现代 macOS 设计体系,尽量减少自定义外观。先落实标准应用结构、工具栏、搜索位置、sheet 与控件,再仅在需要差异化表面处添加自定义 Liquid Glass;优先使用系统玻璃与自适应材质,并审查已有的多余填充、遮罩与裁剪。
主要能力与用法:结构上优先 NavigationSplitView,侧边栏使用系统材质;大量媒体可用 backgroundExtensionEffect 延伸且不裁剪主体;TabView 保留顶层分区及各自导航状态。工具栏项默认渲染在浮动玻璃表面并自动分组,可用 ToolbarSpacer 的固定/弹性间距分组,sharedBackgroundVisibility 让单项独立,badge 添加状态标识,图标多为单色,tint 仅表达语义。搜索用 searchable 挂在正确容器层级(如 NavigationSplitView 或 TabView),次要搜索用 searchToolbarBehavior。控件优先系统控件,用 buttonBorderShape、controlSize 控制形状与密度,主操作使用系统 glass 与 glass-prominent 按钮样式;滑块可用 step 与 neutralValue;需要同心圆角时用 concentric rectangle 配合 containerConcentric。自定义玻璃用 glassEffect,必要时指定形状、tint,交互元素加 .interactive();相邻玻璃元素包在同一个 GlassEffectContainer 中,形变用 glassEffectID 配合 @Namespace。另提供审查清单与护栏:不重建系统侧边栏、工具栏、sheet、控件,不叠加不透明背景,不散放玻璃容器,不为装饰随意加色,不把 iPhone 的标签/搜索行为套用到 macOS。
适用场景:采用系统玻璃、移除冲突自定义外观、构建玻璃表面。限制:资料未提供收费、价格与平台支持范围等信息;涉及结构架构、视图重构、AppKit 互操作、启动调试时,技能建议分别转用 swiftui-patterns、view-refactor、appkit-interop、build-run-debug。