查找 Apple 框架 API…

在开发 iOS/macOS 应用需要浏览或查找 Apple 框架（SwiftUI、UIKit、HealthKit 等）API 文档时，通过本地索引文件快速定位文档路径并按需获取详情。

适用场景

解决思路

1. 使用技能提供的索引表浏览各框架的可用 API：SwiftUI（../swiftui/swiftui-overview.md，907KB，涵盖 Views、modifiers、navigation、state）、XCTest（xctest-index.md，55KB，测试、断言、expectations）、XCUIAutomation（xcuiautomation-index.md，58KB，UI 测试、元素、查询）、UIKit（../uikit/uikit-overview.md，1.8MB，Views、controllers、controls、scenes）、Core Animation（../core-animation/core-animation-index.md，80KB，CALayer、CAAnimation、CATransaction、layer 子类）、HealthKit（healthkit-index.md，312KB，健康数据、workouts、records）、Combine（combine-index.md，153KB，Publishers、subscribers、operators）、SwiftData（swiftdata-index.md，86KB，Models、containers、queries）、Observation（observation-index.md，3KB，@Observable 宏）。
2. 浏览索引内容：用 `cat healthkit-index.md | head -100` 查看开头内容，或用 `grep -i "workout" healthkit-index.md`、`grep -i "navigation" ../swiftui/swiftui-overview.md` 搜索特定主题。
3. 在索引文件中查找文档路径：每个条目以 Markdown 链接形式列出路径，例如 `- [HKWorkout](/documentation/healthkit/hkworkout)`、`- [NavigationStack](/documentation/swiftui/navigationstack)`。
4. 获取更详细的文档前，先检查该详细页面是否已存在于已安装的 Apple 技能中。
5. 通过技能名称、描述或 `SKILL.md` frontmatter 找到可能的技能目录，先 grep 其本地 `.md` 文件，这比从互联网获取新文档更快且更省上下文。
6. 若已安装技能中没有该页面，则用相同路径拼接 `sosumi.ai` Markdown 镜像获取，例如 `/documentation/healthkit/hkworkout` 对应 `https://sosumi.ai/documentation/healthkit/hkworkout`。
7. 若本地索引不包含所需框架，使用该框架的 `sosumi.ai` 索引：`https://sosumi.ai/documentation/{framework}`，例如 `https://sosumi.ai/documentation/foundation` 提供可搜索 Foundation 路径的 Markdown 索引。
8. 若 Markdown 镜像不可用且环境能解析 JSON，使用 Apple 公开的 DocC 索引端点：`https://developer.apple.com/tutorials/data/index/{framework}`，有用的路径树位于 `interfaceLanguages.swift[0].children` 下。