abo/news_agent/USAGE.md

# 新闻稿生成器使用指南

## 快速开始

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

### 2. 配置API密钥
```bash
python setup_config.py
```
选择"1. 设置API密钥"，然后按提示配置各个模型的API密钥。

### 3. 启动应用
```bash
python app.py
```

### 4. 访问应用
打开浏览器访问 `http://127.0.0.1:5000`

## 详细使用说明

### 配置管理

#### 查看当前配置
```bash
python setup_config.py
# 选择 "2. 显示当前配置"
```

#### 导出环境变量文件
```bash
python setup_config.py
# 选择 "3. 导出环境变量文件"
```

### Web界面使用

1. **选择大模型**: 从下拉菜单中选择要使用的AI模型
2. **输入新闻描述**: 在文本框中描述新闻事件的关键信息
3. **选择文案风格**: 选择新闻稿的写作风格（正式、简洁、感性、科技）
4. **上传图片**（可选）: 上传相关的新闻图片
5. **生成新闻稿**: 点击"生成新闻稿"按钮
6. **下载文档**: 系统会自动下载生成的Word文档

### API接口

#### 获取配置信息
```bash
curl http://127.0.0.1:5000/api/config
```

返回JSON格式的配置信息，包括：
- 模型配置
- API密钥状态
- 可用模型列表
- 文案风格选项

## 配置说明

### 模型配置

在 `config.py` 中可以调整以下参数：

```python
MODELS = {
    'openai': {
        'name': 'OpenAI GPT-4',
        'api_key': '',  # API密钥
        'model': 'gpt-4',  # 模型名称
        'max_tokens': 800,  # 最大token数
        'temperature': 0.7  # 温度参数
    }
}
```

### 文案风格

默认支持的文案风格：
- 正式：适合官方新闻稿
- 简洁：适合快速阅读
- 感性：适合情感类新闻
- 科技：适合科技类新闻

### 文档配置

在 `config.py` 中可以调整文档生成参数：

```python
DOCUMENT_CONFIG = {
    'default_filename': 'news.docx',  # 默认文件名
    'image_width': 4,  # 图片宽度（英寸）
    'title': '新闻稿'  # 文档标题
}
```

## 故障排除

### 常见问题

1. **ModuleNotFoundError: No module named 'docx'**
   ```bash
   pip install python-docx
   ```

2. **API密钥未配置错误**
   - 运行 `python setup_config.py` 配置API密钥
   - 或设置环境变量

3. **模型调用失败**
   - 检查API密钥是否正确
   - 检查网络连接
   - 查看控制台错误信息

### 调试模式

应用默认运行在调试模式下，错误信息会显示在控制台和浏览器中。

## 扩展功能

### 添加新模型

1. 在 `config.py` 的 `MODELS` 中添加新模型配置
2. 在 `app.py` 中添加对应的生成函数
3. 在 `generate_news_content` 函数中添加模型调用逻辑

### 自定义文案风格

在 `config.py` 中修改 `STYLES` 列表：

```python
STYLES = ['正式', '简洁', '感性', '科技', '幽默', '专业']
```

### 调整生成参数

在 `config.py` 中调整模型的 `max_tokens` 和 `temperature` 参数来控制生成效果。