Files
aiagents-stock/docs/智瞰龙虎历史报告功能说明.md

213 lines
6.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 智瞰龙虎 - 历史报告功能增强说明
## 📅 更新日期
2024年10月20日
## 🎯 功能概述
本次更新为智瞰龙虎系统新增了完整的历史报告存储和查询功能,参照股票分析的历史记录实现,实现了以下增强:
## ✨ 新增功能
### 1. 完整报告存储
- **结构化数据保存**:将完整的分析结果以JSON格式保存到数据库
- **包含内容**
- 🤖 AI分析师团队报告(5位分析师的完整分析)
- 📊 数据概况(龙虎榜记录、涉及股票、游资等统计)
- 🏆 AI智能评分排名(完整的评分数据)
- 📝 最终综合报告
- 🎯 推荐股票列表
- ⏰ 分析时间戳
### 2. 增强的历史报告查询界面
- **报告列表展示**
- 显示最近50条历史报告
- 按时间倒序排列
- 展示报告ID、分析时间、数据日期范围
- **完整报告详情**
每条历史报告可展开查看以下内容:
#### 📝 报告摘要
- 简要概述本次分析的重点
#### 🎯 推荐股票
- 完整的推荐股票列表
- 包含股票代码、名称、净流入、推荐理由、确定性、持有周期
- 表格化展示,支持排序
#### 🤖 AI分析师团队报告
可展开查看5位AI分析师的完整分析:
- 🎯 **游资行为分析师** - 游资操作风格和进出特征
- 📈 **个股潜力分析师** - 潜力股挖掘和上涨概率分析
- 🔥 **题材追踪分析师** - 热点题材识别和持续性判断
- ⚠️ **风险控制专家** - 高风险股票识别和陷阱预警
- 👔 **首席策略师** - 综合研判和最终推荐
#### 🏆 AI智能评分排名
- 显示TOP10股票的综合评分
- 包含资金含金量、净买入额、卖出压力、机构共振等维度
#### 📊 数据概况
- 龙虎榜记录数
- 涉及股票数
- 涉及游资数
### 3. 历史报告操作功能
- **📋 加载到分析页**:将历史报告重新加载到"龙虎榜分析"标签页,方便重新查看完整的图表和可视化
- **📥 导出为PDF**:(功能预留)支持将历史报告导出为PDF文档
## 🔧 技术实现
### 数据库层 (longhubang_db.py)
```python
# 增强的保存函数
def save_analysis_report(data_date_range, analysis_content,
recommended_stocks, summary, full_result=None):
# 支持字典自动转JSON
# 保存完整的结构化数据
```
```python
# 增强的查询函数
def get_analysis_report(report_id):
# 自动解析JSON内容
# 返回结构化的报告数据
```
### 引擎层 (longhubang_engine.py)
```python
# 构建完整的分析内容
full_analysis_content = {
"agents_analysis": agents_results,
"data_info": results["data_info"],
"scoring_ranking": scoring_df.to_dict('records'),
"final_report": final_report,
"timestamp": results["timestamp"]
}
# 保存到数据库
report_id = self.database.save_analysis_report(
data_date_range=data_date_range,
analysis_content=full_analysis_content,
recommended_stocks=recommended_stocks,
summary=final_report.get('summary', '')
)
```
### UI层 (longhubang_ui.py)
- 完全重写 `display_history_tab()` 函数
- 使用展开面板 (expander) 组织内容
- 支持动态加载报告详情
- 实现报告加载到分析页功能
## 📖 使用说明
### 查看历史报告
1. 进入智瞰龙虎模块
2. 点击"历史报告"标签页
3. 查看报告列表,点击任意报告展开查看详情
### 重新加载历史报告
1. 在历史报告详情中点击"📋 加载到分析页"按钮
2. 切换到"龙虎榜分析"标签页
3. 查看完整的分析结果和可视化图表
### 查看AI分析师报告
1. 在历史报告详情中找到"🤖 AI分析师团队报告"部分
2. 点击各个分析师的展开面板
3. 查看详细的分析内容
## 🔄 与股票分析功能的对比
| 功能 | 股票分析 | 智瞰龙虎(修复后) |
|------|----------|-------------------|
| 保存完整分析结果 | ✅ | ✅ |
| 历史记录查询 | ✅ | ✅ |
| 详细内容展示 | ✅ | ✅ |
| AI分析师报告 | ✅ | ✅ |
| 评分排名展示 | ✅ | ✅ |
| 推荐股票列表 | ✅ | ✅ |
| 加载历史报告 | ✅ | ✅ |
## 📊 数据存储结构
### longhubang_analysis 表
```sql
CREATE TABLE longhubang_analysis (
id INTEGER PRIMARY KEY AUTOINCREMENT,
analysis_date TEXT, -- 分析时间
data_date_range TEXT, -- 数据日期范围
analysis_content TEXT, -- 完整分析内容(JSON
recommended_stocks TEXT, -- 推荐股票列表(JSON
summary TEXT, -- 报告摘要
created_at TEXT DEFAULT CURRENT_TIMESTAMP
)
```
### analysis_content JSON结构
```json
{
"agents_analysis": {
"youzi": {"analysis": "...", "timestamp": "..."},
"stock": {"analysis": "...", "timestamp": "..."},
"theme": {"analysis": "...", "timestamp": "..."},
"risk": {"analysis": "...", "timestamp": "..."},
"chief": {"analysis": "...", "timestamp": "..."}
},
"data_info": {
"total_records": 100,
"total_stocks": 50,
"total_youzi": 30,
"summary": {...}
},
"scoring_ranking": [
{
"排名": 1,
"股票名称": "...",
"股票代码": "...",
"综合评分": 85.5,
...
}
],
"final_report": {
"title": "...",
"summary": "...",
...
},
"timestamp": "2024-10-20 15:30:00"
}
```
## 🎉 优势和特点
1. **数据完整性**:保存了所有分析结果,不会丢失任何信息
2. **方便查询**:可以随时查看历史分析报告,追踪分析效果
3. **复用功能**:可以将历史报告重新加载,无需重新分析
4. **结构化存储**:使用JSON格式存储,便于解析和展示
5. **向后兼容**:对旧的报告也能正常显示(降级到原始内容展示)
## 📝 注意事项
1. **数据库兼容性**:新旧版本的报告都可以正常查看
2. **性能优化**:历史报告列表限制显示50条,避免加载过慢
3. **存储空间**:完整的分析结果占用空间较大,建议定期清理旧报告
4. **JSON解析**:如果报告内容无法解析为JSON,会降级显示原始文本
## 🚀 后续优化方向
1. **PDF导出功能**:实现历史报告的PDF导出
2. **报告对比功能**:支持对比不同日期的分析报告
3. **搜索过滤功能**:按股票代码、日期范围搜索历史报告
4. **性能分析功能**:统计推荐股票的准确率和收益率
5. **批量管理功能**:支持批量删除、导出历史报告
## 🐛 已知问题
## 📧 反馈与建议
如有问题或建议,请在项目中提交Issue。
---
**更新完成!**