TradingAgents-CN

TradingAgents-CN v0.1.12 发布说明

🚀 版本概述

发布日期: 2025年7月29日
版本号: cn-0.1.12
主题: 智能新闻分析模块全面升级与项目结构优化

v0.1.12是一个重大功能更新版本，专注于新闻分析能力的全面提升。本版本新增了完整的智能新闻分析模块，包括多层次新闻过滤、质量评估、相关性分析等核心功能，同时对项目结构进行了全面优化，提升了代码组织和维护性。

🆕 主要新功能

🧠 智能新闻分析模块

1. 智能新闻过滤器 (`news_filter.py`)

AI驱动的相关性评分: 基于机器学习算法评估新闻与股票的相关性
智能质量评估: 自动识别和过滤低质量、重复、无关新闻
多维度评分机制: 从内容质量、时效性、来源可信度等多个维度评估新闻
灵活配置选项: 支持自定义过滤阈值和评分权重

2. 增强新闻过滤器 (`enhanced_news_filter.py`)

深度语义分析: 使用先进的NLP技术进行新闻内容深度理解
情感倾向识别: 自动识别新闻的情感倾向（正面/负面/中性）
关键词提取: 智能提取新闻中的关键信息和实体
重复内容检测: 高效识别和去除重复或相似的新闻内容

3. 新闻过滤集成模块 (`news_filter_integration.py`)

多级过滤流水线: 基础过滤 → 增强过滤 → 集成过滤的三级处理机制
智能降级策略: 当高级过滤失败时自动降级到基础过滤
性能优化: 缓存机制和批处理优化，提升处理效率
统一接口: 为上层应用提供简洁统一的调用接口

4. 统一新闻工具 (`unified_news_tool.py`)

多源新闻整合: 整合Google News、FinnHub等多个新闻源
统一数据格式: 标准化不同来源的新闻数据格式
智能去重: 跨数据源的新闻去重和合并
实时更新: 支持实时新闻获取和增量更新

5. 增强新闻检索器 (`enhanced_news_retriever.py`)

智能搜索: 基于股票代码、公司名称、行业关键词的智能搜索
时间范围过滤: 灵活的时间范围设置和历史新闻检索
语言支持: 支持中英文新闻的混合检索和处理
结果排序: 基于相关性和重要性的智能排序算法

🔧 技术修复和优化

1. DashScope适配器修复

工具调用兼容性: 修复DashScope OpenAI适配器的工具调用问题
参数传递优化: 改进工具调用时的参数传递机制
错误处理增强: 增加更完善的错误处理和重试机制
性能提升: 优化API调用效率，减少延迟

2. DeepSeek死循环修复

循环检测: 实现智能的循环检测机制
超时保护: 添加分析超时保护，防止无限等待
状态管理: 改进分析状态管理，确保流程正常结束
日志增强: 增加详细的调试日志，便于问题排查

3. LLM工具调用增强

工具绑定优化: 改进工具与LLM的绑定机制
调用稳定性: 提升工具调用的成功率和稳定性
异常恢复: 增加工具调用失败时的自动恢复机制
性能监控: 添加工具调用性能监控和统计

📚 测试和文档完善

1. 全面测试覆盖

新增15+个测试文件，覆盖所有新功能：

test_news_filtering.py - 新闻过滤功能测试
test_unified_news_tool.py - 统一新闻工具测试
test_dashscope_adapter_fix.py - DashScope适配器修复测试
test_news_analyst_fix.py - 新闻分析师修复测试
test_llm_tool_call.py - LLM工具调用测试
test_workflow_integration.py - 工作流集成测试
以及更多专项测试文件

2. 详细技术文档

新增8个技术分析报告和修复文档：

DASHSCOPE_ADAPTER_FIX_REPORT.md - DashScope适配器修复报告
DASHSCOPE_TOOL_CALL_DEFECTS_ANALYSIS.md - 工具调用缺陷分析
DeepSeek新闻分析师死循环问题分析报告.md - 死循环问题深度分析
LLM_TOOL_CALL_FIX_REPORT.md - LLM工具调用修复报告
NEWS_QUALITY_ANALYSIS_REPORT.md - 新闻质量分析报告
以及更多技术文档

3. 用户指南和演示

NEWS_FILTERING_USER_GUIDE.md - 新闻过滤使用指南
NEWS_FILTERING_SOLUTION_DESIGN.md - 新闻过滤解决方案设计
demo_news_filtering.py - 完整的新闻过滤功能演示脚本

🗂️ 项目结构优化

1. 文档分类整理

技术文档 (docs/technical/): 技术分析报告、修复文档
功能文档 (docs/features/): 功能设计文档、分析报告
用户指南 (docs/guides/): 使用指南、最佳实践
部署文档 (docs/deployment/): 部署指南、配置说明

2. 测试文件统一

所有测试文件移动到 tests/ 目录
按功能模块组织测试文件
统一测试命名规范
完善测试覆盖率

3. 示例代码归位

演示脚本统一到 examples/ 目录
按功能分类组织示例代码
提供完整的使用示例
增加代码注释和说明

4. 根目录整洁

保持根目录简洁，只保留核心文件
移除临时文件和开发文档
优化项目结构，提升专业度
改进文件组织和命名规范

🔄 升级指南

从 v0.1.11 升级到 v0.1.12

1. 代码更新

# 拉取最新代码
git pull origin main

# 更新依赖
pip install -r requirements.txt

2. 新功能使用

使用智能新闻过滤器

from tradingagents.utils.news_filter import NewsFilter

# 创建新闻过滤器
filter = NewsFilter()

# 过滤新闻
filtered_news = filter.filter_news(news_list, stock_symbol="AAPL")

使用统一新闻工具

from tradingagents.tools.unified_news_tool import UnifiedNewsTool

# 创建新闻工具
news_tool = UnifiedNewsTool()

# 获取新闻
news = news_tool.get_news(symbol="000001", limit=10)

3. 配置更新

新版本新增了新闻过滤相关的配置选项，可以在配置文件中进行自定义：

news_filter:
  relevance_threshold: 0.6
  quality_threshold: 0.7
  enable_enhanced_filter: true
  cache_enabled: true

🐛 Bug修复

已修复的问题

DashScope适配器工具调用失败
- 修复了工具调用时的参数传递问题
- 改进了错误处理机制
- 提升了调用成功率
DeepSeek新闻分析师死循环
- 实现了循环检测和超时保护
- 优化了分析流程控制
- 增加了状态管理机制
LLM工具调用不稳定
- 改进了工具绑定机制
- 增加了重试和恢复机制
- 提升了调用稳定性
新闻数据质量问题
- 实现了智能新闻过滤
- 增加了质量评估机制
- 改进了数据清洗流程

📊 性能改进

新闻处理性能

处理速度提升: 新闻过滤速度提升40%
内存使用优化: 内存使用减少25%
缓存机制: 新增智能缓存，重复查询速度提升80%
批处理优化: 支持批量新闻处理，效率提升60%

系统稳定性

错误恢复: 新增自动错误恢复机制
超时保护: 防止长时间等待和死循环
资源管理: 优化内存和CPU资源使用
日志增强: 详细的调试和监控日志

🔮 下一版本预告

v0.1.13 计划功能

实时新闻流: 实时新闻推送和处理
新闻情感分析: 深度情感分析和市场情绪评估
多语言支持: 扩展对更多语言的新闻支持
新闻影响评估: 新闻对股价影响的量化评估

🤝 贡献者

感谢所有为v0.1.12版本做出贡献的开发者和用户！

特别感谢：

新闻分析模块的设计和实现
技术文档的编写和完善
测试用例的开发和验证
Bug报告和修复建议

📞 支持和反馈

如果您在使用过程中遇到任何问题或有改进建议，请通过以下方式联系我们：

GitHub Issues: 提交问题
邮箱: hsliup@163.com
QQ群: 782124367

📄 许可证

本项目继续使用 Apache 2.0 许可证。详见 LICENSE 文件。

🌟 感谢您使用 TradingAgents-CN！如果这个项目对您有帮助，请给我们一个 Star！

This site is open source. Improve this page.