Merge pull request #8 from frezes/docs/extensions

add holmesgpt docs

Author: frezes

website/docs/extension-managerment/install.md

@@ -46,15 +46,13 @@ title: 安装扩展组件
 
 安装成功后，该扩展组件默认即被启用。
 
----
 
 ## 🧭 后续操作 & 使用
 
 - 在 KubeSphere 控制台的扩展中心中，查看已安装扩展列表  
 - 对已安装的扩展进行升级、配置或卸载  
 - 使用扩展组件提供的功能模块（访问 UI、管理 Agent、查看状态等）  
 
----
 
 ## 📘 延伸阅读
 

website/docs/extension-managerment/manage.md

@@ -15,7 +15,6 @@ title: 管理扩展组件
 - 配置集群 Agent
 - 禁用或启用扩展组件
 
----
 
 ## 🧩 配置扩展组件
 
@@ -44,7 +43,6 @@ title: 管理扩展组件
    - **复制（Copy）**：复制当前配置信息。
    - **下载（Download）**：下载当前配置文件。
 
----
 
 ## ⚙️ 配置集群 Agent
 
@@ -70,7 +68,6 @@ title: 管理扩展组件
    - **copy-light**：复制当前配置信息。
    - **download-new**：下载配置文件。
 
----
 
 ## 🚫 禁用扩展组件
 
@@ -90,7 +87,6 @@ title: 管理扩展组件
 4. 点击组件图标下的 **更多（More）**，选择 **禁用（Disable）**。
 5. 若需重新启用组件，再次点击 **更多（More）**，选择 **启用（Enable）**。
 
----
 
 ## 📘 延伸阅读
 

website/docs/extension-managerment/uninstall.md

@@ -13,14 +13,12 @@ title: 卸载扩展组件
 
 对于配置了集群 Agent 的扩展组件，卸载时会先卸载集群 Agent，再卸载组件。
 
----
 
 ## ⚠️ 前提条件
 
 - 您需要在 KubeSphere 平台中具有 **platform-admin** 角色。
   有关更多信息，请参阅 [用户和平台角色](https://docs.kubesphere.com.cn/v4.2.0/07-user-guide/02-platform-management/04-users-and-roles/)。
 
----
 
 ## 🛠 操作步骤
 
@@ -30,15 +28,13 @@ title: 卸载扩展组件
 4. 点击组件图标下的 **更多（More）**，选择 **卸载（Uninstall）**。
 5. 输入扩展组件的名称，点击 **确定（Confirm）** 开始卸载。
 
----
 
 ## ⚠️ 注意事项
 
 - 卸载操作不可撤销，请在确认不再使用该组件后再执行此操作。
 - 若组件依赖其他扩展或服务，请先评估其影响。
 - 对于配置了集群 Agent 的扩展组件，系统会自动清理相关资源，无需手动删除。
 
----
 
 ## 📘 延伸阅读
 

website/docs/extension-managerment/upgrade.md

@@ -13,7 +13,6 @@ title: 升级扩展组件
 
 当组件发布新版本后，您可以在扩展中心的组件详情页中执行升级操作。
 
----
 
 ## ⚠️ 注意事项
 
@@ -34,15 +33,13 @@ title: 升级扩展组件
 2. **推荐使用默认配置**，以自动获取与当前扩展版本匹配的镜像标签。
 3. 各扩展组件镜像标签的具体配置路径，请参阅 **扩展中心各组件详情页的升级说明**。
 
----
 
 ## 🧩 前提条件
 
 - 您需要在 KubeSphere 平台中具有 **platform-admin** 角色。  
   有关更多信息，请参阅 [用户和平台角色](https://docs.kubesphere.com.cn/v4.2.0/07-user-guide/02-platform-management/04-users-and-roles/)。
 - 目标组件已安装，且存在可用的新版本。
 
----
 
 ## ⚙️ 操作步骤
 
@@ -53,7 +50,6 @@ title: 升级扩展组件
 5. 在弹出的更新对话框中，根据提示完成升级步骤。
 6. 升级完成后，系统会自动同步至新的组件版本。
 
----
 
 ## 📘 延伸阅读
 

website/docs/quick-start.md

@@ -7,7 +7,6 @@ sidebar_position: 2
 本章节介绍如何在 **KubeSphere** 环境中快速部署 **AI Labs**。  
 你可以选择以下两种方式之一进行安装：
 
----
 
 ## 方式 1：使用 kubectl 部署（推荐）
 
@@ -30,7 +29,7 @@ kubectl get deploy -n kubesphere-system -l app=ai-labs-museum
 > 此方式适合快速安装与功能体验。
 > 系统会自动同步扩展，无需手动推送。
 
----
+
 
 ## 方式 2：手动推送扩展至 KubeSphere 扩展中心（开发者使用）
 
@@ -43,7 +42,7 @@ git clone https://github.com/frezes/ai-labs.git
 cd ai-labs
 ```
 
----
+
 
 ### ⚙️ 步骤 2：构建并发布扩展
 
@@ -60,7 +59,7 @@ ksbuilder publish extensions/{extension}/config/{extension}
 > * `{extension}` 请替换为实际扩展名称（如 `holmesgpt`、`open-webui`、`jupyterhub` 等）。
 > * 推送成功后，扩展将出现在 KubeSphere 控制台的 **扩展中心** 页面。
 
----
+
 
 ## 📘 接下来做什么
 

website/extensions/holmesgpt/_category_.json

@@ -0,0 +1,9 @@
+{
+  "label": "HolmesGPT",
+  "position": 2,
+  "link": {
+    "type": "generated-index"
+  },
+  "collapsible": true,
+  "collapsed": false
+}

website/extensions/holmesgpt/configuration.md

@@ -0,0 +1,44 @@
+---
+sidebar_position: 2
+title:  HolmesGPT 配置
+---
+
+# HolmesGPT 配置
+
+## 模型选择与接入
+
+HolmesGPT 支持多家 AI 提供商，让您可以灵活地选择最适合您需求和预算的模型。包括 Anthropic、AWS Bedrock、Azure OpenAI、Gemini、Google Vertex AI、Ollama、OpenAI、OpenAI-Compatible 等。
+
+当然，HolmesGPT 也进行了 Benchmark，以帮助您选择最合适的模型，更详细内容可参考 [HolmesGPT LLM Evaluation Benchmark Results](https://holmesgpt.dev/development/evaluations/latest-results/)。
+
+### Model Accuracy Comparison
+
+| Model                                               | Pass | Fail | Skip/Error | Total | Success Rate          |
+|-----------------------------------------------------|------|------|-------------|--------|------------------------|
+| gpt-4o                                              | 52   | 41   | 12          | 105    | 🟡 **56% (52/93)**     |
+| eu.anthropic.claude-sonnet-4-20250514-v1:0          | 82   | 13   | 10          | 105    | 🟡 **86% (82/95)**     |
+| gpt-4.1                                             | 67   | 27   | 11          | 105    | 🟡 **71% (67/94)**     |
+| gpt-5                                               | 74   | 20   | 11          | 105    | 🟡 **79% (74/94)**     |
+| deepseek/deepseek-v3.1-terminus                     | 75   | 20   | 10          | 105    | 🟡 **79% (75/95)**     |
+| qwen/qwen3-next-80b-a3b-instruct                    | 55   | 40   | 10          | 105    | 🟡 **58% (55/95)**     |
+
+### 模型配置接入
+
+你可以 [ai-providers](https://holmesgpt.dev/ai-providers/) 查看所有支持的 AI 提供商，并选择你需要的提供商进行配置。
+
+
+## 数据源配置
+
+HolmesGPT 连接到您的监控和可观察性工具，以提供全面的根本原因分析。您可以在 [data-sources](https://holmesgpt.dev/data-sources/) 查看所有支持的数据源，并进行配置。
+
+- 内置工具集
+
+  预先配置了 Prometheus、Grafana、DataDog 等流行工具的集成。
+
+- 自定义工具集
+
+  为专有或专用工具创建您自己的集成。
+
+- 远程 MCP 服务器
+
+  连接到模型上下文协议服务器以获得扩展功能。

website/extensions/holmesgpt/img/Interactive.png

@@ -1,5 +1,127 @@
 ---
 sidebar_position: 1
+title: HolmesGPT 介绍
 ---
 
-# Intro
+# HolmesGPT 介绍
+
+## HolmesGPT 是什么
+
+**HolmesGPT** 是一个面向云原生环境的智能故障排查助手（AI Agent for Troubleshooting Cloud-Native Environments）。  
+它基于大语言模型（LLM），通过交互式分析、自动化集成和多源数据联动，帮助用户快速定位和解决云原生系统中的问题。
+
+
+
+## 主要特性
+
+### 1. 交互式诊断（Interactive Mode）
+
+HolmesGPT 提供强大的对话式交互界面，支持用户以自然语言与 AI 进行多轮对话式排障。  
+它能够理解上下文，结合日志、事件、配置等信息，进行迭代式的故障分析与建议。
+
+### 2. CI/CD 流水线故障分析
+
+HolmesGPT 可集成到 CI/CD 流水线中，自动识别并分析部署失败的原因。  
+当部署失败时，系统会即时生成诊断结果，并可将分析报告推送到 **Slack** 等协作工具中，帮助开发团队快速响应。
+
+### 3. Prometheus 告警分析
+
+通过连接到 **AlertManager** 实例，HolmesGPT 能够对 Prometheus/AlertManager 的告警进行深入分析。  
+无论是全量告警还是特定告警，都可通过 HolmesGPT 发起智能调查，定位潜在问题根因。
+
+### 4. MCP 集成分析
+
+HolmesGPT 支持与 **MCP（Model Context Protocol）** 服务器集成，可结合 **MCP** 与 **自定义 tool_call** 进行智能化排查，帮助运维人员快速理解和解决集群异常。
+
+
+
+## 快速开始
+
+### 前提条件
+
+在开始之前，请确保：
+
+- 已部署可用的 **KubeSphere** 环境。
+- 已按照 [AI Labs 快速开始指南](https://frezes.github.io/ai-labs/docs/quick-start/) 安装完成 AI Labs 平台。
+
+
+
+### 安装 HolmesGPT 扩展
+
+1. 打开 **KubeSphere 扩展中心**。  
+2. 搜索 **HolmesGPT** 并进入详情页。  
+3. 点击 **安装**，根据提示完成安装流程。  
+
+#### 示例配置
+
+```yaml
+holmes:
+  logLevel: DEBUG
+  additionalEnvVars:
+    - name: CLUSTER_NAME
+      value: "host"
+    - name: DEEPSEEK_API_BASE
+      value: "https://openapi.coreshub.cn/v1"                # 请替换为您的 DeepSeek API Base
+    - name: DEEPSEEK_API_KEY
+      value: "sk-*******************"                        # 请替换为您的 DeepSeek API Key
+
+  customClusterRoleRules:
+    - apiGroups: ["monitoring.coreos.com"]
+      resources: ["servicemonitors", "podmonitors", "prometheusrules"]
+      verbs: ["get", "list"]
+    - apiGroups: [""]
+      resources: ["secrets", "pods", "services", "configmaps", "persistentvolumeclaims"]
+      verbs: ["get", "list", "watch"]
+    - apiGroups: [""]
+      resources: ["namespaces"]
+      verbs: ["get"]
+    - apiGroups: ["apps"]
+      resources: ["deployments", "statefulsets", "daemonsets"]
+      verbs: ["get", "list", "watch"]
+    - apiGroups: ["batch"]
+      resources: ["jobs", "cronjobs"]
+      verbs: ["get", "list", "watch"]
+    - apiGroups: ["networking.k8s.io"]
+      resources: ["ingresses"]
+      verbs: ["get", "list", "watch"]
+
+  toolsets:
+    kubernetes/core:
+      enabled: true
+    kubernetes/logs:
+      enabled: true
+    kubernetes/prometheus_stack:
+      description: This toolset fetches Prometheus target definitions. Requires specific cluster role rules.
+      enabled: true
+    helm/core:
+      enabled: true
+    robusta:
+      enabled: false
+    internet:
+      enabled: true
+    prometheus/metrics:
+      enabled: true
+      config:
+        prometheus_url: "http://prometheus-k8s.kubesphere-monitoring-system.svc:9090"
+
+  modelList:
+    deepseek:
+      api_key: "{{ env.DEEPSEEK_API_KEY }}"
+      model: deepseek/DeepSeek-V3.1-Terminus               # 请替换为您的 DeepSeek 模型
+      temperature: 0
+```
+
+安装完成后，HolmesGPT 将出现在扩展组件列表中，可直接进入交互模式进行使用。
+
+> 💡 **提示：**  
+> 模型原则上支持多种，可查看[配置部分](./configuration.md)了解详情。国内推建使用 **DeepSeek-V3.1-Terminus** 模型。  
+> 可使用基石智算的产品，[注册](https://www.coreshub.cn/) 即送算力券，参考如下方式[获取 API Key](https://docs.coreshub.cn/console/big_model_server/api_key/create_api_key)，使用 **DeepSeek-V3.1-Terminus** 模型。
+
+
+
+## 下一步
+
+* [使用 HolmesGPT 进行交互式排障](./playground.md)
+* [配置 HolmesGPT](./configuration.md)
+* [更多关于 HolmesGPT 的信息](https://holmesgpt.dev/)
+