# Chanlun-ETF-Quant

**Repository Path**: lilonghua/Chanlun-ETF-Quant

## Basic Information

- **Project Name**: Chanlun-ETF-Quant
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-29
- **Last Updated**: 2026-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🦞 ChanTheory ETF · 基于东方财富妙想技能包的缠论智能量化系统

[English](README_EN.md) | [效果演示](#效果演示) | [快速启动](#快速启动) | [功能特性](#功能特性)

---

> **首个深度整合东方财富妙想 AI 技能生态的缠论 ETF 分析开源项目。**
>
> 缠论 × 妙想技能包（选股/自选/搜索/量化） × 景气度 × 网格策略 —— 五维一体，用机构级数据打造散户量化工作站。

[![Stars](https://img.shields.io/github/stars/evoo-Proxy/chan-theory-h5?style=social)](https://github.com/evoo-Proxy/chan-theory-h5/stargazers)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![数据源](https://img.shields.io/badge/数据源-东方财富妙想-FF5722?style=flat-square)](https://dl.dfcfs.com/m/itc4)
[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
[![React](https://img.shields.io/badge/React-18-blue.svg)](https://react.dev/)

---

## 🎯 解决什么问题

A 股散户炒 ETF，最头疼三件事：

1. **缠论太难学** —— 理论复杂，笔/线段/中枢/背驰手工画图费时费力，还容易画错
2. **基本面靠感觉** —— 行业景气度、政策导向、估值分位，没有系统化的研判框架
3. **数据分散** —— K线、主力资金、公告、研报分散在各个平台，拼凑分析效率极低

**ChanTheory ETF 基于东方财富妙想技能包，接入权威数据，让散户也能用机构级工具分析 ETF。**

---

## 🌟 为什么选择 ChanTheory ETF

| 对比项 | 手动分析 / 其他工具 | ChanTheory ETF |
|--------|---------------------|----------------|
| **数据源** | 东方财富网页手动查 | 东方财富妙想 API，实时权威数据 |
| **缠论** | 人工画图，费时易错 | 引擎自动识别，7步完整流程 |
| **景气度** | 凭感觉判断 | 五维量化模型，雷达图直观 |
| **选股** | 条件筛选繁琐 | AI 技能 + 四维因子，一键TOP10 |
| **数据成本** | 免费但低效 | 每日300次免费额度，够个人研究 |

---

## 🤖 东方财富妙想技能包 · 深度集成

本项目深度集成东方财富妙想 AI 技能生态，数据与分析能力均来自这一权威平台：

| 妙想技能 | 本项目中的应用 |
|----------|---------------|
| **mx-xuangu** | 智能选股：四维因子 × 预设策略 × 自定义筛选 |
| **mx-zixuan** | 自选管理：持仓市值实时追踪、盈亏核算 |
| **mx-search** | 信息检索：公告/研报/新闻一站式获取 |
| **mx-moni** | 模拟交易：组合管理、买入卖出信号记录 |

> 妙想技能包（东方财富官方）：[https://dl.dfcfs.com/m/itc4](https://dl.dfcfs.com/m/itc4) — 每日 300 次免费 API 调用，企业用户可申请商用 Key。

---

## 🖥️ 效果演示

> 📹 完整演示视频（2分45秒）：[【全程实战】基于妙想技能包的缠论ETF量化系统](https://www.bilibili.com/video/BV1egdvBZEuv/)

---

## 📊 功能特性

### 📐 缠论结构分析
- 自动识别笔、线段、中枢、背驰
- 标注一买/二买/三买，一卖/二卖/三卖
- 支持日线、60分钟、30分钟、周线四周期切换
- 关键支撑位 / 压力位标注
- 走势分类与应对预案
- 📥 分析报告一键导出（打印PDF）
- 🔔 买卖点预警规则设置

### 🌡️ 行业景气度打分
- **五维度量化模型**：供需格局、政策导向、业绩表现、估值分位、资金流向
- SVG 雷达图可视化
- 12期景气度趋势图
- 拐点预判 + 持续性评级

### 📊 网格策略
- 基于波动率的自适应网格参数
- 止损/止盈建议

### 💰 资金研判
- 主力资金流向分析、DDX 指标追踪

### 🔍 AI 智能选股（妙想技能）
- 四维因子：资金面 × 技术面 × 基本面 × 景气度
- 预设策略：资金龙头 / 技术突破 / 低估值高息 / 景气赛道
- 自定义筛选 + 行业赛道过滤
- 结果页 TOP10，点击跳转完整分析报告

### 💼 持仓管理（妙想技能）
- 实时持仓市值、盈亏核算
- 账户资产全景展示

### 🔔 智能预警
- Cron 定时自动检查买卖点
- PushPlus / Server酱 推送通知

### 🎨 三套专业主题
- 简约白 / 科技黑 / 商务蓝，随时切换

---

## 🏗️ 技术架构

```
┌──────────────────────────────────────────────────────────┐
│                   H5 前端 (React 18 + Vite)               │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐  │
│  │ 缠论 K线图表  │ │ 景气度雷达图  │ │ AI 智能选股      │  │
│  │ lightweight  │ │ 五维度量化    │ │ 妙想 mx-xuangu  │  │
│  │ -charts      │ │              │ │                  │  │
│  └──────────────┘ └──────────────┘ └──────────────────┘  │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐  │
│  │ 持仓管理      │ │ 预警系统     │ │ 网格策略回测     │  │
│  │ 妙想 mx-zixuan│ │              │ │                  │  │
│  └──────────────┘ └──────────────┘ └──────────────────┘  │
└──────────────────────────┬───────────────────────────────┘
                           │ REST API (Express :3099)
┌──────────────────────────┴───────────────────────────────┐
│                    Node.js 后端                           │
│  ┌───────────────────────────────────────────────────┐   │
│  │     缠论引擎 (server/chan/engine.js)             │   │
│  │  K线 → 分型 → 笔 → 线段 → 中枢 → 背驰            │   │
│  └───────────────────────────────────────────────────┘   │
│  ┌─────────────┐ ┌──────────────┐ ┌─────────────────┐  │
│  │ 景气度分析   │ │ 网格分析      │ │ 资金分析         │  │
│  ├─────────────┤ ├──────────────┤ ├─────────────────┤  │
│  │ mx-zixuan   │ │ mx-xuangu    │ │ mx-search       │  │
│  │ 持仓管理     │ │ AI 选股      │ │ 资讯检索        │  │
│  └─────────────┘ └──────────────┘ └─────────────────┘  │
└──────────────────────────┬───────────────────────────────┘
                           │ MX API（东方财富妙想）
┌──────────────────────────┴───────────────────────────────┐
│               东方财富 · 妙想开放平台                      │
│   K线 / 财务 / 资金流向 / 选股条件 / 公告 / 研报         │
│   官方地址：https://dl.dfcfs.com/m/itc4                 │
└──────────────────────────────────────────────────────────┘
```

---

## 📁 项目结构

```
chan-theory-h5/
├── client/                         # React 18 H5 前端
│   ├── src/
│   │   ├── App.jsx                 # 主应用 + 路由
│   │   ├── components/
│   │   │   ├── Layout.jsx          # 导航 + 三主题切换
│   │   │   ├── HomePage.jsx        # 首页概览
│   │   │   ├── StockAnalysis.jsx    # 缠论结构分析核心
│   │   │   ├── StockSelect.jsx      # AI 智能选股（妙想技能）
│   │   │   ├── Page.jsx             # 景气度/网格/资金/风险
│   │   │   ├── Portfolio.jsx         # 持仓管理（妙想技能）
│   │   │   └── Alerts.jsx            # 预警设置
│   │   ├── api/index.js             # API 调用封装
│   │   ├── constants.js             # 核心 ETF 列表
│   │   └── data/DataProvider.jsx    # 数据层 + 缓存
│   └── vite.config.js
├── server/                         # Node.js API 服务
│   ├── chan/
│   │   ├── engine.js               # 缠论引擎 v2（核心）
│   │   ├── analysis.js             # 综合分析
│   │   ├── xuangu.js              # AI 选股（妙想 mx-xuangu）
│   │   ├── portfolio.js            # 持仓（妙想 mx-zixuan）
│   │   ├── replace_capital.js       # 主力资金分析
│   │   └── replace_risk.js          # 风险量化
│   └── index.js                    # Express 路由入口
├── docs/
├── README.md
└── LICENSE (MIT)
```

---

## 🔑 核心 ETF 标的

| 代码 | 名称 | 行业 |
|------|------|------|
| 159326 | 电网设备ETF | 电力设备 |
| 515880 | 通信ETF | 通信服务 |
| 512480 | 半导体ETF | 半导体 |
| 510300 | 沪深300ETF | 大盘蓝筹 |
| 588000 | 科创50ETF | 硬科技 |

---

## ⚡ 快速启动

### 1. 克隆项目

```bash
git clone https://github.com/evoo-Proxy/chan-theory-h5.git
cd chan-theory-h5
```

### 2. 安装依赖

```bash
cd client && npm install
cd ../server && npm install
```

### 3. 配置东方财富 API Key

> 🔑 **获取 API Key**：[东方财富妙想开放平台](https://dl.dfcfs.com/m/itc4)（每日 300 次免费额度）

```bash
# Linux/macOS
export MX_APIKEY=your_api_key_here

# Windows (PowerShell)
$env:MX_APIKEY="your_api_key_here"
```

### 4. 启动服务

```bash
# 终端 1：后端 API（端口 3099）
cd server && npm start

# 终端 2：前端（端口 5173）
cd client && npm run dev
```

访问 **http://localhost:5173**

---

## 🛠️ 高级配置

### 生产环境部署

```bash
# 构建前端
cd client && npm run build

# Nginx 部署 dist 目录，或使用内置 static.js（带 HTTP Basic Auth）
node server/static.js   # 端口 5173，带认证
```

### 预警推送配置

支持 PushPlus / Server酱，将 Token 填入预警设置界面。

---

## ⚠️ 数据来源与额度说明

本项目数据来源于**东方财富·妙想开放平台**（[获取 API Key](https://dl.dfcfs.com/m/itc4)）。

- 免费额度：**每日 300 次** API 调用
- 缠论完整分析每次约 8-12 次调用，高频使用建议充值或申请商用 Key
- 额度耗尽后缠论数据返回历史 mock 数据（标注日期），属平台限制非本项目故障
- 如需更高频次，请联系东方财富官方购买商用配额

---

## ⚠️ 免责声明（必读）

**本工具仅供学习研究与技术交流使用，不构成任何投资建议。**

- 本工具基于公开数据进行分析，所有分析结果仅供参考
- ETF 投资有风险，决策自负，任何盈亏与项目开发者无关
- 请在实际投资前充分了解产品风险，必要时咨询专业投顾
- 项目团队不对因使用本工具而造成的任何损失承担责任

---

## 🤝 如何贡献

**Bug 反馈 / 功能建议 / 代码贡献** — 欢迎提交 Issue 和 PR！

特别欢迎以下贡献：
- 🌐 更多市场数据接入（如港股、美股）
- 🎨 主题皮肤
- 📊 更多选股策略
- 📈 量化策略回测模块

---

## 📜 License

MIT © 龙虾 🦞