Upload README.md

README.md

@@ -1,3 +1,4 @@
+---
 title: BigData Ops Copilot 
 emoji: 🐠 
 colorFrom: blue 
@@ -7,7 +8,7 @@ sdk_version: 6.3.0
 app_file: app.py 
 pinned: false 
 license: apache-2.0 
-
+---
 # 🚀 BigData Ops Copilot (Lightweight) 
 
 这是经过优化的轻量化版本，旨在解决 Hugging Face 免费 CPU 算力下编译缓慢的问题。 
@@ -16,3 +17,45 @@ license: apache-2.0
 - **Endpoint**: ` `https://coco1990-bigdata-ops-copilot.hf.space/v1` ` 
 - **API Key**: 使用你的 HF Access Token 
 - **Model Name**: `qwen2.5-coder-7b` 
+
+
+# 🚀 BigData Ops Copilot (Qwen2.5-Coder-7B)
+
+这是一个专为**大数据运维（Big Data O&M）**场景打造的轻量级 AI 助手。基于阿里开源的 `Qwen2.5-Coder-7B-Instruct-GGUF` 模型，通过 Hugging Face Spaces 免费算力实现零成本部署。
+
+## 🌟 核心能力
+- **组件诊断**：涵盖 Hadoop, Spark, Flink, Kafka, Hive, HBase 等主流大数据组件。
+- **性能调优**：提供 Spark 内存调优、Hive 倾斜优化、ClickHouse 查询加速建议。
+- **运维脚本**：自动生成 Shell、Python、SQL 等运维脚本及监控逻辑。
+- **日志分析**：粘贴 Error Stacktrace，快速定位 OOM、超时、权限等常见故障。
+
+## 🛠 部署架构
+- **模型格式**：GGUF (Q4_K_M 量化版本)。
+- **后端框架**：llama-cpp-python + FastAPI。
+- **前端界面**：Gradio。
+- **硬件环境**：Hugging Face CPU Basic (2 vCPU / 16GB RAM)。
+
+---
+
+## 🔌 Dify 接入指南 (API Mode)
+
+本 Space 已经过优化，支持 OpenAI 兼容接口，可无缝对接 Dify 等大模型应用开发平台。
+
+### 1. 获取 API 信息
+- **API Endpoint**: `https://coco1990-bigdata-ops-copilot.hf.space/v1`
+- **API Key**: 你的 Hugging Face Access Token（请勿泄露）
+- **模型名称**: `qwen2.5-coder-7b`
+
+### 2. Dify 配置步骤
+1. 进入 Dify **设置 -> 模型供应商**。
+2. 添加 **OpenAI-API-compatible** 类型供应商。
+3. 填入上述 Endpoint 和 Key 即可完成连接。
+
+> **⚠️ 注意事项**：
+> - **自动休眠**：免费版 Space 在长时间无人访问后会进入休眠状态。若 Dify 调用失败，请手动访问本页面唤醒。
+> - **推理速度**：由于运行在 CPU 环境，首字响应可能存在 5-10 秒延迟，请在 Dify 中适当调大超时时间。
+
+---
+
+## 📜 免责声明
+本模型提供的建议仅供参考，在生产环境执行任何脚本或配置更改前，请务必在测试环境验证。