📝 Update more documentations (phase 4)

Author: Phinease

doc/docs/.vitepress/config.mts

@@ -32,13 +32,14 @@ export default defineConfig({
               { text: 'Key Features', link: '/en/getting-started/features' },
               { text: 'Software Architecture', link: '/en/getting-started/software-architecture' },
               { text: 'Development Guide', link: '/en/getting-started/development-guide' },
-              { text: 'FAQ', link: '/en/faq' }
+              { text: 'FAQ', link: '/en/getting-started/faq' }
             ]
           },
           {
             text: 'SDK Documentation',
             items: [
               { text: 'SDK Overview', link: '/en/sdk/overview' },
+              { text: 'Basic Usage', link: '/en/sdk/basic-usage' },
               { 
                 text: 'Core Modules',
                 items: [
@@ -134,13 +135,14 @@ export default defineConfig({
               { text: '核心特性', link: '/zh/getting-started/features' },
               { text: '软件架构', link: '/zh/getting-started/software-architecture' },
               { text: '开发指南', link: '/zh/getting-started/development-guide' },
-              { text: '常见问题', link: '/zh/faq' }
+              { text: '常见问题', link: '/zh/getting-started/faq' }
             ]
           },
           {
             text: 'SDK 文档',
             items: [
               { text: 'SDK 概览', link: '/zh/sdk/overview' },
+              { text: '基本使用', link: '/zh/sdk/basic-usage' },
               { 
                 text: '核心模块',
                 items: [

doc/docs/en/getting-started/development-guide.md

@@ -1,10 +1,8 @@
 # Nexent Development Guide
 
-## Project Overview
+This guide provides comprehensive information for developers to understand and contribute to the Nexent project, covering architecture, technology stack, development environment setup, and best practices.
 
-Nexent is an AI agent-based intelligent conversation system with a frontend-backend separation architecture, supporting enterprise-level features like multi-tenancy, multi-language, and streaming responses.
-
-## Overall Architecture
+## 🏗️ Overall Architecture
 
 ```
 nexent/
@@ -17,29 +15,7 @@ nexent/
 └── assets/           # Static resources
 ```
 
-## Architecture Module Overview
-
-### 🎨 Frontend Development
-- **Tech Stack**: Next.js 14 + TypeScript + React + Tailwind CSS
-- **Core Features**: User interface, real-time chat, configuration management, internationalization
-- **Details**: See [Frontend Overview](../frontend/overview.md)
-
-### 🔧 Backend Development
-- **Tech Stack**: FastAPI + Python 3.10+ + PostgreSQL + Redis + Elasticsearch
-- **Core Features**: API services, agent management, data processing, vector search
-- **Details**: See [Backend Overview](../backend/overview.md)
-
-### 🤖 AI Agents
-- **Framework**: Enterprise agent framework based on smolagents
-- **Core Features**: Agent creation, tool integration, reasoning execution, multi-modal support
-- **Details**: See [Agent Overview](../agents/overview.md)
-
-### 📦 SDK Development Kit
-- **Features**: Complete interfaces for AI agents, model calling, tool integration
-- **Modules**: Core agents, data processing, vector database
-- **Details**: See [SDK Overview](../sdk/overview.md)
-
-## Technology Stack
+## 🛠️ Technology Stack
 
 ### Frontend Tech Stack
 - **Framework**: Next.js 14 (App Router)
@@ -64,59 +40,78 @@ nexent/
 - **Monitoring**: Built-in health checks
 - **Logging**: Structured logging
 
-## Development Environment Setup 🚀
+## 🚀 Development Environment Setup
 
-### 1. Environment Requirements
+### Environment Requirements
 - Python 3.10+
 - Node.js 18+
 - Docker & Docker Compose
 - uv (Python package manager)
 
-### 2. Backend Setup
+### Backend Setup
 ```bash
 cd backend
 uv sync && uv pip install -e ../sdk
 ```
 
-### 3. Frontend Setup
+### Frontend Setup
 ```bash
 cd frontend
 npm install
 npm run dev
 ```
 
-### 4. Service Startup
+### Service Startup
 Nexent includes three core backend services that need to be started separately:
 ```bash
 python backend/data_process_service.py   # Data processing service
 python backend/main_service.py           # Main service
 python backend/nexent_mcp_service.py     # MCP service
 ```
 
-## Development Module Guide
+## 🔧 Development Module Guide
+
+### 🎨 Frontend Development
+- **Tech Stack**: Next.js 14 + TypeScript + React + Tailwind CSS
+- **Core Features**: User interface, real-time chat, configuration management, internationalization
+- **Details**: See [Frontend Overview](../frontend/overview.md)
+
+### 🔧 Backend Development
+- **Tech Stack**: FastAPI + Python 3.10+ + PostgreSQL + Redis + Elasticsearch
+- **Core Features**: API services, agent management, data processing, vector search
+- **Details**: See [Backend Overview](../backend/overview.md)
 
-### Agent Development 🤖
+### 🤖 AI Agent Development
+- **Framework**: Enterprise agent framework based on smolagents
+- **Core Features**: Agent creation, tool integration, reasoning execution, multi-modal support
 - **Custom Agents**: See [Agent Overview](../agents/overview.md)
 - **System Prompts**: Located in `backend/prompts/`
 - **Implementation Steps**: Create instance → Configure tools → Set prompts → Test run
+- **Details**: See [Agent Overview](../agents/overview.md)
 
-### Tool Development 🛠️
+### 🛠️ Tool Development
 - **MCP Tool System**: Based on Model Context Protocol
 - **Development Flow**: Implement logic → Register tool → Restart service
+- **Protocol Compliance**: Tool development must follow MCP protocol
 - **Detailed Specification**: See [Tool Development Guide](../sdk/core/tools.md)
 
-### Data Processing 📊
+### 📦 SDK Development Kit
+- **Features**: Complete interfaces for AI agents, model calling, tool integration
+- **Modules**: Core agents, data processing, vector database
+- **Details**: See [SDK Overview](../sdk/overview.md)
+
+### 📊 Data Processing
 - **File Processing**: Supports 20+ formats
 - **Chunking Strategies**: basic, by_title, none
 - **Streaming Processing**: Memory optimization for large files
 - **Details**: See [Data Processing Guide](../sdk/data-process.md)
 
-## Build & Deployment 🏗️
+## 🏗️ Build & Deployment
 
 ### Docker Build
 For detailed build instructions, see [Docker Build Guide](../deployment/docker-build.md)
 
-## Development Best Practices
+## 📋 Development Best Practices & Important Notes
 
 ### Code Quality
 1. **Test-Driven**: Write unit tests and integration tests
@@ -136,15 +131,13 @@ For detailed build instructions, see [Docker Build Guide](../deployment/docker-b
 3. **Sensitive Information**: Properly handle sensitive data like API keys
 4. **Security Updates**: Regular dependency and security updates
 
-## Important Notes ⚠️
-
+### Important Development Notes
 1. **Service Dependencies**: Ensure all services are started before testing
 2. **Code Changes**: Restart related services after code modifications
 3. **Development Mode**: Use debug mode in development environment
-4. **Protocol Compliance**: Tool development must follow MCP protocol
-5. **Prompt Testing**: System prompts need thorough testing
+4. **Prompt Testing**: System prompts need thorough testing
 
-## Getting Help 💬
+## 💡 Getting Help
 
 ### Documentation Resources
 - [Installation Guide](./installation.md) - Environment setup and deployment

doc/docs/en/faq.md doc/docs/en/getting-started/faq.mddoc/docs/en/faq.md renamed to doc/docs/en/getting-started/faq.md

@@ -1,10 +1,10 @@
 # Nexent FAQ
 
-This FAQ addresses common questions and issues you might encounter while installing and deploying Nexent. For the basic installation steps, please refer to the [Quick Start Guide](./getting-started/overview#quick-start) in our documentation.
+This FAQ addresses common questions and issues you might encounter while installing and deploying Nexent. For the basic installation steps, please refer to the [Quick Start Guide](./overview#quick-start) in our documentation.
 
 ## 🚀 Installation & Setup
 
-For model provider setup and API key acquisition, see our detailed **[Model Providers Guide](./getting-started/model-providers)**.
+For model provider setup and API key acquisition, see our detailed **[Model Providers Guide](./model-providers)**.
 
 ## 🚫 Common Errors & Operations
 
@@ -49,7 +49,7 @@ For model provider setup and API key acquisition, see our detailed **[Model Prov
     3. **Model name**: Confirm the model identifier is correct
     4. **Network access**: Ensure your deployment can reach the provider's servers
 
-    For specific provider setup, see our [Model Providers Guide](./getting-started/model-providers).
+    For specific provider setup, see our [Model Providers Guide](./model-providers).
 
 ### 📧 Email Tools Configuration
 - **Q: How can I enable and configure email tools?**
@@ -59,9 +59,9 @@ For model provider setup and API key acquisition, see our detailed **[Model Prov
     3. Switch to the email-enabled system prompt by using `code_agent_with_email.yaml`
     4. Restart the MCP service to apply changes
 
-## ❓ Still Need Help?
+## 💡 Need Help
 
 If your question isn't answered here:
 - Join our [Discord community](https://discord.gg/tb5H3S3wyv) for real-time support
 - Check our [GitHub Issues](https://github.com/ModelEngine-Group/nexent/issues) for similar problems
-- Refer to our [Contribution Guide](contributing) for more detailed information
+- Refer to our [Contribution Guide](../contributing) for more detailed information 

doc/docs/en/getting-started/features.md

@@ -46,11 +46,23 @@ Drop in or build Python plug-ins that follow the MCP spec; swap models, tools, a
 
 ## 🏗️ Architecture Benefits
 
-- **Zero-Code Development**: Build sophisticated agents using natural language
-- **Scalable Processing**: Handle everything from single files to enterprise-scale batch operations
-- **Rich Integration**: Connect with multiple AI models, databases, and external services
-- **Extensible Design**: Add new capabilities through the MCP ecosystem
-- **Enterprise Ready**: Built for production environments with proper scaling and monitoring
+### ⚡ Distributed Processing Capabilities
+- **Asynchronous Architecture**: High-performance asynchronous processing based on asyncio
+- **Multi-threading Safety**: Thread-safe concurrent processing mechanisms
+- **Celery Integration**: Optimized for distributed task queues
+- **Batch Optimization**: Intelligent batch operations to reduce network overhead
+
+### 🏢 Enterprise-grade Scalability
+- **Modular Design**: Loose-coupled module architecture for easy extension
+- **Plugin-based Tools**: Standardized tool interfaces for rapid integration
+- **Configuration Management**: Flexible configuration system supporting multi-environment deployment
+- **Monitoring Friendly**: Comprehensive logging and status monitoring
+
+### 🚀 High-performance Optimization
+- **Connection Pooling**: Intelligent reuse of database and HTTP connections
+- **Memory Management**: Stream processing of large files and memory optimization
+- **Concurrency Control**: Intelligent concurrency limiting and load balancing
+- **Caching Strategy**: Multi-layer caching to improve response speed
 
 For detailed information about Nexent's software architecture and technical advantages, see our **[Software Architecture](./software-architecture)** guide.