用途：帮助开发者把现有应用迁移到 Apple Liquid Glass 设计语言，或在新建界面时遵循其最佳实践，也回答具体 API 问题（如 glassEffect、GlassEffectContainer）以及分层应用图标重设计、watchOS/tvOS 等平台差异。
主要能力：提供采用清单，按顺序覆盖构建与审查、视觉刷新、应用图标、控件、导航、菜单与工具栏、窗口与模态、布局、搜索、平台测试。视觉刷新要求移除导航元素的自定义背景，并用辅助功能设置（降低透明度、降低动态效果）测试。图标部分建议用 Icon Composer 做前景/中景/背景分层，使用简洁、填充、半透明形状。控件部分建议不硬编码布局尺寸、使用系统颜色、采用 .glass 与 .glassProminent 按钮样式、safeAreaBar 与 ConcentricRectangle。导航部分建议明确层级、考虑 sidebarAdaptable、使用 NavigationSplitView 与 backgroundExtensionEffect()。
自定义玻璃效果：基础用法包括 glassEffect()、glassEffect(in: .rect(cornerRadius:))、.tint()、.interactive()；多效果用 GlassEffectContainer(spacing:) 控制混合；动态视图统一形状用 glassEffectUnion(id:namespace:)；过渡协调用 glassEffectID(_:in:) 配合 @Namespace；过渡方式区分 matchedGeometry 与 materialize。
退出路径：若需使用最新 SDK 但保留旧外观，可在 Info.plist 添加 UIDesignRequiresCompatibility 键。
限制与原则：不要过度使用 Liquid Glass，仅限最重要的功能元素；让系统决定外观，移除自定义背景；测试辅助功能；注意性能，使用 GlassEffectContainer、限制屏幕上的效果数量并用 Instruments 分析；玻璃效果应在其他外观修饰符之后应用。详细代码示例与完整 API 参考见 references/liquid-glass-guide.md。