前言¶

在使用 DeepSeek Harness (DSH) 開發智能體時，處理 Kubernetes 相關的故障排查往往需要人工查閱外部文檔。xby-kubernetes-runbooks 插件通過引入基於模型上下文協議（MCP）的服務器，直接在對話中提供對 Kubernetes 故障排查手冊的訪問能力，支持搜索、內容獲取和 AI 集成。

插件介紹¶

該插件是一個 MCP 服務器，由 xby-skill 維護。它解決的核心問題是讓智能體能夠檢索 Kubernetes 的故障排查手冊，從而輔助進行自動化故障診斷或生成排查建議。

核心功能¶

插件提供以下四個核心能力：
* set_xby_apikey：在聊天上下文中設置 API 密鑰，該密鑰會自動持久化，重啓後依然有效。
* fetch_runbook：根據指定的主題獲取特定的 Kubernetes 故障排查手冊。
* search_runbooks：通過關鍵詞搜索 Kubernetes 故障排查手冊。
* list_topics：列出所有可用的 Kubernetes 故障排查手冊主題。

安裝與啓用¶

使用官方提供的命令進行安裝。安裝後，插件將作爲 MCP 服務器在 DSH 環境中運行。

dsh plugin --profile web add github:xby_skill/xby-kubernetes-runbooks

配置與使用¶

使用前需要配置 API 密鑰。獲取密鑰需要前往小笨羊官網註冊。

1. 設置 API 密鑰
   在聊天中調用 set_xby_apikey 命令，將獲取到的密鑰傳入。密鑰會被系統自動保存。

2. 查看可用主題
   調用 list_topics 可以列出當前所有可用的故障排查手冊主題，方便了解有哪些資源可供檢索。

3. 搜索手冊
   當遇到特定的 Kubernetes 錯誤時，調用 search_runbooks 並輸入關鍵詞，插件會返回相關的排查手冊內容。

4. 獲取具體手冊
   如果搜索結果指向某個特定主題，調用 fetch_runbook 並傳入該主題名稱，即可獲取完整的故障排查步驟。

適用場景與注意¶

• 適用場景：適用於需要基於 Kubernetes 運行時知識進行故障排查或自動化運維的 DSH 用戶。
• 注意事項：該插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼以確保安全性。插件採用 MIT 許可證。此外，獲取 API 密鑰需要註冊第三方網站（小笨羊官網），且該插件的主頁和作者信息目前爲空。

結尾¶

該插件通過集成 Kubernetes 故障排查手冊，降低了智能體獲取專業運維知識的門檻。如需查看更多細節，請訪問插件目錄或 GitHub 倉庫。