苹果开发者文档搜索

开发者为何需要这套检索工具

在实际项目中，Apple Developer Documentation 的信息量极大，涵盖了成千上万的 API、框架和指南。当你正在编码，突然需要确认某个 API 的确切签名、可用性或替代方案时，直接通过浏览器翻阅往往效率低下，容易迷失在层级菜单中。这个技能旨在解决这一痛点：它允许你通过自然语言描述需求，直接在 Apple Developer 的文档库中定位特定的 class、method 或 framework，甚至能穿透 WWDC 视频的转录内容寻找实现方案。

核心架构与工作流程

该服务基于 MCP 协议，核心逻辑是将你的 AI 助手变成一个智能路由层。它并不直接搜索数据，而是负责理解意图、提取参数并调用相应的检索脚本。

• 鉴权管理：服务强制要求 XBY_APIKEY。首次使用时，模型会主动触发交互询问密钥，确保后续请求合法。
• 多维度检索：

- search_apple_docs：用于常规的文档搜索。
- search_wwdc_content：支持对 WWDC 视频转录进行全文检索。
- search_framework_symbols：针对特定框架，如 SwiftUI，进行符号级的筛选。

• 深度分析：除了基础搜索，工具还提供 get_related_apis 来分析继承关系，以及 get_platform_compatibility 来确认 API 的最低部署目标。

使用注意与边界

• 必须配置密钥：如果环境中未检测到 .env 中的 XBY_APIKEY，该技能会中止流程并提示输入，无法在无密钥状态下运行。
• 语义而非猜测：虽然模型负责路由，但输入的描述越具体（例如使用 URLSession 而非“网络请求”），检索结果越精确。
• 不替代阅读：该工具能帮你快速定位和总结，但在处理复杂逻辑或特定平台的边缘行为时，仍需结合原始文档页面进行核实。