一个基于人工智能的股票分析智能助手，提供多维度股票分析和投资决策支持。
📦 当前版本: v0.5.0 🔄 最新更新: 2025-07-28 📋 更新日志: CHANGELOG.md
🚀 主要功能
📊 多维度股票分析
- 技术分析：趋势、动量、支撑阻力位分析
- 基本面分析：财务指标、估值模型、DCF分析
- 新闻情绪分析：实时新闻监控和情绪分析
- 全球市场分析：宏观经济指标和全球市场趋势
- 综合分析：多因子权重分配和蒙特卡洛模拟
🖥️ 多种使用方式
- 桌面应用：基于 PyQt6 的独立桌面应用
- Web UI：基于 Streamlit 的 Web 界面
- 命令行：交互式命令行界面
- MCP 服务器：Model Context Protocol 服务器
📈 支持市场
- 中国 A 股 (cn)
- 美国股市 (us)
- 香港股市 (hk)
🛠️ 安装
环境要求
- Python 3.8+
- macOS/Linux/Windows
安装依赖
# 克隆项目 git clone <repository-url> cd wff_agent # 安装依赖 pip install -r requirements.txt # 或者使用 conda conda create -n wff_agent python=3.11 conda activate wff_agent pip install -r requirements.txt
环境变量配置
# 新闻 API 密钥 export NEWS_API_KEY=your_news_api_key # Alpha Vantage API 密钥 export ALPHA_VANTAGE_API_KEY=your_alpha_vantage_key # DeepSeek API 密钥 export DEEPSEEK_API_KEY=your_deepseek_key export DEEPSEEK_BASE_URL=https://api.deepseek.com/v1
🎯 使用方法
1. 桌面应用 (推荐)
# 运行桌面应用
python build_desktop_app.py功能特点：
-
图形化界面，操作简单
-
实时进度显示
-
多标签页结果展示
-
支持历史分析结果加载
-
参数可视化调节
2. Web UI
# 运行 Web UI
python -m src.wff_agent.web_ui功能特点：
- 基于 Streamlit 的现代化界面
- 实时数据更新
- 响应式设计
- 支持多用户访问
3. 交互式命令行
# 运行交互式对话
python -m src.wff_agent.interactive_dialogue功能特点：
- 命令行交互界面
- 逐步参数设置
- 详细分析过程展示
4. MCP 服务器
# 运行 MCP 服务器
python -m src.wff_agent.mcp_server功能特点：
- Model Context Protocol 支持
- 工具函数集成
- 可扩展架构
📋 分析类型
1. 综合分析 (ComprehensiveAnalysisAgent)
- 多因子权重分配
- 蒙特卡洛模拟
- 风险收益比计算
- 操作建议生成
2. 技术分析 (TechAnalysisAgent)
- 趋势分析
- 动量指标
- 支撑阻力位
- 技术形态识别
3. 基本面分析 (FundamentalAnalysisAgent)
- 财务指标计算
- DCF 估值模型
- 自由现金流分析
- 估值比率分析
4. 新闻情绪分析 (NewsAnalysisAgent)
- 实时新闻监控
- 情绪分析
- 事件影响评估
- 市场反应预测
5. 全球市场分析 (GlobalMarketAnalysisAgent)
- 宏观经济指标
- 全球市场趋势
- 汇率影响分析
- 地缘政治风险
🏗️ 项目结构
wff_agent/
├── src/wff_agent/
│ ├── agents/ # AI 代理模块
│ ├── datasource/ # 数据源模块
│ ├── utils/ # 工具函数
│ ├── workflows/ # 工作流模块
│ ├── build_desktop_app.py # 桌面应用
│ ├── web_ui.py # Web UI
│ ├── interactive_dialogue.py # 交互式对话
│ └── mcp_server.py # MCP 服务器
├── reports/ # 分析报告输出
├── documents/ # 文档
├── requirements.txt # 依赖包
└── README.md # 项目说明
🔧 构建 macOS 应用
# 构建 macOS .app 文件
python build_macos_app.py构建完成后会在 dist/ 目录生成 wff.app 文件。
📊 示例输出
综合决策报告示例
### 综合决策报告：中国平安（601318.SH）
#### 当前信息
- 股票价格：53.65元
- 股票代码：601318
- 市场：中国A股（cn）
- 日期：2025-06-09
#### 多因子权重分配
| 因子类别 | 权重 | 子因子 | 权重 |
|---------|------|--------|------|
| 技术面 | 50% | 趋势 | 30% |
| | | 动量 | 20% |
| 基本面 | 30% | 估值 | 20% |
| | | 质量 | 10% |
| 市场情绪 | 20% | - | - |
#### 蒙特卡洛模拟结果
- 上涨概率：55%
- 下跌概率：30%
- 震荡概率：15%
#### 操作建议
- 短期投资者：轻仓介入（仓位不超过40%）
- 长期投资者：持有，关注业绩改善
🤝 贡献
欢迎提交 Issue 和 Pull Request！
📄 许可证
本项目采用 MIT 许可证。
⚠️ 免责声明
本工具仅用于学习和研究目的，不构成投资建议。投资有风险，入市需谨慎。请根据个人风险偏好和投资目标做出决策。