# 小红书 AI 内容助手 - 完整文档

> 基于 AI 的智能内容生成工具，支持多种内容类型，真人感输出

---

## 🚀 快速开始

### 1. 环境要求

- **Python**: 3.10+
- **操作系统**: Windows 10/11
- **内存**: 最低 4GB
- **网络**: 需要访问阿里云 API

### 2. 安装依赖

```powershell
# 进入项目目录
cd C:\Users\Administrator\xiaohongshu-content-assistant

# 安装依赖包
pip install fastapi uvicorn pydantic requests

# 或使用 requirements.txt
pip install -r requirements.txt
```

### 3. 配置 API Key

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

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

或创建 `.env` 文件：

```env
API_KEY=sk-your-api-key
API_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
MODEL=qwen-plus
```

### 4. 启动方式

#### 方式一：命令行快速生成

```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
```

#### 方式二：交互式 CLI

```powershell
python main.py
```

按照提示选择内容类型和输入参数。

#### 方式三：API 服务

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

# 服务地址
http://localhost:8000

# API 文档
http://localhost:8000/docs
```

---

## 📡 API 接口说明

### 1. 生成内容

**请求：**
```bash
POST /api/v1/content/generate
Content-Type: application/json

{
  "content_type": "coffee_culture",
  "params": {
    "topic": "周末咖啡探店",
    "cafe_scenario": "独自工作",
    "mood_keywords": "安静,治愈"
  },
  "style": "文艺清新",
  "temperature": 0.7,
  "max_tokens": 2000
}
```

**响应：**
```json
{
  "success": true,
  "data": {
    "title": "推开门的那一刻，时间自动调成了慢放键",
    "content": "全文内容...",
    "tags": ["#手冲咖啡", "#咖啡探店"],
    "word_count": 500,
    "content_type": "coffee_culture"
  }
}
```

### 2. 批量生成

**请求：**
```bash
POST /api/v1/content/generate/batch

{
  "content_type": "coffee_culture",
  "params": {
    "topic": "周末咖啡探店"
  },
  "count": 3,
  "style": "轻松活泼"
}
```

**响应：**
```json
{
  "success": true,
  "data": {
    "versions": [
      {"version": 1, "content": "..."},
      {"version": 2, "content": "..."},
      {"version": 3, "content": "..."}
    ]
  }
}
```

### 3. 内容优化

**请求：**
```bash
POST /api/v1/content/optimize

{
  "content": "原文内容...",
  "instruction": "更像真人、增加细节"
}
```

### 4. 生成标题

**请求：**
```bash
POST /api/v1/content/titles

{
  "content": "正文内容...",
  "count": 5
}
```

### 5. 生成标签

**请求：**
```bash
POST /api/v1/content/tags

{
  "content": "正文内容...",
  "count": 5
}
```

---

## 📋 支持的内容类型

| 类型 | 参数值 | 必需参数 | 可选参数 |
|------|--------|----------|----------|
| 咖啡文化 | `coffee_culture` | topic | cafe_scenario, mood_keywords |
| 产品测评 | `product_review` | product_name | product_info, target_audience, price_range |
| 穿搭分享 | `ootd` | outfit_description | style, occasion, items |
| 生活方式 | `lifestyle` | topic | scenario, mood |
| 美食探店 | `food` | shop_name | shop_info, signature_dishes, price, location |
| 旅行攻略 | `travel` | destination | travel_type, season, budget |
| 知识科普 | `knowledge` | topic | knowledge_point, target_audience |

---

## 🎨 写作风格选项

- `轻松活泼` - 默认风格，适合大多数内容
- `文艺清新` - 适合咖啡、书店等文艺话题
- `幽默风趣` - 适合轻松话题
- `专业干货` - 适合知识科普类
- `温馨治愈` - 适合情感类内容

---

## 📁 项目结构

```
xiaohongshu-content-assistant/
├── api/                        # API 服务层
│   ├── server.py              # FastAPI 服务
│   ├── schemas.py             # 数据模型
│   └── __init__.py
├── core/                      # 核心业务逻辑
│   ├── generator.py           # 内容生成引擎
│   ├── templates.py           # 模板管理
│   └── __init__.py
├── models/                    # AI 模型适配
│   ├── base.py               # LLM 基类
│   ├── openai_compatible.py  # OpenAI 兼容适配器
│   └── __init__.py
├── prompts/                   # Prompt 模板
│   ├── title_prompt.txt      # 标题生成
│   ├── note_prompt.txt       # 正文生成
│   ├── humanize_prompt.txt   # 拟人化优化
│   └── risk_prompt.txt       # 风险检测
├── config.py                  # 配置管理
├── main.py                    # 入口文件
├── requirements.txt           # 依赖列表
├── .env                       # 环境变量
└── README.md                  # 项目文档
```

---

## 🔧 常见问题

### Q1: 安装依赖时报错
```powershell
# 使用清华镜像源
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```

### Q2: API 调用失败
- 检查 API Key 是否正确
- 检查网络连接
- 确认 API 额度是否用完

### Q3: 生成内容乱码
```powershell
# 设置 PowerShell 编码
chcp 65001
```

### Q4: 端口被占用
```powershell
# 更改端口
uvicorn api.server:app --port 8001
```

---

## 📞 技术支持

- 项目地址：`C:\Users\Administrator\xiaohongshu-content-assistant`
- OpenClaw Skill：`C:\Users\Administrator\.openclaw\skills\xiaohongshu-writer`

---

## 📄 许可证

MIT License
