# AntMonitor

**Repository Path**: sfidea/ant-monitor

## Basic Information

- **Project Name**: AntMonitor
- **Description**: 交易市场量化工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 24
- **Created**: 2025-11-06
- **Last Updated**: 2025-11-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🐜 Ant-Tools - 智能股票监控分析系统

<div align="center">

![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)
![PyQt6](https://img.shields.io/badge/PyQt6-6.0+-green.svg)
![License](https://img.shields.io/badge/License-MIT-yellow.svg)
![Status](https://img.shields.io/badge/Status-Active-success.svg)

**一个基于 PyQt6 + Fluent Design 的现代化股票监控分析工具**

[功能特性](#-功能特性) • [快速开始](#-快速开始) • [项目结构](#-项目结构) • [相关文章](#-相关文章)

</div>

---

## 📖 项目概述

Ant-Tools 是一个专为个人投资者打造的**量化分析辅助工具**，旨在帮助投资者建立自己的交易体系。

### 💡 设计理念

> **投资需要体系，而非盲目跟风**

本项目的核心目标是：
- ✅ 提供股票数据的可视化分析
- ✅ 支持多种技术指标策略（BOLL、MACD、KDJ 等）
- ✅ 帮助投资者量化自己的交易逻辑
- ❌ **不提供**自动化交易功能
- ❌ **不推荐**任何具体的买卖建议

### 🎯 核心功能

- **股票池管理** - 自定义股票池，实时监控关注标的
- **技术指标分析** - 内置多种经典技术指标策略
- **专注模式** - 深度跟踪单只股票的生命周期
- **智能日报** - AI 驱动的市场资讯与情绪分析
- **板块监控** - 行业板块联动分析
- **策略回测** - 验证交易策略的有效性

---

## 🖼️ 功能展示

### 1️⃣ 首页 - 市场概览
![首页](doc/001-首页.png)
> 实时展示市场行情、自选股票池、今日关注重点

### 2️⃣ 个股推荐 - 策略筛选
![个股推荐](doc/002-个股推荐.png)
> 基于多维度策略评分，筛选符合条件的投资标的

### 3️⃣ 股票列表 - 全局视图
![股票列表](doc/003-股票列表.png)
> 管理股票池，查看所有监控股票的关键指标

### 4️⃣ 个股走势 - 技术分析
![个股走势](doc/004-个股走势.png)
> K线图表、技术指标叠加、历史数据回溯

### 5️⃣ 股票发现 - 策略探索
![股票发现](doc/005-股票发现.png)
> 通过策略组合发现潜在机会

### 6️⃣ 策略报表 - 绩效分析
![策略报表](doc/006-策略报表.png)
> 策略执行效果统计与可视化报表

### 7️⃣ 日志记录 - 操作追踪
![日志记录](doc/007-日志记录.png)
> 记录每一次操作决策，便于复盘总结

### 8️⃣ 专注模式 - 深度监控
![专注模式](doc/008-专注模式.png)
> 设置盈利目标，跟踪股票策略变化

### 9️⃣ 板块监控 - 行业分析
![板块监控](doc/009-板块监控.png)
> 监控行业板块轮动，把握市场热点

### 🔟 财经新闻 - 资讯聚合
![财经新闻](doc/010-财经新闻.png)
> 整合多源财经资讯，AI 辅助情绪分析

### 1️⃣1️⃣ 日报管理 - 智能总结
![日报管理](doc/011-日报管理.png)
> 自动生成每日市场分析报告

---

## 🚀 快速开始

### 前置准备

在开始之前，请确保完成以下准备工作：

1. **Python 环境**: 安装 Python 3.8 或更高版本
2. **Tushare 账号**: [点击注册 Tushare 账号](https://tushare.pro/register?reg=621792)（免费，提供股票数据接口）
3. **获取 Token**: 注册后在 Tushare 个人中心获取 API Token

> 💡 **提示**: Tushare 是国内领先的金融数据平台，本项目使用的都是免费接口，无需付费即可使用核心功能。

### 环境要求

- **Python**: 3.8 或更高版本
- **操作系统**: Windows / macOS / Linux
- **数据源**: Tushare 账号（免费接口）

### 安装步骤

#### 1. 克隆项目

```bash
git clone https://github.com/your-username/ant-tools.git
cd ant-tools
```

#### 2. 安装依赖

推荐使用虚拟环境：

```bash
# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt
```

或手动安装核心依赖：

```bash
# GUI 框架
pip install PyQt6 PyQt6-WebEngine qfluentwidgets

# 数据处理
pip install pandas numpy matplotlib pyecharts

# 数据库
pip install peewee DBUtils

# 股票数据源
pip install tushare akshare

# 网络请求
pip install requests beautifulsoup4 lxml httpx

# AI 相关（可选）
pip install openai zhipuai crewai tavily-python

# 其他工具
pip install schedule pydantic
```

#### 3. 配置 Tushare Token

在项目根目录创建配置文件或在代码中设置：

```python
# 在 config/settings.py 中配置
TUSHARE_TOKEN = "your_tushare_token_here"
```

#### 4. 初始化数据库

```bash
python main.py
```

首次运行会自动初始化数据库并同步股票基础数据。

### 运行项目

```bash
# 方式一：直接运行
python main.py

# 方式二：使用批处理文件（Windows）
run.bat
```

---

## 📁 项目结构

```
ant-tools/
├── agents/          # AI 智能体模块
├── api/             # 外部 API 适配器
├── app/             # 主应用程序
├── common/          # 公共工具类
├── config/          # 配置文件
├── das/             # 数据访问层
├── doc/             # 项目文档与截图
├── models/          # 数据模型
├── plugins/         # 插件系统
├── service/         # 业务逻辑层
├── strategy/        # 策略引擎
├── utils/           # 工具函数
├── views/           # UI 视图层
├── web/             # Web 服务（可选）
├── main.py          # 程序入口
├── requirements.txt # 依赖清单
└── README.md        # 项目说明
```

### 核心技术栈

| 技术 | 说明 |
|------|------|
| **PyQt6** | 现代化桌面 GUI 框架 |
| **QFluentWidgets** | Fluent Design 风格组件库 |
| **Tushare** | 股票数据接口 |
| **Pandas** | 数据处理与分析 |
| **Peewee** | 轻量级 ORM 框架 |
| **SQLite** | 本地数据库 |
| **PyEcharts** | 数据可视化 |
| **CrewAI** | AI 智能体框架（可选）|

---

## 📚 相关文章

以下是项目开发过程中的技术分享文章（掘金专栏）：

- 📝 [Python：关系型数据库用 SQLite 妥妥足够了](https://juejin.cn/post/7416657615369453620)
- 📝 [Python：用 TuShare 构建你自己的量化引擎](https://juejin.cn/post/7419304540200288268)
- 📝 [Python 桌面端：30分钟桌面端入门 + 分享我的开箱即用脚手架](https://juejin.cn/post/7458630988761612297)

> 更多技术细节和使用心得，欢迎关注我的掘金主页 👉 [@忘字辈小蚂蚁](https://juejin.cn/user/3790771822007822)

---

## 👨‍💻 关于作者

**忘字辈小蚂蚁** - 一个热爱技术的个人投资者

- 🔗 掘金：[@忘字辈小蚂蚁](https://juejin.cn/user/3790771822007822)
- 💬 欢迎交流：量化投资、Python 开发、桌面应用

### 💡 为什么做这个项目？

> 炒股多年，曾经靠感觉赚点小钱，但有一天被市场狠狠教育了。从峰值 8W 盈利到 -2W 亏损，5 年的收获全部打了水漂。我终于明白：**投资需要体系，而非运气**。

这个工具的目的是帮助像我一样的散户投资者：
- ✅ 建立自己的交易体系
- ✅ 量化投资决策过程
- ✅ 通过复盘不断优化策略

### ⚠️ 风险提示

- 本项目**仅供学习交流**，不构成任何投资建议
- 股市有风险，投资需谨慎
- 请根据自身情况制定投资策略
- **不要盲目跟随任何推荐**

---

## 📅 更新日志

### 🎉 v1.0.0 (2025-10-26)

**新增功能**
- ✨ 日志记录模块 - 完整的操作日志追踪
- ✨ 专注模式优化 - 支持多维度监控配置
- ✨ 新闻资讯模块 - 整合多源财经资讯
- ✨ 日报管理系统 - AI 驱动的智能日报生成

**功能优化**
- 🔧 优化策略引擎性能
- 🔧 改进数据同步机制
- 🔧 增强 UI 交互体验

**Bug 修复**
- 🐛 修复股票数据同步异常
- 🐛 修复图表渲染问题
- 🐛 修复数据库连接池泄漏

---


## 📄 开源协议

本项目采用 [MIT License](LICENSE) 开源协议。

---

## ⭐ Star History

如果这个项目对你有帮助，欢迎 Star ⭐ 支持一下！

---

<div align="center">

**Made with ❤️ by 忘字辈小蚂蚁**

[⬆ 回到顶部](#-ant-tools---智能股票监控分析系统)

</div>