Apple Docs

🍎 Apple 官方文档与 WWDC 一站式查询

官方 Apple 开发者文档查询工具,支持 SwiftUI/UIKit API 检索、WWDC 视频搜索与技术分析,为 iOS/macOS 开发提供一手权威资料

收藏
15.5k
安装
3.3k
版本
1.0.0
CLS 安全性认证2026-05-06
点击查看完整报告 >

使用说明

核心功能

apple-docs 是一款面向 Apple 平台开发者的专业文档查询技能,通过原生 fetch 直连 Apple 官方开发者资源库,无需安装即可使用。

主要能力

| 维度 | 功能说明 |
|------|---------|
| **文档检索** | 支持 Apple Developer Documentation 全文搜索、符号查询、技术概览浏览 |
| **API 分析** | 提供类继承层级、协议遵循关系、平台版本兼容性检查 |
| **替代推荐** | 智能识别废弃 API 并推荐 Apple 官方替代方案 |
| **WWDC 视频** | 覆盖 2014-2025 共 1,260+ 场会议,支持字幕检索、代码示例提取 |
| **示例项目** | 按技术分类浏览 Swift/Objective-C 官方 Sample Code |

显著优点

  • 来源权威:数据直接来自 Apple 官方文档与 WWDC 内容,确保 API 说明、版本要求、最佳实践的准确性
  • 离线缓存:内置 35MB WWDC 视频元数据,常用查询 10-30 分钟缓存机制提升响应速度
  • 多维度过滤:支持按框架、技术分类、年份、平台版本等精细化筛选
  • 开发友好:命令设计贴近实际开发场景(platform 查兼容、similar 找替代、apis 看继承)

局限性与风险

| 类型 | 说明 |
|------|------|
| **功能边界** | 仅覆盖 Apple 第一方框架,不支持第三方库(如 Alamofire、SnapKit) |
| **时效延迟** | 依赖缓存机制,新 API 或文档更新可能存在 30 分钟同步延迟 |
| **视频深度** | WWDC 字幕为自动提取,复杂代码演示需配合视频观看 |
| **平台限定** | 专注于 Apple 生态,不适用于 Android、跨平台框架查询 |

适合人群

  • iOS/macOS/watchOS/tvOS 原生应用开发者
  • 需要迁移旧代码、适配新系统版本的维护工程师
  • 学习 SwiftUI/UIKit 框架的初学者(可通过 overview 获取结构化教程)
  • 技术调研人员(快速比对 API 平台差异)

常规风险提示

  • 依赖外部 MCP Server 稳定性,建议关键开发节点结合本地 Xcode 文档离线包使用
  • WWDC 视频内容可能涉及 Beta API,生产环境需核对正式版文档确认可用性

安全解读

核心用法

apple-docs 是专为 Apple 开发者设计的文档查询 Skill,通过原生 fetch API 实时访问 Apple 官方开发者文档。核心功能分为四大模块:

文档搜索:支持模糊搜索 API 文档、符号查找(类/结构体/协议)、精确路径文档获取。可快速定位 SwiftUIUIKitObjective-C 等框架的 API 说明。

API 探索:提供继承关系分析、协议遵循检查、平台兼容性验证(iOS/macOS/tvOS/watchOS 版本要求)、以及 Apple 推荐的替代方案查询,特别适合处理废弃 API 迁移。

技术浏览:按分类浏览 Apple 技术栈(如 SwiftUI、Vision、HealthKit),获取技术概览指南和官方示例代码,加速技术选型与原型开发。

WWDC 视频库:内置 1,260+ 条 WWDC 视频数据(2014-2025),支持关键词搜索、指定年份/场次查询、完整转录文本提取及代码片段获取。视频数据离线打包(约 35MB),响应迅速。

显著优点

  • 零依赖纯净:纯 Node.js 原生实现,无 npm 依赖,彻底消除供应链攻击风险
  • 官方数据源:所有文档内容直接来自 developer.apple.com,权威准确
  • 离线 WWDC 数据:视频索引本地缓存,即使无网络也能浏览元数据
  • 分级缓存策略:API 文档 30 分钟、搜索结果 10 分钟、框架信息 1 小时,平衡时效与性能
  • 多维度过滤:支持按技术分类、框架名称、年份等维度精确筛选结果

潜在局限

  • 依赖外部 WWDC 数据:视频详细数据托管于 GitHub 个人仓库(kimsungwhee/apple-docs-mcp),若仓库变更或删除可能影响功能
  • 无本地持久缓存:CLI 层未发现磁盘缓存,重复查询相同内容仍会发起网络请求
  • 网络请求无超时fetch() 未配置 signal 或超时参数,弱网环境下可能长时间挂起
  • 实时性限制:缓存策略虽合理,但紧急查阅最新 Beta 文档时可能稍有延迟

适合人群

  • iOS/macOS/watchOS/tvOS 开发者日常 API 查阅
  • 技术调研时需要快速了解 Apple 框架演进
  • WWDC 学习需求,需按主题检索历年 session
  • 处理旧项目 API 废弃迁移,需查询替代方案

常规风险

该 Skill 网络行为高度可控,仅访问 Apple 官方域名和 GitHub Raw Content。无敏感信息收集,不访问本地文件系统,无进程创建能力。唯一低风险点为外部 GitHub 数据源的可维护性,建议关注上游仓库更新状态。

Apple Docs 内容

手动下载zip · 7.5 kB
cli.jstext/javascript
请选择文件