xby-search-apple-docs：蘋果開發者文檔搜索與 WWDC 內容訪問插件

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。