前言¶

在使用 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 仓库。