用途:在构建或重构 SwiftUI 界面时提供组件模式与示例,适用于导航、状态、布局、控件和页面组合等场景。
主要能力:提供组件参考索引(references/components-index.md)及导航栈、Sheet、深链、应用装配、异步状态、预览、性能等专题文档;给出状态归属选择表(@State、@Binding、@Observable、@Environment、@StateObject/@ObservedObject 等);列出反模式,如巨型视图、多个互斥布尔标志、在 body 中直接调用服务、滥用 AnyView、无明确归属地使用 @EnvironmentObject 或全局路由。
使用方式:已有项目先定位功能或页面与主要交互模型,用 rg "TabView(" 等查找相近示例并阅读最近的 SwiftUI 视图,遵循本地约定,从组件索引选择参考。新项目从 references/app-wiring.md 开始,装配 TabView + NavigationStack + sheets,按骨架添加 AppTab 与 RouterPath,再按需选择组件参考并扩展路由与 sheet 枚举。新视图流程:先定义状态、归属位置与最低 OS 假设,区分 @Environment 与初始化注入的依赖,画出视图层级与路由,实现异步加载与加载/错误状态,添加预览与无障碍标签,最后构建验证。
限制:资料未提供具体安装命令、收费方式、平台支持范围或效果数据;部分模式依赖最低 OS 版本,需按部署目标选择 API,iOS 16 及更早需回退到 ObservableObject 方案;API 可用性可能变化,建议查阅当前 Apple 开发者文档。