需求
Liquid Glass UI API
默认选项
SwiftUI with glassEffect, GlassEffectContainer，以及玻璃按钮样式
为何需要它
这些是技能应优先使用的原生 API，以便让 Codex 移除自定义模糊层，而不是重新发明材质系统。
Codex 用例
采用 liquid glass 风格
使用 Codex 将现有 SwiftUI 应用迁移至 Liquid Glass，适配 iOS 26 API 与 Xcode 26。
难度 高级
时间周期 1h
结合 Codex 与 Build iOS Apps 插件审查现有 iPhone 和 iPad UI，用原生 Liquid Glass 替换自定义模糊或材质堆栈，并通过 iOS 26 可用性检查和模拟器驱动的验证确保迁移安全。
适用场景
- 需要切实可行的 iOS 26 Liquid Glass 迁移方案（而非笼统的重设计简报）的现有 SwiftUI 应用
- 希望由 Codex 审查自定义卡片、表单、标签栏、工具栏和操作按钮，然后逐步实施迁移的团队
- 仍需支持旧版 iOS，并需要通过 `#available(iOS 26, *)` 设置回退方案，而非单方面视觉重写的应用
目录
采用 liquid glass 风格
使用 Codex 将现有 SwiftUI 应用迁移至 Liquid Glass，适配 iOS 26 API 与 Xcode 26。
结合 Codex 与 Build iOS Apps 插件审查现有 iPhone 和 iPad UI，用原生 Liquid Glass 替换自定义模糊或材质堆栈，并通过 iOS 26 可用性检查和模拟器驱动的验证确保迁移安全。
高级
1h
结合 Codex 与 Build iOS Apps 插件审查现有 iPhone 和 iPad UI，用原生 Liquid Glass 替换自定义模糊或材质堆栈，并通过 iOS 26 可用性检查和模拟器驱动的验证确保迁移安全。
高级
1h
适用场景
- 需要切实可行的 iOS 26 Liquid Glass 迁移方案（而非笼统的重设计简报）的现有 SwiftUI 应用
- 希望由 Codex 审查自定义卡片、表单、标签栏、工具栏和操作按钮，然后逐步实施迁移的团队
- 仍需支持旧版 iOS，并需要通过 `#available(iOS 26, *)` 设置回退方案，而非单方面视觉重写的应用
技能与插件
- 使用 SwiftUI Liquid Glass、SwiftUI UI 模式和模拟器调试等技能现代化 iOS 界面，采用原生玻璃效果，并在 iOS 26 模拟器上验证结果。
| 技能 | 为什么使用它 |
|---|---|
| 构建 iOS 应用 | 使用 SwiftUI Liquid Glass、SwiftUI UI 模式和模拟器调试等技能现代化 iOS 界面，采用原生玻璃效果，并在 iOS 26 模拟器上验证结果。 |
起始提示词
使用 Build iOS Apps 插件及其 SwiftUI Liquid Glass 技能，将此应用中一个高流量流程迁移至 Liquid Glass。约束条件：- 将其视为 iOS 26 + Xcode 26 迁移项目，但使用 `#available(iOS 26, *)` 为早期的部署目标保留非玻璃效果的回退方案。- 先审查流程。指出应转换为原生 Liquid Glass 的自定义背景、模糊堆栈、标签、按钮、表单和工具栏，并指出应保持为纯内容呈现的界面。- 优先使用系统控件和原生 API（如 `glassEffect`、`GlassEffectContainer`、`glassEffectID`、`.buttonStyle(.glass)` 和 `.buttonStyle(.glassProminent)`）而非自定义模糊。仅当真实的变形过渡能改善流程时，才将 `glassEffectID` 与 `@Namespace` 结合使用。- 在布局和视觉修饰符之后应用 `glassEffect`，保持形状一致，并且仅对实际响应触摸的控件使用 `.interactive()`。- 使用 XcodeBuildMCP 在 iOS 26 模拟器上构建并运行，捕获已迁移流程的屏幕截图，并明确说明所使用的方案、模拟器和检查项。交付内容：- 该流程的简明迁移计划- 已实现的 Liquid Glass 切片- iOS 26 之前设备的回退行为- 你使用的模拟器验证步骤和屏幕截图
使用 Build iOS Apps 插件及其 SwiftUI Liquid Glass 技能，将此应用中一个高流量流程迁移至 Liquid Glass。约束条件：- 将其视为 iOS 26 + Xcode 26 迁移项目，但使用 `#available(iOS 26, *)` 为早期的部署目标保留非玻璃效果的回退方案。- 先审查流程。指出应转换为原生 Liquid Glass 的自定义背景、模糊堆栈、标签、按钮、表单和工具栏，并指出应保持为纯内容呈现的界面。- 优先使用系统控件和原生 API（如 `glassEffect`、`GlassEffectContainer`、`glassEffectID`、`.buttonStyle(.glass)` 和 `.buttonStyle(.glassProminent)`）而非自定义模糊。仅当真实的变形过渡能改善流程时，才将 `glassEffectID` 与 `@Namespace` 结合使用。- 在布局和视觉修饰符之后应用 `glassEffect`，保持形状一致，并且仅对实际响应触摸的控件使用 `.interactive()`。- 使用 XcodeBuildMCP 在 iOS 26 模拟器上构建并运行，捕获已迁移流程的屏幕截图，并明确说明所使用的方案、模拟器和检查项。交付内容：- 该流程的简明迁移计划- 已实现的 Liquid Glass 切片- iOS 26 之前设备的回退行为- 你使用的模拟器验证步骤和屏幕截图
从 iOS 26 基线开始
首先将 Liquid Glass 视作 iOS 26 和 Xcode 26 的迁移项目。使用 iOS 26 SDK 重新构建应用，检查标准 SwiftUI 控件自动提供的效果，然后再让 Codex 重新设计那些看起来仍然过于扁平、过于沉重或与系统界面风格严重脱节的自定义部分。
如果应用仍需支持早期的 iOS 版本，请预先明确该约束条件。 Build iOS Apps 插件 中的 SwiftUI Liquid Glass 技能将使用 #available(iOS 26, *) 对仅支持新版系统的玻璃效果 API 进行条件限制，并保留在旧设备上依然显示正常的回退路径。
利用 iOS 插件
使用 Build iOS Apps 插件 当你希望 Codex 将 SwiftUI UI 更改与模拟器验证相结合时。对于 Liquid Glass 相关工作，最佳做法是让 Codex 审查单个流程，迁移一小部分界面，在 iOS 26 模拟器上启动结果并捕获屏幕截图，然后再扩大迁移范围。
该插件包含一个 SwiftUI Liquid Glass 技能，其默认设置非常适合直接用于你的提示词：
- 优先使用原生
glassEffect,GlassEffectContainer，玻璃按钮样式，以及glassEffectID过渡，而非自定义模糊视图。 - 对工具参数
.glassEffect(...)应用于布局和视觉修饰符之后，使材质能够包裹你真正想要的最终形状。 - 将相关的玻璃效果元素包裹在
GlassEffectContainer中（当多个表面同时出现时）。 - 使用
.interactive()仅应用于实际响应触摸的按钮、标签和控件。 - 在整个功能中保持圆角形状、着色和间距的一致性，不要混用各种临时拼凑的玻璃效果处理。
- 为 iOS 26 之前的部署目标保留非玻璃效果的回退方案。
如需了解有关安装插件和技能的更多信息，请参阅我们的 插件 and 技能 docs.
观看 WWDC 会议视频
在要求 Codex 重构实际的生产流程之前，以下 WWDC25 会议视频是很好的参考：
先提示迁移计划，再逐步切片
如果让 Codex 先解决“玻璃效果应出现在哪里？”的问题，而不是“立即编写所有代码”，Liquid Glass 迁移的效果会更好。首先要求进行快速审查，然后让代理实现一个独立的切片并通过模拟器进行验证。
实用技巧
不要对所有内容都使用玻璃效果
Liquid Glass 应在内容之上创建一个清晰的控件层，而不是将每张卡片都变成发光面板。要求 Codex 移除与系统材质冲突的装饰性背景，在可读性最重要的地方保留纯内容，并将着色保留用于语义强调或主要操作。
从高流量流程开始
标签栏根页面、详情页、表单、搜索界面或新手指引流程，通常比直接进行全应用范围的迁移更适合作为首选迁移目标。这能让审查更容易，也更能明确哪些 Liquid Glass 决策应被固化为可重用的组件模式。
仔细审查回退行为
如果你的部署目标低于 iOS 26，请让 Codex 在展示 Liquid Glass 版本的同时也提供回退实现。这个审查步骤可以发现意外的 API 可用性退化问题，避免交付只能在最新模拟器上运行的迁移方案。
技术栈
需求
默认选项
为何需要它
需求
平台基线
默认选项
iOS 26 和 Xcode 26
为何需要它
Liquid Glass 随 iOS 26 SDK 同步发布。Codex 应使用 Xcode 26 进行编译，并为早期的操作系统支持添加明确的回退方案。
需求
模拟器验证
默认选项
为何需要它
在视觉迁移过程中，构建、启动、截屏和日志检查至关重要，尤其是在审查多种状态和设备尺寸时。
| 需求 | 默认选项 | 为何需要它 |
|---|---|---|
| Liquid Glass UI API | SwiftUI with glassEffect , GlassEffectContainer ，以及玻璃按钮样式 | 这些是技能应优先使用的原生 API，以便让 Codex 移除自定义模糊层，而不是重新发明材质系统。 |
| 平台基线 | iOS 26 和 Xcode 26 | Liquid Glass 随 iOS 26 SDK 同步发布。Codex 应使用 Xcode 26 进行编译，并为早期的操作系统支持添加明确的回退方案。 |
| 模拟器验证 | XcodeBuildMCP | 在视觉迁移过程中，构建、启动、截屏和日志检查至关重要，尤其是在审查多种状态和设备尺寸时。 |
