xiaohongshu_note_uploader/QUICKSTART.md

# 快速开始指南

5分钟快速上手小红书笔记发布工具 🚀

## 第一步：安装依赖

```bash
# 安装Python依赖包
pip install playwright loguru

# 安装浏览器驱动（重要！）
playwright install chromium
```

## 第二步：运行快速测试

```bash
# 直接运行测试脚本
python quick_test.py
```

测试脚本会：
1. ✅ 检查环境配置
2. 🔐 自动打开浏览器（首次需要扫码登录）
3. 📸 上传测试图片
4. 🎉 发布测试笔记

## 第三步：发布你的第一篇笔记

### 图文笔记

创建文件 `my_first_note.py`：

```python
import asyncio
from publisher import XiaoHongShuImageNote

async def main():
    note = XiaoHongShuImageNote(
        title="我的第一篇笔记 ✨",
        content="Hello 小红书！",
        tags=["#新人报到"],
        image_paths=["my_photo.jpg"],  # 换成你的图片路径
        publish_date=0,
        account_file="cookies/account.json"
    )
    await note.main()

asyncio.run(main())
```

运行：
```bash
python my_first_note.py
```

## 常用功能

### 1. 多图发布

```python
image_paths=["photo1.jpg", "photo2.jpg", "photo3.jpg"]
```

### 2. 添加标签

```python
tags=["#美食", "#探店", "#广州"]
```

### 3. 定时发布

```python
from datetime import datetime, timedelta

tomorrow = datetime.now() + timedelta(days=1)
tomorrow = tomorrow.replace(hour=15, minute=0)

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

### 4. 添加地理位置

```python
note = XiaoHongShuImageNote(
    ...,
    location="广州塔"
)
```

## 常见问题

### Q: 提示"Cookie失效"怎么办？
A: 删除Cookie文件重新登录：
```bash
rm cookies/account.json
python quick_test.py
```

### Q: 图片上传失败？
A: 检查：
- 图片文件是否存在
- 图片格式是否正确（jpg/png）
- 文件路径是否正确

### Q: 如何使用多个账号？
A: 为每个账号准备不同的Cookie文件：
```python
account_file="cookies/account1.json"  # 账号1
account_file="cookies/account2.json"  # 账号2
```

## 更多示例

查看项目中的示例文件：
- `example_image.py` - 图文笔记完整示例
- `example_video.py` - 视频笔记完整示例

## 需要帮助？

- 📖 查看完整文档：`README.md`
- 💬 遇到问题可以提Issue

---

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