readme_en.md

🌟 Xiaohongshu AI Publisher

🎨 Smart Content Creation • 🤖 AI-Powered • 📱 One-Click Publishing

🇨🇳 简体中文 | 🇺🇸 English

---

📖 Project Overview

Xiaohongshu AI Publisher is a powerful automated content creation and publishing tool, specifically designed for content creators on the Xiaohongshu platform.

🎯 Core Values

• 🧠 Smart Creation: Generate high-quality content with advanced AI technology
• ⚡ Efficiency Boost: One-click operation saves 90% of publishing time
• 🎨 Professional Quality: Beautiful interface design with excellent user experience
• 🔧 Complete Features: Full automation from content generation to publishing

---

✨ Core Features

🤖 AI Smart Generation 🎯 Smart Titles: AI-generated engaging titles 📝 Content Creation: Auto-generate articles based on topics 🖼️ Image Processing: Smart image matching and processing 🏷️ Tag Recommendations: Auto-recommend trending tags	🚀 Automated Publishing 📱 One-Click Login: Quick login with phone number 📋 Content Preview: Complete preview before publishing ⏰ Scheduled Publishing: Support for timed publishing 💾 State Saving: Auto-save login status
👥 User Management 🔄 Multi-Account: Support multiple Xiaohongshu accounts 🌐 Proxy Configuration: Support proxy server configuration 🔍 Browser Fingerprints: Anti-detection browser fingerprints 📊 Data Analytics: Publishing data statistics and analysis	🛡️ Security & Stability 🔐 Data Encryption: Secure local data encryption storage 🛡️ Anti-Detection: Advanced anti-detection technology 📝 Logging: Complete operation logging 🔄 Error Recovery: Smart error handling and recovery

---

📁 Project Architecture

📦 xhs_ai_publisher/
├── 📂 src/                          # 🔧 Source Code Directory
│   ├── 📂 core/                     # ⚡ Core Functionality Modules
│   │   ├── 📂 models/               # 🗄️ Data Models
│   │   ├── 📂 services/             # 🔧 Business Service Layer
│   │   ├── 📂 pages/                # 🎨 UI Pages
│   │   ├── 📂 browser/              # 🌐 Browser Automation
│   │   └── 📂 utils/                # 🛠️ Utility Functions
│   ├── 📂 web/                      # 🌐 Web Interface
│   │   ├── 📂 templates/            # 📄 HTML Templates
│   │   └── 📂 static/               # 🎨 Static Resources
│   └── 📂 logger/                   # 📝 Logging System
├── 📂 ai_publish_google_shop/       # 🏪 Chrome Extension
├── 📂 test/                         # 🧪 Test Directory
├── 📂 build/                        # 📦 Build Output
├── 🐍 main.py                       # 🚀 Main Program Entry
├── 📋 requirements.txt              # 📦 Dependencies List
└── 📖 README.md                     # 📚 Project Documentation

---

🛠️ Quick Start

📋 System Requirements

Component	Version	Description
🐍 Python	3.9+	Latest version recommended
🌐 Chrome	Latest	For browser automation
💾 Memory	4GB+	8GB+ recommended
💿 Storage	2GB+	For dependencies and data

🚀 Installation Methods

📥 Method 1: Source Installation (Recommended for Developers)

# 1️⃣ Clone the repository
git clone https://github.com/yourusername/xhs_ai_publisher.git
cd xhs_ai_publisher

# 2️⃣ Create virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # Linux/Mac
# or
venv\Scripts\activate     # Windows

# 3️⃣ Install dependencies
pip install -r requirements.txt

# 4️⃣ Install browser drivers
playwright install chromium

# 5️⃣ Initialize database
python src/core/database_init.py init

# 6️⃣ Start the program
python main.py

📦 Method 2: Executable Program (Recommended for General Users)

🎯 One-Click Download, Ready to Use

Extraction Code: iqiy

Usage Steps:

1. 📥 Download and extract the archive
2. 🚀 Double-click to run easy_ui.exe
3. 🎯 Follow the interface prompts

Important Notes:

• ✅ Windows 10/11 systems only
• ⏱️ First run may take 30-60 seconds to load
• 🛡️ Add to antivirus software whitelist if prompted

---

📱 User Guide

🎯 Basic Usage Flow

flowchart LR
    A[🚀 Launch Program] --> B[📱 Login Account]
    B --> C[✍️ Input Topic]
    C --> D[🤖 AI Generate Content]
    D --> E[👀 Preview Content]
    E --> F[📤 One-Click Publish]
    
    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style C fill:#e8f5e8
    style D fill:#fff3e0
    style E fill:#fce4ec
    style F fill:#e0f2f1

Loading

📝 Detailed Steps

1. 🚀 Launch Program

   • Run python main.py or double-click executable
   • Wait for program initialization

2. 👤 User Management

   • Click "User Management" button
   • Add new users or switch existing users
   • Configure proxy and browser fingerprints (optional)

3. 📱 Account Login

   • Enter phone number
   • Receive and enter verification code
   • System automatically saves login status

4. ✍️ Content Creation

   • Enter creation topic in the input box
   • Click "Generate Content" button
   • AI automatically generates title and content

5. 🖼️ Image Processing

   • System automatically matches relevant images
   • Manually upload custom images
   • Support batch image processing

6. 👀 Preview & Publish

   • Click "Preview Publish" to check content
   • Confirm content and click publish
   • Support scheduled publishing

---

🎨 Interface Preview

🏠 Main Interface	👤 User Management
🤖 Content Generation	📤 Publish Preview

---

🔧 Advanced Configuration

⚙️ Configuration Files

📁 config.py - Main Configuration File

# AI Configuration
AI_CONFIG = {
    "model": "gpt-3.5-turbo",
    "max_tokens": 2000,
    "temperature": 0.7
}

# Browser Configuration
BROWSER_CONFIG = {
    "headless": False,
    "user_agent": "Mozilla/5.0...",
    "viewport": {"width": 1920, "height": 1080}
}

# Publishing Configuration
PUBLISH_CONFIG = {
    "auto_publish": False,
    "delay_range": [3, 8],
    "max_retry": 3
}

🌐 Proxy Configuration

Supports multiple proxy types:

• 🔗 HTTP Proxy
• 🔒 HTTPS Proxy
• 🧅 SOCKS5 Proxy
• 🏠 Local Proxy

---

📊 Roadmap

🗓️ Development Roadmap

• ✅ Basic Features: Content generation and publishing
• ✅ User Management: Multi-account support
• ✅ Proxy Configuration: Network proxy support
• 🔄 Content Library: Material management system
• 🔄 Template Library: Preset template system
• 🔄 Data Analytics: Publishing performance analysis
• 🔄 API Interface: Open API endpoints
• 🔄 Mobile Support: Mobile app support

---

🤝 Contributing

🎉 We welcome all forms of contributions!

🛠️ Contribution Guidelines

1. 🍴 Fork the project
2. 🌿 Create a feature branch (git checkout -b feature/AmazingFeature)
3. 💾 Commit your changes (git commit -m 'Add some AmazingFeature')
4. 📤 Push to the branch (git push origin feature/AmazingFeature)
5. 🔄 Create a Pull Request

---

📞 Contact Us

💬 Join Our Community

🐱 WeChat Group Scan to join discussion

📱 Official Account Get latest updates

---

📄 License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details

---

_{🌟 Built with ❤️ for Xiaohongshu content creators | 为小红书创作者精心打造}

⭐ If this project helps you, please give us a star!