苹果文档搜索 xby-skill/xby-search-apple-docs

xby-search-apple-docs

DeepSeek Harness (DSH) 的插件：苹果开发者文档搜索服务

通过模型上下文协议（MCP）访问苹果官方开发者文档、框架、API及WWDC视频，支持AI驱动的自然语言查询，提供Swift/Objective-C代码示例和技术指南。

功能

- set_xby_apikey — 在聊天中设置 API 密钥（自动持久化，重启有效）
- search_apple_docs — 搜索苹果开发者文档中的 API、框架、指南和示例。最适合查找特定的 API、类或方法。如需浏览示例代码项目，请使用 get_sample_code。如需 WWDC 视频，请使用专用的 WWDC 工具（list_wwdc_videos、search_wwdc_content）。
- get_apple_doc_content — 从特定的苹果开发者文档页面获取详细内容。在 search_apple_docs 之后使用此工具以获取完整文档。支持增强分析选项，以便全面理解 API。最适合：阅读 API 详情、理解用法、检查可用性。
- list_technologies — 按类别浏览所有苹果技术和框架。对于发现可用框架和理解苹果技术生态系统至关重要。在以下情况使用：探索可用内容、查找 search_framework_symbols 的框架标识符、检查测试版状态。
- search_framework_symbols — 在特定苹果框架内浏览和搜索符号。非常适合探索框架 API、查找框架中的所有视图/控制器/委托，或发现可用类型。在 list_technologies 之后使用以获取框架标识符。
- get_related_apis — 分析 API 关系并发现相关功能。显示继承关系、协议遵循以及苹果推荐的替代方案。对于理解 API 如何协同工作至关重要。在以下情况使用：了解 API 层级结构、查找协议要求、发现相关功能。
- resolve_references_batch — 深入探究文档页面中引用的所有类型和 API。解析所有提及的类型、方法和属性，以理解依赖关系。在以下情况使用：分析复杂 API、理解类型要求、探索 API 生态系统。
- get_platform_compatibility — 检查 API 在苹果各平台和操作系统版本上的可用性。显示最低部署目标、弃用情况和平台特定功能。对于跨平台开发至关重要。在以下情况使用：规划应用需求、检查 API 可用性、查找平台替代方案。
- find_similar_apis — 发现替代和相关 API。查找功能相似的 API、已弃用 API 的现代替代方案以及平台特定的替代方案。在寻找更好的功能实现方式时非常适用。
- get_documentation_updates — 跟踪最新的苹果平台更新、新 API 和变更。显示 WWDC 公告、框架更新和发布说明。对于紧跟苹果开发动态至关重要。如需详细的 WWDC 视频，请使用 WWDC 专用工具。
- get_technology_overviews — 访问 Apple 技术的全面指南和教程。包括入门指南、架构概述、最佳实践和实现模式。非常适合学习新框架或了解 Apple 推荐的方法。
- get_sample_code — 浏览来自 Apple 的完整示例项目。展示最佳实践和实现模式的完整可运行示例。与返回代码片段的 search_apple_docs 不同。用于通过示例学习。
- list_wwdc_videos — 浏览 WWDC 会议视频，可完全离线访问文字记录和代码。显示所有可用会议并提供筛选选项。使用此工具发现 WWDC 内容、按主题查找会议或识别包含代码示例的视频。
- search_wwdc_content — 在所有 WWDC 视频文字记录和代码示例中进行全文搜索。查找特定讨论、API 提及或实现示例。在查找特定内容方面比 list_wwdc_videos 更强大。
- get_wwdc_video — 访问完整的 WWDC 会议内容，包括完整文字记录、代码示例和资源。在使用 list_wwdc_videos 或 search_wwdc_content 找到视频后使用。提供对整个会议内容的离线访问。
- get_wwdc_code_examples — 浏览 WWDC 会议中的所有代码示例。非常适合查找实现模式、查看新 API 用法或通过示例学习。每个结果都包含代码及其会议上下文。
- browse_wwdc_topics — 列出所有 WWDC 主题类别及其 ID。在使用带主题筛选的 list_wwdc_videos 之前必不可少的首要步骤。返回诸如 "swiftui-ui-frameworks" 之类的主题 ID，可用于其他工具。
- find_related_wwdc_videos — 发现与特定视频相关的 WWDC 会议。查找前置会议、后续内容和主题相似的演讲。对于创建学习路径至关重要。
- list_wwdc_years — 列出所有可用的 WWDC 年份及其视频数量和统计信息。显示哪些年份有可用内容以及每年包含多少视频。

安装

方式一：从 GitHub 直接安装（推荐）

格式: dsh plugin --profile add github:/
dsh plugin --profile web add github:xby_skill/xby-search-apple-docs

方式二：从本地目录安装（开发模式）

仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-search-apple-docs

方式三：通过 cordis.patch.yml 开发调试

dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml

配置

获取 API 密钥

前往 小笨羊官网 注册并获取 API 密钥。