核心用法
apple-docs 是一款面向 Apple 生态开发者的文档查询技能，通过命令行接口提供五大核心功能模块：文档搜索（search//symbols//doc）、API 探索（apis//platform//similar）、技术浏览（tech//overview//samples）以及 WWDC 视频检索（wwdc-search//wwdc-video` 等）。用户可通过自然语言查询快速定位 SwiftUI、UIKit、Objective-C 等框架的官方文档，支持按平台版本、技术类别、年份等多维度过滤，并内置 1,260+ 部 WWDC 视频的离线数据包（35MB），可直接获取视频转录文本与代码示例。
显著优点
权威数据源：直接对接 Apple 官方开发者文档 API（developer.apple.com），确保信息准确性与时效性，避免第三方文档的滞后或错误。 零配置开箱即用：纯 Node.js 实现，仅依赖原生 fetch API，无需安装额外依赖或配置认证密钥。 开发者场景深度优化：提供符号级检索（如 UITableViewDelegate 方法查询）、继承关系图谱、平台兼容性检查（iOS/macOS/watchOS 版本支持）及废弃 API 替代方案推荐，精准匹配开发调试需求。 WWDC 资源一站式整合：覆盖 2014-2025 年全部 WWDC 会议，支持按主题分类浏览与视频转录提取，大幅降低技术学习成本。 智能缓存机制：文档 API 30 分钟缓存、搜索结果 10 分钟缓存，平衡实时性与响应速度。
潜在缺点与局限性
网络依赖性强：所有实时查询均需连接 Apple 官方服务器，离线环境下仅可访问已缓存的 WWDC 视频元数据，无法检索最新文档更新。 功能边界明确：仅支持只读查询，无法直接下载示例代码或生成 Xcode 项目模板，仍需手动跳转至 Apple 官网完成后续操作。 中文支持有限：Apple 官方文档以英文为主，该技能未内置机器翻译层，非英语开发者阅读门槛较高。 WWDC 数据更新延迟：离线视频包需随技能版本更新，当年最新 WWDC 内容可能存在数周滞后。 结果深度受限：复杂查询（如跨框架关联分析）需多次命令组合，缺乏交互式探索界面。
适合的目标群体
iOS/macOS/watchOS 开发者：日常开发中需快速查阅 API 签名、平台兼容性或替代方案的技术人员。 技术学习者：系统学习 SwiftUI/UIKit 框架、准备技术面试或跟进 WWDC 新特性的初学者与进阶开发者。 跨平台团队：需评估 Apple 技术栈可行性（如 Vision 框架、SwiftData）的产品经理或技术决策者。 教育培训机构：编程教学中需要权威代码示例与官方技术解读的讲师与课程设计者。
使用风险
网络稳定性风险：Apple 官方 API 偶发限流或区域性访问延迟，高峰期可能影响查询响应。 数据时效性风险：缓存策略虽提升性能，但紧急安全补丁或 API 变更可能存在 10-30 分钟信息差。 输入误用风险：虽经 URL 编码防护，但极长查询字符串（>2000 字符）可能导致 Apple 服务端截断或报错。 依赖维护风险：WWDC 数据源依赖社区仓库（kimsungwhee/apple-docs-mcp），若上游停止维护，视频检索功能将受限。