abo/news_agent/USAGE.md

新闻稿生成器使用指南

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 配置API密钥

python setup_config.py

选择"1. 设置API密钥"，然后按提示配置各个模型的API密钥。

3. 启动应用

python app.py

4. 访问应用

打开浏览器访问 http://127.0.0.1:5000

详细使用说明

配置管理

查看当前配置

python setup_config.py
# 选择 "2. 显示当前配置"

导出环境变量文件

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

Web界面使用

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

API接口

获取配置信息

curl http://127.0.0.1:5000/api/config

返回JSON格式的配置信息，包括：

• 模型配置
• API密钥状态
• 可用模型列表
• 文案风格选项

配置说明

模型配置

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

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

文案风格

默认支持的文案风格：

• 正式：适合官方新闻稿
• 简洁：适合快速阅读
• 感性：适合情感类新闻
• 科技：适合科技类新闻

文档配置

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

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

故障排除

常见问题

1. ModuleNotFoundError: No module named 'docx'

   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 列表：

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

调整生成参数

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