swiftui-core

涵盖所有 Apple 平台通用的 SwiftUI 基础知识：可组合的视图与修饰符、导航（用于基于堆栈流程的 NavigationStack、用于多列布局的 NavigationSplitView）、使用 SwiftData 进行数据持久化（@Model，在大多数情况下取代 Core Data）、状态管理（用于本地状态的 @State、用于共享状态的 @Observable、用于注入的 @Environment）、Liquid Glass 样式，以及用于 Siri/Shortcuts 集成的 App Intents。

参考资料深入介绍视图/修饰符、导航、SwiftData、跨平台的 Liquid Glass，以及 App Intents。

最佳实践：视图主体超过约 30 行时提取子视图；使用 ViewBuilder 和修饰符进行组合；始终包含 #Preview；使用语义颜色（.primary/.secondary）；为图标添加辅助功能标签；根据尺寸类别调整布局。

SwiftUI 核心

所有 Apple 平台通用的 SwiftUI 基础知识。

Agent 工作流（必需）

在进行任何实现之前，必须并行启动 3 个 Agent，每个使用一个带有 name 的 Agent 调用：

1. fuse-ai-pilot:explore-codebase - 分析现有的 SwiftUI 模式
2. fuse-ai-pilot:research-expert - 通过 Context7/Exa 核实最新的 SwiftUI 文档
3. mcp__apple-docs__search_apple_docs - 检查 SwiftUI 视图模式

实现后，运行 fuse-ai-pilot:sniper 进行验证。

---

概览

适用场景

• 构建 SwiftUI 视图和组件
• 实现导航（NavigationStack、SplitView）
• 使用 SwiftData 进行数据持久化
• 状态管理（@State、@Observable）
• 自定义视图修饰符和布局

SwiftUI 核心的优势

特性	优势
声明式 UI	代码更少，自动更新
跨平台	iOS/macOS/watchOS/visionOS 使用相同代码
@Observable	简单的响应式状态
SwiftData	以极少代码实现现代化持久化

---

核心概念

视图与修饰符

可组合的 UI 构建模块。达到 30 行以上时提取子视图。

导航

基于堆栈的导航使用 NavigationStack，多列导航使用 NavigationSplitView。

SwiftData

使用 @Model 实现现代化持久化。在大多数使用场景中取代 Core Data。

状态管理

@State 用于本地状态，@Observable 用于共享状态，@Environment 用于注入。

---

参考指南

需求	参考资料
视图、修饰符、布局	views-modifiers.md
NavigationStack、深度链接	navigation.md
SwiftData、@Query、CloudKit	data-swiftdata.md
@State、@Observable、Environment	state-management.md
所有平台上的 Liquid Glass	liquid-glass.md
Siri、Shortcuts、App Intents	app-intents.md

---

最佳实践

1. 精简视图 - 达到 30 行以上时提取子视图
2. 组合 - 使用 ViewBuilder 和修饰符
3. 预览驱动 - 始终包含 #Preview
4. 语义颜色 - 使用 .primary、.secondary
5. 辅助功能 - 为图标添加标签
6. 适配平台 - 检查 sizeClass 以实现响应式布局