xiaohongshu_note_uploader/使用说明.md

# 小红书笔记发布工具 - 使用说明

## 🎯 这是什么？

一个**超级简单**的小红书自动发布工具！

只需几行代码，就能自动发布图文/视频笔记到小红书 📱✨

## ⚡ 快速开始（3步搞定）

### 第1步：安装

```bash
pip install playwright loguru
playwright install chromium
```

### 第2步：准备你的图片

把图片放到任意文件夹，比如 `my_photos` 文件夹

### 第3步：写代码发布

创建 `发布笔记.py`：

```python
import asyncio
from publisher import XiaoHongShuImageNote

async def main():
    note = XiaoHongShuImageNote(
        title="我的第一篇笔记",           # 标题
        content="Hello 小红书！",         # 正文
        tags=["#新人"],                   # 标签
        image_paths=["my_photos/1.jpg"],  # 图片路径
        publish_date=0,                   # 0=立即发布
        account_file="cookies/my.json"    # Cookie保存位置
    )
    await note.main()
    print("发布成功！")

asyncio.run(main())
```

运行：
```bash
python 发布笔记.py
```

**首次运行会弹出浏览器，用小红书App扫码登录即可！**

## 📸 常用功能

### 1️⃣ 发布多张图片

```python
image_paths=["1.jpg", "2.jpg", "3.jpg"]  # 最多9张
```

### 2️⃣ 添加多个标签

```python
tags=["#美食", "#探店", "#广州"]  # 最多3个
```

### 3️⃣ 定时发布

```python
from datetime import datetime, timedelta

明天下午3点 = datetime.now() + timedelta(days=1)
明天下午3点 = 明天下午3点.replace(hour=15, minute=0)

note = XiaoHongShuImageNote(
    ...,
    publish_date=明天下午3点  # 定时发布
)
```

### 4️⃣ 添加位置

```python
location="广州塔"  # 添加地理位置
```

### 5️⃣ 发布视频

```python
from publisher import XiaoHongShuVideoNote

note = XiaoHongShuVideoNote(
    title="我的vlog",
    content="今天的记录",
    tags=["#vlog"],
    video_path="my_video.mp4",  # 视频文件
    publish_date=0,
    account_file="cookies/my.json"
)
```

## 📚 示例文件

项目里有很多示例，直接运行就能看效果：

| 文件 | 说明 | 运行方式 |
|------|------|----------|
| `quick_test.py` | 快速测试 | `python quick_test.py` |
| `example_image.py` | 图文笔记示例 | `python example_image.py` |
| `example_video.py` | 视频笔记示例 | `python example_video.py` |
| `example_batch.py` | 批量发布示例 | `python example_batch.py` |

## ❓ 常见问题

### Q1: Cookie失效了怎么办？

**A:** 删除Cookie文件，重新运行会自动让你登录

```bash
rm cookies/my.json
python 发布笔记.py
```

### Q2: 为什么上传失败？

**A:** 检查这几点：
- ✅ 网络连接正常吗？
- ✅ 图片/视频文件存在吗？
- ✅ 文件路径写对了吗？
- ✅ 图片格式是jpg/png吗？

### Q3: 可以批量发布吗？

**A:** 可以！参考 `example_batch.py`

### Q4: 支持多账号吗？

**A:** 支持！每个账号用不同的Cookie文件：

```python
# 账号1
account_file="cookies/账号1.json"

# 账号2  
account_file="cookies/账号2.json"
```

### Q5: 会被封号吗？

**A:** 工具模拟真人操作，很安全。但要注意：
- ⚠️ 不要频繁发布（建议间隔30秒以上）
- ⚠️ 不要发布违规内容
- ⚠️ 不要一次发太多（建议每天10篇以内）

## 💡 使用技巧

### 技巧1：批量发布要间隔

```python
# 发布完一篇后等30秒
await asyncio.sleep(30)
# 再发布下一篇
```

### 技巧2：可以看到操作过程

```python
headless=False  # 会打开浏览器，可以看到操作
```

### 技巧3：指定封面图

```python
image_paths=["1.jpg", "2.jpg", "3.jpg"],
cover_index=1  # 使用第2张图作为封面（从0开始数）
```

## 📞 需要帮助？

- 📖 详细文档：`README.md`
- 🚀 快速指南：`QUICKSTART.md`
- 💬 遇到问题：提Issue

## 🎉 开始使用吧！

运行快速测试体验一下：

```bash
python quick_test.py
```

**祝你使用愉快！** ✨