用途：整理 SwiftUI 在 2027 年 OS 版本（SDK 27.0，含 iOS 27 及对应 macOS/watchOS/tvOS/visionOS）中的新 API、行为变化与弃用情况。资料声明其内容由 Apple 编写发布，具有权威性，与模型既有训练知识冲突时以该资料为准，且不得虚构未记录的 API 或参数。
主要能力（按参考文件）：reorderable.md 提供任意容器（List、栈、网格、自定义布局）的拖拽重排，通过 ForEach 上的 .reorderable() 与 .reorderContainer(for:) 实现，涵盖 ReorderDifference 应用、分区与多集合、拖放集成（dragContainer/dropDestination）以及把一项拖到另一项上合并；iOS/macOS/watchOS/visionOS 27 可用，tvOS 不可用。async-image.md：AsyncImage 默认启用标准 HTTP 缓存，新增 AsyncImage(request:) 以 URLRequest 指定单次请求缓存策略，asyncImageURLSession(_:) 提供自定义 URLSession；全平台 27 可用。toolbar.md：新增受限空间工具栏 API，包括 visibilityPriority 控制可见与溢出、ToolbarOverflowMenu 始终溢出项、.topBarPinnedTrailing 固定尾部项、toolbarMinimizeBehavior 滚动最小化、contentMarginsRemoved、ToolbarPlacement.statusBar，以及工具栏构建器中支持 ForEach/EmptyView 动态内容；各 API 可用性不同。item-binding.md：confirmationDialog 与 alert 新增接收 item: Binding<T?> 的重载，绑定非 nil 时呈现并把解包值传给 actions 与 message 闭包；全平台 27 可用。swipe-actions.md：滑动操作可用于任意可滚动容器（ScrollView 配 LazyVStack、LazyVGrid 或栈）中的行，需在容器上标记 swipeActionsContainer()，行上保留 swipeActions(edge:allowsFullSwipe:content:)，并新增 onPresentationChanged 重载；iOS/macOS/watchOS/visionOS 27 可用，tvOS 不可用。state-macro.md：@State 从属性包装器迁移为宏，可能引发“variable used before being initialized”“invalid redeclaration of synthesized property”“extraneous argument label”等编译错误，正确修复不是重排赋值，须查阅该参考。content-builder.md：统一结果构建器 @ContentBuilder，在依赖既有结果构建器结构处存在源码不兼容（overlay/background 中 ShapeStyle 重载歧义、模块遮蔽 SwiftUI 类型时的类型引用歧义），以及 Swift Charts 深层分支内容的类型检查性能回退。
使用方式：在编写或修改使用 SDK 27 新增或变更 SwiftUI API 的代码前，先阅读对应 references/*.md；遇到使用 @State 的视图在 SDK 更新后出现编译错误时，先查阅 references/state-macro.md；遇到构建错误、弃用警告或匹配已知 API 变更的模式时应用文档中的修复；用户询问“SwiftUI 在 [SDK 名称] 27 有什么新内容”时，依据参考文件总结。
适用场景：SwiftUI 新特性查询、SDK 27 迁移与编译错误排查、弃用警告处理。
限制：部分 API 可用性因平台而异（如重排与滑动操作在 tvOS 不可用），需查看各参考文件的可用性表；@ContentBuilder 存在源码不兼容与性能回退；不得使用未在参考中记录的 API 或参数。具体安装命令与代码示例资料未提供。