MND-IA/QUICKSTART.md
2025-12-31 19:58:09 +08:00

3.9 KiB
Raw Blame History

🚀 MND-IA 快速开始指南

安装依赖

pip install -r requirements.txt

核心依赖说明:

  • akshare: A股行情数据获取
  • cloudscraper: 绕过 Cloudflare 防护的爬虫工具
  • beautifulsoup4: HTML 解析
  • pandas, numpy: 数据处理

运行测试

1. 测试核心模块World Book

python core/world_book.py

2. 测试 Agent Skills

# 测试量化模块
python skills/quant.py

# 测试情报分析
python skills/analyst.py

# 测试策略师
python skills/strategist.py

# 测试基金经理
python skills/pm.py

# 测试审计员
python skills/auditor.py

# 测试新闻联播爬虫
python skills/crawler.py

3. 运行完整系统

# 测试模式(使用模拟数据)
python main.py --mode test --no-crawler

# 测试模式(使用爬虫抓取新闻联播)
python main.py --mode test

# 每日批处理模式(自动爬取新闻)
python main.py --mode daily --capital 1000000

# 盘后审计模式
python main.py --mode audit

系统架构

MND-IA/
├── core/              # 共享内核
│   ├── world_book.py  # WorldBook 核心类
│   ├── asset_map.json # 资产映射表
│   └── macro_matrix.json # 宏观因子矩阵
├── skills/            # Agent 技能群
│   ├── analyst.py     # Skill A: 情报分析师
│   ├── quant.py       # Skill B: 量化研究员
│   ├── strategist.py  # Skill C: 宏观策略师
│   ├── pm.py          # Skill D: 基金经理
│   ├── auditor.py     # Skill E: 复盘审计员
│   └── crawler.py     # Skill F: 新闻联播爬虫
├── data/              # 数据存储
├── logs/              # 日志文件
└── main.py            # 主调度程序

数据流示意

[新闻联播] ──→ Crawler (Skill F) ──→ 新闻文本
                                        ↓
                                    Analyst ──→ Narrative_JSON
                                        ↓
[行情] ──→ Quant ──→ Market_Data ──→ Strategist ──→ WorldBook
                                                       ↓
                                              PM ──→ Trust Index ──→ Orders
                                                       ↑
                                              Auditor (复盘)

核心概念

Trust Index 公式

TrustIndex = (Score_narrative × 0.6 + Score_flow × 0.4) - Penalty

一票否决: 
if Narrative > 80 and Flow < 30:
    Penalty = 100

叙事生命周期

  1. incubation (潜伏期): 新闻刚出现,市场未反应
  2. fermentation (发酵期): 政策出台,市场开始关注
  3. realization (兑现期): Level A 重大利好,资金涌入
  4. decay (衰退期): 热度下降,逐步退出

下一步

  1. 配置新闻数据源(可接入财联社、东方财富等 API 已实现新闻联播爬虫
  2. 配置 LLM如 GLM-4 或 Claude-3.5)用于 Analyst 增强
  3. 实现实盘交易接口(如东方财富、同花顺)
  4. 部署定时任务(每日 08:30 自动执行)
  5. 添加更多新闻源(如财联社快讯、部委官网等)

常见问题

Q: akshare 获取数据失败? A: 确保网络连接正常,某些 API 有频率限制。

Q: 爬虫无法获取新闻联播? A:

  1. 检查网站是否可访问(可能被墙或维护)
  2. 查看 data/news_cache/ 目录下的缓存文件
  3. 手动测试:python skills/crawler.py
  4. 新闻联播通常 20:00 后更新,提前爬取会返回空

Q: cloudscraper 安装失败? A:

pip install --upgrade pip
pip install cloudscraper requests[security] pyparsing

Q: 如何添加新的 ETF A: 编辑 core/asset_map.json,在对应板块添加 ETF 代码。

Q: 如何调整 Trust Index 公式权重? A: 修改 skills/pm.py 中的 calculate_trust_index() 方法。

许可证

MIT License