# protect-quant

**Repository Path**: cyrcc/protect-quant

## Basic Information

- **Project Name**: protect-quant
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-13
- **Last Updated**: 2026-09-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 股票量化辅助分析系统

基于趋势跟踪策略的 A 股量化分析工具，支持信号扫描和历史回测。

## 环境要求

- Python >= 3.10
- 安装依赖：`pip install -r requirements.txt`

## 快速开始

### 扫描今日信号

```bash
python main.py scan              # 默认双均线策略扫描沪深300
python main.py scan -s macd      # 用 MACD 策略
python main.py scan -s donchian  # 用唐奇安通道策略
```

### 运行回测

```bash
python main.py backtest          # 用配置文件中的策略回测
python main.py backtest --all    # 三种策略全跑，对比排名
```

## 配置文件 config.yaml

```yaml
data:
  source: akshare          # 数据源（免费）
  cache_dir: data/cache/

strategy:
  name: ma_cross           # 默认策略: ma_cross / donchian / macd
  params:
    fast: 5                # 双均线快线周期
    slow: 20               # 双均线慢线周期

risk:
  stop_loss: 0.05          # 止损比例 5%
  max_positions: 5         # 最多同时持仓数

backtest:
  start: "2024-01-01"      # 回测起始日期
  end: "2026-08-08"        # 回测截止日期
  initial_capital: 100000  # 初始资金
  universe: "hs300"        # 股票池：沪深300
```

## 三种策略

| 策略 | 命令参数 | 原理 |
|------|----------|------|
| 双均线交叉 | ma_cross | 快线上穿慢线买入，下穿卖出 |
| 唐奇安通道 | donchian | 收盘突破 N 日最高买入，跌破 N 日最低卖出 |
| MACD | macd | DIF 上穿 DEA 买入，下穿卖出 |

## 输出

- 终端：信号表格（绿=买入，红=卖出）或回测排名
- CSV：`output/signals_YYYY-MM-DD.csv` 和 `output/backtest_results.csv`

## 运行测试

```bash
python -m pytest tests/ -v    # 44 个测试
```

## 目录结构

```
protect/
├── main.py              # CLI 入口
├── config.yaml          # 配置文件
├── data/                # 数据获取与缓存
├── strategy/            # 策略实现（基类 + 三种策略）
├── backtest/            # 回测引擎
├── risk/                # 风控（止损 + 仓位管理）
├── signals/             # 信号输出
├── tests/               # 测试
└── output/              # 输出文件
```