TravelContentCreator/README.md

# TravelContentCreator

旅游内容自动创作系统 - Python 后端服务

> 版本: 2.3.0 | 更新日期: 2024-12-10

## 功能概述

- **选题生成** - 基于热点、节日、目标人群生成小红书选题
- **内容生成** - 生成小红书风格的图文笔记正文
- **海报生成** - 自动生成配图海报
- **热点数据** - 多平台热点数据采集 (百度、Bing、小红书、节日日历)

## 快速启动

```bash
# 安装依赖
pip install -r requirements.txt

# 启动服务
PYTHONPATH=. uvicorn api.main:app --host 0.0.0.0 --port 8001

# 测试
curl http://localhost:8001/
curl http://localhost:8001/api/v2/hotspot/baidu?limit=10
```

## API 使用

### AIGC 统一接口

```bash
POST /api/v2/aigc/execute
{
  "engine": "topic_generate",  # topic_generate / content_generate / poster_generate
  "params": {...}
}
```

### 热点数据

```bash
GET /api/v2/hotspot/baidu      # 百度热搜 (含旅游榜)
GET /api/v2/hotspot/bing       # Bing 搜索建议
GET /api/v2/hotspot/calendar   # 节日日历
GET /api/v2/hotspot/travel     # 旅游相关聚合
```

## 项目结构

```
TravelContentCreator/
├── api/                  # FastAPI 应用
│   ├── main.py          # 入口
│   └── routers/         # API 路由
├── domain/              # 领域层 (核心业务)
│   ├── aigc/            # AIGC 引擎
│   ├── hotspot/         # 热点数据
│   ├── prompt/          # Prompt 管理
│   └── poster/          # 海报服务
├── prompts/             # Prompt 模板 (YAML)
├── poster/              # 海报模板
├── config/              # 配置文件
├── libs/                # 外部库 (MediaCrawler)
└── docs/                # 文档
```

## 文档

| 文档 | 说明 |
|-----|------|
| [PROJECT_OVERVIEW.md](docs/PROJECT_OVERVIEW.md) | 项目总览 |
| [PROJECT_STATUS.md](docs/PROJECT_STATUS.md) | 详细状态 |
| [HOTSPOT_MODULE.md](docs/HOTSPOT_MODULE.md) | 热点模块 |
| [NEXT_PHASE_PLAN.md](docs/NEXT_PHASE_PLAN.md) | 下阶段计划 |

## 技术栈

| 组件 | 技术 |
|-----|------|
| Web 框架 | FastAPI |
| AI 模型 | OpenAI GPT-4 |
| 模板引擎 | Jinja2 |
| 图像处理 | Pillow |
| 爬虫 | aiohttp / MediaCrawler |