social_media_auto_publisher/README.md

# 社交媒体自动发布器

🚀 一个统一的社交媒体自动化发布平台，支持小红书和抖音的内容自动发布。

## ✨ 特性

- 🎯 **多平台支持**: 小红书（图文/视频）、抖音（视频）
- 🔐 **智能登录**: 扫码登录 + Cookie持久化管理
- 🛡️ **反检测机制**: 模拟人类操作，避免被平台识别
- ⚡ **批量发布**: 支持多账号、多内容批量操作
- 📊 **任务调度**: 定时发布、内容规划
- 📝 **详细日志**: 完整的操作记录和错误追踪

## 🏗️ 项目结构

```
social_media_auto_publisher/
├── core/                   # 核心引擎
│   ├── publisher.py        # 统一发布管理器
│   ├── session_manager.py  # 会话管理
│   └── task_scheduler.py   # 任务调度器
├── platforms/              # 平台适配层
│   ├── xiaohongshu/        # 小红书适配器
│   └── douyin/             # 抖音适配器
├── auth/                   # 认证模块
│   ├── base_auth.py        # 基础认证类
│   ├── xiaohongshu_auth.py # 小红书认证
│   └── douyin_auth.py      # 抖音认证
├── utils/                  # 工具模块
│   ├── browser.py          # 浏览器管理
│   ├── human_behavior.py   # 人类行为模拟
│   ├── media_handler.py    # 媒体文件处理
│   └── logger.py           # 日志管理
├── config/                 # 配置管理
│   ├── settings.py         # 系统配置
│   └── platform_config.py  # 平台配置
├── tests/                  # 测试用例
├── examples/               # 使用示例
├── docs/                   # 文档
└── media/                  # 媒体文件存储
```

## 🚀 快速开始

### 环境要求

- Python >= 3.8
- Playwright >= 1.40.0
- Chrome/Chromium 浏览器

### 安装

```bash
# 克隆项目
git clone https://github.com/your-repo/social_media_auto_publisher.git
cd social_media_auto_publisher

# 安装依赖
pip install -r requirements.txt

# 安装 Playwright 浏览器
playwright install chromium
```

### 基本使用

```python
import asyncio
from social_media_auto_publisher import Publisher, ImageNote, VideoContent

async def main():
    # 初始化发布器
    publisher = Publisher(headless=False)

    # 设置小红书账号（首次使用需要扫码登录）
    await publisher.setup_platform("xiaohongshu", "your_account_name")

    # 发布图文笔记
    note = ImageNote(
        title="我的旅行分享",
        description="今天去了很美的地方，分享给大家！",
        images=["path/to/image1.jpg", "path/to/image2.jpg"],
        tags=["旅行", "美景", "分享"]
    )

    result = await publisher.publish("xiaohongshu", note, "your_account_name")
    print(f"发布结果: {result}")

    # 发布视频到抖音
    video = VideoContent(
        title="搞笑视频",
        description="今天拍的搞笑视频，希望大家喜欢！",
        video_path="path/to/video.mp4",
        tags=["搞笑", "日常"]
    )

    result = await publisher.publish("douyin", video, "your_douyin_account")
    print(f"发布结果: {result}")

if __name__ == "__main__":
    asyncio.run(main())
```

### 批量发布

```python
from social_media_auto_publisher import Publisher, PublishTask

async def batch_publish():
    publisher = Publisher()

    # 创建批量任务
    tasks = [
        PublishTask(
            platform="xiaohongshu",
            content=image_note,
            account="user1"
        ),
        PublishTask(
            platform="douyin",
            content=video_content,
            account="user2"
        ),
    ]

    # 执行批量发布
    results = await publisher.batch_publish(tasks)

    for result in results:
        print(f"任务 {result.task_id}: {'成功' if result.success else '失败'}")

asyncio.run(batch_publish())
```

## 📋 支持的功能

### 小红书 (XiaoHongShu)
- ✅ 扫码登录
- ✅ 图文笔记发布 (最多9张图片)
- ✅ 视频笔记发布
- ✅ Cookie 自动管理
- ✅ 发布状态检测

### 抖音 (Douyin)
- ✅ 扫码登录
- ✅ 视频发布
- ✅ Cookie 自动管理
- ✅ 上传进度监控
- ⏳ 图文笔记 (规划中)

### 通用功能
- ✅ 人类行为模拟
- ✅ 反自动化检测
- ✅ 批量操作
- ✅ 错误重试机制
- ✅ 详细日志记录
- ✅ 配置管理
- ⏳ 定时发布 (开发中)

## ⚙️ 配置

### 基础配置

```python
# config/settings.py
class Settings:
    # 浏览器配置
    BROWSER_HEADLESS = False          # 是否无头模式
    BROWSER_TIMEOUT = 30000           # 超时时间（毫秒）

    # 并发配置
    MAX_CONCURRENT_TASKS = 3          # 最大并发任务数
    TASK_RETRY_COUNT = 3              # 任务重试次数

    # 反检测配置
    HUMAN_TYPING_SPEED = (80, 150)    # 打字速度范围（毫秒/字符）
    RANDOM_PAUSE_PROBABILITY = 0.15   # 随机暂停概率
    RANDOM_DELAY_RANGE = (0.3, 0.8)   # 随机延迟范围（秒）

    # 文件限制
    MAX_IMAGE_SIZE = 10 * 1024 * 1024 # 最大图片大小 (10MB)
    MAX_VIDEO_SIZE = 500 * 1024 * 1024 # 最大视频大小 (500MB)
```

### 平台特定配置

```python
# config/platform_config.py
XIAOHONGSHU = {
    'login_url': 'https://creator.xiaohongshu.com/',
    'image_note_url': 'https://creator.xiaohongshu.com/publish/publish',
    'video_note_url': 'https://creator.xiaohongshu.com/publish/video',
    'max_images': 9,
    'max_video_duration': 300,  # 5分钟
}

DOUYIN = {
    'login_url': 'https://creator.douyin.com/creator-micro/home',
    'upload_url': 'https://creator.douyin.com/creator-micro/content/upload',
    'max_video_duration': 600,  # 10分钟
    'supported_formats': ['mp4', 'mov', 'avi'],
}
```

## 🛡️ 反检测机制

本项目采用多层反检测策略来避免被平台识别为自动化工具：

### 1. 浏览器指纹伪装
- 使用 stealth.min.js 脚本
- 修改 webdriver、navigator 等属性
- 随机化浏览器版本和插件信息

### 2. 行为模拟
- **打字模拟**: 随机打字速度 (80-150ms/字符)
- **点击模拟**: 模拟真实鼠标移动和点击
- **滚动模拟**: 随机滚动行为
- **随机暂停**: 15% 概率随机暂停 0.3-0.8 秒

### 3. 操作时间随机化
- 操作间隔随机化 (1-3秒)
- 上传检测等待完成状态
- 智能重试机制

## 📝 使用示例

更多使用示例请查看 [examples/](examples/) 目录：

- [小红书图文笔记发布](examples/xiaohongshu_image_note.py)
- [小红书视频笔记发布](examples/xiaohongshu_video_note.py)
- [抖音视频发布](examples/douyin_video.py)
- [批量发布示例](examples/batch_publish.py)
- [多账号管理](examples/multi_account.py)

## 🧪 测试

```bash
# 运行所有测试
python -m pytest tests/

# 运行特定平台测试
python -m pytest tests/test_xiaohongshu.py
python -m pytest tests/test_douyin.py

# 运行测试并查看覆盖率
python -m pytest tests/ --cov=.
```

## 📊 日志

系统会自动记录详细的操作日志：

```bash
logs/
├── 2024-01-01.log          # 按日期分割的日志文件
├── 2024-01-02.log
└── ...
```

日志级别：
- **INFO**: 正常操作信息
- **WARNING**: 警告信息
- **ERROR**: 错误信息
- **DEBUG**: 调试信息（需手动开启）

## 🔧 故障排除

### 常见问题

**Q: 登录时一直等待扫码？**
A: 确保在5分钟内完成扫码，如果超时需要重新开始。

**Q: 发布失败提示元素找不到？**
A: 可能是平台页面更新，需要更新选择器配置。

**Q: 文件上传失败？**
A: 检查文件格式和大小是否符合平台要求。

**Q: 被平台检测为自动化？**
A: 尝试增加操作间隔时间，降低并发数量。

### 调试模式

```python
# 开启调试模式
publisher = Publisher(
    headless=False,      # 显示浏览器窗口
    debug=True,          # 开启调试日志
    slow_mode=True       # 慢速模式，增加操作间隔
)
```

## 🤝 贡献

欢迎贡献代码！请遵循以下步骤：

1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## ⚠️ 免责声明

本工具仅供学习和研究使用，请遵守相关平台的使用条款和法律法规。使用本工具产生的任何后果由使用者承担。

## 🙏 致谢

- 感谢 [Playwright](https://playwright.dev/) 提供强大的浏览器自动化能力
- 感谢 [loguru](https://github.com/Delgan/loguru) 提供优雅的日志管理
- 参考了 [xiaohongshu_note_publisher](https://github.com/your-repo/xiaohongshu_note_publisher) 项目的设计思路

---

📧 如有问题或建议，欢迎提交 Issue 或联系：your-email@example.com