140 lines
2.9 KiB
Markdown
140 lines
2.9 KiB
Markdown
# 新闻稿生成器使用指南
|
||
|
||
## 快速开始
|
||
|
||
### 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` 参数来控制生成效果。 |