# etf-quant-report

**Repository Path**: bearcatl/etf-quant-report

## Basic Information

- **Project Name**: etf-quant-report
- **Description**: 全市场ETF量化分析报告 - 四维评分(资金35/量价25/景气25/筹码15) + Gitee Pages 自动部署
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-03
- **Last Updated**: 2026-10-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 全市场ETF量化分析报告

实时 ETF 量化评分与资金流向监控系统。

## 项目简介

本项目是一个全市场 ETF 量化分析报告自动生成系统，通过四维量化评分模型对全市场 ETF 进行实时监测和分析，生成可视化的量化分析报告。

## 评分模型

**四维量化评分体系**（满分 100 分）：

| 维度 | 分值 | 说明 |
|------|------|------|
| 资金流向 | 35分 | 主力资金净流入/流出分析 |
| 量价信号 | 25分 | 成交量与价格趋势信号 |
| 行业景气 | 25分 | 行业板块景气度评估 |
| 筹码结构 | 15分 | 筹码分布与集中度分析 |

## 数据覆盖

- **60只全品类 ETF**：涵盖场内ETF和场外ETF
- **9大指数**：实时行情数据
- **行业板块**：主力资金 TOP9
- **持仓研判**：个性化操作建议

## 技术栈

- **Python 3.x**：核心数据处理
- **Pillow**：图像生成
- **NumPy**：数据计算
- **westock-data-clawhub**：金融数据获取

## 目录结构

```
etf-quant-report/
├── etf_report/                    # 核心报告生成模块
│   ├── generate_board_etf_v10.py  # 主生成脚本
│   └── _kline_cache.json          # K线数据缓存
├── output/                        # 输出目录
│   ├── etf_analysis_engine.py    # 分析引擎
│   └── generate_etf_board_db.py  # 数据库生成
├── docs/                          # GitHub Pages 文档
│   ├── index.html                # 数据展示页面
│   └── llms.txt                   # AI可读数据
├── .github/workflows/             # GitHub Actions
└── README.md                     # 项目说明
```

## 本地运行

### 环境要求

- Python 3.8+
- Pillow
- NumPy

### 安装依赖

```bash
pip install Pillow numpy
npm install -g westock-data-clawhub
```

### 运行生成脚本

```bash
cd etf_report
python generate_board_etf_v10.py
```

### 输出文件

运行后将在 `output/` 目录生成以下文件：

| 文件类型 | 命名格式 | 说明 |
|----------|----------|------|
| 可视化报告 | `全市场ETF量化分析报告_YYYYMMDD_HHMMSS.png` | PNG格式可视化报告 |
| HTML页面 | `etf_report_YYYYMMDD_HHMMSS.html` | AI可读数据页 |
| JSON数据 | `etf_report_data_YYYYMMDD_HHMMSS.json` | 结构化数据 |

## 部署方式

### 方式一：GitHub Pages（推荐）

1. Fork 本仓库
2. 进入仓库设置，启用 GitHub Pages（Source: `gh-pages` branch）
3. GitHub Actions 将在每个交易日盘中每小时自动更新报告

### 方式二：Gitee Pages

详见 [DEPLOY_CN.md](./DEPLOY_CN.md)

1. 创建 Gitee 公开仓库
2. 推送代码到 Gitee
3. 启用 Gitee Pages 服务

## 数据页面

部署完成后访问：`https://your_username.github.io/etf-quant-report/`

## 许可

[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)

## 相关文档

- [AEO部署指南](./AEO_DEPLOY_GUIDE.md)
- [国内部署指南](./DEPLOY_CN.md)
- [集成调试文档](./output/integration_guide.md)