更新 SwiftUI API

通过 Sosumi MCP 系统地扫描 Apple 开发者文档，识别已弃用的 SwiftUI API 及其现代替代方案，并更新 swiftui-expert-skill/references/latest-apis.md。

前提条件

• Sosumi MCP 必须已启用且可用（提供 searchAppleDocumentation、fetchAppleDocumentation、fetchAppleVideoTranscript、fetchExternalDocumentation 工具）
• 具有此仓库（或复刻仓库）的写入权限

工作流程

1. 了解当前覆盖范围

阅读 swiftui-expert-skill/references/latest-apis.md 以了解：

• 已记录哪些弃用 API 到现代 API 的转换
• 正在使用的版本分段（iOS 15+、16+、17+、18+、26+）
• 底部的快速查找表

2. 加载扫描清单

阅读 references/scan-manifest.md（相对于此技能）。它包含要扫描的 API 领域、文档路径、搜索查询和 WWDC 视频路径的分类列表。

3. 扫描 Apple 文档

对于清单中的每个类别：

1. 使用列出的查询调用 searchAppleDocumentation 以发现相关页面。
2. 使用特定的文档路径调用 fetchAppleDocumentation 以获取完整的 API 详情。
3. 查找弃用通知、”已弃用”标签和”改用 …”的指导。
4. 注意现代替代方案可用的 iOS 版本。
5. 可选择调用 fetchAppleVideoTranscript 来获取宣布 API 变更的 WWDC 会议记录。

为了提高效率，请将相关的搜索批量组合在一起。重点关注查找尚未在 latest-apis.md 中记录的新弃用项。

4. 比较并识别变更

将发现的结果与现有条目进行比较。对结果进行分类：

• 新弃用项：尚未在 latest-apis.md 中记录的 API
• 更正项：需要更新的现有条目（版本错误、有更好的替代方案）
• 新版本分段：如果新的 iOS 版本引入了弃用项，请添加新的部分

5. 更新 latest-apis.md

严格遵循既定的格式。每个条目必须包括：

部分放置 — 放置在正确的版本分段下：

• “始终使用（iOS 15+）” 用于已弃用很久的 API
• “当目标为 iOS 16+ / 17+ / 18+ / 26+ 时” 用于版本受限的变更

条目格式：

**始终使用 `modernAPI()` 替代 `deprecatedAPI()`。**

\```swift
// 现代写法
View()
    .modernAPI()

// 已弃用
View()
    .deprecatedAPI()
\```

快速查找表 — 在文件底部添加一行：

| `deprecatedAPI()` | `modernAPI()` | iOS XX+ |

保持文件顶部的署名行：

基于使用 Sosumi MCP 对 Apple 文档的对比，我们找到了最新的推荐 API。

6. 开启拉取请求

1. 从 main 分支创建一个名为 update/latest-apis-YYYY-MM 的分支（使用当前年份和月份）。
2. 将更改提交到 swiftui-expert-skill/references/latest-apis.md。
3. 通过 gh pr create 开启一个 PR，内容包括：
   • 标题：”Update latest SwiftUI APIs (Month Year)”
   • 正文：新/更改条目的摘要、归因于 Sosumi MCP

Sosumi MCP 工具参考

技巧

• 先从广泛的 searchAppleDocumentation 查询开始，然后使用 fetchAppleDocumentation 深入特定的路径。
• Apple 的弃用文档通常会在页面中显示“已弃用”并链接到替代方案。
• WWDC 的“SwiftUI 新特性”会议是查找新引入的替代方案的最佳来源。
• 当不确定弃用的确切 iOS 版本时，通过查看获取的文档中的“可用性”部分来验证。
• 如果某个 API 已弃用但没有直接的替代方案，请注明这一点，而不是建议不正确的替代方案。