xiaohongshu_note_uploader/PROJECT_INFO.md

# 小红书笔记发布工具 - 项目信息

## 📦 项目概述

这是一个从 `autoUpload` 项目中提取出来的**独立模块**，专门用于小红书笔记的自动发布。

### 特点

✅ **独立运行** - 可以单独使用，不依赖原项目的其他模块  
✅ **简单易用** - API设计简洁，几行代码即可完成发布  
✅ **文档完善** - 提供中英文文档，多个示例代码  
✅ **功能完整** - 支持图文、视频、定时发布、批量发布等  

## 📂 文件说明

### 核心文件

| 文件 | 说明 |
|------|------|
| `publisher.py` | 主程序入口，导出核心类 |
| `requirements.txt` | Python依赖列表 |

### 文档文件

| 文件 | 说明 | 适合人群 |
|------|------|----------|
| `README.md` | 完整英文文档 | 所有用户 |
| `使用说明.md` | 简化中文说明 | 中文用户 |
| `QUICKSTART.md` | 5分钟快速指南 | 新手用户 |
| `PROJECT_INFO.md` | 项目信息（本文件） | 开发者 |

### 示例文件

| 文件 | 说明 | 运行方式 |
|------|------|----------|
| `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` |

### 其他文件

| 文件/目录 | 说明 |
|----------|------|
| `cookies/` | Cookie存储目录 |
| `.gitignore` | Git忽略规则 |

## 🔗 依赖关系

这个独立模块仍然依赖原项目的以下部分：

```
xiaohongshu_note_publisher/
├── publisher.py  ────────┐
                          ├──→ ../uploader/xhs_note_uploader/main.py
                          ├──→ ../utils/base_social_media.py
                          ├──→ ../utils/human_typing_wrapper.py
                          ├──→ ../utils/log.py
                          └──→ ../conf.py
```

### 需要的原项目文件

运行此模块需要原项目中的以下文件：

```
autoUpload/
├── conf.py                          # 配置文件
├── uploader/
│   └── xhs_note_uploader/
│       ├── __init__.py
│       └── main.py                  # 核心上传逻辑
└── utils/
    ├── base_social_media.py         # 基础工具
    ├── human_typing_wrapper.py      # 人类化输入
    ├── log.py                       # 日志
    └── stealth.min.js              # 反检测脚本
```

## 🚀 部署方式

### 方式1：作为子目录使用（当前方式）

保持在 `autoUpload/xiaohongshu_note_publisher/` 目录下，直接运行。

优点：
- ✅ 无需修改代码
- ✅ 可以直接使用

缺点：
- ❌ 依赖原项目结构

### 方式2：完全独立部署

如果要完全独立部署，需要：

1. 将以下文件复制到独立目录：
```
xiaohongshu_note_publisher/
├── publisher.py
├── conf.py (从父目录复制)
├── uploader/
│   └── xhs_note_uploader/
│       └── main.py
└── utils/
    ├── base_social_media.py
    ├── human_typing_wrapper.py
    ├── log.py
    └── stealth.min.js
```

2. 修改 `publisher.py` 中的导入路径：
```python
# 从
sys.path.insert(0, parent_dir)
from uploader.xhs_note_uploader.main import ...

# 改为
from uploader.xhs_note_uploader.main import ...
```

## 📊 版本历史

### v1.0.0 (2025-11-07)

**首次发布**

核心功能：
- ✅ 图文笔记发布（1-9张图片）
- ✅ 视频笔记发布
- ✅ 自动Cookie管理
- ✅ 定时发布
- ✅ 地理位置标记
- ✅ 人类化操作
- ✅ 批量发布

文档：
- ✅ 完整英文README
- ✅ 简化中文说明
- ✅ 快速开始指南
- ✅ 4个示例代码

## 🎯 使用场景

### 个人使用
- 📱 个人笔记自动发布
- 📸 旅行照片批量分享
- 🎬 Vlog定时发布

### 商业使用
- 🛍️ 电商产品批量上架
- 📢 营销内容定时发布
- 🏢 多账号管理

### 开发集成
- 🤖 集成到现有系统
- 📊 内容管理系统(CMS)
- 🔄 自动化工作流

## 💡 最佳实践

### 1. 发布频率控制

```python
# 每篇笔记间隔30-60秒
await asyncio.sleep(30)
```

### 2. 使用有意义的Cookie文件名

```python
account_file="cookies/美食账号.json"
account_file="cookies/旅游账号.json"
```

### 3. 批量发布建议使用无头模式

```python
headless=True  # 提高效率
```

### 4. 添加错误处理

```python
try:
    await note.main()
except Exception as e:
    print(f"发布失败: {e}")
    # 记录日志或发送通知
```

## 🔧 技术栈

- **Python 3.11+** - 编程语言
- **Playwright** - 浏览器自动化
- **Loguru** - 日志记录
- **Chromium** - 浏览器驱动

## 📞 技术支持

- 📖 查看文档解决常见问题
- 💬 提交Issue获取帮助
- 🤝 欢迎贡献代码和改进建议

## 📄 许可证

MIT License

---

**项目创建日期：** 2025-11-07  
**当前版本：** 1.0.0  
**维护状态：** 活跃开发中 🚀