Metadata-Version: 2.4
Name: dragon-quant
Version: 0.7.3
Summary: 龙头战法五维量化筛选系统 — A股涨停板龙头识别工具
Author: gitBingxu
License-Expression: MIT
Project-URL: repository, https://github.com/gitBingxu/dragon-quant
Project-URL: Changelog, https://github.com/gitBingxu/dragon-quant/releases
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: playwright>=1.30
Requires-Dist: tmdx>=3.0
Dynamic: license-file

<p align="center">
  <img src="https://raw.githubusercontent.com/gitBingxu/dragon-quant/main/assets/icon.png" width="120" alt="dragon-quant icon">
</p>

<h1 align="center">dragon-quant 缅A龙头识别工具</h1>

<p align="center">
  <a href="https://pypi.org/project/dragon-quant/"><img src="https://img.shields.io/pypi/v/dragon-quant" alt="PyPI version"></a>
  <a href="https://pypi.org/project/dragon-quant/"><img src="https://img.shields.io/badge/python-%3E%3D3.10-blue" alt="Python >= 3.10"></a>
  <a href="https://github.com/gitBingxu/dragon-quant/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/dragon-quant" alt="License"></a>
  <a href="https://pypi.org/project/dragon-quant/"><img src="https://img.shields.io/pypi/dm/dragon-quant" alt="Downloads"></a>
  <a href="https://github.com/gitBingxu/dragon-quant"><img src="https://img.shields.io/github/stars/gitBingxu/dragon-quant" alt="GitHub stars"></a>
  <img src="https://img.shields.io/badge/stable-scan%20%7C%20review-brightgreen" alt="Stability: scan and review">
</p>

一款通过多维量化评分识别市场龙头的工具。基于 [TMDX](https://pypi.org/project/tmdx/) 获取股票行情，使用 SQLite 持久化数据，并具备完备的选股与选股回测能力。

## 目录

- [稳定性说明](#稳定性说明)
- [龙头扫描](#龙头扫描)
- [龙头回测](#龙头回测)
- [快速使用](#快速使用)
- [设计哲学](#设计哲学)
- [目录结构](#目录结构)
- [免责声明](#免责声明)
- [欢迎共建](#欢迎共建)
- [License](#license)

## 稳定性说明

选股与选股回测能力已经稳定，暂时不再迭代。当前重点是搭建模拟账户交易与回测系统，打通盘后复盘、集合竞价和账户交易链路。

| 功能 | 状态 | 预期稳定时间 |
|------|------|--------------|
| `scan` 龙头扫描 | 稳定 | — |
| `review` 龙头回测 | 稳定 | — |
| `prep` 盘后复盘 | 快速迭代中 | 2026 年 12 月初 |
| `auction` 集合竞价强度判断 | 快速迭代中 | 2026 年 12 月初 |
| `review-account` 账户模拟交易与回测 | 快速迭代中 | 2026 年 12 月初 |
| `agent-skill` 盘前预案复盘回测等 skills | 快速迭代中 | 2026 年 12 月中 |

## 龙头扫描

在**当日收盘后**运行，扫描涨停候选股，通过多维量化评分识别市场龙头：

```bash
dragon-quant scan --top 5
```

![龙头扫描示例](assets/scan.png)

## 龙头回测

这里的回测结果采用**宽松口径**：入选后首个非一字板交易日按最低价买入，统计后续最多 5 个交易日的最大收益与回撤。

```bash
# 回测已到观察期的扫描结果
dragon-quant review

# 打开龙头回测面板
dragon-quant review --ui-only
```

![龙头回测面板](assets/review.png)

## 快速使用

要求 **Python ≥ 3.10**，推荐使用 `pipx` 安装：

```bash
pipx install dragon-quant

# 当日收盘后扫描龙头
dragon-quant scan --top 5

# 回测扫描结果并打开面板
dragon-quant review --ui
```

只需查看已有回测结果时，运行 `dragon-quant review --ui-only`。

## 设计哲学

**龙头不是预判出来的，而是根据盘面证据识别出来的。** 评分器从带动性、领涨性、抗跌性、流动性和资金承接五个维度评估候选股：四项核心特征设置门槛，资金承接作为补充证据，避免单一高分掩盖明显短板。

模拟交易与回测的目标，是把盘后复盘、集合竞价和账户交易串成可回放、可验证的决策链，用统一的候选池、买卖规则、费用与成交假设检验策略，而不只展示选股收益。

详细设计见[评分器规范](archived_md/score/评分器Refactor.md)与[模拟交易和回测方案](archived_md/review_account/2026-10-20-live-trade-alignment.md)。

## 目录结构

```text
dragon_quant/
├── commands/        # CLI 命令入口
├── scan/            # 龙头扫描、五维评分与结果持久化
├── review/          # 龙头回测
├── review_account/  # 盘后复盘、集合竞价、模拟账户与交易策略
├── vpa/             # 量价分析
├── infra/           # 行情数据源、SQLite、缓存、因子与资产同步
└── tests/           # 单元、集成与离线 E2E 测试
web_ui/              # 回测与账户可视化面板
assets/              # 图标与 README 截图
docs/                # 模块与开发文档
archived_md/         # 已落地的调研与技术方案
```

## 免责声明

本工具仅供学习交流，不提供任何个股买卖建议。评分、回测与模拟交易的所有输出均为技术研究结果，不构成投资建议；据此操作产生的盈亏由使用者自行承担。

## 欢迎共建

欢迎通过 Issues 分享使用反馈、讨论策略与提出改进，也欢迎提交 PR 参与共建。

## License

[MIT](LICENSE)
