xiaohongshu-publisher

# 小红书自动发布技能

自动发布笔记到小红书创作者中心。内容生成 → 封面图生成（多张） → 自动发布，全流程自动化。

## 核心特性

- ✅ 跨平台（Windows / macOS / Linux）
- ✅ 无硬编码路径，所有目录可通过环境变量或参数配置
- ✅ 浏览器会话默认不持久化到磁盘（安全），可通过 `--profile-dir` 或 `XHS_PROFILE_DIR` 显式开启
- ✅ 内容自动生成（6大话题模板库 + 通用模板）
- ✅ 封面图自动生成（5种布局 × 7种纹理 × 10种配色，每张风格不同）
- ✅ 多图上传（默认3张，可配置）
- ✅ 一条命令完成全流程

## 环境变量（可选）

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `SKILL_DATA_DIR` | 数据根目录（图片/内容/截图） | `<skill>/.local/` |
| `XHS_PROFILE_DIR` | 浏览器 profile 目录（登录态持久化） | 临时目录（不持久化） |
| `XHS_FONT_PATH` | 自定义字体路径 | 系统默认中文字体 |

## 快速开始

### 首次登录（只需一次）

```bash
python scripts/save_login.py                          # 默认保存到 .local/xhs_browser_profile/
python scripts/save_login.py --profile-dir ~/xhs_data  # 自定义目录
```

### 一键发布

```bash
python scripts/auto_publish.py --topic 美食                                    # 临时 profile，不保留登录态
python scripts/auto_publish.py --topic 科技 --profile-dir .local/xhs_browser_profile  # 复用已保存的登录态
python scripts/auto_publish.py --topic 穿搭 --count 5
python scripts/auto_publish.py --topic 生活 --image a.png b.png c.png
```

也可以通过环境变量设置 profile 目录，避免每次传参：

```bash
export XHS_PROFILE_DIR=.local/xhs_browser_profile   # Linux/macOS
set XHS_PROFILE_DIR=.local\xhs_browser_profile       # Windows
python scripts/auto_publish.py --topic 美食
```

### 参数说明

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `--topic` | 话题（美食/旅游/穿搭/科技/生活/健身） | 科技 |
| `--title` | 自定义标题（<20字） | 自动生成 |
| `--content` | 自定义正文 | 自动生成 |
| `--cover-text` | 封面图文字 | 用标题 |
| `--image` | 已有图片路径（可多张） | 自动生成 |
| `--profile-dir` | 浏览器 profile 目录（登录态持久化） | 临时目录 |
| `--count` | 生成图片数量 | 3 |

## 话题模...