social_media_auto_publisher/INSTALLATION.md

# 安装指南

## 环境要求

- Python >= 3.8
- Chrome/Chromium 浏览器
- 稳定的网络连接

## 安装步骤

### 1. 克隆项目

```bash
git clone https://github.com/your-repo/social_media_auto_publisher.git
cd social_media_auto_publisher
```

### 2. 创建虚拟环境

```bash
# 使用 venv
python -m venv venv

# 激活虚拟环境
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate
```

### 3. 安装依赖

```bash
pip install -r requirements.txt
```

### 4. 安装 Playwright 浏览器

```bash
playwright install chromium
```

### 5. 验证安装

```bash
python -c "from social_media_auto_publisher import Publisher; print('安装成功！')"
```

## 配置

### 环境变量配置（可选）

创建 `.env` 文件：

```env
# 浏览器配置
SMP_BROWSER_HEADLESS=false
SMP_BROWSER_TIMEOUT=30000
SMP_BROWSER_USER_AGENT=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36

# 并发配置
SMP_MAX_CONCURRENT_TASKS=3
SMP_TASK_RETRY_COUNT=3

# 文件大小限制
SMP_MAX_IMAGE_SIZE=10485760  # 10MB
SMP_MAX_VIDEO_SIZE=524288000  # 500MB

# 日志配置
SMP_LOG_LEVEL=INFO
SMP_LOG_DIR=logs

# 开发模式
SMP_DEBUG=false
SMP_ENV=development
```

## 目录结构

创建以下目录结构：

```
social_media_auto_publisher/
├── auth/cookies/           # Cookie存储目录
├── logs/                   # 日志文件目录
├── media/                  # 媒体文件目录
│   ├── images/            # 图片文件
│   └── videos/            # 视频文件
└── temp/                  # 临时文件目录
```

## 验证安装

运行基础示例验证安装：

```bash
cd examples
python basic_usage.py
```

如果看到正常的输出，说明安装成功。