DSH（DeepSeek Harness）的插件生态允许开发者扩展智能体的能力。苹果官方文档和 WWDC 内容资源丰富，但直接检索和定位具体 API 或技术细节往往效率较低。xby-search-apple-docs 通过模型上下文协议（MCP）连接这些资源，支持 AI 驱动的自然语言查询，提供 Swift/Objective-C 代码示例和技术指南。
插件定位¶
这是一个连接苹果开发者文档、API、框架及 WWDC 视频的搜索服务插件，由 xby-skill 维护。
安装与配置¶
使用前需要先注册并获取 API 密钥。前往 小笨羊官网 完成注册。
安装插件：
dsh plugin --profile web add github:xby_skill/xby-search-apple-docs
安装成功后，需要在对话中设置 API 密钥（自动持久化，重启有效）：
set_xby_apikey <你的密钥>
核心功能¶
文档检索与内容获取¶
search_apple_docs：搜索苹果开发者文档，用于查找特定的 API、类或方法。这是获取结果的起点。get_apple_doc_content：获取特定文档页面的详细内容。通常在search_apple_docs之后使用，用于阅读 API 详情、理解用法或检查可用性。list_technologies：按类别浏览所有苹果技术和框架。用于发现可用的框架或了解生态系统。search_framework_symbols：在特定框架内浏览和搜索符号。通常在list_technologies获取框架标识符后使用。get_sample_code：浏览完整的示例项目，区别于search_apple_docs返回的代码片段。
API 分析与依赖解析¶
get_related_apis：分析 API 关系，显示继承、协议遵循及 Apple 推荐的替代方案。resolve_references_batch：深入解析文档页面中引用的所有类型和 API，理解依赖关系。get_platform_compatibility：检查 API 在不同 Apple 平台和 OS 版本上的可用性，包括最低部署目标和弃用信息。find_similar_apis：发现替代和相关的 API，寻找具有类似功能的现代替换方案。
WWDC 内容访问¶
list_wwdc_years：列出所有可用的 WWDC 年份及视频数量。browse_wwdc_topics：列出所有 WWDC 话题分类及其 ID，用于后续按话题筛选视频。list_wwdc_videos：浏览 WWDC 会话视频，支持过滤。search_wwdc_content：对 WWDC 视频转录稿和代码示例进行全文搜索，用于查找特定讨论或实现示例。get_wwdc_video：获取完整的 WWDC 会话内容（包括转录稿、代码示例和资源），提供离线访问。get_wwdc_code_examples：浏览 WWDC 会话中的所有代码示例。find_related_wwdc_videos：发现与特定视频相关的会话，包括先修和后续内容。
技术概览与更新¶
get_technology_overviews：获取 Apple 技术的综合指南和教程。get_documentation_updates：追踪最新的 Apple 平台更新、新 API 和变更。
典型用法¶
查找特定 API¶
- 使用
search_apple_docs搜索目标 API 或类名。 - 使用
get_apple_doc_content获取详细文档。
探索框架与符号¶
- 使用
list_technologies浏览可用框架，获取框架标识符。 - 使用
search_framework_symbols在该框架内查找具体类型或方法。
使用 WWDC 内容学习¶
- 使用
list_wwdc_years确定有内容的年份。 - 使用
browse_wwdc_topics获取话题 ID。 - 使用
list_wwdc_videos或search_wwdc_content定位视频。 - 使用
get_wwdc_video获取完整内容。
适用场景与注意¶
- 适用场景：iOS/Swift/Objective-C 开发者需要快速查阅官方文档、检查 API 兼容性、查找 WWDC 案例代码或构建技术学习路径时。
- 注意：该插件以当前 dsh 进程的权限运行。安装前建议检查 GitHub 源码与许可证。插件遵循 MIT License。
