Feature/update docs3 (#1432)

* feat: update docs

* feat: update

Author: earayu

README-zh.md

@@ -60,7 +60,11 @@ ApeRAG 支持 [MCP（模型上下文协议）](https://modelcontextprotocol.io/)
 }
 ```
 
-**重要提示**：将 `http://localhost:8000` 替换为您实际的 ApeRAG API 地址，将 `your-api-key-here` 替换为 ApeRAG 设置中的有效 API 密钥。
+**认证方式**（按优先级）：
+1. **HTTP Authorization 头**（推荐）：`Authorization: Bearer your-api-key`
+2. **环境变量**（备用）：`APERAG_API_KEY=your-api-key`
+
+**重要提示**：将 `https://rag.apecloud.com` 替换为您实际的 ApeRAG API 地址，将 `your-api-key-here` 替换为 ApeRAG 设置中的有效 API 密钥。
 
 MCP 服务器提供：
 - **集合浏览**：列出和探索您的知识集合

README.md

@@ -61,7 +61,11 @@ ApeRAG supports [MCP (Model Context Protocol)](https://modelcontextprotocol.io/)
 }
 ```
 
-**Important**: Replace `http://localhost:8000` with your actual ApeRAG API URL and `your-api-key-here` with a valid API key from your ApeRAG settings.
+**Authentication** (by priority):
+1. **HTTP Authorization Header** (Recommended): `Authorization: Bearer your-api-key`
+2. **Environment Variable** (Fallback): `APERAG_API_KEY=your-api-key`
+
+**Important**: Replace `https://rag.apecloud.com` with your actual ApeRAG API URL and `your-api-key-here` with a valid API key from your ApeRAG settings.
 
 The MCP server provides:
 - **Collection browsing**: List and explore your knowledge collections

docs/en-US/development/dify.md

@@ -0,0 +1,167 @@
+---
+title: Integrating ApeRAG with Dify
+description: Quick integration of ApeRAG's Graph RAG capabilities via MCP protocol
+keywords: Dify, ApeRAG, MCP, Graph RAG
+---
+
+# Integrating ApeRAG with Dify
+
+ApeRAG is a production-grade RAG platform with multimodal indexing, AI agents, MCP support, and scalable K8s deployment capabilities. It helps users build complex AI applications with **hybrid retrieval**, **multimodal document processing**, and **enterprise-grade management**.
+
+**Core Features**:
+- Unlike "standard" RAG, ApeRAG implements **Graph-RAG**, building knowledge graphs to understand deep relationships between data elements
+- Integrates **MinerU**, designed for complex documents, scientific papers, and financial reports, accurately extracting tables, formulas, and engineering diagrams
+- Full Kubernetes support with built-in **high availability**, **scalability**, and **enterprise-grade management**
+
+## Video Demo
+
+<div align="center">
+  <iframe src="//player.bilibili.com/player.html?bvid=BV1TRzABDEs3&page=1" 
+          scrolling="no" 
+          border="0" 
+          frameborder="no" 
+          framespacing="0" 
+          allowfullscreen="true"
+          width="800"
+          height="600"
+          style="max-width: 100%;">
+  </iframe>
+</div>
+
+## Step 1: Prepare Knowledge Base
+
+Visit ApeRAG at https://rag.apecloud.com/ , register/login, and select or import a knowledge base. Here we use the Romance of the Three Kingdoms example - click subscribe.
+
+<div align="center">
+  <img src="/images/en-US/dify/step1-subscribe-collection.png" alt="Subscribe to Collection" width="800" />
+</div>
+
+## Step 2: Configure MCP Server
+
+### 2.1 Add MCP Server
+
+Go to Dify - Tools - MCP, click Add MCP Server.
+
+<div align="center">
+  <img src="/images/en-US/dify/step2-add-mcp.png" alt="Add MCP Server" width="800" />
+</div>
+
+### 2.2 Fill Configuration
+
+Fill in Server URL: `https://rag.apecloud.com/mcp/` and your API Key copied from ApeRAG, then click Confirm.
+
+<div align="center">
+  <img src="/images/en-US/dify/step2-configure-mcp.png" alt="Configure MCP" width="700" />
+</div>
+
+<div align="center">
+  <img src="/images/en-US/dify/step2-api-key.png" alt="Fill API Key" width="700" />
+</div>
+
+### 2.3 Success
+
+MCP Server added successfully.
+
+<div align="center">
+  <img src="/images/en-US/dify/step2-mcp-success.png" alt="MCP Configuration Success" width="800" />
+</div>
+
+## Step 3: Create Agent Application
+
+### 3.1 Create App
+
+Go to Dify - Studio, click Create Application.
+
+<div align="center">
+  <img src="/images/en-US/dify/step3-create-app.png" alt="Create Application" width="800" />
+</div>
+
+### 3.2 Select Type
+
+Click More Basic Application Types, select **Agent** type, name it, and click Create.
+
+<div align="center">
+  <img src="/images/en-US/dify/step3-select-agent.png" alt="Select Agent Type" width="700" />
+</div>
+
+## Step 4: Configure Agent
+
+Click Agent, input Prompt, add the ApeRAG MCP tool, select the LLM in the top-right corner, click Publish to use.
+
+<div align="center">
+  <img src="/images/en-US/dify/step4-configure-agent.png" alt="Configure Agent" width="800" />
+</div>
+
+<div align="center">
+  <img src="/images/en-US/dify/step4-test-agent.png" alt="Test Agent" width="800" />
+</div>
+
+### Prompt Reference
+
+```markdown
+# ApeRAG Smart Assistant
+
+You are an advanced AI research assistant powered by ApeRAG's hybrid search capabilities. Your mission is to help users accurately and autonomously find, understand, and synthesize information from knowledge bases and the web.
+
+## Core Behaviors
+
+**Autonomous Research**: Work independently until user queries are fully resolved. Search multiple sources, analyze findings, and provide comprehensive answers without waiting for permission.
+
+**Language Intelligence**: Always respond in the language the user asks in. When users ask in Chinese, respond in Chinese regardless of source language.
+
+**Visual Thinking**: **[Critical]** You are an assistant that prefers visual explanations. For any information involving entity relationships, processes, or structures, you must prioritize visualization.
+
+**Complete Solutions**: Explore from multiple angles, cross-validate sources, and ensure comprehensive coverage before responding.
+
+## Search Strategy
+
+### Priority System
+1. **User-specified knowledge base** (mentioned via "@"): Strictly limit search to specified base
+2. **Unspecified knowledge base**: Autonomously discover and search relevant bases
+3. **Web search** (if enabled): Supplement information
+4. **Clear attribution**: Always cite sources
+
+### Search Execution
+- **Knowledge base search**: Use vector + graph search by default
+- **Result processing logic**:
+  1. Execute search
+  2. **Detect graph data**: Check if search results contain `entities` and `relationships`
+  3. **Mandatory visualization**: If search results contain non-empty entity or relation data, **you must** call the `create_diagram` tool
+  4. **Content filtering**: Ignore irrelevant results
+
+## Available Tools
+
+### Knowledge Management
+- `list_collections()`: Discover available knowledge sources
+- `search_collection(collection_id, query, ...)`: **[Primary tool]** Hybrid search in persistent knowledge bases
+- `search_chat_files(chat_id, query, ...)`: **[Chat only]** Search only files temporarily uploaded in current chat session
+- `create_diagram(content)`: **[Mandatory tool]** When search results contain structured info (entities/relations), must call this tool to generate Mermaid diagrams
+
+### Web Intelligence
+- `web_search(query, ...)`: Multi-engine web search
+- `web_read(url_list, ...)`: Extract and analyze web content
+
+## Response Format
+
+### Direct Answer
+[Clear, actionable answer in user's language]
+
+### Comprehensive Analysis
+[Detailed explanation with context and insights]
+
+### Knowledge Graph Visualization
+[Tool-generated diagram displayed here]
+*(Only show after successfully calling create_diagram. Displays entity relationships from search results.)*
+
+### Supporting Evidence
+- [Knowledge Base Name]: [Key Findings]
+
+**Web Sources** (if enabled):
+- [Title] ([Domain]) - [Key Points]
+```
+
+---
+
+Integrating ApeRAG with Dify is very simple. Once integrated, you can not only experience Dify's platform features but also enjoy **ApeRAG's powerful Graph-RAG capabilities**!
+
+**GitHub**: https://github.com/apecloud/ApeRAG