LEI Scanner - 快速演示启动指南

🚀 一键启动（3 步）

第 1 步：初始化数据库

在 /workspace/lei_scanner 目录运行：

python3 init_demo.py

输出应该是这样：

╔════════════════════════════════════════════════════════════╗║     LEI Scanner - 演示数据初始化                            ║╚════════════════════════════════════════════════════════════╝
📊 创建数据表...✅ 表创建完成
📈 添加示例股票（美股）...✅ 添加了 8 个美股
📈 添加示例股票（A股）...✅ 添加了 5 个 A 股
⚡ 添加示例事件...✅ 添加了 8 个示例事件
╔════════════════════════════════════════════════════════════╗║  ✅ 数据库初始化完成！

第 2 步：安装依赖

pip install Flask Flask-CORS

第 3 步：启动 Web 服务器

python3 web_server.py

输出应该是这样：

 * Serving Flask app 'web_server' * Debug mode: on * Running on http://127.0.0.1:5000

🌐 打开仪表板

在浏览器打开：

http://localhost:5000

或

http://127.0.0.1:5000

📊 你会看到什么

✅ 实时观察列表（Watchlist Tab）

✅ 实时事件（Events Tab）

• price_breakout - AAPL 于 2026-09-30 突破高点 - 高级别
• setup_formed - NVDA 于 2026-09-30 形成设置点 - 中级别
• volume_surge - TSLA 于 2026-09-30 成交量激增 - 中级别
• ... 更多事件

✅ 统计数据（Statistics Tab）

• 按状态分布：

  • RUNNING: 4 只
  • TRIGGERED: 3 只
  • SETUP: 3 只
  • WATCH: 1 只
  • DAMAGED: 2 只

• 市场分布：

  • 美股：8 只
  • A 股：5 只

• 最近 24 小时事件：8 个

🎛️ 仪表板功能

市场切换

顶部有两个按钮：

• US Market - 显示所有美股数据
• A-Share Market - 显示所有 A 股数据

实时刷新

页面每 5 分钟自动刷新一次数据

颜色编码

• 🟢 RUNNING - 绿色（进行中）
• 🔴 TRIGGERED - 红色（已触发）
• 🟡 SETUP - 黄色（设置中）
• ⚪ WATCH - 灰色（观察中）
• 💀 DAMAGED - 黑色（损坏）
• ⭕ DEAD - 已清除

🔄 后续操作

运行实时扫描

如果你想用真实数据运行扫描：

# 扫描美股python3 main.py scan --market US
# 扫描 A 股python3 main.py scan --market A_SHARE
# 同时扫描两个市场python3 main.py scan

查看监视列表

python3 main.py watchlist

查看系统状态

python3 main.py status

🛠️ 故障排除

问题 1：ModuleNotFoundError: No module named 'flask'

解决方案：

pip install Flask Flask-CORS

问题 2：Address already in use（端口被占用）

解决方案：改用其他端口

python3 web_server.py 8080# 然后访问 http://localhost:8080

问题 3：数据库为空

解决方案：重新初始化

rm data.db  # 删除旧数据库python3 init_demo.py  # 重新初始化

问题 4：页面显示空白

解决方案：

1. 检查浏览器控制台（F12 → Console）是否有错误
2. 确保 web_server.py 正在运行（检查终端输出）
3. 尝试硬刷新：Ctrl + Shift + R（Windows/Linux）或 Cmd + Shift + R（Mac）

📂 文件结构

/workspace/lei_scanner/├── dashboard.html          # 仪表板前端（HTML + CSS + JS）├── api.py                  # REST API（Flask 路由）├── web_server.py           # Web 服务器启动器├── init_demo.py            # 数据库初始化脚本 ✨├── config.py               # 配置文件├── models.py               # 数据模型├── indicators.py           # 技术指标计算├── data_fetch.py           # 数据获取（Tushare + yfinance）├── filters.py              # 流动性过滤器├── scanner.py              # 主扫描引擎├── reporter.py             # 报告生成器├── main.py                 # CLI 界面├── data.db                 # SQLite 数据库（自动创建）└── QUICK_DEMO_START.md     # 本文件

💡 使用场景

场景 1：快速演示（2 分钟）

python3 init_demo.pypython3 web_server.py# 打开浏览器 → http://localhost:5000

场景 2：实时监控（生产环境）

python3 init_demo.py  # 第一次初始化python3 main.py scan  # 获取最新数据python3 web_server.py  # 启动服务器

场景 3：定时扫描（后台运行）

# Linux/Mac: 使用 cron# crontab -e# 0 9,15 * * 1-5 cd /workspace/lei_scanner && python3 main.py scan
# Windows: 使用任务计划程序# 每天 09:00 和 15:00 运行 main.py scan

📞 支持

• 文档：查看 /workspace/lei_scanner/README.md
• 架构：查看 /workspace/lei_scanner/STRUCTURE.md
• 部署：查看 /workspace/lei_scanner/DEPLOYMENT.md

现在就开始吧！🎯

Run: python3 init_demo.py && python3 web_server.py

Then open: http://localhost:5000