# 小红书 AI 内容助手 - 快速使用指南

---

## 🚀 5分钟上手

### 步骤 1：安装依赖

```powershell
cd C:\Users\Administrator\xiaohongshu-content-assistant
pip install fastapi uvicorn pydantic requests
```

### 步骤 2：配置 API Key

编辑 `config.py`，设置你的 API Key：

```python
API_KEY: str = "your-api-key-here"
```

### 步骤 3：运行

**方式 A：一键启动**
```powershell
start.bat
```

**方式 B：命令行**
```powershell
# 快速生成
python main.py --topic "手冲咖啡" --type coffee_culture

# 交互模式
python main.py --mode interactive

# API 服务
python main.py --mode api
```

---

## 📝 常用命令

### 生成不同类型内容

```powershell
# 咖啡文化
python main.py --topic "周末咖啡探店" --type coffee_culture

# 产品测评
python main.py --topic "瑞幸拿铁" --type product_review

# 穿搭分享
python main.py --topic "秋冬穿搭" --type ootd

# 生活方式
python main.py --topic "周末日常" --type lifestyle

# 美食探店
python main.py --topic "网红餐厅" --type food

# 旅行攻略
python main.py --topic "青岛三日游" --type travel

# 知识科普
python main.py --topic "如何选择咖啡豆" --type knowledge
```

---

## 🌐 API 使用

### 启动服务

```powershell
python main.py --mode api
```

### 调用示例

```bash
# 生成内容
curl -X POST "http://localhost:8000/api/v1/content/generate" \
  -H "Content-Type: application/json" \
  -d "{\"content_type\": \"coffee_culture\", \"params\": {\"topic\": \"手冲咖啡\"}}"

# 批量生成
curl -X POST "http://localhost:8000/api/v1/content/generate/batch" \
  -H "Content-Type: application/json" \
  -d "{\"content_type\": \"coffee_culture\", \"params\": {\"topic\": \"手冲咖啡\"}, \"count\": 3}"

# 优化内容
curl -X POST "http://localhost:8000/api/v1/content/optimize" \
  -H "Content-Type: application/json" \
  -d "{\"content\": \"原文案...\", \"instruction\": \"更像真人\"}"

# 生成标题
curl -X POST "http://localhost:8000/api/v1/content/titles" \
  -H "Content-Type: application/json" \
  -d "{\"content\": \"正文内容...\", \"count\": 5}"

# 生成标签
curl -X POST "http://localhost:8000/api/v1/content/tags" \
  -H "Content-Type: application/json" \
  -d "{\"content\": \"正文内容...\", \"count\": 5}"
```

---

## 🤖 OpenClaw 集成

### 通过 OpenClaw 使用

在 OpenClaw 聊天中直接说：

```
你: 帮我写一篇关于手冲咖啡的小红书文案
AI: [自动生成内容]

你: 生成秋冬穿搭分享
AI: [自动生成内容]

你: 写一个瑞幸拿铁的产品测评
AI: [自动生成内容]
```

### 技能位置

```
C:\Users\Administrator\.openclaw\skills\xiaohongshu-writer\
```

---

## 📂 项目结构

```
xiaohongshu-content-assistant/
├── prompts/                   # Prompt 模板
│   ├── title_prompt.txt      # 标题生成
│   ├── note_prompt.txt       # 正文生成
│   ├── humanize_prompt.txt   # 拟人化
│   └── risk_prompt.txt       # 风险检测
├── api/                      # API 服务
├── core/                     # 核心逻辑
├── models/                   # AI 模型
├── openclaw_integration.py   # OpenClaw 集成
├── main.py                   # 入口文件
├── config.py                 # 配置
├── start.bat                 # 一键启动
├── requirements.txt          # 依赖
├── README.md                 # 文档
├── ROADMAP.md                # 规划
└── QUICKSTART.md             # 本文件
```

---

## 🔧 故障排除

### 问题 1：编码错误
```powershell
chcp 65001
```

### 问题 2：依赖安装失败
```powershell
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```

### 问题 3：API 调用失败
- 检查 API Key 是否正确
- 检查网络连接
- 查看错误详情

### 问题 4：端口被占用
```powershell
# 更改端口
uvicorn api.server:app --port 8001
```

---

## 📞 获取帮助

- 查看完整文档：`README.md`
- 查看项目规划：`ROADMAP.md`
- 运行测试：`python tests/test_all.py`

---

## 🎯 下一步

1. 熟悉 7 种内容类型
2. 尝试不同的写作风格
3. 集成到你的工作流
4. 探索 OpenClaw 深度集成

---

**祝你创作愉快！** ☕
