报告生成器使用说明
功能概述
本模块提供了日报和周报生成功能，主要特点：
- AI智能筛选：从AI分析结果表获取已筛选的相关内容（是否相关=1）
- 多格式输出：同时生成HTML和Markdown格式的报告
- 钉钉推送：支持自动推送到钉钉群
- 可扩展数据源：支持添加多个数据源（RSS、投诉、API等）
- 灵活模板系统：支持内置HTML模板和外部HTML模板
快速开始
生成日报（24小时内数据）
from applications.reporter.daily import DailyReporter
reporter = DailyReporter()
result = reporter.generate()
print(f"日报已生成:")
print(f" HTML: {result.get('html_path')}")
print(f" Markdown: {result.get('markdown_path')}")
生成周报（7天内数据）
from applications.reporter.weekly import WeeklyReporter
reporter = WeeklyReporter()
result = reporter.generate()
print(f"周报已生成:")
print(f" HTML: {result.get('html_path')}")
print(f" Markdown: {result.get('markdown_path')}")
钉钉推送配置
1. 获取钉钉Webhook地址
- 在钉钉群中，点击"群设置" -> "智能群助手" -> "添加机器人"
- 选择"自定义"机器人
- 设置机器人名称和头像
- 复制Webhook地址（格式：
https://oapi.dingtalk.com/robot/send?access_token=xxx）
2. 配置Webhook地址
方式1：通过环境变量（推荐）
export DINGTALK_WEBHOOK="https://oapi.dingtalk.com/robot/send?access_token=xxx"
方式2：在config.py中配置
DINGTALK_WEBHOOK = "https://oapi.dingtalk.com/robot/send?access_token=xxx"
方式3：在代码中指定
from applications.reporter.daily import DailyReporter
reporter = DailyReporter(dingtalk_webhook="https://oapi.dingtalk.com/robot/send?access_token=xxx")
result = reporter.generate()
3. 控制推送行为
# 生成报告但不推送到钉钉
reporter = DailyReporter()
result = reporter.generate(send_dingtalk=False)
# 不保存Markdown文件
result = reporter.generate(save_markdown=False)
# 同时控制
result = reporter.generate(save_markdown=True, send_dingtalk=True)
4. 钉钉消息格式
- 自动使用Markdown格式发送
- 如果内容过长（超过5000字符），会自动截断并显示摘要
- 包含报告文件路径提示
添加自定义数据源
1. 创建数据源类
数据源类需要继承 DataSource 基类并实现以下方法：
from applications.reporter.base_reporter import DataSource
from typing import List, Dict, Any
from datetime import datetime
class MyCustomDataSource(DataSource):
def fetch_data(self, start_time: datetime, end_time: datetime) -> List[Dict[str, Any]]:
"""获取指定时间范围内的数据"""
# 返回格式：
return [
{
'title': '标题',
'link': '链接',
'summary': '摘要',
'publish_time': '发布时间',
'source_url': '来源URL'
}
]
def get_source_name(self) -> str:
return "数据源名称"
2. 添加到报告生成器
from applications.reporter.daily import DailyReporter
from my_module import MyCustomDataSource
reporter = DailyReporter()
custom_source = MyCustomDataSource(...)
reporter.add_data_source(custom_source)
# 生成报告（会自动包含新数据源的数据）
report_path = reporter.generate()
使用外部HTML模板
1. 创建HTML模板文件
创建外部HTML模板文件（如 custom_template.html）：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>自定义报告模板</title>
<style>
/* 自定义样式 */
body { ... }
</style>
</head>
<body>
<!-- 内容占位符，支持以下格式之一： -->
<!-- {{content}} 或 {content} 或 <!-- content --> -->
{{content}}
</body>
</html>
2. 使用外部模板生成报告
from applications.reporter.daily import DailyReporter
reporter = DailyReporter()
report_path = reporter.generate(template_path="path/to/custom_template.html")
配置说明
AI配置
在 config.py 中配置百度AI API：
BAIDU_AI_CONFIG = {
'api_key': 'your_api_key',
'model': 'ernie-x1-turbo-32k',
}
数据库配置
确保 config.py 中的数据库配置正确：
MYSQL_CONFIG = {
'host': 'your_host',
'port': 3306,
'user': 'your_user',
'password': 'your_password',
'database': 'intelligence_system',
}
输出目录
- 日报：
output/reports/daily/ - 周报：
output/reports/weekly/
报告文件名格式：
- HTML：
daily_report_YYYYMMDD_HHMMSS.html/weekly_report_YYYYMMDD_HHMMSS.html - Markdown：
daily_report_YYYYMMDD_HHMMSS.md/weekly_report_YYYYMMDD_HHMMSS.md
报告内容
生成的报告包含：
- 报告时间信息：生成时间和时间范围
- 数据统计：相关文章数
- 相关新闻列表（从AI分析结果表筛选，是否相关=1）：
- 标题
- 分类
- 标签
- 摘要
- 链接
- 发布时间
- 相关度评分
- 分析说明
如果没有相关数据，会显示：
- 日报：
昨日无汽车后市场相关的新闻 - 周报：
上周无汽车后市场相关的新闻
AI筛选说明
AI会根据以下定义筛选汽车后市场相关内容：
- 汽车维修保养
- 汽车配件
- 汽车改装
- 汽车美容
- 汽车用品
- 汽车金融
- 汽车保险
- 二手车交易
- 汽车租赁
- 汽车检测
- 汽车报废回收
- 汽车相关法律法规和政策
扩展示例
参考 data_source_example.py 查看如何：
- 添加数据库数据源
- 添加外部API数据源
- 实现自定义数据源
注意事项
- 确保数据库连接正常
- 确保AI API配置正确且有足够配额
- 外部模板文件需要包含内容占位符
- 数据源返回的数据格式需要符合规范