-**Language / 语言**
-| [🇨🇳 中文](README.md) | [🇺🇸 English](docs/readme_en.md) |
-|---------|---------|
+**🌐 Language / 语言切换**
+
+[](README.md)
+[](docs/readme_en.md)
+
+---
+
+[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/stargazers)
+[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/network)
+[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/issues)
+[](LICENSE)
+[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/commits)
+
+**🔥 为ComfyUI工作流程注入强大的大语言模型力量!**
+
+*一个专业级的ComfyUI自定义节点套件,支持全球领先的大语言模型*
-**为ComfyUI工作流程注入强大的大语言模型力量!**
-
-[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/stargazers)
-[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/network)
-[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/blob/main/LICENSE)
-
-> 一个集成全球领先大语言模型的ComfyUI自定义节点套件
+---
## 📖 项目简介
-ComfyUI-LLMs-Toolkit 专为ComfyUI设计,将DeepSeek、通义千问、GPT等优秀的大语言模型无缝集成到您的AI工作流程中。
+ComfyUI-LLMs-Toolkit 是一个高性能的ComfyUI扩展,专为AI创作者设计。通过轻量级API驱动方案,即使在有限计算资源下也能轻松接入DeepSeek、通义千问、GPT等世界级大语言模型,让AI创作民主化。
+
+### 🎯 为什么选择我们?
+
+- **🚀 零硬件门槛**:无需高端GPU,仅需API即可享受前沿AI能力
+- **🌍 全球模型支持**:集成中外主流LLM,一站式解决方案
+- **⚡ 高性能架构**:优化的并发处理,大幅提升工作流效率
+- **🛠️ 极客友好**:环境变量配置,Docker支持,开发者至上
+
+---
+
+## ✨ 核心特性
+
+### 🧠 强大的LLM生态系统
+
+| 类别 | 支持模型 | 特色能力 |
+|------|----------|----------|
+| **🇨🇳 中国领军** | DeepSeek-V3, Qwen-Max, GLM-4 | 中文理解、代码生成、数学推理 |
+| **🇺🇸 国际巨头** | GPT-4, Claude-3, Gemini | 多模态处理、创意写作、复杂推理 |
+| **⚡ 专业垂直** | Doubao, Spark, Moonshot | 对话生成、长文本、角色扮演 |
+
+### 🔧 技术亮点
+
+- **✨ 闪电部署**:一键安装,五分钟上手
+- **⚡ 并发优化**:多线程处理,支持批量请求
+- **🛡️ 安全为先**:环境变量配置,密钥安全管理
+- **🔄 热重载**:动态配置更新,无需重启ComfyUI
+- **📊 智能缓存**:响应缓存机制,降低API调用成本
+- **🐳 容器化**:Docker支持,一致性部署环境
+
+---
## 🚀 快速开始
-### 📋 安装步骤
+### 📋 系统要求
-```bash
-# 1. 克隆项目到ComfyUI的custom_nodes目录
+- **Python**: \`>= 3.8\`
+- **ComfyUI**: 最新版本
+- **内存**: \`>= 4GB RAM\`
+- **网络**: 稳定的互联网连接
+
+### ⚡ 闪电安装
+
+\`\`\`bash
+# 🎯 方式一:Git克隆(推荐)
cd ComfyUI/custom_nodes/
git clone https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit.git
-
-# 2. 进入项目目录
cd ComfyUI-LLMs-Toolkit
-# 3. 安装依赖
+# 📦 安装依赖
pip install -r requirements.txt
-```
+\`\`\`
+
+\`\`\`bash
+# 🐳 方式二:Docker部署
+docker pull your-dockerhub/comfyui-llms-toolkit:latest
+docker run -d --name comfyui-llms -p 8188:8188 your-dockerhub/comfyui-llms-toolkit
+\`\`\`
### ⚙️ 环境配置
-#### 1. 创建环境变量文件
+#### 1️⃣ 创建配置文件
-```bash
-# 复制环境变量示例文件
+\`\`\`bash
+# 复制环境变量模板
cp config/env.example .env
-```
+\`\`\`
-#### 2. 配置API密钥
+#### 2️⃣ 配置API密钥
-编辑 `.env` 文件,填入您的API配置:
+编辑 \`.env\` 文件,选择您要使用的模型:
-```bash
-# DeepSeek配置(必填其中之一)
-DEEPSEEK_API_KEY=your_deepseek_api_key_here
+\`\`\`bash
+# 🔥 DeepSeek(推荐新手)
+DEEPSEEK_API_KEY=sk-your_deepseek_key_here
DEEPSEEK_BASE_URL=https://api.deepseek.com
DEEPSEEK_MODEL_NAME=deepseek-chat
-# 通义千问配置
-QWEN_API_KEY=your_qwen_api_key_here
-QWEN_BASE_URL=https://dashscope.aliyun.com/api/v1
+# 🌟 通义千问(中文优化)
+QWEN_API_KEY=your_qwen_key_here
+QWEN_BASE_URL=https://dashscope.aliyuncs.com/api/v1
QWEN_MODEL_NAME=qwen-max
-# OpenAI配置
-OPENAI_API_KEY=your_openai_api_key_here
+# 🤖 OpenAI GPT(国际标准)
+OPENAI_API_KEY=sk-your_openai_key_here
OPENAI_BASE_URL=https://api.openai.com/v1
-OPENAI_MODEL_NAME=gpt-3.5-turbo
+OPENAI_MODEL_NAME=gpt-4o-mini
-# 更多模型配置请参考 config/env.example
-```
+# 🚀 更多配置参见 config/env.example
+\`\`\`
-#### 3. 获取API密钥
+#### 3️⃣ API密钥获取指南
-| 模型提供商 | 获取地址 | 说明 |
-|-----------|---------|------|
-| 🔥 **DeepSeek** | [platform.deepseek.com](https://platform.deepseek.com/) | 新用户有免费额度 |
-| 🌟 **通义千问** | [dashscope.aliyun.com](https://dashscope.aliyun.com/) | 阿里云账号登录 |
-| 🤖 **OpenAI** | [platform.openai.com](https://platform.openai.com/) | GPT系列模型 |
-| 🚀 **豆包** | [console.volcengine.com](https://console.volcengine.com/) | 字节跳动产品 |
-| ⚡ **星火** | [console.xfyun.cn](https://console.xfyun.cn/) | 科大讯飞产品 |
-| 🧠 **智谱清言** | [open.bigmodel.cn](https://open.bigmodel.cn/) | 清华技术 |
-| 🌙 **月之暗面** | [platform.moonshot.cn](https://platform.moonshot.cn/) | Kimi Chat团队 |
+| 🏢 提供商 | 🔗 获取地址 | 💰 免费额度 | ⭐ 推荐指数 |
+|-----------|-------------|-------------|-------------|
+| **DeepSeek** | [platform.deepseek.com](https://platform.deepseek.com/) | ¥500免费额度 | ⭐⭐⭐⭐⭐ |
+| **通义千问** | [dashscope.aliyun.com](https://dashscope.aliyun.com/) | 每月100万tokens | ⭐⭐⭐⭐ |
+| **OpenAI** | [platform.openai.com](https://platform.openai.com/) | $5体验额度 | ⭐⭐⭐⭐⭐ |
+| **智谱清言** | [open.bigmodel.cn](https://open.bigmodel.cn/) | 每月500万tokens | ⭐⭐⭐⭐ |
-### 🎯 基础使用
+### 🎯 第一次运行
-1. **重启ComfyUI** - 配置完成后重启ComfyUI以加载节点
-2. **添加节点** - 在节点菜单中找到 \`LLMs Toolkit\` 分类
-3. **配置模型** - 选择要使用的LLM模型和参数
-4. **开始创作** - 连接工作流开始您的AI创作之旅
+1. **🔄 重启ComfyUI**:
+ \`\`\`bash
+ # 重启ComfyUI以加载新节点
+ cd /path/to/ComfyUI
+ python main.py
+ \`\`\`
-## 📄 许可证
+2. **🔍 查找节点**:
+ - 在ComfyUI界面中右键
+ - 导航至 \`Add Node\` → \`LLMs Toolkit\`
+ - 选择您需要的节点类型
-本项目采用 [GPL-2.0](LICENSE) 开源协议。
+3. **⚡ 开始创作**:
+ - 拖入LLM节点
+ - 配置模型参数
+ - 连接输入输出
+ - 享受AI创作之旅!
+
+---
+
+## 🌟 支持的模型矩阵
+
+### 🇨🇳 中国AI军团
+
+| 模型 | 提供商 | 核心优势 | 价格等级 | 配置前缀 |
+|------|--------|----------|----------|----------|
+| **DeepSeek-V3** | DeepSeek | 🧮 数学推理、💻 代码生成 | 💚 超低价 | \`DEEPSEEK_\` |
+| **Qwen-Max** | 阿里巴巴 | 🌏 多模态、🇨🇳 中文优化 | 💛 中等 | \`QWEN_\` |
+| **GLM-4** | 智谱AI | 🤔 逻辑推理、📚 知识问答 | 💚 低价 | \`GLM_\` |
+| **Doubao-Pro** | 字节跳动 | 💬 对话生成、✍️ 创意写作 | 💛 中等 | \`DOUBAO_\` |
+| **Spark-Max** | 科大讯飞 | 🗣️ 语言理解、📊 文本分析 | 💚 低价 | \`SPARK_\` |
+| **Moonshot-V1** | 月之暗面 | 📖 长文本、🧠 深度理解 | 💛 中等 | \`MOONSHOT_\` |
+
+### 🌍 国际AI豪门
+
+| 模型 | 提供商 | 核心优势 | 价格等级 | 配置前缀 |
+|------|--------|----------|----------|----------|
+| **GPT-4o** | OpenAI | 🧠 通用智能、🎨 多模态 | 🧡 高价 | \`OPENAI_\` |
+| **Claude-3.5** | Anthropic | 🛡️ 安全对话、📚 长文本 | 🧡 高价 | \`CLAUDE_\` |
+| **Gemini-Pro** | Google | 🔍 搜索增强、🌐 多语言 | 💛 中等 | \`GEMINI_\` |
+
+---
+
+## ❓ 常见问题
+
+
+
+---
+
+## 📄 开源协议
+
+本项目采用 **[GNU General Public License v2.0](LICENSE)** 开源协议。
+
+**这意味着:**
+- ✅ **自由使用**:个人和商业使用均可
+- ✅ **自由修改**:可以修改源代码
+- ✅ **自由分发**:可以分发原版或修改版
+- ⚠️ **开源义务**:修改版必须开源
---
-**⭐ 如果这个项目对您有帮助,请给我们一个Star!**
+### 🌟 如果这个项目对您有帮助,请给我们一个Star!
[](https://star-history.com/#HuangYuChuh/ComfyUI-LLMs-Toolkit&Date)
+**📞 联系我们**
+
+[](https://github.com/HuangYuChuh)
+[](mailto:your-email@example.com)
+
+---
+
+**💡 Made with ❤️ for the ComfyUI community**
+
+*让AI创作更简单,让技术更有温度*
+
diff --git a/docs/readme_en.md b/docs/readme_en.md
index 8ea54f3..9e30daa 100644
--- a/docs/readme_en.md
+++ b/docs/readme_en.md
@@ -1,109 +1,237 @@
# 🚀 ComfyUI-LLMs-Toolkit
-
+
-**Language / 语言**
-| [🇨🇳 中文](../README.md) | [🇺🇸 English](readme_en.md) |
-|---------|---------|
+**🌐 Language / 语言切换**
+
+[](readme_en.md)
+[](../README.md)
+
+---
+
+[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/stargazers)
+[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/network)
+[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/issues)
+[](../LICENSE)
+[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/commits)
+
+**🔥 Inject powerful Large Language Models into your ComfyUI workflows!**
+
+*A professional-grade ComfyUI custom node suite supporting world-leading Large Language Models*
-**Inject powerful Large Language Models into your ComfyUI workflows!**
-
-[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/stargazers)
-[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/network)
-[](https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit/blob/main/LICENSE)
-
-> A ComfyUI custom node suite integrating leading Large Language Models worldwide
+---
## 📖 Project Overview
-ComfyUI-LLMs-Toolkit is designed specifically for ComfyUI, seamlessly integrating excellent Large Language Models such as DeepSeek, Qwen, GPT, and others into your AI workflows.
+ComfyUI-LLMs-Toolkit is a high-performance ComfyUI extension designed for AI creators. Through a lightweight API-driven approach, you can easily integrate world-class Large Language Models like DeepSeek, Qwen, GPT, etc., even with limited computational resources, democratizing AI creation.
+
+### 🎯 Why Choose Us?
+
+- **🚀 Zero Hardware Barrier**: No high-end GPU required, enjoy cutting-edge AI capabilities with just APIs
+- **🌍 Global Model Support**: Integrated mainstream LLMs worldwide, one-stop solution
+- **⚡ High-Performance Architecture**: Optimized concurrent processing, dramatically improving workflow efficiency
+- **🛠️ Developer Friendly**: Environment variable configuration, Docker support, developer-first approach
+
+---
+
+## ✨ Core Features
+
+### 🧠 Powerful LLM Ecosystem
+
+| Category | Supported Models | Key Capabilities |
+|----------|------------------|------------------|
+| **🇨🇳 Chinese Leaders** | DeepSeek-V3, Qwen-Max, GLM-4 | Chinese understanding, code generation, mathematical reasoning |
+| **🇺🇸 International Giants** | GPT-4, Claude-3, Gemini | Multimodal processing, creative writing, complex reasoning |
+| **⚡ Professional Vertical** | Doubao, Spark, Moonshot | Dialogue generation, long text, role-playing |
+
+### 🔧 Technical Highlights
+
+- **✨ Lightning Deployment**: One-click installation, get started in 5 minutes
+- **⚡ Concurrency Optimization**: Multi-threading processing, supports batch requests
+- **🛡️ Security First**: Environment variable configuration, secure API key management
+- **🔄 Hot Reload**: Dynamic configuration updates, no need to restart ComfyUI
+- **📊 Smart Caching**: Response caching mechanism, reducing API call costs
+- **🐳 Containerized**: Docker support, consistent deployment environment
+
+---
## 🚀 Quick Start
-### 📋 Installation Steps
+### 📋 System Requirements
-```bash
-# 1. Clone the project to ComfyUI's custom_nodes directory
+- **Python**: \`>= 3.8\`
+- **ComfyUI**: Latest version
+- **Memory**: \`>= 4GB RAM\`
+- **Network**: Stable internet connection
+
+### ⚡ Lightning Installation
+
+\`\`\`bash
+# 🎯 Method 1: Git Clone (Recommended)
cd ComfyUI/custom_nodes/
git clone https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit.git
-
-# 2. Enter project directory
cd ComfyUI-LLMs-Toolkit
-# 3. Install dependencies
+# 📦 Install Dependencies
pip install -r requirements.txt
-```
+\`\`\`
+
+\`\`\`bash
+# 🐳 Method 2: Docker Deployment
+docker pull your-dockerhub/comfyui-llms-toolkit:latest
+docker run -d --name comfyui-llms -p 8188:8188 your-dockerhub/comfyui-llms-toolkit
+\`\`\`
### ⚙️ Environment Configuration
-#### 1. Create Environment Variable File
+#### 1️⃣ Create Configuration File
-```bash
-# Copy the environment variable example file
+\`\`\`bash
+# Copy environment variable template
cp config/env.example .env
-```
+\`\`\`
-#### 2. Configure API Keys
+#### 2️⃣ Configure API Keys
-Edit the `.env` file and fill in your API configuration:
+Edit the \`.env\` file and select the models you want to use:
-```bash
-# DeepSeek Configuration (fill in at least one)
-DEEPSEEK_API_KEY=your_deepseek_api_key_here
+\`\`\`bash
+# 🔥 DeepSeek (Recommended for beginners)
+DEEPSEEK_API_KEY=sk-your_deepseek_key_here
DEEPSEEK_BASE_URL=https://api.deepseek.com
DEEPSEEK_MODEL_NAME=deepseek-chat
-# Qwen Configuration
-QWEN_API_KEY=your_qwen_api_key_here
-QWEN_BASE_URL=https://dashscope.aliyun.com/api/v1
+# 🌟 Qwen (Chinese optimized)
+QWEN_API_KEY=your_qwen_key_here
+QWEN_BASE_URL=https://dashscope.aliyuncs.com/api/v1
QWEN_MODEL_NAME=qwen-max
-# OpenAI Configuration
-OPENAI_API_KEY=your_openai_api_key_here
+# 🤖 OpenAI GPT (International standard)
+OPENAI_API_KEY=sk-your_openai_key_here
OPENAI_BASE_URL=https://api.openai.com/v1
-OPENAI_MODEL_NAME=gpt-3.5-turbo
-```
+OPENAI_MODEL_NAME=gpt-4o-mini
-### 🎯 Basic Usage
+# 🚀 More configurations see config/env.example
+\`\`\`
-1. **Restart ComfyUI** - Restart ComfyUI after configuration to load nodes
-2. **Add Nodes** - Find the \`LLMs Toolkit\` category in the node menu
-3. **Configure Model** - Select the LLM model and parameters you want to use
-4. **Start Creating** - Connect workflows to begin your AI creation journey
+#### 3️⃣ API Key Acquisition Guide
-## 🌟 Supported Models
+| 🏢 Provider | 🔗 Get Address | 💰 Free Credits | ⭐ Rating |
+|-------------|----------------|-----------------|-----------|
+| **DeepSeek** | [platform.deepseek.com](https://platform.deepseek.com/) | ¥500 free credits | ⭐⭐⭐⭐⭐ |
+| **Qwen** | [dashscope.aliyun.com](https://dashscope.aliyun.com/) | 1M tokens/month | ⭐⭐⭐⭐ |
+| **OpenAI** | [platform.openai.com](https://platform.openai.com/) | $5 trial credits | ⭐⭐⭐⭐⭐ |
+| **GLM** | [open.bigmodel.cn](https://open.bigmodel.cn/) | 5M tokens/month | ⭐⭐⭐⭐ |
-### 🇨🇳 Chinese Large Language Models
+### 🎯 First Run
-| Model | Provider | Key Features | Config Prefix |
-|-------|----------|--------------|---------------|
-| DeepSeek-V3 | DeepSeek | Superior reasoning, code generation | \`DEEPSEEK_\` |
-| Qwen-Max | Alibaba Cloud | Multimodal understanding, Chinese optimization | \`QWEN_\` |
-| Doubao-Pro | ByteDance | Dialogue generation, creative writing | \`DOUBAO_\` |
-| Spark-Max | iFLYTEK | Language understanding, text analysis | \`SPARK_\` |
-| GLM-4 | Zhipu AI | Knowledge Q&A, logical reasoning | \`GLM_\` |
-| Moonshot-V1 | Moonshot AI | Long text processing | \`MOONSHOT_\` |
+1. **🔄 Restart ComfyUI**:
+ \`\`\`bash
+ # Restart ComfyUI to load new nodes
+ cd /path/to/ComfyUI
+ python main.py
+ \`\`\`
-### 🌍 International Large Language Models
+2. **🔍 Find Nodes**:
+ - Right-click in ComfyUI interface
+ - Navigate to \`Add Node\` → \`LLMs Toolkit\`
+ - Select the node type you need
-| Model | Provider | Key Features | Config Prefix |
-|-------|----------|--------------|---------------|
-| GPT-4 | OpenAI | General intelligence, multimodal | \`OPENAI_\` |
-| Claude | Anthropic | Safe dialogue, long text | \`CLAUDE_\` |
-| Gemini | Google | Multimodal understanding | \`GEMINI_\` |
+3. **⚡ Start Creating**:
+ - Drag in LLM nodes
+ - Configure model parameters
+ - Connect inputs and outputs
+ - Enjoy your AI creation journey!
-## 📄 License
+---
-This project is licensed under the [GPL-2.0](../LICENSE) open source license.
+## 🌟 Supported Model Matrix
+
+### 🇨🇳 Chinese AI Champions
+
+| Model | Provider | Core Advantages | Price Level | Config Prefix |
+|-------|----------|-----------------|-------------|---------------|
+| **DeepSeek-V3** | DeepSeek | 🧮 Mathematical reasoning, 💻 Code generation | 💚 Ultra-low | \`DEEPSEEK_\` |
+| **Qwen-Max** | Alibaba | 🌏 Multimodal, 🇨🇳 Chinese optimization | 💛 Medium | \`QWEN_\` |
+| **GLM-4** | Zhipu AI | 🤔 Logical reasoning, 📚 Knowledge Q&A | 💚 Low | \`GLM_\` |
+| **Doubao-Pro** | ByteDance | 💬 Dialogue generation, ✍️ Creative writing | 💛 Medium | \`DOUBAO_\` |
+| **Spark-Max** | iFLYTEK | 🗣️ Language understanding, 📊 Text analysis | 💚 Low | \`SPARK_\` |
+| **Moonshot-V1** | Moonshot AI | 📖 Long text, 🧠 Deep understanding | 💛 Medium | \`MOONSHOT_\` |
+
+### 🌍 International AI Giants
+
+| Model | Provider | Core Advantages | Price Level | Config Prefix |
+|-------|----------|-----------------|-------------|---------------|
+| **GPT-4o** | OpenAI | 🧠 General intelligence, 🎨 Multimodal | 🧡 High | \`OPENAI_\` |
+| **Claude-3.5** | Anthropic | 🛡️ Safe dialogue, 📚 Long text | 🧡 High | \`CLAUDE_\` |
+| **Gemini-Pro** | Google | 🔍 Search enhanced, 🌐 Multilingual | 💛 Medium | \`GEMINI_\` |
+
+---
+
+## ❓ FAQ
+
+
+🔑 Q: How to get API keys?
+
+**A**: All major vendors provide free trial credits:
+- **DeepSeek**: Register and get ¥500 credits, suitable for beginners
+- **Qwen**: Large quota available after Alibaba Cloud account verification
+- **OpenAI**: New users get $5 free credits, requires international payment method
+
+
+
+
+🖥️ Q: Does it support local models?
+
+**A**: Currently mainly supports API calls, local model support is on the development roadmap:
+- **v2.0**: Planned support for Ollama local models
+- **v2.1**: Support for GGUF format models
+- **v3.0**: Support for custom model fine-tuning
+
+
+
+
+❌ Q: What to do when encountering connection errors?
+
+**A**: Common solutions:
+1. **Check network**: Ensure access to corresponding API services
+2. **Verify keys**: Confirm API keys are correct and have balance
+3. **Check configuration**: Confirm BASE_URL format is correct
+4. **View logs**: Check ComfyUI console output
+
+
+
+---
+
+## 📄 Open Source License
+
+This project is licensed under **[GNU General Public License v2.0](../LICENSE)**.
+
+**This means:**
+- ✅ **Free to use**: Both personal and commercial use
+- ✅ **Free to modify**: You can modify the source code
+- ✅ **Free to distribute**: You can distribute original or modified versions
+- ⚠️ **Open source obligation**: Modified versions must be open source
---
-**⭐ If this project helps you, please give us a Star!**
+### 🌟 If this project helps you, please give us a Star!
[](https://star-history.com/#HuangYuChuh/ComfyUI-LLMs-Toolkit&Date)
+**📞 Contact Us**
+
+[](https://github.com/HuangYuChuh)
+[](mailto:your-email@example.com)
+
+---
+
+**💡 Made with ❤️ for the ComfyUI community**
+
+*Making AI creation simpler, making technology more humane*
+